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：新版 ESP-AT 不添加此命令。

提供有关此文档的反馈