Creating the HSDP-enabled Linux Image Using PetaLinux - Creating the HSDP-enabled Linux Image Using PetaLinux - 2026.1 English - UG1305

Versal Adaptive SoC Embedded Design Tutorial (UG1305)

Document ID
UG1305
Release Date
2026-06-23
Version
2026.1 English

This example rebuilds the PetaLinux project using the HSDP-enabled XSA that was built in the preceding step. The assumption is that the PetaLinux project has been created as per the instructions in System Design Example using Scalar Engine and Adaptable Engine.

Important

If you are building this tutorial without having created a PetaLinux project in the preceding chapter, follow steps 1 through 12 in the Example Project: Creating Linux Images Using PetaLinux section to create a new PetaLinux project.

This example needs a Linux host machine. Refer to the PetaLinux Tools Documentation Reference Guide [UG1144] for information on dependencies and installation procedure for the PetaLinux tool.

  1. Change to the PetaLinux project directory that was created in Example Project: Creating Linux Images Using PetaLinux using the following command.

    $ cd led_example
    
  2. Copy the new hardware platform project XSA to the Linux host machine one directory above the PetaLinux build root.

    Note

    Make sure that you are using the updated the XSA file which you generated in the prior step.

  3. Reconfigure the BSP using the following commands.

    $ petalinux-config --get-hw-description=<path till the directory containing the respective xsa file>
    
  4. Build the Linux images using the following command.

    $ petalinux-build
    
  5. Once the build completes, package the boot images with the following command:

    $ petalinux-package --force --boot --atf --u-boot
    

    Note

    The packaged Linux boot images are located in the <petaLinux-project>/images/Linux/ directory in the PetaLinux build root. Make a note of this directory location as it will be used in the following steps. If you intend to use a different machine than the one that was used to build PetaLinux (for example, a Windows Based PC) to download the Linux boot images using SmartLynq+, the contents of this directory should be transferred to that machine before proceeding with this tutorial.