ESP-AT 用户指南 Choose target... Choose version... 入门 AT Binary 列表 AT 命令集 AT 命令示例 AT 版本简介 编译和开发 第三方定制化 AT 命令和固件 FAQ 缩写词索引 特别声明 关于 ESP-AT ESP-AT 用户指南 » ESP-AT 用户指南 在 GitHub 上修改 ESP-AT 用户指南 [English] 这里是乐鑫 ESP-AT 开发框架的文档中心。ESP-AT 作为由 Espressif Systems 发起和提供技术支持的官方项目，适用于 Windows、Linux、macOS 上的 ESP32、ESP32-C2、ESP32-C3、ESP32-C6、和 ESP32-S2 系列芯片。 本文档仅包含针对 ESP32-C3 芯片的 ESP-AT 使用。如需了解其他芯片，请在页面左上方的下拉菜单中选择您的目标芯片。 入门 AT Binary 列表 AT 命令集 AT 命令示例 编译和开发 第三方定制化 AT 命令和固件 索引 提供有关此文档的反馈 下一页 © 版权所有 2016 - 2025 乐鑫信息科技（上海）股份有限公司. 利用 Sphinx 构建，使用了 主题 based on Read the Docs Sphinx Theme. Download PDF ESP-AT 用户指南 Choose target... Choose version... 入门 ESP-AT 是什么 技术选型 硬件连接 下载指导 AT Binary 列表 AT 命令集 AT 命令示例 AT 版本简介 编译和开发 第三方定制化 AT 命令和固件 FAQ 缩写词索引 特别声明 关于 ESP-AT ESP-AT 用户指南 » 入门指南 在 GitHub 上修改 入门指南 [English] 本指南详细介绍 ESP-AT 是什么、技术选型、如何连接硬件、以及如何下载和烧录 AT 固件，由以下章节组成： ESP-AT 是什么 技术选型 硬件连接 下载指导 如果您尚不了解 ESP-AT 工程，请阅读 ESP-AT 是什么。 如果您想学习如何使用 ESP-AT，请首先阅读 技术选型，帮助您选型硬件和软件，再阅读 硬件连接，了解所需的硬件以及硬件之间如何连接，然后再阅读 下载指导，了解如何下载和烧录 AT 固件。 提供有关此文档的反馈 上一页 下一页 © 版权所有 2016 - 2025 乐鑫信息科技（上海）股份有限公司. 利用 Sphinx 构建，使用了 主题 based on Read the Docs Sphinx Theme. Download PDF ESP-AT 用户指南 Choose target... Choose version... 入门 ESP-AT 是什么 技术选型 硬件连接 下载指导 AT Binary 列表 AT 命令集 AT 命令示例 AT 版本简介 编译和开发 第三方定制化 AT 命令和固件 FAQ 缩写词索引 特别声明 关于 ESP-AT ESP-AT 用户指南 » 入门指南 » ESP-AT 是什么 在 GitHub 上修改 ESP-AT 是什么 [English] 重要 在使用 ESP-AT 前，请仔细阅读 特别声明，并遵循其中的各项条款和注意事项。 ESP-AT 是乐鑫开发的可直接用于量产的物联网应用固件，旨在降低客户开发成本，快速形成产品。通过 ESP-AT 命令，您可以快速加入无线网络、连接云平台、实现数据通信以及远程控制等功能，真正的通过无线通讯实现万物互联。 ESP-AT 是基于 ESP-IDF 实现的软件工程。它使 ESP32-C3 模组作为从机，MCU 作为主机。MCU 发送 AT 命令给 ESP32-C3 模组，控制 ESP32-C3 模组执行不同的操作，并接收 ESP32-C3 模组返回的 AT 响应。ESP-AT 提供了大量功能不同的 AT 命令，如 Wi-Fi 命令、TCP/IP 命令、Bluetooth LE 命令、Bluetooth 命令、MQTT 命令、HTTP 命令、Ethernet 命令等。 ESP-AT 概览 AT 命令以 “AT” 开始，代表 Attention，以新的一行 (CR LF) 为结尾。输入的每条命令都会返回 OK 或 ERROR 的响应，表示当前命令的最终执行结果。注意，所有 AT 命令均为串行执行，每次只能执行一条命令。因此，在使用 AT 命令时，应等待上一条命令执行完毕后，再发送下一条命令。如果上一条命令未执行完毕，又发送了新的命令，则会返回 busy p... 提示。更多有关 AT 命令的信息可参见 AT 命令集。 默认配置下，MCU 通过 UART 连接至 ESP32-C3 模组、发送 AT 命令以及接收 AT 响应。但是，您也可以根据实际使用情况修改程序，使用其他的通信接口，例如 SDIO。 同样，您也可以基于 ESP-AT 工程，自行开发更多的 AT 命令，以实现更多的功能。 提供有关此文档的反馈 上一页 下一页 © 版权所有 2016 - 2025 乐鑫信息科技（上海）股份有限公司. 利用 Sphinx 构建，使用了 主题 based on Read the Docs Sphinx Theme. Download PDF ESP-AT 用户指南 Choose target... Choose version... 入门 AT Binary 列表 AT 命令集 AT 命令示例 AT 版本简介 编译和开发 第三方定制化 AT 命令和固件 FAQ 缩写词索引 特别声明 应用场景验证 兼容性 服务器升级注意事项 无线方案问题处理 使用限制 责任限制 第三方软件和技术 数据保护 版本更新与维护 声明更新 用户责任 关于 ESP-AT ESP-AT 用户指南 » 特别声明 在 GitHub 上修改 特别声明 [English] 感谢您选择使用 ESP-AT 方案（固件）。为了确保您对本方案（本固件）的使用安全、合法且符合预期效果，请仔细阅读以下特别声明。本声明旨在明确用户在使用本方案（本固件）过程中需要遵循的各项条款和注意事项。通过继续使用本方案（本固件），您即表示接受并同意遵守这些条款。 应用场景验证 本方案（本固件）为通用版本，尽管针对各种场景做了大量的测试，但测试用例仍存在某些应用场景无法覆盖的风险，在决定基于本方案（本固件）进行商用量产前，请结合自己的应用场景，进行充足且全面的验证。 兼容性 由于技术日新月异，当某一新的技术、方案或标准出现时，可能导致兼容性问题，请结合自己产品做好相应的测试验证，并关注本方案（本固件）的新版本发布情况。 服务器升级注意事项 当对服务器进行升级时，包括但不限于操作系统升级、工具升级、证书升级等，请务必在正式升级前进行测试验证，避免因服务器变动导致的连接问题。 无线方案问题处理 无线方案易受外部因素影响，且问题定位复杂。请结合自身产品和云平台，规划好远程 OTA 和远程问题信息获取的解决方案，否则可能需要用户现场提供日志、数据包等必需的信息进行问题分析。 使用限制 用户不得将本方案（本固件）用于非法活动或违反相关法律法规的用途。用户应确保其使用本方案（本固件）的行为符合所有适用的法律和法规，我司不对因非法使用本方案（固件）而产生的任何后果负责。 责任限制 对于因使用本方案（本固件）造成的直接、间接、偶然、特殊或继发性的损害（包括但不限于数据丢失、利润损失、业务中断等），我司不承担任何责任，即使已被告知可能发生此类损害。 第三方软件和技术 本方案（本固件）可能包含第三方的软件或技术，我司对这些第三方软件或技术的适用性和合规性不承担责任。用户应遵循第三方的许可协议和使用条款。 数据保护 用户在使用本方案（本固件）过程中产生的数据应由用户自行负责保护和备份。我司对因数据丢失或泄露引起的任何损失不承担责任。 版本更新与维护 本方案（本固件）会不定期进行维护更新及版本发布，请自行关注版本状态，恕不另行通知。 声明更新 本声明条款可能会不定期更新，恕不另行通知。 用户责任 强烈建议用户认真阅读并严格遵守本声明条款，由于未遵守导致的风险，需由用户承担。 感谢您的理解与配合！ 提供有关此文档的反馈 上一页 下一页 © 版权所有 2016 - 2025 乐鑫信息科技（上海）股份有限公司. 利用 Sphinx 构建，使用了 主题 based on Read the Docs Sphinx Theme. Download PDF ESP-AT 用户指南 Choose target... Choose version... 入门 AT Binary 列表 ESP32-C3 AT 发布版固件 AT 固件简介 AT 命令集 AT 命令示例 AT 版本简介 编译和开发 第三方定制化 AT 命令和固件 FAQ 缩写词索引 特别声明 关于 ESP-AT ESP-AT 用户指南 » AT 固件 在 GitHub 上修改 AT 固件 [English] 本文档包含以下小节： 下载 ESP32-C3 AT 发布版固件 AT 固件简介：AT 固件包含哪些二进制文件及其作用 备注 若需下载其他芯片系列的发布版固件，请在页面左上方的下拉菜单栏选择相应的芯片，即可跳转至该芯片的文档进行下载。 AT 固件简介 ESP-AT 固件包含了若干个特定功能的二进制文件： build ├── at_customize.bin // 二级分区表（用户分区表，列出了 mfg_nvs 分区以及 fatfs 分区的起始地址和分区大小） ├── bootloader │ └── bootloader.bin // 启动加载器 ├── customized_partitions │ └── mfg_nvs.bin // 出厂配置参数，参数值见同级目录下的 mfg_nvs.csv ├── esp-at.bin // AT 应用固件 ├── factory │ └── factory_xxx.bin // 特定功能的二进制文件合集，您可以仅烧录本文件到起始地址为 0 的 flash 空间中，或者根据 download.config 文件中的信息将若干个二进制文件烧录到 flash 中对应起始地址的空间中。 ├── partition_table │ └── partition-table.bin // 一级分区表（系统分区表） └── ota_data_initial.bin // OTA 数据初始化文件 提供有关此文档的反馈 上一页 下一页 © 版权所有 2016 - 2025 乐鑫信息科技（上海）股份有限公司. 利用 Sphinx 构建，使用了 主题 based on Read the Docs Sphinx Theme. Download PDF ESP-AT 用户指南 Choose target... Choose version... 入门 AT Binary 列表 ESP32-C3 AT 发布版固件 特别声明 ESP32-C3-MINI-1 系列 订阅 AT 版本发布 AT 固件简介 AT 命令集 AT 命令示例 AT 版本简介 编译和开发 第三方定制化 AT 命令和固件 FAQ 缩写词索引 特别声明 关于 ESP-AT ESP-AT 用户指南 » AT 固件 » 发布的固件 在 GitHub 上修改 发布的固件 [English] 推荐下载最新版本的固件。目前，乐鑫发布了以下 ESP32-C3 系列模组的 AT 固件。 备注 当前的 ESP32-C3 AT 固件支持 ESP32-C3 ECO0 (Rev v0.0) ~ ECO4 (Rev v0.4) 系列芯片（包括 ECO0 和 ECO4），暂不支持 ESP32-C3 的 ECO6 (Rev v1.0)、ECO7 (Rev v1.1) 以及之后的芯片。 如果您的模组没有发布的固件，可以使用相同硬件配置的模组的固件（点击 ESP-AT 固件差异 查看与您的模组硬件配置相同的固件），或者如果您需要修改下面的配置，则可以通过 at.py 工具 修改发布的固件，为您的模组生成新的固件。 修改 UART 配置 修改 Wi-Fi 配置 修改证书和密钥配置 修改 GATTS 配置 特别声明 在使用下面的 AT 固件前，请仔细阅读 特别声明，并遵循其中的各项条款和注意事项。 ESP32-C3-MINI-1 系列 v3.3.0.0 ESP32-C3-MINI-1-AT-V3.3.0.0.zip （推荐） v3.2.0.0 ESP32-C3-MINI-1-AT-V3.2.0.0.zip v2.4.2.0 ESP32-C3-MINI-1-AT-V2.4.2.0.zip v2.4.1.0 ESP32-C3-MINI-1-AT-V2.4.1.0.zip v2.4.0.0 ESP32-C3-MINI-1-AT-V2.4.0.0.zip v2.3.0.0 ESP32-C3-MINI-1-AT-V2.3.0.0.zip v2.2.0.0 ESP32-C3-MINI-1-AT-V2.2.0.0.zip 订阅 AT 版本发布 请参考 订阅 AT 版本发布 文档订阅我们的版本发布通知，及时获取最新版本的发布情况。 提供有关此文档的反馈 上一页 下一页 © 版权所有 2016 - 2025 乐鑫信息科技（上海）股份有限公司. 利用 Sphinx 构建，使用了 主题 based on Read the Docs Sphinx Theme. Download PDF ESP-AT 用户指南 Choose target... Choose version... 入门 AT Binary 列表 AT 命令集 AT 命令示例 AT 版本简介 编译和开发 如何本地编译 AT 工程 如何在 GitHub 网页上编译 AT 工程 如何修改 AT 管脚 如何添加自定义 AT 命令 如何提高 ESP-AT 吞吐性能 如何更新 mfg_nvs 分区 如何更新出厂参数 如何更新 PKI 配置 如何自定义低功耗蓝牙服务 如何自定义分区 如何增加一个新的模组支持 如何实现 SPI AT 如何基于乐鑫服务器实现自己的 OTA 管理 如何更新 ESP-IDF 版本 ESP-AT 固件差异 ESP32-C3 系列 支持的命令集 硬件差异 支持的模组 如何从 GitHub 下载最新临时版本 AT 固件 at.py 工具 ESP-AT API 参考 第三方定制化 AT 命令和固件 FAQ 缩写词索引 特别声明 关于 ESP-AT ESP-AT 用户指南 » 如何编译和开发自己的 AT 工程 » ESP-AT 固件差异 在 GitHub 上修改 ESP-AT 固件差异 [English] 本文档比较了同一 ESP32-C3 系列的 AT 固件在支持的命令集、硬件、模组方面的差异。 ESP32-C3 系列 本节介绍以下 ESP32-C3 系列 AT 固件的区别： ESP32-C3-MINI-1-AT-Vx.x.x.x.zip（本节简称为 MINI-1 Bin） 支持的命令集 下表列出了官方适配的 ESP32-C3 系列 AT 固件默认支持哪些命令集（用 表示）、默认不支持但可以在配置和编译 ESP-AT 工程后支持的命令集（用 表示）、完全不支持的命令集（用 表示），下表没有列出的命令集也为完全不支持的命令集。正式发布的固件见 AT 固件，已适配但未发布的模组固件，需要自行编译。自行编译的固件无法从乐鑫官方服务器进行 OTA 升级。 命令集 MINI-1 Bin base user Wi-Fi TCP-IP mDNS WPS SmartConfig ping MQTT HTTP Bluetooth LE Bluetooth LE HID BluFi FileSystem driver WPA2 enterprise Web server WebSocket OTA 硬件差异 硬件 MINI-1 Bin Flash 4 MB PSRAM UART 管脚 1 TX: 7 RX: 6 CTS: 5 RTS: 4 1 UART 管脚可自定义，详情请参考 如何设置 AT 端口管脚。 支持的模组 下表列出了官方发布的 ESP32-C3 系列 AT 固件默认支持哪些模组或芯片（用 表示）、默认不支持但可以通过 at.py 工具 修改后支持的模组（用 表示），以及完全不支持的模组（用 表示）。对于完全不支持的模组，您可以 本地编译 ESP-AT 工程 修改您需要的配置后支持。 模组/芯片 MINI-1 Bin ESP32-C3-MINI-1/1U ESP32-C3-WROOM-02/02U ESP8685-WROOM-01 ESP8685-WROOM-03 ESP8685-WROOM-04 ESP8685-WROOM-05 ESP8685-WROOM-06 ESP8685-WROOM-07 提供有关此文档的反馈 上一页 下一页 © 版权所有 2016 - 2025 乐鑫信息科技（上海）股份有限公司. 利用 Sphinx 构建，使用了 主题 based on Read the Docs Sphinx Theme. Download PDF ESP-AT 用户指南 Choose target... Choose version... 入门 AT Binary 列表 AT 命令集 AT 命令示例 AT 版本简介 编译和开发 如何本地编译 AT 工程 如何在 GitHub 网页上编译 AT 工程 如何修改 AT 管脚 ESP32-C3 系列 修改日志端口管脚 修改命令端口管脚 如何添加自定义 AT 命令 如何提高 ESP-AT 吞吐性能 如何更新 mfg_nvs 分区 如何更新出厂参数 如何更新 PKI 配置 如何自定义低功耗蓝牙服务 如何自定义分区 如何增加一个新的模组支持 如何实现 SPI AT 如何基于乐鑫服务器实现自己的 OTA 管理 如何更新 ESP-IDF 版本 ESP-AT 固件差异 如何从 GitHub 下载最新临时版本 AT 固件 at.py 工具 ESP-AT API 参考 第三方定制化 AT 命令和固件 FAQ 缩写词索引 特别声明 关于 ESP-AT ESP-AT 用户指南 » 如何编译和开发自己的 AT 工程 » 如何设置 AT 端口管脚 在 GitHub 上修改 如何设置 AT 端口管脚 [English] 本文档介绍了如何修改 ESP32-C3 系列固件中的 AT port 管脚。默认情况下，ESP-AT 使用两个 UART 接口作为 AT 端口：一个用于输出日志（以下称为日志端口），另一个用于发送 AT 命令和接收响应（以下称为命令端口）。 要修改 ESP32-C3 设备的 AT 端口管脚，应该： 克隆 ESP-AT 工程。 在 menuconfig 配置工具或 factory_param_data.csv 表格中修改对应管脚。 编译工程。 将新的 bin 文件烧录进设备。 本文档重点介绍如何修改管脚，点击上面的链接了解其它步骤的详细信息。 备注 使用其它接口作为 AT 命令接口请参考 使用 AT SPI 接口 , AT through SPI 和 使用 AT 套接字接口 。 ESP32-C3 系列 ESP32-C3 AT 固件的日志端口和命令端口管脚可以自定义为其它管脚，请参阅 《ESP32-C3 技术参考手册》 查看可使用的管脚。 修改日志端口管脚 默认情况下，乐鑫提供的 ESP32-C3 AT 固件使用以下 UART0 管脚输出日志： TX：GPIO21 RX：GPIO20 在编译 ESP-AT 工程时，可使用 menuconfig 配置工具将其修改为其它管脚： ./build.py menuconfig –> Component config –> ESP System Settings –> Channel for console output –> Custom UART ./build.py menuconfig –> Component config –> ESP System Settings –> UART TX on GPIO# ./build.py menuconfig –> Component config –> ESP System Settings –> UART RX on GPIO# 修改命令端口管脚 默认情况下，UART1 用于发送 AT 命令和接收 AT 响应，其管脚定义在 factory_param_data.csv 表格中的 uart_port、uart_tx_pin、uart_rx_pin、uart_cts_pin 和 uart_rts_pin 列。 您可以直接在 factory_param_data.csv 表中修改端口管脚： 打开您本地的 factory_param_data.csv。 找到模组所在的行。 根据需要设置 uart_port （如果希望 AT 日志口同时用作 AT 命令口，则需要修改此行，同时保证下面的 uart_tx_pin 和 uart_rx_pin 和 AT 日志口的管脚一样）。 根据需要设置 uart_tx_pin 和 uart_rx_pin （您需要保证将要修改的管脚，未被其它功能使用，包括 AT 日志口的管脚）。 若不需要使用硬件流控功能，请将 uart_cts_pin 和 uart_rts_pin 设置为 -1。 保存表格。 提供有关此文档的反馈 上一页 下一页 © 版权所有 2016 - 2025 乐鑫信息科技（上海）股份有限公司. 利用 Sphinx 构建，使用了 主题 based on Read the Docs Sphinx Theme. Download PDF ESP-AT 用户指南 Choose target... Choose version... 入门 AT Binary 列表 AT 命令集 AT 命令示例 AT 版本简介 编译和开发 第三方定制化 AT 命令和固件 FAQ 缩写词索引 特别声明 关于 ESP-AT ESP-AT 用户指南 » Index of Abbreviations 在 GitHub 上修改 Index of Abbreviations A2DP Advanced Audio Distribution Profile 高级音频分发框架 ADC Analog-to-Digital Converter 模拟数字转换器 ALPN Application Layer Protocol Negotiation 应用层协议协商 AT AT stands for “attention”. AT 是 attention 的缩写。 AT command port The port that is used to send AT commands and receive responses. More details are in the AT port introduction. AT 命令端口 也称为 AT 命令口，用于发送 AT 命令和接收响应的端口。更多介绍请参考 AT 端口。 AT log port The port that is used to output log. More details are in the AT port introduction. AT 日志端口 也称为 AT 日志口，用于输出 AT 日志的端口。更多介绍请参考 AT 端口。 AT port AT port is the general name of AT log port (that is used to output log)