AT 配网示例
本文档主要介绍以下几种 ESP-AT 支持的配网方式:
配网方式 |
SmartConfig 配网 |
SoftAP 配网 |
WPS 配网 |
---|---|---|---|
默认固件支持情况 |
(备注 1) |
||
是否需要 BLE |
|||
是否需要额外的手机 APP |
(备注 2) |
||
配网成功率 |
较高 |
高 |
高 |
操作复杂性 |
简单 |
复杂 |
复杂 |
推荐指数 |
推荐 |
中等 |
中等 |
备注 1:若想 AT 固件中支持 SoftAP 配网,请参考: Web 服务器 AT 命令。
备注 2:使用 SmartConfig 中的 AirKiss 类型配网时需依赖微信 APP,国外用户可能无法使用微信 APP。
SmartConfig 配网
AT SmartConfig 配网有四种类型,分别是 ESP-TOUCH、AirKiss、ESP-TOUCH+AirKiss 和 ESP-TOUCH v2。以下是 AirKiss 和 ESP-TOUCH v2 类型的配网示例。
ESP-TOUCH v2 配网示例
在手机端安装 EspTouch 应用程序。
Android:安卓端 EspTouch 下载 (安卓端应用程序源码)
iOS:iOS 端 EspTouch 下载 (iOS 端应用程序源码)
设置 ESP 设备为 Station 模式。
命令:
AT+CWMODE=1
响应:
OK
ESP32-S2 设备开启 SmartConfig。
命令:
AT+CWSTARTSMART=4,0,"1234567890123456"
响应:
OK
在手机端进行配网。
请按照以下步骤操作:打开手机的 Wi-Fi,连接到目标网络(例如 SSID:test,密码:1234567890),启动 EspTouch 应用程序,点击
EspTouch V2
按钮。在跳转的页面中输入所连接 Wi-Fi 的密码、待配网的设备数量以及 AES 密钥,如下所示:Wi-Fi 密码:1234567890 需要配网的设备数量:1 AES 密钥:1234567890123456
在 ESP 设备端确认配网成功。
此时 ESP 设备端会输出类似如下信息:
smartconfig type:ESPTOUCH_V2 Smart get wifi info ssid:test password:1234567890 WIFI CONNECTED WIFI GOT IP smartconfig connected wifi
到此,ESP 设备的配网已成功完成。
ESP32-S2 设备停止 SmartConfig。
命令:
AT+CWSTOPSMART
响应:
OK
AirKiss 配网示例
打开手机微信,搜索并关注“乐鑫信息科技”公众号。
设置 ESP 设备为 Station 模式。
命令:
AT+CWMODE=1
响应:
OK
ESP32-S2 设备开启 SmartConfig。
命令:
AT+CWSTARTSMART=2
响应:
OK
在手机端进行配网。
手机连接到要配网的 Wi-Fi(例如 SSID:test,密码:1234567890),然后打开微信,进入“乐鑫信息科技”公众号,点击产品资源,找到 AirKiss 设备并进入。在跳转的页面中输入 Wi-Fi 密码
1234567890
,稍等片刻,手机页面将显示类似日志配置成功......
。此时 ESP 设备端会输出类似如下信息:
smartconfig type:AIRKISS Smart get wifi info ssid:test password:1234567890 WIFI CONNECTED WIFI GOT IP smartconfig connected wifi
到此,ESP 设备的配网已成功完成。
ESP32-S2 设备停止 SmartConfig。
命令:
AT+CWSTOPSMART
响应:
OK
SoftAP 配网
AT SoftAP 配网指的是 WEB 配网。有关详细信息,请参见 Web Server AT 示例。
WPS 配网
准备一个支持 WPS 配网的路由器(例如 Wi-Fi SSID: test)。
设置 ESP 设备为 Station 模式。
命令:
AT+CWMODE=1
响应:
OK
ESP32-S2 设备开启 WPS 配网。
命令:
AT+WPS=1
响应:
OK
此时根据路由器的使用手册,开启 WPS 功能,稍等片刻,ESP 设备端会输出类似如下信息,即设备配网已成功。
WIFI CONNECTED WIFI GOT IP
查询 ESP32-S2 设备连接上的 Wi-Fi 信息。
命令:
AT+CWJAP?
响应:
+CWJAP:"test",...... OK
ESP32-S2 设备关闭 WPS 配网。
命令:
AT+WPS=0
响应:
OK