PetaLinux Configuration and Build System Image - 2023.2 English

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
Release Date
2023.2 English

Steps to configure PetaLinux for SD card ext file system boot and build the system image are as follows:

  1. Change to root directory of your PetaLinux project.
    cd <plnx-proj-root>
  2. Launch top level system configuration menu.
  3. Select Image Packaging Configuration > Root file system type.
  4. Select EXT4 (SD/eMMC/SATA/USB) as the root file system type.
    Note: Choose this setting to configure your PetaLinux build for EXT root. By default, it adds the SD/eMMC device name in bootargs. For other devices (SATA/USB), you must change the ext4 device name, as shown in the following examples:
    • eMMC or SD root = /dev/mmcblkYpX
    • SATA or USB root= /dev/sdX
  5. Exit menuconfig and save configuration settings.
    Note: The boot arguments is automatically updated in the <plnx-proj-root>/components/plnx_workspace/device-tree/device-tree/system-conf.dtsi. These changes are reflected only after the build.
  6. Build PetaLinux images. For more information, see Building a System Image.
  7. Generate boot image. For more information, see Generate Boot Image for Zynq UltraScale+ MPSoC.
  8. The generated rootfs.tar.gz file is present in images/linux directory.