一、硬件连接与配置
先解决最基础的部分——怎么把STM32和ESP8266可靠地连起来。硬件上其实就四个要点:TX接RX、RX接TX、共地、供电。

核心引脚:
- STM32的
TX→ ESP8266的RX - STM32的
RX→ ESP8266的TX - GND对GND(共地)
- ESP8266的供电必须用稳定的3.3V——千万别图省事用5V,会烧模块。
示例接线:
STM32 (TX) → ESP8266 (RX)
STM32 (RX) → ESP8266 (TX)
STM32 (3.3V) → ESP8266 (CH_PD)
GND → GND
电平匹配
ESP8266是3.3V逻辑电平,大部分STM32的串口引脚也是3.3V兼容,可以直接连。但如果你用的是5V供电的STM32开发板(比如某些老版),记得加电平转换电路,否则通信不稳定甚至烧坏模块。
二、AT指令配置流程
硬件接好后,下一步就是通过AT指令让ESP8266连上Wi-Fi并建立TCP连接。
初始化ESP8266
- 复位模块:发
AT RST,模块重启。 - 设置工作模式:
AT CWMODE=1(Station模式,连接路由器)。 - 可选关闭回显:
ATE0,减少调试干扰。
连接Wi-Fi
// 示例代码(基于HAL库)
void ESP8266_ConnectWiFi(const char* ssid, const char* pwd) {
char cmd[100];
sprintf(cmd, "AT CWJAP=\"%s\",\"%s\"\r", ssid, pwd);
ESP8266_SendCommand(cmd, "OK", 10000); // 超时10秒
}
注意:连接Wi-Fi容易失败,最好加重试逻辑,比如循环尝试5次,每次间隔几秒。
建立TCP连接
// 示例:连接服务器(IP:192.168.1.100,端口8080)
void ESP8266_ConnectServer(const char* ip, uint16_t port) {
char cmd[50];
sprintf(cmd, "AT CIPSTART=\"TCP\",\"%s\",%d\r", ip, port);
ESP8266_SendCommand(cmd, "CONNECT", 10000);
}
成功返回CONNECT标识,失败则返回ERROR或CLOSED。
三、数据发送实现
连上之后,核心任务就是发送数据。分两步:先告诉ESP8266要发多少字节,再把数据扔过去。
发送数据流程
- 先发
AT CIPSEND=<长度>(长度后面要加\r)。 - 等到模块返回
>提示符后,再直接发送数据内容(可以是JSON、字符串等)。
// 示例:发送字符串"Hello Server"
void ESP8266_SendData(const char* data) {
char cmd[20];
sprintf(cmd, "AT CIPSEND=%d\r", strlen(data));
ESP8266_SendCommand(cmd, ">", 2000); // 等待">"提示符
HAL_UART_Transmit(&huart1, (uint8_t*)data, strlen(data), 1000);
}
HTTP请求示例
如果你想直接用TCP发送HTTP POST请求,手动拼好请求报文即可:
// 发送POST请求(需包含Host和Content-Length)
char httpRequest[] = "POST /api/data HTTP/1.1\r"
"Host: 192.168.1.100\r"
"Content-Type: application/json\r"
"Content-Length: 29\r\r"
"{\"temp\":25.5,\"humidity\":60}";
ESP8266_SendCommand(httpRequest, "SEND OK", 10000);
四、数据接收与处理
发送之外,接收服务器或远端的数据也是常见需求。ESP8266有两种接收模式:
接收模式
- 非透传模式(
AT CIPMODE=0):接收数据时每条前面会有+IPD,长度:标识,需要解析。 - 透传模式(
AT CIPMODE=1):数据直接通过串口吐出,你自己定义协议来分包。
接收回调函数
一般在串口中断或DMA完成回调中处理接收到的数据:
void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size) {
if (huart->Instance == USART1) {
// 解析接收数据(如检查"OK"或错误码)
ESP8266_ParseResponse(esp8266_rxbuf);
memset(esp8266_rxbuf, 0, sizeof(esp8266_rxbuf));
}
}
五、优化与调试技巧
实际项目里总会遇到各种小坑,下面几个优化点能帮你少走弯路:
关键优化点
- 超时处理:所有AT指令都设置超时(比如5秒),防止程序死等。
- 缓冲区管理:用环形缓冲区或DMA接收数据,避免溢出。尤其数据量大时,中断接收容易丢包。
- 关闭冗余功能:比如
AT CIPDINFO=0可以隐藏IP显示,减少干扰数据。
调试工具
- 串口助手:先手动发AT指令验证模块是否正常工作。
- Wireshark:如果需要抓TCP包分析,可以用电脑搭建袋里抓包。
- 日志打印:在代码里用
printf输出每个步骤的状态,定位问题非常高效。
六、完整代码框架
把上面所有模块拼起来,就是一个最小可用的程序骨架:
// 主函数示例
int main(void) {
HAL_Init();
SystemClock_Config();
MX_USART1_UART_Init(); // 初始化串口1(连接ESP8266)
// 初始化ESP8266
ESP8266_Init();
ESP8266_ConnectWiFi("Your_SSID", "Your_Password");
ESP8266_ConnectServer("192.168.1.100", 8080);
while (1) {
ESP8266_SendData("Hello from STM32!");
HAL_Delay(5000); // 每5秒发送一次
}
}
// ESP8266发送指令函数
ESP8266_Status ESP8266_SendCommand(const char* cmd, const char* response, uint32_t timeout) {
HAL_UART_Transmit(&huart1, (uint8_t*)cmd, strlen(cmd), 1000);
HAL_Delay(100); // 等待发送完成
uint32_t start = HAL_GetTick();
while ((HAL_GetTick() - start) < timeout) {
if (strstr(esp8266_rxbuf, response)) return ESP8266_OK;
}
return ESP8266_TIMEOUT;
}
七、常见问题解决
最后,把大家问得最多的几个问题集中说一下:
AT指令无响应
- 先检查波特率是否匹配(默认115200,但有些模块可能被改过)。
- 确认TX/RX交叉连接、GND共地,供电是否稳定(3.3V/300mA以上)。
TCP连接失败
- 用电脑Ping一下服务器IP,确保可达。
- 用
AT CIFSR查ESP8266的本地IP,确认它已经成功获取到IP地址。
数据丢包
- 启用TCP Keep-Alive机制,比如
AT CIPOPEN=0,0,60(60秒发送一次心跳)。 - 增加发送间隔,或给数据加上校验(比如CRC),必要时重传。
