企业官网建设流程全解析

在智能家居项目中，实现窗帘的远程和语音控制是一个高频需求。很多开发者尝试将STM32、WiFi模块、手机APP和云平台整合时，常常遇到硬件选型、网络协议对接、数据同步和稳定性等一系列难题，网上资料又往往只讲单一环节，缺乏一个从零到一的完整闭环方案。

本文将以“智能窗帘”为实战项目，系统拆解基于STM32单片机、ESP8266 WiFi模块、手机APP和OneNET云平台的全栈物联网开发流程。内容涵盖硬件电路设计、STM32固件开发、MQTT协议通信、APP界面编写以及云平台设备管理，并提供完整的可运行代码和配置。无论你是嵌入式新手想入门物联网，还是有一定基础的开发者希望整合软硬件，都能从本文获得可直接复用的解决方案。

1. 项目背景与核心概念

智能窗帘系统是现代智能家居的重要组成部分，它通过物联网技术，将传统的窗帘控制方式从手动拉合升级为远程无线控制、定时任务甚至语音交互。这不仅提升了生活便利性，也是学习嵌入式系统、无线通信和云平台技术的绝佳实践项目。

一个完整的智能窗帘物联网系统通常包含以下几个核心层：

1. 感知与控制层（设备端）：以STM32单片机为核心，负责采集窗帘状态（如通过限位开关或编码器判断位置），并驱动电机正反转来实现窗帘的打开与关闭。它是系统的“手”和“脚”。
2. 网络传输层：通常采用WiFi模块（如ESP8266/ESP32），负责将设备端的数据（如状态、指令）通过无线网络上传至互联网，并接收来自云平台或APP的控制指令。它是系统的“神经”。
3. 云平台层：如中国移动OneNET、阿里云物联网平台等。它作为数据中转站和设备管理后台，负责接收设备上报的数据并转发给APP，同时接收APP下发的指令并转发给设备。它还提供设备管理、数据可视化、规则引擎等高级功能。
4. 应用层（用户端）：即手机APP或微信小程序。为用户提供直观的操作界面，可以实时查看窗帘状态（开/关/百分比），并发送控制指令。部分高级应用还支持语音助手（如天猫精灵、小爱同学）集成，实现语音控制。

本项目的技术路线为：STM32 (MCU) + ESP8266 (WiFi) + MQTT (协议) + OneNET (云平台) + 安卓APP (应用)。我们将逐一攻克每个环节。

2. 环境准备与版本说明

在开始编码和硬件连接前，请确保你的开发环境已就绪。以下版本为本文示例所使用，实际操作时请根据你的硬件和软件情况进行适配。

硬件清单：

• 主控芯片：STM32F103C8T6 最小系统板（核心板）
• WiFi模块：ESP-01S (基于ESP8266)
• 电机驱动：L298N 电机驱动模块（用于驱动直流电机）或 ULN2003 驱动板（用于驱动步进电机）
• 执行机构：12V直流减速电机 或 28BYJ-48步进电机
• 电源模块：12V电源适配器（为电机供电），AMS1117-3.3V模块（为STM32和ESP8266提供3.3V）
• 其他：杜邦线、限位开关（2个）、USB转TTL串口模块、万用表、电烙铁等。

软件与工具清单：

• 集成开发环境 (IDE)：Keil uVision5 (MDK-ARM) 或 STM32CubeIDE
• 单片机程序框架：标准外设库 (Standard Peripheral Library) 或 HAL库。本文示例基于HAL库，因其可移植性更好。
• 串口调试助手：如XCOM、SSCOM，用于调试STM32与ESP8266的AT指令通信。
• APP开发环境：Android Studio (用于开发原生安卓APP)
• 云平台账号：中国移动OneNET物联网平台 (https://open.iot.10086.cn/) 注册账号。
• 网络协议调试工具：MQTT.fx 或 MQTTBox，用于测试设备与云端的MQTT连接。

关键软件版本：

• STM32CubeMX: 6.5.0
• HAL库版本: 1.8.0
• ESP8266 AT固件版本: 支持MQTT的AT指令集（如安信可提供的AT固件）
• OneNET MQTT旧版协议（较稳定，本文采用此协议）
• Android Studio: 2021.3.1 Patch 1

3. 核心原理与技术选型拆解

3.1 系统通信架构与协议选择

智能窗帘系统的核心是数据流。我们采用MQTT协议作为设备、云平台、APP之间的通信标准。MQTT是一种基于发布/订阅模式的轻量级消息协议，非常适合物联网设备在低带宽、不稳定网络环境下的通信。

工作流程如下：

1. STM32通过串口AT指令，控制ESP8266连接到家庭路由器，并作为MQTT客户端连接到OneNET云平台。
2. STM32将窗帘的当前状态（如{"curtain_state": 50}表示打开50%）通过ESP8266发布(Publish)到云平台指定的主题(Topic)。
3. 手机APP也作为另一个MQTT客户端连接到同一个OneNET云平台。
4. 当用户在APP上点击“打开”按钮时，APP会向云平台的一个特定主题发布一条控制命令（如{"cmd": "open"}）。
5. 云平台将该命令消息转发给订阅了该主题的设备（即我们的STM32设备）。
6. ESP8266通过串口将收到的命令数据传递给STM32。
7. STM32解析命令，控制电机转动，直到达到目标状态，然后上报新的状态，完成一个控制闭环。

3.2 硬件电路设计要点

1. STM32与ESP8266的连接：这是最关键的一环。ESP-01S通常通过串口与STM32通信。

• ESP8266_TX-> 连接 STM32的USART_RX引脚 (如PA3)
• ESP8266_RX-> 连接 STM32的USART_TX引脚 (如PA2)
• ESP8266_VCC-> 连接3.3V(必须稳定，电流足够，建议单独供电)
• ESP8266_GND-> 连接GND
• ESP8266_CH_PD/EN-> 连接3.3V(使能)
• ESP8266_GPIO0-> 悬空或接高电平（运行模式）
• ESP8266_RST-> 可通过STM32 GPIO控制，用于硬件复位。

2. STM32与电机驱动的连接：以L298N驱动直流电机为例：

• STM32 GPIO1(如PA0) -> L298NIN1
• STM32 GPIO2(如PA1) -> L298NIN2
• L298N OUT1, OUT2-> 连接直流电机两极。
• L298N供电：12V和GND接外部12V电源，5V输出可为STM32供电（需确认电压匹配）。
• 使能端ENA：可接PWM引脚实现调速，或直接接高电平使能。

3. 限位开关连接：用于检测窗帘完全打开和完全关闭的位置，防止电机堵转。

• 两个限位开关（常开型）一端分别接STM32的GPIO（如PC13， PC14），另一端接GND。
• STM32 GPIO配置为上拉输入模式。当窗帘碰到限位开关时，开关闭合，GPIO读到低电平。

3.3 OneNET云平台关键概念

• 产品：一类设备的集合。你需要先创建一个“智能窗帘”产品。
• 设备：归属于某个产品下的一个实体，对应你的一套STM32硬件。创建设备后，会获得唯一的设备ID (DEVICE_ID)和鉴权信息 (AUTH_INFO)，这是设备登录云平台的凭证。
• 数据流：设备的一种属性，如“curtain_state”。设备可以上报数据到数据流。
• API Key：用于从平台侧（如APP）访问该产品下设备数据的密钥。
• Topic：MQTT通信的主题。OneNET有预定义的主题格式，例如用于设备上报的$sys/{pid}/{device-name}/dp/post/json，用于命令下发的$sys/{pid}/{device-name}/cmd/request/{cmd-id}。

4. 完整实战案例：从零搭建智能窗帘系统

4.1 STM32端固件开发

我们使用STM32CubeMX进行初始化配置，然后使用Keil编写业务逻辑。

步骤1：使用STM32CubeMX创建工程

1. 选择MCU型号：STM32F103C8Tx。
2. 配置时钟：使用外部高速时钟(HSE)，系统时钟设置为72MHz。
3. 配置串口：USART1用于与ESP8266通信。模式为异步通信(Asynchronous)，波特率115200。
4. 配置GPIO：
   • 两个GPIO输出，用于控制L298N的IN1和IN2。
   • 两个GPIO输入（上拉模式），连接限位开关。
   • 一个GPIO输出，连接ESP8266的RST引脚（可选，用于复位）。
5. 配置一个定时器（如TIM2），用于产生PWM控制电机速度（可选）。
6. 生成代码，选择IDE为MDK-ARM。

步骤2：编写ESP8266 MQTT驱动代码核心是通过串口发送AT指令控制ESP8266。我们需要编写一个esp8266.c/.h文件。

// 文件：esp8266.h #ifndef __ESP8266_H #define __ESP8266_H #include “main.h” #include “stdio.h” #include “string.h” // 定义ESP8266连接的串口句柄 extern UART_HandleTypeDef huart1; #define ESP_UART &huart1 // 函数声明 void ESP8266_Init(void); uint8_t ESP8266_SendCmd(char *cmd, char *ack, uint16_t timeout); uint8_t ESP8266_ConnectWiFi(char *ssid, char *pwd); uint8_t ESP8266_ConnectMQTTServer(char *server, char *port, char *client_id, char *username, char *password); uint8_t ESP8266_MQTTPublish(char *topic, char *msg); void ESP8266_UART_RxCpltCallback(UART_HandleTypeDef *huart); // 串口接收中断回调 #endif

// 文件：esp8266.c #include “esp8266.h” char esp_rx_buffer[512]; // 接收缓冲区 uint16_t esp_rx_index = 0; uint8_t esp_rx_flag = 0; // 发送AT指令并等待应答 uint8_t ESP8266_SendCmd(char *cmd, char *ack, uint16_t timeout) { char rx_buffer[256]; uint16_t time = 0; esp_rx_index = 0; esp_rx_flag = 0; // 发送指令 HAL_UART_Transmit(ESP_UART, (uint8_t*)cmd, strlen(cmd), 1000); HAL_UART_Transmit(ESP_UART, (uint8_t*)"\r\n", 2, 1000); // AT指令以回车换行结束 // 等待应答 while(time < timeout) { if(esp_rx_flag == 1) { // 在串口中断中置位此标志 esp_rx_flag = 0; if(strstr((char*)esp_rx_buffer, ack) != NULL) { return 1; // 成功 } } HAL_Delay(10); time += 10; } return 0; // 超时失败 } // 连接WiFi uint8_t ESP8266_ConnectWiFi(char *ssid, char *pwd) { char cmd[128]; sprintf(cmd, “AT+CWJAP=\”%s\”,\”%s\””, ssid, pwd); return ESP8266_SendCmd(cmd, “OK”, 10000); // 连接WiFi可能较慢，超时设长 } // 连接OneNET MQTT服务器 (旧版协议) uint8_t ESP8266_ConnectMQTTServer(char *server, char *port, char *client_id, char *username, char *password) { char cmd[256]; // 设置MQTT客户端ID、用户名、密码 sprintf(cmd, “AT+MQTTCFG=\”%s\”,\”%s\”,\”%s\”,%s,0”, server, port, client_id, username); if(!ESP8266_SendCmd(cmd, “OK”, 3000)) return 0; // 发起连接 sprintf(cmd, “AT+MQTTCONN=1,\”%s\”,\”%s\””, username, password); return ESP8266_SendCmd(cmd, “+MQTTCONN:0”, 5000); // 连接成功返回 +MQTTCONN:0 } // 发布消息到主题 uint8_t ESP8266_MQTTPublish(char *topic, char *msg) { char cmd[512]; sprintf(cmd, “AT+MQTTPUB=\”%s\”,\”%s\”,1,0”, topic, msg); return ESP8266_SendCmd(cmd, “OK”, 3000); } // 串口接收中断回调函数（在stm32f1xx_it.c中调用） void ESP8266_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if(huart->Instance == ESP_UART->Instance) { uint8_t ch; HAL_UART_Receive_IT(ESP_UART, &ch, 1); // 重新开启中断 if(esp_rx_index < sizeof(esp_rx_buffer)-1) { esp_rx_buffer[esp_rx_index++] = ch; if(ch == ‘\n’) { // 简单以换行符作为一帧结束 esp_rx_buffer[esp_rx_index] = ‘\0’; esp_rx_flag = 1; esp_rx_index = 0; } } } }

步骤3：编写主业务逻辑在main.c中整合初始化、网络连接、电机控制和状态上报。

// 文件：main.c (部分关键代码) #include “esp8266.h” // 定义WiFi和OneNET信息 #define WIFI_SSID “Your_WiFi_SSID” #define WIFI_PWD “Your_WiFi_Password” #define ONENET_DEVICE_ID “123456789” // 你的设备ID #define ONENET_AUTH_INFO “your_auth_info” // 你的鉴权信息 #define ONENET_PRODUCT_ID “123456” // 你的产品ID // 窗帘状态枚举 typedef enum { CURTAIN_STOP = 0, CURTAIN_OPENING, CURTAIN_CLOSING, CURTAIN_OPEN, CURTAIN_CLOSE } CurtainState_t; CurtainState_t curtain_state = CURTAIN_STOP; int curtain_position = 0; // 0-100， 0为全关，100为全开 int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_USART1_UART_Init(); // ... 其他初始化 // 初始化ESP8266 ESP8266_Init(); HAL_Delay(2000); // 等待模块启动 // 连接WiFi while(!ESP8266_ConnectWiFi(WIFI_SSID, WIFI_PWD)) { HAL_Delay(2000); // 可添加LED闪烁提示连接失败 } // 连接OneNET MQTT char server[] = “183.230.40.39”; // OneNET旧版MQTT地址 char port[] = “6002”; char client_id[50]; sprintf(client_id, “%s”, ONENET_DEVICE_ID); while(!ESP8266_ConnectMQTTServer(server, port, client_id, ONENET_DEVICE_ID, ONENET_AUTH_INFO)) { HAL_Delay(2000); } // 上报初始状态 report_curtain_status(); while (1) { // 1. 检查限位开关 check_limit_switches(); // 2. 解析来自云平台的命令（在串口中断中接收并设置命令标志） parse_mqtt_message(); // 3. 根据命令和限位状态控制电机 control_motor(); // 4. 定时上报状态（例如每5秒或状态变化时） static uint32_t last_report = 0; if(HAL_GetTick() - last_report > 5000) { report_curtain_status(); last_report = HAL_GetTick(); } HAL_Delay(50); } } // 控制电机函数示例 void control_motor(void) { switch(curtain_state) { case CURTAIN_OPENING: HAL_GPIO_WritePin(MOTOR_IN1_GPIO_Port, MOTOR_IN1_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(MOTOR_IN2_GPIO_Port, MOTOR_IN2_Pin, GPIO_PIN_RESET); break; case CURTAIN_CLOSING: HAL_GPIO_WritePin(MOTOR_IN1_GPIO_Port, MOTOR_IN1_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(MOTOR_IN2_GPIO_Port, MOTOR_IN2_Pin, GPIO_PIN_SET); break; default: // STOP, OPEN, CLOSE HAL_GPIO_WritePin(MOTOR_IN1_GPIO_Port, MOTOR_IN1_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(MOTOR_IN2_GPIO_Port, MOTOR_IN2_Pin, GPIO_PIN_RESET); break; } } // 上报状态到OneNET void report_curtain_status(void) { char topic[100]; char msg[100]; // 构造OneNET数据点上报Topic sprintf(topic, “$sys/%s/%s/dp/post/json”, ONENET_PRODUCT_ID, ONENET_DEVICE_ID); // 构造JSON格式数据 sprintf(msg, “{\”id\”:123,\”dp\”:{\”curtain_state\”:[{\”v\”:%d}]}}”, curtain_position); ESP8266_MQTTPublish(topic, msg); }

4.2 OneNET云平台配置

1. 登录OneNET平台，进入“开发者中心”。
2. 创建产品：点击“产品创建”，选择“设备接入方式”为“公开协议”，“接入协议”选择“MQTT(旧版)”。填写产品名称“智能窗帘”，其他信息按需填写。
3. 添加设备：进入刚创建的产品，点击“添加设备”。填写设备名称（如Curtain_01）、鉴权信息（自己设定，需与代码中AUTH_INFO一致）。记录下生成的设备ID (DEVICE_ID)和产品ID (PRODUCT_ID)。
4. 创建数据流：进入设备详情页，在“数据流”标签页下，点击“添加数据流”，创建名为curtain_state的数据流。
5. 获取API Key：在产品详情页，点击“API-key”管理，创建一个具有“设备数据点查询”和“设备命令下发”权限的API Key，并记录下来，用于APP开发。

4.3 安卓APP开发（核心代码示例）

使用Android Studio，集成OneNET提供的MQTT SDK或使用开源的Paho MQTT库。

1. 添加依赖 (build.gradle):

dependencies { implementation ‘org.eclipse.paho:org.eclipse.paho.client.mqttv3:1.2.5’ implementation ‘org.eclipse.paho:org.eclipse.paho.android.service:1.1.1’ }

2. 连接OneNET并订阅命令下发主题:

// 文件：MqttManager.java public class MqttManager { private MqttAndroidClient mqttClient; private final String serverUri = “tcp://183.230.40.39:6002”; private final String clientId = “APP_” + UUID.randomUUID().toString(); // APP客户端ID需唯一 private final String userName = “YOUR_PRODUCT_ID”; // 产品ID private final String password = “YOUR_API_KEY”; // 产品的API Key public void connect() { try { mqttClient = new MqttAndroidClient(context, serverUri, clientId); MqttConnectOptions options = new MqttConnectOptions(); options.setUserName(userName); options.setPassword(password.toCharArray()); options.setCleanSession(true); options.setConnectionTimeout(10); options.setKeepAliveInterval(20); mqttClient.connect(options, null, new IMqttActionListener() { @Override public void onSuccess(IMqttToken asyncActionToken) { Log.i(“MQTT”, “Connected to OneNET”); // 连接成功后，订阅命令响应主题 subscribeToCmdResponse(); } @Override public void onFailure(IMqttToken asyncActionToken, Throwable exception) { Log.e(“MQTT”, “Connection failed”, exception); } }); // 设置消息到达回调 mqttClient.setCallback(new MqttCallback() { @Override public void connectionLost(Throwable cause) { } @Override public void messageArrived(String topic, MqttMessage message) throws Exception { // 处理设备上报的状态消息，更新UI String payload = new String(message.getPayload()); parseDeviceStatus(payload); } @Override public void deliveryComplete(IMqttDeliveryToken token) { } }); } catch (MqttException e) { e.printStackTrace(); } } private void subscribeToCmdResponse() { String topic = String.format(“$sys/%s/%s/dp/post/json”, productId, deviceId); try { mqttClient.subscribe(topic, 0); } catch (MqttException e) { e.printStackTrace(); } } }

3. 发送控制命令:

// 在Activity中发送打开窗帘命令 public void sendOpenCommand() { String topic = String.format(“$sys/%s/%s/cmd/request/%s”, productId, deviceId, UUID.randomUUID().toString()); String cmdMsg = “{\”cmd\”: \”open\”}”; // 命令内容需与设备端解析格式一致 try { MqttMessage message = new MqttMessage(cmdMsg.getBytes()); message.setQos(0); mqttClient.publish(topic, message); } catch (MqttException e) { e.printStackTrace(); } }

4. 解析设备状态更新UI:

private void parseDeviceStatus(String jsonStr) { try { JSONObject jsonObject = new JSONObject(jsonStr); JSONObject dp = jsonObject.getJSONObject(“dp”); JSONArray curtainArray = dp.getJSONArray(“curtain_state”); int position = curtainArray.getJSONObject(0).getInt(“v”); runOnUiThread(() -> { progressBar.setProgress(position); textViewStatus.setText(“当前位置：” + position + “%”); }); } catch (JSONException e) { e.printStackTrace(); } }

4.4 系统联调与测试

1. 硬件连接：按照原理图连接STM32、ESP8266、电机驱动、限位开关和电源。务必确认电压匹配，特别是ESP8266必须使用稳定的3.3V供电。
2. 烧录程序：将编译好的STM32固件通过ST-Link或USB转TTL烧录到单片机。
3. 串口调试：先不接WiFi模块，用USB转TTL连接ESP8266到电脑，使用串口助手发送AT指令测试模块是否正常。然后测试AT+CWJAP连接WiFi，AT+MQTTCONN连接OneNET。
4. 整体测试：将ESP8266接回STM32，上电。观察串口日志，确认设备成功连接WiFi和OneNET。
5. APP测试：在手机上运行APP，输入正确的产品ID、设备ID和API Key，点击连接。尝试发送“打开”、“关闭”、“停止”命令，观察窗帘电机是否动作，同时APP界面是否收到设备上报的最新位置状态。

5. 常见问题与排查思路

在开发过程中，你可能会遇到以下典型问题：

6. 最佳实践与工程建议

将项目原型转化为稳定可靠的产品，还需要考虑以下工程化细节：

1. 固件健壮性设计

   • 看门狗：启用STM32的独立看门狗(IWDG)和窗口看门狗(WWDG)，防止程序跑飞。
   • 异常重启：在网络连接失败、解析数据异常等关键错误后，进行延时并自动重试，超过一定次数后执行软件复位。
   • 参数存储：将WiFi的SSID/密码、设备ID等配置信息存储在STM32的Flash或EEPROM中，方便通过串口指令或按键进行配置，无需修改代码重新烧录。

2. 通信协议与数据格式优化

   • 心跳包：设备定时（如每60秒）向云平台发送一个简单的心跳包，用于维持长连接和检测设备在线状态。
   • 数据压缩：上报的JSON数据可以精简键名（如用"c":50代替"curtain_state":50），减少网络流量。
   • 命令确认机制：APP下发命令后，设备执行成功应回复一条确认消息。APP可设置超时重发，提高控制可靠性。

3. 电机控制与安全

   • 软启动/软停止：使用PWM逐渐增加/减少电机占空比，避免电流冲击，使窗帘启停更平缓。
   • 堵转检测：监测电机电流（可通过采样电阻和ADC），当电流持续过高时判断为堵转，立即停止电机并上报故障。
   • 位置记忆：如果使用步进电机，可以通过记录步进数来精确计算窗帘位置。即使断电，位置信息也应保存在非易失存储器中。

4. APP用户体验

   • 本地缓存：APP应将设备最后上报的状态缓存到本地，每次启动时先显示缓存数据，再尝试连接云平台获取实时数据，避免启动时白屏。
   • 离线队列：在网络不佳时，用户的操作命令可先存入本地队列，待网络恢复后自动发送。
   • 多设备管理：APP应支持添加和管理多个窗帘设备，并可能支持场景联动（如“离家模式”自动关闭所有窗帘）。

5. 生产环境部署考虑

   • OTA升级：预留通过WiFi进行固件在线升级(OTA)的接口，便于后期修复漏洞和增加功能。
   • 日志上报：设备可将运行日志（错误码、网络状态）加密后上报到云平台，便于远程诊断问题。
   • 安全加固：使用TLS加密MQTT连接（OneNET支持），防止通信被窃听。鉴权信息避免硬编码，采用安全芯片或加密存储。

通过以上步骤，你不仅完成了一个可运行的智能窗帘项目，更掌握了物联网系统从硬件到云到应用的全栈开发思维。接下来，你可以在此基础上扩展更多功能，如语音助手接入（通过云平台规则引擎转发到设备）、光照传感器自动控制、定时任务、多用户权限分享等，将其打磨成一个真正实用的智能家居产品。