副标题接线、新行模式、完整配网会话以及为什么 Wireshark 抓不到 AT 文本专栏《嵌入式学生的方案测试课》第 4 篇前置第 1 篇环境表第 3 篇阻塞点地图里的「等 AT OK」标签嵌入式、WiFi、软件测试、物联网、C语言读者买了 ESP8266 和 USB 转串口或即将到手会打开串口助手但还没把会话当成测试证据学完交什么接线照片、一份带时间戳的 AT 会话、四层标注、一张「失败不可观察」缺陷单主实验板ESP8266 / ESP-12F。Hi3861 用自打日志对照。国内不做 HaLow 发射泰芯 AT 只作公开命令对照。0. 这篇结束你能干什么勾这 3 条。勾不完不要宣称「会配网」。能独立接线TX 对 RX、RX 对 TX、GND 共地、3V3 供电串口 115200 8N1打开新行先发AT得到OK。电脑不认 COM、有打印输不进命令能按清单排除而不是先怪芯片。能跑完一条完整会话扫网、正确密码连上并记录 GOT IP 耗时、错误密码记录失败码和耗时、弱网或拔天线记录超时全过程存成带时间戳的 txt。能当面说清AT 文本走 UARTWireshark 默认抓不到它DHCP、TCP、MQTT 才可能出现在网口。把 AT 原文说成抓包是第 8 篇之前最常见的装懂。第 3 篇把「等 AT OK」画进了阻塞点地图。本篇把这次等待变成可测的状态机发、等、校验、超时、重试、放弃。1. 为什么现场第一件事是打开串口客户板来了不要先开 Wireshark不要先改代码。先问串口有没有、波特率多少、版本横幅是什么。理由很具体版本不对后面所有性能数字作废第 1 篇纪律很多「连不上」是 TX/RX 没交叉、没 GND、没新行、驱动没装AT 是模组的控制面。控制面都没通数据面抓包没有意义公开的泰芯 AH FAQ 把串口工具写成了独立一节电脑不认口先查 CH340有打印输不进命令先查会话和新行模式。原厂把学生第一天会踩的坑写进了 FAQ说明它不是个例方案测试工程师的手感有一半是串口手感。另外一半才是分层和抓包。2. 最小原理2.1 UART 只要记住这几条UART 是异步串口双方约定波特率没有时钟脚。一方 115200、另一方 9600两边都可能看到乱码或什么都没有。最小接线MCU/模组 TX ---- USB转串口 RX MCU/模组 RX ---- USB转串口 TX MCU/模组 GND ---- USB转串口 GND 电源 3V3/5V 按板子丝印不要用 USB 5V 直灌 3V3 芯片TX 对 TX、RX 对 RX是学生第一错。看起来「有电」现象是有时能看到模组打印模组 TX 碰巧接到了电脑 RX但电脑打字模组听不见。GND 必须共地。只接 TX/RX 不接 GND现象飘有时通、有时乱码极像「射频不稳」。先当供电和地不当 Wi-Fi。USB 转串口常见 CH340、CP2102、FT232。Windows 不认 COM先装驱动再换线、换口。AH FAQ 公开写的就是 CH340 驱动。不要把「设备管理器里没有 COM」写成模组 UART 坏了。电平USB 转串口有 3.3V 和 5V 逻辑。ESP8266 的 UART 是 3.3V。5V 推 RX 有风险。测试记录写清转接板型号。AH 公开硬件项UART TX/RX 串 1K防止串口工具漏电把模组灌醒或灌异常。学生板没有 1K 也可以先练 AT但要知道现场「插上串口电流变了、休眠进不去」可能是漏电不是协议栈。第 15 篇会回到这颗电阻。2.2 新行模式有打印输不进命令的第一嫌疑AT 命令通常以回车、换行结束CR、LF或两者。串口助手必须配置波特率以模组手册为准ESP8266 常见 115200也有 74880 启动日志数据位 8、无校验、1 停止位8N1发送时附加新行 / CR LF。只附加 CR 或只 LF有的模组认、有的不认不要用「十六进制发送」除非你在测二进制AH FAQ 原话方向电脑能识别串口、有打印但输不进命令先查会话设置和新行。学生用 SSCOM、MobaXterm、PuTTY、串口助手都一样。PuTTY 要在 Terminal 里自己处理 Enter。配不好就会出现「我明明敲了 AT」。ESP8266 启动时可能先以 74880 打一段 boot再切到 115200。你只开 115200上电瞬间那几行是乱码后面ready才正常。不要把启动乱码写成芯片损坏。记录里写启动乱码是否只出现在前 200ms。2.3 AT 是 UART 上的文本协议不是网包分层再钉一次你敲的 ATCWJAP... → USB 转串口 → 模组 UART 解析器 模组连 AP 的 802.11 → 空口第 9 篇默认抓不到 拿到 IP 之后的 DHCP/TCP → 网口第 8 篇热点拓扑才能看到设备包所以Wireshark 选电脑网卡过滤器mqtt看不到ATCWJAP串口 txt 里出现ATCWJAP不能当作「我抓过 MQTT」简历写 Wireshark 抓 AT是概念错误第 8 篇会教正确拓扑。本篇只要你停止混用两个通道。2.4 AT 状态机发、等、校验、超时、重试、放弃把第 2 篇状态机具体化空闲 --发命令-- 等待响应 |-- 收到完整 OK / ERROR / 数据 -- 校验 -- 空闲成功或失败 |-- 超时 -- 重试有限次-- 放弃 -- 空闲带错误码 |-- 半路又来一条命令 -- 非法重入第 2 篇非法转移每一项都要变成可测数字项你必须写进用例的数发完整命令字节含结束符是否回显等超时阈值例如 8s 连 AP、2s 普通 AT校验成功关键字OK、WIFI GOT IP失败ERROR、FAIL、CWJAP:1重试最多几次、间隔多少、间隔是否退避放弃放弃后能否再接受AT会不会复位UI 会不会转圈到死第 3 篇若把「等 OK」放进采集任务且超时 8s采集周期直接烂。本篇实验在 PC 串口助手上手动等先体会 8 秒有多长第 14 篇再用 Python 把超时写成脚本。2.5 日志规范现在就开始不要等自动化串口助手打开「时间戳」。没有该功能就在保存后用编辑器按段标注。一行合格日志至少有21:05:03.012 [UART] AT 21:05:03.020 [UART] OK 21:05:10.100 [WIFI] GOT IP 192.168.43.12 rssi-48要抄的字段时间、方向主控发还是模组回、版本横幅、RSSI有则抄、错误码原文。不要总结成「连上了」。第 1 篇合格现象的硬指标在这里落地。ESP8266 常见版本查询ATGMR。泰芯公开ATVERSION、ATSYSCFG。学生板用谁记谁报告禁止只写「最新固件」。3. ESP8266 命令表本篇够用的最小集不同厂家 AT 固件略有差异。先ATGMR确认。下面按乐鑫经典 AT 写你的板若不同以回显为准不要和范文死磕命令字母。目的命令示例成功时你应看到超时建议探活ATOK1s版本ATGMRAT version / SDK version1s模式ATCWMODE1OK1STA1s扫网ATCWLAP若干(ecn,ssid,rssi,...)然后OK5 到 10s连接ATCWJAPssid,pwdWIFI CONNECTED、WIFI GOT IP、OK8 到 15s查 IPATCIFSRSTAIP1s断开ATCWQAPOK2s错误密码常见FAIL、ERROR、或CWJAP:1按固件。本篇不要求背错误码表要求原文抄进缺陷单。连 AP 是长命令。等待期间不要连敲。那是非法重入。4. 手把手实验ESP8266 必做材料ESP-12F 或开发板、USB 转串口、杜邦线、能改密码的 2.4G AP 或手机热点、串口助手。环境表 ENV 按第 1 篇先填。SSID 用lab-ap-01密码不要写进公开博客。步骤 0接线并拍照断电。TX-RX 交叉GND 共地。开发板若已带 USB 转串口不要再外接另一套抢同一脚。供电按丝印。ESP8266 发射瞬间电流大用能供 300mA 以上的口避开无源扩展坞。拍照照片里能看出交叉和 GND。作业要这张图。设备管理器确认 COM 号写入 ENV。排障清单按顺序一次一个现象先查没有 COM驱动、线、口、设备管理器是否被占用COM 在完全无打印TX/RX 接反或只接了一根波特率模组没上电BOOT 脚被拉成下载模式全是乱码波特率地启动 74880 vs 115200有启动打印敲 AT 无回新行RX 没接到模组CTS/RTS 流控误开一发 AT 模组复位供电不够IO 电压复位脚被带偏到「AT→OK」之前不要开始配网。探活失败属于环境未就绪不是 Wi-Fi 缺陷第 1 篇。步骤 1探活和版本发送AT期望 1s 内OK。发送ATGMR把版本字符串整段粘进 ENV「固件如何确认」。步骤 2扫网射频 扫描ATCWMODE1再ATCWLAP。记录列表里有没有lab-ap-01对应 RSSI从发令到OK的时间列表空先看天线第 1 篇拔天线对照再看是不是 5G-only 热点扫不到就不要连。连一个不存在的 SSID失败原因会和错密码搅在一起。步骤 3正确密码记 GOT IP 耗时基线1m、天线接好。发送连接命令。用时间戳算T0 发出 CWJAP T1 WIFI CONNECTED有则记关联层 T2 WIFI GOT IPIP 层 T3 OKT1 到 T2 的空隙就是「已关联没 IP」的窗口。第 5 篇四层会用到。本篇先把数字抄下来。重复 3 次写 3 个耗时不要只留一次好运气。步骤 4错误密码关联层只改密码少一位其它冻结。期望明确失败模组仍响应下一条AT。记录失败原文和耗时。重复 3 次。若 30s 无任何失败码、且AT不再OK这是缺陷不是「密码不对所以随便」。见第 5 节范文。步骤 5超时射频或关联一次一个变量下面选一种不要同时拔天线又改密码松开天线再扫、再连或 AP 关机后再连SSID 不在列表记录等到你设定的超时例如 15s是否放弃、是否仍能AT。把超时阈值写进用例不要无限等。步骤 6保存会话并分层标注把整段 txt 存为labs/week04/at-session.txt。在旁边做一份标注稿at-session-annotated.mdL12 ATCWLAP → 射频/扫描 L40 CWJAP 正确密码 → 关联 L45 WIFI CONNECTED → 关联成功 L47 WIFI GOT IP → IP L60 CWJAP 错误密码 → 关联失败期望内 L88 拔天线后 CWLAP 空 → 射频标注的是层不是锅。IP 没拿到不要写「芯片 DHCP 实现垃圾」除非你已经排除关联。没有 ESP8266 时用开发板自带 USB 串口打AT/ATGMR也行。完全没模组用电脑两个串口互环或 USB 转串口短接 TX-RX 做回显只练接线和新行配网会话标「待补」。第 18 篇全程案例会卡住所以仍建议本周把板买回来。Hi3861若无 AT就保存启动日志 你自己的wifi connected/got ip打印同样做时间戳和分层标注。状态机一样只是命令不是ATCWJAP。5. 缺陷单范文失败必须可观察编号BUG-20261016-at-01 标题【AT】错误密码时 30s 内无 ERROR/FAIL且期间 AT 无 OK3/3 严重级别严重产品会转圈到死测试无法自动化 环境ENV-xxESP-12FATGMR____AP lab-ap-01 WPA2天线锁紧只改密码少一位 前置正确密码 3/3 在 8s 内 GOT IP探活 AT 正常 步骤 1. 115200 8N1 新行。 2. AT 得 OK。 3. 发错误密码连接。 4. 等待 30s再发 AT。 期望30s 内返回明确失败随后 AT 仍 OK模组不复位。 实际30s 无失败码第 31s 发 AT 无回显直到 40s 模组自行打印 ready自行复位。3/3。 附件at-session-wrongpass.txt含启动横幅 初步分层AT 状态机 / 关联失败路径。射频排除扫网成功。对照若错误密码 8s 内FAIL且AT仍OK这是符合期望记测试记录不要当芯片缺陷。第 1 篇已经说过。另一张可选单供电不足导致一连接就复位。环境写「电脑前口 USB无外供」。换适配器后消失。初步分层硬件/供电不是 AT 解析器。6. 换成泰芯公开场景会怎么变国内读者不发射 HaLow。下面只对照公开命令和行为学生用 ESP8266 迁移同一测试动作。到原厂板以手册为准不要把ATCWJAP打到 AH 模组上。公开文档测试动作串口不识别 → CH340环境未就绪清单第一项有打印输不进 → 新行 / 会话步骤 0 探活TX/RX 串 1K 防漏电插串口前后电流、休眠是否仍能进第 15 篇展开ATSYSCFG探活学生用AT/ATGMR对应ATWIFIMODEATSSIDATKEY对应模式、SSID、密码改参前先 down 再 upATCHAN_LISTATBSS_BW两端必须完全一致含顺序学生迁移两端加密和频段要匹配不要在连接中途改 SSIDATPAIR成功后必须PAIR0才握手迁移配网状态机要有明确退出否则假连接ATVERSION含 SVN不要擅自改会话开头抄完整版本ATLOADDEF改容量类参数后恢复出厂改过 STA 数、分区类配置前置必须写是否恢复ATIPERF2c,ip,port,time第 12 篇再打流本篇只记「命令存在、需要网络宏」ATPING期间不能输入其它 AT阻塞点ping 会占住 AT 会话和第 3 篇同一类TXW82xAT是 CPU0AT1是 CPU1测无线核不要只打应用核 AT学生无该板则记在地图里Wi-Fi4 SRRCATWIFIMODEsta再 SSID/KEY连上再 iperf本篇完成「连上」打流留第 12 篇网口 netat 发 AT网桥知道 AT 不一定走 UART学生无网桥则只认知固定句式公开 FAQ 写新行模式学生板上用串口助手勾上新行到 AH 板同样先探活ATSYSCFG。6.1 一份合格会话长什么样可对照下面是打码后的示意不是让你抄结果交差。时间戳格式按你的助手来。21:10:01.000 AT 21:10:01.012 OK 21:10:02.000 ATGMR 21:10:02.020 AT version:1.x.x.x 21:10:02.030 SDK version:x.x.x 21:10:02.040 OK 21:10:05.000 ATCWMODE1 21:10:05.010 OK 21:10:06.000 ATCWLAP 21:10:08.100 CWLAP:(4,lab-ap-01,-47,xx:xx:xx:xx:xx:xx,6) 21:10:08.500 OK 21:10:20.000 ATCWJAPlab-ap-01,******** 21:10:22.400 WIFI CONNECTED 21:10:23.100 WIFI GOT IP 21:10:23.120 OK 21:10:30.000 ATCIFSR 21:10:30.020 CIFSR:STAIP,192.168.x.x 21:10:30.030 OK 21:10:40.000 ATCWQAP 21:10:40.050 OK 21:10:50.000 ATCWJAPlab-ap-01,******* ; 少一位 21:10:58.000 FAIL 21:10:59.000 AT 21:10:59.010 OK标注稿对应CWLAP 有 ssid 且 rssi-47射频扫描过CONNECTED关联过GOT IP 加 STAIPIP 过错密码 FAIL 且随后 AT 得 OK失败可观察状态机回到空闲如果你的固件没有 WIFI CONNECTED 这行不要补造。以原文为准在 times.md 里定义你用哪一行当 T1。回显若助手开了本地回显同一句 AT 会出现两次。报告写明。统计耗时用模组返回的那一行。7. 30 秒口径现场先开串口驱动、交叉、地、波特率、新行先 AT 得 OK。AT 是发、等、校验、超时、重试、放弃。失败必须有码超时后还要能探活。AT 在 UART 上Wireshark 抓不到 AT 文本。网口抓的是 DHCP/TCP/MQTT。版本字符串每次抄进环境表。改 SSID 不要在连接半路进行。8. 作业labs/week04/ env.md wiring.jpg # TX-RX 交叉和 GND 可见 at-session.txt # 原始会话开时间戳 at-session-annotated.md # 每段标射频/关联/IP times.md # 正确密码 3 次 GOT IP 耗时错密码 3 次耗时 BUG-at.md # 若失败不可观察就提单若都符合期望写「无缺陷附测试记录」验收会话里能搜到AT和版本有一次成功 GOT IP 和一次故意失败标注稿没有把 AT 原文写成 Wireshark错密码实验没有同时拔天线密码和真实 SSID 已打码或未进公开目录9. 自测题先闭卷有启动打印、敲 AT 没回最优先查什么为什么 Wireshark 看不到ATCWJAPTX 接 TX 时为什么有时仍能看见模组输出正确密码的 T1CONNECTED和 T2GOT IP分别对应第 0 篇哪一层错误密码 30s 无码且 AT 死为什么是缺陷而不是「密码不对」为什么连 AP 等待时不能连发下一条 ATAH FAQ 的新行模式和 ESP8266 实验哪一步对应ATPING期间不能输入其它 AT和第 3 篇什么概念是同一个启动前 200ms 乱码、随后ready要不要写成 UART 损坏把 AT 会话当抓包贴进简历错在哪答案见附录。10. 学生常见翻车波特率不对先换模组。没新行提单「AT 固件坏了」。正确和错误密码、拔天线写在同一次操作里。会话不存文件口头说「刚才 OK 过」。把ATCWLAP列表当空口抓包。用电脑 USB 口供电一关联就复位判射频差。泰芯板上仍打ATCWJAP不读手册。11. 下一篇预告第 5 篇《扫不到、连不上、没 IP、上不了云方案测试只记这一张分层表》。本篇会话里已经出现了扫网空、错密码、GOT IP。下一篇把它们收成四层故障注入同一块 ESP8266每层只造一个故障填同一张表。那张表是专栏中轴。附录 A. 自测题参考答案新行 / 结束符其次 RX 是否接到模组再查流控。AT 在 UART 上不经过电脑网卡的 IP 栈。模组 TX 仍可能接到了电脑 RX所以能看打印电脑 TX 没进模组 RX所以输不进。T1 关联层T2 IP 层。期望是可观察的失败并回到空闲。死等、死机、不再探活破坏测试和产品。非法重入状态机还在等待第二条会粘包或被丢现象无法分层。步骤 0 探活串口助手打开新行后再发 AT。阻塞。长命令占住 AT 任务其它命令进不去。不要。先确认是否 74880 启动日志。持续全程乱码才查波特率和地。通道都错了。抓包指网口或空口帧AT 是串口旁路。附录 B. 公开资料泰芯 AH 方案 FAQCH340、新行、1K 电阻、版本、LOADDEF、改参 down/up泰芯 AH-SDK AT 指令WIFIMODE / SSID / KEY / CHAN_LIST / BSS_BW / PAIR / VERSION / IPERF2 / PING / SYSCFGWi-Fi4 SRRC 测试方法STA 连接命令序列其后才是 iperfTXW82x ReleaseNoteAT 与 AT1 分核附录 C. 串口助手推荐配置可截图对照端口COMx与设备管理器一致 波特率115200 数据位8 停止位1 校验无 流控无 发送附加CR LF新行 显示时间戳开本地回显可开报告里注明回显以免和模组回显重复计算 编码UTF-8 或 GBK 以实际中文日志为准不要混用第 4 篇完