Building a PetaLinux System Image - 2025.1 English - UG1144

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
UG1144
Release Date
2025-05-29
Version
2025.1 English
  1. Change into the directory of your PetaLinux project.
    cd <plnx-proj-root>
  2. Run petalinux-build to build the system image:
    petalinux-build

    This step generates a device tree DTB file, a first stage boot loader (for Zynq 7000 devices, Zynq UltraScale+ MPSoC, and MicroBlaze), PLM (for Versal adaptive SoC), PSM (for Versal adaptive SoC) and TF-A (for Zynq UltraScale+ MPSoC and Versal adaptive SoC), U-Boot, the Linux kernel, a root file system image, and the U-Boot boot script (boot.scr). Finally, it generates the necessary boot images.

  3. The compilation progress shows on the console. Wait until the compilation finishes.
Tip: A detailed compilation log is in <plnx-proj-root>/build/build.log.

When the build finishes, the generated images are stored in the <plnx-proj-root>/images/linux and /tftpboot directories.

The console shows the compilation progress. For example:

petalinux-build

[INFO] Building project
[INFO] Bitbake is not available, some functionality may be reduced.
[INFO] Using HW file: /wrk/everest_fcv_nobkup/PLNX_DEVTOOL/WDYCD_20250407_813/plnx_tests/build/vck190/plnx_devtool/bsp/modify/work/xilinx-vck190-2025.1/project-spec/hw-description/system-top.dts
[INFO] Getting Platform info from HW file
[INFO] Silentconfig project
[INFO] Silentconfig rootfs
[INFO] Generating configuration files
[INFO] Generating workspace directory
NOTE: Starting bitbake server...
NOTE: Started PRServer with DBfile: /wrk/everest_fcv_nobkup/PLNX_DEVTOOL/WDYCD_20250407_813/plnx_tests/build/vck190/plnx_devtool/bsp/modify/work/xilinx-vck190-2025.1/build/cache/prserv.sqlite3, Address: 127.0.0.1:38667, PID: 2007763
INFO: Specified workspace already set up, leaving as-is
[INFO] bitbake petalinux-image-minimal
NOTE: Started PRServer with DBfile: /wrk/everest_fcv_nobkup/PLNX_DEVTOOL/WDYCD_20250407_813/plnx_tests/build/vck190/plnx_devtool/bsp/modify/work/xilinx-vck190-2025.1/build/cache/prserv.sqlite3, Address: 127.0.0.1:38387, PID: 2034154
Loading cache...done.
Loaded 26600 entries from dependency cache.
Parsing recipes...done.
Parsing of 18600 .bb files complete (18564 cached, 36 parsed). 26640 targets, 13681 skipped, 84 masked, 0 errors.
NOTE: Resolving any missing task queue dependencies
NOTE: Resolving any missing task queue dependencies
NOTE: Resolving any missing task queue dependencies
NOTE: Resolving any missing task queue dependencies
NOTE: Resolving any missing task queue dependencies
NOTE: Resolving any missing task queue dependencies
NOTE: Resolving any missing task queue dependencies
NOTE: Resolving any missing task queue dependencies
NOTE: Resolving any missing task queue dependencies
Initialising tasks...Checking sstate mirror object availability...done.
Sstate summary: Wanted 6375 Local 206 Mirrors 4609 Missed 1560 Current 10 (75% match, 75% complete)
NOTE: Executing Tasks
NOTE: Tasks Summary: Attempted 13948 tasks of which 12127 didn't need to be rerun and all succeeded.
[INFO] Failed to copy built images to tftp dir: /tftpboot
[INFO] Successfully built project