STM32单片机与cJSON：构建并解析JSON数据

在现代嵌入式体系开发中，数据交换和通信变得日益重要尤其是在单片机设备接入云端的过程中常常会用到构建息争析JSON格式。而且JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，因其简洁、易于阅读和编写，以及跨平台兼容性的上风，在嵌入式体系中得到了广泛应用。本文将详细介绍如安在STM32微控制器上使用cJSON库来生成息争析JSON数据，为开发者们提供一个实用的指南。
一、准备工作

1. cJSON库简介

cJSON是一个轻量级的、易于使用的C语言库，用于解析和生成JSON数据。它只包含两个文件：cJSON.c和cJSON.h，非常适合资源受限的嵌入式体系。cJSON的设计目标是简单、快速和高效，因此它非常适合在STM32如许的微控制器上运行。
2. 硬件环境

• STM32微控制器（本次接纳STM32F103RCT6）
  
• 串口通信模块
  

3. 软件环境

• Keil uVision IDE（或其他支持STM32的IDE）
  
• STM32CubeMX（可选，用于设置硬件）
  
• cJSON库文件（cJSON.c和cJSON.h）
  
• 工程接纳之前制作的串口模版STM32-HAL库串口空闲中断DMA汲取数据Demo-CSDN博客
  

二、实现步骤

1. 导入添加cJSON库

添加cjson.c和cjson.h文件到工程中，工程中相关文件放在工程目录下User文件夹下。

在json文件中可以看到已经封装好大量函数，在使用过程中只需要包含cjson.h文件便可以调用构建息争析json的函数
2. 创建JSON字符串

2.1. 根本用法

在STM32上创建一个JSON对象并添加数据非常简单。首先，需要创建一个cJSON对象，然后使用cJSON提供的API函数向此中添加数据。如下代码所示能够在json对象中分别添加字符串string类型、数字以及bool类型：

1. cJSON *root = cJSON_CreateObject();  
2. cJSON_AddStringToObject(root, "name", "STM32");  
3. cJSON_AddNumberToObject(root, "age",5);  
4. cJSON_AddBoolToObject(root, "is_running", cJSON_True);

复制代码

创建好JSON对象后，需要将其转换为字符串以便于传输或存储。cJSON提供了cJSON_Print函数来完成这一使命。

1. char *json_string = cJSON_Print(root);  
2. printf("%s\n", json_string);

复制代码

现在就可以输出一个完备的json字符串：

1. {
2.     "name": "stm32",
3.     "age": 5,
4.     "is_running": true
5. }

复制代码

在实际使用过程中需要考虑到单片机内存空间问题，假如创建失败大概会导致内存泄漏等问题，所以在单片使用时需要增长相关判定和错误处置惩罚
2.2. 单片机中cJSON的用法

• 构建目标
  

下方json字符串为华为云IoTDA中设备上报属性的格式，在json字符串中嵌套json字符串

1. {
2.     "name": "environment",
3.     "id": 1,
4.     "params": {
5.         "temp": 23.5,
6.         "humi": 50,
7.         "o2": 21
8.     }
9. }

复制代码

• 函数实现
  

在实现前需要确保stm32单片机的堆空间充足大，保证后续json构建能够乐成。

如下代码能够实现了 cJSON 对象的创建、添补、转换为字符串、打印以及最终的内存开释。

1. void getJsonData(void)
2. {
3.         cJSON *pOrder = cJSON_CreateObject();  
4.     cJSON *params = cJSON_CreateObject();  
5.     char *json_body = NULL;  
6.        
7.         if (pOrder == NULL || params == NULL)  
8.     {  
9.         printf("Creat ENV JSONobj Err\n");  
10.         cJSON_Delete(pOrder);  
11.         cJSON_Delete(params);  
12.         return;  
13.     }  
14.        
15.         // 添加参数到params对象，并检查每个调用的返回值  
16.     if (!cJSON_AddNumberToObject(params,"temp",23.5)||  
17.         !cJSON_AddNumberToObject(params,"humi",50)        ||  
18.         !cJSON_AddNumberToObject(params,"o2",21))
19.     {  
20.         printf("Add ENV data to JSONobj Err\n");  
21.         cJSON_Delete(pOrder);  
22.         cJSON_Delete(params);  
23.         return;  
24.     }  
25.        
26.         // 添加params到pOrder对象  
27.     cJSON_AddStringToObject(pOrder, "name", "environment");  
28.     cJSON_AddNumberToObject(pOrder, "id", 1);  
29.     cJSON_AddItemToObject(pOrder, "params", params);
30.        
31.         // 转换JSON对象为字符串  
32.     json_body = cJSON_PrintUnformatted(pOrder);
33.        
34.     if (json_body == NULL)  
35.     {  
36.         printf("Print ENV JSON Err\n");  
37.         cJSON_Delete(pOrder);  
38.         return;  
39.     }  
40.        
41.         // 打印并发送JSON字符串
42.     printf("ENV json: %s \r\n", json_body);  
43.        
44.         cJSON_free(json_body);
45.         cJSON_Delete(pOrder);  
46. }

复制代码

• 分析
  

• 错误检查：在创建 cJSON 对象后，检查 pOrder 和 params 是否为 NULL。因为内存分配大概会失败，尤其是在资源受限的环境中。
  
• 参数添加：使用 cJSON_AddNumberToObject 添加了数字类型的参数到 params 对象中，并检查了每个调用的返回值，能够确保数据正确添加到 JSON 对象中的好方法。
  
• 对象嵌套：使用 cJSON_AddItemToObject 将 params 对象作为子项添加到了 pOrder 对象中。params 的所有权转移给了 pOrder，因此在后续调用cJSON_Delete删除时不需要在之后单独删除 params。
  
• 字符串转换：使用 cJSON_PrintUnformatted 将 pOrder 对象转换为了一个未格式化的字符串，并检查了转换是否乐成。
  
• 内存开释：最后开释了转换后的字符串 json_body 所占用的内存，以及整个 pOrder 对象及其所有子对象所占用的内存。
  

3. 解析JSON字符串

3.1. 根本用法

汲取到的JSON字符串可以使用cJSON_Parse函数举行解析。解析后的结果是一个cJSON对象，你可以通过cJSON_GetObjectItem等函数来访问此中的数据。

1. cJSON *parsed_json = cJSON_Parse(json_string);  
2. if (parsed_json == NULL) {  
3.     // 解析失败处理  
4.     printf("Parse error\n");  
5. } else {  
6.     cJSON *name = cJSON_GetObjectItem(parsed_json, "name");  
7.     if (name != NULL) {  
8.         printf("Name: %s\n", name->valuestring);  
9.     }  
10.     // 继续解析其他数据...  
11.     cJSON_Delete(parsed_json);  
12. }

复制代码

3.2. 单片机中的用法

在stm32单片机中需要先判定汲取到的字符串是否完备，并对一些错误举行防范。解析将以华为云IoTDA中应用侧下发的控制下令为例，其下令格式如下：

1. {
2.     "object_device_id": 123,
3.     "command_name": "LED",
4.     "service_id": "WaterMeter",
5.     "paras": {
6.         "sw": true,
7.         "val": 50
8.     }
9. }

复制代码

此中paras中的sw代表开关，val代表亮度值，解析代码如下，第一部分先查找汲取到的数据中完备的json字符串，第二部分分配内存空间复制生存json数据，第三部分解析json数据

1. int8_t Parse_MqttCmd(uint8_t *data)
2. {
3.         // 寻找JSON数据的开始位置  
4.         const char *json_start = strstr((char *)data, "{");
5.         if (json_start == NULL)
6.         {  
7.                 printf("JSON data not found in the received string.\n");  
8.                 return -1;  
9.         }  
10.         size_t json_length = strlen(json_start);
11.        
12.         // 分配内存并复制JSON数据  
13.         char *json_data = (char *)malloc(json_length + 1);  
14.         if (json_data == NULL) {  
15.                 printf("Memory allocation failed.\n");  
16.                 return -1;  
17.         }  
18.         strncpy(json_data, json_start, json_length);  
19.         json_data[json_length] = '\0'; // 添加null终止符  
21.         //解析JSON数据  
22.         cJSON *root = cJSON_Parse(json_data);  
23.         if (root == NULL)
24.         {  
25.                 printf("Failed to parse JSON data.\n");  
26.                 cJSON_free(json_data);  
27.                 return -1;  
28.         }  
29.         // ... 在这里处理JSON数据 ...  
30.                
31.         // 获取并打印"command_name"字段的值  
32.         cJSON *name = cJSON_GetObjectItemCaseSensitive(root, "command_name");
34.         //判断"command_name"字段的值选择控制类型
35.         if (name && cJSON_IsString(name) && (name->valuestring != NULL))
36.         {  
37.                 char * command_name = name->valuestring;
38.                 printf("Name: %s \r\n", command_name);
39.                
40.                 //灯光控制命令
41.                 if(strstr(name->valuestring,"LED"))
42.                 {
43.                         cJSON *paras = cJSON_GetObjectItemCaseSensitive(root, "paras");/*获取obj中的paras的json*/
44.                         if (paras && cJSON_IsObject(paras))
45.                         {
46.                                 cJSON *sw_item = cJSON_GetObjectItemCaseSensitive(paras, "sw");/*开关状态*/  
47.                                 if (sw_item != NULL && cJSON_IsBool(sw_item))
48.                                 {  
49.                                         int sw_value = sw_item->valueint; // cJSON使用int来表示bool值  
50.                                         printf("sw: %d \r\n", sw_value); // 输出sw的值，1代表true，0代表false
51.                                 }else
52.                                 {  
53.                                         printf("Failed to get 'sw' value or it's not a boolean.\r\n");  
54.                                 }  
55.                                 cJSON *val_item = cJSON_GetObjectItemCaseSensitive(paras, "val");  
56.                                 if (val_item != NULL && cJSON_IsNumber(val_item))
57.                                 {  
58.                                         int val = val_item->valueint; // cJSON使用int来表示bool值  
59.                                         printf("val: %d \r\n", val); // 输出sw的值，1代表true，0代表false  
60.                                 }else
61.                                 {  
62.                                         printf("Failed to get 'val' value or it's not a number. \r\n");  
63.                                 }
64.                         }                                       
65.                 }
66.         }
67.         // 释放资源
68.         cJSON_Delete(root);  
69.         cJSON_free(json_data);  
70.         return 1;  
71. }

复制代码

• 分析
  

• 字段存在性和类型检查：通过 cJSON_GetObjectItemCaseSensitive 和相应的类型检查函数来确保字段存在且类型正确。
  
• 内存分配和开释：分配内存来存储 JSON 字符串，并在处置惩罚完 JSON 数据后开释了这块内存也开释了 cJSON 对象。
  
• 错误处置惩罚：在JSON 解析失败和内存分配失败添加了错误提示。
  

4. 留意事项

• 内存管理：STM32的内存资源有限，特殊是在使用cJSON库时，需要确保有充足的堆内存来存储JSON数据，需要调解STM32的堆栈大小。
  
• 错误处置惩罚：在解析JSON字符串时，一定要检查返回值，确保解析没有失败。
  

三、cJSON库各类函数解析

1. 解析和创建函数

• cJSON_Parse(): 解析一个JSON格式的字符串，并返回一个cJSON指针，指向解析后的JSON结构的根。假如解析失败，返回NULL。
  
• cJSON_Create 系列函数（如cJSON_CreateObject(), cJSON_CreateArray(), cJSON_CreateString(), cJSON_CreateNumber(), cJSON_CreateBool(), cJSON_CreateNull()）: 这些函数用于创建差别类型的cJSON对象，分别对应于JSON中的对象、数组、字符串、数字、布尔值和null。
  

2. 访问和修改函数

• cJSON_GetObjectItemCaseSensitive() 和 cJSON_GetObjectItem(): 根据键名查找JSON对象中的项。第一个函数对大小写敏感，第二个函数则不敏感。
  
• cJSON_GetArrayItem(): 根据索引获取JSON数组中的项。
  
• cJSON_AddItemToObject(), cJSON_AddItemToArray(), cJSON_AddItemReferenceToArray(), cJSON_AddItemToObjectCS(): 这些函数用于向JSON对象或数组中添加项。此中，带有CS后缀的函数对键名大小写敏感。
  
• cJSON_ReplaceItemInObjectCaseSensitive() 和 cJSON_ReplaceItemInObject(): 根据键名更换JSON对象中的项。与GetObjectItem函数类似，第一个函数对大小写敏感。
  
• cJSON_DetachItemFromObject() 和 cJSON_DetachItemFromArray(): 从JSON对象或数组中移除项，但不开释其内存。
  
• cJSON_DeleteItemFromObject() 和 cJSON_DeleteItemFromArray(): 从JSON对象或数组中移除项，并开释其内存。
  

3. 辅助函数

• cJSON_Print() 和 cJSON_PrintUnformatted(): 将cJSON结构转换回JSON格式的字符串。第一个函数格式化输出，第二个函数不格式化。
  
• cJSON_PrintBuffered(): 类似于cJSON_Print，但允许使用自界说的缓冲区。
  
• cJSON_Duplicate(): 创建一个cJSON项的深拷贝。
  
• cJSON_NumStrings 和相关宏（如cJSON_IsArray, cJSON_IsObject, cJSON_IsString, cJSON_IsNumber, cJSON_IsBool, cJSON_IsNull）: 这些函数和宏用于检查cJSON项的类型。
  

4. 错误处置惩罚

• cJSON_GetErrorPtr(): 返回一个指向全局变量的指针，该变量包含解析错误时的错误信息（假如有的话）。
  

5. 内存管理

• cJSON_Delete(): 开释一个cJSON项及其所有子项占用的内存。
  

四、源码链接

【免费】stm32+cjson库实现json格式创建与解析资源-CSDN文库

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。