前言
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编译代码。本示例所用的开发板及部分原理图:
-
- 关于CUBEMX工具及KEIL工具的操作将不再细讲,如果还有不熟悉的可以查看之前的教程文档。下面直接介绍工程配置:
-
-
- 系统时钟树
-
-
-
- 串口配置(用于程序调试)
-
-
-
- RCC配置
-
-
-
- SYS配置
-
-
-
- 引脚配置,用到引脚极少
-
-
-
- 堆栈配置(堆要大些):
-
-
- 工程代码
- Keil MDK开发环境可以扩展丰富的第三方库,本节要用到的jansson库也可以直接在MDK开发环境中导入,具体操作如下:
- 工程代码
库安装》
库导入》
库导入后》
-
-
- 在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
关注十三公众号