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 不添加此命令。