跳到主要内容
返回学习中心基础

用 SmartLife App 配网

让已烧录并授权的设备进入配网模式,并通过 SmartLife App 将其注册到涂鸦云 —— 这是第一台设备路径的最后一公里。

入门6 分钟网络

完成后的状态

设备已注册到涂鸦云,可在 SmartLife App 中远程控制 —— 第一台设备路径的终点。

  • 配网即将设备连接并注册到云端,从而支持远程控制。
  • 设备必须已烧录固件并完成授权(写入 UUID + AuthKey)。
  • 部分 Tuya 模组仅支持 2.4 GHz Wi-Fi 频段 —— 请核对芯片/模组的 WiFi 能力与路由器设置。

前置条件

配网前请逐项确认:

  • 手机已安装 SmartLife App(见下方“获取 App”)。
  • 设备已烧录固件并完成授权 —— 未授权请先看“使用授权码”。
  • 设备处于配网模式(见“进入配网模式”)。

获取 SmartLife App

在手机上安装 SmartLife,注册并登录。可扫描下方二维码,或点击对应应用商店。

SmartLife
涂鸦智能生活
SmartLife app download QR code
扫码下载

二维码会打开 SmartLife 官方下载页,并根据你的手机自动跳转到对应应用商店。

进入配网模式

首次启动

若你的应用使用了涂鸦云(如 switch_demoyour_chat_bot),刚烧录并授权的设备会在首次启动时自动进入配网模式,无需手动触发。可通过串口日志确认就绪。

若未进入配网模式

若设备此前已配过网、丢失网络配置,或日志中没有出现配网信息,可用以下方法重置配网与网络配置:

嵌入式模组(T5/T3/T2/ESP32/BK…)在 5 秒内给设备断电再上电 3 次,每次间隔约 1 秒。
树莓派 / Linux 主机删除设备上的 tuyadb 文件夹以清除已存储的配网配置,再重启。

就绪时的日志特征

无论走哪条路径,当串口日志出现以下内容时,设备即进入配网模式:

[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 中添加:

  1. 全部设备 页面,点击 添加设备 或右上角的 +
  2. 按提示授予 Wi-Fi 与蓝牙权限 —— 否则无法发现附近设备。
  3. 设备出现在首页或添加设备页后,点击 前往添加,按 App 提示完成配网。

部分 Tuya 模组仅支持 2.4 GHz Wi-Fi 频段。若配网失败,请核对芯片/模组的 WiFi 能力,并确认路由器在配网期间开启了所支持的频段(或分离双频)。

方法 2 —— 扫码配网(QR)

部分 TuyaOpen 设备 —— 常见于树莓派等 Linux 设备 —— 通过扫描设备在终端打印的二维码配网。

  1. 确认设备处于配网模式,且终端/日志中显示了二维码。
  2. 打开 SmartLife App,点击右上角 +
  3. 选择 扫描,将摄像头对准设备打印的二维码。
  4. 按屏幕提示完成配网。

故障排查

配网失败,日志中 UUID / AuthKey 显示为 xxxxxxxxxxxxxxxx

授权信息未写入。用 tyutool 重新写入 TuyaOpen(而非 TuyaOS)的 UUID + AuthKey,再重新进入配网模式。参见“使用授权码”。

App 搜不到设备

确认已授予 SmartLife 的 Wi-Fi 与蓝牙权限、设备处于配网模式(日志含 TUYA_EVENT_BIND_START)、手机与设备在所支持的同一频段网络。

在路由器下配网失败

部分 Tuya 模组仅支持 2.4 GHz。请核对芯片/模组的 WiFi 能力,确认路由器开启了所支持的频段 —— 必要时在配网期间分离或关闭 5 GHz。

设备已烧录但没有授权码

烧录固件不等于授权。设备需另行写入 UUID + AuthKey —— 配网前请先看“获取授权码”与“使用授权码”。

设备之前配过网、无法重新配网

先重置配网与网络配置:嵌入式模组在 5 秒内断电再上电 3 次(间隔约 1 秒);树莓派 / Linux 主机删除 tuyadb 文件夹后重启。

完成 —— 浏览更多教程 →完整配网文档 →使用授权码 →