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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

use serde::{Deserialize, Serialize};

use crate::tapo_vendor::error::{Error, TapoResponseError};

/// Implemented by all Tapo Responses.
pub(crate) trait TapoResponseExt {}

impl TapoResponseExt for serde_json::Value {}

#[derive(Debug, Serialize, Deserialize)]
pub(crate) struct TapoResponse<T: TapoResponseExt> {
    pub error_code: i64,
    pub result: Option<T>,
}

#[derive(Debug, Deserialize)]
pub(crate) struct TapoMultipleResponse<T: TapoResponseExt> {
    pub result: TapoMultipleResult<T>,
}

impl<T> TapoResponseExt for TapoMultipleResponse<T> where T: TapoResponseExt {}

#[derive(Debug, Deserialize)]
pub(crate) struct TapoMultipleResult<T: TapoResponseExt> {
    pub responses: Vec<TapoResponse<T>>,
}

pub(crate) fn validate_response(error_code: i64) -> Result<(), Error> {
    if error_code == 0 {
        return Ok(());
    }

    let kind = error_kind(error_code);

    let error = match kind {
        "LOGIN" => TapoResponseError::Unauthorized {
            kind,
            description:
                "Please verify that your email and password are correct - both are case-sensitive."
                    .to_string(),
        },
        // The device counts failed logins and locks itself after too many,
        // so neither of these may read as an expired session to retry on.
        "TPAP_CREDENTIALS" => TapoResponseError::tpap_credentials(),
        "TPAP_AUTH_ATTEMPTS_LIMIT" => TapoResponseError::tpap_auth_attempts_limit(),
        "SESSION_TIMEOUT" | "SESSION_EXPIRED" => TapoResponseError::session_expired(kind),
        _ => TapoResponseError::DeviceError {
            code: error_code,
            kind,
        },
    };

    Err(Error::Tapo(error))
}

fn error_kind(code: i64) -> &'static str {
    match code {
        // Smart Devices
        -1002 => "UNKNOWN_METHOD",
        -1003 => "JSON_DECODE_FAIL",
        -1004 => "JSON_ENCODE_FAIL",
        -1008 => "PARAMS",
        -1010 => "PUBLIC_KEY",
        -1501 => "LOGIN",
        9999 => "SESSION_TIMEOUT",
        // Smart Devices: plug schedule rules
        -1802 => "SCHEDULE_FULL",
        -1803 => "SCHEDULE_CONFLICT",
        -1805 => "SCHEDULE_INDEX",
        // Smart Devices: TPAP protocol
        -2101 => "TPAP_AUTH_ATTEMPTS_LIMIT",
        -2201 => "TPAP_CIPHER_SUITES_UNSUPPORTED",
        -2202 => "TPAP_PASSCODE_TYPE_UNSUPPORTED",
        -2203 => "TPAP_CREDENTIALS",
        -2402 => "TPAP_SESSION_INVALID",
        // SmartCam Devices
        -40106 => "UNSUPPORTED_METHOD",
        -40109 => "ONE_SECOND_REPEAT_REQUEST",
        -40203 => "BIND_SENSOR_EXISTS",
        // The positive variant has been observed from both camera hubs (H200,
        // H500) rejecting a Smart-format request under "err_code".
        -40210 | 40210 => "PROTOCOL_FORMAT_ERROR",
        -40211 => "MISSING_NECESSARY_PARAMS",
        -40321 => "IP_CONFLICT",
        -40401 => "SESSION_EXPIRED",
        -40404 => "DEVICE_BLOCKED",
        -40405 => "DEVICE_FACTORY",
        -40406 => "OUT_OF_LIMIT",
        -40407 => "OTHER_ERROR",
        -40408 => "SYSTEM_BLOCKED",
        -40409 => "NONCE_EXPIRED",
        -40412 => "HOMEKIT_LOGIN_FAIL",
        -40413 => "INVALID_NONCE",
        -40414 => "NEED_LOGIN_BY_LOCAL_PASSWORD",
        -60506 => "LOCAL_ACCOUNT_OLD_PWD_ERROR",
        -69051 => "DIAGNOSE_TYPE_NOT_SUPPORT",
        -69052 => "DIAGNOSE_TASK_FULL",
        -69053 => "DIAGNOSE_TASK_BUSY",
        -69055 => "DIAGNOSE_INTERNAL_ERROR",
        -69056 => "DIAGNOSE_ID_NOT_FOUND",
        -69057 => "DIAGNOSE_TASK_NULL",
        -69060 => "CLOUD_LINK_DOWN",
        -69061 => "ONVIF_SET_WRONG_TIME",
        -69062 => "CLOUD_NTP_NO_RESPONSE",
        -69063 => "CLOUD_GET_WRONG_TIME",
        -69064 => "SNTP_SRV_NO_RESPONSE",
        -69065 => "SNTP_GET_WRONG_TIME",
        -69076 => "LINK_UNCONNECTED",
        -69077 => "WIFI_SIGNAL_WEAK",
        -69078 => "LOCAL_NETWORK_POOR",
        -69079 => "CLOUD_NETWORK_POOR",
        -69080 => "INTER_NETWORK_POOR",
        -69081 => "DNS_TIMEOUT",
        -69082 => "DNS_ERROR",
        -69083 => "PING_NO_RESPONSE",
        -69084 => "DHCP_MULTI_SERVER",
        -69085 => "DHCP_ERROR",
        -69094 => "STREAM_SESSION_CLOSE",
        -69095 => "STREAM_BITRATE_EXCEPTION",
        -69096 => "STREAM_FULL",
        -69097 => "STREAM_NO_INTERNET",
        -71105 => "PLAYBACK_SEARCH_FAILED",
        -71114 => "STORAGE_NOT_EXIST",
        -71115 => "STORAGE_SD_LOADING",
        -72101 => "HARDWIRED_NOT_FOUND",
        -80101 => "ENCRYPT_NOT_SUPPORT",
        -90000 => "FFS_NONE_PWD",
        -90001 => "TSS_NONE_PWD",
        40108 => "TIMEOUT_ERROR",
        _ => "UNKNOWN",
    }
}