【ESP8266】基础AT指令和常用WIF指令

【ESP8266 （12F）】硬件参数 以及 固件烧录

一、常用AT命令

完整的请参考：AT指令指南 这个pdf。

指令复制进串口助手可能无效，可以尝试手打。

资料地址：https://github.com/CQUPTLei/ESP8266

通用 AT 命令有四种类型：

类型	命令格式	说明
测试命令	AT+<命令名称>=?	查询设置命令的内部参数及其取值范围
查询命令	AT+<命令名称>?	返回当前参数值
设置命令	AT+<命令名称>=<…>	设置用户自定义的参数值，并运行命令
执行命令	AT+<命令名称>	运行无用户自定义参数的命令

• 不是每条 AT 命令都具备上述四种类型的命令。
• 命令里输入参数，当前只支持字符串参数和整形数字参数。
• 尖括号 < > 内的参数不可以省略。
• 方括号 [ ] 内的参数可以省略，省略时使用默认值。

1.1 基础

AT：测试AT启动 AT+RST：重启 AT+GMR：查看版本信息 AT+CMD?：查询当前固件支持的所有命令及命令类型 AT+GSLP=time：进入Deep-sleep模式，单位毫秒 ATE1、ATE0：开启或关闭 AT 回显功能 AT+RESTOREL：恢复出厂设置（当前固件） AT+UART_DEF=115200,8,1,0,3：设置串口的波特率、数据位、停止位、校验位、流控（下次上电依然有效） AT+SYSRAM?：查看当前剩余堆空间和最小堆空间 AT+SYSMSG：查询/设置系统提示信息 AT+SYSSTORE：设置参数存储模式，=0：不存储在Flash，=1：存储在Flash，？：查询当前存储模式

• AT：测试 AT 启动
• AT+RST：重启模块
• AT+GMR：查看版本信息
• AT+CMD：查询当前固件支持的所有命令及命令类型
• AT+GSLP：进⼊ Deep-sleep 模式
• ATE：开启或关闭 AT 回显功能
• AT+RESTORE：恢复出厂设置
• AT+SAVETRANSLINK：设置开机 透传模式 信息
• AT+TRANSINTVL：设置 透传模式 模式下的数据发送间隔
• AT+UART_CUR：设置 UART 当前临时配置，不保存到 flash
• AT+UART_DEF：设置 UART 默认配置, 保存到 flash
• AT+SLEEP：设置 sleep 模式
• AT+SYSRAM：查询当前剩余堆空间和最小堆空间
• AT+SYSMSG：查询/设置系统提示信息
• AT+SYSMSGFILTER：启用或禁用 系统消息 过滤
• AT+SYSMSGFILTERCFG：查询/配置 系统消息 的过滤器
• AT+SYSFLASH：查询或读写 flash 用户分区
• AT+SYSMFG：查询或读写 manufacturing nvs 用户分区
• AT+RFPOWER：查询/设置 RF TX Power
• AT+SYSROLLBACK：回滚到以前的固件
• AT+SYSTIMESTAMP：查询/设置本地时间戳
• AT+SYSLOG：启用或禁用 AT 错误代码提示
• AT+SLEEPWKCFG：设置 Light-sleep 唤醒源和唤醒 GPIO
• AT+SYSSTORE：设置参数存储模式
• AT+SYSREG：读写寄存器

1.2 WiFi相关

• AT+CWINIT：初始化/清理 Wi-Fi 驱动程序
• AT+CWMODE：查询/设置 Wi-Fi 模式 (Station/SoftAP/Station+SoftAP)
• AT+CWSTATE：查询 Wi-Fi 状态和 Wi-Fi 信息
• AT+CWJAP：连接 AP
• AT+CWRECONNCFG：查询/设置 Wi-Fi 重连配置
• AT+CWLAPOPT：设置 AT+CWLAP 命令扫描结果的属性
• AT+CWLAP：扫描当前可用的 AP
• AT+CWQAP：断开与 AP 的连接
• AT+CWSAP：配置 ESP32 SoftAP 参数
• AT+CWLIF：查询连接到 ESP32 SoftAP 的 station 信息
• AT+CWQIF：断开 station 与 ESP32 SoftAP 的连接
• AT+CWDHCP：启用/禁用 DHCP
• AT+CWDHCPS：查询/设置 ESP32 SoftAP DHCP 分配的 IPv4 地址范围
• AT+CWAUTOCONN：上电是否自动连接 AP
• AT+CWAPPROTO：查询/设置 SoftAP 模式下 802.11 b/g/n 协议标准
• AT+CWSTAPROTO：设置 Station 模式下 802.11 b/g/n 协议标准
• AT+CIPSTAMAC：查询/设置 ESP32 Station 的 MAC 地址
• AT+CIPAPMAC：查询/设置 ESP32 SoftAP 的 MAC 地址
• AT+CIPSTA：查询/设置 ESP32 Station 的 IP 地址
• AT+CIPAP：查询/设置 ESP32 SoftAP 的 IP 地址
• AT+CWSTARTSMART：开启 SmartConfig
• AT+CWSTOPSMART：停止 SmartConfig
• AT+WPS：设置 WPS 功能
• AT+MDNS：设置 mDNS 功能
• AT+CWJEAP：连接 WPA2 企业版 AP
• AT+CWHOSTNAME：查询/设置 ESP32 Station 的主机名称
• AT+CWCOUNTRY：查询/设置 Wi-Fi 国家代码

1.21 AT+CWMODE：查询/设置 Wi-Fi 模式 (Station/SoftAP/Station+SoftAP)

AT+CWMODE?：查询 ESP 设备的 Wi-Fi 模式

• 0: 无 Wi-Fi 模式，并且关闭 Wi-Fi RF
• 1: Station 模式
• 2: SoftAP 模式
• 3: SoftAP+Station 模式

• Station模式是客户端模式，模块可以连接到其他路由器发出的Wi-Fi信号，主要应用在网络通信中。
• SoftAP模式是软路由模式，模块本身相当于一个路由器，其他设备可以连接到模块发送的Wi-Fi信号，主要应用在主从设备的主机部分。
• Station+SoftAP模式是混合模式，模块可以在与其他设备连接的同时充当路由器，结合上面两种模式的综合应用，一般应用在需要网络通信且在主从关系中的主机

AT+CWMODE=[,]：设置 ESP 设备的 Wi-Fi 模式

：切换 ESP 设备的 Wi-Fi 模式时（例如，从 SoftAP 或无 Wi-Fi 模式切换为 Station 模式或 SoftAP+Station 模式），是否启用自动连接 AP 的功能，默认值：1。参数缺省时，使用默认值，也就是能自动连接。

– 0: 禁用自动连接 AP 的功能
– 1: 启用自动连接 AP 的功能，若之前已经将自动连接 AP 的配置保存到 flash 中，则 ESP 设备将自动连接 AP

1.22 AT+CWJAP：连接 AP

（连接wifi时，先设置为模式1或者3，注意你的模块支持的频段，比如的是是2.4GHz的，就不能连5GHz的wifi）

AT+CWJAP?：查询与 ESP Station 连接的 AP 信息

AT+CWJAP=[],[][,][,][,][,,→][,][,][,]：设置 ESP Station 需连接的 AP

AT+CWJAP：将 ESP station 连接至上次 Wi-Fi 配置中的 AP

上面的说明可能看的头晕了，莫急，看看简单示例：

// 如果目标 AP 的 SSID 是 "abc"，密码是 "0123456789"，则命令是：
AT+CWJAP="abc","0123456789"
// 如果目标 AP 的 SSID 是 "ab\,c"，密码是 "0123456789"\"，则命令是：
AT+CWJAP="ab\\\,c","0123456789\"\\"
// 如果多个 AP 有相同的 SSID "abc"，可通过 BSSID 找到目标 AP：
AT+CWJAP="abc","0123456789","ca:d7:19:d8:a6:44"
// 如果 ESP-AT 要求通过 PMF 连接 AP，则命令是：
AT+CWJAP="abc","0123456789",,,,,,,3

1.23 AT+CWLAP：扫描当前可用的 AP

功能：
列出符合特定条件的 AP，如指定 SSID、MAC 地址或信道号

1.24 AT+CWSAP：配置 ESP SoftAP 参数

注意把模式设置为3.

AT+CWSAP?：查询 ESP SoftAP 的配置参数

AT+CWSAP=,,,[,][,：设置 ESP SoftAP 的配置参数

示例：

AT+CWSAP="ESP8266","11223344",5,3

1.25 AT+CWLIF：查询连接到 ESP SoftAP 的 station 信息

输出：连接者的ip地址和mac地址

---

这些是常用的，更多的请看完整PDF。

二、应用

2.1 SoftAP模式

ESP8266作为SoftAP时，主要是用来使连接到它的设备可以直接和他通信。连接到它的设置是不能直接连接到因特网的。

在我们的大多数ESP8266 NodeMCU Web 服务器项目中，我们将 ESP8266 连接到无线路由器。在这个配置中，我们可以通过本地网络访问ESP8266。

在这种情况下，路由器充当接入点，ESP8266 设置为站。因此，您需要连接到路由器（本地网络）才能控制 ESP8266。

在某些情况下，这可能不是最佳配置（当您附近没有路由器时）。但是，如果您将 ESP8266 设置为接入点（热点），您可以使用任何具有 Wi-Fi 功能的设备连接到 ESP8266，而无需连接到路由器。

简而言之，当您将 ESP8266 设置为接入点时，您会创建自己的 Wi‑Fi 网络，附近的 Wi-Fi 设备（站点）可以连接到它（例如您的智能手机或计算机）。

因为 ESP8266 不进一步连接到有线网络（如您的路由器），所以它被称为软 AP（软接入点）。

这意味着如果您尝试从 Internet 加载库或使用固件，它将不起作用。如果您尝试向 Internet 上的服务发出 HTTP 请求（例如将传感器读数发布到云），它也不起作用。

---

也可以运行在，SoftAP+Station模式，让子设备通过esp8266实现互联网数据传输，这也是常用的模式之一。

或者使用串口、IIC等连接子设备，再通过esp8266连接互联网。

2.2 WiFi中继（趣味）

此外，esp8266还可以运行在SoftAP+Station 模式，再使用NAT功能，让ESP8266 连接到家里的路由器，再让其他设备连接到ESP8266的WiFi，实现WiFi中继的效果。

这功能路由器也能完成，但使用ESP8266或许更便宜，或许还可以有其他用处，也挺好玩的。

这是项目地址：https://github.com/martin-ger/esp_wifi_repeater，可以到这里下载固件。

---

把 永 远 爱 你 写 进 诗 的 结 尾 ~