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

新版OneNET的JSON数据流怎么玩？手把手教你用STM32解析与上传传感器数据

news 2026/6/13 16:06:39

新版OneNET JSON数据流实战：STM32+ESP8266全链路传感器数据上传指南

在物联网设备开发中，数据上传是连接物理世界与数字世界的桥梁。新版OneNET平台采用JSON格式的数据点（dp）协议，为开发者提供了更灵活的数据传输方式。本文将带您从零开始，实现STM32微控制器通过ESP8266 WiFi模块，将多类型传感器数据规范上传至OneNET平台的全过程。

1. 理解OneNET JSON数据流协议

OneNET的dp协议采用JSON格式封装数据点，其核心结构如下：

{ "id": 123, "dp": { "temperature": [{"v": 25.3}], "humidity": [{"v": 65}], "light": [{"v": 1023}] } }

id字段为消息序列号，可用于跟踪数据包
dp对象包含多个数据流，每个数据流对应一个传感器
v表示数据点的实际值，支持整数、浮点数等多种类型

常见错误处理：

数值类型错误（如将浮点数误传为字符串）
JSON格式不规范（缺少引号或括号）
数据流名称与平台定义不一致

提示：OneNET对JSON格式要求严格，建议在发送前使用在线JSON验证工具检查格式

2. STM32硬件环境搭建

2.1 所需硬件组件

组件	型号	备注
主控芯片	STM32F103C8T6	蓝核最小系统板
WiFi模块	ESP8266-01S	需刷入AT固件
温湿度传感器	DHT11	单总线接口
光照传感器	BH1750	I2C接口
开发环境	STM32CubeIDE	或Keil MDK

2.2 硬件连接示意图

STM32F103C8T6 <--> ESP8266 PA2 (USART2_TX) --> RX PA3 (USART2_RX) --> TX 3.3V --> VCC GND --> GND STM32F103C8T6 <--> DHT11 PB6 --> DATA 3.3V --> VCC GND --> GND

3. 传感器数据采集与处理

3.1 DHT11温湿度数据读取

DHT11采用单总线协议，典型读取代码如下：

#define DHT11_PIN GPIO_PIN_6 #define DHT11_PORT GPIOB void DHT11_Start(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = DHT11_PIN; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(DHT11_PORT, &GPIO_InitStruct); HAL_GPIO_WritePin(DHT11_PORT, DHT11_PIN, GPIO_PIN_RESET); HAL_Delay(18); HAL_GPIO_WritePin(DHT11_PORT, DHT11_PIN, GPIO_PIN_SET); delay_us(30); GPIO_InitStruct.Mode = GPIO_MODE_INPUT; HAL_GPIO_Init(DHT11_PORT, &GPIO_InitStruct); } uint8_t DHT11_Read_Byte(void) { uint8_t i, data = 0; for(i=0;i<8;i++) { while(!HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN)); delay_us(40); if(HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN)) { data |= (1<<(7-i)); while(HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN)); } } return data; }

3.2 光照强度传感器BH1750

BH1750通过I2C接口通信，典型初始化代码：

#define BH1750_ADDR 0x23<<1 // 7位地址左移1位 void BH1750_Init(I2C_HandleTypeDef *hi2c) { uint8_t cmd = 0x10; // 连续高分辨率模式 HAL_I2C_Master_Transmit(hi2c, BH1750_ADDR, &cmd, 1, 100); HAL_Delay(180); // 等待测量完成 } uint16_t BH1750_Read_Lux(I2C_HandleTypeDef *hi2c) { uint8_t data[2]; HAL_I2C_Master_Receive(hi2c, BH1750_ADDR, data, 2, 100); return (data[0]<<8)|data[1]; }

4. JSON数据封装与内存优化

4.1 动态构建JSON字符串

为避免内存溢出，推荐使用sprintf分段构建JSON：

char jsonBuffer[256]; // 根据实际数据量调整大小 int jsonLen = 0; jsonLen += sprintf(jsonBuffer+jsonLen, "{\"id\":%d,\"dp\":{", messageId++); jsonLen += sprintf(jsonBuffer+jsonLen, "\"temperature\":[{\"v\":%.1f}],", temp); jsonLen += sprintf(jsonBuffer+jsonLen, "\"humidity\":[{\"v\":%d}],", humi); jsonLen += sprintf(jsonBuffer+jsonLen, "\"light\":[{\"v\":%d}]", light); jsonLen += sprintf(jsonBuffer+jsonLen, "}}");

4.2 内存管理技巧

使用sizeof(jsonBuffer)确保不越界
对于大量数据点，考虑分批次上传
启用STM32的硬件CRC校验数据完整性

5. ESP8266 WiFi通信实现

5.1 AT指令配置流程

发送AT+RST重启模块
发送AT+CWMODE=1设置为Station模式
发送AT+CWJAP="SSID","password"连接WiFi
发送AT+CIPSTART="TCP","183.230.40.39",6002连接OneNET
发送AT+CIPSEND=<length>准备发送数据

5.2 长数据包发送注意事项

单次发送不超过2048字节
等待">"提示后再发送实际数据
添加\r\n作为结束符

注意：ESP8266的TCP缓冲区有限，建议将JSON数据控制在1KB以内

6. OneNET平台配置与数据可视化

6.1 创建数据流模板

登录OneNET控制台
进入产品→数据流模板
添加与JSON中对应的数据流名称（如temperature、humidity等）
设置合适的数据类型和单位

6.2 创建数据可视化仪表盘

在设备详情页点击"添加控件"
选择折线图、仪表盘等合适组件
绑定对应的数据流
设置刷新间隔和显示范围

7. 实战调试技巧与问题排查

7.1 常见问题及解决方案

问题现象	可能原因	解决方法
数据上传失败	WiFi连接不稳定	检查信号强度，重连
JSON解析错误	格式不规范	使用在线JSON验证工具
数据值异常	传感器读取错误	检查硬件连接，重新校准
平台无数据显示	数据流名称不匹配	核对平台与代码中的名称