简介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 发ATCWJAP、ATCIPSTART这类命令就能完成连热点、建 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 构建产物为例文件在系统里的角色默认烧录地址以包内配置为准bootloader.bin二级引导负责把控制权交给 factory 分区里的 AT 主程序0x0partition-table.bin分区表规定 NVS、phy_init、factory、OTA 各落在哪个区间0x8000phy_init_data.binRF 初始化参数影响 WiFi 发射功率和接收灵敏度0xf000esp-at.bin 或 factory.binAT 主固件包含 WiFi 协议栈和 AT 解析器0x10000at_customize.bin出厂自定义参数可以覆盖默认波特率、默认 AP 等配置分区表指定的 custom 分区ota_data_initial.binOTA 数据初始标记让首次启动走 factory 而不是空 OTA 分区otadata 分区这张表里的地址是按 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.binIDF-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 modeQIO 和 DIO 在读取输出里不直接显示但只要烧录时选dio绝大多数 ESP8266 模组都能起来。提示如果flash_id卡在Connecting...说明芯片没有进入下载模式。把 GPIO0 拉低按一下复位键再试这是 ESP8266 烧录最常见的失败原因。3. 用 esptool.py 把 ESP8266 官方 AT 固件烧进 flash命令和参数说明3.1 先检查串口与芯片再进入刷机状态烧录前置工作比命令本身更容易出错。首先确认串口驱动正常Linux 下一般是/dev/ttyUSB0Windows 下是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_resetesptool 会自动通过 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或者杜邦线超过 15cm460800 容易丢包。刷不进去的时候把波特率降到115200不要在第一次烧录时急着追求速度。--after hard_reset表示烧完自动复位复位后固件直接启动省得手动断电。3.3 烧录后如何确认 AT 固件正常运行烧录完成后打开串口工具波特率设 115200复位看启动日志。ESP8266 的 ROM bootloader 会以 74880 波特率打印一段启动信息AT 固件本身的串口日志在 115200。如果你用 115200 打开可能只看得到后半段这是正常的。启动日志稳定后发两个最基本命令AT返回OK说明 AT 解析器在工作。再查版本ATGMR返回内容里会包含2.2.1.0和对应的编译信息这能确认你烧的确实是 IDF-AT_V2.2.1.0而不是某个第三方改过的固件。版本号对不上时先怀疑烧录地址特别是partition-table.bin地址对不对。分区表错乱会让系统跳过 factory 分区里的主固件可能启动到一个空白 OTA 分区这时AT无响应但 flash_id 又能正常读到芯片。3.4 烧录失败的常见原因现象原因处理办法Timed out waiting for packet header没进入下载模式或 RTS/DTR 没接GPIO0 拉低后按复位改用--before default_resetInvalid head of packet (0x00)串口数据干扰USB 转串口线过长降低波特率到 115200检查共地烧完 AT 无响应flash 容量不够或 flash_mode 不对确认 flash 是 4MB把 qio 换成 dio烧录成功但 ATGMR 报错NVS 残留数据或分区表不匹配先erase_flash再按 flasher_args.json 重新烧提示烧录工具里选的--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 ATCWMODE1ATE0关闭命令回显让后面分析输出更干净。ATCWMODE1把 WiFi 切成 Station 模式也就是 ESP8266 作为客户端去连路由器。如果你要做 AP 模式用2SoftAPStation 共存用3。做网桥设备时一般只用1功耗和中断都更少。然后扫描附近热点确认 WiFi 环境ATCWLAP返回是一行一行的CWLAP:(加密方式,SSID,信号强度,MAC,频道)比如CWLAP:3,MyWiFi,-45,a0:xx:xx:xx:xx:xx,6中间的负数是 RSSI单位 dBm数值越接近 0 信号越强。-45很好-80基本连不上。扫描结果里能看到你要连的 SSID就可以发起连接ATCWJAPMyWiFi,password123连接成功回WIFI CONNECTED和WIFI GOT IP。如果只看到WIFI CONNECTED没有GOT IP问题多半在路由器可能是开了 MAC 白名单、DHCP 地址池耗尽或者热点需要网页认证。查询当前连接状态用ATCWJAP?返回CWJAP:1表示已连接CWJAP:0表示断开。想让设备每次上电都自动重连打开自动连接参数ATCWAUTOCONN1这个参数是在断开后靠近 AP 范围内的自动重连不等同于 TCP 层重连后面透传还会遇到另一层问题。4.2 固定 IP 并做网络连通性检查CIPSTA 和 PING如果主机侧的业务逻辑依赖 ESP8266 的 IP 地址比如主控要定时往固定 IP 发数据那就不要依赖 DHCP 动态分配。先用下面命令查看当前 IPATCIPSTA?返回三行分别是 IP、网关、子网掩码。要改成静态 IP执行ATCIPSTA192.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 验证ATPING192.168.1.1返回类似PING:10的是往返时间单位毫秒。如果 PING 网关能通说明 LAN 通再 PING 一个公网地址比如ATPING223.5.5.5能通才说明 ESP8266 的 WiFi 链路和路由出口都没问题。PING 网关都超时检查ATCWJAP?是否还是1以及静态 IP 的网关参数是否填错。这里说一个很现实的情况如果你连的是商场、酒店的公共 WiFi连上 AP 后手机会跳出一个“打开浏览器并连接”的认证页AT 固件里没有浏览器内核所以ATCWJAP能返回WIFI CONNECTED但 PING 网关或者公网会失败。这种场景只能让主控通过ATCIPSTART主动访问认证服务器提交账号密码后拿到授权否则固件本身是“无解”的。4.3 用 CIPMODE/CIPSEND 跑一次 TCP 透传并保留自动重连WiFi 功能完整性的最后一步是验证 TCP 数据面。先关闭多连接使用单连接模式这样参数最简单ATCIPMUX0然后建立到服务端的 TCP 连接。如果你手头没有服务器可以先用电脑开一个netcat监听端口例如nc -l 8080。ESP8266 这边执行ATCIPSTARTTCP,192.168.1.100,8080192.168.1.100换成电脑在局域网里的 IP端口保持一致。连接成功返回CONNECT。紧接着进入透传模式ATCIPMODE1ATCIPMODE1开启透传这之后所有从串口发出去的数据都会被原样发到 TCP 服务端不再按 AT 命令解析。然后ATCIPSEND串口终端会先回一个提示符接下来你输入的任何内容固件都会打包发出去。在后面输入GET /test HTTP/1.1 Host: 192.168.1.100网络调试助手那头能看到这些字符串说明 TCP 数据面正常。退出透传模式的方法是不要发换行后的任何内容直接发送特殊序列。注意前后的时间间隔要求很严发送后等 1 秒再发 AT 命令紧挨着容易把当成普通数据发给服务端。TCP 透传里一个容易忽略的参数是ATCIPRECONN1它控制 TCP 连接断开后是否自动重连。它是 ESP8266 AT 固件里面向 TCP 长连接场景的重要参数必须在ATCIPSTART之前设置否则不生效ATCIPMUX0 ATCIPRECONN1 ATCIPSTARTTCP,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.zipWindows 的 PowerShell 可以用Get-FileHash ESP8266-IDF-AT_V2.2.1.0.zip -Algorithm SHA256拿到结果后和官方页面公布的哈希逐字符对比。这个步骤看着多此一举但模组烧录之后是无法简单从ATGMR看出固件是否被篡改的因为版本号可以被原样改回。5.2 用 pyserial 自动执行 AT 冒烟测试批量生产或修复一批设备时人工在串口里一条条敲 AT 太慢。我通常会在刷完固件后用一个 Python 脚本走一遍“版本检查、连接 AP、PING 网关”的冒烟流程。脚本长这样import serial import time def send_at(ser, cmd, wait1.0, expectOK): ser.reset_input_buffer() ser.write((cmd \r\n).encode()) time.sleep(wait) resp ser.read(ser.in_waiting or 1).decode(errorsignore) print(f {cmd}\n {resp.strip()}) assert expect in resp, f{cmd} failed ser serial.Serial(/dev/ttyUSB0, 115200, timeout2) time.sleep(0.5) send_at(ser, ATE0) send_at(ser, AT) send_at(ser, ATGMR) send_at(ser, ATCWMODE1) ssid YourSSID password YourPass send_at(ser, fATCWJAP{ssid},{password}, wait8, expectWIFI GOT IP) send_at(ser, ATPING192.168.1.1, wait3, expectPING) print(AT smoke test passed) ser.close()脚本里的send_at先清空串口缓冲再发命令然后根据命令实际耗时等 1 到 8 秒。ATCWJAP这一步等 8 秒不是随便拍的路由器认证和 DHCP 获取 IP 通常需要 3 到 6 秒时间给短了会只读到前半段WIFI CONNECTED。脚本里用expect断言返回里没有关键字就抛异常退出适合放进量产测试工装。跑通这个脚本后把输出里的PING时间、ATGMR的版本串保存成文本和主控板的软件版本一起写入测试报告归档。以后再遇到“这模块能不能用”的争议直接翻这份日志比现场重新测一遍要快得多也算给 AT 固件画了一个可量化的验收边界。# 产测机上可以循环执行 for i in {1..50}; do python3 smoke_at.py || echo round $i failed; done本文还有配套的精品资源点击获取
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 发ATCWJAP、ATCIPSTART这类命令就能完成连热点、建 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 构建产物为例文件在系统里的角色默认烧录地址以包内配置为准bootloader.bin二级引导负责把控制权交给 factory 分区里的 AT 主程序0x0partition-table.bin分区表规定 NVS、phy_init、factory、OTA 各落在哪个区间0x8000phy_init_data.binRF 初始化参数影响 WiFi 发射功率和接收灵敏度0xf000esp-at.bin 或 factory.binAT 主固件包含 WiFi 协议栈和 AT 解析器0x10000at_customize.bin出厂自定义参数可以覆盖默认波特率、默认 AP 等配置分区表指定的 custom 分区ota_data_initial.binOTA 数据初始标记让首次启动走 factory 而不是空 OTA 分区otadata 分区这张表里的地址是按 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.binIDF-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 modeQIO 和 DIO 在读取输出里不直接显示但只要烧录时选dio绝大多数 ESP8266 模组都能起来。提示如果flash_id卡在Connecting...说明芯片没有进入下载模式。把 GPIO0 拉低按一下复位键再试这是 ESP8266 烧录最常见的失败原因。3. 用 esptool.py 把 ESP8266 官方 AT 固件烧进 flash命令和参数说明3.1 先检查串口与芯片再进入刷机状态烧录前置工作比命令本身更容易出错。首先确认串口驱动正常Linux 下一般是/dev/ttyUSB0Windows 下是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_resetesptool 会自动通过 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或者杜邦线超过 15cm460800 容易丢包。刷不进去的时候把波特率降到115200不要在第一次烧录时急着追求速度。--after hard_reset表示烧完自动复位复位后固件直接启动省得手动断电。3.3 烧录后如何确认 AT 固件正常运行烧录完成后打开串口工具波特率设 115200复位看启动日志。ESP8266 的 ROM bootloader 会以 74880 波特率打印一段启动信息AT 固件本身的串口日志在 115200。如果你用 115200 打开可能只看得到后半段这是正常的。启动日志稳定后发两个最基本命令AT返回OK说明 AT 解析器在工作。再查版本ATGMR返回内容里会包含2.2.1.0和对应的编译信息这能确认你烧的确实是 IDF-AT_V2.2.1.0而不是某个第三方改过的固件。版本号对不上时先怀疑烧录地址特别是partition-table.bin地址对不对。分区表错乱会让系统跳过 factory 分区里的主固件可能启动到一个空白 OTA 分区这时AT无响应但 flash_id 又能正常读到芯片。3.4 烧录失败的常见原因现象原因处理办法Timed out waiting for packet header没进入下载模式或 RTS/DTR 没接GPIO0 拉低后按复位改用--before default_resetInvalid head of packet (0x00)串口数据干扰USB 转串口线过长降低波特率到 115200检查共地烧完 AT 无响应flash 容量不够或 flash_mode 不对确认 flash 是 4MB把 qio 换成 dio烧录成功但 ATGMR 报错NVS 残留数据或分区表不匹配先erase_flash再按 flasher_args.json 重新烧提示烧录工具里选的--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 ATCWMODE1ATE0关闭命令回显让后面分析输出更干净。ATCWMODE1把 WiFi 切成 Station 模式也就是 ESP8266 作为客户端去连路由器。如果你要做 AP 模式用2SoftAPStation 共存用3。做网桥设备时一般只用1功耗和中断都更少。然后扫描附近热点确认 WiFi 环境ATCWLAP返回是一行一行的CWLAP:(加密方式,SSID,信号强度,MAC,频道)比如CWLAP:3,MyWiFi,-45,a0:xx:xx:xx:xx:xx,6中间的负数是 RSSI单位 dBm数值越接近 0 信号越强。-45很好-80基本连不上。扫描结果里能看到你要连的 SSID就可以发起连接ATCWJAPMyWiFi,password123连接成功回WIFI CONNECTED和WIFI GOT IP。如果只看到WIFI CONNECTED没有GOT IP问题多半在路由器可能是开了 MAC 白名单、DHCP 地址池耗尽或者热点需要网页认证。查询当前连接状态用ATCWJAP?返回CWJAP:1表示已连接CWJAP:0表示断开。想让设备每次上电都自动重连打开自动连接参数ATCWAUTOCONN1这个参数是在断开后靠近 AP 范围内的自动重连不等同于 TCP 层重连后面透传还会遇到另一层问题。4.2 固定 IP 并做网络连通性检查CIPSTA 和 PING如果主机侧的业务逻辑依赖 ESP8266 的 IP 地址比如主控要定时往固定 IP 发数据那就不要依赖 DHCP 动态分配。先用下面命令查看当前 IPATCIPSTA?返回三行分别是 IP、网关、子网掩码。要改成静态 IP执行ATCIPSTA192.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 验证ATPING192.168.1.1返回类似PING:10的是往返时间单位毫秒。如果 PING 网关能通说明 LAN 通再 PING 一个公网地址比如ATPING223.5.5.5能通才说明 ESP8266 的 WiFi 链路和路由出口都没问题。PING 网关都超时检查ATCWJAP?是否还是1以及静态 IP 的网关参数是否填错。这里说一个很现实的情况如果你连的是商场、酒店的公共 WiFi连上 AP 后手机会跳出一个“打开浏览器并连接”的认证页AT 固件里没有浏览器内核所以ATCWJAP能返回WIFI CONNECTED但 PING 网关或者公网会失败。这种场景只能让主控通过ATCIPSTART主动访问认证服务器提交账号密码后拿到授权否则固件本身是“无解”的。4.3 用 CIPMODE/CIPSEND 跑一次 TCP 透传并保留自动重连WiFi 功能完整性的最后一步是验证 TCP 数据面。先关闭多连接使用单连接模式这样参数最简单ATCIPMUX0然后建立到服务端的 TCP 连接。如果你手头没有服务器可以先用电脑开一个netcat监听端口例如nc -l 8080。ESP8266 这边执行ATCIPSTARTTCP,192.168.1.100,8080192.168.1.100换成电脑在局域网里的 IP端口保持一致。连接成功返回CONNECT。紧接着进入透传模式ATCIPMODE1ATCIPMODE1开启透传这之后所有从串口发出去的数据都会被原样发到 TCP 服务端不再按 AT 命令解析。然后ATCIPSEND串口终端会先回一个提示符接下来你输入的任何内容固件都会打包发出去。在后面输入GET /test HTTP/1.1 Host: 192.168.1.100网络调试助手那头能看到这些字符串说明 TCP 数据面正常。退出透传模式的方法是不要发换行后的任何内容直接发送特殊序列。注意前后的时间间隔要求很严发送后等 1 秒再发 AT 命令紧挨着容易把当成普通数据发给服务端。TCP 透传里一个容易忽略的参数是ATCIPRECONN1它控制 TCP 连接断开后是否自动重连。它是 ESP8266 AT 固件里面向 TCP 长连接场景的重要参数必须在ATCIPSTART之前设置否则不生效ATCIPMUX0 ATCIPRECONN1 ATCIPSTARTTCP,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.zipWindows 的 PowerShell 可以用Get-FileHash ESP8266-IDF-AT_V2.2.1.0.zip -Algorithm SHA256拿到结果后和官方页面公布的哈希逐字符对比。这个步骤看着多此一举但模组烧录之后是无法简单从ATGMR看出固件是否被篡改的因为版本号可以被原样改回。5.2 用 pyserial 自动执行 AT 冒烟测试批量生产或修复一批设备时人工在串口里一条条敲 AT 太慢。我通常会在刷完固件后用一个 Python 脚本走一遍“版本检查、连接 AP、PING 网关”的冒烟流程。脚本长这样import serial import time def send_at(ser, cmd, wait1.0, expectOK): ser.reset_input_buffer() ser.write((cmd \r\n).encode()) time.sleep(wait) resp ser.read(ser.in_waiting or 1).decode(errorsignore) print(f {cmd}\n {resp.strip()}) assert expect in resp, f{cmd} failed ser serial.Serial(/dev/ttyUSB0, 115200, timeout2) time.sleep(0.5) send_at(ser, ATE0) send_at(ser, AT) send_at(ser, ATGMR) send_at(ser, ATCWMODE1) ssid YourSSID password YourPass send_at(ser, fATCWJAP{ssid},{password}, wait8, expectWIFI GOT IP) send_at(ser, ATPING192.168.1.1, wait3, expectPING) print(AT smoke test passed) ser.close()脚本里的send_at先清空串口缓冲再发命令然后根据命令实际耗时等 1 到 8 秒。ATCWJAP这一步等 8 秒不是随便拍的路由器认证和 DHCP 获取 IP 通常需要 3 到 6 秒时间给短了会只读到前半段WIFI CONNECTED。脚本里用expect断言返回里没有关键字就抛异常退出适合放进量产测试工装。跑通这个脚本后把输出里的PING时间、ATGMR的版本串保存成文本和主控板的软件版本一起写入测试报告归档。以后再遇到“这模块能不能用”的争议直接翻这份日志比现场重新测一遍要快得多也算给 AT 固件画了一个可量化的验收边界。# 产测机上可以循环执行 for i in {1..50}; do python3 smoke_at.py || echo round $i failed; done本文还有配套的精品资源点击获取
