1. 方案簡介

方案示意圖

2. 快速上手

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

2.1 源碼工程下載

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

cd ~/nfsroot
mkdir GitHub
cd GitHub

再通過git工具，在管理目錄內克隆遠程倉庫（需要設備能對外網進行訪問）

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

注：

* 此處可能會因網絡原因造成卡頓，請耐心等待。

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

2.2 開發環境搭建

通過adb shell進入板卡開發環境，如下圖所示。

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

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

2.3 例程編譯

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

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

進入到對應的開發實例目錄執行編譯操作，具體命令如下所示：

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

2.4 例程運行及效果

執行下方命令，運行示例程序：

./Release/rtspMulitPlayer

執行效果如下所示。

3. 設計說明

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

3.1 邏輯框圖

3.2 數據流圖

3.3 代碼組成

本開發實例相關的所有代碼，均位于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 調用關系

4. 開發指南

4.1 Toolkit倉庫介紹

4.2 示例文件&目錄結構

4.2.1 開發實例介紹

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

具體介紹如下所示。

4.2.2 可拓展的目錄

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

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

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

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

4.3 CMakeLists.txt文件解析

4.3.1 編譯環境配置部分：

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

配置信息如下所示。

4.3.2 easyeai-api配置部分

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

配置信息如下所示。

4.3.3 第三方庫配置部分

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

配置信息如下所示。

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

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

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

配置項如下所示。

4.4 build.sh編譯腳本：

4.4.1 路徑定位部分

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

4.4.2 清除編譯部分

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

4.4.3 編譯操作

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

審核編輯 黃宇