基于STM32与ESP-01S的物联网实战：AP/STA双模式详解与阿里云平台接入

基于STM32与ESP-01S的物联网实战：AP/STA双模式详解与阿里云平台接入

最近在做一个智能家居的小项目，需要让STM32开发板连上WiFi，既能作为热点让手机直连控制，又能作为客户端接入家里的路由器，把数据上传到阿里云。我选择了安信可的ESP-01S模块，这个小家伙性价比超高，用串口AT指令就能轻松搞定网络通信。今天我就把整个开发过程，从硬件连接到代码编写，再到两种模式（AP和STA）的配置和阿里云接入，手把手分享给大家，希望能帮你少走弯路。

1. 认识我们的主角：ESP-01S WiFi模块

ESP-01S是安信可基于ESP8266芯片设计的一款WiFi模块，核心就两点：便宜和好用。它本身就是一个完整的WiFi SOC（片上系统），内置了TCP/IP协议栈，这意味着你不需要在STM32上跑复杂的网络协议，只需要通过串口发送简单的AT指令，就能让它联网、收发数据。

模块核心特点：

• 透传功能：即买即用，数据从串口进，从WiFi出，反之亦然，像一条透明的数据传输通道。
• AT指令控制：所有功能，包括连接WiFi、建立TCP连接、发送数据等，都通过串口发送AT指令字符串来实现，对单片机开发者非常友好。
• 三种工作模式：
  • STA模式：模块作为客户端，去连接你家或公司的无线路由器，从而接入互联网。
  • AP模式：模块自己变成一个WiFi热点，让你的手机、电脑等设备直接连接到它，组成一个局域网。
  • STA+AP模式：以上两种模式同时存在，既能连接路由器上网，又能自己开热点。

硬件参数速览：

准备工作：获取资料与固件在开始编程前，我们需要准备好模块的资料和固件。根据原始资料，你需要下载两个东西：

1. 模块资料包：包含数据手册等。
2. MQTT固件：因为后续我们要连接阿里云（使用MQTT协议），所以必须给ESP-01S烧录支持MQTT的AT指令固件。如果固件不对，发送MQTT相关的AT指令会一直失败。

注意：烧录固件需要用到USB转TTL工具，并让模块进入烧录模式（通常需要将GPIO0引脚拉低后复位）。具体的烧录接线和步骤，请严格按照资料包里的指南操作。

2. 硬件连接与工程搭建

2.1 连接STM32与ESP-01S

连接非常简单，本质上就是串口通信。我们使用STM32的USART2与ESP-01S通信。

接线表：

提示：ESP-01S的RX/TX引脚是3.3V电平，直接与STM32的USART引脚连接即可，无需电平转换。

2.2 在工程中移植驱动文件

原始资料提供了完整的驱动文件bsp_esp01s.c和bsp_esp01s.h。你需要将它们添加到你的STM32工程中，过程和其他外设（如DHT11）的移植类似：

1. 将这两个文件复制到你的工程目录下（例如User/bsp文件夹）。
2. 在IDE（如Keil）的工程管理器中，把.c文件添加到对应的分组。
3. 在main.c中包含头文件#include "bsp_esp01s.h"。
4. 根据你的硬件，检查并确认bsp_esp01s.h中的引脚宏定义是否正确（默认使用USART2，PA2/PA3）。

3. 驱动代码解析：如何与ESP-01S“对话”

与ESP-01S通信的核心是串口收发和AT指令处理。我们来看看驱动文件里的关键函数。

3.1 串口与中断初始化

首先，需要初始化USART2，并配置好中断来接收ESP-01S返回的数据。

void WIFI_USART_Init(unsigned int bund) { // ... 初始化GPIO（PA2为复用推挽输出，PA3为浮空输入） // ... 配置USART2参数（波特率、数据位、停止位等） // 关键：使能接收中断和空闲中断 USART_ITConfig(WIFI_USART, USART_IT_RXNE, ENABLE); // 接收缓冲区非空中断 USART_ITConfig(WIFI_USART, USART_IT_IDLE, ENABLE); // 空闲线路中断 // ... 配置NVIC中断优先级并开启串口 }

这里使用了空闲中断。当ESP-01S回复完一条AT指令后，串口总线会有一段时间空闲，触发这个中断，标志着一次完整的回复接收完毕，非常方便。

中断服务函数WIFI_USART_IRQHandler负责把接收到的字节存入缓冲区WIFI_RX_BUFF，并在空闲中断发生时，设置接收完成标志WIFI_RX_FLAG。

3.2 AT指令发送与应答检测

这是驱动层最核心的函数，它封装了“发送指令-等待回复-判断结果”的完整流程。

char WIFI_Send_Cmd(char *cmd, char *ack, unsigned int waitms, unsigned char cnt) { uint8_t tt = 0; re: WIFI_USART_send_String((unsigned char*)cmd); // 1. 发送AT指令 while(cnt--) { delay_1ms(waitms); // 等待一段时间 // 检查是否收到数据 if( WIFI_RX_FLAG == 1 ) { WIFI_RX_FLAG = 0; // 在接收缓冲区中查找期待的应答字符串，如"OK" if( strstr((char*)WIFI_RX_BUFF, ack) != NULL ) { return 1; // 成功收到预期应答 } memset( WIFI_RX_BUFF, 0, sizeof(WIFI_RX_BUFF) ); // 清除缓冲区 } } // 如果重试次数内未成功，尝试重新发送（最多3次） if(tt < 3) { tt++; goto re; } return 0; // 失败 }

使用这个函数：比如我们要测试模块是否正常，就调用WIFI_Send_Cmd("AT\r\n", "OK", 100, 3)，意思是发送"AT"，等待100ms，最多等3个100ms，只要在回复里找到"OK"就返回成功。

4. 实战一：配置AP模式（模块开热点）

AP模式适合近距离、点对点的控制场景，比如用手机APP直接控制一个智能灯，不需要路由器。

4.1 AP模式初始化流程

在WIFI_MODE_AP_Init函数中，通过一系列AT指令完成配置：

uint8_t WIFI_MODE_AP_Init(void) { uint8_t ret = 0; char send_buff[200]; // 1. 测试指令 ret = WIFI_Send_Cmd("AT\r\n", "OK", 10, 3); if( ret != 1 ) return ret; // 2. 设置模式为AP (2) ret = WIFI_Send_Cmd("AT+CWMODE=2\r\n","OK",30,3); if( ret != 1 ) return ret; // 3. 设置热点名称和密码 sprintf(send_buff, "AT+CWSAP=\"%s\",\"%s\",11,4\r\n", AP_WIFISSID, AP_WIFIPASS); ret = WIFI_Send_Cmd(send_buff,"OK",30,3); if( ret != 1 ) return ret; // 4. 复位使配置生效 ret = WIFI_Send_Cmd("AT+RST\r\n","ready",800,3); if( ret != 1 ) return ret; // 5. 允许多个设备连接 ret = WIFI_Send_Cmd("AT+CIPMUX=1\r\n","OK",50,3); if( ret != 1 ) return ret; // 6. 开启TCP服务器，端口5000 ret = WIFI_Send_Cmd("AT+CIPSERVER=1,5000\r\n","OK",50,3); return ret; }

关键指令解释：

• AT+CWMODE=2：设置模式为AP。
• AT+CWSAP：配置热点的SSID（名称）和密码。11代表信道，4代表加密方式（WPA2_PSK）。
• AT+CIPMUX=1：开启多连接，允许多个客户端（比如多部手机）同时连接。
• AT+CIPSERVER=1,5000：启动TCP服务器，监听5000端口。

配置成功后，用手机就能搜索到名为AP_WIFISSID（代码中默认为"ESP-01S"）的热点，连接密码为AP_WIFIPASS。

4.2 处理手机连接与数据收发

模块作为服务器，需要处理客户端的连接、断开和数据。

连接状态检测：函数Get_Device_connection_status通过解析模块主动上报的信息来判断状态。

• 手机连接热点时，模块会发送：+STA_CONNECTED:"手机MAC地址"
• 手机连接服务器（即连接5000端口）时，模块会发送：,CONNECT

接收手机数据：当手机APP发送数据时，模块会通过串口上报格式如+IPD,<连接ID>,<数据长度>:<实际数据>的信息。函数Get_WIFI_AP_Data就是用来解析这个字符串，提取出连接ID、数据长度和数据内容。

向手机发送数据：使用WIFI_Send_To_Client函数，指定连接ID和要发送的字符串即可。

4.3 AP模式主程序示例

在main函数中，我们可以这样使用：

int main(void) { AP_PARAMETER ap_parameter={0}; // 用于保存解析后的数据 board_init(); // 系统初始化 uart1_init(115200U); // 初始化调试串口 printf("AP Mode Start\r\n"); WIFI_ESP01S_Init(); // 初始化WIFI串口 WIFI_MODE_AP_Init(); // 配置为AP模式并开启服务器 while(1) { // 不断检查连接状态 Get_Device_connection_status(); // 如果当前有设备连接了服务器（手机APP连上了5000端口） if( wifi_link_flag == 2 ) { // 尝试获取手机发来的数据 if( Get_WIFI_AP_Data(&ap_parameter) == 1 ) { printf("Client ID:%d sent: %s\r\n", ap_parameter.device_id, ap_parameter.device_data); // 这里可以根据接收到的数据控制LED、继电器等 // 例如，如果收到"LED_ON"，就点亮LED if(strcmp((char*)ap_parameter.device_data, "LED_ON") == 0) { LED_ON(); // 还可以回复手机 WIFI_Send_To_Client(ap_parameter.device_id, "LED is ON"); } } } } }

5. 实战二：配置STA模式并接入阿里云

STA模式是更常见的应用，让设备接入现有WiFi网络，从而访问互联网。这里我们以连接阿里云物联网平台为例。

5.1 阿里云设备三元组

在连接前，你需要在阿里云物联网平台创建一个产品和一个设备，获取至关重要的“三元组”：

• ProductKey：产品标识
• DeviceName：设备名称
• DeviceSecret：设备密钥

这三个信息需要填写到bsp_esp01s.h文件的对应宏定义中，同时也要填写你要连接的WiFi热点的SSID和密码。

// 在 bsp_esp01s.h 中修改 #define WIFISSID "Your_WiFi_SSID" // 你的WiFi名称 #define WIFIPASS "Your_WiFi_Password" // 你的WiFi密码 #define DeviceName "Your_Device_Name" // 阿里云设备名称 #define ProductKey "Your_Product_Key" // 阿里云产品Key #define DeviceSecret "Your_Device_Secret" // 阿里云设备密钥

5.2 STA模式连接阿里云流程

核心函数是WIFI_MODE_STA_Aliyun_Init，它完成了从连接WiFi到登录阿里云MQTT服务器的全过程。

1. 基础配置与连接WiFi：

WIFI_Send_Cmd("AT\r\n","OK",100,3); // 测试指令 WIFI_Send_Cmd("AT+CWMODE=1\r\n","OK",300,3); // 设置为STA模式 // 设置NTP服务器，用于同步时间（阿里云MQTT需要） WIFI_Send_Cmd("AT+CIPSNTPCFG=1,8,\"ntp1.aliyun.com\"\r\n","OK",100,3); // 连接指定的WiFi热点 sprintf(AT_CMD,"AT+CWJAP=\"%s\",\"%s\"\r\n",WIFISSID,WIFIPASS); WIFI_Send_Cmd(AT_CMD,"OK",3000,3); // 连接WiFi，等待时间可设长些

2. 计算MQTT连接密码：阿里云使用基于DeviceSecret的HMAC-SHA1签名作为密码。驱动中CalculateSha1函数完成了这个计算。你不需要修改它，只需确保DeviceSecret正确。

3. 配置并连接MQTT服务器：

// 配置MQTT用户名、密码等参数 sprintf(AT_CMD,"AT+MQTTUSERCFG=0,1,\"NULL\",\"%s\",\"%s\",0,0,\"\"\r\n", UserName, PassWord); WIFI_Send_Cmd(AT_CMD,"OK",2000,3); // 设置客户端ID sprintf(AT_CMD,"AT+MQTTCLIENTID=0,\"%s\"\r\n",ClientId); WIFI_Send_Cmd(AT_CMD,"OK",1000,3); // 连接到阿里云MQTT服务器 sprintf(AT_CMD,"AT+MQTTCONN=0,\"%s\",1883,1\r\n",IP); // IP是阿里云服务器地址 WIFI_Send_Cmd(AT_CMD,"OK",2000,3); // 订阅主题，用于接收云端下发的指令 sprintf(AT_CMD, "AT+MQTTSUB=0,\"%s\",1\r\n", PublishMessageTopSet); WIFI_Send_Cmd(AT_CMD,"OK",1000,3);

连接成功后，模块就与阿里云平台建立了长连接。

5.3 与阿里云的数据交互

接收云端指令（属性设置）：当你在阿里云平台或手机APP上点击开关，云端会下发一条JSON格式的MQTT消息到设备。函数Get_Aliyun_json_data负责解析这个消息。

例如，收到的消息可能是：

+MQTTSUBRECV:0,"/sys/a1PJRLOWo3p/TEST/thing/service/property/set",100,{"method":"thing.service.property.set","id":"367399823","params":{"LED_Switch":1},"version":"1.0.0"}

Get_Aliyun_json_data会从中解析出keyname为"LED_Switch"，value为"1"。你的主程序根据这个键值对去执行相应的操作（如点亮LED）。

向云端上报数据：使用Publish_MQTT_message函数。你需要先定义一个JSON_PUBLISH结构体数组，里面存放你要上报的属性名和值。

// 定义要上报的属性 JSON_PUBLISH publish_mqtt_message[2] = { { "\\\"LED_Switch\\\":","0" }, // 注意字符串内的转义 { "\\\"brightness\\\":","0" } }; // 在需要上报时，比如定时上报传感器数据 void report_sensor_data(int led_status, int brightness) { sprintf(publish_mqtt_message[0].value, "%d", led_status); sprintf(publish_mqtt_message[1].value, "%d", brightness); Publish_MQTT_message(publish_mqtt_message, 2); // 上报两个属性 }

这个函数会构造出符合阿里云物模型标准的JSON字符串，并通过AT指令AT+MQTTPUB发布到云端。

6. 调试心得与常见问题

1. 模块无响应：首先检查电源是否为3.3V且稳定，电流是否足够（建议电源能提供500mA以上）。然后检查TX/RX是否接反，波特率是否正确（默认115200）。
2. AT指令返回ERROR：仔细核对指令格式，确保每条指令以\r\n结尾。另外，确认烧录的固件是否支持你使用的AT指令集（特别是MQTT相关指令）。
3. 连接WiFi失败：检查WIFISSID和WIFIPASS是否正确，以及路由器是否设置了MAC地址过滤。
4. 连接阿里云失败：99%的问题出在三元组。请逐字核对ProductKey、DeviceName、DeviceSecret是否与物联网平台上完全一致，包括大小写。同时检查设备在平台上是否为“启用”状态。
5. 数据收发异常：利用调试串口打印出所有AT指令和模块的回复，这是最有效的调试手段。确保你的串口接收缓冲区WIFI_RX_BUFF足够大，能容纳完整的回复数据。
6. 模块发热严重：如果模块持续发热，可能是电源电压过高或短路，立即断电检查。

ESP-01S是一个非常经典的WiFi模块，虽然内存和功能有限，但对于简单的物联网设备接入来说绰绰有余。掌握好AT指令的交互逻辑，无论是连接本地热点还是上云，思路都是相通的。希望这篇教程能帮你顺利打通STM32与云端的连接。在实际项目中，你还需要考虑网络重连、数据重发、低功耗等更多细节，但有了这个基础框架，剩下的就是在此基础上不断完善了。