denki 0.2.0

CLI for controlling TP-Link smart home devices — denki (電気) means electricity in Japanese
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

use crate::tapo_vendor::error::Error;
use crate::tapo_vendor::requests::{
    SmartCamAddMotorPositionParams, SmartCamDeletePresetParams, SmartCamGetPresetConfigParams,
    SmartCamMotorMoveParams, SmartCamMotorMoveToPresetParams, TapoParams, TapoRequest,
};
use crate::tapo_vendor::responses::{DeviceInfoCameraResult, Preset, PresetRaw};

tapo_handler! {
    /// Handler for Tapo cameras with PTZ, such as the
    /// [C210](https://www.tapo.com/en/search/?q=C210),
    /// [C220](https://www.tapo.com/en/search/?q=C220),
    /// [C225](https://www.tapo.com/en/search/?q=C225),
    /// [C325WB](https://www.tapo.com/en/search/?q=C325WB),
    /// [C520WS](https://www.tapo.com/en/search/?q=C520WS),
    /// [TC40](https://www.tapo.com/en/search/?q=TC40),
    /// and [TC70](https://www.tapo.com/en/search/?q=TC70).
    CameraPtzHandler(DeviceInfoCameraResult),
}

camera_device_management_handlers!(CameraPtzHandler);
camera_detection_handlers!(CameraPtzHandler, builder = c220);
camera_stream_handlers!(CameraPtzHandler);

impl CameraPtzHandler {
    /// Moves the camera by the given pan and tilt values.
    ///
    /// Positive `pan` moves right, negative moves left. `0` will not move on this axis.
    /// Positive `tilt` moves up, negative moves down. `0` will not move on this axis.
    ///
    /// If unsure of the value, `10` for both `pan` and `tilt` are good values for small nudges.
    pub async fn pan_tilt(&self, pan: i32, tilt: i32) -> Result<(), Error> {
        let request = TapoRequest::SmartCamMotorMove(TapoParams::new(
            SmartCamMotorMoveParams::new(pan, tilt),
        ));

        self.client
            .read()
            .await
            .execute_smart_cam_command(request)
            .await
    }

    /// Saves the current camera position as a named preset.
    pub async fn save_preset(&self, name: &str) -> Result<(), Error> {
        let request = TapoRequest::SmartCamAddMotorPosition(TapoParams::new(
            SmartCamAddMotorPositionParams::new(name),
        ));

        self.client
            .read()
            .await
            .execute_smart_cam_command(request)
            .await
    }

    /// Moves the camera to a saved preset position by its ID.
    pub async fn goto_preset(&self, id: &str) -> Result<(), Error> {
        let request = TapoRequest::SmartCamMotorMoveToPreset(TapoParams::new(
            SmartCamMotorMoveToPresetParams::new(id),
        ));

        self.client
            .read()
            .await
            .execute_smart_cam_command(request)
            .await
    }

    /// Deletes a preset by its ID.
    pub async fn delete_preset(&self, id: &str) -> Result<(), Error> {
        let request =
            TapoRequest::SmartCamDeletePreset(TapoParams::new(SmartCamDeletePresetParams::new(id)));

        self.client
            .read()
            .await
            .execute_smart_cam_command(request)
            .await
    }

    /// Returns the list of saved PTZ presets.
    pub async fn get_presets(&self) -> Result<Vec<Preset>, Error> {
        let request = TapoRequest::SmartCamGetPresetConfig(TapoParams::new(
            SmartCamGetPresetConfigParams::new(),
        ));

        let raw: PresetRaw = self
            .client
            .read()
            .await
            .execute_smart_cam_section_request(request)
            .await?;

        Ok(raw.into_presets())
    }
}