1. 方案簡介

方案示意圖

2. 快速上手

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

2.1 源碼工程下載

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

cd ~/nfsroot
mkdir GitHub
cd GitHub

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

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

注：

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

* 如果實在要在gitHub網(wǎng)頁上下載，也要把整個倉庫下載下來，不能單獨下載本實例對應(yīng)的目錄。

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

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

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

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

2.3 例程編譯

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

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

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

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

2.4 例程運行及效果

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

./Release/rtspMulitPlayer

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

3. 設(shè)計說明

本開發(fā)實例由四大邏輯模塊組成，分別是：啟動邏輯、取流解碼邏輯、算法分析邏輯、顯示邏輯。

3.1 邏輯框圖

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

3.3 代碼組成

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

啟動邏輯位于：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. 開發(fā)指南

4.1 Toolkit倉庫介紹

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

4.2.1 開發(fā)實例介紹

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

具體介紹如下所示。

4.2.2 可拓展的目錄

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

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

增加用戶自定義的功能模塊，推薦在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配置部分

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

配置信息如下所示。

4.3.3 第三方庫配置部分

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

配置信息如下所示。

例如添加個人庫的目錄組成方式如下所示。

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 本方案配置部分

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

配置項如下所示。

4.4 build.sh編譯腳本：

4.4.1 路徑定位部分

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

4.4.2 清除編譯部分

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

4.4.3 編譯操作

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

審核編輯 黃宇