从ESP32到STM32：手把手教你用CJSON库搞定跨平台嵌入式设备的数据通信
在物联网和智能硬件开发中，跨平台数据通信一直是个令人头疼的问题。想象一下这样的场景：你的ESP32网关需要与多个STM32节点交换数据，这些设备可能运行着不同的固件框架（ESP-IDF和STM32 HAL），内存资源也各不相同。如何确保数据格式的统一性和解析的可靠性？这就是cJSON这个轻量级C语言JSON库大显身手的地方。
JSON作为一种轻量级的数据交换格式，已经成为现代物联网通信的事实标准。它比XML更简洁，比二进制协议更易读，特别适合资源受限的嵌入式系统。cJSON以其纯C实现、无外部依赖和极小的内存占用（仅需单个.h和.c文件），成为嵌入式开发者的首选JSON解决方案。
1. 跨平台环境下的cJSON集成策略
1.1 ESP-IDF环境中的cJSON集成
在ESP32的ESP-IDF开发环境中，集成cJSON非常简单，因为ESP-IDF已经内置了对cJSON的支持。你只需要在menuconfig中启用即可：
idf.py menuconfig导航到Component config -> JSON，选择cJSON支持。或者在代码中直接包含：
#include "cJSON.h"ESP-IDF对cJSON做了优化，特别适合Wi-Fi和蓝牙通信场景。例如，在接收HTTP JSON数据时：
cJSON *root = cJSON_Parse(response_data); if (root == NULL) { const char *error_ptr = cJSON_GetErrorPtr(); if (error_ptr != NULL) { ESP_LOGE(TAG, "Error before: %s", error_ptr); } return ESP_FAIL; }1.2 STM32 HAL环境中的cJSON适配
对于STM32开发环境，你需要手动将cJSON添加到项目中。以下是关键步骤：
- 从GitHub获取最新cJSON源码（通常只需要cJSON.c和cJSON.h）
- 在CubeIDE或Keil项目中添加这两个文件
- 配置正确的堆栈大小（建议至少4KB的堆空间）
注意：STM32默认的堆空间可能不足，需要在启动文件（如startup_stm32fxxx.s）中调整Heap_Size：
Heap_Size EQU 0x00001000在低内存STM32（如STM32F103）上使用时，建议采用以下编译优化：
CFLAGS += -Os -ffunction-sections -fdata-sections LDFLAGS += -Wl,--gc-sections -lm2. 设计跨平台的JSON通信协议
2.1 设备状态数据结构设计
一个良好的协议设计应该兼顾可读性和效率。以下是典型的物联网设备状态上报结构：
{ "device": { "id": "ESP32-GW-001", "type": "gateway", "fw_ver": "1.2.0" }, "status": { "uptime": 3600, "mem_free": 45231, "cpu_temp": 48.7 }, "nodes": [ { "id": "STM32-NODE-01", "online": true, "last_seen": 1634567890 } ] }对应的C结构体定义：
typedef struct { char id[32]; char type[16]; char fw_ver[16]; } device_info_t; typedef struct { uint32_t uptime; size_t mem_free; float cpu_temp; } device_status_t; typedef struct { char id[32]; bool online; time_t last_seen; } node_info_t;2.2 控制指令协议设计
从ESP32向STM32发送控制指令的JSON格式示例：
{ "cmd": "set_parameters", "target": "STM32-NODE-01", "params": { "sampling_interval": 500, "report_threshold": 2.5, "enable_alarm": true }, "timestamp": 1634567890 }3. 高效序列化与解析实现
3.1 内存优化的序列化技巧
在资源受限的设备上，使用cJSON_PrintUnformatted可以节省约30%的内存：
char* serialize_device_status(const device_status_t *status) { cJSON *root = cJSON_CreateObject(); cJSON_AddNumberToObject(root, "uptime", status->uptime); cJSON_AddNumberToObject(root, "mem_free", status->mem_free); cJSON_AddNumberToObject(root, "cpu_temp", status->cpu_temp); char *json_str = cJSON_PrintUnformatted(root); cJSON_Delete(root); return json_str; }对于频繁通信的场景，可以预分配缓冲区：
int serialize_to_buffer(char *buf, size_t buf_size, const device_info_t *info) { cJSON *root = cJSON_CreateObject(); // 构建JSON对象... char *json_str = cJSON_PrintUnformatted(root); int len = snprintf(buf, buf_size, "%s", json_str); free(json_str); cJSON_Delete(root); return len; }3.2 安全解析与错误处理
健壮的JSON解析需要考虑各种异常情况：
bool parse_control_command(const char *json_str, control_cmd_t *cmd) { cJSON *root = cJSON_Parse(json_str); if (root == NULL) return false; cJSON *j_cmd = cJSON_GetObjectItemCaseSensitive(root, "cmd"); if (!cJSON_IsString(j_cmd)) goto error; strncpy(cmd->command, j_cmd->valuestring, sizeof(cmd->command)); cJSON *j_params = cJSON_GetObjectItemCaseSensitive(root, "params"); if (cJSON_IsObject(j_params)) { cJSON *j_interval = cJSON_GetObjectItemCaseSensitive(j_params, "sampling_interval"); if (cJSON_IsNumber(j_interval)) { cmd->sampling_interval = j_interval->valueint; } // 解析其他参数... } cJSON_Delete(root); return true; error: cJSON_Delete(root); return false; }4. 跨平台通信实战案例
4.1 UART通信实现
在STM32端实现UART JSON通信：
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart == &huart1) { if (parse_json(rx_buffer)) { // 处理有效JSON数据 process_control_command(¤t_cmd); } // 重新启动接收 HAL_UART_Receive_IT(&huart1, rx_buffer, RX_BUF_SIZE); } }ESP32端的UART发送优化：
void send_json_over_uart(uart_port_t uart_num, const char *json_str) { // 添加帧头和帧尾 uint8_t frame[256]; int len = snprintf(frame, sizeof(frame), "\x02%s\x03", json_str); uart_write_bytes(uart_num, frame, len); }4.2 网络通信实现
ESP32作为HTTP服务器提供JSON API：
esp_err_t api_handler(httpd_req_t *req) { char buf[256]; int ret = httpd_req_recv(req, buf, sizeof(buf)); cJSON *root = cJSON_Parse(buf); if (root == NULL) { httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST, "Invalid JSON"); return ESP_FAIL; } // 处理请求并生成响应 cJSON *response = create_response_json(); char *response_str = cJSON_PrintUnformatted(response); httpd_resp_send(req, response_str, strlen(response_str)); cJSON_Delete(root); cJSON_Delete(response); free(response_str); return ESP_OK; }5. 性能优化与调试技巧
5.1 内存使用分析
不同平台上的内存消耗对比：
| 操作 | ESP32 (字节) | STM32F4 (字节) | STM32F1 (字节) |
|---|---|---|---|
| 解析简单JSON | 1,200 | 1,500 | 2,000 |
| 生成格式化JSON | 2,500 | 3,000 | 内存不足 |
| 生成非格式化JSON | 1,800 | 2,200 | 2,800 |
5.2 常见问题排查
内存不足错误：
- 症状：解析失败或设备重启
- 解决方案：使用
cJSON_PrintUnformatted，增加堆空间
JSON格式错误：
const char *error_ptr = cJSON_GetErrorPtr(); if (error_ptr != NULL) { printf("Error before: %s\n", error_ptr); }浮点数精度问题：
// 设置浮点数打印精度 cJSON_InitHooks(&(cJSON_Hooks){ .malloc_fn = malloc, .free_fn = free, .realloc_fn = realloc });
6. 高级应用场景
6.1 二进制数据编码
对于需要传输二进制数据的场景，可以使用Base64编码：
#include "mbedtls/base64.h" void add_binary_data(cJSON *obj, const char *key, const uint8_t *data, size_t len) { size_t b64_len; mbedtls_base64_encode(NULL, 0, &b64_len, data, len); char *b64_data = malloc(b64_len); mbedtls_base64_encode((unsigned char *)b64_data, b64_len, &b64_len, data, len); cJSON_AddStringToObject(obj, key, b64_data); free(b64_data); }6.2 差分更新策略
为减少通信数据量，可以实现差分更新：
void generate_diff_update(cJSON *current, cJSON *previous, cJSON *update) { // 比较两个JSON对象，只将有变化的字段添加到update中 // 实现略... } // 使用示例 cJSON *current_state = get_current_state(); cJSON *last_reported = get_last_reported_state(); cJSON *update = cJSON_CreateObject(); generate_diff_update(current_state, last_reported, update);在STM32端实现了一个基于JSON的远程固件更新方案。通过将固件分块传输，每块数据都通过JSON包装，包含校验和和序列号，确保了在不可靠通信链路下的可靠传输。
