简介这是一套面向嵌入式开发初学者与物联网实践者的完整智能灯光控制系统项目资源基于STM32F103C8T6主控、ESP8266 WiFi模块、OneNet云平台及自研Android APP实现远程灯光调控。项目覆盖硬件驱动如TIM/PWM控制LED亮度、WiFi透传协议解析、MQTT/HTTP接入OneNet云端、以及安卓端双向通信与UI交互全流程适用于课程设计、毕业设计及IoT入门实战。压缩包共582个文件含102个C源文件如stm32f1xx_hal_tim.c、112个头文件、59个XML布局与配置文件、102个编译中间文件.d/.o以及Gradle构建脚本和Java核心逻辑总大小10.87MB结构清晰分为androidControlAPP工程与stm32Project单片机固件两大模块。已有210人学习下载提供可直接编译运行的完整工程、关键外设初始化范例、ESP8266 AT指令调试记录及云端设备绑定说明助开发者快速掌握软硬协同开发闭环。1. 项目概述从零构建一个云端可控的智能灯最近在工作室捣鼓一个智能灯光控制系统核心目标很简单用手机APP随时随地控制一盏灯并且能记录它的开关状态。听起来像是市面上智能家居产品的简化版但自己做一遍从硬件选型、固件开发、云端对接再到APP编写整个链路走通对嵌入式物联网IoT开发的理解会深刻得多。这个项目非常适合有一定单片机基础想迈入物联网领域的开发者练手。我选择的方案是经典的“MCUWiFi模组”组合STM32F103C8T6作为主控负责逻辑控制和PWM调光ESP8266作为网络模块负责连接WiFi和与云端通信中国移动的OneNet作为云端平台进行设备管理和数据中转最后自己开发一个简单的安卓APP作为控制终端。这套组合成本低廉、资料丰富是学习物联网架构的绝佳样板。接下来我会详细拆解每个环节的设计思路、实操步骤以及我踩过的那些坑。2. 核心硬件选型与电路设计解析2.1 为什么是STM32F103C8T6和ESP8266在项目启动时硬件选型决定了后续开发的难度和天花板。我选择STM32F103C8T6以下简称C8T6和ESP8266是基于成本、性能、生态和项目需求的综合考量。STM32F103C8T6江湖人称“蓝莓派”是一款基于ARM Cortex-M3内核的MCU。它在这个项目中的核心优势在于强大的外设支持我们需要至少一个硬件PWM通道来实现灯光无频闪平滑调光。C8T6的定时器资源丰富轻松产生高精度PWM信号。同时其USART串口用于与ESP8266稳定通信GPIO用于读取本地按键预留手动控制功能。充足的性能与资源72MHz主频、64KB Flash、20KB RAM对于运行一个包含串口解析、逻辑控制、PWM输出的轻量级实时系统绰绰有余。即使未来想加入更复杂的色彩模式如RGB灯资源也足够。极佳的生态与性价比市面上有大量现成的“最小系统板”价格通常在十元左右。其Keil MDK或STM32CubeIDE的开发环境、HAL库/标准库都非常成熟调试工具ST-Link也便宜易得极大降低了学习和开发门槛。ESP8266则是物联网领域的“现象级”芯片。它本身就是一个集成了WiFi和MCU的SOC但在这个项目中我们将其用作“透传模块”即只利用其WiFi连接和TCP/IP协议栈功能。这样做的原因是功能解耦让C8T6专注于核心控制业务如调光算法、本地交互让ESP8266专注于网络通信。架构清晰便于调试和维护。如果将所有逻辑都放在ESP8266上用Arduino或NodeMCU开发虽然硬件更简单但对于学习设备-云端分离的物联网架构不利。稳定性与可靠性ESP8266的AT指令固件经过长期迭代在连接路由器和保持长连接方面相对稳定。我们可以通过简单的串口指令如ATCIPSTART、ATCIPSEND让其连接OneNet的MQTT服务器而无需在C8T6上实现复杂的TCP/IP协议栈。成本与功耗ESP-01S模块价格仅十元左右且具有深度睡眠模式适合低功耗场景本项目常电供电未重点优化功耗。注意ESP8266有多个版本推荐使用ESP-01S。它与老版ESP-01外观相似但内部Flash通常为1MB且默认固件更稳定对AT指令集支持更好。购买时务必确认型号。2.2 电路连接与电源设计要点硬件连接的核心是让C8T6和ESP8266能正确通信并为整个系统提供干净、稳定的电源。1. 串口通信连接这是两者交互的“高速公路”。我们需要将C8T6的一个USART例如USART2与ESP8266的UART连接。C8T6 USART2_TX (PA2)-ESP8266 RXDC8T6 USART2_RX (PA3)-ESP8266 TXD双方GND必须共地。这里有一个关键细节ESP8266的IO口电平是3.3V而C8T6虽然也是3.3V供电但其部分引脚可容忍5V输入。为确保通信稳定最好在两者TX和RX之间串联一个330Ω-1kΩ的电阻起到限流和保护作用。如果使用3.3V供电的C8T6最小系统板通常可以直接连接。2. 电源与使能控制ESP8266在发射WiFi信号时瞬时电流可能超过200mA因此对电源要求较高。必须使用独立LDO供电不要直接从C8T6开发板的3.3V引脚取电该引脚的输出电流通常不足以支撑ESP8266。建议使用一片AMS1117-3.3或性能更好的LDO输入5V输出3.3V单独为ESP8266供电。整个系统的电源拓扑可以是5V电源输入 - 一路给C8T6最小系统板板载LDO另一路给独立的AMS1117-3.3为ESP8266供电。控制ESP8266的使能脚CH_PD/EN将此引脚通过一个10k电阻上拉到3.3V同时连接一个按键到地。这样可以通过按键复位ESP8266在程序里也可以通过C8T6的一个GPIO控制此引脚进行硬重启这在网络异常时是最后的恢复手段。GPIO0的处理GPIO0在上电时决定模块启动模式。高电平或悬空为正常运行模式低电平为下载模式。我们通常将其通过10k电阻上拉到3.3V确保每次上电都是正常运行。3. 灯光驱动电路如果控制的是普通LED灯珠或小功率LED灯带可以直接用C8T6的PWM引脚通过一个MOS管如IRF520或IRF540驱动。注意在MOS管的栅极G和C8T6的PWM引脚之间串联一个100-220Ω的电阻防止振荡和过冲。如果控制的是220V交流灯具务必使用隔离的继电器模块或固态继电器SSR严禁直接用单片机IO口控制高压电安全第一。3. 云端平台OneNet的配置与设备接入云端平台是连接设备和APP的“大脑”和“中转站”。选择OneNet是因为它对个人开发者友好有免费的设备接入额度和清晰的数据流管理界面。3.1 在OneNet上创建产品与设备首先你需要注册一个OneNet账号。登录后进入控制台开始创建我们的智能灯项目。创建产品在“产品开发”中选择“创建产品”。产品类别可以选择“智能家居”-“照明设备”。协议选择MQTT旧版公开协议资料多易于接入。其他信息如产品名称、型号按需填写。关键一步是设备接入方式选择“设备密钥”这样每个设备会有唯一的ProductID和APIKey安全性比直接使用设备ID更高。创建设备在产品详情页点击“添加设备”。你需要为你的智能灯起一个名字例如“Studio_Light_01”。设备编号DeviceID可以自定义也可以使用系统自动生成。创建成功后记录下三要素ProductID产品ID、DeviceID设备ID、APIKey设备密钥。这是ESP8266连接云端的“身份证”。定义数据流与命令物联网中设备上传的数据叫“数据流”平台下发的控制指令叫“命令”。数据流我们创建一个名为light_status的数据流用于上传灯的开关状态例如值可以是0或1。再创建一个名为brightness的数据流用于上传灯的亮度值0-100。命令在“命令”选项卡中创建一个命令名称设为switch参数格式设为JSON例如{status:1}。再创建一个命令brightness参数为{value:50}。这样APP就可以通过下发这些JSON格式的命令来控制设备。3.2 MQTT协议连接参数详解ESP8266通过AT指令以MQTT协议连接OneNet。你需要理解并准备好以下连接参数这些参数将用于组装AT指令MQTT服务器地址183.230.40.39MQTT服务器端口6002ClientID由三部分构成格式为ProductIDDeviceID。例如你的ProductID是123456DeviceID是dev001那么ClientID就是123456dev001。Username直接填写ProductID。Password这里需要计算。密码是Token其计算方式为对以下字符串进行MD5计算结果转为大写。 字符串格式products/产品ID/devices/设备IDexpires时间戳signmethodmd5其中expires是一个未来的时间戳例如当前时间1年的秒数signmethod固定为md5。计算出的MD5值就是密码。OneNet官网有在线的Token计算工具初次使用时可以借助工具生成并验证你的算法是否正确。KeepAlive心跳包间隔设为120秒即可。实操心得MQTT连接失败90%的原因出在ClientID、Username或PasswordToken的格式错误。建议先在电脑上用MQTT客户端软件如MQTT.fx使用这些参数连接OneNet成功后再移植到嵌入式端这样可以排除参数错误将问题隔离在硬件和网络层面。4. STM32与ESP8266的固件开发详解这是项目的核心编码部分分为STM32的主控逻辑和ESP8266的通信逻辑。我采用前后台大循环中断的软件架构没有上RTOS以保持简洁。4.1 STM32端状态机与串口解析C8T6的程序主要处理几件事解析ESP8266发来的云端指令、控制PWM输出、检测本地按键、定时上报状态。1. 串口通信驱动与数据解析我们使用USART2与ESP8266通信配置为115200波特率8位数据位1位停止位无校验。关键在于设计一个稳定的串口数据接收解析机制。环形缓冲区Ring Buffer在串口接收中断USART2_IRQHandler中不要进行复杂的字符串处理仅仅将接收到的字节存入一个预先定义好的环形缓冲区。这能避免因处理速度慢而导致的数据丢失。状态机解析在主循环中定期检查环形缓冲区。ESP8266的AT指令响应和MQTT数据都以\r\n结尾。我们可以设计一个状态机寻找\r\n作为帧结束符将一帧完整的数据拷贝到解析缓冲区。指令识别对于接收到的数据帧首先要判断其类型。是AT指令的响应如OK,ERROR,IPD还是MQTT平台下发的消息通常OneNet通过MQTT下发的命令数据在ESP8266透传模式下会以IPD,len:data的格式出现。我们需要解析出data部分也就是APP下发的JSON字符串如{status:1}。// 示例简化的串口解析逻辑片段 void USART2_IRQHandler(void) { if(USART_GetITStatus(USART2, USART_IT_RXNE) ! RESET) { char ch USART_ReceiveData(USART2); ring_buffer_write(uart2_rx_buf, ch); // 写入环形缓冲区 } } void parse_uart_data(void) { char frame[256]; if(ring_buffer_find_frame(uart2_rx_buf, frame, \r\n)) { // 查找一帧数据 if(strstr(frame, IPD)) { // 提取MQTT数据部分 extract_mqtt_payload(frame, mqtt_payload); process_mqtt_message(mqtt_payload); // 处理JSON命令 } else if(strstr(frame, OK)) { // AT指令执行成功 at_cmd_state AT_CMD_OK; } // ... 其他响应处理 } }2. PWM调光驱动使用一个通用定时器如TIM3的通道如CH2对应引脚PB5产生PWM。在CubeMX中配置很方便。关键代码是改变捕获比较寄存器CCR的值来调整占空比从而改变亮度。// 初始化PWM频率设为1kHz1000Hz这样人眼感觉不到闪烁。 HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_2); // 设置亮度brightness范围0-100 void set_light_brightness(uint8_t brightness) { if(brightness 100) brightness 100; // 将百分比转换为CCR值。假设ARR自动重装载值设置为999则100%对应CCR999。 uint16_t ccr_value (uint16_t)((brightness / 100.0) * 999); __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_2, ccr_value); current_brightness brightness; }3. 主循环逻辑设计主循环是一个大的状态机协调所有任务。while (1) { // 1. 解析串口数据 parse_uart_data(); // 2. 处理来自云端的命令 if(new_mqtt_cmd_received) { handle_cloud_command(); new_mqtt_cmd_received 0; } // 3. 检测本地按键优先级高于云端 if(KEY_Scan() KEY_PRESS) { toggle_light_locally(); // 本地开关灯 // 状态改变后需要主动上报到云端 report_status_to_cloud(); } // 4. 定时上报状态例如每30秒 if(HAL_GetTick() - last_report_time 30000) { report_status_to_cloud(); last_report_time HAL_GetTick(); } // 5. 处理ESP8266的连接状态维护心跳、重连 handle_wifi_connection_state(); HAL_Delay(10); // 释放CPU }4.2 ESP8266端AT指令流程与控制我们将ESP8266设置为STA模式连接家庭WiFi然后以透传模式连接OneNet的MQTT服务器。STM32只需要通过串口发送一系列固定的AT指令即可完成初始化。上电初始化流程STM32发送ESP8266回复测试通信AT\r\n- 期待回复OK。这一步验证硬件连接和模块是否正常。恢复出厂设置ATRESTORE\r\n- 回复OK。清除之前的网络配置避免干扰。设置模式ATCWMODE1\r\n- 回复OK。设置为Station客户端模式。连接WiFiATCWJAP你的WiFi名,你的WiFi密码\r\n- 回复WIFI CONNECTED-WIFI GOT IP。这里等待时间较长程序里需要设置足够的超时时间如10秒。开启多连接ATCIPMUX0\r\n- 回复OK。设置为单连接模式适合MQTT。连接MQTT服务器ATCIPSTARTTCP,183.230.40.39,6002\r\n- 回复CONNECT-OK。进入透传模式ATCIPMODE1\r\n- 回复OK。然后发送ATCIPSEND\r\n- 回复。此后ESP8266会将所有从串口收到的数据原封不动地发送给服务器反之亦然。进入透传模式后不能再发送AT指令除非先退出透传发送注意不要带回车换行。在透传模式下发送MQTT连接报文MQTT协议需要按照其固定格式组包。STM32需要将连接参数组装成二进制报文通过串口发送给ESP8266。这是一个难点。你需要根据MQTT 3.1.1协议规范手动构造CONNECT、PUBLISH、SUBSCRIBE报文。例如CONNECT报文包含固定头、可变头和有效载荷ClientID, Username, Password等。网上有开源的C语言MQTT报文构造函数可以移植过来使用。维护连接与心跳在透传模式下STM32需要定时小于KeepAlive时间向服务器发送MQTTPINGREQ报文来维持连接。同时需要监听服务器下发的PINGRESP以及订阅主题上的消息PUBLISH。踩坑记录ESP8266在透传模式下如果网络断开它不会自动退出透传模式也不会返回任何错误信息给STM32。STM32会一直以为连接正常。因此必须在STM32端实现“应用层心跳”。即除了MQTT协议本身的PINGSTM32可以定时如每60秒通过串口向ESP8266发送一个特定的探测指令需要先发送退出透传发送AT\r\n检查然后再重新进入透传以此检测链路是否真正健康。这是一个非常重要的稳定性设计。5. 安卓APP开发控制界面与云端API调用APP的作用是作为用户界面向OneNet平台发送控制命令并查询设备的最新状态。我们开发一个最简单的原生安卓APP使用Java/Kotlin界面包含一个开关按钮和一个亮度滑条。5.1 界面布局与网络权限使用Android Studio创建一个新项目。在activity_main.xml中设计界面一个Switch或ToggleButton作为电源开关。一个SeekBar范围0-100作为亮度调节滑条。两个TextView用于显示当前状态。在AndroidManifest.xml中必须添加网络权限uses-permission android:nameandroid.permission.INTERNET /5.2 使用HTTP API与OneNet交互APP不直接连接设备而是通过调用OneNet提供的HTTP API与平台交互平台再将命令转发给设备。这是物联网平台的典型用法安全且解耦。1. 下发命令控制灯OneNet提供了“下发命令”的API。我们需要向一个特定的URL发送HTTP POST请求。API地址http://api.heclouds.com/cmds?device_id你的DeviceID请求头Headerapi-key: 你的设备APIKey注意这里是设备的APIKey不是产品的Content-Type: application/json请求体BodyJSON格式的命令。例如开灯{switch: 1} 调节亮度{brightness: 75}。在安卓中可以使用OkHttp或HttpURLConnection库来发送这个POST请求。// 示例使用OkHttp发送开灯命令 OkHttpClient client new OkHttpClient(); String json {\switch\: \1\}; RequestBody body RequestBody.create(json, MediaType.parse(application/json)); Request request new Request.Builder() .url(http://api.heclouds.com/cmds?device_id你的DeviceID) .post(body) .addHeader(api-key, 你的设备APIKey) .build(); client.newCall(request).enqueue(new Callback() { Override public void onFailure(Call call, IOException e) { // 网络错误处理 runOnUiThread(() - Toast.makeText(MainActivity.this, 命令发送失败, Toast.LENGTH_SHORT).show()); } Override public void onResponse(Call call, Response response) throws IOException { // 响应处理OneNet会返回一个JSON包含命令ID等信息 if(response.isSuccessful()) { runOnUiThread(() - Toast.makeText(MainActivity.this, 命令已下发, Toast.LENGTH_SHORT).show()); } } });2. 查询设备数据获取灯的状态APP需要知道灯当前是开是关亮度多少。这通过查询设备的数据流最新点API实现。API地址http://api.heclouds.com/devices/你的DeviceID/datastreams查询所有数据流或http://api.heclouds.com/devices/你的DeviceID/datastreams/light_status查询特定数据流请求头同样需要api-key。请求方法GET。收到响应后解析JSON更新界面上的开关和滑条状态。这个查询操作可以在APP打开时执行一次也可以定时轮询。5.3 数据解析与界面更新解析OneNet返回的JSON数据通常格式如下{ errno: 0, data: { current_value: 1, // 最新值 update_at: 2023-10-27 12:00:00 // 更新时间 } }根据current_value更新UI。注意网络请求是异步的所有UI更新操作必须在主线程UI线程中执行可以使用runOnUiThread()或Handler。注意事项频繁轮询会增加服务器压力和耗电量。一个优化方案是使用OneNet的消息推送功能。在平台配置“数据存储”或“触发器”当设备数据点更新时OneNet可以向一个你指定的服务器地址需要一个公网IP或内网穿透推送消息APP再从你的服务器获取更新。但这涉及更复杂的后端服务对于初学者定时轮询间隔30秒到1分钟是更简单直接的方案。6. 系统联调与问题排查实录将所有部分组合在一起时会遇到各种各样的问题。下面是我在调试过程中遇到的一些典型问题及解决方法。6.1 硬件与通信层问题问题1ESP8266模块无法连接WiFi一直返回FAIL。排查检查ATCWJAP指令中的SSID和密码是否正确特别注意大小写和特殊字符。最好先在手机或电脑上确认WiFi可连接。检查电源。用万用表测量ESP8266的VCC引脚电压在发射瞬间是否跌落到3.0V以下如果是说明电源功率不足必须更换为输出能力更强的LDO或电源模块。检查路由器设置。有些路由器开启了“AP隔离”或“访客网络”禁止设备间通信这会影响模块连接。尝试关闭这些功能。或者路由器对连接设备数有限制。ESP8266与路由器距离过远或信号太差。问题2STM32与ESP8266串口通信乱码或无反应。排查首要检查波特率ESP8266默认波特率通常是115200但有些卖家刷的固件可能是9600或其他。先用USB转TTL工具连接ESP8266用串口助手发送AT\r\n尝试不同波特率直到收到OK。检查电平确认双方都是3.3V电平。如果STM32板子是5V电平TX到ESP8266的RX需要电平转换。检查接线TX接RXRX接TXGND共地。这是最常接错的地方。检查代码确认STM32的串口初始化配置波特率、数据位、停止位、校验位与ESP8266一致。6.2 网络与云端接入问题问题3MQTT连接OneNet失败返回错误码。排查核对连接参数这是最高频错误点。逐字核对ClientID、Username、PasswordToken的格式和内容。特别是Token建议使用OneNet官方提供的在线计算工具生成一个与你代码计算的结果对比。检查网络时间Token计算依赖expires过期时间如果设备本地时钟不对STM32没有RTC计算出的Token可能已过期或未生效。确保生成Token时使用的时间戳在未来足够长的时间如当前时间1年。检查防火墙/网络确保设备所在的网络可以访问外网并且没有屏蔽183.230.40.39:6002这个端口。问题4设备在线但APP下发命令后设备无反应。排查检查设备是否订阅了命令主题在MQTT协议中设备需要订阅特定的主题才能接收命令。对于OneNet旧版MQTT命令下发的主题是$creq/命令ID。设备在连接后需要主动发送MQTT SUBSCRIBE报文订阅通配符主题$creq/#。请确认你的STM32代码中在MQTT连接成功后执行了订阅操作。检查APP的API调用使用抓包工具如Fiddler、Charles或网络调试助手拦截APP发出的HTTP请求。查看URL、Header尤其是api-key、Body是否正确。OneNet API返回的JSON中会有errno字段非0即表示错误根据错误码查文档。在OneNet控制台查看进入设备详情页查看“命令历史”。如果命令状态是“超时”或“失败”说明平台已下发但设备未响应。如果状态是“已送达”则说明设备收到了但未正确回复。设备需要在收到命令后向一个特定的主题发布回复消息平台才会将命令状态更新为“成功”。6.3 软件逻辑与稳定性问题问题5系统运行一段时间后网络断开且无法自动恢复。原因与解决这是物联网设备最常见的问题。网络环境是不稳定的。你的代码必须具备断线重连机制。STM32应用层心跳如前所述在透传模式下STM32需定时如每30秒退出透传发送发送ATCIPSTATUS或ATCIPSTART?查询连接状态如果断开则重新执行从连接WiFi开始的整个初始化流程。利用MQTT的KeepAlive确保你的MQTTCONNECT报文中的KeepAlive时间设置合理如120秒并且STM32定时发送PINGREQ。如果长时间未收到PINGRESP也应触发重连流程。看门狗Watchdog在STM32中启用独立看门狗IWDG在主循环中定期喂狗。如果程序跑飞或死锁导致网络维护任务停止看门狗会复位整个系统这是一种最后的保障。问题6PWM调光时灯光有闪烁或抖动。排查PWM频率过低如果频率低于100Hz人眼可能会感觉到闪烁。将定时器频率提高到500Hz或1kHz以上。电源干扰LED灯珠在亮度变化时电流变化较大如果电源纹波大会导致灯光抖动。在LED电源两端并联一个100-470uF的电解电容和一个0.1uF的瓷片电容可以很好地平滑电压。代码问题在改变PWM占空比CCR值时确保是在PWM周期更新事件之外进行或者使用__HAL_TIM_SET_COMPARE这类库函数它们通常会处理时序问题。整个项目调试的过程就是不断地在硬件、固件、云端、APP四个层面来回验证和排查。建议使用串口调试助手同时监听STM32的调试串口如果有多余串口和ESP8266的通信串口打印关键日志这是定位问题的利器。当手机APP上的按钮按下远处的灯应声而亮时那种成就感是对所有调试工作最好的回报。这个项目麻雀虽小五脏俱全涵盖了物联网从端到云再到应用的全流程理解它你就拿到了进入物联网开发大门的一把钥匙。本文还有配套的精品资源点击获取