ESP8266官方AT固件v2.2.1.0烧录与配置指南

简介：ESP8266-IDF-AT_V2.2.1.0.zip 是乐鑫官方发布的 ESP8266 AT 固件包，面向物联网开发者与嵌入式工程师，用于通过 AT 指令快速实现 Wi-Fi 联网、数据透传和设备控制，适合智能硬件原型验证及量产评估。压缩包共 23 个文件，其中 14 个 bin 文件涵盖 bootloader、esp-at.bin、partition_table 等固件镜像，3 个 PDF 分别提供用户指南与版本发布说明，另有 sdkconfig、elf、map、json、config、log 等配置与调试辅助文件，整体约 14.65MB。目前已有 2601 人学习下载。该版本基于 IDF 框架开发，在性能、安全、稳定性及兼容性上均有更新，并修复了已知问题。开发者将固件烧录到模块后，可用 AT 命令灵活配置 STA/AP 模式、连接目标网络并完成数据收发；随包文档对固件结构、编译配置和升级流程做了清晰说明，有助于初学者快速上手，也能为资深工程师在集成排错时提供参考。

1. ESP8266 官方 AT 固件 v2.2.1.0 是哪一类固件，它和 Arduino 固件有什么不同

ESP8266 官方 AT 固件 ESP8266-IDF-AT_V2.2.1.0.zip，是乐鑫把 WiFi 协议栈封装成串口指令的二进制包。把它烧进芯片后，ESP8266 就变成一个“串口转 WiFi 模块”：主控 STM32、单片机或 PC 只需要通过 UART 发AT+CWJAP、AT+CIPSTART这类命令，就能完成连热点、建 TCP、收发数据，自己不用碰 TCP/IP 协议栈。这个版本是基于 ESP-IDF 编译的 AT 固件，所以也叫 IDF-AT，兼容传统 AT 指令集，同时把 OTA、分区表、SNTP、MQTT 这些底层能力也带进来了。

很多刚接触 esp8266 的人会直接在 Arduino IDE 里写点灯、读传感器，那是把 ESP8266 当主控 MCU 用。而 AT 固件的定位完全相反：它不跑任何用户代码，没有 Arduino 运行时，也看不到 NodeMCU 的 Lua 环境。你得到的只是一个能听懂串口 AT 命令的“无线网卡”。对做产品的团队来说，AT 方案的价值在于业务固件和 WiFi 固件彻底解耦，WiFi 出问题直接升级 AT 固件，主控代码不用改。2022 年乐鑫发布的 V2.2.1.0 是这一条产品线里比较稳的版本，很多模组厂商的出厂 AT 固件还在用它。

2. 烧录 IDF-AT_V2.2.1.0 前，先看懂固件包的文件和 flash 分区规划

2.1 为什么首选 IDF-AT，而不是老 Non-OS AT 或 Arduino 固件

在烧录之前，先要分清两代 AT 固件。老 Non-OS AT 基于 ESP8266 Non-OS SDK，整个固件就几个 bin，烧录地址固定，分区靠厂商约定，用户改不了。新 IDF-AT 基于 ESP-IDF，系统带分区表、NVS、OTA 机制，AT 固件的模块化程度更高，后续可以自己用idf.py build重新编译，甚至往 AT 固件里加私有命令。V2.2.1.0 这个名字里的 IDF 已经说明它属于这条新线。

另一个对比对象是 Arduino 固件。很多 ESP8266 开发板出厂预装的是 NodeMCU 固件，用户拿到后可以在 Lua 里写脚本，也可以用 Arduino IDE 重刷。但 Arduino 固件把决定权交给了用户，你不写代码它就什么都不干。AT 固件则是“拿来即用”，上电后串口就有ready，发AT回OK，这对硬件工程师和上位机开发者非常友好。如果你是入门，想最快看到 WiFi 功能跑起来，AT 固件比 Arduino IDE 搭环境更直接。如果后续你要控制 GPIO 拉高拉低、读 ADC、跑自定义协议，AT 固件就不合适了，那要换回 Arduino 或 MicroPython。

IDF-AT 的分区表和 OTA 机制也带来一个使用变化：刷错了分区表，固件可能起不来。所以不要只认一个at.bin就烧，先看包里的文件结构。

2.2 压缩包里的 bin 文件和地址，怎么读最不容易错

官方发布的 ESP8266-IDF-AT_V2.2.1.0.zip 解压后，一般会有 README、Release Notes、烧录工具说明，以及bin目录。bin 目录里的文件不是每个都要烧，但每个都要知道它做什么。以最常见的 ESP-IDF 构建产物为例：

这张表里的地址是按 ESP-IDF 默认 partition 布局写的，你的固件包不一定完全一样。更可靠的办法是直接看压缩包里有没有flasher_args.json或flash_download_list文件，这是 ESP-IDF 构建时自动生成的烧写清单，里面有每个文件的正确偏移。用下面的命令可以把它格式化读出来：

python -m json.tool flasher_args.json

输出里会有一串flash_files字段，结构类似"0x10000": "build/esp-at.bin"。这一步花两分钟看，能避免你拿着网上搜来的老 Non-OS AT 地址烧到一个基于 IDF 的固件上。老地址一般是0x01000烧user1.bin，IDF-AT 如果照抄就会把 partition-table 覆盖掉，开机只看到乱码。

2.3 烧录前用 esptool 读取模组 flash 容量，决定能不能刷

IDF-AT_V2.2.1.0 对 flash 容量有要求，不能拿 512KB 的 ESP-01 硬上。烧录前先用 esptool 读出芯片和 flash 信息。安装 esptool 后执行：

esptool.py --chip esp8266 --port /dev/ttyUSB0 --before default_reset flash_id

执行成功会看到类似下面的输出：

Detecting chip type... ESP8266 Manufacturer: 5e Device: 4016 Detected flash size: 4MB

重点看两个东西：Manufacturer和Detected flash size。IDF-AT 固件建议在 4MB flash 的模组上使用，如果你的板子读出来是 1MB 或 2MB，先查压缩包 README 里有没有裁剪版本，没有就不要刷 V2.2.1.0 的完整 bin，否则很容易出现 App 区写不下、启动后AT无响应的问题。顺便看一眼 flash mode，QIO 和 DIO 在读取输出里不直接显示，但只要烧录时选dio，绝大多数 ESP8266 模组都能起来。

提示：如果flash_id卡在Connecting...，说明芯片没有进入下载模式。把 GPIO0 拉低，按一下复位键再试，这是 ESP8266 烧录最常见的失败原因。

3. 用 esptool.py 把 ESP8266 官方 AT 固件烧进 flash：命令和参数说明

3.1 先检查串口与芯片，再进入刷机状态

烧录前置工作比命令本身更容易出错。首先确认串口驱动正常，Linux 下一般是/dev/ttyUSB0，Windows 下是COM3之类的编号。测试串口能通的最快方法是读一次芯片信息：

esptool.py --chip esp8266 --port /dev/ttyUSB0 --baud 115200 chip_id

返回Chip is ESP8266EX说明串口通道没问题。如果提示Failed to connect，检查设备是否被 minicom、串口助手或 Arduino IDE 的串口监视器占用。ESP8266 的下载模式不需要手动按住 GPIO0，只要--before default_reset，esptool 会自动通过 RTS/DTR 信号线复位到 bootloader，前提是你的 USB 转串口模块带了 DTR/RTS，并且接线接齐了。

3.2 从 flasher_args.json 生成烧录映射并执行 write_flash

拿到flasher_args.json后，可以用jq把偏移和文件对应关系提取出来，避免手写写错：

jq -r '.flash_files | to_entries[] | "\(.key) \(.value)"' flasher_args.json

输出可能是这样：

0x0 bootloader.bin 0x8000 partition-table.bin 0xf000 phy_init_data.bin 0x10000 esp-at.bin 2020 0x210000 at_customize.bin

注意不要把2020后面的数字当成普通地址，那一段是我用来演示格式的占位。真正烧录时，把上面每一行地址和文件都传给write_flash。一个完整命令长这样：

esptool.py --chip esp8266 --port /dev/ttyUSB0 --baud 460800 \ --before default_reset --after hard_reset \ write_flash --flash_mode dio --flash_size 4MB \ 0x0 bootloader.bin \ 0x8000 partition-table.bin \ 0xf000 phy_init_data.bin \ 0x10000 esp-at.bin

如果你希望从头清干净，可以在烧录前先整片擦除：

esptool.py --chip esp8266 --port /dev/ttyUSB0 erase_flash

整片擦除会把模组里的出厂 WiFi 校准数据一起清掉。这里要说明一下：ESP8266 的 RF 校准参数有一部分存在 flash 的 NVS / phy_init 分区，烧录命令里已经包含了phy_init_data.bin，所以擦除后再写入 AT 固件是安全的。如果只擦除不写任何数据就断电，模组才会出现 WiFi 信号弱、连接不稳定之类的问题。

--flash_mode dio这个参数尤其重要。很多 ESP-12F 模组厂商出厂默认用 QIO，但 QIO 需要全部四根 SPI 数据线都连到 flash，个别精简板子只拉了 DIO 模式所需的两根线。这种情况用 QIO 烧录后，上电 log 能跑，AT就是不出OK，原因就在这。先统一用 DIO，能覆盖绝大多数 ESP8266 模组。

--baud 460800不是越高越好。如果你的 USB 转串口芯片是老版 CH340G，或者杜邦线超过 15cm，460800 容易丢包。刷不进去的时候把波特率降到115200，不要在第一次烧录时急着追求速度。--after hard_reset表示烧完自动复位，复位后固件直接启动，省得手动断电。

3.3 烧录后如何确认 AT 固件正常运行

烧录完成后，打开串口工具，波特率设 115200，复位看启动日志。ESP8266 的 ROM bootloader 会以 74880 波特率打印一段启动信息，AT 固件本身的串口日志在 115200。如果你用 115200 打开，可能只看得到后半段，这是正常的。

启动日志稳定后，发两个最基本命令：

AT

返回OK，说明 AT 解析器在工作。再查版本：

AT+GMR

返回内容里会包含2.2.1.0和对应的编译信息，这能确认你烧的确实是 IDF-AT_V2.2.1.0，而不是某个第三方改过的固件。版本号对不上时，先怀疑烧录地址，特别是partition-table.bin地址对不对。分区表错乱会让系统跳过 factory 分区里的主固件，可能启动到一个空白 OTA 分区，这时AT无响应，但 flash_id 又能正常读到芯片。

3.4 烧录失败的常见原因

提示：烧录工具里选的--flash_size 4MB并不是直接写进 flash 的，真正决定可用空间的是分区表。如果板子实际 flash 只有 2MB，却按 4MB 烧，esptool 会提示File is not multiple of flash size，这时不能强行继续，要去找 2MB 版本固件。

4. 跑通 WiFi 功能：从连接 AP 到 TCP 透传，把 AT 固件当网桥用

4.1 用 CWMODE/CWLAP/CWJAP 完成 Station 模式接入

AT 固件上电后默认可能是 Station 模式，也可能保留上次配置。最稳妥的做法是一进制式清掉回显，再显式设置模式。进入串口终端后执行：

ATE0 AT+CWMODE=1

ATE0关闭命令回显，让后面分析输出更干净。AT+CWMODE=1把 WiFi 切成 Station 模式，也就是 ESP8266 作为客户端去连路由器。如果你要做 AP 模式，用2，SoftAP+Station 共存用3。做网桥设备时一般只用1，功耗和中断都更少。

然后扫描附近热点，确认 WiFi 环境：

AT+CWLAP

返回是一行一行的+CWLAP:(加密方式,SSID,信号强度,MAC,频道)，比如：

+CWLAP:3,"MyWiFi",-45,"a0:xx:xx:xx:xx:xx",6

中间的负数是 RSSI，单位 dBm，数值越接近 0 信号越强。-45很好，-80基本连不上。扫描结果里能看到你要连的 SSID，就可以发起连接：

AT+CWJAP="MyWiFi","password123"

连接成功回WIFI CONNECTED和WIFI GOT IP。如果只看到WIFI CONNECTED没有GOT IP，问题多半在路由器：可能是开了 MAC 白名单、DHCP 地址池耗尽，或者热点需要网页认证。查询当前连接状态用：

AT+CWJAP?

返回+CWJAP:1表示已连接，+CWJAP:0表示断开。想让设备每次上电都自动重连，打开自动连接参数：

AT+CWAUTOCONN=1

这个参数是在断开后靠近 AP 范围内的自动重连，不等同于 TCP 层重连，后面透传还会遇到另一层问题。

4.2 固定 IP 并做网络连通性检查：CIPSTA 和 PING

如果主机侧的业务逻辑依赖 ESP8266 的 IP 地址，比如主控要定时往固定 IP 发数据，那就不要依赖 DHCP 动态分配。先用下面命令查看当前 IP：

AT+CIPSTA?

返回三行，分别是 IP、网关、子网掩码。要改成静态 IP，执行：

AT+CIPSTA="192.168.1.50","192.168.1.1","255.255.255.0"

注意引号和逗号都不能少，AT 固件对字符串格式很严格。设置完再查一次确认生效。静态 IP 配置的常见坑是 IP 与 DHCP 地址池冲突，造成设备刚连上网就被路由器踢掉。建议把静态 IP 设在 DHCP 地址池范围之外，例如池子是192.168.1.100到192.168.1.200，用192.168.1.50。

网络层连通性用 PING 验证：

AT+PING="192.168.1.1"

返回类似+PING:10的是往返时间，单位毫秒。如果 PING 网关能通，说明 LAN 通；再 PING 一个公网地址，比如AT+PING="223.5.5.5"，能通才说明 ESP8266 的 WiFi 链路和路由出口都没问题。PING 网关都超时，检查AT+CWJAP?是否还是1，以及静态 IP 的网关参数是否填错。

这里说一个很现实的情况：如果你连的是商场、酒店的公共 WiFi，连上 AP 后手机会跳出一个“打开浏览器并连接”的认证页，AT 固件里没有浏览器内核，所以AT+CWJAP能返回WIFI CONNECTED，但 PING 网关或者公网会失败。这种场景只能让主控通过AT+CIPSTART主动访问认证服务器，提交账号密码后拿到授权，否则固件本身是“无解”的。

4.3 用 CIPMODE/CIPSEND 跑一次 TCP 透传，并保留自动重连

WiFi 功能完整性的最后一步是验证 TCP 数据面。先关闭多连接，使用单连接模式，这样参数最简单：

AT+CIPMUX=0

然后建立到服务端的 TCP 连接。如果你手头没有服务器，可以先用电脑开一个netcat监听端口，例如nc -l 8080。ESP8266 这边执行：

AT+CIPSTART="TCP","192.168.1.100",8080

192.168.1.100换成电脑在局域网里的 IP，端口保持一致。连接成功返回CONNECT。紧接着进入透传模式：

AT+CIPMODE=1

AT+CIPMODE=1开启透传，这之后所有从串口发出去的数据都会被原样发到 TCP 服务端，不再按 AT 命令解析。然后：

AT+CIPSEND

串口终端会先回一个>提示符，接下来你输入的任何内容，固件都会打包发出去。在>后面输入：

GET /test HTTP/1.1 Host: 192.168.1.100

网络调试助手那头能看到这些字符串，说明 TCP 数据面正常。退出透传模式的方法是不要发换行后的任何内容，直接发送特殊序列+++。注意+++前后的时间间隔要求很严，发送后等 1 秒再发 AT 命令，紧挨着容易把+++当成普通数据发给服务端。

TCP 透传里一个容易忽略的参数是AT+CIPRECONN=1，它控制 TCP 连接断开后是否自动重连。它是 ESP8266 AT 固件里面向 TCP 长连接场景的重要参数，必须在AT+CIPSTART之前设置，否则不生效：

AT+CIPMUX=0 AT+CIPRECONN=1 AT+CIPSTART="TCP","192.168.1.100",8080

这样 WiFi 闪断再恢复时，TCP 层会尝试重新建连。如果连的是 STM32 主控，还有一个硬件层面要注意：ESP8266 的 UART 是 3.3V TTL 电平，STM32 的串口引脚如果容忍 5V 可以直接连，但不能把这个 WiFi 模块接到带 5V 电源的 RS232 板上，否则长期运行会把 AT 固件跑出乱码。真正量产时，主机和模块之间还要共地，串口的 TX、RX 要交叉连接。

5. 进阶：用 Python 脚本把固件版本、文件哈希和 WiFi 状态一次验完

5.1 在刷机前校验固件包的 SHA256

从网络下载的 AT 固件，理论上都应该做一次哈希校验，这就是固件安全里最基本的一道动作。乐鑫在发布页会提供对应 zip 或 bin 的 SHA256 值，下载后手动算一遍再解压，能避免中间人替换成带后门的固件。在 Linux 或 macOS 下执行：

sha256sum ESP8266-IDF-AT_V2.2.1.0.zip

Windows 的 PowerShell 可以用：

Get-FileHash ESP8266-IDF-AT_V2.2.1.0.zip -Algorithm SHA256

拿到结果后和官方页面公布的哈希逐字符对比。这个步骤看着多此一举，但模组烧录之后是无法简单从AT+GMR看出固件是否被篡改的，因为版本号可以被原样改回。

5.2 用 pyserial 自动执行 AT 冒烟测试

批量生产或修复一批设备时，人工在串口里一条条敲 AT 太慢。我通常会在刷完固件后，用一个 Python 脚本走一遍“版本检查、连接 AP、PING 网关”的冒烟流程。脚本长这样：

import serial import time def send_at(ser, cmd, wait=1.0, expect="OK"): ser.reset_input_buffer() ser.write((cmd + "\r\n").encode()) time.sleep(wait) resp = ser.read(ser.in_waiting or 1).decode(errors="ignore") print(f">> {cmd}\n<< {resp.strip()}") assert expect in resp, f"{cmd} failed" ser = serial.Serial("/dev/ttyUSB0", 115200, timeout=2) time.sleep(0.5) send_at(ser, "ATE0") send_at(ser, "AT") send_at(ser, "AT+GMR") send_at(ser, "AT+CWMODE=1") ssid = "YourSSID" password = "YourPass" send_at(ser, f'AT+CWJAP="{ssid}","{password}"', wait=8, expect="WIFI GOT IP") send_at(ser, 'AT+PING="192.168.1.1"', wait=3, expect="+PING") print("AT smoke test passed") ser.close()

脚本里的send_at先清空串口缓冲，再发命令，然后根据命令实际耗时等 1 到 8 秒。AT+CWJAP这一步等 8 秒不是随便拍的，路由器认证和 DHCP 获取 IP 通常需要 3 到 6 秒，时间给短了会只读到前半段WIFI CONNECTED。脚本里用expect断言，返回里没有关键字就抛异常退出，适合放进量产测试工装。

跑通这个脚本后，把输出里的+PING时间、AT+GMR的版本串保存成文本，和主控板的软件版本一起写入测试报告归档。以后再遇到“这模块能不能用”的争议，直接翻这份日志比现场重新测一遍要快得多，也算给 AT 固件画了一个可量化的验收边界。

# 产测机上可以循环执行 for i in {1..50}; do python3 smoke_at.py || echo "round $i failed"; done

本文还有配套的精品资源，点击获取