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