完成后的状态
设备已注册到涂鸦云,可在 SmartLife App 中远程控制 —— 第一台设备路径的终点。
- 配网即将设备连接并注册到云端,从而支持远程控制。
- 设备必须已烧录固件并完成授权(写入 UUID + AuthKey)。
- 部分 Tuya 模组仅支持 2.4 GHz Wi-Fi 频段 —— 请核对芯片/模组的 WiFi 能力与路由器设置。
前置条件
配网前请逐项确认:
- 手机已安装 SmartLife App(见下方“获取 App”)。
- 设备已烧录固件并完成授权 —— 未授权请先看“使用授权码”。
- 设备处于配网模式(见“进入配网模式”)。
获取 SmartLife App
在手机上安装 SmartLife,注册并登录。可扫描下方二维码,或点击对应应用商店。

二维码会打开 SmartLife 官方下载页,并根据你的手机自动跳转到对应应用商店。
进入配网模式
首次启动
若你的应用使用了涂鸦云(如 switch_demo 或 your_chat_bot),刚烧录并授权的设备会在首次启动时自动进入配网模式,无需手动触发。可通过串口日志确认就绪。
若未进入配网模式
若设备此前已配过网、丢失网络配置,或日志中没有出现配网信息,可用以下方法重置配网与网络配置:
就绪时的日志特征
无论走哪条路径,当串口日志出现以下内容时,设备即进入配网模式:
[01-01 00:00:01 ty D][tuya_iot.c:774] STATE_START
[01-01 00:00:01 ty I][tuya_iot.c:792] Activation data read fail, go activation mode...
[01-01 00:00:01 ty D][tuya_main.c:143] Tuya Event ID:1(TUYA_EVENT_BIND_START)方法 1 —— 在 App 中添加设备(常用)
设备进入配网模式后,在 SmartLife App 中添加:
- 在 全部设备 页面,点击 添加设备 或右上角的 +。
- 按提示授予 Wi-Fi 与蓝牙权限 —— 否则无法发现附近设备。
- 设备出现在首页或添加设备页后,点击 前往添加,按 App 提示完成配网。
部分 Tuya 模组仅支持 2.4 GHz Wi-Fi 频段。若配网失败,请核对芯片/模组的 WiFi 能力,并确认路由器在配网期间开启了所支持的频段(或分离双频)。
方法 2 —— 扫码配网(QR)
部分 TuyaOpen 设备 —— 常见于树莓派等 Linux 设备 —— 通过扫描设备在终端打印的二维码配网。
- 确认设备处于配网模式,且终端/日志中显示了二维码。
- 打开 SmartLife App,点击右上角 +。
- 选择 扫描,将摄像头对准设备打印的二维码。
- 按屏幕提示完成配网。
故障排查
授权信息未写入。用 tyutool 重新写入 TuyaOpen(而非 TuyaOS)的 UUID + AuthKey,再重新进入配网模式。参见“使用授权码”。
确认已授予 SmartLife 的 Wi-Fi 与蓝牙权限、设备处于配网模式(日志含 TUYA_EVENT_BIND_START)、手机与设备在所支持的同一频段网络。
部分 Tuya 模组仅支持 2.4 GHz。请核对芯片/模组的 WiFi 能力,确认路由器开启了所支持的频段 —— 必要时在配网期间分离或关闭 5 GHz。
烧录固件不等于授权。设备需另行写入 UUID + AuthKey —— 配网前请先看“获取授权码”与“使用授权码”。
先重置配网与网络配置:嵌入式模组在 5 秒内断电再上电 3 次(间隔约 1 秒);树莓派 / Linux 主机删除 tuyadb 文件夹后重启。