License | Versioning |
---|---|
C++ Data Structure with Vitis.
- Host: GNU/Linux only
- Container: Podman
3.4.7
and above. Make sure to configure for rootless. - Target board:
digilentinc.com:arty-z7-20:part0:1.1
. - Vivado 2022.1 and above installed via Flatpak.
- petalinux-builder v1.2.0.
Clone this project and cd
into the project root:
git clone https://github.com/extra2000/vitis-cpp-datastruct.git
cd vitis-cpp-datastruct
From the project root directory, execute the following command:
cd vivado/run/
flatpak run com.github.corna.Vivado -mode batch -source ../script/create_prj.tcl -notrace -tclargs --project_name cpp-datastruct
Then, load the Vivado project:
flatpak run com.github.corna.Vivado -mode gui ./cpp-datastruct/cpp-datastruct.xpr
Generate XSA file required by Vitis and PetaLinux.
Fix permission issues:
chcon -R -v -t container_file_t ./petalinux ./vivado/run/cpp-datastruct
podman unshare chown -R 1000:1000 ./petalinux
Create project:
podman run -it --rm -v ${PWD}/petalinux:${PWD}/petalinux:rw --workdir ${PWD}/petalinux --security-opt label=type:petalinux_builder.process localhost/extra2000/petalinux-builder:latest
petalinux-create --type project --template zynq --name arty-z7-20
chmod -R og+rw ./arty-z7-20/.petalinux/
exit
Initialize project:
podman run -it --rm -v ${PWD}/vivado:${PWD}/vivado:ro -v ${PWD}/petalinux:${PWD}/petalinux:rw --workdir ${PWD}/petalinux/arty-z7-20 --security-opt label=type:petalinux_builder.process localhost/extra2000/petalinux-builder:latest
petalinux-config --get-hw-description ../../vivado/run/cpp-datastruct/
Choose EXT4
file system:
Image Packaging Configuration
>Root filesystem type
>EXT4
.
Execute the following command:
petalinux-config -c rootfs
Then, set the following configurations:
- All packages in
Filesystem Packages
>libs
>boost
Filesystem Packages
>misc
>gcc-runtime
>libstdc++
Filesystem Packages
>misc
>packagegroup-core-tools-profile
>packagegroup-core-tools-profile
Filesystem Packages
>misc
>packagegroup-core-tools-profile
>packagegroup-core-tools-profile-dbg
- Disable
Filesystem Packages
>misc
>packagegroup-core-ssh-dropbear
>packagegroup-core-ssh-dropbear
- Disable
Image Features
>ssh-server-dropbear
- Enable
Image Features
>ssh-server-openssh
- Enable
Image Features
>package-management
- Disable
Image Features
>package-management
>package-feed-uris
- Disable
Image Features
>package-management
>package-feed-archs
- Set
Image Features
>Init-manager
>systemd
Build project:
petalinux-build
petalinux-build --sdk
petalinux-package --sysroot
petalinux-package --boot --fsbl ./images/linux/zynq_fsbl.elf --fpga ./images/linux/system.bit --u-boot
Build for QEMU (optional but may be useful for testing and development):
petalinux-package --wic
petalinux-package --prebuilt --fpga ./images/linux/system.bit -a images/linux/image.ub:images/image.ub
chmod og+rw ./pre-built/linux/images/petalinux-sdimage.wic
NOTE: If the following sudo
file has permission denied during the petalinux-package --prebuilt
command, try fix the permission by executing the following command from host:
sudo chmod u+rw,og+r ./petalinux/arty-z7-20/images/linux/sdk/sysroots/cortexa9t2hf-neon-xilinx-linux-gnueabi/usr/bin/sudo
Exit from the container:
exit
Create SD card image.
Spawn a Petalinux container with host
networking:
podman run -it --rm --network host -v ${PWD}/vivado:${PWD}/vivado:ro -v ${PWD}/petalinux:${PWD}/petalinux:rw --workdir ${PWD}/petalinux/arty-z7-20 --security-opt label=type:petalinux_builder.process localhost/extra2000/petalinux-builder
Start QEMU which binds TCF Agent port 1534
for Vitis development in later Section:
petalinux-boot --qemu --prebuilt 3 --qemu-args "-net nic,netdev=eth0 -netdev user,id=eth0,hostfwd=tcp:127.0.0.1:1534-:1534 -net nic"
Later, Vitis will expect a directory /run/media/mmcblk0p1
to be existed in PetaLinux. For unknown reason, TCF Agent doesn't automatically create /run/media/mmcblk0p1
in PetaLinux 2022.1. To fix this issue, execute the following commands on PetaLinux:
sudo mkdir -pv /run/media/mmcblk0p1
NOTE: The default SSH username for Petalinux is petalinux
.
To shutdown QEMU, execute the following command:
poweroff
After QEMU has halted, terminate QEMU console with CTRL + A
and then type X
.
Ensure host has full access to applications:
podman unshare chown -R 0:0 ./petalinux/arty-z7-20/project-spec/meta-user/recipes-apps
podman unshare chown -R 0:0 ./petalinux/arty-z7-20/project-spec/meta-user/conf/user-rootfsconfig
Clone applications:
git clone https://github.com/extra2000/datastruct-cpp.git ./petalinux/arty-z7-20/project-spec/meta-user/recipes-apps/datastruct-cpp
Build the application into RPM files:
petalinux-build -c datastruct-cpp
Upload the RPM files petalinux/arty-z7-20/build/tmp/deploy/rpm/cortexa9t2hf_neon/datastruct-cpp-*.rpm
to the board and then install the application using dnf
command:
sudo dnf install ./datastruct-cpp-*.rpm
To uninstall the application:
sudo dnf remove datastruct-cpp{,-dbg,-dev,-lic,-src}
Restore host's ownership for Petalinux images files. This is required for Vitis to create project:
podman unshare chown -R 0:0 ./petalinux/arty-z7-20/images
From the project root directory, cd
into petalinux/arty-z7-20/project-spec/meta-user/recipes-apps/datastruct-cpp/files
:
cd ./petalinux/arty-z7-20/project-spec/meta-user/recipes-apps/datastruct-cpp/files
Generate platform:
flatpak run --command=xsct com.github.corna.Vivado ./scripts/arty-z7-20.tcl
From the project root directory, cd
into ./workspace
:
cd ./workspace
Launch Vitis:
flatpak run --command=vitis com.github.corna.Vivado -workspace .
Then, Import Projects
> Eclipse workspace or zip file
:
- Select root directory:
/path/to/vitis-cpp-datastruct/petalinux/arty-z7-20/project-spec/meta-user/recipes-apps/datastruct-cpp
. - Check all projects.
- Options:
- Do not copy projects into workspace.
Uploading shared library by executing xsct
command from this project root directory (Warning: May conflict with datastruct-cpp-1.0-r0.0.cortexa9t2hf_neon.rpm
):
flatpak run --command=xsct com.github.corna.Vivado
connect -host 127.0.0.1 -port 1534
tfile copy -from-host ./vitis/logger/Debug/liblogger.so /usr/lib/liblogger.so
disconnect
exit
- Microsoft Windows 11 with Ubuntu 22.04 LTS WSL2: Building with Vitis doesn't work. We don't know how to prevent Vitis from creating paths that mixed with forward ("
/
") and backward ("\
") slash.