前言
之前分享關(guān)于JSON的使用:例說嵌入式實用知識之JSON數(shù)據(jù)。JSON類型數(shù)據(jù)可讀性很好,但是整個數(shù)據(jù)包中會帶有一些無用的數(shù)據(jù),會在一定程度上帶來通信負擔。
本篇文章我們來分享一種更輕量的數(shù)據(jù)格式——protobuf。
protobuf的優(yōu)點:
- 更小、更快、更簡單。
- 支持多種編程語言 。
- 解析速度快。
- 可擴展性強。
什么是protobuf、protobuf-c?
Protocol Buffers,是Google公司開發(fā)的一種數(shù)據(jù)格式,類似于XML能夠?qū)⒔Y(jié)構(gòu)化數(shù)據(jù)序列化,可用于數(shù)據(jù)存儲、通信協(xié)議等方面。它不依賴于語言和平臺并且可擴展性極強。
protobuf倉庫:
github:https://github.com/protocolbuffers/protobuf
下載速度比較慢,可以先導(dǎo)入到碼云,再下載。
protobuf支持多種編程語言:
可以看到,protobuf支持一些主流的語言,唯獨沒有支持C。所以誕生了第三方的protobuf-c。
protobuf-c倉庫:
https://github.com/protobuf-c/protobuf-c
安裝protobuf、protobuf-c
我們要使用基于C語言的protobuf,首先需要安裝protobuf與protobuf-c。
下面是在Ubuntu下安裝的方法:
1、安裝protobuf
安裝protobuf需要依賴一些工具,需要先安裝依賴:
sudo?apt-get?install?autoconf?automake?libtool?curl?make?g++?unzip
安裝完依賴后一依次輸入如下命令下載、編譯、安裝(下載速度慢的話可以先導(dǎo)入碼云再下載)protobuf:
git?clone?https://github.com/protocolbuffers/protobuf.git
cd?protobuf
./autogen.sh
./configure
make
sudo?make?install
sudo?ldconfig
其中,執(zhí)行./autogen.sh命令為了生成configure配置腳本,執(zhí)行configure可生成Makefile文件,執(zhí)行make進行編譯,執(zhí)行sudo make install命令進行安裝,執(zhí)行sudo ldconfig命令讓動態(tài)鏈接庫為系統(tǒng)所共享。
2、安裝protobuf-c
同樣的,protobuf-c也要依賴于 pkg-config ,輸入以下命令進行安裝:
sudo?apt-get?install?pkg-config
然后輸入如下命令下載、編譯、安裝protobuf-c:
git?clone?https://github.com/protobuf-c/protobuf-c.git cd?protobuf-c
./autogen.sh
./configure
make
sudo?make?install
按以上方式安裝的話,protobuf與protobuf-c默認安裝在/usr/local路徑下:
溫馨提示:安裝過程可能會出現(xiàn)各種各樣的錯誤,遇到錯誤的時候仔細看錯誤描述及看本篇文章安裝步驟,看是否遺漏了哪一步。
實踐demo
protobuf的核心是一個.proto文件,我們自定義一個.proto來創(chuàng)建我們的協(xié)議數(shù)據(jù),然后使用protoc-c工具編譯生成C代碼,有兩個文件:一個頭文件、一個源文件。
例如我們創(chuàng)建一個student.proto文件:
syntax?= "proto2";
?
message?Student
{
????required string name????= 1;
????required?uint32?num?????= 2;
????required?uint32?c_score?= 3;
}
其中syntax為語法版本,有proto2、proto3兩個版本,我們使用proto2。同C語言類似,.proto也規(guī)定了一些數(shù)據(jù)格式,如proto2的數(shù)據(jù)類型有:double 、 float、 int32 、 uint32 、 string 等。
本例中,message為關(guān)鍵字,修飾的Student會對應(yīng)生成我們C中的Student結(jié)構(gòu)體。其中required為前綴修飾,表明該字段是必填字段。還有其它兩個修飾關(guān)鍵字:
-
optional:聲明該字段是可選字段。
-
repeated:聲明該字段是可重復(fù)字段,通常用數(shù)組表示,也可以是list。
使用protoc-c工具工具編譯student.proto文件的命令:
protoc?--c_out=.?student.proto
此時編譯會生成student.pb-c.c、student.pb-c.h兩個文件。我們看看student.pb-c.h里面有什么:
可以看到,student.pb-c.h里生成了一個協(xié)議數(shù)據(jù)結(jié)構(gòu)體與操作該結(jié)構(gòu)體的一些接口,包括組包與解包接口,對應(yīng)的student.pb-c.c里就是這些接口對應(yīng)的實現(xiàn)。
編寫我們的student.c測試demo:
左右滑動查看全部代碼>>>
#include #include #include #include "student.pb-c.h" int main(void) {
????Student?pack_stu?=?{0}; uint8_t buffer[512]?=?{0};
????Student?*unpack_stu?= NULL; size_t len?= 0;
????student__init(&pack_stu); /*?組包?*/ pack_stu.name?= "ZhengN";
????pack_stu.num?= 88;
????pack_stu.c_score?= 90;
????len?=?student__pack(&pack_stu,?buffer); printf("len?=?%ld\n",len); /*?解包?*/ unpack_stu?=?student__unpack(NULL,?len,?buffer); printf("unpack_stu.name?=?%s\n",?unpack_stu->name); printf("unpack_stu.num?=?%d\n",?unpack_stu->num); printf("unpack_stu.c_score?=?%d\n",?unpack_stu->c_score);
????student__free_unpacked(unpack_stu, NULL); return 0;
}
demo很簡單,組包就是構(gòu)造一個協(xié)議數(shù)據(jù)結(jié)構(gòu)體,調(diào)用pack組包接口往buffer中扔數(shù)據(jù);解包正好是反過來,從buffer中拿數(shù)據(jù)放到結(jié)構(gòu)體里。
編譯命令:
gcc?student.c?student.pb-c.c?-o?student?-lprotobuf-c
加上-lprotobuf-c參數(shù)鏈接動態(tài)鏈接庫protobuf-c.so,因為前面安裝操作的時候有使用ldconfig命令了,所以這里不需要指定動態(tài)庫路徑,否則需要指定,指定方法參照往期文章:靜態(tài)鏈接與動態(tài)鏈接補充(Linux)、什么是動態(tài)鏈接與靜態(tài)鏈接?
編譯運行:
如果運行時報錯:找不到動態(tài)庫??奢斎肴缦旅顚?dǎo)出動態(tài)庫:
export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
具體解釋可查看往期文章:靜態(tài)鏈接與動態(tài)鏈接補充(Linux)
以上就是本次關(guān)于protobuf的分享,本文給出了pc上的實例,感興趣的小伙伴不妨嘗試運用到stm32、嵌入式Linux中,后續(xù)有機會的話再繼續(xù)做相關(guān)分享。
如果覺得文章有用,記得給給小編三連哦
猜你喜歡
mqtt應(yīng)用于進程間通信
自定義協(xié)議的這些典型例子你會了嗎?
例說嵌入式實用知識之JSON數(shù)據(jù)
1024G 嵌入式資源大放送!包括但不限于C/C++、單片機、Linux等。在公眾號聊天界面回復(fù)1024,即可免費獲?。?/span>
免責聲明:本文內(nèi)容由21ic獲得授權(quán)后發(fā)布,版權(quán)歸原作者所有,本平臺僅提供信息存儲服務(wù)。文章僅代表作者個人觀點,不代表本平臺立場,如有問題,請聯(lián)系我們,謝謝!