PetaLinux is brand name used by

AMD , it is based on Yocto and pretty decent mainstream kernel, what Petalinux adds is the HSI (Hardware Software Interface from Vivado) and special tools for boot image creation.

Online version of this manual and other related documents can be found at https://wiki.trenz-electronic.de/display/PD/PetaLinux+KICKstart

Table of Content

PetaLinux 2022.2

PetaLinux Installation

• (optional) Create new VM with supported Linux OS.

  • Attention: Use English as OS language for your Linux System (Keyboard language can be any language). Other languages may cause errors on PetaLinux build process.

    • with OracleVM:

      • VM Setup:

        • RAM: >= 8GB

        • CPU:  >= 4

        • HDD: 200GB dynanically

          • ubuntu-20.04-desktop-amd64.iso

          • install vm guest additions

        • Network: network bridge

        • optional: add shared folder, enable drag and drop

      • 
        

        Info
        title Alternative to Oracle VM
        AMD Tools and Win10 WSL

        
        

• Download PetaLinux  from Xilinx Website: http://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html

  • Choose  a PetaLinux Version, that's corresponding to the installed Vivado and SDK Version.

    • Example: Use Vitis (SDK+Vivado) 2021.2 with PetaLinux 2021.2

• Use UG1144 "PetaLinux Tools Documentation - Reference Guide" that's corresponding with your PetaLinux Version

  1. Use bash as terminal:

     1. $ sudo dpkg-reconfigure dash 

        1. → press no

  2. Check "PetaLinux Tools Installation Requirements" chapter and install missing tool/libraries

     1.  https://www.xilinx.com/support/answers/73296.html

        1. download plnx-env-setup.sh and run

     2. $ sudo apt-get update

     3. $ sudo apt-get install iproute2 gawk python3 python build-essential gcc git make net-tools libncurses5-dev tftpd zlib1g-dev libssl-dev flex bison libselinux1 gnupg wget git-core diffstat chrpath socat xterm autoconf libtool tar unzip texinfo zlib1g-dev gcc-multilib automake zlib1g:i386 screen pax gzip cpio python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev pylint3 -y

        1. This is necessary because lnx-env-setup.sh seems to be not install all packages correctly

  3. Install petalinux (Note: do not start from shared folder, copy installer into home directory)

     1. $ mkdir -p ~/petalinux/2022.2

     2. copy  petalinux-v2022.2-final-installer.run into ~/petalinux/2022.2

     3. $ ./petalinux-v2020.2-final-installer.run

  4. source enviroment

     1. $ source ~/petalinux/2022.2/settings.sh

  5. Deactivate Webtalk:

     1. $ petalinux-util --webtalk off

• Note:

  • There is no need to install anything else, or to fetch anything from any github repos, etc.

  • It is recommended to test the installation by creating a dummy template project and building it.

    • Download one of the BSP Examples from Xilinx Website (Only to test your installation)

    • Install:$ petalinux-create -t project -s <path-to-bsp>

    • Build: $ petalinux-build

Creating a Project from Vivado Project

1. PetaLinux Working Environment (see UG1144)
   • PetaLinux Tools Installation is completed.
   • (Note: do not create project from shared folder, use home directory)

   • "/bin/sh" is bash

   • Set Working Environment:
     • $ source <path-to-installed-PetaLinux>/settings.sh
2. (optional to create project from scretch instead of Trenz Templates) Create a New Project (see UG1144): 
   

   1. $ petalinux-create --type project --template <CPU_TYPE> --name <PROJECT_NAME>

      • <CPU_TYPE>: zynqMP, zynq, microblaze
      • <PROJECT_NAME>:The name of the project you are building
3. Import Hardware Configuration (see UG1144):
   • Export Hardware Definition File (*.xsa) from the Vivado Project into the PetaLinux root folder "<plnx-proj-root>":
     • change to PetaLinux root folder:
     • Run:$ petalinux-config --get-hw-description
4. (optional) Configure your PetaLinux:
   • While anywhere in the project folder tree:
   • Run:$ petalinux-config
   • Run:$ petalinux-config -c u-boot
   • Run:$ petalinux-config -c kernel
   • Run:$ petalinux-config -c rootfs
5. Build System Image (see UG1144):
   • While anywhere in the project folder tree:
   • Run:$ petalinux-build
6. Generate Boot.bin with Vitis tools (recommended)
   1. Take u-boot.elf,  image.ub,  bl31.elf (ZynqMP only) from "<plnx-proj-root>/images/linux" for BOOT.BIN generation, also boot.scr is used (put separate on SD or include into Boot.bin for QSPI boot only).  It is recommended to create the FSBL and PMU Firmware (ZynqMP only) with Vitis tools.
7. Generate Boot.bin with Petalinux
   1. Run:$ petalinux-package --boot <command options>
      
   2. https://docs.xilinx.com/r/en-US/ug1144-petalinux-tools-reference-guide/petalinux-package-boot

Petalinux Configuration

Use local sstate cache and downlods

• Download (https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html):
  • aarch64 sstate-cache
    • for Versal, U+Zynq, RFSoC projects
  • arm sstate-cache
    • for 7 series Zynq projects
  •  mbfull sstate-cache 
    • for microblaze full projects
  •  mblite sstate-cache
    • for microblaze lite projects
  • Downloads 
    • forall types
• extract files for example in
  • mkdir ~/design/sstate-cache
  • cd ~/design/sstate-cache
  • copy archives into this folder
  • tar -xfv sstate_aarch64_2022.2_10071807.tar.gz
  • tar -xfv sstate_arm_2022.2_10071807.tar.gz
  • tar -xfv sstate_microblaze_2022.2_10071807.tar.gz
  • mkdir ~/design/sstate-cache/downloads_2022.2
  • cd ~/design/sstate-cache/downloads_2022.2
  • copy archives into this folder
  • tar -xfv downloads_2022.2_10071807.tar.gz
  • delete archive files
• change to the petalinux project
  • petalinux-config
    • for sstate-cache
      • -> Yocto Settings->Local sstate feeds settings->local sstate feeds url
        • ~/design/sstate-cache/sstate_aarch64_20222/aarch64
        • ~/design/sstate-cache/sstate_aarch64_2022.2/arm
        • ~/design/sstate-cache/sstate_aarch64_2022.2/mb-full
        • original: http://petalinux.xilinx.com/sswreleases/rel-v${PETALINUX_MAJOR_VER}/aarch64/sstate-cache
    • for downloads
      • -> Yocto Settings-> Add pre-mirror url
        • file://~/design/sstate-cache/downloads_2021.2/downloads
        • orginal:http://petalinux.xilinx.com/sswreleases/rel-v${PETALINUX_MAJOR_VER}/downloads
• Clear petalinux project
  • petalinux-build -x mrproper

Configuration menues and files

Most settings can be changed with menu-config:

• $  petalinux-config
• $  petalinux-config -c u-boot
• $  petalinux-config -c kernel
• $  petalinux-config -c rootfs

Manual changes can be done in the subfolder "<plnx-proj-root>/project-spec/meta-user/"

PetaLinux 2021.2

PetaLinux Installation

• (optional) Create new VM with supported Linux OS.

  • Attention: Use English as OS language for your Linux System (Keyboard language can be any language). Other languages may cause errors on PetaLinux build process.

    • with OracleVM:

      • VM Setup:

        • RAM: >= 8GB

        • CPU:  >= 4

        • HDD: 200GB dynanically

          • ubuntu-20.04-desktop-amd64.iso

          • install vm guest additions

        • Network: network bridge

        • optional: add shared folder, enable drag and drop

      • 
        

        Info
        title Alternative to Oracle VM
        AMD Tools and Win10 WSL

        
        

• Download PetaLinux  from Xilinx Website: http://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html

  • Choose  a PetaLinux Version, that's corresponding to the installed Vivado and SDK Version.

    • Example: Use Vitis (SDK+Vivado) 2021.2 with PetaLinux 2021.2

• Use UG1144 "PetaLinux Tools Documentation - Reference Guide" that's corresponding with your PetaLinux Version

  1. Use bash as terminal:

     1. $ sudo dpkg-reconfigure dash 

        1. → press no

  2. Check "PetaLinux Tools Installation Requirements" chapter and install missing tool/libraries

     1.  https://www.xilinx.com/support/answers/73296.html

        1. download plnx-env-setup.sh and run

     2. $ sudo apt-get update

     3. $ sudo apt-get install iproute2 gawk python3 python build-essential gcc git make net-tools libncurses5-dev tftpd zlib1g-dev libssl-dev flex bison libselinux1 gnupg wget git-core diffstat chrpath socat xterm autoconf libtool tar unzip texinfo zlib1g-dev gcc-multilib automake zlib1g:i386 screen pax gzip cpio python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev pylint3 -y

        1. This is necessary because lnx-env-setup.sh seems to be not install all packages correctly

  3. Install petalinux (Note: do not start from shared folder, copy installer into home directory)

     1. $ mkdir -p ~/petalinux/2021.2

     2. copy  petalinux-v2021.2-final-installer.run into ~/petalinux/2021.2

     3. $ ./petalinux-v2020.2-final-installer.run

  4. source enviroment

     1. $ source ~/petalinux/2021.2/settings.sh

  5. Deactivate Webtalk:

     1. $ petalinux-util --webtalk off

• Note:

  • There is no need to install anything else, or to fetch anything from any github repos, etc.

  • It is recommended to test the installation by creating a dummy template project and building it.

    • Download one of the BSP Examples from Xilinx Website (Only to test your installation)

    • Install:$ petalinux-create -t project -s <path-to-bsp>

    • Build: $ petalinux-build

Creating a Project from Vivado Project

1. PetaLinux Working Environment (see UG1144)
   • PetaLinux Tools Installation is completed.
   • (Note: do not create project from shared folder, use home directory)

   • "/bin/sh" is bash

   • Set Working Environment:
     • $ source <path-to-installed-PetaLinux>/settings.sh
2. (optional to create project from scretch instead of Trenz Templates) Create a New Project (see UG1144): 
   

   1. $ petalinux-create --type project --template <CPU_TYPE> --name <PROJECT_NAME>

      • <CPU_TYPE>: zynqMP, zynq, microblaze
      • <PROJECT_NAME>:The name of the project you are building
3. Import Hardware Configuration (see UG1144):
   • Export Hardware Definition File (*.xsa) from the Vivado Project into the PetaLinux root folder "<plnx-proj-root>":
     • change to PetaLinux root folder:
     • Run:$ petalinux-config --get-hw-description
4. (optional) Configure your PetaLinux:
   • While anywhere in the project folder tree:
   • Run:$ petalinux-config
   • Run:$ petalinux-config -c u-boot
   • Run:$ petalinux-config -c kernel
   • Run:$ petalinux-config -c rootfs
5. Build System Image (see UG1144):
   • While anywhere in the project folder tree:
   • Run:$ petalinux-build
6. Take u-boot.elf,  image.ub,  bl31.elf (ZynqMP only) from "<plnx-proj-root>/images/linux" for BOOT.BIN generation, also boot.scr is used (put separate on SD or include into Boot.bin for QSPI boot only).  It is recommended to create the FSBL and PMU Firmware (ZynqMP only) with Vitis tools.

Petalinux Configuration

Use local sstate cache and downlods

• Download (https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html):
  • aarch64 sstate-cache
    • for Versal, U+Zynq, RFSoC projects
  • arm sstate-cache
    • for 7 series Zynq projects
  •  mbfull sstate-cache 
    • for microblaze full projects
  •  mblite sstate-cache
    • for microblaze lite projects
  • Downloads 
    • forall types
• extract files for example in
  • mkdir ~/design/sstate-cache
  • cd ~/design/sstate-cache
  • copy archives into this folder
  • tar -xfv sstate_aarch64_2021.2.tar.gz
  • tar -xfv sstate_arm_2021.2.tar.gz
  • tar -xfv sstate_mb-full_2021.2.tar.gz
  • tar -xfv sstate_mb-lite_2021.2.tar.gz
  • mkdir ~/design/sstate-cache/downloads_2021.2
  • cd ~/design/sstate-cache/downloads_2021.2
  • copy archives into this folder
  • tar -xfv downloads_2021.2.tar.gz
  • delete archive files
• change to the petalinux project
  • petalinux-config
    • for sstate-cache
      • -> Yocto Settings->Local sstate feeds settings->local sstate feeds url
        • ~/design/sstate-cache/sstate_aarch64_2021.2/aarch64
        • ~/design/sstate-cache/sstate_aarch64_2021.2/arm
        • ~/design/sstate-cache/sstate_aarch64_2021.2/mb-full
        • ~/design/sstate-cache/sstate_aarch64_2021.2/mb-lite
        • original: http://petalinux.xilinx.com/sswreleases/rel-v${PETALINUX_MAJOR_VER}/aarch64/sstate-cache
    • for downloads
      • -> Yocto Settings-> Add pre-mirror url
        • file://~/design/sstate-cache/downloads_2021.2/downloads
        • orginal:http://petalinux.xilinx.com/sswreleases/rel-v${PETALINUX_MAJOR_VER}/downloads
• Clear petalinux project
  • petalinux-build -x mrproper

Configuration menues and files

Most settings can be changed with menu-config:

• $  petalinux-config
• $  petalinux-config -c u-boot
• $  petalinux-config -c kernel
• $  petalinux-config -c rootfs

Manual changes can be done in the subfolder "<plnx-proj-root>/project-spec/meta-user/"

PetaLinux 2020.2

PetaLinux Installation

• (optional) Create new VM with supported Linux OS.

  • Attention: Use English as OS language for your Linux System (Keyboard language can be any language). Other languages may cause errors on PetaLinux build process.

    • with OracleVM:

      • VM Setup:

        • RAM: >= 8GB

        • CPU:  >= 4

        • HDD: 200GB dynanically

          • ubuntu-18.04-desktop-amd64.iso

          • install vm guest additions

          • update to 18.04.5 was done

        • Network: network bridge

        • optional: add shared folder, enable drag and drop

      • 
        

        Info
        title Alternative to Oracle VM
        AMD Tools and Win10 WSL

        
        

• Download PetaLinux  from Xilinx Website: http://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html

  • Choose  a PetaLinux Version, that's corresponding to the installed Vivado and SDK Version.

    • Example: Use Vitis (SDK+Vivado)

• • • 2021.2 with PetaLinux 2020.2

• Use UG1144 "PetaLinux Tools Documentation - Reference Guide" that's corresponding with your PetaLinux Version

  1. Use bash as terminal:

     1. $ sudo dpkg-reconfigure dash 

        1. → press no

  2. Check "PetaLinux Tools Installation Requirements" chapter and install missing tool/libraries

     1.  https://www.xilinx.com/support/answers/73296.html

        1. download plnx-env-setup.sh and run

     2. $ sudo apt-get update

     3. $ sudo apt-get install iproute2 gawk python3 python build-essential gcc git make net-tools libncurses5-dev tftpd zlib1g-dev libssl-dev flex bison libselinux1 gnupg wget git-core diffstat chrpath socat xterm autoconf libtool tar unzip texinfo zlib1g-dev gcc-multilib automake zlib1g:i386 screen pax gzip cpio python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev pylint3 -y

        1. This is necessary because lnx-env-setup.sh seems to be not install all packages correctly

  3. Install petalinux (Note: do not start from shared folder, copy installer into home directory)

     1. $ mkdir -p ~/petalinux/2020.2

     2. copy  petalinux-v2020.2-final-installer.run into ~/petalinux/2020.2

     3. $ ./petalinux-v2020.2-final-installer.run

  4. source enviroment

     1. $ source ~/petalinux/2020.2/settings.sh

  5. Deactivate Webtalk:

     1. $ petalinux-util --webtalk off

• Note:

  • There is no need to install anything else, or to fetch anything from any github repos, etc.

  • It is recommended to test the installation by creating a dummy template project and building it.

    • Download one of the BSP Examples from Xilinx Website (Only to test your installation)

    • Install:$ petalinux-create -t project -s <path-to-bsp>

    • Build: $ petalinux-build

Creating a Project from Vivado Project

1. PetaLinux Working Environment (see UG1144)
   • PetaLinux Tools Installation is completed.
   • (Note: do not create project from shared folder, use home directory)

   • "/bin/sh" is bash

   • Set Working Environment:
     • $ source <path-to-installed-PetaLinux>/settings.sh
2. (optional to create project from scretch instead of Trenz Templates) Create a New Project (see UG1144): 
   

   1. $ petalinux-create --type project --template <CPU_TYPE> --name <PROJECT_NAME>

      • <CPU_TYPE>: zynqMP, zynq, microblaze
      • <PROJECT_NAME>:The name of the project you are building
3. Import Hardware Configuration (see UG1144):
   • Export Hardware Definition File (*.xsa) from the Vivado Project into the PetaLinux root folder "<plnx-proj-root>":
     • change to PetaLinux root folder:
     • Run:$ petalinux-config --get-hw-description
4. (optional) Configure your PetaLinux:
   • While anywhere in the project folder tree:
   • Run:$ petalinux-config
   • Run:$ petalinux-config -c u-boot
   • Run:$ petalinux-config -c kernel
   • Run:$ petalinux-config -c rootfs
5. Build System Image (see UG1144):
   • While anywhere in the project folder tree:
   • Run:$ petalinux-build
6. Take u-boot.elf,  image.ub,  bl31.elf (ZynqMP only) from "<plnx-proj-root>/images/linux" for BOOT.BIN generation, also boot.scr is used (put separate on SD or include into Boot.bin for QSPI boot only).  It is recommended to create the FSBL and PMU Firmware (ZynqMP only) with Vitis tools.

Petalinux Configuration

Most settings can be changed with menu-config*:

• $  petalinux-config
• $  petalinux-config -c u-boot
• $  petalinux-config -c kernel
• $  petalinux-config -c rootfs

* with 2020.2 kernel and u-boot changes must be exported to the user-layer with petalinux-devtool command.

Manual changes can be done in the subfolder "<plnx-proj-root>/project-spec/meta-user/"

PetaLinux 2019.2

PetaLinux Installation

• (optional) Create new VM with supported Linux OS.
  
  • Attention: Use English as OS language for your Linux System (Keyboard language can be any language). Other languages may cause errors on PetaLinux build process.
    • with OracleVM:
      • VM Setup:
        • RAM: >= 8GB
        • CPU:  >= 4
        • HDD: 200GB dynanically
          • ubuntu-18.04-desktop-amd64.iso
          • install vm guest additions
        • Network: network bridge
        • optional: add shared folder, enable drag and drop
• Download PetaLinux  from Xilinx Website: http://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html
  • Choose  a PetaLinux Version, that's corresponding to the installed Vivado and SDK Version.
    • Example: Use Vitis (SDK+Vivado) 2019.2 with PetaLinux 2019.2
• Use UG1144 "PetaLinux Tools Documentation - Reference Guide" that's corresponding with your PetaLinux Version
  
  1. Use bash as terminal:
     1. $ sudo dpkg-reconfigure dash 
        1. → press no
  2. Check "PetaLinux Tools Installation Requirements" chapter and install missing tool/libraries
     1. $ sudo apt-get update
     2. $ sudo apt-get install tofrodos iproute2 gawk make net-tools libncurses5-dev tftpd zlib1g:i386 libssl-dev flex bison libselinux1 gnupg wget diffstat chrpath socat xterm autoconf libtool tar unzip texinfo zlib1g-dev gcc-multilib build-essential screen pax gzip python 2.7.5 -y
  3. Change owner of installation directory to non root

     1. $ sudo chown <owner>:<owner> /opt/

  4. Install petalinux (Note: do not start from shared folder, copy installer into home directory)
     
     1. $ mkdir -p /opt/pkg/petalinux/2019.2
     2. $ ./petalinux-v2019.2-final-installer.run /opt/pkg/petalinux/2019.2
  5. source enviroment
     1. $ source /opt/pkg/petalinux/2019.2/settings.sh
  6. Deactivate Webtalk:
     1. $ petalinux-util --webtalk off
• Note:
  
  • There is no need to install anything else, or to fetch anything from any github repos, etc.
  • It is recommended to test the installation by creating a dummy template project and building it.
    • Download one of the BSP Examples from Xilinx Website (Only to test your installation)
    • Install:$ petalinux-create -t project -s <path-to-bsp>
    • Build: $ petalinux-build

Creating a Project from Vivado Project

1. PetaLinux Working Environment (see UG1144)
   • PetaLinux Tools Installation is completed.
   • (Note: do not create project from shared folder, use home directory)

   • "/bin/sh" is bash

   • Set Working Environment:
     • $ source <path-to-installed-PetaLinux>/settings.sh
2. (optional to create project from scretch instead of Trenz Templates) Create a New Project (see UG1144): 
   

   1. $ petalinux-create --type project --template <CPU_TYPE> --name <PROJECT_NAME>

      • <CPU_TYPE>: zynqMP, zynq, microblaze
      • <PROJECT_NAME>:The name of the project you are building
3. Import Hardware Configuration (see UG1144):
   • Export Hardware Definition File (*.xsa) from the Vivado Project into the PetaLinux root folder "<plnx-proj-root>":
     • change to PetaLinux root folder:
     • Run:$ petalinux-config --get-hw-description
4. (optional) Configure your PetaLinux:
   • While anywhere in the project folder tree:
   • Run:$ petalinux-config
   • Run:$ petalinux-config -c u-boot
   • Run:$ petalinux-config -c kernel
   • Run:$ petalinux-config -c rootfs
5. Build System Image (see UG1144):
   • While anywhere in the project folder tree:
   • Run:$ petalinux-build
6. Take u-boot.elf,  image.ub,  bl31.elf (ZynqMP only) from "<plnx-proj-root>/images/linux" for BOOT.BIN generation.  It is recommended to create the FSBL and PMU Firmware (ZynqMP only) with Vitis tools.

Petalinux Configuration

Most settings can be changed with menu-config:

• $  petalinux-config
• $  petalinux-config -c u-boot
• $  petalinux-config -c kernel
• $  petalinux-config -c rootfs

Manual changes can be done in the subfolder "<plnx-proj-root>/project-spec/meta-user/"

PetaLinux 2018.3

PetaLinux Installation

• (optional) Create new VM with supported Linux OS.
  
  • Attention: Use English as OS language for your Linux System (Keyboard language can be any language). Other languages may cause errors on PetaLinux build process.
• Download PetaLinux  from Xilinx Website: http://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html
  • Choose  a PetaLinux Version, that's corresponding to the installed Vivado and SDK Version.
    • Example: Use Vivado 2018.3 with SDK 2018.3 and PetaLinux 2018.3
• Use UG1144 "PetaLinux Tools Documentation - Reference Guide" that's corresponding with your PetaLinux Version
  
  1. Change owner of installation directory to non root (see Troubleshoot page)
  2. Check "PetaLinux Tools Installation Requirements" chapter and install missing tool/libraries
  3. Use installation instructions from chapter "PetaLinux Tools Installation Steps"
  4. Deactivate Webtalk: $ petalinux-util --webtalk off
  5. See also Petalinux Troubleshoot#Petalinux2018.3
• Note:
  
  • There is no need to install anything else, or to fetch anything from any github repos, etc.
  • It is recommended to test the installation by creating a dummy template project and building it.
    • Download one of the BSP Examples from Xilinx Website (Only to test your installation)
    • Install:$ petalinux-create -t project -s <path-to-bsp>
    • Build: $ petalinux-build

Creating a Project from Vivado Project

1. PetaLinux Working Environment (see UG1144)
   • PetaLinux Tools Installation is completed.

   • "/bin/sh" is bash

   • Set Working Environment:
     • $ source <path-to-installed-PetaLinux>/settings.sh
2. Create a New Project (see UG1144):

   • $ petalinux-create --type project --template <CPU_TYPE> --name <PROJECT_NAME>

     • <CPU_TYPE>: zynqMP, zynq, microblaze
     • <PROJECT_NAME>:The name of the project you are building
3. Import Hardware Configuration (see UG1144):
   • Export Hardware Definition File (*.hdf) from the Vivado Project into the PetaLinux root folder "<plnx-proj-root>":
     • change to PetaLinux root folder:
     • Run:$ petalinux-config --get-hw-description
4. (optional) Configure your PetaLinux:
   • While anywhere in the project folder tree:
   • Run:$ petalinux-config
   • Run:$ petalinux-config -c u-boot
   • Run:$ petalinux-config -c kernel
   • Run:$ petalinux-config -c rootfs
5. Build System Image (see UG1144):
   • While anywhere in the project folder tree:
   • Run:$ petalinux-build
6. Take u-boot.elf,  image.ub,  bl31.elf (ZynqMP only) from "<plnx-proj-root>/images/linux" and make BOOT.BIN.  It is recommended to create the FSBL and PMU Firmware (ZynqMP only) with SDK/HSI tools.

Petalinux Configuration

Most settings can be changed with menu-config:

• $  petalinux-config
• $  petalinux-config -c u-boot
• $  petalinux-config -c kernel
• $  petalinux-config -c rootfs

Manual changes can be done in the subfolder "<plnx-proj-root>/project-spec/meta-user/"

PetaLinux 2018.2

PetaLinux Installation

• (optional) Create new VM with supported Linux OS.
  
  • Attention: Use English as OS language for your Linux System (Keyboard language can be any language). Other languages may cause errors on PetaLinux build process.
• Download PetaLinux  from Xilinx Website: http://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html
  • Choose  a PetaLinux Version, that's corresponding to the installed Vivado and SDK Version.
    • Example: Use Vivado 2018.2 with SDK 2018.2 and PetaLinux 2018.2
• Use UG1144 "PetaLinux Tools Documentation - Reference Guide" that's corresponding with your PetaLinux Version
  
  1. Change owner of installation directory to non root (see Troubleshoot page)
  2. Check "PetaLinux Tools Installation Requirements" chapter and install missing tool/libraries
  3. Use installation instructions from chapter "PetaLinux Tools Installation Steps"
  4. Deactivate Webtalk: $ petalinux-util --webtalk off
  5. See also Petalinux Troubleshoot - Petalinux2018.2
• Note:
  
  • There is no need to install anything else, or to fetch anything from any github repos, etc.
  • It is recommended to test the installation by creating a dummy template project and building it.
    • Download one of the BSP Examples from Xilinx Website (Only to test your installation)
    • Install:$ petalinux-create -t project -s <path-to-bsp>
    • Build: $ petalinux-build

Creating a Project from Vivado Project

1. PetaLinux Working Environment (see UG1144)
   • PetaLinux Tools Installation is completed.

   • "/bin/sh" is bash

   • Set Working Environment:
     • $ source <path-to-installed-PetaLinux>/settings.sh
2. Create a New Project (see UG1144):

   • $ petalinux-create --type project --template <CPU_TYPE> --name <PROJECT_NAME>

     • <CPU_TYPE>: zynqMP, zynq, microblaze
     • <PROJECT_NAME>:The name of the project you are building
3. Import Hardware Configuration (see UG1144):
   • Export Hardware Definition File (*.hdf) from the Vivado Project into the PetaLinux root folder "<plnx-proj-root>":
     • change to PetaLinux root folder:
     • Run:$ petalinux-config --get-hw-description
4. (optional) Configure your PetaLinux:
   • While anywhere in the project folder tree:
   • Run:$ petalinux-config
   • Run:$ petalinux-config -c kernel
   • Run:$ petalinux-config -c rootfs
5. Build System Image (see UG1144):
   • While anywhere in the project folder tree:
   • Run:$ petalinux-build
6. Take u-boot.elf,  image.ub,  bl31.elf (ZynqMP only) from "<plnx-proj-root>/images/linux" and make BOOT.BIN.  It is recommended to create the FSBL and PMU Firmware (ZynqMP only) with SDK/HSI tools.

Petalinux Configuration

Most settings can be changed with menu-config ($ petalinux-config, petalinux-config -c kernel, petalinux-config -c rootfs).

Manual changes can be done in the subfolder "<plnx-proj-root>/project-spec/meta-user/"

PetaLinux 2017.4

PetaLinux Installation

• (optional) Create new VM with supported Linux OS.
  
  • Attention: Use English as OS language for your Linux System (Keyboard language can be any language). Other languages may cause errors on PetaLinux build process.
• Download PetaLinux  from Xilinx Website: http://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html
  • Choose  a PetaLinux Version, that's corresponding to the installed Vivado and SDK Version.
    • Example: Use Vivado 2017.4 with SDK 2017.4 and PetaLinux 2017.4
• Use UG1144 "PetaLinux Tools Documentation - Reference Guide" that's corresponding with your PetaLinux Version
  
  1. Change owner of installation directory to non root (see Troubleshoot page)
  2. Check "PetaLinux Tools Installation Requirements" chapter and install missing tool/libraries
  3. Use installation instructions from chapter "PetaLinux Tools Installation Steps"
  4. Deactivate Webtalk: $ petalinux-util --webtalk off
  5. See also Petalinux Troubleshoot - Petalinux2017.4
• Note:
  
  • There is no need to install anything else, or to fetch anything from any github repos, etc.
  • It is recommended to test the installation by creating a dummy template project and building it.
    • Download one of the BSP Examples from Xilinx Website (Only to test your installation)
    • Install:$ petalinux-create -t project -s <path-to-bsp>
    • Build: $ petalinux-build

Creating a Project from Vivado Project

1. PetaLinux Working Environment (see UG1144)
   • PetaLinux Tools Installation is completed.

   • "/bin/sh" is bash

   • Set Working Environment:
     • $ source <path-to-installed-PetaLinux>/settings.sh
2. Create a New Project (see UG1144):

   • $ petalinux-create --type project --template <CPU_TYPE> --name <PROJECT_NAME>

     • <CPU_TYPE>: zynqMP, zynq, microblaze
     • <PROJECT_NAME>:The name of the project you are building
3. Import Hardware Configuration (see UG1144):
   • Export Hardware Definition File (*.hdf) from the Vivado Project into the PetaLinux root folder "<plnx-proj-root>":
     • change to PetaLinux root folder:
     • Run:$ petalinux-config --get-hw-description
4. (optional) Configure your PetaLinux:
   • While anywhere in the project folder tree:
   • Run:$ petalinux-config
   • Run:$ petalinux-config -c kernel
   • Run:$ petalinux-config -c rootfs
5. Build System Image (see UG1144):
   • While anywhere in the project folder tree:
   • Run:$ petalinux-build
6. Take u-boot.elf,  image.ub,  bl31.elf (ZynqMP only) from "<plnx-proj-root>/images/linux" and make BOOT.BIN.  It is recommended to create the FSBL and PMU Firmware (ZynqMP only) with SDK/HSI tools.
7. Note: uboot need also boot.scr from the  "<plnx-proj-root>/images/linux" folder. This can be put on SD card or must be included into Boot.bin for QSPI boot without SD usage.

Petalinux Configuration

Most settings can be changed with menu-config ($ petalinux-config, petalinux-config -c kernel, petalinux-config -c rootfs).

Manual changes can be done in the subfolder "<plnx-proj-root>/project-spec/meta-user/"

PetaLinux 2017.2

PetaLinux Installation

• (optional) Create new VM with supported Linux OS.
  
  • Attention: Use English as OS language for your Linux System (Keyboard language can be any language). Other languages may cause errors on PetaLinux build process.
• Download PetaLinux  from Xilinx Website: http://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html
  • Choose  a PetaLinux Version, that's corresponding to the installed Vivado and SDK Version.
    • Example: Use Vivado 2017.2 with SDK 2017.2 and PetaLinux 2017.2
• Use UG1144 "PetaLinux Tools Documentation - Reference Guide" that's corresponding with your PetaLinux Version
  
  1. Change owner of installation directory to non root (see Troubleshoot page)
  2. Check "PetaLinux Tools Installation Requirements" chapter and install missing tool/libraries
  3. Use installation instructions from chapter "PetaLinux Tools Installation Steps"
  4. See Troubleshoot Petalinux2017.2
• Note:
  
  • There is no need to install anything else, or to fetch anything from any github repos, etc.
  • It is recommended to test the installation by creating a dummy template project and building it.
    • Download one of the BSP Examples from Xilinx Website (Only to test your installation)
    • Install:$ petalinux-create -t project -s <path-to-bsp>
    • Build: $ petalinux-build

Creating a Project from Vivado Project

1. PetaLinux Working Environment (see UG1144)
   • PetaLinux Tools Installation is completed.
   • "/bin/sh" is bash
   • Set Working Environment:
     • $ source <path-to-installed-PetaLinux>/settings.sh
2. Create a New Project (see UG1144):
   • $ petalinux-create --type project --template <CPU_TYPE> --name <PROJECT_NAME>
     • <CPU_TYPE>: zynqMP, zynq, microblaze
     • <PROJECT_NAME>:The name of the project you are building
3. Import Hardware Configuration (see UG1144):
   • Export Hardware Definition File (*.hdf) from the Vivado Project into the PetaLinux root folder "<plnx-proj-root>":
     • change to PetaLinux root folder:
     • Run:$ petalinux-config --get-hw-description
4. (optional) Configure your PetaLinux:
   • While anywhere in the project folder tree:
   • Run:$ petalinux-config
   • Run:$ petalinux-config -c kernel
   • Run:$ petalinux-config -c rootfs
5. Build System Image (see UG1144):
   • While anywhere in the project folder tree:
   • Run:$ petalinux-build
6. Take u-boot.elf,  image.ub,  bl31.elf (ZynqMP only) from "<plnx-proj-root>/images/linux" and make BOOT.BIN.  It is recommended to create the FSBL and PMU Firmware (ZynqMP only) with SDK/HSI tools.

Petalinux Configuration

Most settings can be changed with menu-config ($ petalinux-config, petalinux-config -c kernel, petalinux-config -c rootfs).

Manual changes can be done in the subfolder "<plnx-proj-root>/project-spec/meta-user/"

PetaLinux 2017.1

PetaLinux Installation

• (optional) Create new VM with supported Linux OS.
  
  • Attention: Use English as OS language for your Linux System (Keyboard language can be any language). Other languages may cause errors on PetaLinux build process.
• Download PetaLinux  from Xilinx Website: http://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html
  • Choose  a PetaLinux Version, that's corresponding to the installed Vivado and SDK Version.
    • Example: Use Vivado 2017.1 with SDK 2017.1 and PetaLinux 2017.1
• Use UG1144 "PetaLinux Tools Documentation - Reference Guide" that's corresponding with your PetaLinux Version
  
  1. Check "PetaLinux Tools Installation Requirements" chapter and install missing tool/libraries
  2. Use installation instructions from chapter "PetaLinux Tools Installation Steps"
  3. See Troubleshoot Petalinux2017.1
• Note:
  
  • There is no need to install anything else, or to fetch anything from any github repos, etc.
  • It is recommended to test the installation by creating a dummy template project and building it.
    • Download one of the BSP Examples from Xilinx Website (Only to test your installation)
    • Install:$ petalinux-create -t project -s <path-to-bsp>
    • Build: $ petalinux-build

Creating a Project from Vivado Project

1. PetaLinux Working Environment (see UG1144)
   • PetaLinux Tools Installation is completed.
   • "/bin/sh" is bash
   • Set Working Environment:
     • $ source <path-to-installed-PetaLinux>/settings.sh
2. Create a New Project (see UG1144):
   • $ petalinux-create --type project --template <CPU_TYPE> --name <PROJECT_NAME>
     • <CPU_TYPE>: zynqMP, zynq, microblaze
     • <PROJECT_NAME>:The name of the project you are building
3. Import Hardware Configuration (see UG1144):
   • Export Hardware Definition File (*.hdf) from the Vivado Project into the PetaLinux root folder "<plnx-proj-root>":
     • change to PetaLinux root folder:
     • Run:$ petalinux-config --get-hw-description
4. (optional) Configure your PetaLinux:
   • While anywhere in the project folder tree:
   • Run:$ petalinux-config
   • Run:$ petalinux-config -c kernel
   • Run:$ petalinux-config -c rootfs
5. Build System Image (see UG1144):
   • While anywhere in the project folder tree:
   • Run:$ petalinux-build
6. Take u-boot.elf,  image.ub,  bl31.elf (ZynqMP only) and pmufw.elf (ZynqMP only) from "<plnx-proj-root>/images/linux" and make BOOT.BIN.  It is recommended to create the FSBL with SDK/HSI tools.

Petalinux Configuration

Most settings can be changed with menu-config ($ petalinux-config, petalinux-config -c kernel, petalinux-config -c rootfs).

Manual changes can be done in the subfolder "<plnx-proj-root>/project-spec/meta-user/"

PetaLinux 2016.4

PetaLinux Installation

• (optional) Create new VM with supported Linux OS.
  
  • Attention: Use English as OS language for your Linux System (Keyboard language can be any language). Other languages may cause errors on PetaLinux build process.
• Download PetaLinux  from Xilinx Website: http://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html
  • Choose  a PetaLinux Version, that's corresponding to the installed Vivado and SDK Version.
    • Example: Use Vivado 2016.4 with SDK 2016.4 and PetaLinux 2016.4
• Use UG1144 "PetaLinux Tools Documentation - Reference Guide" that's corresponding with your PetaLinux Version
  
  1. Check "PetaLinux Tools Installation Requirements" chapter and install missing tool/libraries
  2. Use installation instructions from chapter "PetaLinux Tools Installation Steps"
  3. See Troubleshoot Petalinux2016.4
• Note:
  
  • There is no need to install anything else, or to fetch anything from any github repos, etc.
  • It is recommended to test the installation by creating a dummy template project and building it.
    • Download one of the BSP Examples from Xilinx Website (Only to test your installation)
    • Install:$ petalinux-create -t project -s <path-to-bsp>
    • Build: $ petalinux-build

Creating a Project from Vivado Project

1. PetaLinux Working Environment (see UG1144)
   • PetaLinux Tools Installation is completed.
   • "/bin/sh" is bash
   • Set Working Environment:
     • $ source <path-to-installed-PetaLinux>/settings.sh
2. Create a New Project (see UG1144):
   • $ petalinux-create --type project --template <CPU_TYPE> --name <PROJECT_NAME>
     • <CPU_TYPE>: zynqMP, zynq, microblaze
     • <PROJECT_NAME>:The name of the project you are building
3. Import Hardware Configuration (see UG1144):
   • Export Hardware Definition File (*.hdf) from the Vivado Project into the PetaLinux root folder "<plnx-proj-root>":
     • change to PetaLinux root folder:
     • Run:$ petalinux-config --get-hw-description
4. (optional) Configure your PetaLinux:
   • While anywhere in the project folder tree:
   • Run:$ petalinux-config
   • Run:$ petalinux-config -c kernel
   • Run:$ petalinux-config -c rootfs
5. Build System Image (see UG1144):
   • While anywhere in the project folder tree:
   • Run:$ petalinux-build
6. Take u-boot.elf,  image.ub and bl31.elf (zynqMP only) from "<plnx-proj-root>/images/linux" and make BOOT.BIN.  It is recommended to create the FSBL with SDK/HSI tools.

Petalinux Configuration

Most settings can be changed with menu-config ($ petalinux-config, petalinux-config -c kernel, petalinux-config -c rootfs).

Manual changes can be done in the subfolder "<plnx-proj-root>/project-spec/meta-user/"

PetaLinux 2016.2

PetaLinux Installation

• (optional) Create new VM with supported Linux OS.
  
  • Attention: Use English as OS language for your Linux System (Keyboard language can be any language). Other languages may cause errors on PetaLinux build process.
• Download PetaLinux  from Xilinx Website: http://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html
  • Choose  a PetaLinux Version, that's corresponding to the installed Vivado and SDK Version.
    • Example: Use Vivado 2016.2 with SDK 2016.2 and PetaLinux 2016.2
• Use UG1144 "PetaLinux Tools Documentation - Reference Guide" that's corresponding with your PetaLinux Version
  
  1. Check "PetaLinux Tools Installation Requirements" chapter and install missing tool/libraries
  2. Use installation instructions from chapter "PetaLinux Tools Installation Steps"
  3. Additional packages for PetaLinux 2016.2 + MicroBlaze projects:
  • • $ sudo apt-get install libc6-i386 lib32stdc++6 lib32gcc1 lib32ncurses5 lib32z1
• Note:
  
  • There is no need to install anything else, or to fetch anything from any github repos, etc.
  • It is recommended to test the installation by creating a dummy template project and building it.
    • Download one of the BSP Examples from Xilinx Website (Only to test your installation)
    • Install:$ petalinux-create -t project -s <path-to-bsp>
    • Build: $ petalinux-build

Creating a Project from Vivado Project

1. PetaLinux Working Environment (see UG1144)
   • PetaLinux Tools Installation is completed.
   • "/bin/sh" is bash
   • Set Working Environment:
     • $ source <path-to-installed-PetaLinux>/settings.sh
   • Set cross compiler:
     • $ export CROSS_COMPILE=arm-xilinx-linux-gnueabi-
     • $ export ARCH=arm
2. Create a New Project (see UG1144):
   • $ petalinux-create --type project --template <CPU_TYPE> --name <PROJECT_NAME>
     • <CPU_TYPE>: zynqMP, zynq, microblaze
     • <PROJECT_NAME>:The name of the project you are building
3. Import Hardware Configuration (see UG1144):
   • Export Hardware Definition File (*.hdf) from the Vivado Project into the PetaLinux subfolder "<plnx-proj-root>/hw-description":
     • change to the hardware description folder:
     • Run:$ petalinux-config --get-hw-description
4. (optional) Configure your PetaLinux:
   • While anywhere in the project folder tree:
   • Run:$ petalinux-config
     • It's recommended to deactivate FSBL-Configuration and build FSBL and Boot.bin with SDK/HSI: "linux Components Selection --->" "[ ] First Stage Bootloader
   • Run:$ petalinux-config -c kernel
   • Run:$ petalinux-config -c rootfs
5. Build System Image (see UG1144):
   • While anywhere in the project folder tree:
   • Run:$ petalinux-build
   • Build log-file:"<plnx-proj-root>/build/build.log"
6. Take u-boot.elf and image.ub from "<plnx-proj-root>/images/linux" and make BOOT.BIN.  It is recommended to create the FSBL with SDK/HSI tools.

Petalinux Configuration

Most settings can be changed with menu-config ($ petalinux-config).

There are 3 more files that user can edit, they are

There should be no reason to modify any other files by editing them (most of them are generated and would be overwritten).