STM32物联网实战：ESP8266通过OneNET MQTT协议实现微信小程序远程控制完整代码解析

1. 项目概述与硬件准备

大家好，今天我来分享一个超实用的STM32物联网项目实战经验。这个项目实现了通过ESP8266 WiFi模块，借助OneNET平台的MQTT协议，最终用微信小程序远程控制STM32设备的完整方案。我自己在实际项目中多次使用这种架构，稳定性相当不错，特别适合智能家居、工业监控这类需要远程控制的场景。

先来看看需要准备哪些硬件设备：

• 一块STM32开发板（我用的STM32F103C8T6，性价比高）
• ESP8266 WiFi模块（推荐ESP-01S，便宜又好用）
• 一些基础外设（LED、温湿度传感器等用于演示控制效果）
• USB转TTL模块（用于调试ESP8266）

硬件连接非常简单：STM32的USART2的TX接ESP8266的RX，RX接TX，记得共地。供电方面，ESP8266工作时峰值电流可能达到200mA，最好单独供电或者确保你的STM32板子能提供足够电流。

我第一次做这个项目时，在供电上栽过跟头。当时直接用STM32的3.3V给ESP8266供电，结果WiFi连接时总是重启，后来外接了一个3.3V电源就稳定了。所以如果你也遇到不稳定的情况，首先检查供电是否充足。

2. OneNET平台配置详解

OneNET是中国移动推出的物联网平台，对国内用户来说访问速度快、稳定性好。下面我一步步教你如何配置：

首先注册账号并登录OneNET控制台，进入"产品开发"页面创建一个新产品。产品类型选择"设备接入"，协议选择"MQTT旧版"。这里有个小技巧：在创建产品时最好提前规划好数据模板，后面代码中需要严格匹配。

创建完产品后，需要添加设备。关键是要记录下几个参数：产品ID、设备名称和设备密钥。这些参数在代码中需要准确配置，否则无法连接。我在代码中是这么定义的：

#define ONENET_MQTT_PRODUCT_ID "7M6S32xnSS"
#define ONENET_MQTT_DEVICE_NAME "20010712"
#define ONENET_MQTT_TOKEN "version=2018-10-31&res=products%2F7M6S32xnSS%2Fdevices%2F20010712&et=2066868610&method=md5&sign=LJFN5pnrXIN6xgTT85NwHg%3D%3D"

设备创建成功后，建议在平台上测试一下通信是否正常。OneNET提供了在线调试工具，可以模拟设备上报数据和下发命令，这对后续调试很有帮助。

3. ESP8266的AT指令配置

ESP8266模块需要正确配置才能连接MQTT服务器。我总结了一个稳定的初始化序列：

uint8_t WiFi_Init(void) {
    uint8_t wifi_retry = 0;
    MQTT_Status.error_code = 0;
    
    if (MQTT_Send_Command("AT+RST\r\n", "", 3, 1, 1000) != 1)
        MQTT_Status.error_code |= (1 << 0);
    
    if (MQTT_Send_Command("ATE0\r\n", "OK", 3, 1, 500) != 1)
        MQTT_Status.error_code |= (1 << 1);
    
    if (MQTT_Send_Command("AT+CWMODE=1\r\n", "OK", 3, 1, 50) != 1)
        MQTT_Status.error_code |= (1 << 2);
    
    if (MQTT_Send_Command("AT+CWDHCP=1,1\r\n", "OK", 3, 1, 50) != 1)
        MQTT_Status.error_code |= (1 << 3);

    // WiFi连接重试
    while (wifi_retry++ < 5) {
        if (MQTT_Send_Command(WIRELESS_WIFI_INFO, "GOT IP", 1, 1, 10000))
            break;
        delay_ms(2000);
    }
    
    if (wifi_retry >= 5) {
        MQTT_Status.error_code |= (1 << 4);
        return 0;
    }
    return 1;
}

这里有几个需要注意的地方：AT+RST后要给模块足够的重启时间（我一般留1秒）；ATE0关闭回显可以减少数据干扰；WiFi连接重试机制很重要，因为偶尔一次连接失败很正常。

在实际项目中，我发现ESP8266对电源波动很敏感。如果遇到频繁断开重连，除了检查供电，还可以尝试在AT+CWJAP指令前添加AT+CIPRECVMODE=1指令，设置为透传模式可以提高稳定性。

4. MQTT协议连接与配置

MQTT配置是整个项目的核心环节，主要包括用户配置、服务器连接和主题订阅三个步骤：

uint8_t MQTT_Config(void) {
    MQTT_Status.error_code = 0;
    
    if (MQTT_Send_Command(ONENET_MQTT_USERCFG_INFO, "OK", 3, 1, 50) != 1)
        MQTT_Status.error_code |= (1 << 5);
    
    if (MQTT_Send_Command(ONENET_MQTT_SERVER_INFO, "+MQTTCONNECTED", 3, 1, 10000) != 1)
        MQTT_Status.error_code |= (1 << 6);
    
    if (MQTT_Send_Command(ONENET_MQTT_REPLY_TOPIC, "OK", 3, 1, 500) != 1)
        MQTT_Status.error_code |= (1 << 7);
    
    delay_ms(3000);

#if ONENET_MQTT_SET_ENABLE
    if (MQTT_Send_Command(ONENET_MQTT_SET_TOPIC, "OK", 3, 1, 10000) != 1)
        MQTT_Status.error_code |= (1 << 8);
#endif

    return (MQTT_Status.error_code == 0) ? 1 : 0;
}

连接OneNET的MQTT服务器时，需要注意几个细节：一是服务器地址是"mqtts.heclouds.com"，端口1883；二是需要开启SSL加密（AT+MQTTCONN最后一个参数为1）；三是连接超时时间要设置足够长（我这里用了10秒），因为网络状况不好时握手过程可能较慢。

主题订阅方面，需要订阅两个主题：属性设置主题用于接收小程序下发的控制命令，属性上报回复主题用于接收平台对上报数据的应答。主题名称有固定格式：$sys/{产品ID}/{设备名称}/thing/property/set和$sys/{产品ID}/{设备名称}/thing/property/post/reply。

5. 数据上报机制实现

数据上报是物联网设备最基本的功能，这里需要将设备数据封装成特定的JSON格式：

void MQTT_Publish_Data(void) {
    char globalBuffer[512] = {0};
    char atCommand[256] = {0};
    uint16_t bufferPos = 0;

    // 组装JSON消息
    bufferPos += snprintf(globalBuffer, sizeof(globalBuffer), "{\"id\":\"123\",\"params\":{");
    for (uint8_t i = 0; i < DATA_ARRAY_SIZE; i++) {
        switch (onenet_data_array[i]->type) {
            case TYPE_BOOL:
                bufferPos += snprintf(globalBuffer + bufferPos, sizeof(globalBuffer) - bufferPos, 
                    "\"%s\":{\"value\":%s}%s", 
                    onenet_data_array[i]->name, 
                    onenet_data_array[i]->value.bool_value ? "true" : "false",
                    (i < DATA_ARRAY_SIZE - 1) ? "," : "");
                break;
            case TYPE_INT:
                bufferPos += snprintf(globalBuffer + bufferPos, sizeof(globalBuffer) - bufferPos,
                    "\"%s\":{\"value\":%d}%s",
                    onenet_data_array[i]->name,
                    onenet_data_array[i]->value.int_value,
                    (i < DATA_ARRAY_SIZE - 1) ? "," : "");
                break;
            case TYPE_FLOAT:
                bufferPos += snprintf(globalBuffer + bufferPos, sizeof(globalBuffer) - bufferPos,
                    "\"%s\":{\"value\":%.1f}%s",
                    onenet_data_array[i]->name,
                    onenet_data_array[i]->value.float_value,
                    (i < DATA_ARRAY_SIZE - 1) ? "," : "");
                break;
        }
    }
    bufferPos += snprintf(globalBuffer + bufferPos, sizeof(globalBuffer) - bufferPos, "}}");

    // 发送AT指令
    snprintf(atCommand, sizeof(atCommand), "%s,%d,0,0\r\n", ONENET_MQTT_PUBTOPIC, bufferPos);
    if (MQTT_Send_Command(atCommand, "OK", 1, 1, 100) != 1) {
        printf("发布指令发送失败\r\n");
        return;
    }

    // 发送JSON数据
    Usart2_SendString(globalBuffer);
    printf("已发送消息内容: %s\r\n", globalBuffer);
}

在实际应用中，我建议给每个上报消息设置一个唯一的ID，这样可以在平台回复时对应起来。数据格式一定要严格按照OneNET的要求，特别是数据类型要匹配。比如布尔值必须是true/false，不能是1/0。

上报频率也需要根据实际场景调整。对于温湿度这类变化慢的数据，30秒上报一次就足够了；对于开关状态这类实时性要求高的，应该在状态变化时立即上报。

6. 命令接收与处理逻辑

命令接收是远程控制的关键，需要处理小程序下发的控制指令：

void MQTT_Processing_Command(void) {
    char *jsonData = NULL;
    
    // 定位JSON数据起始位置
    jsonData = strstr((char*)MQTT_RxBuffer, ONENET_MQTT_REVEIVE_SET_TOPIC);
    if (jsonData)
        jsonData = strchr(jsonData, '{');
    else
        jsonData = strchr((char*)MQTT_RxBuffer, '{');
    
    if (!jsonData) return;

    // 提取命令ID
    uint32_t cmd_id = MQTT_Get_Command_Id(jsonData);
    
    // 提取控制参数
    MQTT_Receiver_Command_Extract(jsonData);
    
    // 发送响应
    MQTT_Receive_Command_Respond(cmd_id, 200, "success");
}

数据处理函数需要从JSON中提取具体控制参数：

void MQTT_Receiver_Command_Extract(char *jsonData) {
    cJSON *json_obj = cJSON_Parse(jsonData);
    if (!json_obj) return;

    cJSON *params = cJSON_GetObjectItem(json_obj, "params");
    if (!params) {
        cJSON_Delete(json_obj);
        return;
    }

    // 处理窗帘控制
    cJSON *item = cJSON_GetObjectItem(params, ChuangLian_Control.name);
    if (item && cJSON_IsBool(item))
        ChuangLian_Control.value.bool_value = item->valueint;

    // 处理加湿器控制
    item = cJSON_GetObjectItem(params, JiaShiQi_Control.name);
    if (item && cJSON_IsBool(item))
        JiaShiQi_Control.value.bool_value = item->valueint;

    // 处理吊灯控制
    item = cJSON_GetObjectItem(params, DiaoDeng_Control.name);
    if (item && cJSON_IsNumber(item))
        DiaoDeng_Control.value.int_value = item->valueint;

    cJSON_Delete(json_obj);
}

在实际应用中，命令处理需要充分考虑异常情况。我建议添加超时重发机制和命令状态反馈。比如当收到控制命令后，除了立即回复平台，还应该将执行结果再次上报，这样小程序端就能知道设备实际状态。

7. 微信小程序开发要点

微信小程序作为控制端，主要功能是发送控制指令和显示设备状态。开发时需要注意几个关键点：

首先是MQTT连接，小程序可以使用WebSocket方式连接OneNET平台。需要在app.json中配置网络权限：

{
  "permission": {
    "scope.userLocation": {
      "desc": "你的位置信息将用于小程序位置接口的效果展示"
    }
  },
  "requiredBackgroundModes": ["audio", "location"],
  "networkTimeout": {
    "request": 10000,
    "connectSocket": 10000,
    "uploadFile": 10000,
    "downloadFile": 10000
  }
}

控制界面设计要简洁明了，建议使用按钮组控制设备开关，滑块控制亮度等连续值。每次操作后要及时更新UI状态，并显示操作结果。

数据接收方面，小程序需要订阅设备状态主题，实时显示设备上报的数据。建议使用定时器每隔几秒获取一次设备状态，保持数据显示的实时性。

8. 异常处理与稳定性优化

在实际部署中，网络异常和设备重启是常见问题。我总结了几种提高稳定性的方法：

AT指令重试机制：所有AT指令都应该有重试逻辑，我一般设置3次重试：

uint8_t MQTT_Send_Command(char *cmd, char *res, uint8_t MaxSendCount, uint8_t Clear_Buffer, uint16_t timeout_ms) {
    uint32_t start_time;
    bool received;
    uint8_t temp_buffer[RX_BUFFER_SIZE] = {0};
    uint16_t temp_len = 0;
    
    printf("\n发送指令: %s", cmd);
    printf("期望返回: %s\n", res);
    
    while (MaxSendCount--) {
        // ... 发送和检测逻辑
        if (MaxSendCount > 0) {
            printf("剩余重试次数: %d\n", MaxSendCount);
            delay_ms(500);
        }
    }
    printf("所有重试均失败！\n");
    return 0;
}

心跳保持机制：ESP8266需要定期发送心跳包保持连接。我一般每60秒发送一次AT指令检查连接状态，如果断开就立即重连。

数据缓存机制：在网络异常时，重要数据应该先缓存起来，等网络恢复后再上报。我通常使用环形缓冲区存储待上报数据。

电源管理：对于电池供电的设备，需要优化功耗。可以在无操作时让ESP8266进入睡眠模式，有控制命令时再唤醒。

9. 实际应用中的调试技巧

调试物联网项目需要耐心和一些技巧。我常用的调试方法包括：

串口日志分级：将日志分为ERROR、WARN、INFO、DEBUG等级别，通过宏定义控制输出级别，方便定位问题。

#define LOG_LEVEL_DEBUG 0
#define LOG_LEVEL_INFO 1
#define LOG_LEVEL_WARN 2
#define LOG_LEVEL_ERROR 3

#ifndef CURRENT_LOG_LEVEL
#define CURRENT_LOG_LEVEL LOG_LEVEL_DEBUG
#endif

#define LOG_DEBUG(fmt, ...) \
    if (CURRENT_LOG_LEVEL <= LOG_LEVEL_DEBUG) \
        printf("[DEBUG] " fmt, ##__VA_ARGS__)

AT指令日志记录：记录所有发送和接收的AT指令，最好同时记录十六进制和ASCII格式，这样能发现隐藏的字符编码问题。

网络状态监控：定期检查WiFi信号强度和MQTT连接状态，当信号弱时提前预警。

离线测试：先使用串口调试工具模拟ESP8266的响应，确保STM32端的逻辑正确，再实际连接模块测试。

我在项目中遇到最棘手的问题是JSON格式错误，因为OneNET平台对JSON格式要求很严格，多一个空格少一个逗号都会导致解析失败。后来我写了一个JSON格式校验函数，在发送前先检查格式，大大提高了成功率。

10. 性能优化与扩展建议

这个基础框架还可以进一步优化和扩展：

数据压缩：对于频繁上报的数据，可以使用简单的压缩算法减少数据量。比如将多个数据点打包成一条消息上报。

OTA升级：通过OneNET平台实现固件远程升级，这对于部署后的设备维护很重要。

多协议支持：除了MQTT，还可以支持HTTP、CoAP等协议，根据网络条件自动选择最优协议。

本地联动：设备之间可以通过蓝牙或LoRa直接通信，不依赖云平台实现本地联动控制。

安全增强：添加数据加密和设备认证机制，防止未授权访问。

我在实际项目中还添加了设备分组管理功能，可以同时控制多个设备。小程序端也做了场景模式，比如"回家模式"可以一次性打开多个设备。

这个项目最让我满意的是稳定性。经过多次优化后，设备可以连续运行几个月不掉线。即使网络中断，恢复后也能自动重连并补发缓存的数据。