vitis-ledxor

License	Versioning

LEDXOR with Vitis.

Preprequisites

• 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.

Getting Started

Clone this project and cd into the project root:

git clone https://github.com/extra2000/vitis-ledxor.git
cd vitis-ledxor

Creating Vivado Project

From the project root directory, create contraint file using the following command:

cp -v vivado/src/constrs/artyz7-20.xdc{.example,}

Create project:

cd vivado/run/
flatpak run com.github.corna.Vivado -mode batch -source ../script/create_prj.tcl -notrace -tclargs --project_name ledxor

Then, load the Vivado project:

flatpak run com.github.corna.Vivado -mode gui ./ledxor/ledxor.xpr

Generate XSA file required by Vitis and PetaLinux.

Build PetaLinux

Fix permission issues:

chcon -R -v -t container_file_t ./petalinux ./vivado/run/ledxor
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/ledxor/

Choose EXT4 file system:

• Image Packaging Configuration > Root filesystem type > EXT4.

Execute the following command:

petalinux-config -c kernel

Enable the following options (usually enabled by default):

• Device Drivers > GPIO Support > /sys/class/gpio/... (sysfs interface)
• Device Drivers > GPIO Support > Memory mapped GPIO drivers > Xilinx Zynq GPIO support

Execute the following command:

petalinux-config -c rootfs

Then, set the following configurations:

• Add all packages in Filesystem Packages > libs > boost
• Add all packages in Filesystem Packages > libs > libgpiod
• Add Filesystem Packages > misc > gcc-runtime > libstdc++
• Add Filesystem Packages > misc > packagegroup-core-tools-profile > packagegroup-core-tools-profile
• Add Filesystem Packages > misc > packagegroup-core-tools-profile > packagegroup-core-tools-profile-dbg
• 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

Exit from the container:

exit

Restore ownership:

podman unshare chown -R 0:0 ./petalinux/

Create SD card image.

Creating Vitis Project

cd into ./workspace:

cd workspace

Generate platform:

flatpak run --command=xsct com.github.corna.Vivado ../vitis/platform/arty-z7-20.tcl

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-ledxor.
• Projects:
  • ledxor
  • ledxor_app
  • ledxor_system
  • logger
• Options:
  • Do not copy projects into workspace.

Allow non-root R/W access to /dev/gpiochip0

Create /etc/udev/rules.d/99-gpiod.rules:

SUBSYSTEM=="gpio", KERNEL=="gpiochip0", GROUP="petalinux", MODE="0660"

Reboot.

Autorun LEDXOR app on boot

Copy LEDXOR application from temporary directory into /usr/local/bin/:

sudo mkdir -pv /usr/local/bin
sudo cp -v /run/media/mmcblk0p1/ledxor_app.elf /usr/local/bin/ledxor_app.elf
sudo chmod ugo+rx /usr/local/bin/ledxor_app.elf

Create user's systemd unit directory ~/.config/systemd/user:

mkdir -pv ~/.config/systemd/user

Create ~/.config/systemd/user/ledxor.service with the following content:

[Unit]
Description=LEDXOR Application
After=systemd-user-sessions.service

[Service]
Type=exec
ExecStart=/usr/local/bin/ledxor_app.elf
Restart=on-failure

[Install]
WantedBy=multi-user.target default.target

Reload systemd and enable ledxor.service:

systemctl --user daemon-reload
systemctl --user enable --now ledxor.service

Enable lingering:

sudo loginctl enable-linger ${USER}

Notes: Finding the first pin of EMIO GPIO

In Vivado, "Open Block Design". Customize Zynq7 Processing System. Under "MIO Configuration", choose "Summary Report". The first GPIO pin for EMIO is after MIO pins. For example, ArtyZ7-20 has MIO pins starting from pin 0 to pin 53. Thus, the first EMIO GPIO pin will be at pin 54.