中文(Esp8266_at_instruction_set_cn).pdf

发布时间：2023-11-24 发布人：admin 分类：养殖资料大小：0.81M 资料格式：pdf 举报版权申诉

第1页 / 共69页

中文(Esp8266_at_instruction_set_cn).pdf-第2页.jpg

第2页 / 共69页

中文(Esp8266_at_instruction_set_cn).pdf-第3页.jpg

第3页 / 共69页

中文(Esp8266_at_instruction_set_cn).pdf-第4页.jpg

第4页 / 共69页

中文(Esp8266_at_instruction_set_cn).pdf-第5页.jpg

第5页 / 共69页

中文(Esp8266_at_instruction_set_cn).pdf-第6页.jpg

第6页 / 共69页

中文(Esp8266_at_instruction_set_cn).pdf-第7页.jpg

第7页 / 共69页

中文(Esp8266_at_instruction_set_cn).pdf-第8页.jpg

第8页 / 共69页

前言

客制化 AT 固件

编译 AT 工程

客制化功能

新增自定义 AT 指令

烧录 AT 固件

16 Mbit Flash, Map: 1024 KB + 1024 KB

32 Mbit Flash, Map: 1024 KB + 1024 KB

4 Mbit Flash

8 Mbit Flash

16 Mbit Flash, Map: 512 KB + 512 KB

32 Mbit Flash, Map: 512 KB + 512 KB

指令说明

基础 AT 指令

基础 AT 指令一览表

基础 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 模式

AT+WAKEUPGPIO—设置 GPIO 唤醒 Light-sleep 模式

AT+RFPOWER—设置 RF TX Power 上限

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_CUR—设置当前系统消息，不保存到 flash

AT+SYSMSG_DEF—设置默认系统消息，保存到 flash

基础 AT 指令

基础 Wi-Fi 功能 AT 指令一览表

基础 Wi-Fi 功能 AT 指令描述

AT+CWMODE_CUR—设置当前 Wi-Fi 模式，不保存到 Flash

AT+CWMODE_DEF—设置当前 Wi-Fi 模式并保存到 Flash

AT+CWJAP_CUR—临时连接 AP

AT+CWJAP_DEF—连接 AP，保存到 Flash

AT+CWLAPOPT—设置 CWLAP 指令的属性

AT+CWLAP—扫描当前可用的 AP

AT+CWQAP—断开与 AP 的连接

AT+CWSAP_CUR—配置 ESP8266 SoftAP 当前参数

AT+CWSAP_DEF—配置 ESP8266 SoftAP 当前参数，保存到 Flash

AT+CWLIF—查询连接到 ESP8266 SoftAP 的 Station 信息

AT+CWDHCP_CUR—设置 DHCP，不保存到 Flash

AT+CWDHCP_DEF—设置 DHCP，保存到 Flash

AT+CWDHCPS_CUR—设置 ESP8266 SoftAP DHCP 分配的 IP 范围，不保存到 Flash

AT+CWDHCPS_DEF—设置 ESP8266 SoftAP DHCP 分配的 IP 范围，保存到 Flash

AT+CWAUTOCONN—上电是否自动连接 AP

AT+CIPSTAMAC_CUR—设置 ESP8266 Station 当前 MAC 地址，不保存到 Flash

AT+CIPSTAMAC_DEF—设置 ESP8266 Station 当前 MAC 地址，保存到 Flash

AT+CIPAPMAC_CUR—设置 ESP8266 SoftAP 当前 MAC 地址，不保存到 Flash

AT+CIPAPMAC_DEF—设置 ESP8266 SoftAP 默认 MAC 地址，保存到 Flash

AT+CIPSTA_CUR—设置 ESP8266 Station 的 IP 地址，不保存到 Flash

AT+CIPSTA_DEF—设置 ESP8266 Station 的 IP 地址，保存到 Flash

AT+CIPAP_CUR—设置 ESP8266 SoftAP 的 IP 地址，不保存到 Flash

AT+CIPAP_DEF—设置 ESP8266 SoftAP 的 IP 地址，保存到 Flash

AT+CWSTARTSMART—开启 SmartConfig

AT+CWSTOPSMART—停止 SmartConfig

AT+CWSTARTDISCOVER—开启可被局域网内微信探测模式

AT+CWSTOPDISCOVER—关闭可被局域网内微信探测模式

AT+WPS—设置 WPS 功能

AT+MDNS—设置 MDNS 功能

AT+CWHOSTNAME—设置 ESP8266 Station 的主机名称

AT+CWCOUNTRY_CUR—设置 ESP8266 WiFi 国家码

AT+CWCOUNTRY_DEF—设置默认的 ESP8266 WiFi 国家码，并保存到 flash

TCP/IP 功能 AT 指令

TCP/IP 指令一览表

TCP/IP 指令描述

AT+CIPSTATUS—查询网络连接信息

AT+CIPDOMAIN—域名解析功能

AT+CIPSTART—建立 TCP 连接，UDP 传输或 SSL 连接

AT+CIPSSLSIZE—设置 SSL Buffer 容量

AT+CIPSSLCCONF—配置 SSL Client

AT+CIPSEND—发送数据

AT+CIPSENDEX—发送数据

AT+CIPSENDBUF—数据写入 TCP 发包缓存

AT+CIPBUFRESET—重新计数

AT+CIPBUFSTATUS—查询 TCP 发包缓存的状态

AT+CIPCHECKSEQ—查询写入 TCP 发包缓存的某包是否发送成功

AT+CIPCLOSEMODE—设置 TCP 连接的断开方式

AT+CIPCLOSE—关闭 TCP/UDP/SSL 传输

AT+CIFSR—查询本地 IP 地址

AT+CIPMUX—设置多连接

AT+CIPSERVER—建立 TCP 服务器

AT+CIPSERVERMAXCONN—设置服务器允许建立的最大连接数 *

AT+CIPMODE—设置传输模式

AT+SAVETRANSLINK—保存透传到 Flash

AT+CIPSTO—设置 TCP 服务器超时时间

AT+PING—Ping 功能

AT+CIUPDATE—通过 Wi-Fi 升级软件

AT+CIPDINFO—接收网络数据时是否提示对端 IP 和端口

+IPD—接收网络数据

AT+CIPRECVMODE—设置 TCP 连接的数据接收方式

AT+CIPRECVDATA—被动接收模式时，读取缓存的 TCP 数据

AT+CIPRECVLEN—被动接收模式时，查询缓存 TCP 数据的长度

AT+CIPSNTPCFG—设置时域和 SNTP 服务器

AT+CIPSNTPTIME—查询 SNTP 时间

AT+CIPDNS_CUR—自定义 DNS 服务器，不保存到 Flash

AT+CIPDNS_DEF—自定义 DNS 服务器，保存到 Flash

附录 A

附录 B

Q&A

关于本⼿手册本⽂文档提供 ESP8266_NONOS_SDK 的 AT 指令说明。发布说明⽇日期 2016.04 2016.05 2016.07 2017.05 2017.08 2018.02 2018.05 2018.05 2018.08 2019.02 版本 V1.5.3 V1.5.4 V2.0.0 V2.1.0 V2.1.1 V2.2 V2.2.1 V2.2.2 V3.0 V3.0.1 发布说明⾸首次发布。更更新章节 5.2.16 和 5.2.19。增加章节 3.2.11，更更新章节 1.2。更更新章节 3.2，4.1 和 5.2。增加附录 B 增加章节 3.2.22，3.2.23，4.2.39，4.2.40 和 5.2.15。更更新章节 4.2.7，4.2.8 和附录 B。更更新章节 4.2.10，4.2.11 和 4.2.12。增加章节 5.2.11，5.2.23，5.2.24。更更新章节 3.2.10。增加章节 5.2.5，5.2.25，5.2.26，5.2.27。更更新第 1 章，章节 4.2.3，4.2.4，4.2.11，4.2.12，附录 A。删除 AT+RFAUTOTRACE 指令。更更新章节 5.2.5，5.2.30，5.2.31。⽂文档变更更通知⽤用户可通过乐鑫官⽹网订阅⻚页⾯面 https://www.espressif.com/zh-hans/subscribe 订阅技术⽂文档变更更的电⼦子邮件通知。证书下载⽤用户可通过乐鑫官⽹网证书下载⻚页⾯面 https://www.espressif.com/zh-hans/certiﬁcates 下载产品证书。 

⽬目录 1. 前⾔言 1.1. 客制化 AT 固件 1.2. 烧录 AT 固件 1.1.1. 编译 AT ⼯工程 1.1.2. 客制化功能 1.1.3. 新增⾃自定义 AT 指令 ........................................................................................................................................................ ............................................................................................................................................ .................................................................................................................................. ..................................................................................................................................... ....................................................................................................................... ................................................................................................................................................ ...................................................................................... ...................................................................................... ................................................................................................................................... ................................................................................................................................... .......................................................................................... .......................................................................................... 1.2.1. 16 Mbit Flash, Map: 1024 KB + 1024 KB 1.2.2. 32 Mbit Flash, Map: 1024 KB + 1024 KB 1.2.3. 4 Mbit Flash 1.2.4. 8 Mbit Flash 1.2.5. 16 Mbit Flash, Map: 512 KB + 512 KB 1.2.6. 32 Mbit Flash, Map: 512 KB + 512 KB 1 1 1 1 1 2 3 3 3 4 4 4 2. 指令说明 ................................................................................................................................................. 6 3. 基础 AT 指令 3.1. 基础 AT 指令⼀一览表 3.2. 基础 AT 指令描述 ........................................................................................................................................... ..................................................................................................................................... ........................................................................................................................................ .......................................................................................................................... ........................................................................................................................ ............................................................................................................... ................................................................................................ ....................................................................................................................... ....................................................................................................... .................................................... ....................................................................... ....................................................................................................... 3.2.1. AT—测试 AT 启动 3.2.2. AT+RST—重启模块 3.2.3. AT+GMR—查询版本信息 3.2.4. AT+GSLP—进⼊入 Deep-sleep 模式 3.2.5. ATE—开关回显功能 3.2.6. AT+RESTORE—恢复出⼚厂设置 3.2.7. AT+UART_CUR—设置 UART 当前临时设置，不不保存到 Flash 3.2.8. AT+UART_DEF—设置 UART 配置，保存到 Flash 3.2.9. AT+SLEEP—设置 sleep 模式 7 7 8 8 8 8 8 9 9 10 11 12

3.2.10. AT+WAKEUPGPIO—设置 GPIO 唤醒 Light-sleep 模式 3.2.11. AT+RFPOWER—设置 RF TX Power 上限 3.2.12. AT+RFVDD—根据 VDD33 设置 RF TX Power 3.2.13. AT+SYSRAM—查询系统当前剩余内存 3.2.14. AT+SYSADC—查询 ADC 值 3.2.15. AT+SYSIOSETCFG—设置 IO ⼯工作模式 3.2.16. AT+SYSIOGETCFG—查询 IO ⼯工作模式 3.2.17. AT+SYSGPIODIR—设置 GPIO ⼯工作为输⼊入或输出 3.2.18. AT+SYSGPIOWRITE—设置 GPIO 的输出电平 3.2.19. AT+SYSGPIOREAD—读取 GPIO 的电平状态 3.2.20. AT+SYSMSG_CUR—设置当前系统消息，不不保存到 ﬂash 3.2.21. AT+SYSMSG_DEF—设置默认系统消息，保存到 ﬂash ............................................................... .................................................................................... ............................................................................. ........................................................................................ ........................................................................................................ ....................................................................................... ...................................................................................... ...................................................................... ............................................................................ .............................................................................. ........................................................... ............................................................... 12 13 13 14 14 14 14 15 15 16 17 17 4. 基础 AT 指令 4.1. 基础 Wi-Fi 功能 AT 指令⼀一览表 4.2. 基础 Wi-Fi 功能 AT 指令描述 ......................................................................................................................................... ................................................................................................................. ..................................................................................................................... ..................................................... .......................................................... ................................................................................................. ................................................................................. ............................................................................... ............................................................................................... ................................................................................................. .................................................................. ........................................... ......................................................... ................................................................... ........................................................................ 4.2.1. AT+CWMODE_CUR—设置当前 Wi-Fi 模式，不不保存到 Flash 4.2.2. AT+CWMODE_DEF—设置当前 Wi-Fi 模式并保存到 Flash 4.2.3. AT+CWJAP_CUR—临时连接 AP 4.2.4. AT+CWJAP_DEF—连接 AP，保存到 Flash 4.2.5. AT+CWLAPOPT—设置 CWLAP 指令的属性 4.2.6. AT+CWLAP—扫描当前可⽤用的 AP 4.2.7. AT+CWQAP—断开与 AP 的连接 4.2.8. AT+CWSAP_CUR—配置 ESP8266 SoftAP 当前参数 4.2.9. AT+CWSAP_DEF—配置 ESP8266 SoftAP 当前参数，保存到 Flash 4.2.10. AT+CWLIF—查询连接到 ESP8266 SoftAP 的 Station 信息 4.2.11. AT+CWDHCP_CUR—设置 DHCP，不不保存到 Flash 4.2.12. AT+CWDHCP_DEF—设置 DHCP，保存到 Flash 18 18 20 20 20 21 22 23 24 25 26 26 28 28 29

4.2.13. AT+CWDHCPS_CUR—设置 ESP8266 SoftAP DHCP 分配的 IP 范围，不不保存到 Flash 4.2.14. AT+CWDHCPS_DEF—设置 ESP8266 SoftAP DHCP 分配的 IP 范围，保存到 Flash 4.2.15. AT+CWAUTOCONN—上电是否⾃自动连接 AP 4.2.16. AT+CIPSTAMAC_CUR—设置 ESP8266 Station 当前 MAC 地址，不不保存到 Flash 4.2.17. AT+CIPSTAMAC_DEF—设置 ESP8266 Station 当前 MAC 地址，保存到 Flash 4.2.18. AT+CIPAPMAC_CUR—设置 ESP8266 SoftAP 当前 MAC 地址，不不保存到 Flash 4.2.19. AT+CIPAPMAC_DEF—设置 ESP8266 SoftAP 默认 MAC 地址，保存到 Flash 4.2.20. AT+CIPSTA_CUR—设置 ESP8266 Station 的 IP 地址，不不保存到 Flash 4.2.21. AT+CIPSTA_DEF—设置 ESP8266 Station 的 IP 地址，保存到 Flash 4.2.22. AT+CIPAP_CUR—设置 ESP8266 SoftAP 的 IP 地址，不不保存到 Flash 4.2.23. AT+CIPAP_DEF—设置 ESP8266 SoftAP 的 IP 地址，保存到 Flash 4.2.24. AT+CWSTARTSMART—开启 SmartConﬁg 4.2.25. AT+CWSTOPSMART—停⽌止 SmartConﬁg 4.2.26. AT+CWSTARTDISCOVER—开启可被局域⽹网内微信探测模式 4.2.27. AT+CWSTOPDISCOVER—关闭可被局域⽹网内微信探测模式 4.2.28. AT+WPS—设置 WPS 功能 4.2.29. AT+MDNS—设置 MDNS 功能 4.2.30. AT+CWHOSTNAME—设置 ESP8266 Station 的主机名称 4.2.31. AT+CWCOUNTRY_CUR—设置 ESP8266 WiFi 国家码 4.2.32. AT+CWCOUNTRY_DEF—设置默认的 ESP8266 WiFi 国家码，并保存到 ﬂash ............. ................. .............................................................................. ..................... ......................... ....................... ........................... ..................................... ......................................... ....................................... ............................................ ................................................................................. ................................................................................... ..................................................... ....................................................... .......................................................................................................... ..................................................................................................... .......................................................... ............................................................... ........................... 30 30 31 31 32 32 32 33 33 34 34 35 36 36 37 37 37 38 38 39 5. TCP/IP 功能 AT 指令 5.1. TCP/IP 指令⼀一览表 5.2. TCP/IP 指令描述 ............................................................................................................................ .................................................................................................................................... ....................................................................................................................................... ........................................................................................... ................................................................................................. ............................................................ ..................................................................................... 5.2.1. AT+CIPSTATUS—查询⽹网络连接信息 5.2.2. AT+CIPDOMAIN—域名解析功能 5.2.3. AT+CIPSTART—建⽴立 TCP 连接，UDP 传输或 SSL 连接 5.2.4. AT+CIPSSLSIZE—设置 SSL Buﬀer 容量量 40 40 41 41 41 42 44

5.2.5. AT+CIPSSLCCONF—配置 SSL Client 5.2.6. AT+CIPSEND—发送数据 5.2.7. AT+CIPSENDEX—发送数据 5.2.8. AT+CIPSENDBUF—数据写⼊入 TCP 发包缓存 5.2.9. AT+CIPBUFRESET—重新计数 5.2.10. AT+CIPBUFSTATUS—查询 TCP 发包缓存的状态 5.2.11. AT+CIPCHECKSEQ—查询写⼊入 TCP 发包缓存的某包是否发送成功 5.2.12. AT+CIPCLOSEMODE—设置 TCP 连接的断开⽅方式 5.2.13. AT+CIPCLOSE—关闭 TCP/UDP/SSL 传输 5.2.14. AT+CIFSR—查询本地 IP 地址 5.2.15. AT+CIPMUX—设置多连接 5.2.16. AT+CIPSERVER—建⽴立 TCP 服务器器 5.2.17. AT+CIPSERVERMAXCONN—设置服务器器允许建⽴立的最⼤大连接数 * 5.2.18. AT+CIPMODE—设置传输模式 5.2.19. AT+SAVETRANSLINK—保存透传到 Flash 5.2.20. AT+CIPSTO—设置 TCP 服务器器超时时间 5.2.21. AT+PING—Ping 功能 5.2.22. AT+CIUPDATE—通过 Wi-Fi 升级软件 5.2.23. AT+CIPDINFO—接收⽹网络数据时是否提示对端 IP 和端⼝口 5.2.24. +IPD—接收⽹网络数据 5.2.25. AT+CIPRECVMODE—设置 TCP 连接的数据接收⽅方式 5.2.26. AT+CIPRECVDATA—被动接收模式时，读取缓存的 TCP 数据 5.2.27. AT+CIPRECVLEN—被动接收模式时，查询缓存 TCP 数据的⻓长度 5.2.28. AT+CIPSNTPCFG—设置时域和 SNTP 服务器器 5.2.29. AT+CIPSNTPTIME—查询 SNTP 时间 5.2.30. AT+CIPDNS_CUR—⾃自定义 DNS 服务器器，不不保存到 Flash 5.2.31. AT+CIPDNS_DEF—⾃自定义 DNS 服务器器，保存到 Flash ........................................................................................ ............................................................................................................. ........................................................................................................ .............................................................................. .................................................................................................... ....................................................................... ........................................... .................................................................... ................................................................................. ...................................................................................................... ........................................................................................................... ............................................................................................ ............................................. ..................................................................................................... ................................................................................... .................................................................................... ................................................................................................................... .......................................................................................... ........................................................... ................................................................................................................... ................................................................ .................................................... ............................................... ............................................................................ .......................................................................................... ......................................................... .............................................................. 44 45 46 46 47 48 48 49 49 50 50 50 51 51 52 53 53 53 54 54 55 55 56 56 56 57 57

A. 附录 A ................................................................................................................................................... 59 B. 附录 B .................................................................................................................................................. 60 C. Q&A ...................................................................................................................................................... 61

1. 1. 前⾔言前⾔言乐鑫官⽅方发布 ESP8266 AT 固件，供⽤用户直接下载使⽤用。同时，乐鑫也提供 AT ⼯工程供⽤用户在乐鑫 AT 的基础上，⾃自⾏行行开发客制化 AT 固件。本⽂文包含客制化 AT 固件的⽅方法，AT 固件的烧录，以及乐鑫已有的 AT 指令集说明。 ⚠ 注意： • 请确保正确的 BIN (/ESP8266_NONOS_SDK/bin/at) 已经参考 ESP8266_NONOS_SDK/bin/at 中 readme.txt 烧录到 ESP8266 模块，再执⾏行行⽂文档中的 AT 指令。 • AT 底层已占⽤用 system_os_task 优先级 0 和 1，如果⽤用户基于 AT 开发，仅⽀支持建⽴立⼀一个优先级为 2 的任务。 1.1. 客制化 AT 固件 1.1.1. 编译 AT ⼯工程⽤用户如需编译客制化 AT 源代码，新增⾃自定义的 AT 指令，请将 example 中的⽂文件夹 at 拷⻉贝到对应版本的 ESP8266_NONOS_SDK 根⽬目录下，再进⼊入 at ⽂文件夹进⾏行行开发及编译。详细编译说明，可参考 ESP8266 ⼊入⻔门指南。 1.1.2. 客制化功能 • OTA 功能： - 乐鑫发布的官⽅方 AT 固件，默认⽀支持使⽤用 AT+CIUPDATE 指令，从乐鑫云下载升级到新版本的 AT 固件。 - 如果⽤用户⾃自⾏行行客制化 AT 固件，则需要⾃自⾏行行实现 OTA 升级功能，从⽤用户⾃自⼰己的云端下载升级⾃自定义的新版本固件。乐鑫在 at_upgrade.c 中提供了了 OTA 示例例，以供参考。 • SmartConﬁg 功能： - 乐鑫发布的官⽅方 AT 固件，默认⽀支持 AT+CWSTARTSMART 和 AT+CWSTOPSMART 指令. - 如果⽤用户⽆无需 SmartConﬁg 功能，可以⾃自⾏行行重新编译 at，在 user_conﬁg.h 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE，从⽽而减⼩小 bin size，节省内存。 1.1.3. 新增⾃自定义 AT 指令⾃自定义 AT 指令命名时，使⽤用英⽂文字符，请勿使⽤用其他特殊字符或数字。 Espressif ! /!1 62 2019.02 !

分享到：

赞收藏

资料库

中文(Esp8266_at_instruction_set_cn).pdf

相关推荐

树莓派

热门标签

最新资料