STM32 基础系列教程 49 – Jansson

前言

    JSON(JavaScript Object Notation, JS 对象简谱) 是一种轻量级的数据交换格式。它基于 ECMAScript (欧洲计算机协会制定的js规范)的一个子集，采用完全独立于编程语言的文本格式来存储和表示数据。简洁和清晰的层次结构使得 JSON 成为理想的数据交换语言。 易于人阅读和编写，同时也易于机器解析和生成，并有效地提升网络传输效率。它独立于开发语言，是一种文本格式， 很适用描述在各个系统间交换的数据。

JSON 格式的数据看起来就像下面这个样子：

{

“Room1”: {

“LED”: “on”,

“Temperature”: “36”

}

}

这个 JSON 数据描述的是 Room1 的 LED 灯状态以及温度值。它由一组“名称（key） ”以及对应的“ 值（value） ”组成。“名称”和“ 值”之间由“ ： ”分开。各组“名称： 值”对之间由“， ”符号进行分割。

 

Jansson是一个用于编码、解码和操作JSON数据的C库。其主要特点和设计原则是:

简单直观的API和数据模型

全面的文档

不依赖于其他库

完全Unicode支持(UTF-8)

广泛的测试套件

 

Jansson获得麻省理工学院许可;有关详细信息，请参阅源代码发行版中的LICENSE。Jansson在生产中使用，它的API是稳定的。它可以在许多平台上工作，包括许多Unix之类的系统和Windows。它适用于任何系统，包括桌面、服务器和小型嵌入式系统。本节将给大家演示STM32MCU + jansson库实现对JSON数据的组包与解包过程，下面开始进入正题。

 

示例详解

基于硬件平台： 正点源子的stm32f4 探索者开发板，MCU 的型号是 STM32F4ZET6, 使用stm32cubemx 工具自动产生的配置工程，使用KEIL5编译代码。本示例所用的开发板及部分原理图：

 

1. 1. 关于CUBEMX工具及KEIL工具的操作将不再细讲，如果还有不熟悉的可以查看之前的教程文档。下面直接介绍工程配置：

 

1. 1. 1. 系统时钟树

 

1. 1. 1. 串口配置（用于程序调试）

 

1. 1. 1. RCC配置

1. 1. 1. SYS配置

 

1. 1. 1. 引脚配置,用到引脚极少

1. 1. 1. 堆栈配置（堆要大些）：

 

1. 1. 工程代码
      1. Keil MDK开发环境可以扩展丰富的第三方库，本节要用到的jansson库也可以直接在MDK开发环境中导入，具体操作如下：

库安装》

库导入》

库导入后》

 

1. 1. 1. 在main.c 中main函数中USER CODE BEGIN Includes、USER CODE0， USER CODE1、USER CODE 2, USER CODE 4 区域加入如下图所示代码：

  

 

c) 编译工程，调试程序， (注：在使用探索者F4调试时，下载或仿真调试时先不要PC串口工具连接上开发板的USB_232接口，有可能导致程序运行不了--boot0引脚电平不对，可以先跑起来再在PC串口工具上连接相应端口！！，可按下面的具体操作步骤来操作—>>  )

 

串口已打开，程序全速运行（F5或单击全速运行图标）相看运行结果：

 

这个时候可以在串口中看到如下程序运行结果（成功打印出JSON数据并成功解析）：

复制上面输出的结果，打开电脑网页浏览器，打开http://www.bejson.com/ （在线JSON格式化）网站，格式化一下输出结果！！

到此本次的基于jansson库的JSON数据操作（创建与解析）就完成了，jansson库之持的所有接口都在 jansson.h文件中有声明，关于jansson库的更多接口具体说明请查看jansson官方接口说明可以KEIL MDK 安装目录下（如笔者的…/ARM/PACK/jansson\1.0.0\doc）的说明文档对应的API Reference部分：

当然你也可以直接百度jansson,进入Jansson官方网站https://jansson.readthedocs.io/en/2.12/apiref.html：查看API Reference说明：

下载使用最新的jansson库请点它--> http://www.digip.org/jansson/releases/ ,快快让你的程序也Json起来吧。

 

OK,本期实验完成！下期见！同时如果大家有什么疑问或是有想了解的其它内容，也欢迎大家留言！！最后喜欢这个公众号的同学们记得加关注了，会有不定期技术干货推出！！

 

文中源码资料下载，在公众号里给十三发消息:

下载|STM32基础系列教程49

 

关注十三公众号