Configuring Project Components - 2020.2 English

PetaLinux Tools Documentation Reference Guide (UG1144)

Document ID
Release Date
2020.2 English

If you want to perform advanced PetaLinux project configuration such as enabling Linux kernel options or modifying flash partitions, use the petalinux-config tool with the appropriate -c COMPONENT option.

Important: Only Xilinx® drivers or optimizations in the Linux kernel configuration are supported by Xilinx technical support. For more information on Xilinx drivers for Linux, see

The examples below demonstrate how to use petalinux-config to review or modify your PetaLinux project configuration.

  1. Change into the root directory of your PetaLinux project.
    $ cd <plnx-proj-root>
  2. Launch the top level system configuration menu and configure it to meet your requirements:
    $ petalinux-config
  3. Launch the Linux kernel configuration menu and configure it to meet your requirements:
    $ petalinux-config -c kernel
  4. Launch the root file system configuration menu and configure it to meet your requirements:
    $ petalinux-config -c rootfs
  5. Use --silentconfig for the components when you do not have Kconfig/Menuconfig support or to skip the launching of configuration menu
    $ petalinux-config -c <COMPONENT> --silentconfig
Note: petalinux-config -c <COMPONENT> command creates the workspace directory <plnx-proj-root>/components/yocto/workspace/sources/<COMPONENT> by fetching the source. For example, petalinux-config -c u-boot fetches the U-Boot source and create the workspace in <plnx-proj-root>/components/sources/u-boot-xlnx. You can use this in your development.
Note: Using petalinux-config -c <COMPONENT> the component changes will be stored in workspace directory (<project-root-dir>/components/yocto/workspace). To apply workspace changes to the recipe in the meta-user user must run petalinux-devtool finish command to return their build location, for example, petalinux-devtool finish linux-xlnx <plnx-proj-dir>/project-spec/meta-user.

Warning Message for petalinux-config or petalinux-build Commands

The following warning message appears when you run the petalinux-config or petalinux-build for components (Ex: petalinux-build -c u-boot) and this can be ignored.

WARNING: SRC_URI is conditionally overridden in this recipe, thus several devtool-override-* branches have been created, one for each override that makes changes to SRC_URI. It is recommended that you make changes to the devtool branch first, then checkout and rebase each devtool-override-* branch and update any unique patches there (duplicates on those branches will be ignored by devtool finish/update-recipe).
Note: Please make sure board and user specific dtsi entries are added to project-spec/meta-user/recipes-bsp/device-tree/files/system-user.dtsi.

Using template flow, for zcu102 and zcu106 boards, add the following line to <plnx-proj-root>/project-spec/meta-user/recipes-bsp/fsbl/fsbl_%.bbappend for FSBL initializations.

YAML_COMPILER_FLAGS_append = " -DXPS_BOARD_ZCU102" #for zcu102
YAML_COMPILER_FLAGS_append = " -DXPS_BOARD_ZCU106" # for zcu106