AT 配网示例

[English]

本文档主要介绍以下几种 ESP-AT 支持的配网方式:

配网方式关键参数总结

配网方式

SmartConfig 配网

SoftAP 配网

WPS 配网

默认固件支持情况

icon-green-check

icon-red-cross备注 1

icon-green-check

是否需要 BLE

icon-red-cross

icon-red-cross

icon-red-cross

是否需要额外的手机 APP

icon-green-check备注 2

icon-green-check

icon-red-cross

配网成功率

较高

操作复杂性

简单

复杂

复杂

推荐指数

推荐

中等

中等

  • 备注 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 配网示例

  1. 在手机端安装 EspTouch 应用程序。

  2. 设置 ESP 设备为 Station 模式。

    命令:

    AT+CWMODE=1
    

    响应:

    OK
    
  3. ESP32-S2 设备开启 SmartConfig。

    命令:

    AT+CWSTARTSMART=4,0,"1234567890123456"
    

    响应:

    OK
    
  4. 在手机端进行配网。

    请按照以下步骤操作:打开手机的 Wi-Fi,连接到目标网络(例如 SSID:test,密码:1234567890),启动 EspTouch 应用程序,点击 EspTouch V2 按钮。在跳转的页面中输入所连接 Wi-Fi 的密码、待配网的设备数量以及 AES 密钥,如下所示:

    Wi-Fi 密码:1234567890
    需要配网的设备数量:1
    AES 密钥:1234567890123456
    
  5. 在 ESP 设备端确认配网成功。

    此时 ESP 设备端会输出类似如下信息:

    smartconfig type:ESPTOUCH_V2
    Smart get wifi info
    ssid:test
    password:1234567890
    WIFI CONNECTED
    WIFI GOT IP
    smartconfig connected wifi
    

    到此,ESP 设备的配网已成功完成。

  6. ESP32-S2 设备停止 SmartConfig。

    命令:

    AT+CWSTOPSMART
    

    响应:

    OK
    

AirKiss 配网示例

  1. 打开手机微信,搜索并关注“乐鑫信息科技”公众号。

  2. 设置 ESP 设备为 Station 模式。

    命令:

    AT+CWMODE=1
    

    响应:

    OK
    
  3. ESP32-S2 设备开启 SmartConfig。

    命令:

    AT+CWSTARTSMART=2
    

    响应:

    OK
    
  4. 在手机端进行配网。

    手机连接到要配网的 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 设备的配网已成功完成。

  5. ESP32-S2 设备停止 SmartConfig。

    命令:

    AT+CWSTOPSMART
    

    响应:

    OK
    

SoftAP 配网

AT SoftAP 配网指的是 WEB 配网。有关详细信息,请参见 Web Server AT 示例

WPS 配网

  1. 准备一个支持 WPS 配网的路由器(例如 Wi-Fi SSID: test)。

  2. 设置 ESP 设备为 Station 模式。

    命令:

    AT+CWMODE=1
    

    响应:

    OK
    
  3. ESP32-S2 设备开启 WPS 配网。

    命令:

    AT+WPS=1
    

    响应:

    OK
    

    此时根据路由器的使用手册,开启 WPS 功能,稍等片刻,ESP 设备端会输出类似如下信息,即设备配网已成功。

    WIFI CONNECTED
    WIFI GOT IP
    
  4. 查询 ESP32-S2 设备连接上的 Wi-Fi 信息。

    命令:

    AT+CWJAP?
    

    响应:

    +CWJAP:"test",......
    OK
    
  5. ESP32-S2 设备关闭 WPS 配网。

    命令:

    AT+WPS=0
    

    响应:

    OK