STM32与ThingsCloud物联网平台MQTT通信实战

1. 项目概述

作为一名嵌入式开发工程师，最近在做一个基于STM32的智慧物联网项目，需要将设备连接到ThingsCloud物联网平台。这个项目让我对物联网设备与云平台的交互有了更深入的理解，特别是MQTT协议在实际应用中的实现方式。

ThingsCloud是一个功能强大的物联网云平台，支持多种通信协议和设备管理功能。通过这个项目，我成功实现了STM32设备通过Wi-Fi模块（安信可AI-WB2-12F）连接到ThingsCloud平台，并完成了数据上报和命令下发的完整流程。

2. 硬件选型与准备

2.1 核心硬件组件

在这个项目中，我选择了以下硬件组件：

1. 主控芯片：STM32F103C8T6

   • 72MHz Cortex-M3内核
   • 64KB Flash，20KB RAM
   • 丰富的外设接口（USART、SPI、I2C等）

2. Wi-Fi模块：安信可AI-WB2-12F

   • 基于BL602芯片
   • 支持802.11b/g/n协议
   • 内置BLE 5.0
   • 支持AT指令控制

3. 其他外设：

   • OLED显示屏（用于显示状态信息）
   • LED指示灯
   • 按键输入

2.2 硬件连接

硬件连接相对简单，主要是将Wi-Fi模块通过串口与STM32连接：

code复制STM32 USART3_TX -> AI-WB2-12F RX
STM32 USART3_RX -> AI-WB2-12F TX
STM32 GND -> AI-WB2-12F GND
STM32 3.3V -> AI-WB2-12F VCC

注意：确保Wi-Fi模块的供电稳定，不稳定的电源可能导致模块工作异常。

3. ThingsCloud平台配置

3.1 平台账号注册与项目创建

首先需要在ThingsCloud平台注册账号并创建项目：

1. 访问ThingsCloud官网注册账号
2. 登录后进入控制台
3. 点击"创建项目"，填写项目名称和描述
4. 选择适合的项目模板（本项目选择"通用物联网设备"）

3.2 设备类型与设备创建

在项目中需要先创建设备类型，然后添加具体设备：

1. 进入"设备管理"->"设备类型"
2. 点击"新建设备类型"，填写类型名称和描述
3. 为设备类型添加功能点（如温度、湿度等传感器数据）
4. 进入"设备管理"->"设备列表"
5. 点击"添加设备"，选择刚创建的设备类型
6. 记录下设备的Access Token（用于MQTT连接认证）

3.3 应用配置

为了方便查看设备数据和控制设备，可以创建一个用户应用：

1. 进入"应用管理"->"用户应用"
2. 点击"新建应用"，选择模板
3. 配置应用UI，添加设备控制面板和数据展示图表
4. 发布应用，生成访问链接

4. 软件设计与实现

4.1 开发环境搭建

本项目使用Keil MDK作为开发环境：

1. 安装Keil MDK-ARM
2. 安装STM32F1系列设备支持包
3. 创建新工程，选择STM32F103C8T6作为目标设备
4. 配置工程选项，设置正确的晶振频率和调试接口

4.2 Wi-Fi模块驱动开发

4.2.1 AT指令封装

为了方便控制Wi-Fi模块，我封装了一系列AT指令发送函数：

c复制// WIFI发送命令，检查命令返状态信息
static u8 ESP8266_SendCmd(const char *cmd, const char *stat)
{
    u8 i = 0;
    u16 j = 0;
    for (i = 0; i < 3; i++) {
        usart3_cnt = 0;
        usart3_flag = 0;
        USARTx_SendStr(USART3, (u8 *)cmd); // 发送命令
        
        for (j = 0; j < 5000; j++) {
            if (usart3_flag) {
                usart3_buffer[usart3_cnt] = '\0';
                if (strstr((char *)usart3_buffer, stat)) {
                    usart3_cnt = 0;
                    usart3_flag = 0;
                    return 0; // 发送成功
                } else {
                    usart3_cnt = 0;
                    usart3_flag = 0;
                }
            }
            Delay_Ms(1);
        }
        Delay_Ms(100);
    }
    return 1; // 命令发送失败
}

这个函数实现了命令的自动重发机制，提高了通信的可靠性。

4.2.2 Wi-Fi连接实现

STA模式初始化函数实现了Wi-Fi连接的完整流程：

c复制u8 ESP8266_STA_Init(const char *wifi_name, const char *wifi_key)
{
    // 1. 退出透传模式
    int i = 0;
    for (i = 0; i < 3; i++) {
        if (ESP8266_SendCmd("AT\r\n", "OK\r\n") == 0) {
            i = 0;
            break;
        }
        printf("第%d次退出透传\r\n", i + 1);
        USARTx_SendStr(USART3, (u8 *)"+++\r\n"); // 退出透传模式
        Delay_Ms(500);
    }
    if (i >= 3) return 1; // 退出透传失败
    
    char buffer[100];
    printf("2. 关回显ATE0\r\n");
    if (ESP8266_SendCmd("ATE0\r\n", "OK")) return 2;
    
    printf("3. 查询WIFI自动连接:\r\n");
    if (ESP8266_SendCmd("AT+WAUTOCONN?\r\n", "+WAUTOCONN") == 0) {
        printf("rx3=%s\n", usart3_buffer);
        if (strstr((char *)usart3_buffer, "+WAUTOCONN:0")) {
            printf("3.1 设置WIFI自动重连:\r\n");
            snprintf(buffer, sizeof(buffer), "AT+WAUTOCONN=1,%s,%s\r\n", wifi_name, wifi_key);
            if (ESP8266_SendCmd(buffer, "OK\r\n")) return 3;
            printf("3.2 重启WIFI模块\r\n");
            if (ESP8266_SendCmd("AT+RST\r\n", "ready")) return 4;
        }
    }
    
    printf("等待WIFI连接成功\r\n");
    if (ESP8266_WaitConnect()) {
        printf("4. 查询连接WIFI信息:\r\n");
        u8 ret = ESP8266_CheckStaInfo();
        if (ret == 0 || ret == 4) { // wifi信息错误
            printf("ret=%d\n", ret);
            printf("4.1 关闭WIFI自动重连:\r\n");
            if (ESP8266_SendCmd("AT+WAUTOCONN=0\r\n", "OK\r\n")) return 3;
            printf("3.2 重启WIFI模块\r\n");
            if (ESP8266_SendCmd("AT+RST\r\n", "ready")) return 4;
            
            // 设置WIFI模式为STA并保存到flash
            printf("4.1 设置WIFI为STA模式\r\n");
            if (ESP8266_SendCmd("AT+WMODE=1,1\r\n", "OK\r\n")) return 5;
            
            // 设置WIFI连接
            printf("4.2 设置WIFI连信息\r\n");
            snprintf(buffer, sizeof(buffer), "AT+WJAP=%s,%s\r\n", wifi_name, wifi_key);
            printf("buffer=%s", buffer);
            if (ESP8266_SendCmd(buffer, "WIFI_GOT_IP")) {
                printf("err=%s\n", usart3_buffer);
                return 6;
            }
        }
    }
    return 0;
}

4.3 MQTT协议实现

4.3.1 MQTT连接配置

c复制u8 MQTT_Config(const char *ip, u16 port, const char *client_id, const char *user_name, const char *password)
{
    char buffer[200];
    // 断开连接
    ESP8266_SendCmd("AT+MQTTDISCONN\r\n", "OK\r\n");
    
    // 1. 设置域名
    snprintf(buffer, sizeof(buffer), "AT+MQTT=1,%s\r\n", ip);
    if (ESP8266_SendCmd(buffer, "OK\r\n")) return 2;
    
    // 2. 设置端口号
    snprintf(buffer, sizeof(buffer), "AT+MQTT=2,%d\r\n", port);
    if (ESP8266_SendCmd(buffer, "OK\r\n")) return 3;
    
    // 3. 设置连接方式1为TCP、2为SSL
    if (ESP8266_SendCmd("AT+MQTT=3,1\r\n", "OK\r\n")) return 4;
    
    // 4. 设置用户ID
    snprintf(buffer, sizeof(buffer), "AT+MQTT=4,%s\r\n", client_id);
    printf("设置客户端id:%s,len=%d\n", buffer, strlen(buffer));
    if (ESP8266_SendCmd(buffer, "OK\r\n")) return 5;
    
    // 5. 设置用户名
    snprintf(buffer, sizeof(buffer), "AT+MQTT=5,%s\r\n", user_name);
    if (ESP8266_SendCmd(buffer, "OK\r\n")) return 6;
    
    // 6. 设置密码
    snprintf(buffer, sizeof(buffer), "AT+MQTT=6,%s\r\n", password);
    if (ESP8266_SendCmd(buffer, "OK\r\n")) return 7;
    
    // 7. MQTT接入
    snprintf(buffer, sizeof(buffer), "AT+MQTT\r\n");
    if (ESP8266_SendCmd(buffer, "MQTT_CONNECT")) {
        printf("rx3=%s\n", usart3_buffer);
        return 8;
    }
    return 0;
}

4.3.2 消息订阅与发布

c复制// 消息订阅
u8 MQTT_SubTopic(const char *topic, int qos, int flag)
{
    char buffer[200];
    if (flag)
        snprintf(buffer, sizeof(buffer), "AT+MQTTSUB=%s,%d\r\n", topic, qos);
    else // 取消订阅
        snprintf(buffer, sizeof(buffer), "AT+MQTTUNSUB=%s\r\n", topic);
    
    if (ESP8266_SendCmd(buffer, "OK")) return 1;
    return 0;
}

// 消息发布
u8 MQTT_PublishMesg(const char *topic, int qos, const char *msg)
{
    char buffer[512];
    int len = strlen(msg);
    
    snprintf(buffer, sizeof(buffer), "AT+MQTTPUBRAW=%s,%d,0,%d\r\n", topic, qos, len);
    if (ESP8266_SendCmd(buffer, ">")) return 1;
    
    if (ESP8266_SendCmd(msg, "OK")) return 2;
    return 0;
}

4.4 主程序流程

主程序实现了完整的设备工作流程：

c复制int main()
{
    // 硬件初始化
    LED_Init();
    Key_Init();
    USARTx_Init(USART1, 115200);
    USARTx_Init(USART2, 115200);
    USARTx_Init(USART3, 115200);
    OLED_Init();
    RTC_Init();
    
    // Wi-Fi连接
    u8 ret = 1;
    while (ret) {
        ret = ESP8266_STA_Init(WIFI_NAME, PASSWORD);
        printf("ret=%d\n", ret);
        if (ret == 0) break;
        USARTx_SendStr(USART3, "AT+RST\r\n");
        Delay_Ms(2000);
    }
    
    // 网络校时
    USARTx_SendStr(USART3, (u8 *)"AT+HTTPCLIENTLINE=2,2,,sapi.k780.com,,,?app=life.time&appkey=25273&sign=eae95a712a66e7a97dfd39534e24ffb1&format=json\r\n");
    
    // MQTT连接
    ret = 1;
    while (ret) {
        ret = MQTT_Config(SERVER_IP, SERVER_PORT, ClientID, Username, Password);
        printf("连接:ret=%d\n", ret);
        if (ret == 0) break;
        Delay_Ms(3000);
    }
    
    // 消息订阅
    ret = MQTT_SubTopic(SET_TOPIC, 0, 1);
    printf("消息订阅ret=%d\n", ret);
    
    // 主循环
    u32 time = 0;
    u32 time2 = 5000;
    char mqtt_message[256];
    float temp = 26;
    int light = 300;
    
    while (1) {
        time++;
        time2++;
        Delay_Ms(1);
        
        // 定时上报数据
        if (time2 >= 5000) {
            time2 = 0;
            temp += 1.5;
            light += 5;
            sprintf(mqtt_message, "{\"temperature\":%.1f,\"luminosity\":%d}", temp, light);
            ret = MQTT_PublishMesg(POST_TOPIC, 0, mqtt_message);
            printf("消息发布ret=%d\n", ret);
        }
        
        // 处理接收到的消息
        if (usart3_flag) {
            usart3_buffer[usart3_cnt] = '\0';
            printf("rx3=%s\n", usart3_buffer);
            
            if (strstr((char *)usart3_buffer, "\"state\":true")) {
                LED1 = 0;
                printf("开灯\n");
            } else if (strstr((char *)usart3_buffer, "\"state\":false")) {
                LED1 = 1;
                printf("关灯\n");
            }
            
            usart3_cnt = 0;
            usart3_flag = 0;
        }
        
        // 串口调试
        if (usart1_flag) {
            usart1_buffer[usart1_cnt] = '\0';
            printf("rx1=%s", usart1_buffer);
            USARTx_SendStr(USART3, usart1_buffer);
            usart1_cnt = 0;
            usart1_flag = 0;
        }
    }
}

5. 项目调试与优化

5.1 常见问题与解决方案

在项目开发过程中，我遇到了以下几个典型问题：

1. Wi-Fi连接不稳定

   • 现象：设备偶尔会断开Wi-Fi连接
   • 解决方案：
     • 增加自动重连机制
     • 优化电源设计，确保供电稳定
     • 调整Wi-Fi模块天线位置

2. MQTT连接失败

   • 现象：有时无法连接到MQTT服务器
   • 解决方案：
     • 检查服务器地址和端口是否正确
     • 验证用户名和密码
     • 增加连接重试机制

3. 数据上报延迟

   • 现象：数据上报不及时
   • 解决方案：
     • 优化网络通信流程
     • 减少不必要的数据处理
     • 调整数据上报频率

5.2 性能优化建议

1. 内存优化

   • 使用内存池管理动态内存
   • 减少不必要的全局变量
   • 优化字符串处理函数

2. 功耗优化

   • 在不工作时进入低功耗模式
   • 优化数据上报频率
   • 关闭不必要的外设

3. 代码结构优化

   • 使用状态机设计模式
   • 模块化代码结构
   • 增加错误处理机制

6. 项目成果与扩展

6.1 实现功能

通过这个项目，我成功实现了以下功能：

1. STM32通过Wi-Fi连接到本地网络
2. 设备自动同步网络时间
3. 通过MQTT协议连接到ThingsCloud平台
4. 定时上报传感器数据（模拟）
5. 接收平台下发的控制命令

6.2 扩展应用

基于这个基础框架，可以进一步扩展以下功能：

1. 真实传感器接入

   • 连接温湿度传感器
   • 添加光照强度传感器
   • 集成运动检测传感器

2. 设备联动

   • 实现多设备联动控制
   • 创建自动化场景
   • 设置条件触发规则

3. 数据存储与分析

   • 长期存储历史数据
   • 数据分析与可视化
   • 异常检测与预警

7. 开发心得

在实际开发过程中，我总结了以下几点经验：

1. AT指令调试：Wi-Fi模块的AT指令调试需要耐心，建议先使用串口调试工具单独测试模块，确保基本功能正常后再集成到主程序中。

2. 错误处理：网络通信中各种异常情况很常见，完善的错误处理机制非常重要。我在代码中加入了多次重试和状态检查，大大提高了系统的稳定性。

3. 日志记录：良好的日志记录对于调试非常有帮助。我在项目中实现了多级日志输出，可以根据需要调整日志详细程度。

4. 协议理解：深入理解MQTT协议的特性对于物联网开发至关重要。我花了不少时间研究MQTT的QoS级别、保留消息等特性，这对优化系统性能很有帮助。

这个项目让我对物联网设备开发有了更深入的理解，特别是在设备与云平台交互方面积累了不少实战经验。希望我的分享对其他开发者有所帮助，也欢迎交流讨论。