当前位置：首页 > news >正文

从零构建：基于STM32与4G Cat.1模块的MQTT温湿度数据上云实践

news 2026/4/17 17:08:38

1. 项目背景与硬件选型

第一次接触物联网项目时，我被各种专业术语和复杂的协议搞得晕头转向。直到真正动手做了一个温湿度监测项目，才发现从硬件到云端的完整链路并没有想象中那么难。这次我们就用最常见的STM32开发板和4G Cat.1模块，带大家走通数据上云的完整流程。

为什么选择4G Cat.1模块？实测下来，相比传统的2G模块，它的网络覆盖和稳定性更好；相比Cat.4模块，功耗和成本又低不少，特别适合这种低频次、小数据量的物联网场景。我用的是移远EC200S，市面上类似的还有中移物联ML302，价格都在百元以内，性价比很高。

STM32的选择就更加灵活了，F103系列完全够用。我手头正好有块STM32F103C8T6最小系统板，内存64KB，Flash 128KB，跑MQTT客户端绰绰有余。温湿度传感器选了经典的DHT11，虽然精度一般（湿度±5%，温度±2℃），但胜在便宜好用，5块钱就能买到。

2. 硬件连接与初始化

拿到硬件后，先要搞定物理连接。这里有个坑要注意：4G模块的供电需求比较高，峰值电流可能达到2A，直接接开发板的3.3V输出肯定会出问题。我的解决方案是用一个AMS1117-3.3稳压芯片单独给模块供电，输入接5V电源，这样最稳。

具体接线如下：

EC200S的VCC接AMS1117输出
GND与STM32共地
TXD接STM32的PA3（USART2_RX）
RXD接PA2（USART2_TX）
DHT11的数据线接PA1

上电后模块的NET灯会开始闪烁，等变成常亮就说明注册到4G网络了。如果一直闪烁，可能是SIM卡没插好或者APN设置有问题。我用的是移动物联网卡，APN要设成"CMIOT"，不同运营商可能不一样。

初始化代码很简单：

void USART2_Init(void) { // 波特率115200,8位数据,无校验,1位停止位 huart2.Instance = USART2; huart2.Init.BaudRate = 115200; huart2.Init.WordLength = UART_WORDLENGTH_8B; huart2.Init.StopBits = UART_STOPBITS_1; huart2.Init.Parity = UART_PARITY_NONE; HAL_UART_Init(&huart2); }

3. MQTT协议栈实现

虽然EC200S自带MQTT AT指令集，但就像原始文章提到的，为了更好的可移植性，我们选择在MCU端实现MQTT协议。这里我用的是开源的Paho MQTT嵌入式客户端，经过裁剪后不到10KB，非常适合资源受限的MCU。

关键是要实现以下几个功能：

连接建立：发送CONNECT报文，包含ClientID、用户名和密码
心跳维持：定时发送PINGREQ
主题订阅：SUBSCRIBE报文
消息发布：PUBLISH报文

OneNET的鉴权比较特殊，用户名是产品ID，密码要用Token算法生成。我封装了一个函数来处理：

void generate_onenet_token(char* buffer, const char* product_id, const char* device_name, const char* access_key) { // 计算过期时间（当前时间+1小时） uint32_t expiry = HAL_GetTick()/1000 + 3600; // 构造待签名字符串 char temp[256]; sprintf(temp, "products/%s/devices/%s", product_id, device_name); // HMAC-SHA1加密 uint8_t digest[20]; hmac_sha1((uint8_t*)temp, strlen(temp), (uint8_t*)access_key, strlen(access_key), digest); // Base64编码 base64_encode(digest, 20, buffer); }

4. OneNET平台配置

很多新手卡在平台配置这一步，其实按照流程走并不复杂。首先在OneNET官网注册账号，进入"多协议接入"选择MQTT，创建一个新产品。关键参数这样填：

协议类型：MQTT
联网方式：蜂窝
运营商：根据SIM卡选择
数据格式：JSON

创建完产品后添加设备，记下这三个关键信息：

产品ID：在产品详情页查看
设备名称：创建时自己定义
API Key：在设备详情页的"密钥管理"中

平台端的Topic有固定格式：

发布主题：$sys/{产品ID}/{设备名称}/dp/post/json
订阅主题：$sys/{产品ID}/{设备名称}/cmd/request/+

5. 数据上传与调试

一切就绪后，就可以上传温湿度数据了。我定义了一个简单的JSON格式：

{ "id": 123, "dp": { "temperature": [{"v": 25.5}], "humidity": [{"v": 60.2}] } }

对应的C代码实现：

void publish_sensor_data(float temp, float humi) { char payload[128]; sprintf(payload, "{\"id\":%d,\"dp\":{\"temperature\":[{\"v\":%.1f}],\"humidity\":[{\"v\":%.1f}]}}", device_id, temp, humi); mqtt_publish("$sys/123456/my_device/dp/post/json", payload, strlen(payload), QOS0); }

调试时最容易遇到三个问题：