Tuya Smart Home

通过云API或本地网络控制任何涂鸦/智能生活设备。

依赖项

bash
pip3 install tinytuya tuya-connector-python

配置

提供两种控制模式：

云模式

需要从 https://iot.tuya.com 获取涂鸦IoT平台凭证：

• - ACCESSID — 来自云项目
• ACCESSSECRET — 来自云项目
• REGION — cn（中国）、us（美洲/东南亚）、eu（欧洲）、in（印度）

本地模式（推荐）

需要设备信息（先通过云API获取）：

• - DEVICEID — 设备标识符
• LOCALKEY — 设备加密密钥
• IP — 设备本地IP地址
• VERSION — 协议版本（通常为3.4）

快速开始

扫描本地网络中的设备

bash
python3 scripts/tuya_scan.py

获取设备信息（云）

bash
python3 scripts/tuya_control.py --mode cloud --action info \
--device-id DEVICE_ID \
--access-id ACCESSID --access-secret ACCESSSECRET --region cn

查询设备状态

bash

云模式

python3 scripts/tuya_control.py --mode cloud --action status \
--device-id DEVICE_ID \
--access-id ACCESSID --access-secret ACCESSSECRET --region cn

本地模式

python3 scripts/tuya_control.py --mode local --action status \ --device-id DEVICE_ID --ip IP --local-key KEY

发送命令

bash

云模式 — 喂宠物1份

python3 scripts/tuya_control.py --mode cloud --action send \
--device-id DEVICEID --code manualfeed --value 1 \
--access-id ACCESSID --access-secret ACCESSSECRET --region cn

本地模式 — 喂宠物1份

python3 scripts/tuya_control.py --mode local --action send \ --device-id DEVICE_ID --ip IP --local-key KEY \ --dp-id 3 --value 1

打开灯

python3 scripts/tuya_control.py --mode cloud --action send \ --device-id DEVICEID --code switchled --value true \ --access-id ACCESSID --access-secret ACCESSSECRET --region cn

打开窗帘

python3 scripts/tuya_control.py --mode cloud --action send \ --device-id DEVICE_ID --code control --value open \ --access-id ACCESSID --access-secret ACCESSSECRET --region cn

常见设备命令

设备	代码	值	描述
宠物喂食器	manualfeed	1-12	喂食N份
宠物喂食器

quickfeed | true | 快速喂食 | | 宠物喂食器 | light | true/false | 夜灯 | | 灯 | switch_led | true/false | 开/关 | | 灯 | bright_value | 10-1000 | 亮度 | | 灯 | temp_value | 0-1000 | 色温 | | 插座 | switch_1 | true/false | 开/关 | | 窗帘 | control | open/stop/close | 移动 | | 窗帘 | percent_control | 0-100 | 位置百分比 |

中国区域说明

中国数据中心（openapi.tuyacn.com）默认屏蔽非中国IP。
解决方案：

1. 1. 在涂鸦IoT平台 → 项目 → IP白名单中添加您的IP
2. 使用本地模式（完全绕过云，推荐）

API参考

有关详细的API文档、DP代码表和设置指南，请参阅 references/tuya_api.md。