You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 31 Next »

PetaLinux is brand name used by Xilinx, 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.

Table of Content


Petalinux Project Creation- Short HOWTO


Getting Linux working on Zynq is very simple, following steps are required

  1. Vivado/SDK/PetaLinux 20xx.x installed (important do not mix versions!)
  2. Create Vivado Project, configure PS, Export HDF
  3. Ceate new PetaLinux project
  4. Import HDF into project
  5. petalinux-build
  6. copy boot.bin and image.ub to SD Card (only 2 files no more)

This is generic how-to, everything is setup for your by the Vivado->PetaLinux flow. Note, the boot.bin generated by PetaLinux may not always work, in such case it is recommended to make the boot.bin with SDK-GUI or command line tools manually.

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

PetaLinux 2016.4

Description is coming soon.

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:
    • 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 BSP Example from Xilinx Website
      • Install:$ petalinux-create -t project -s <path-to-bsp>
      • Build: $ petalinux-build


Creating a Project from Vivado Project

Some reference designs contains a preconfigured PetaLinux project as template. This can be used instead of creating a new project described on step two.

  1. PetaLinux Working Environment (see UG1144)
    • PetaLinux Tools Installation is completed.
    • "/bin/sh" is bash
    • Set Working Environment:
      • $ source <path-to-installed-PetaLinux>/
    • 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

system-top.dtsDevice tree changes are to be applied here<petalinux-project>/subsystems/linux/configs/device-tree
platform-top.hU-boot changes are to be applied here<petalinux-project>/subsystems/linux/configs/u-boot
fsbl_hooks.cFSBL changes are to be applied hereSDK/HSI FSBL-Template

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

Additional Descriptions


  1. PetaLinux Tools Documentation - Reference Guide (UG1144)
  2. PetaLinux Tools Documentation - PetaLinux Command Line Reference (UG1157)


  • No labels