Configuring Project Components - 2023.2 English

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
Release Date
2023.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 AMD drivers or optimizations in the Linux kernel configuration are supported by AMD technical support. For more information on AMD drivers for Linux, see

The following examples 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:
  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

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 (for example, 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).
Tip: Set U-Boot target in petalinux-config menuconfig as required, for your custom board. Set $ petalinux-config > U-Boot Configuration > u-boot config target as required. Default values for AMD evaluation boards are as follows:
  • For Zynq 7000 devices, xilinx_zynq_virt_defconfig
  • For Zynq UltraScale+ MPSoC, xilinx_zynqmp_virt_defconfig
  • For MicroBlaze processors, microblaze-generic_defconfig
  • For Versal devices, xilinx_versal_virt_defconfig
Note: 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/embeddedsw/fsbl-firmware_%.bbappend for FSBL initializations.
YAML_COMPILER_FLAGS:append = " -DXPS_BOARD_ZCU102" #for zcu102
YAML_COMPILER_FLAGS:append = " -DXPS_BOARD_ZCU106" # for zcu106