esp8266 smartconfig-智能配网分析和使用及注意事项

基本知识：

  乐鑫⾃主研发的 ESP-TOUCH 协议采⽤的是 Smart Config（智能配置）技术，帮助⽤户将 采⽤ ESP8266EX 和 ESP32 的设备（以下简称“设备”）连接⾄ Wi-Fi ⽹络。⽤户只需在⼿ 机上进⾏简单操作即可实现智能配置。整个过程如下图所示：

 　　

 由于设备在⼀开始并未连接⾄⽹络，ESP-TOUCH App ⽆法直接向设备发送信息。通过 ESP-TOUCH 通信协议，具备 Wi-Fi ⽹络接⼊能⼒的设备（例如智能⼿机）就可以向接 ⼊点 (AP) 发送⼀系列 UDP 包，其中每⼀包的⻓度（即 Length 字段）都按照 ESPTOUCH 通信协议进⾏编码，SSID 和密码就包含在 Length 字段中，随后设备便可以获 得并解析出所需的信息。数据包结构如图 1-2 所示：

 

源码和app：

源码的路径如下所示：

源码路径：https://github.com/EspressifApp/EsptouchForAndroid/releases/tag/v1.1.0

根据你的所需进行修改或直接安装，笔者的截图如下所示：

 

操作步骤：

准备⼀台⽀持 ESP-TOUCH 的设备，开启配置功能；
将⼿机连接⾄路由器；
打开安装在⼿机上的 ESP-TOUCH App；
在 App 界⾯输⼊路由器的 SSID 和密码（若路由不加密则密码为空），开始连接。

注意事项：

• 设备与⼿机建⽴链路所需的时间和两者之间的距离有关，若距离很近，仅需数秒即可完成。

• 在开启设备端 ESP-TOUCH 智能配置功能之前，请确保路由器已经开启。由于开启此功能后，设备会先 扫描周围的 AP 信息，如果路由器没有开启，则⽆法获取周围的 AP 列表。

• ESP-TOUCH App 端发送序列有超时限制，即如果没有在规定的时间配置上路由，App 会返回配置失败 信息（参考 App 源码）。设备端也会有超时限制，从设备锁定通道开始计时到获取 SSID 和密码信息， 如果达到超时限制但并未获取到 SSID 和密码信息，设备会⾃动重新开始⼀次 Smart Config。⽤户可以通 过 esptouch_set_timeout(uint8 time_s) 或 esp_smartconfig_set_timeout(uint8 time_s) 设置超时时 间。

• Smart Config 过程中设备需要开启 Sniffer 模式，所以在 ESP8266 上 Station 和 soft-AP 模式都是关闭 的，不要调⽤其他相关 API。ESP32 不受此限制，可以同时开启 Sniffer 和 Station 模式。

• 配置结束后，发送端获取设备的 IP，设备端也会返回发送端的 IP，如果⽤户需要⾃定义发送端和设备端 的信息交互，可以使⽤此 IP 信息进⾏局域⽹通信。 • 如果路由器设置了“AP 隔离”，会出现设备连接路由器成功，但 App 未收到连接成功的提示的现象。

• ⽀持⼿机同时配置多个设备到同⼀路由器上，配置时 App 端选择接收多个返回结果。

• ESP8266 和 ESP32 不⽀持 5G 和 11AC 模式，因此不⽀持 Smart Config 连接 5G 或 11AC 模式的路由 器。