news 2026/4/16 12:20:26

STM32与cJSON实战：从零构建嵌入式JSON数据解析方案

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
STM32与cJSON实战：从零构建嵌入式JSON数据解析方案

1. 为什么STM32需要JSON解析能力

在物联网和嵌入式设备爆发式增长的今天，JSON已经成为设备间通信的事实标准格式。我刚开始接触STM32与云平台对接时，发现大多数API接口都采用JSON格式传输数据。比如一个简单的温湿度传感器数据，云端通常要求这样的格式：

{ "device_id": "STM32F407_001", "sensor_data": { "temperature": 25.6, "humidity": 60.2 }, "timestamp": 1625097600 }

传统嵌入式开发中，我们习惯用自定义的二进制协议或简单的字符串分隔方式。但实际项目中我深刻体会到，当需要与Web服务对接时，JSON的通用性能大幅降低开发门槛。有次项目紧急对接第三方平台，对方只提供JSON API，幸亏提前集成了cJSON库，两天就完成了协议对接。

cJSON作为轻量级解析库，在STM32F103这类Cortex-M3内核芯片上，完整解析一个20层嵌套的JSON文件仅需4KB RAM。相比之下，我测试过Jansson库虽然内存占用更小，但在处理复杂JSON时稳定性不如cJSON。特别是在资源受限环境下，cJSON的零拷贝设计能有效减少内存碎片问题。

2. cJSON库移植实战指南

2.1 获取与工程集成

直接从GitHub克隆最新源码：

git clone https://github.com/DaveGamble/cJSON.git

关键文件只需要两个：

  • cJSON.c(约28KB)
  • cJSON.h(约18KB)

我习惯在工程目录下新建Middlewares/cJSON文件夹存放这些文件。在Keil中添加源文件时，遇到过路径包含中文导致编译失败的情况，建议使用全英文路径。有个实用技巧：将cJSON文件属性设置为"Exclude from Build"先不编译，等配置完成再取消排除。

2.2 内存管理优化

默认的malloc/free在STM32上可能引发内存碎片。我的解决方案是使用静态内存池：

#define CJSON_POOL_SIZE 2048 static uint8_t cjson_mem_pool[CJSON_POOL_SIZE]; static size_t cjson_mem_offset = 0; void* cJSON_malloc(size_t size) { if(cjson_mem_offset + size > CJSON_POOL_SIZE) { printf("[ERROR] cJSON内存不足!\n"); return NULL; } void* ptr = &cjson_mem_pool[cjson_mem_offset]; cjson_mem_offset += size; return ptr; } void cJSON_free(void* ptr) { // 静态池无需释放 }

在cJSON.h开头添加：

#define cJSON_malloc my_malloc #define cJSON_free my_free

2.3 常见编译问题解决

遇到__use_no_semihosting错误时，在usart.c添加：

// 解决半主机模式错误 void _ttywrch(int ch) { ch = ch; }

如果出现堆栈溢出，修改启动文件startup_stm32fxxx.s中的堆栈大小：

Stack_Size EQU 0x00001000 → 0x00002000

3. JSON数据解析实战技巧

3.1 基础解析示例

解析这个气象站数据：

char* json_str = "{\"device\":\"WS-100\",\"readings\":[{\"type\":\"temp\",\"value\":23.5},{\"type\":\"humi\",\"value\":65}]}"; cJSON* root = cJSON_Parse(json_str); if(!root) { printf("解析错误: %s\n", cJSON_GetErrorPtr()); return; } // 获取设备名 cJSON* device = cJSON_GetObjectItem(root, "device"); printf("设备: %s\n", device->valuestring); // 遍历传感器数组 cJSON* readings = cJSON_GetObjectItem(root, "readings"); int array_size = cJSON_GetArraySize(readings); for(int i=0; i<array_size; i++) { cJSON* item = cJSON_GetArrayItem(readings, i); cJSON* type = cJSON_GetObjectItem(item, "type"); cJSON* value = cJSON_GetObjectItem(item, "value"); printf("%s: %.1f\n", type->valuestring, value->valuedouble); } cJSON_Delete(root); // 必须释放内存

3.2 高效解析技巧

  1. 错误处理增强版：
cJSON* root = cJSON_ParseWithLength(json_str, strlen(json_str)); if(!root) { const char* error_ptr = cJSON_GetErrorPtr(); if(error_ptr) { printf("错误位置: %.*s\n", 20, error_ptr); } return; }
  1. 批量提取数据：
typedef struct { float temp; float humi; } SensorData; void parse_sensor_data(cJSON* root, SensorData* out) { cJSON* readings = cJSON_GetObjectItem(root, "readings"); cJSON* item; cJSON_ArrayForEach(item, readings) { cJSON* type = cJSON_GetObjectItem(item, "type"); cJSON* value = cJSON_GetObjectItem(item, "value"); if(strcmp(type->valuestring, "temp") == 0) { out->temp = value->valuedouble; } else if(strcmp(type->valuestring, "humi") == 0) { out->humi = value->valuedouble; } } }

4. JSON数据生成高级应用

4.1 动态生成复杂JSON

构建一个设备状态报告：

cJSON* root = cJSON_CreateObject(); cJSON_AddStringToObject(root, "device_id", "STM32F407_001"); // 添加嵌套对象 cJSON* status = cJSON_CreateObject(); cJSON_AddNumberToObject(status, "battery", 85); cJSON_AddBoolToObject(status, "connected", true); cJSON_AddItemToObject(root, "status", status); // 添加数组 cJSON* sensors = cJSON_CreateArray(); cJSON* sensor1 = cJSON_CreateObject(); cJSON_AddStringToObject(sensor1, "type", "temperature"); cJSON_AddNumberToObject(sensor1, "value", 25.6); cJSON_AddItemToArray(sensors, sensor1); cJSON* sensor2 = cJSON_CreateObject(); cJSON_AddStringToObject(sensor2, "type", "humidity"); cJSON_AddNumberToObject(sensor2, "value", 60.2); cJSON_AddItemToArray(sensors, sensor2); cJSON_AddItemToObject(root, "sensors", sensors); // 输出紧凑型JSON char* json_str = cJSON_PrintUnformatted(root); printf("%s\n", json_str); // 释放资源 cJSON_free(json_str); cJSON_Delete(root);

4.2 内存优化技巧

  1. 使用静态缓冲区：
char buffer[512]; cJSON* root = cJSON_CreateObject(); // ...构建JSON对象... cJSON_PrintPreallocated(root, buffer, sizeof(buffer), true);
  1. 复用JSON对象：
cJSON* root = cJSON_CreateObject(); for(int i=0; i<10; i++) { cJSON_DeleteItemFromObject(root, "data"); // 删除旧数据 cJSON_AddNumberToObject(root, "data", i); // 使用数据... }

5. 真实项目中的经验分享

在工业传感器项目中，我们遇到JSON解析性能瓶颈。通过以下优化将解析时间从15ms降到3ms：

  1. 预解析关键路径：
// 提前获取常用路径 cJSON* GetNestedItem(cJSON* root, const char* path) { char* token = strtok((char*)path, "."); cJSON* curr = root; while(token && curr) { curr = cJSON_GetObjectItem(curr, token); token = strtok(NULL, "."); } return curr; } // 使用示例 cJSON* temp = GetNestedItem(root, "payload.sensors.temperature");
  1. 选择性解析：
// 只解析需要的字段 void FastParse(const char* json, float* out_temp, float* out_humi) { cJSON* root = cJSON_Parse(json); *out_temp = cJSON_GetObjectItem(root, "temp")->valuedouble; *out_humi = cJSON_GetObjectItem(root, "humi")->valuedouble; cJSON_Delete(root); }
  1. 内存泄漏检测：
#ifdef DEBUG #define CJSON_TRACK_MEMORY size_t cjson_mem_used = 0; void* debug_malloc(size_t size) { cjson_mem_used += size; printf("[MEM] Alloc %zu bytes (total: %zu)\n", size, cjson_mem_used); return malloc(size); } void debug_free(void* ptr) { // 注意: 实际项目中需要记录释放大小 printf("[MEM] Freed\n"); free(ptr); } #endif
版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/4/15 10:55:20

智能剪辑如何节省90%时间？Autocut让视频创作效率倍增

智能剪辑如何节省90%时间&#xff1f;Autocut让视频创作效率倍增 【免费下载链接】autocut 用文本编辑器剪视频 项目地址: https://gitcode.com/GitHub_Trending/au/autocut 你是否曾在剪辑视频时反复拖拽时间轴寻找关键片段&#xff1f;是否为手动添加字幕花费数小时&a…

作者头像 李华
网站建设 2026/4/9 13:20:32

图解说明TI C2000电机控制器ePWM模块工作原理

以下是对您提供的博文《图解解析TI C2000电机控制器ePWM模块工作原理》的 深度润色与专业重构版本 。本次优化严格遵循您的全部要求： ✅ 彻底去除AI腔调与模板化结构（如“引言/总结/展望”等机械分节） ✅ 所有技术内容有机融合，以工程师真实开发视角展开叙述 ✅ 语言自…

作者头像 李华
网站建设 2026/4/15 18:40:58

W5500以太网模块原理图在智能传感器中的集成：从零实现

以下是对您提供的技术博文《W5500以太网模块原理图在智能传感器中的集成：从零实现技术分析》的 深度润色与专业重构版本 。本次优化严格遵循您的全部要求： ✅ 彻底去除AI痕迹，语言自然、老练、有“工程师在现场调试”的真实感 ✅ 摒弃所有模板化标题（如“引言”“总结”…

作者头像 李华
网站建设 2026/4/7 4:18:32

3秒预览，告别等待：提升办公效率的文件预览神器

3秒预览&#xff0c;告别等待&#xff1a;提升办公效率的文件预览神器 【免费下载链接】QuickLook.Plugin.OfficeViewer-Native View Word, Excel, and PowerPoint files with MS Office and WPS Office components. 项目地址: https://gitcode.com/gh_mirrors/qu/QuickLook.…

作者头像 李华
网站建设 2026/4/8 11:10:34

3倍提速！百度网盘非会员突破下载限制的实战指南

3倍提速&#xff01;百度网盘非会员突破下载限制的实战指南 【免费下载链接】pan-baidu-download 百度网盘下载脚本 项目地址: https://gitcode.com/gh_mirrors/pa/pan-baidu-download 你是否遇到过这样的情况&#xff1a;急需下载一份工作文件&#xff0c;百度网盘却以…

作者头像 李华
网站建设 2026/4/10 18:29:15

轻量模型开发者指南：Qwen2.5-0.5B多平台兼容性测试

轻量模型开发者指南&#xff1a;Qwen2.5-0.5B多平台兼容性测试 1. 为什么你需要一个真正能“塞进设备”的大模型&#xff1f; 你有没有试过在树莓派上跑大模型&#xff1f;或者想给安卓手机加个本地AI助手&#xff0c;结果发现连最基础的推理都卡在显存不足上&#xff1f;不是…

作者头像 李华