ESP-AT 不同版本命令集支持对比

[English]

本文档主要列举了旧版 NONOS-AT 向新版 ESP-AT 迁移时,需要注意的命令上的差异。

  • NONOS-AT:不推荐 使用的 ESP8266 AT 版本,早期用于 ESP8266 系列芯片,基于 ESP8266_NONOS_SDK 开发,已停止更新。
  • ESP-AT:推荐 使用的版本,支持多个芯片平台,与 NONOS-AT 相比,支持更多种类的命令,如 Bluetooth 命令、Bluetooth LE 命令、以太网命令、驱动命令等。更多有关 ESP-AT 的信息请参阅 ESP-AT 是什么AT 固件

注意

下表列出了所有的 NONOS-AT 命令,以及它们在 ESP-AT 中的支持情况。下表并不包含所有的 ESP-AT 命令,若想了解所有 ESP-AT 命令,请参考 AT 命令集

下表中第一列的命令链接均指向 ESP-AT 命令。

ESP-AT 不同版本命令集支持对比表
命令 简介 NONOS-AT ESP-AT
AT 测试 AT 启动
AT+RST 重启模块
AT+GMR 查询版本信息
AT+GSLP 进入 deep-sleep 模式
ATE 开关回显功能
AT+RESTORE 恢复出厂设置
AT+UART_CUR 配置 UART,不保存到 flash
AT+UART_DEF 配置 UART,保存到 flash
AT+SLEEP 设置 sleep 模式
1: light sleep
2: modem sleep
ESP8266 ✅
ESP32 ✅
ESP32-S2 ❌
注释 [1]
AT+WAKEUPGPIO 配置 GPIO 唤醒 light sleep
[3] 相似命令参考 AT+SLEEPWKCFG
AT+RFPOWER 设置 RF TX Power
范围:[0,82]
单位:0.25 dBm
[2]
AT+RFVDD 根据 VDD33 设置 RF TX Power
AT+SYSRAM 查询系统当前剩余内存 ✅ 新增最小峰值内存参数
AT+SYSADC 查询 ADC 值
AT+SYSIOSETCFG 设置 IO 工作模式
AT+SYSIOGETCFG 查询 IO 工作模式
AT+SYSGPIODIR 设置 GPIO 工作为输入或输出
AT+SYSGPIOWRITE 设置 GPIO 的输出电平
AT+SYSGPIOREAD 读取 GPIO 的电平状态
AT+SYSMSG 设置系统消息
AT+SYSMSG_CUR 设置当前系统消息,不保存到 flash
[3] 相似命令参考 AT+SYSMSG
AT+SYSMSG_DEF 设置默认系统消息,保存到 flash
[3] 相似命令参考 AT+SYSMSG
AT+CWMODE 设置 Wi-Fi 模式 ✅ 新增切换模式自动连接
AT+CWMODE_CUR 设置当前 Wi-Fi 模式,不保存到 flash
[3] 相似命令参考 AT+CWMODE
AT+CWMODE_DEF 设置默认 Wi-Fi 模式,保存到 flash
[3] 相似命令参考 AT+CWMODE
AT+CWJAP 连接 AP ✅ 新增更多功能
AT+CWJAP_CUR 连接 AP,参数不保存到 flash
[3] 相似命令参考 AT+CWJAP
AT+CWJAP_DEF 连接 AP,参数保存到 flash
[3] 相似命令参考 AT+CWJAP
AT+CWLAPOPT 设置 CWLAP 命令的属性 ✅ 新增更多功能
AT+CWLAP 扫描当前可⽤ AP ✅ 回复不同
AT+CWQAP 断开与 AP 连接
AT+CWSAP 配置 softAP 参数
AT+CWSAP_CUR 配置 softAP 参数,不保存到 flash
[3] 相似命令参考 AT+CWSAP
AT+CWSAP_DEF 配置 softAP 参数,保存到 flash
[3] 相似命令参考 AT+CWSAP
AT+CWLIF 查询连接到 softAP 的 Station 信息
AT+CWDHCP 设置 DHCP
AT+CWDHCP_CUR 设置 DHCP,不保存到 flash
[3] 相似命令参考 AT+CWDHCP
AT+CWDHCP_DEF 设置 DHCP,保存到 flash
[3] 相似命令参考 AT+CWDHCP
AT+CWDHCPS 设置 softAP DHCP 分配的 IP 范围
AT+CWDHCPS_CUR 设置 softAP DHCP 分配的 IP 范围,不保存到 flash
[3] 相似命令参考 AT+CWDHCPS
AT+CWDHCPS_DEF 设置 softAP DHCP 分配的 IP 范围,保存到 flash
[3] 相似命令参考 AT+CWDHCPS
AT+CWAUTOCONN 上电是否自动连接 AP
AT+CIPSTAMAC 设置 Station 接⼝的 MAC 地址
AT+CIPSTAMAC_CUR 设置 Station 接口 MAC 地址,不保存到 flash
[3] 相似命令参考 AT+CIPSTAMAC
AT+CIPSTAMAC_DEF 设置 Station 接口 MAC 地址,保存到 flash
[3] 相似命令参考 AT+CIPSTAMAC
AT+CIPAPMAC 设置 softAP 的 MAC 地址
AT+CIPAPMAC_CUR 设置 softAP 的 MAC 地址,不保存到 flash
[3] 相似命令参考 AT+CIPAPMAC
AT+CIPAPMAC_DEF 设置 softAP 的 MAC 地址,保存到 flash
[3] 相似命令参考 AT+CIPAPMAC
AT+CIPSTA 设置 Station 的 IP 地址
AT+CIPSTA_CUR 设置 Station 的 IP 地址,不保存到 flash
[3] 相似命令参考 AT+CIPSTA
AT+CIPSTA_DEF 设置 Station 的 IP 地址,保存到 flash
[3] 相似命令参考 AT+CIPSTA
AT+CIPAP 设置 softAP 的 IP 地址
AT+CIPAP_CUR 设置 softAP 的 IP 地址,不保存到 flash
[3] 相似命令参考 AT+CIPAP
AT+CIPAP_DEF 设置 softAP 的 IP 地址,保存到 flash
[3] 相似命令参考 AT+CIPAP
AT+CWSTARTSMART 开启 SmartConfig
AT+CWSTOPSMART 停止 SmartConfig
AT+CWSTARTDISCOVER 开启可被局域⽹网内微信探测模式
AT+CWSTOPDISCOVER 关闭可被局域⽹网内微信探测模式
AT+WPS 设置 WPS 功能
AT+MDNS 设置 mDNS 功能
AT+CWJEAP 连接企业级加密路由器
ESP8266 ❌
ESP32 ✅
ESP32-S2 ❌
AT+CWJEAP_CUR 连接企业级加密路由器,不保存到 flash
AT+CWJEAP_DEF 连接企业级加密路由器,保存到 flash
AT+CWHOSTNAME 设置 Station 的主机名称
AT+CWCOUNTRY 设置 Wi-Fi 国家码
AT+CWCOUNTRY_CUR 设置 Wi-Fi 国家码,不保存到 flash
[3] 相似命令参考 AT+CWCOUNTRY
AT+CWCOUNTRY_DEF 设置 Wi-Fi 国家码,保存到 flash
[3] 相似命令参考 AT+CWCOUNTRY
AT+CIPSTATUS 查询⽹网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP/UDP/SSL 连接
AT+CIPSSLSIZE 设置 SSL Buffer size
AT+CIPSSLCCONF 配置 SSL 连接属性 ✅ 参数不同
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送长度为 length 数据,或在长度内 0 结尾的数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存 [3]
AT+CIPBUFRESET 重新计数 [3]
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态 [3]
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否发送成功 [3]
AT+CIPCLOSEMODE 设置 TCP 连接的断开方式 [3]
AT+CIPCLOSE 关闭 TCP/UDP/SSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接
AT+CIPSERVER 建立 TCP/SSL 服务器 ✅ 不支持 SSL server ✅ ESP32 和 ESP32-S2 支持 SSL server,ESP8266 不支持 SSL server
AT+CIPSERVERMAXCONN 设置服务器允许建立的最⼤连接数
AT+CIPMODE 设置传输模式
AT+SAVETRANSLINK 设置开机 透传模式 信息
AT+CIPSTO 设置 TCP 服务器器超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级固件 ✅ 支持更多参数
AT+CIPDINFO 接收网络数据时是否提示对端 IP 和端⼝
AT+CIPRECVMODE 设置 TCP 连接的数据接收方式
AT+CIPRECVDATA 被动接收模式时,读取缓存的 TCP 数据 ✅ 回复有差异
AT+CIPRECVLEN 被动接收模式时,查询缓存 TCP 数据的长度
AT+CIPSNTPCFG 设置时域和 SNTP 服务器 ✅ 支持更多功能
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS ⾃定义 DNS 服务器
AT+CIPDNS_CUR 自定义 DNS 服务器,不保存到 flash
[3] 相似命令参考 AT+CIPDNS
AT+CIPDNS_DEF 自定义 DNS 服务器,保存到 flash
[3] 相似命令参考 AT+CIPDNS
AT+SYSFLASH 读写 flash 用户分区

提示:点击脚注序号即可返回/跳转到上方表格的标注处。

[1]

新版 ESP-AT 中的 AT+SLEEP

  • ESP8266 and ESP32 ✅
    • 1:modem sleep by DTIM
    • 2:light sleep
    • 3:modem sleep by listen interval
  • ESP32-S2 ❌
[2]

新版 ESP-AT 中的 AT+RFPOWER

  • ESP8266 ✅,范围:[40,82],单位:0.25 dBm
  • ESP32 ✅,范围:[40,78],单位:0.25 dBm,且支持 Bluetooth LE
  • ESP32-S2 ✅,范围:[40,78],单位:0.25 dBm
[3](1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30) 新版 ESP-AT 不添加此命令