一. 關(guān)于 AMD Vitis Vision Library

Vitis Vision 庫(kù)是一組 90 多個(gè)內(nèi)核，基于 OpenCV 計(jì)算機(jī)視覺(jué)庫(kù)，針對(duì) AMD FPGA、AMD AI Engine 和 AMD SoC 進(jìn)行了優(yōu)化。 Vitis Vision 庫(kù)中的內(nèi)核在 Vitis 工具套件中進(jìn)行了優(yōu)化和支持。

二.硬件和軟件要求

Vitis Vision 庫(kù)設(shè)計(jì)用于與 AMD Zynq、AMD Zynq Ultrascale+、AMD VCK190和 AMD Alveo FPGA 配合使用。 該庫(kù)已在 zcu102、zcu104、vck190、U50 和 U200 板上經(jīng)過(guò)驗(yàn)證。

必要條件：

有效安裝Vitis 2022.2或更高版本以及相應(yīng)的許可證。

必須安裝Xilinx Runtime (XRT)。 XRT 為 AMD FPGA 提供軟件接口。

安裝 OpenCV-4.4.0 x86 庫(kù)（兼容libjpeg.so）。 x86 庫(kù)必須用于:

a.L1 flow irrespective of target FPGA device being PCIe or embedded.
b.L2/L3 flow when the target device is PCIe based
c.L2/L3 flow when performing software emulation for an embedded platform.
對(duì)于針對(duì)嵌入式平臺(tái)的 L2/L3 Flow（針對(duì)hardware emulation and hardware build），應(yīng)使用 sysroot 中附帶的 aarch32/aarch64 版本 OpenCV。

如果libOpenCL.so不存在，則必須安裝。

安裝 Vitis 2022.2 或更高版本支持該平臺(tái)的卡。

如果針對(duì)嵌入式平臺(tái)，請(qǐng)安裝它并設(shè)置評(píng)估板。

三.OpenCV 安裝指導(dǎo)

建議全新安裝 OpenCV 4.4.0，不要使用系統(tǒng)的現(xiàn)有庫(kù)，因?yàn)樗鼈兛赡苓m用于 Vitis 環(huán)境，也可能不適用于。

請(qǐng)確保更新和升級(jí)系統(tǒng)的軟件包和操作系統(tǒng)庫(kù)，并安裝 cmake 版本>3.5，然后再繼續(xù)。不然可能遇到如下的錯(cuò)誤：

#CMake Error: The source directory "/home/***/Desktop/source/source/build/WITH_V4L=ON" does not exist.

以下步驟可幫助安裝編譯和鏈接 Vitis Vision 主機(jī)代碼中的 OpenCV 調(diào)用所需的基本庫(kù)。

下面是一個(gè)完整的示例，基于 Ubuntu 22.04/bash，在 /home/ycw/Desktop 路徑下操作。

以下為可能會(huì)遇到的問(wèn)題：

Q1: 遇到下面的這個(gè)錯(cuò)誤，可能 cmake 的版本沒(méi)有大于3.5。

CMake Error: The source directory "/home/ycw/Desktop/source/source/build/WITH_V4L=ON" does not exist.

Q2：FATAL: In-source builds are not allowed.

需要安裝上面的步驟 mkdir build文件夾，注意如果已經(jīng)創(chuàng)建了 build 目錄，還是出現(xiàn)這個(gè) FATAL ERROR 注意 cd 回 source 目錄內(nèi)，嘗試使用如下命令清理一下 cache：rm -rf CMakeCache.txt CMakeFiles

Q3：CMAKE_CXX_COMPILER=< path-to-Vitis-installation-directory>.

這里的 path-to-Vitis-installation-directory應(yīng)該設(shè)置成 Vitis_HLS 的路徑。

見(jiàn)上面的完整示例。

五. 兩種platform 的master/vision/L3/examples/isppipeline 的流程

Level 3: Pipeline Applications:
https://github.com/Xilinx/Vitis_Libraries/tree/master/vision/L3#level-3-pipeline-applications

不同設(shè)備和行為流程如下：

實(shí)例：

1. Pcie設(shè)備示例(U50)：

xilinx_u50_gen3x16_xdma_5_202210_1.xpfm的編譯 make 流程：

a. OPENCV_INCLUDE、OPENCV_LIB 指向的是步驟3（OpenCV安裝指導(dǎo)）CMAKE_INSTALL_PREFIX 設(shè)置的目錄內(nèi)。

b. U50 的platform

（xilinx_u50_gen3x16_xdma_5_202210_1.xpfm）

該示例 xilinx_u50_gen3x16_xdma_5_202210_1.xpfm 默認(rèn)部署在下圖的路徑。

c. 示例代碼：

2. Embedded 設(shè)備示例（ZCU102）：

xilinx_zcu102_base_202220_1.xpfm 的編譯 make 流程：

注意點(diǎn)：

a.OPENCV_INCLUDE、OPENCV_LIB指向的是步驟3（OpenCV安裝指導(dǎo)）CMAKE_INSTALL_PREFIX 設(shè)置的目錄內(nèi)。

b. SYSROOT 可以通過(guò)如下的方式獲取：

2.1 在下面的鏈接下載 zynqmp 的 common image :

https://www.xilinx.com/member/forms/download/xef.html?filename=xilinx-zynqmp-common-v2022.2_10141622.tar.gz

2.2 解壓之后，cd 到 common-image 目錄內(nèi)，使用命令（./sdk.sh-y -d ./ -p）安裝 sysroot。該示例安裝完成之后，安裝在下圖顯示的目錄：/home/ycw/Desktop/xilinx-zynqmp-common-v2022.2/sysroots/

c.示例代碼：

六. 板上運(yùn)行

U50 的 HW 運(yùn)行示例：

1. 使用 make run TARGET=hw 運(yùn)行的示例代碼：

注：運(yùn)行之后可以看到在

/home/ycw/Desktop/Vitis_Libraries-2022.2/vision/L3/examples/isppipeline/目錄下生成了 hls_output.png 文件。

2. Build HW 之后生成的 App 運(yùn)行示例：

注：

1. 當(dāng)前在

/home/ycw/Desktop/Vitis_Libraries-2022.2/vision/L3/examples/isppipeline/build_dir.hw.xilinx_u50_gen3x16_xdma_5_202210_1/

路徑內(nèi)，isppipeline 需要帶入輸入圖片的絕對(duì)路徑參數(shù)，這里輸入圖片的路徑是：

/home/ycw/Desktop/Vitis_Libraries-2022.2/vision/L3/examples/isppipeline/input.png

2. 生成的圖片默認(rèn)也在

/home/ycw/Desktop/Vitis_Libraries-2022.2/vision/L3/examples/isppipeline/build_dir.hw.xilinx_u50_gen3x16_xdma_5_202210_1/

路徑內(nèi)。

審核編輯：劉清