配网问题
2025-06-20 06:33:45 世界杯冠军最多
本文主要针对配网过程中的一些常见问题，梳理出对应的问题排查指引，帮助您解决一些日常问题。更多详情，请参考 智能生活 App 设备配网操作。
只有一个实际设备，为什么在自动发现配网页面搜到了两个该设备的 Logo？
智能生活 3.16.0 已经解决该问题。3.16.0 之前，双模设备是有可能在自发现中搜索到同一个双模设备两次。
Wi-Fi 快连或热点配网模式下出现显示结果页面，提示配网失败的相关信息？
这种情况一般是下面 2 种原因导致：
强绑定设备，已被别的账户绑定，可通过 App 反馈。
用户是游客模式，不支持绑定强绑定类型设备。
App 无法通过蓝牙连接到目标设备？
错误码
错误描述
错误原因
用户指引
-5
网络错误
1.获取 auth_key 失败2.注册失败3.激活失败
根据 App 网络错误引导进行操作
-14
配网信息发送失败
1.发送中途设备断开2.发送格式等数据错误3.其他原因设备返回接收信息失败
重置设备后重新配网
-20
配网超时
1.超过特定时间，配网未终止，且配网失败
重置设备后重新配网
-2561
连接失败
1.App 蓝牙设备连接失败2.发现服务失败3.打开通信通道失败
设备端保持配网状态，App 重新配网
-4368
token 失效
1.Wi-Fi 配网的逻辑，配对时间过久超过了 token 失效期（双模一般不会触发）
重置设备后重新配网
目标设备连接不到云端？
错误码
错误描述
错误原因
用户指引
1
数据包格式错误
App 发包设备不识别
开发错误，不会流到用户端
2
找不到路由
1.路由器频段是 5G2.路由器 SSID 为 2.4G+5G3.周围没有 Wi-Fi 路由环境
1.设备不支持 5G，请选择 2.4G 频段 SSID2.将设备设置为热点兼容模式，或者将路由器 SSID 分为 2.4G 和 5G 双频段3.将设备放置于有 2.4GWi-Fi 路由环境下
3
密码错误
密码输入错误
请检查密码，重新输入
4
连不上路由
1.路由器负载已满2.信号太差，距离太远3.密码错误
1.减少路由器挂载数量2.将设备放在路由器旁边3.请检查密码，重新输入
5
DHCP分配 IP 地址失效
1. 路由器工作不正常，此时路由器作为 IP 分配者，不向外分配地址，不论电脑或者手机都无法接收到有效 ip 来访问路由器，造成网络中断2. 路由器工作正常，但某个设备工作不正常无法准确接收到路由器发送过来的正确信号。如果手机或其他电脑通过此路由器可以正常上网，则判断设备接收信号出现故障3.路由器负载已满
1.将路由器重启，如果不好的话需要将路由器恢复出厂设置，然后重新设置参数基本就能解决问题2.重置设备 3.减少路由器挂载数量
其他错误（App 提示配网超时）
路由器为商业路由器
1.设备连接不上网络
使用家用路由进行配网
路由器设置了白名单
1.路由器设置白名单无法访问或者链接路由器网络
在路由器中管理中心增加白名单
网络环境差，网速慢
1.路由器软件卡死，路由器自己网络限速
修复网络环境
自动发现配网添加设备失败？
请参考 App 的 自动发现 功能为什么添加设备失败?。
Wi-Fi 快连配网（Wi-Fi 快连）添加设备失败？
请参考 使用 Wi-Fi 快连配网，设备进入快闪模式但仍连接不上?。
热点配网添加设备失败？
请参考 使用热点模式配网，设备进入慢闪模式但仍连接不上?。
指示灯状态有变化，但是 App 提示超时，过一会首页设备列表又出现设备？
此问题，大概率是因为设备上线慢导致。
热点配网时 App 提示配网失败，但是设备指示灯一直处于快闪状态？
局域网内设备未收到 App 的广播包，请按以下步骤进行排查：
确认 App 版本是否是 3.17.6 之前版本，若是，则升级 App 即可。
换个手机（Android 不同品牌手机或者 ios 手机），如果能成功，则提供设备信息和不成功的手机系统信息，以 工单形式 反馈给涂鸦。
若步骤 2 不成功，则需要提供设备说明书相关的信息，以工单形式反馈给涂鸦。
Wi-Fi 快连配网模式下出现 App 提示配网失败，但是设备指示灯一直处于快闪状态？
出现此问题现象，极大可能是设备未收到 App 发送的配网指令，需要先从路由问题排查，主要经过以下步骤：
确认配网过程中 App 是否有提示 5G 路由，如有提示，请将路由设置为分频模式，配网时使用 2.4G 频段。
换个路由器或者使用手机热点作为路由，重新尝试配网。
若手机热点可以，路由器不可以，则可将具体路由器信息以工单形式反馈给涂鸦。
若手机热点和路由器均不可以，则可换个手机（不同 Android 手机或者 ios 手机尝试），将失败的手机系统说明页详细信息以及路由信息以工单形式反馈给涂鸦。
Wi-Fi 快连或热点配网模式下 App 提示配网失败，但是设备指示灯状态发生改变？
设备指示灯不再闪烁，说明设备收到了 App 发送的配网指令（涂鸦固件一般在收到 App 指令后去连接路由器，同时不再闪烁），可以按以下步骤排查：
可能是设备连接不上配网的路由器，可以使用手机热点尝试。
将路由器信息和设备信息（固件版本）以工单形式反馈给涂鸦。
设备联网成功（可通过路由器查询是否连接成功，或者如果是手机热点，可查看连接数），激活失败，这种话情况下，请提供 App 的登录账号和配网时间，以工单形式反馈给涂鸦。
设备配网时无法激活，查看本地串口打印日志发现有 errorCode:PRODUCT_OTA_CHANNEL_CONFIG 的错误？
此错误码的出现原因是：产品上固件配置有问题，OTA 通道号不匹配对。您可以按以下方法逐一排除：
Pid 未绑定固件 Key。
如果固件为 OEM 固件，请检查应用代码是否设置 OEM 固件标志位。
调用以下接口进行解决：
/***********************************************************
Function: tuya_iot_oem_set
Desc: set oem mode
Input: oem
Note: must call first***********************************************************/
VOID tuya_iot_oem_set(IN CONST BOOL_T oem);
我有几台设备配网都连不到云端，查看日志报 -720 错误，这是为什么？
-720 错误码的释义为 OPRT_HTTPS_NOT_ENCRYPT_RET。
在激活时出现此问题，应该是前面用某个 PID 配网过，现在用的是另一个 PID 配网，触发了跨 PID 升级，在某些固件（已下架）中，这种操作会导致设备功能失效，解决的方法只能擦除并重新烧录程序。jpg" src=“https://images.tuyacn.com/goat/20191216/5f55fcc576184b9a93f4cc041620753d.jpg” width=“”>
通过 腾讯云小微 控制智能设备
现在，您可以使用 腾讯云小微 来控制您的智能设备了。
您可以通过下列指令控制您的设备。
控制设备命令固定格式：Hi 小微，把{设备名称}{打开 | 关闭 | 暂停 | 调高 | 调低}。