一、下載VITIS-AI的倉庫

單獨git clone很慢，因此先將其匯入到gitee平臺，再執行clone

1. Import VITIS-AI github repo into gitee repo

2. Git clone repo from gitee

二、安裝Docker

參考：https://docs.docker.com/engine/install/ubuntu/，并執行：

1. “Install using the repository”的全部步驟

2. “Install Docker Engine”的 sudo apt-get install docker-ce docker-ce-cli containerd.io

三、修改docker的組態檔

使用國內鏡像（阿里云、網易云....），

sudo gedit /etc/docker/daemon.json

  "registry-mirrors": [

"https://kfwkfulq.mirror.aliyuncs.com",

"https://2lqq34jg.mirror.aliyuncs.com",

"https://pee6w651.mirror.aliyuncs.com",

"https://registry.docker-cn.com",

"http://hub-mirror.c.163.com"

參考：https://blog.oioweb.cn/index.php/archives/1347.html

四、加載重啟docker

$ sudo systemctl daemon-reload

$ sudo systemctl restart docker

五、從docker中下載檔案

sudo docker pull xilinx/vitis-ai:latest

六、Run docker

打開從gitee下載的Vitis-AI檔案路徑

cd Vitis-AI

sudo ./docker_run.sh xilinx/vitis-ai:latest

按照提示操作知道出現logo“VITIS—AI”表示安裝成功，輸入exit退出，

七、下載VITIS-AI tutorial

該倉庫的master分支只有一個Readme.md檔案，其他的例子在其他份分支上：

如果想切換到其他分支（比如Vitis-AI-Custom-Platform），則執行git checkout Vitis-AI-Custom-Platform，

VitisAI(Ultra96v2)平臺教程（GitHub開源 https://github.com/Xilinx/Vitis-AI-Tutorials/tree/Vitis-AI-Custom-Platform）

一、閱讀Vitis-AI-Tutorial檔案中

/files/tutorials/1-Building-a-Vitis-Ultra96V2-and-MIPI-platform.md

1、首先在Vivado中創建MIPI專案，安裝Petalinux工具，其次在ultra96上啟動硬體和軟體鏡像來觀察MIPI視頻，

1.1、將Vitis-AI-Tutorial檔案夾中 reference-files/vivado/sources的sources檔案復制到 build/vivado 路徑下，

1.2、打開Vivado2019.2（后綜合發現vivado2019.2版本不支持mipi IP核，vivado2020.1版本方可支持）

1.3、在build/vivado創建一個新的專案，將其命名為‘ultra96v2_mipi’-----選擇RTL專案-----do not specify sources-----Boards-----Ultra96v2-----Finish，

1.4、在Tcl控制臺視窗打開sources路徑，

1.5、Use the Tcl Console to call `source ./sources/u96v2_mipi.tcl`.

1.6、在Sources標簽中右鍵`u96v2_mipi.bd`然后‘Create HDL Wrapper’，

1.7、添加xdc檔案，從 `build/vivado/sources` 復制`cnst.xdc`檔案到專案約束檔案中，

2、為使用Vitis開發工具設計做準備

打開Vivado工程修改硬體設計為軟體加速做準備，

3、配置平臺介面

3.1、添加ZYNQUltraSCALE IP核，打開“Window”目錄選擇“Platform Interfaces”,

使能下列三個PS從介面，和一個master主介面（如果不做使能配置，直接在ZYNQ GUI界面勾選應該是可以的）

* S_AXI_HP0_FPD

* S_AXI_HP1_FPD

* S_AXI_HP2_FPD

* HPM0_FPD

Platform Interfaces**Options**選項中將三個slave介面的“stpg”值依次設定為: `HP0`, `HP1`, and `HP2`

4、指定平臺時鐘

　　4.1. Double-click the **clk_wiz_0 IP**, and make the following changes in the Output Clocks tab:`[clk_out3=150MHz], [clk_out4=300MHz], [Matched routing selected on clk_out3/4], [Reset Type = Active Low]`

　　4.2. Right-click the block design, select **Add IP**, and add a processor system reset IP for each of the new clocks.

　　4.3 Name the new clocks, `proc_sys_reset_dynamic_1` and `proc_sys_reset_dynamic_2`.

　　4.4 Connect the `clk_out3` and `clk_out4` outputs of `clk_wiz_0` block to `proc_sys_reset_dynamic_1` and `proc_sys_reset_dynamic_2` `slowest_sync_clk` inputs, respectively.

　　4.5 Connect the `ext_reset_in`（proc_sys_rest IP的介面） to `pl_resetn0` on the MPSoC block.

4.6 Connect the "locked" output of the Clock Wizard to the `dcm_locked` port of the processor reset blocks.

　　4.7 確保每個‘proc_sys_reset` 模塊的`ext_reset_in` 與`pl_resetn0` 連接，

4.8 In the Platform Interfaces tab, enable `clk_out3` and `clk_out4` of the `clk_wiz_0` instance.

　　4.9 Set the slower clock (in this case, `clk_out3`) as the default. `clk_out3` should have its id set to 0, and `clk_out4` should have its id set to 1.

　　4.10 Make sure the `proc_sys_reset` block listed in each window is set to the instance that is connected to that clock. Check the properties/options window when each clock is selected in platform interfaces, and verify the proc_sys_reset parameter matches.

5、使能中斷

　　5.1、添加IP核AXI Interrupt Controller命名為“axi_intc_0“，雙擊IP核進行配置，修改為”Edge or Level”和”Single”，點選OK，

5.2、添加IP核Concat命名為”xlconcat_interrup_0”,配置IP埠數為8.

　　5.3、添加IP核Constant，配置值為’0’，連接到interrupt controller，命名為”xlconstant_gnd”，

　　5.4、”Run Connection Automation”，自動連接將AXI Interrupt Controller的從介面連接到PS的”HPM0_LPD”主介面上，將”clk_out1(200MHz)”選擇為所有模塊的時鐘資源，

　　5.5、將”interrupt controller”的輸入與”concat”模塊輸出連接，

　　5.6、將”constant”模塊的輸出與”concat”模塊的第一個輸入連接，then each subsequent concat input to this net，

　　5.7、將”interrupt comtroller”模塊的輸出與PS模塊的”pl_ps_irq0”連接，

6、生成XSA檔案

　　綜合、布局布線、生成bit流，匯出自定制硬體平臺設計；可通過TCL指令或者點選界面執行，

　　source ./sources/xsa.tcl

　　注意：Vivado工程路徑不要太長，此時如果將sources檔案夾放在路徑 ~build/vivado下并且執行sources下的xsa腳本，生成的.xsa檔案會存放在與~build/hw_platform檔案夾下面，

　　創建軟體平臺

　　The software platform requires several changes to the default Petalinux template. Begin by configuring the project to include a meta-layer, which builds in all necessary support for the MIPI mezzanine card and pipeline. Then, finish by adding the necessary Xilinx Runtime (XRT) components into the design.

7、安裝petalinux工具在ubuntu上

　　# 安裝步驟

　　7.1 運行 `bash pre_install.sh`

　　7.2 運行 `bash tftp.sh`

　　7.3 運行

```bash

mkdir /tools/Xilinx/

sudo chown 你的用戶名 /tools/Xilinx

```

　　7.4 運行 `./petalinux-v2020.1-final-installer.run -d /tools/Xilinx`

　　7.5 zyp使用：source /tools/Xilinx/settings.sh 注：每次使用petalinux工具時都要執行settings.sh；

8、定制Petalinux專案（createàconfigàbuildàboot）

　　8.1、在’build/’路徑下打開備用的petalinux工程，

8.2、創建新的帶有zynqMP模板的petalinux工程

　　‘petalinux-create -n petalinux --template zynqMP -t project’

　　8.3、從`reference-files/ petalinux’下復制檔案夾`meta-ultra96v2mipi`，粘貼到’build/ petalinux/ components’路徑下，

　　8.4、更新Petalinux工程（xsa檔案）并且打開初始化配置選單，

　　‘petalinux-config --get-hw-description=../hw_platform`

　　注意：hw_platform檔案夾路徑問題，

　　若出現報錯：將ultra96 路徑下的layer.conf檔案中 thud 改成 zeus.

8.5、主選單中選擇”Subsystem AUTO settings”和目錄下的”Serial Settings”，修改’psu_uart_1’作為primary（原默認psu_uart_0），

8.6、主選單中選擇”DTG Settings”并且設定命名為’avnet-ultra96-rev1’(原來默認template)，

8.7、主選單中選擇”Yocto Settings” à”User Layers”并且添加

　　${PROOT}/components/meta-ultra96v2mipi 作為用戶第一層，然后退出初始化配置選單，

8.8、添加平臺XRT驅動，添加recipes通過拷貝`reference-files/ petalinux`路徑下的`recipes-xrt`檔案到`build/ petalinux/ project-spec/ meta-user`路徑下，

8.9、添加recipes”自動運行”的腳本，保證在root后可自動運行recipes，拷貝路徑’reference-files/petalinux/autostart’ autostart目錄到’build/ petalinux/ project-spec/ meta-user/ recipes-apps’路徑下，

8.10、將上述recipes添加到petalinux鏡像配置中，在[build/ petalinux/ project-spec/ meta-user/ conf/ user-rootfsconfig]檔案中內容添加 [reference-files/ petalinux/ plnxrfscfg.txt]檔案內容，

8.11、打開Petalinux的根檔案系統配置界面去使能上述的recipes

`petalinux-config -c rootfs`然后添加在"User Packages" and "Apps" 的子目錄下的`user-rootfsconfig`檔案，

8.12、在rootfs配置下，under the Petalinux Packge Groups,使能如下選項：

gstreamer、matchbox、opencv、v4lutils、x11，

8.13、退出rootfs配置選單，

9、修改Linux設備樹

9.1、打開檔案`build/ petalinux/ project-spec/ meta-user/ recipes-bsp/ device-tree/ files/ system-user.dtsi`，用`reference-files/ petalinux/ dtfrag.txt`內容替換打開的內容，

　　離線編譯petalinux：官網下載aarch64 sstate-cache和downloads檔案并解壓，存放路徑不要出現空格字符，否則后期編譯會出現錯誤，