1. 项目概述与核心功能解析
这个基于STM32F103C8T6单片机的物联网项目，实现了设备与OneNET云平台的双向通信功能。核心功能分为两个方向的数据流：
- 数据上报链路：通过DHT11温湿度传感器采集环境数据，经4G模块（MN316）以MQTT协议上传至OneNET云平台
- 指令下发链路：云平台可发送控制指令，通过4G模块接收后控制开发板上的LED状态
这种双向通信架构是物联网设备的典型应用场景，特别适合远程监测与控制类项目。STM32F103C8T6作为经典的Cortex-M3内核MCU，配合HAL库开发能显著提高开发效率。
提示：选择STM32F103C8T6主要考虑其性价比和丰富的外设资源，72MHz主频完全能满足传感器数据采集和通信需求，且HAL库的硬件抽象层设计让移植更便捷。
2. 硬件系统搭建与关键组件选型
2.1 核心硬件组件清单
| 组件 | 型号 | 主要参数 | 选型理由 |
|---|---|---|---|
| 主控MCU | STM32F103C8T6 | 72MHz Cortex-M3, 64KB Flash, 20KB RAM | 性价比高，生态完善 |
| 4G通信模块 | MN316 | 支持LTE Cat.1, 内置TCP/IP协议栈 | 低功耗，支持MQTT |
| 温湿度传感器 | DHT11 | 湿度±5%RH, 温度±2℃ | 成本低，数字接口 |
| 开发板 | 最小系统板 | 含LED、按键等基础外设 | 便于快速验证 |
2.2 硬件连接示意图
code复制STM32F103C8T6 <--> MN316 4G模块
│
├─ PA0 -> DHT11 DATA
├─ PC13 -> LED
└─ USART1 <-> MN316 UART
关键接线说明：
- 4G模块通过UART与STM32通信（建议使用USART1）
- DHT11建议连接至具有外部中断功能的GPIO（如PA0）
- LED控制引脚可根据实际开发板调整
注意：MN316模块需要单独供电（典型3.7V锂电池），与STM32的串口连接需确保电平匹配（通常需要电平转换电路）。
3. 软件架构设计与关键实现
3.1 程序主流程设计
c复制void main() {
HAL_Init();
SystemClock_Config();
MX_GPIO_Init();
MX_USART1_UART_Init();
MX_DHT11_Init();
MQTT_Init(); // 初始化MQTT连接
OneNET_Register(); // 注册设备
while (1) {
DHT11_ReadData(); // 读取传感器
MQTT_Publish("/temp", temp); // 发布温度
MQTT_Publish("/humi", humi); // 发布湿度
MQTT_Process(); // 处理下行消息
HAL_Delay(5000); // 5秒间隔
}
}
3.2 MQTT通信关键实现
3.2.1 连接OneNET的MQTT参数
c复制#define MQTT_HOST "mqtt.heclouds.com"
#define MQTT_PORT 1883
#define DEVICE_ID "your_device_id"
#define PRODUCT_ID "your_product_id"
#define ACCESS_KEY "your_access_key"
连接过程需要三步握手：
- 建立TCP连接
- 发送CONNECT报文（含鉴权信息）
- 订阅控制TOPIC（如
$sys/{pid}/{did}/cmd）
3.2.2 数据上报报文示例
json复制{
"id": 123,
"dp": {
"temperature": [{"v": 25.5}],
"humidity": [{"v": 60}]
}
}
3.3 云平台控制指令处理
当收到云平台下发的LED控制指令时（如{"LED":1}），解析处理流程：
c复制void MQTT_Callback(char* topic, char* payload) {
if(strstr(topic, "cmd")) {
cJSON* root = cJSON_Parse(payload);
int led_state = cJSON_GetObjectItem(root, "LED")->valueint;
HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, led_state ? GPIO_PIN_SET : GPIO_PIN_RESET);
cJSON_Delete(root);
}
}
4. 开发环境配置与调试技巧
4.1 开发工具链搭建
-
IDE选择：
- STM32CubeIDE（推荐）：集成HAL库和调试工具
- Keil MDK：传统嵌入式开发环境
-
关键库依赖：
- STM32 HAL库（通过CubeMX生成）
- DHT11驱动（需自行实现）
- MQTT客户端库（如Eclipse Paho的嵌入式版本）
-
调试工具：
- J-Link/ST-Link用于程序下载调试
- 串口助手监控4G模块AT指令交互
- OneNET平台的数据流查看器
4.2 典型问题排查指南
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 4G模块不响应 | 供电不足/波特率错误 | 检查3.7V电源稳定性，确认UART波特率（通常115200） |
| MQTT连接失败 | 鉴权信息错误 | 检查设备三元组（PRODUCT_ID/DEVICE_ID/ACCESS_KEY） |
| 数据上报失败 | TOPIC格式错误 | OneNET要求特定格式：$sys/{pid}/{did}/dp/post/json |
| 控制指令不生效 | 订阅TOPIC不匹配 | 需订阅$sys/{pid}/{did}/cmd/request/# |
实操技巧：建议先用串口助手手动发送AT指令测试4G模块，确认基站注册和网络连接正常后再集成MQTT功能。
5. 性能优化与扩展建议
5.1 低功耗设计策略
-
传感器采样优化：
- 将DHT11的连续读取改为触发式（如按键触发或定时唤醒）
- 在休眠期间关闭传感器电源
-
通信节电模式：
- 启用MN316的PSM模式（Power Saving Mode）
- 合并数据包（如将5次采样数据打包上报）
-
STM32电源管理：
- 使用STOP模式替代Delay空等待
- 降低主频至最低可用频率
5.2 功能扩展方向
-
多传感器融合：
- 增加光照传感器（BH1750）
- 添加空气质量检测（SGP30）
-
本地缓存机制：
- 在Flash中实现环形队列存储历史数据
- 网络恢复后补传离线数据
-
OTA升级支持：
- 通过OneNET下发固件更新包
- 实现Bootloader支持分段写入
c复制// 示例：Flash存储数据结构
typedef struct {
float temp;
float humi;
uint32_t timestamp;
} SensorRecord;
6. 生产部署注意事项
-
天线安装：
- 4G模块天线应远离金属壳体
- 保持天线极化方向与基站一致（通常垂直）
-
EMC设计：
- 电源输入端加π型滤波电路
- 敏感信号线走内层或包地处理
-
长期运行维护：
- 添加看门狗（独立看门狗+窗口看门狗）
- 实现运行日志记录和异常自恢复
实际部署中发现，MN316模块在高温环境下可能出现连接不稳定，建议：
- 模块下方预留散热孔
- 避免阳光直射安装位置
- 软件上实现断线自动重连机制
这个项目虽然基础，但涵盖了物联网设备开发的完整链路。我在实际部署中最大的体会是：稳定的网络连接比功能实现更重要，需要充分考虑各种异常场景的处理。下一步可以尝试加入本地规则引擎，在网络中断时也能基于预设规则执行简单控制。