1. 方案簡介

方案接線示意圖

2. 快速上手

2.1 開發(fā)環(huán)境準(zhǔn)備

如果您初次閱讀此文檔，請閱讀《入門指南/開發(fā)環(huán)境準(zhǔn)備/Easy-Eai編譯環(huán)境準(zhǔn)備與更新》，并按照其相關(guān)的操作，進(jìn)行編譯環(huán)境的部署。

在PC端Ubuntu系統(tǒng)中執(zhí)行run腳本，進(jìn)入EASY-EAI編譯環(huán)境，具體如下所示。

cd ~/develop_environment ./run.sh 2204

2.2 源碼下載以及例程編譯

在EASY-EAI編譯環(huán)境下創(chuàng)建存放源碼倉庫的管理目錄：

cd /opt mkdir EASY-EAI-Toolkit cd EASY-EAI-Toolkit

通過git工具，在管理目錄內(nèi)克隆遠(yuǎn)程倉庫

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

注：

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

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

進(jìn)入到對應(yīng)的例程目錄執(zhí)行編譯操作，具體命令如下所示：

cd EASY-EAI-Toolkit-1126B/Solutions/rtspMulitPlayer ./build.sh cpres

注：

* 由于依賴庫部署在板卡上，因此交叉編譯過程中必須保持/mnt掛載。

* 若build.sh腳本帶有cpres參數(shù)，則會(huì)把Release/目錄下的所有資源都拷貝到開發(fā)板上。

2.3 例程運(yùn)行

通過串口調(diào)試或ssh調(diào)試，進(jìn)入板卡后臺，定位到例程部署的位置，如下所示：

cd /userdata/Solu/rtspMulitPlayer

運(yùn)行例程命令，后臺打印如下所示。

./rtspMulitPlayer

屏幕顯示內(nèi)容如下所示：

若屏幕顯示【無視頻信號】，請到src/main.cpp確認(rèn)：

屏幕顯示邏輯：

若要調(diào)整顯示輪詢時(shí)間，請到src/analyzer/analyzer.cpp中的imgDisplay_thread(...)修改：

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

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

3.1 邏輯框圖

線程資源分布：

* 取流解碼邏輯xN

* 算法分析邏輯x1

* 顯示邏輯x1

* 總線程數(shù)=N+1+1

3.2 代碼組成

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

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

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

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

顯示邏輯位于：EASY-EAI-Toolkit-1126B/Solutions/rtspMulitPlayer/src/analyzer/

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

3.4 開發(fā)建議

用戶想要做算法識別，建議【僅修改】以下【兩個(gè)文件】：

EASY-EAI-Toolkit-1126B/Solutions/rtspMulitPlayer/src/analyzer/algoProcess.cpp

EASY-EAI-Toolkit-1126B/Solutions/rtspMulitPlayer/src/analyzer/algoProcess.h

代碼中注釋了一個(gè)【人員識別】的樣例：①把注釋放開。②把【對應(yīng)模型】放到與本開發(fā)實(shí)例的【可執(zhí)行文件】所在的【開發(fā)板目錄】。即可實(shí)現(xiàn)人員識別功能。

效果如下所示：

模型的下載，以及單步的demo使用參考，可閱讀《EASY-EAI-Toolkit/算法組件/人員檢測》

想要接入其它算法，可用同樣方法參考其它的算法組件的使用文檔。

4. 開發(fā)指南

4.1 Toolkit倉庫介紹

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

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

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

具體介紹如下所示。

4.2.2 可拓展的目錄

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

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

l 增加用戶自定義的功能模塊，推薦在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)前方案進(jìn)行：配置EASY EAI API頭文件目錄${XXX_INCLUDE_DIRS}、源碼文件目錄${XXX_SOURCE_DIRS}以及所依賴的庫參數(shù)${XXX_LIBS}）：

4.3.3 第三方庫配置部分

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

配置信息如下所示。

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

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)前目錄絕對路徑，提取當(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)板卡）