ESP8266 这个模块便宜、好买、资料多但真到项目里把它和 STM32 接起来跑通很多人还是会卡在几个固定的地方AT 指令发出去没反应、串口收到的全是乱码、printf 重定向之后程序直接卡死。我前后用 STM32CubeMX HAL 库这套组合做过好几个带联网功能的小设备从 F103C8T6 到 F407每次带新人复现这套流程踩的坑几乎一模一样。这篇就把整个链路拆开讲清楚——从 CubeMX 里怎么配时钟和串口到 ESP8266 的接线、AT 指令交互再到把 printf 重定向到串口做调试最后给一套能直接抄的收发框架。内容偏实战适合刚上手 HAL 库、手里有块 STM32 开发板和一块 ESP8266-01S或 ESP-12F的朋友。不需要你先把 AT 指令手册背下来但需要你会用 CubeMX 建工程、会点 C 语言。我会把每一步为什么这么配讲明白因为 HAL 库这东西光抄配置不改参数换个芯片就翻车。1. 先把硬件链路和供电这件事说透很多人一上来就写代码结果调半天发现是硬件问题。ESP8266 和 STM32 的连接本身不复杂但有两个地方特别容易翻车供电和电平。1.1 接线到底怎么接为什么这么接ESP8266 和 STM32 之间走的是 UART也就是串口。典型接法是交叉连接STM32 引脚ESP8266 引脚说明USARTx_TXRXSTM32 发模块收USARTx_RXTX模块发STM32 收3.3VVCC / CH_PD供电和使能GNDGND共地这里有个细节ESP8266-01S 的 CH_PD有的板子标 EN必须拉高否则模块根本不启动。我见过有人 VCC 接了、GND 接了就是忘了 CH_PD然后对着串口助手发呆半小时。稳妥做法是 CH_PD 直接接 3.3V或者通过一个 10k 电阻上拉到 3.3V。另外 GPIO0 和 GPIO15 这两个脚决定启动模式。正常运行时 GPIO0 悬空或拉高、GPIO15 拉低。如果你要刷 AT 固件GPIO0 才需要拉低进下载模式。日常通信不用管它们但板子上如果有这两个脚别乱接。1.2 供电是头号杀手别用 STM32 的 3.3V 直接喂这是我最想强调的一点。ESP8266 在发射瞬间的峰值电流能到 300mA 甚至更高平均电流也有 70~80mA。而 STM32 开发板上那颗 LDO比如 AMS1117-3.3通常只能稳定输出 100~200mA还要分给 STM32 自己和其他外设。结果就是模块一联网就复位串口打印一堆乱码你以为是代码问题其实是电压被拉垮了。正确做法是给 ESP8266 单独供电用一个能出 500mA 以上的 3.3V LDO比如 AMS1117-3.3 单独一路输入端并一个大电容470uF 电解 0.1uF 陶瓷输出端也并 100uF 以上。我自己的板子上就是 ESP8266 单独一路 LDO从此再没出现过联网复位。提示如果你手头只有 USB 转 TTL 模块注意它的 3.3V 输出电流往往也不够调试阶段可以用但正式跑一定要独立供电。1.3 电平匹配3.3V 对 3.3V别接 5VSTM32 的 IO 是 3.3V 电平ESP8266 也是 3.3V所以直连没问题。但如果你用的是 5V 的 STM32 板子比如某些老开发板把 IO 拉到 5V或者用 USB 转 TTL 的 5V 档去接模块 RX长期下来会把模块打坏。ESP8266 的 IO 不耐 5V这点没有商量余地。如果你非要用 5V 的串口去接至少加个电平转换或者用两个电阻分压TX 到模块 RX 之间串 1k再对地接 2k但分压只适合低速115200 以上容易出错还是老老实实用 3.3V。2. CubeMX 里那几个必须改对的配置硬件通了接下来是软件。CubeMX 建工程这一步很多人是能生成就行但配置里几个默认值不改后面串口通信必出问题。我按顺序说。2.1 时钟树先确认你的晶振频率新建工程选好芯片比如 STM32F103C8T6第一步进 RCC 配置。如果你的板子上是 8MHz 外部晶振就把 HSE 选 Crystal/Ceramic Resonator如果是用内部 RC就选 Disable 然后走 HSI。这一步错了后面串口波特率全是错的收到的就是乱码。然后在 Clock Configuration 里把系统时钟拉到芯片允许的最高值F103 是 72MHzF407 是 168MHz。为什么强调这个因为 HAL 库算波特率是基于你配置的时钟频率算的时钟不对波特率分频系数就错通信自然失败。2.2 串口参数波特率和字长怎么定ESP8266 出厂 AT 固件的默认波特率是 115200老版本可能是 9600具体看你模块。在 CubeMX 的 Connectivity 里选一个 USART比如 USART1模式选 Asynchronous。参数这样配Baud Rate115200Word Length8 BitsParityNoneStop Bits1Data DirectionReceive and Transmit这就是常说的 8-N-1。ESP8266 默认就是这个格式别乱改。如果你不确定模块当前波特率可以先按 115200 试不行再试 9600或者用 ATUART_DEF 查询。2.3 中断还是轮询为什么我推荐中断接收CubeMX 里 USART 的 NVIC 设置有个 USARTx global interrupt建议勾上。为什么因为 ESP8266 返回的数据是不定长的你用轮询HAL_UART_Receive去收要么阻塞主循环要么收不全。用中断接收每来一个字节进一次中断把数据塞进缓冲区主循环再慢慢解析这样最稳。具体做法是在 CubeMX 里勾上中断生成代码后在 main 里调用HAL_UART_Receive_IT(huart1, rx_byte, 1)开启单字节中断接收然后在HAL_UART_RxCpltCallback回调里把字节存进环形缓冲区再重新开启接收。这个模式后面第 4 节会详细展开。2.4 生成工程时的两个小设置在 Project Manager 里Toolchain/IDE 选你用的Keil、STM32CubeIDE、Makefile 都行。有个细节Code Generator 里建议勾上Generate peripheral initialization as a pair of .c/.h files这样每个外设的初始化代码单独成文件工程大了好维护。生成之后先编译一遍确认没报错再往下走。这一步别省我见过有人配置完直接写业务代码结果编译报错一堆回头找问题更费劲。3. AT 指令交互从发出去没反应到稳定通信代码框架有了接下来是和 ESP8266 对话。AT 指令这东西看着简单但实际调试时发出去没反应是最高频的问题。我按排查顺序讲。3.1 先手动发一条 AT确认链路是通的在写代码之前强烈建议先用 USB 转 TTL 模块把 ESP8266 接到电脑上用串口助手手动发AT看能不能收到OK。这一步能排除掉大部分硬件和模块本身的问题。注意串口助手的设置波特率 115200、8-N-1、发送新行也就是结尾加\r\n。ESP8266 的 AT 指令必须以\r\n结尾只发AT不加换行模块是不认的。这是新手最容易忽略的点。如果手动发 AT 都没反应检查这几项供电够不够、CH_PD 有没有拉高、TX/RX 有没有接反、波特率对不对。这四项排查完基本都能通。3.2 代码里发 AT 指令为什么必须带 \r\n在 STM32 里发指令很多人写成HAL_UART_Transmit(huart1, (uint8_t*)AT, 2, 100);这样发出去的是纯AT没有回车换行模块不会响应。正确写法是uint8_t cmd[] AT\r\n; HAL_UART_Transmit(huart1, cmd, sizeof(cmd) - 1, 100);注意sizeof(cmd) - 1因为字符串末尾有个\0不能发出去。或者你直接算长度 4。这个细节不注意发出去的指令就多一个 0x00模块可能直接不认。3.3 常用 AT 指令和它们的返回跑通 AT 之后按这个顺序往下走每一步都等上一条返回 OK 再发下一条指令作用正常返回AT测试通信OKATRST复位模块OK 一堆启动信息ATCWMODE1设为 Station 模式OKATCWJAPssid,pwd连接 WiFiWIFI CONNECTED / WIFI GOT IP / OKATCIPSTARTTCP,ip,port建立 TCP 连接CONNECT / OKATCIPSENDn发送 n 字节数据 然后发数据这里有个坑ATCWJAP连接 WiFi 需要时间返回是分几段的先是WIFI CONNECTED再是WIFI GOT IP最后才是OK。如果你只等一个 OK 就往下走可能 IP 还没拿到。稳妥做法是等WIFI GOT IP或者给足超时时间比如 10 秒。3.4 超时和重试别让程序死在等返回上HAL 库的HAL_UART_Transmit有个超时参数但接收如果也用阻塞式HAL_UART_Receive一旦模块没返回程序就卡在那了。所以实际项目里我一般不用阻塞接收而是用中断 超时判断。思路是发完指令后启动一个软件定时器或者用 HAL_GetTick 记时间在中断回调里不断往缓冲区塞数据主循环里检查缓冲区里有没有出现期望的关键字比如 OK同时检查有没有超时。超时了就当这条指令失败重试或者报错。这样程序永远不会死等。4. 串口 printf 重定向调试效率翻倍的关键调试嵌入式没有 printf 等于闭着眼睛开车。但 STM32 的 HAL 库默认没有把 printf 接到串口上需要自己重定向。这一步做对了后面调试省一半时间。4.1 重定向的原理fputc 和 __io_putcharprintf 最终会调用底层的字符输出函数。在 KeilARMCC里是fputc在 GCCSTM32CubeIDE、Makefile里是_write或__io_putchar。你要做的就是重写这个函数让它把字符通过串口发出去。Keil 下的写法#include stdio.h int fputc(int ch, FILE *f) { HAL_UART_Transmit(huart1, (uint8_t*)ch, 1, 0xFFFF); return ch; }GCC 下的写法int __io_putchar(int ch) { HAL_UART_Transmit(huart1, (uint8_t*)ch, 1, 0xFFFF); return ch; }注意如果你用的是 GCC还要确认链接选项里没有-specsnosys.specs把_write屏蔽掉或者干脆重写_write。这个坑我在 STM32CubeIDE 里踩过printf 死活没输出最后发现是 syscalls 的问题。4.2 为什么 printf 会卡死怎么解决重定向之后很多人发现程序跑着跑着卡死了尤其是在中断里调用 printf 的时候。原因是HAL_UART_Transmit是阻塞式的它会一直等到数据发完。如果你在中断回调里调用 printf而串口又正忙就会死锁。解决办法有两个一是别在中断里 printf把要打印的内容存到缓冲区主循环里再打二是用 DMA 发送HAL_UART_Transmit_DMA是非阻塞的发完触发回调。我一般用第一种简单可靠。还有一个隐藏问题HAL_UART_Transmit的超时参数如果给 0xFFFF在 115200 波特率下大概能等 0.5 秒多正常够用。但如果串口被占用还是会卡。所以调试阶段可以接受正式代码里建议换成 DMA 或者自己写一个非阻塞的发送队列。4.3 一个实用的调试打印宏直接调 printf 有个问题正式发布时不想带这些调试信息一个个删太麻烦。我一般定义一个宏#define DEBUG_EN 1 #if DEBUG_EN #define LOG(fmt, ...) printf(fmt, ##__VA_ARGS__) #else #define LOG(fmt, ...) #endif这样发布时把DEBUG_EN改成 0所有调试打印自动消失不用动业务代码。##__VA_ARGS__是 GCC 的扩展Keil 下可能要用别的写法但思路是一样的。5. 一套能直接用的收发框架前面讲的都是点这一节把它们串成一个能跑的框架。核心是中断接收 环形缓冲区 主循环解析。5.1 环形缓冲区为什么不用普通数组串口数据是异步来的你永远不知道下一秒来多少字节。用普通数组写指针和读指针容易打架数据覆盖了都不知道。环形缓冲区ring buffer的好处是读写指针独立写满了覆盖最老的数据或者丢弃逻辑清晰。一个最简实现#define RX_BUF_SIZE 512 typedef struct { uint8_t buf[RX_BUF_SIZE]; volatile uint16_t head; volatile uint16_t tail; } ring_buf_t; ring_buf_t rx_buf; void ring_buf_put(ring_buf_t *rb, uint8_t data) { uint16_t next (rb-head 1) % RX_BUF_SIZE; if (next ! rb-tail) { rb-buf[rb-head] data; rb-head next; } } int ring_buf_get(ring_buf_t *rb, uint8_t *data) { if (rb-head rb-tail) return 0; *data rb-buf[rb-tail]; rb-tail (rb-tail 1) % RX_BUF_SIZE; return 1; }head和tail用volatile修饰因为它们在中断和主循环里都会被访问不加编译器可能优化出错。5.2 中断回调里只做一件事存数据uint8_t rx_byte; void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart-Instance USART1) { ring_buf_put(rx_buf, rx_byte); HAL_UART_Receive_IT(huart1, rx_byte, 1); } }回调里只做存数据和重新开启接收别做解析、别 printf。解析放主循环这样中断响应快不会丢数据。5.3 主循环里解析找关键字 超时主循环里不断从环形缓冲区取数据拼成一行然后判断有没有 OK、ERROR 这些关键字。同时用一个时间戳判断这条响应是不是超时了。uint8_t line[256]; uint16_t idx 0; uint32_t last_tick HAL_GetTick(); while (1) { uint8_t ch; while (ring_buf_get(rx_buf, ch)) { if (idx sizeof(line) - 1) { line[idx] ch; } last_tick HAL_GetTick(); } if (idx 0 (HAL_GetTick() - last_tick 100)) { line[idx] \0; // 这里解析 line判断 OK / ERROR LOG(RX: %s\r\n, line); idx 0; } }这里的 100ms 是静默超时意思是超过 100ms 没新数据来就认为这一帧收完了。这个值可以根据实际情况调WiFi 连接那种慢操作可以给到 500ms 甚至 1 秒。5.4 发送指令并等待响应的封装把发指令 等响应封装成一个函数用起来就清爽了int esp_send_cmd(const char *cmd, const char *expect, uint32_t timeout) { HAL_UART_Transmit(huart1, (uint8_t*)cmd, strlen(cmd), 1000); uint32_t start HAL_GetTick(); while (HAL_GetTick() - start timeout) { // 从 rx_buf 里找 expect 关键字 // 找到返回 0超时返回 -1 } return -1; }实际实现里找关键字要在环形缓冲区里滑动匹配或者先把数据取出来拼成字符串再strstr。我一般用后者简单。注意别在 while 里死等要留出时间给其他任务或者干脆用状态机。6. 那些年我踩过的坑和排查思路最后这部分是纯经验都是文档里不会写、但实际一定会遇到的问题。6.1 收到的全是乱码先查这三样乱码是最高频的问题排查顺序第一波特率对不对STM32 和 ESP8266 必须一致第二时钟配置对不对CubeMX 里 HSE 频率和实际晶振要匹配第三共地了没有两块板子不共地电平参考不一样必乱码。这三样查完90% 的乱码问题能解决。6.2 模块能连 WiFi 但连不上服务器这种情况通常是 DNS 或者 IP 的问题。先用ATPINGwww.baidu.com试试能不能通通了说明网络没问题那就是你连的服务器地址或端口不对。另外注意ATCIPSTART的 IP 不能带引号里的域名解析问题有些老固件不支持域名得先ATCIPDOMAIN解析出 IP 再连。6.3 程序跑一段时间就死机大概率是缓冲区溢出或者中断里做了耗时操作。检查环形缓冲区的大小够不够检查中断回调里有没有 printf 或者延时。还有一个隐蔽的HAL_UART_Transmit和HAL_UART_Receive_IT同时操作同一个串口如果发送时间太长接收中断可能被影响。这种时候要么用 DMA 发送要么发送前先关接收中断发完再开。6.4 关于 AT 固件版本不同批次的 ESP8266 模块AT 固件版本可能不一样指令集有细微差别。比如老版本用ATCIPMUX0才能ATCIPSTART新版本默认就是单连接。遇到指令不认先ATGMR查版本再去查对应版本的指令手册。别拿一份手册套所有模块。6.5 调试时的一个小技巧如果你没有逻辑分析仪又想看串口上到底发了什么可以把 STM32 的 TX 同时接到 USB 转 TTL 的 RX 上用电脑串口助手旁听。这样你能看到 STM32 实际发出去的字节和 ESP8266 的返回对照很快就能定位是发的问题还是收的问题。这个土办法我用了很多次比猜有效多了。整套流程走下来从接线、CubeMX 配置、AT 交互到 printf 调试和收发框架基本覆盖了 STM32 ESP8266 联网的最小闭环。真正上手做一遍你会发现难点不在代码本身而在那些配置细节和硬件细节上。把供电、时钟、波特率、换行符这几个点守住剩下的就是按部就班调指令。等你把这套跑通再往上接 MQTT、接云平台就是在这个框架上加协议层的事了。