1. 方案簡(jiǎn)介

方案示意圖

2. 快速上手

如果您初次閱讀此文檔，請(qǐng)閱讀：《入門(mén)指南/源碼管理及編程介紹/源碼工程管理》，按需管理自己工程源碼（注：此文檔必看，并建議采用【遠(yuǎn)程掛載管理】方式，否則有代碼丟失風(fēng)險(xiǎn)?。。。?。

2.1 源碼工程下載

先在PC虛擬機(jī)定位到nfs服務(wù)目錄，再在目錄中創(chuàng)建存放源碼倉(cāng)庫(kù)的管理目錄：

cd ~/nfsroot
mkdir GitHub
cd GitHub

再通過(guò)git工具，在管理目錄內(nèi)克隆遠(yuǎn)程倉(cāng)庫(kù)（需要設(shè)備能對(duì)外網(wǎng)進(jìn)行訪問(wèn)）

git clone https://github.com/EASY-EAI/EASY-EAI-Toolkit-3576.git

注：

* 此處可能會(huì)因網(wǎng)絡(luò)原因造成卡頓，請(qǐng)耐心等待。

* 如果實(shí)在要在gitHub網(wǎng)頁(yè)上下載，也要把整個(gè)倉(cāng)庫(kù)下載下來(lái)，不能單獨(dú)下載本實(shí)例對(duì)應(yīng)的目錄。

2.2 開(kāi)發(fā)環(huán)境搭建

通過(guò)adb shell進(jìn)入板卡開(kāi)發(fā)環(huán)境，如下圖所示。

通過(guò)以下命令，把nfs目錄掛載上nfs服務(wù)器。

mount -t nfs -o nolock : /home/orin-nano/Desktop/nfs/

2.3 例程編譯

然后定位到nfs的掛載目錄，再在目錄中創(chuàng)建存放源碼倉(cāng)庫(kù)的管理目錄：

cd /home/orin-nano/Desktop/nfs/GitHub

進(jìn)入到對(duì)應(yīng)的開(kāi)發(fā)實(shí)例目錄執(zhí)行編譯操作，具體命令如下所示：

cd EASY-EAI-Toolkit-3576/Solutions/rtspMulitPlayer/
./build.sh

2.4 例程運(yùn)行及效果

執(zhí)行下方命令，運(yùn)行示例程序：

./Release/rtspMulitPlayer

執(zhí)行效果如下所示。

3. 設(shè)計(jì)說(shuō)明

本開(kāi)發(fā)實(shí)例由四大邏輯模塊組成，分別是：?jiǎn)?dòng)邏輯、取流解碼邏輯、算法分析邏輯、顯示邏輯。

3.1 邏輯框圖

3.2 數(shù)據(jù)流圖

3.3 代碼組成

本開(kāi)發(fā)實(shí)例相關(guān)的所有代碼，均位于EASY-EAI-Toolkit-3576/Solutions/rtspMulitPlayer/中。其中：

啟動(dòng)邏輯位于：EASY-EAI-Toolkit-3576/Solutions/rtspMulitPlayer/src/main.cpp

取流解碼邏輯位于：EASY-EAI-Toolkit-3576/Solutions/rtspMulitPlayer/src/capturer/

算法分析邏輯位于：EASY-EAI-Toolkit-3576/Solutions/rtspMulitPlayer/src/analyzer/

顯示邏輯位于：EASY-EAI-Toolkit-3576/Solutions/rtspMulitPlayer/src/display/

3.4 調(diào)用關(guān)系

4. 開(kāi)發(fā)指南

4.1 Toolkit倉(cāng)庫(kù)介紹

4.2 示例文件&目錄結(jié)構(gòu)

4.2.1 開(kāi)發(fā)實(shí)例介紹

每個(gè)開(kāi)發(fā)實(shí)例就是一個(gè)獨(dú)立的項(xiàng)目，項(xiàng)目使用cmake構(gòu)建自動(dòng)編譯部署。一個(gè)最簡(jiǎn)單的項(xiàng)目至少要包含以下元素：build.sh、CMakeLists.txt、main.c，如下所示。

具體介紹如下所示。

4.2.2 可拓展的目錄

可拓展的目錄是指：開(kāi)發(fā)過(guò)程中增加某些功能模塊，功能代碼。增加模式分為兩種：

增加已編譯的第三方庫(kù)，在include、libs目錄內(nèi)添加頭文件和庫(kù)文件；

增加用戶自定義的功能模塊，推薦在src目錄內(nèi)增加；

具體情況如下所示，第三方模塊相關(guān)的文件由include/3rd_model/xxx.h、libs/3rd_model/xxx.a。自定義的功能模塊為src/mySrcCode、src/mySrcCode2。

4.3 CMakeLists.txt文件解析

4.3.1 編譯環(huán)境配置部分：

第一部分為配置部分，配置部分如下所示。（獲取當(dāng)前方案目錄、配置工具鏈、提取方案名稱）：

配置信息如下所示。

4.3.2 easyeai-api配置部分

第二部分是引入我司的功能組件庫(kù)（針對(duì)當(dāng)前方案進(jìn)行：配置EASY EAI API頭文件目錄${XXX_INCLUDE_DIRS}、源碼文件目錄${XXX_SOURCE_DIRS}以及所依賴的庫(kù)參數(shù)${XXX_LIBS}）：

配置信息如下所示。

4.3.3 第三方庫(kù)配置部分

第三部分配置第三方的庫(kù)（針對(duì)當(dāng)前方案進(jìn)行：配置第三方頭文件目錄、庫(kù)文件目錄、配置第三方庫(kù)鏈接參數(shù)以及配置源碼目錄）：

配置信息如下所示。

例如添加個(gè)人庫(kù)的目錄組成方式如下所示。

aux_source_directory的修改方式為：

aux_source_directory(./src ./src/mySrcCode ./src/mySrcCode2 dir_srcs)

或

aux_source_directory(./src dir_srcs)
aux_source_directory(./src/mySrcCode dir_srcs)
aux_source_directory(./src/mySrcCode2 dir_srcs)

4.3.4 本方案配置部分

第四部分配置項(xiàng)目的編譯信息，內(nèi)容如下所示：

配置項(xiàng)如下所示。

4.4 build.sh編譯腳本：

4.4.1 路徑定位部分

第一部分用于提取目錄用于編譯操作，內(nèi)容如下所示：（進(jìn)入build.sh腳本所在目錄，并且提取當(dāng)前目錄絕對(duì)路徑，提取當(dāng)前目錄名稱）

4.4.2 清除編譯部分

第二部分清除操作，清除目錄為build、Release，內(nèi)容如下所示：（執(zhí)行build.sh腳本時(shí)，帶入了參數(shù)“clear”，則清空編譯輸出）

4.4.3 編譯操作

第三部分，編譯直接調(diào)用cmake，內(nèi)容如下所示：（重新編譯，成部署目錄，并把資源自動(dòng)部署進(jìn)板卡）

審核編輯 黃宇