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 | 测试 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
|
|
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 | ✅ | |
AT+SYSMSG_DEF | 设置默认系统消息,保存到 flash | ✅ | |
AT+CWMODE | 设置 Wi-Fi 模式 | ❌ | ✅ 新增切换模式自动连接 |
AT+CWMODE_CUR | 设置当前 Wi-Fi 模式,不保存到 flash | ✅ | |
AT+CWMODE_DEF | 设置默认 Wi-Fi 模式,保存到 flash | ✅ | |
AT+CWJAP | 连接 AP | ✅ | ✅ 新增更多功能 |
AT+CWJAP_CUR | 连接 AP,参数不保存到 flash | ✅ | |
AT+CWJAP_DEF | 连接 AP,参数保存到 flash | ✅ | |
AT+CWLAPOPT | 设置 CWLAP 命令的属性 | ✅ | ✅ 新增更多功能 |
AT+CWLAP | 扫描当前可⽤ AP | ✅ | ✅ 回复不同 |
AT+CWQAP | 断开与 AP 连接 | ✅ | ✅ |
AT+CWSAP | 配置 softAP 参数 | ❌ | ✅ |
AT+CWSAP_CUR | 配置 softAP 参数,不保存到 flash | ✅ | |
AT+CWSAP_DEF | 配置 softAP 参数,保存到 flash | ✅ | |
AT+CWLIF | 查询连接到 softAP 的 Station 信息 | ✅ | ✅ |
AT+CWDHCP | 设置 DHCP | ❌ | ✅ |
AT+CWDHCP_CUR | 设置 DHCP,不保存到 flash | ✅ | |
AT+CWDHCP_DEF | 设置 DHCP,保存到 flash | ✅ | |
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 | ✅ | |
AT+CIPSTA_DEF | 设置 Station 的 IP 地址,保存到 flash | ✅ | |
AT+CIPAP | 设置 softAP 的 IP 地址 | ❌ | ✅ |
AT+CIPAP_CUR | 设置 softAP 的 IP 地址,不保存到 flash | ✅ | |
AT+CIPAP_DEF | 设置 softAP 的 IP 地址,保存到 flash | ✅ | |
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 | ✅ | |
AT+CIPDNS_DEF | 自定义 DNS 服务器,保存到 flash | ✅ | |
AT+SYSFLASH | 读写 flash 用户分区 | ❌ | ✅ |
提示:点击脚注序号即可返回/跳转到上方表格的标注处。
[1] | 新版 ESP-AT 中的 AT+SLEEP
|
[2] | 新版 ESP-AT 中的 AT+RFPOWER
|
[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 不添加此命令 |