大家好,我是杂烩君。

嵌入式大杂烩周记主要是一些实用项目学习分享,每周一篇,每篇一个主题。

内容主要来源于我们之前收集的资料:

https://gitee.com/zhengnianli/EmbedSummary

本期主角:nanopb

nanopb是一个轻量的、支持C语言的Protobuf,可以在STM32等单片机上使用。

Protobuf是Google公司开发的一种数据格式,类似于XML能够将结构化数据序列化,可用于数据存储、通信协议等方面。它不依赖于语言和平台并且可扩展性极强。

nanopb的优点:

  • 更小、更快、更简单。
  • 解析速度快。
  • 可扩展性强。

nanopb下载地址:

嵌入式入门的电子书:嵌入式大杂烩周记(1)

https://jpa.kapsi.fi/nanopb/download/

nanopb的使用

我们基于STM32来演示nanopb的使用。

我们从上面的链接中下载 nanopb-0.3.8-windows-x86 ,得到:

嵌入式入门的电子书:嵌入式大杂烩周记(2)

然后,我们准备一个带有串口打印功能的STM32工程,如:

嵌入式入门的电子书:嵌入式大杂烩周记(3)

在工程目录下新建一个Protobuf文件夹,并把nanopb-0.3.8-windows-x86目录下如下7个文件

pb.h

pb_common.c

pb_common.h

pb_decode.c

pb_decode.h

pb_encode.c

pb_encode.h

复制至Protobuf文件夹中:

嵌入式入门的电子书:嵌入式大杂烩周记(4)

protobuf的核心是一个.proto文件,我们自定义一个.proto来创建我们的协议数据,然后使用protoc工具编译生成C代码,有两个文件:一个头文件、一个源文件。

其中protoc工具在我们上面下载的nanopb-0.3.8-windows-x86的generator-bin文件夹中:

嵌入式入门的电子书:嵌入式大杂烩周记(5)

为了能在命令行中任何路径下使用protoc工具,我们需要把protoc.exe所在路径添加到环境变量中,我这里的路径为:

C:\nanopb-0.3.8-windows-x86\generator-bin

把这个路径添加到环境变量中:

嵌入式入门的电子书:嵌入式大杂烩周记(6)

嵌入式入门的电子书:嵌入式大杂烩周记(7)

嵌入式入门的电子书:嵌入式大杂烩周记(8)

嵌入式入门的电子书:嵌入式大杂烩周记(9)

嵌入式入门的电子书:嵌入式大杂烩周记(10)

嵌入式入门的电子书:嵌入式大杂烩周记(11)

下面,我们在Protobuf文件夹中创建一个student.proto文件:

嵌入式入门的电子书:嵌入式大杂烩周记(12)

这个文件的内容我们编写为:

syntax = "proto2"; message Student { required uint32 num = 1; required uint32 py_score = 2; required uint32 c_score = 3; }

嵌入式入门的电子书:嵌入式大杂烩周记(13)

然后win r组合键进入运行窗口,输入cmd进入命令行;在命令行cd进入student.proto所在目录;输入如下命令编译student.proto:

protoc --nanopb_out=. student.proto

嵌入式入门的电子书:嵌入式大杂烩周记(14)

生成student.pb.c与student.pb.h文件:

嵌入式入门的电子书:嵌入式大杂烩周记(15)

把Protobuf文件夹里的文件添加到mdk工程并增加头文件搜索路径:

嵌入式入门的电子书:嵌入式大杂烩周记(16)

嵌入式入门的电子书:嵌入式大杂烩周记(17)

编译,无误:

嵌入式入门的电子书:嵌入式大杂烩周记(18)

编写测试代码:

// 嵌入式大杂烩 void protobuf_test(void) { uint8_t buffer[64] = {0}; Student pack_stu = {0}; pb_ostream_t o_stream = {0}; Student unpack_stu = {0}; pb_istream_t i_stream = {0}; // 组包 pack_stu.num = 88; pack_stu.py_score = 90; pack_stu.c_score = 99; o_stream = pb_ostream_from_buffer(buffer, sizeof(buffer)); pb_encode(&o_stream, Student_fields, &pack_stu); // 解包 i_stream = pb_istream_from_buffer(buffer, sizeof(buffer)); pb_decode(&i_stream, Student_fields, &unpack_stu); printf("unpack_stu.num = %d\n", unpack_stu.num); printf("unpack_stu.py_score = %d\n", unpack_stu.py_score); printf("unpack_stu.c_score = %d\n", unpack_stu.c_score); }

demo很简单,组包就是构造一个协议数据结构体,调用pack组包接口往buffer中扔数据;解包正好是反过来,从buffer中拿数据放到结构体里。其中,组包相关的函数在pb_encode.c中,解包相关的函数在pb_decode.c中,感兴趣的小伙伴可自行阅读。

编译、下载验证:

嵌入式入门的电子书:嵌入式大杂烩周记(19)

本篇笔记demo可在私信我 进行获取。

以上就是本次的分享,文章如有错误,欢迎指出,谢谢!

咱们下期见~

猜你喜欢:

分享一些可以快速入门的嵌入式教程

分享一份不错的嵌入式资料汇总贴

嵌入式大杂烩周记 第 4 期:cola_os

嵌入式大杂烩周记 第 7 期:zlog

嵌入式大杂烩周记 第 8 期:AMetal

,