Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

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

 

Creating a Project from Vivado Project

Info

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

Note

PetaLinux 17.1 is using one absolute path in "<plnx-proj-root>/project-spec/configs/config
Change path of CONFIG_TMP_DIR_LOCATION variable to your project path "<plnx-proj-root>/build/tmp" manually.

 

  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/"

U-Bootrecipes-bsp/u-boot/files/platform-top.hoverwrite, add UBoot settings
Device Treerecipes-bsp/device-tree/files/system-user.dtsioverwrite, add device tree attributes
Kernelrecipes-kernel/linux/linux-xlnx/changes with "petalinux-config -c kernel" will be add here automatically

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

 

Creating a Project from Vivado Project

Info

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

Note

PetaLinux 16.4 use is using one absolute path in "<plnx-proj-root>/project-spec/configs/config
Change path of CONFIG_TMP_DIR_LOCATION variable to your project path "<plnx-proj-root>/build/tmp" manually.

...

  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).

...

U-Bootrecipes-bsp/u-boot/files/platform-top.hoverwrite, add UBoot settings
Device Treerecipes-dt/device-tree/files/system-top.dtsoverwrite, add device tree attributes
Kernelrecipes-kernel/linux/linux-xlnx/changes with "petalinux-config -c kernel" will be add here automatically

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

 

Creating a Project from Vivado Project

Info

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>/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).

...