Create a PetaLinux Project - 2025.2 English - XD101

Setup PetaLinux environment

source <petaLinux_tool_install_dir>/settings.sh

Create a PetaLinux project named vck190_petalinux and configure the hw option with the XSA file:

cd workspace
petalinux-create --type project --template versal --name vck190_petalinux
cd vck190_petalinux
petalinux-config --get-hw-description=xilinx_vck190_base_202520_1/hw/hw.xsa  # After you extract the base platform, you can find hw.xsa or hw_emu.xsa under <xilinx_vck190_base_202520_1> directory. If you want to do emulation you can choose hw_emu.xsa 

Note: --template option specifies the chipset. vck190 board adopts the Versal™ series chip. Therefore, we specify this option as versal.

Note: PetaLinux will use XSA to generate the device tree. Since hardware XSA and hardware emulation XSA have identical peripherals, providing either of them to PetaLinux is acceptable. When simplifying the hardware design for hardware emulation, it is recommended to keep all the peripherals that need device tree and drivers so that the auto-generated device tree can be reused. If the two designs have different addressable peripherals, you will need to create two sets of device trees for hardware running and hardware emulation, separately.

A petalinux-config menu is launched. Set it to use VCK190 device tree in the configuration window.

• Select DTG Settings->MACHINE_NAME

• Modify it to vck190-versal.

• Select OK -> Exit -> Exit -> Yes to close this window.

Note:

• If you are using an AMD development board, it is recommended to modify the machine name so that the board configurations would be involved in the DTS auto-generation. You can check the UG1144 document for the corresponding machine name.

• If you are using a custom board, you would need to configure the associated settings (e.g. the PHY information DTS node) in system-user.dtsi manually.

• Device tree is a generic technology in embedded Linux. Search on Google for more information.