用python-miio控制电小酷智能排插CP5-PRO

本文以电小酷智能排插CP5-PRO为例，并非广告，其它产品可参照。
产品主页: http://www.cucosmart.com/#/detail?detId=9

1. 米家的 IoT 协议

• 功能划分为 service，每个 service 里面有若干 property 和若干 action。
• 每个 service、property 和 action 都有 ID，分别是siid、piid、aiid。
• 米家设备的控制就是通过小米IoT协议访问、修改这些property，调用action。

2. 开源项目 python-miio

• python-miio提供了访问小米 IoT 设备的 Python 接口，并提供了命令行工具miiocli
• 项目地址：https://github.com/rytilahti/python-miio.git
• 安装：pip install python-miio
  • 2023年8月：新命令 genericmiot还未发布，使用下面的命令安装最新代码：
    pip install git+https://github.com/rytilahti/python-miio.git

3. 设备的IP地址和设备TOKEN

• 访问设备需要设备的token
• 支持 WiFi 访问的米家 IoT 设备在其 IP地址的54321端口监听UDP消息
• 运行miiocli genericmiot命令需要获取设备的IP地址和设备token
• 重置设备的网络信息，设备token会更新

如何重置设备

1. 安装米家App并登录米家账号
2. 长按总电源键5秒，重置设备网络配置
3. 在米家App中添加设备：发现设备后选择它，按照提示输入WiFi名称和密码

查看设备的IP地址和设备token

• 网上有各种方法，大概是3种思路：
  • 获取米家App本地的database（本文写于2023年9月：成功）
  • 利用bug，获取泄露的信息（本文写于2023年9月：不成功）
  • 利用其它插件或者与米家合作的App获取（未尝试）
  • 利用米家账号和密码从后台获取（本文写于2023年9月：成功）
• 目前有效的最简单的方法是：利用米家账号从后台获取
  • 有人开发工具：https://github.com/Maxmudjon/Get_MiHome_devices_token。运行后提示输入米家账号和密码，即可显示账号下各个设备的信息。
    

4. 设备的小米IoT协议描述文件

• 设备的功能的service、property、action的定义由相应的描述文件定义。

• 这款插线板的描述文件：https://miot-spec.org/miot-spec-v2/instance?type=urn:miot-spec-v2:device:outlet:0000A002:cuco-cp5pro:1
  

• 下载描述文件，保存为：~/Library/Caches/python-miio/cuco.plug.cp5prd.json
  （我用的macOS，其它系统请自行调整）

5. 控制命令

# 关闭插座-1
miiocli genericmiot --ip 192.168.xx.xxx --token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx raw_command set_properties "[{'did': 'switchon', 'piid': 1, 'siid': 3, 'value': False}]"
# 关闭插座-2
miiocli genericmiot --ip 192.168.xx.xxx --token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx raw_command set_properties "[{'did': 'switchon', 'piid': 1, 'siid': 4, 'value': False}]"
# 关闭插座-3
miiocli genericmiot --ip 192.168.xx.xxx --token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx raw_command set_properties "[{'did': 'switchon', 'piid': 1, 'siid': 5, 'value': False}]"
# 关闭插座-4
miiocli genericmiot --ip 192.168.xx.xxx --token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx raw_command set_properties "[{'did': 'switchon', 'piid': 1, 'siid': 6, 'value': False}]"
# 关闭USB插口
miiocli genericmiot --ip 192.168.xx.xxx --token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx raw_command set_properties "[{'did': 'switchon', 'piid': 1, 'siid': 7, 'value': False}]"
# 打开插座-1
miiocli genericmiot --ip 192.168.xx.xxx --token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx raw_command set_properties "[{'did': 'switchon', 'piid': 1, 'siid': 3, 'value': False}]"
# 打开插座-2
miiocli genericmiot --ip 192.168.xx.xxx --token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx raw_command set_properties "[{'did': 'switchon', 'piid': 1, 'siid': 4, 'value': True}]"
# 打开插座-3
miiocli genericmiot --ip 192.168.xx.xxx --token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx raw_command set_properties "[{'did': 'switchon', 'piid': 1, 'siid': 5, 'value': True}]"
# 打开插座-4
miiocli genericmiot --ip 192.168.xx.xxx --token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx raw_command set_properties "[{'did': 'switchon', 'piid': 1, 'siid': 6, 'value': True}]"
# 打开USB插口
miiocli genericmiot --ip 192.168.xx.xxx --token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx raw_command set_properties "[{'did': 'switchon', 'piid': 1, 'siid': 7, 'value': True}]"

# 也可以调用Action，但是只提供了toggle命令
# 所以还要先get属性才知道toggle前后的状态
miiocli genericmiot --ip 192.168.xx.xxx --token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx raw_command action "{'aiid': 1, 'did': 'call-2-1', 'in': [], 'siid': 7}"