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

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
UG1144
Release Date
2026-06-23
Version
2026.1 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.

      *************************************************************************************************************************************************
      The PetaLinux source code and images provided/generated are for demonstration purposes only.
      Please refer to https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/2741928025/Moving+from+PetaLinux+to+Production+Deployment
       for more details
      *************************************************************************************************************************************************
      PetaLinux environment set to '/proj/petalinux/2026.1/petalinux-v2026.1_05181045/tool/petalinux-v2026.1-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 2026.1 PetaLinux Tools Documentation Reference Guide" for its impact and solution
    Figure 1. PetaLinux Deprecation Message
  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.