ZynqMP - ZynqMP - 2026.1 English - UG1144

Prerequisites

ZynqMP flat design(xsa) with PL IPs in bitstream

Build Steps

After creating a PetaLinux project, follow the steps to build and pack the full bitstream and its corresponding dtbo:

1. Source the PetaLinux tool

   source /opt/petalinux/petalinux-v<petalinux-version>-final/settings.sh

2. Create a ZynqMP template project or bsp project

   petalinux-create project -n zynqmp --template zynqmp
   petalinux-create project -s <bsp path> -n zynqmp

3. Go to the project

   cd zynqmp

4. Configure the project with flat xsa if you create project in template flow

    petalinux-config --get-hw-description <flat.xsa>

5. In the petalinux-config command, select FPGA Manager → [*] Fpga Manager.
   Note: The PetaLinux FPGA manager configuration performs the following:

   • fpga-overlay Machine features

   • Enables the required kernel configs to load the fpgamanager driver
6. Use the petalinux-create command to extract the full bitstream and its corresponding pl dtbo into the PetaLinux rootfs.

    petalinux-create apps --template dfx_dtg_zynqmp_full -n can-interface --srcuri "<path-to-xsa>/system.xsa" --enable

   Note: If you do not specify --enable the dtbo and its bitstream is generated in <project>/build/tmp/deploy directory.
7. To build as part of rootfs you can use the following commands:

   petalinux-build
   petalinux-build -c rootfs

   To build only the application:

   petalinux-build -c can-interface 

Boot Steps

Once the base target is up, run the following command:

fpgautil -o /lib/firmware/can interface/pl.dtbo -b /lib/firmware/xilinx/can interface/design_1_wrapper.bit.bin