Steps to Set Up PetaLinux Working Environment - Steps to Set Up PetaLinux Working Environment - 2025.2 English - UG1144

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
UG1144
Release Date
2025-11-20
Version
2025.2 English
  1. Source the appropriate settings script. PetaLinux can work with any interactive shell, and examples are as follows:
    • For Bash as a user shell:
      source <path-to-installed-PetaLinux>/settings.sh
    • Following is an example of the output when sourcing the setup script for the first time:

      The PetaLinux source code and images provided/generated are for demonstration purposes only. Refer to this linkfor more details.

       *************************************************************************************************************************************************
      PetaLinux environment set to '/proj/petalinux/2025.2/petalinux-v2025.2_11160223/tool/petalinux-v2025.2-final'
      WARNING: /bin/sh is not bash!
      bash is PetaLinux recommended shell. Please set your default shell to bash.
      [WARNING] The PetaLinux toolset is scheduled for deprecation in the 2026.2 release. Users are advised to adopt AMD EDF and its Yocto Project based workflows.
      [WARNING] The Microblaze BSP will be deprecated in version 26.1. PetaLinux Microblaze will be end-of-life in the 2026.2 release. Users are advised to transition to MB-V as the alternative.
      [INFO] Checking free disk space
      [INFO] Checking installed tools
      [INFO] Checking installed development libraries
      [INFO] Checking network and other services
      [WARNING] No tftp server found - please refer to "UG1144 2025.2 PetaLinux Tools Documentation Reference Guide" for its impact and solution
    Figure 1. PetaLinux Deprecation Message
    Warning: The PetaLinux toolset is scheduled for deprecation in the 2026.2 release. Users are advised to adopt AMD EDF and its Yocto Project based workflows.
  2. Verify that the working environment has been set:
    echo $PETALINUX

    Example output: /opt/pkg/petalinux

    Environment variable $PETALINUX should point to the installed PetaLinux path. Based on the PetaLinux installation path, the output can differ from this example.