# vitis_tutorial_zcu102

**Repository Path**: sunhao2020/vitis_tutorial_zcu102

## Basic Information

- **Project Name**: vitis_tutorial_zcu102
- **Description**: This is a tutorial for accelerating the vector addition on ZCU102 with Vitis.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2021-11-22
- **Last Updated**: 2025-08-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Overview
This is a simple tutorial for accelerate application on ZCU102 with Vitis command line.

There three parts to generate the boot sd_card from source files.
1. kernel: generate the *.xclbin from source files. 
    1. compile the files with `v++ -c`. Do HLS(high-level-synthesis) to generate xilinx object files(.xo).
    2. link the *.xo files with `v++ -l`. 
        1. link the IP with Processing system to generate the RTL hardware design block.
        2. run VPL(verilog to placement and routing) with platform information. Do placement and routing on ZCU102
        3. generate the bitstream
        4. package the boot information for configure the FPGA to *.xclbin
2. compile the host dirctory to generate *.exe(execute file)
3. package the related files to sd_card and generate boot image with `v++ -p`.

## Set the compile environment:
```
source /tools/Xilinx/Vivado/2020.2/settings64.sh
source /opt/xilinx/xrt/setup.sh
unset LD_LIBRARY_PATH
export PLATFORM_REPO_PATHS=/home/sunhao/vitis_2020_2/xilinx_platforms/xilinx_zcu102_base_202220_1/
export ROOTFS=/home/sunhao/vitis_2020_2/xilinx-zynqmp-common-v2020.2/
export SYSROOT=/home/sunhao/vitis_2020_2_SDK/sysroots/aarch64-xilinx-linux/
source /home/sunhao/vitis_2020_2_SDK/environment-setup-aarch64-xilinx-linux
```

## Steps on board
1. writing the /package.out/sd_card.img to your sd_card with `balenaEtcher` software (Only for te first time.)
2. copy the files in /package.out/sd_card/ directory to /mnt/sd-mmcblk0p1/ with `scp -P 29 sunhao@10.19.129.51:/home/sunhao/vitis_2020_2/my_vadd_zcu102_tutorial/package/package/sd_card/host.exe /mnt/sd-mmcblk0p1/`
3. reboot the zcu102 to writing the bitstream to PL part of ZCU102
4. go to /mnt/sd-mmcblk0p1 directory, run `./init.sh` to source the executing environmrnt.
5. run `./host.exe kernel.xclbin` to run the accelerated application