简介这是一套面向物联网初学者的完整工程资源涵盖STM32单片机端与手机端的无线通信实现方法。项目通过控制ESP8266Wi-Fi模块开启AP接入点模式让手机能够借助TCP传输控制协议与其建立双向数据连接适用于智能家居、远程控制等场景的入门学习。资源包共169个文件、约8.77MB主体为STM32底层驱动和应用程序的.c/.h源码同时附带编译好的.hex/.axf固件、可直接安装的WIFI.apk以及Keil工程配置文件其中也包含部分编译中间文件便于理解代码生成与烧录流程。目前已有1181人学习。内容完整覆盖设备端与应用端包括ESP8266的AT指令配置、STM32串口数据中转以及手机端App Inventor图形化编程的通信界面从热点创建到数据收发形成了可运行的闭环能帮助课程设计或物联网入门开发者快速理解AP模式、TCP协议、串口中转和移动端Socket通信等核心概念也适合在此基础上进行功能扩展与二次开发。1. 把ESP8266当APSTM32和手机之间省掉路由器这个组合我第一次调试时最意外的点是ESP8266在AP模式下当TCP Server比手机连路由器、再经过公网中转的方案稳定得多延时基本在10ms以内而且不依赖外网。STMF103C8通过USART1把指令发给ESP8266手机用App Inventor拼出的APP直连热点走TCP发控制帧STM32解析后驱动继电器或LED再通过SYN6288把状态播报出来——一套典型的智能家居控制闭环。源码包里同时给了.axf编译产物、HAL库的定时器和串口源文件以及可直接安装的WIFI.apk说明作者已经把从固件到手机端的全链路打通了。这套结构适合做宿舍灯控、智能台灯、实验室门禁的课程设计或毕设也适合刚把F103C8从标准库切到CubeMXHAL的工程师当练手样板。2. ESP8266 AT指令链路AP模式建热点与TCP Server2.1 硬件连接USART1直连EN引脚和供电是两个常见翻车点ESP8266与STM32F103C8之间走串口通信。开发板上ESP8266的URXD、UTXD分别对应STM32的TX、RX交叉连接即可STM32F103C8引脚ESP8266引脚说明PA9 (USART1_TX)URXDSTM32发送AT指令PA10 (USART1_RX)UTXDESP8266回显与数据3.3VVCC / CH_PD(EN)模块供电CH_PD必须拉高GNDGND共地不能省注意ESP8266射频发射瞬间电流能到300mA以上开发板自带的3.3V LDO往往在峰值时掉电表现是AT指令时而回OK时而无响应。我一般用独立的AMS1117-3.3V从5V降压供电并在VCC和GND之间并一个470uF电解电容。CH_PDEN引脚悬空可能进入低功耗模式直接接到3.3V最省事。GPIO0保持悬空或上拉只有刷固件时才拉低。2.2 AT指令序列先CWMODE再CWSAP再CIPSERVERESP8266的AT指令以\r\n结尾配置AP模式后再启动TCP Server顺序不能乱AT\r\n ATCWMODE2\r\n ATCWSAPESP_AP,12345678,3,0\r\n ATRST\r\n ATCIPMUX1\r\n ATCIPSERVER1,8080\r\n ATCIFSR\r\n每条指令都等模块返回OK再发下一条ATRST后需要等待约1秒重启完成。ATCWMODE2把模块设为AP模式只做热点不连路由器ATCWSAP的参数分别是SSID、密码、信道号和加密方式3表示WPA2-PSK0是开放网络。ATCIPMUX1开启多连接模式这是启动Server的前置条件默认值0是单连接此时ATCIPSERVER会返回ERROR。ATCIPSERVER1,8080中的1表示开启Server8080是监听端口。最后用ATCIFSR查询模块自身IPAP模式下固定是192.168.4.1。手机上搜索到ESP_AP后输入密码连接再打开TCP调试工具连接192.168.4.1:8080ESP8266串口会回显0,CONNECT表示第一个客户端连进来了。这套指令序列在出厂固件和AT 1.7.4版本上都验证过。老版本固件如果ATCWMODE返回ERROR先执行ATGMR查版本低于1.5的建议刷官方AT固件。2.3 非透传与透传的取舍TCP Server建立后ESP8266向客户端发数据有两种方式。非透传模式每次发数据都要指定连接号和长度ATCIPSEND0,5\r\n hello\r\n模块返回提示符后输入数据发送完成会回显SEND OK。这种方式每帧数据多12字节左右的AT协议开销但帧边界清晰STM32端容易解析。透传模式把串口收到的所有字节直接转发给指定连接ATCIPMODE1\r\n ATCIPSEND\r\n # 此后串口所有数据直接发给客户端退出透传发送 我一般不在STM32项目里用透传原因两个一是透传期间AT回显全部混进数据流状态机必须额外分辨IPD和WIFI CONNECTED这类字符串二是ESP8266固件对透传模式下接收超时、Server多客户端切换处理不一致反而增加调试成本。非透传的12字节开销在局域网内完全无所谓。3. STM32F103C8 HAL工程串口中断收指令与SYN6288联动3.1 CubeMX引脚规划与时钟配置用STM32CubeMX建工程时SYS调试接口选Serial Wire否则烧录一次后SWD引脚被占用连接报Error: No STM32 Target Found。RCC用HSE外部8M晶振时钟树配到72MHz主频。引脚分配如下外设引脚参数USART1PA9/PA10115200 8N1开全局中断USART2PA2/PA39600 8N1接SYN6288GPIO输出PC13板载LED用于指示状态GPIO输入PA0外部按键模拟本地控制源码包里的stm32f1xx_hal_uart.c和stm32f1xx_hal_tim.c说明作者用的就是HAL库加定时器和CubeMX生成的代码结构一致。SYN6288中文语音合成模块的串口波特率固定9600如果SPK端没有声音先查PA2的TX是否真正输出3.3V电平有些USB转TTL模块会把RX拉低导致数据被吞。3.2 串口中断接收与帧解析状态机USART1接收ESP8266的数据既有IPD开头的TCP载荷也有连接状态回显。我在HAL工程里用单字节接收中断配合环形缓冲uint8_t esp8266_pool[256]; volatile uint16_t head 0, tail 0; void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { static uint8_t byte; if (huart-Instance USART1) { esp8266_pool[head] byte; head (head 1) % sizeof(esp8266_pool); HAL_UART_Receive_IT(huart1, byte, 1); // 重新挂载接收 } }回调里每收到一个字节就存入环形缓冲同时立即重新调用HAL_UART_Receive_IT挂下一次接收。这个写法避免在中断里做太长逻辑也防止串口只收到第一字节就停住。主循环里做协议解析帧格式定义为#define FRAME_HEAD1 0xAA #define FRAME_HEAD2 0x55 uint8_t frame_buf[16]; uint8_t frame_len 0; int uart_parse_frame(uint8_t byte) { static uint8_t state 0; switch (state) { case 0: if (byte FRAME_HEAD1) state 1; break; case 1: if (byte FRAME_HEAD2) { state 2; frame_len 0; } else if (byte ! FRAME_HEAD1) { state 0; } break; default: frame_buf[frame_len] byte; if (frame_len 2 frame_len frame_buf[0] 2) { if (frame_buf[frame_len - 1] checksum(frame_buf, frame_len - 1)) { state 0; return 1; // 一帧完整指令 } state 0; } break; } return 0; }帧头AA 55用于同步字节流frame_buf[0]是载荷长度最后一个字节是累加和校验。手机上发送的TCP数据混在IPD,0,len:之后所以主循环要先判断环形缓冲里是否有IPD关键字再进入帧解析。这里有一个坑ESP8266的IPD回显和数据是同一串字节流连续到达如果两个客户端同时发数据IPD,1,len:和IPD,0,len:会交错单状态机容易被带偏。我的做法是记录当前活跃连接号忽略非活跃连接的IPD段直到\n结尾再恢复解析。3.3 指令映射与SYN6288语音播报解析出完整帧后根据载荷里的命令字映射到具体动作uint8_t handle_frame(uint8_t *payload, uint8_t len) { uint8_t cmd payload[1]; switch (cmd) { case 0x01: // 开灯 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_RESET); Syn6288_PlayText(设备已开启); return 1; case 0x02: // 关灯 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_SET); Syn6288_PlayText(设备已关闭); return 1; case 0x03: // 回传状态 snprintf((char *)tx_buf, sizeof(tx_buf), ATCIPSEND0,%d\r\n, 10); HAL_UART_Transmit(huart1, tx_buf, strlen(tx_buf), 100); HAL_UART_Transmit(huart1, LEDON\r\n, 9, 100); return 1; default: return 0; } }Syn6288_PlayText对应源码包里的语音合成驱动SYN6288的帧结构是帧头0xFD、数据区长度、命令字和GBK编码的文本作者已经把编码和校验封装好了直接调用即可。注意SYN6288播报是阻塞式串口发送数据量大的时候会占用几十毫秒如果此时USART1正好有TCP数据进来HAL中断还能收但主循环解析会延迟。建议把USART1的中断优先级设为最高USART2次之Syn6288_PlayText内部改用HAL_UART_Transmit_IT非阻塞发送更稳妥。4. App Inventor拼TCP客户端连热点、发指令、收回显4.1 组件清单与属性配置App Inventor的官方组件库里没有现成的TCP客户端需要导入社区维护的TcpClient扩展.aix文件。不同扩展包的块名称略有出入但核心API一致Connect(host, port)、SendText(text)、ReceivedText事件。在组件面板里需要配置以下组件组件关键属性用途TcpClient1无代码块控制TCP连接管理TextBox1HintText设为「192.168.4.1」输入或显示服务器IPTextBox2HintText设为「8080」输入端口号TextBox3多行勾选显示接收数据Button1Text设为「连接」触发TCP连接Button2Text设为「发送」触发数据发送Notifier1无显示连接错误手机必须先手动在系统设置里连接到ESP_AP这个热点再打开APP。因为热点没有外网部分安卓手机会提示“该WiFi无法访问互联网”然后自动切回4G导致TCP连接立刻断开。这个要在手机的WiFi高级设置里关闭“智能切换网络”或者在代码里通过Notifier提示用户保持连接。4.2 Blocks拼接逻辑App Inventor是拼积木式开发逻辑搭起来之后相当于下面的流程def Button1_Click(): # 连接按钮 result TcpClient1.Connect(192.168.4.1, 8080) if result True: Label1.Text 已连接 else: Notifier1.ShowAlert(连接失败) def Button2_Click(): # 发送按钮 data AA55010189 # 十六进制字符串 TcpClient1.SendText(data) def TcpClient1_ReceivedText(text): # 接收事件 TextBox3.Text text if LEDON in text: Label1.Text 设备状态开关键点在于SendText发送的是字符串TCP字节流里每个字符对应一个ASCII码所以STM32端收到的实际上不是二进制AA 55而是0x41 0x41等十六进制字符。我一般在手机端直接把要发的十六进制内容转换成可打印字符串比如AA55010189STM32端用strtol或逐字符拼十六进制来还原。也可以在App Inventor里用扩展块的SendHex方法直接发二进制字节但每个TCP扩展实现不同建议先在STM32端用串口打印确认收到的原始字节再决定解析方式。4.3 APK打包与权限处理App Inventor打包APK时默认带INTERNET权限局域网TCP通信不需要额外申请位置权限但Android 8以上系统如果目标SDK版本较高连接WiFi前需要先打开定位开关才能扫描到热点。这里只是连接已知热点不扫描所以定位开关可以不开。如果手机连不上ESP8266的热点检查AP信道设置ATCWSAP里的信道号3在多数手机上没问题但部分手机对信道12/13支持差固定用1~6更稳。5. 联调中最容易翻车的三个细节5.1 区分AT回显与透传数据STM32串口收到的数据里同时存在AT OK回显、WIFI CONNECTED状态、IPD前缀和真正的TCP载荷。我维护一个状态机在AT配置阶段所有串口数据都打到调试口当收到0,CONNECT进入“在线”状态后只提取IPD之后的部分进入业务解析。不要试图从整段字节流里直接找帧头ESP8266的回显字符串里完全可能包含0xAA字节直接误判。5.2 半包与粘包的处理策略TCP是字节流协议没有消息边界。手机快速连发多条指令时STM32可能一次中断收到两帧拼在一起也可能一帧被拆成两半。半包状态下环形缓冲里只有AA 55没有完整载荷下一段数据到达后需要把两段拼接。上面第3章的状态机天然处理了这个问题——状态停留在state2等后续字节补齐。粘包则是连续解析出多帧主循环里用while反复调用uart_parse_frame()直到返回0。发送频率控制在100ms以上基本不会丢帧。5.3 烧录与排查检查表源码包里的stm32f103c8_syn6288_wifi_code.axf是Keil编译产物用ST-LINK直接烧录即可也可用J-Flash转成.hex烧录。排查问题按顺序来先用USB转TTL单独测ESP8266串口助手发AT看是否回OK确认波特率是115200而不是9600再测手机能否搜索到热点然后测STM32的PA9/PA10接线是否交叉最后看ATCIFSR返回的IP。如果SYN6288不播报确认USART2波特率9600且Syn6288_PlayText传入的是GBK编码App Inventor发过来的中文在传输时通常是UTF-8需要在STM32端转码。实际经验里还有一条HAL库定时器的HAL_TIM_PeriodElapsedCallback如果同时被多个定时器触发回调里要判断htim-Instance否则只写了一个定时器的处理逻辑其他定时器中断会把共享变量冲掉。本文还有配套的精品资源点击获取