Generate Boot Image - Generate Boot Image - 2025.1 English - UG1144

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document_ID
UG1144
Release_Date
2025-05-29
Version
2025.1 English
A boot image usually contains a PDI file (imported from hardware design), PLM, PSM firmware, ArmĀ® trusted firmware, U-Boot, and DTB.

Execute the following command to generate the boot image in .bin format:

petalinux-package boot --u-boot
Note: Specifying --u-boot adds all the required images to boot up to U-Boot into BOOT.BIN.
petalinux-package boot --u-boot
[NOTE] Argument: "--boot" has been deprecated. It is recommended to start using new python command line Argument.
[NOTE] Use: petalinux-package boot [OPTIONS]
[INFO] Getting Default pdi file
[INFO] File in BOOT BIN: "/wrk/everest_fcv_nobkup/PLNX_INTEGRATION_SANITY_NEXT/RTU87_20250413_1676/plnx_tests/build/vck190/bootmodes/wic_build/work/xilinx-vck190-2025.1/project-spec/hw-description/vpl_gen_fixed.pdi"
[INFO] File in BOOT BIN: "/wrk/everest_fcv_nobkup/PLNX_INTEGRATION_SANITY_NEXT/RTU87_20250413_1676/plnx_tests/build/vck190/bootmodes/wic_build/work/xilinx-vck190-2025.1/images/linux/plm.elf"
[INFO] File in BOOT BIN: "/wrk/everest_fcv_nobkup/PLNX_INTEGRATION_SANITY_NEXT/RTU87_20250413_1676/plnx_tests/build/vck190/bootmodes/wic_build/work/xilinx-vck190-2025.1/images/linux/psmfw.elf"
[INFO] File in BOOT BIN: "/wrk/everest_fcv_nobkup/PLNX_INTEGRATION_SANITY_NEXT/RTU87_20250413_1676/plnx_tests/build/vck190/bootmodes/wic_build/work/xilinx-vck190-2025.1/images/linux/system-default.dtb"
[INFO] File in BOOT BIN: "/wrk/everest_fcv_nobkup/PLNX_INTEGRATION_SANITY_NEXT/RTU87_20250413_1676/plnx_tests/build/vck190/bootmodes/wic_build/work/xilinx-vck190-2025.1/images/linux/bl31.elf"
[INFO] File in BOOT BIN: "/wrk/everest_fcv_nobkup/PLNX_INTEGRATION_SANITY_NEXT/RTU87_20250413_1676/plnx_tests/build/vck190/bootmodes/wic_build/work/xilinx-vck190-2025.1/images/linux/u-boot.elf"
[INFO] Generating versal binary package BOOT.BIN...
[INFO]

****** Bootgen v2025.1
  **** Build date : Mar 19 2025-06:26:45
    ** Copyright 1986-2022 Xilinx, Inc. All Rights Reserved.
    ** Copyright 2022-2025 Advanced Micro Devices, Inc. All Rights Reserved.


[INFO]   : Bootimage generated successfully


****** Bootgen v2025.1  **** Build date : Mar 19 2025-06:26:45    ** Copyright 1986-2022 Xilinx, Inc. All Rights Reserved.    ** Copyright 2022-2025 Advanced Micro Devices, Inc. All Rights Reserved.[INFO]   : Bootimage generated successfully[INFO] Generating QEMU boot images...
[INFO] File in qemu_boot.img: /wrk/everest_fcv_nobkup/PLNX_INTEGRATION_SANITY_NEXT/RTU87_20250413_1676/plnx_tests/build/vck190/bootmodes/wic_build/work/xilinx-vck190-2025.1/images/linux/BOOT.BIN
[INFO] File in qemu_boot.img: /wrk/everest_fcv_nobkup/PLNX_INTEGRATION_SANITY_NEXT/RTU87_20250413_1676/plnx_tests/build/vck190/bootmodes/wic_build/work/xilinx-vck190-2025.1/images/linux/boot.scr
[INFO] File in qemu_boot.img: /wrk/everest_fcv_nobkup/PLNX_INTEGRATION_SANITY_NEXT/RTU87_20250413_1676/plnx_tests/build/vck190/bootmodes/wic_build/work/xilinx-vck190-2025.1/images/linux/rootfs.cpio.gz.u-boot
[INFO] Binary is ready.
[INFO] Successfully Generated BIN File
[WARNING] Unable to access the TFTPBOOT folder /tftpboot!!!
[WARNING] Skip file copy to TFTPBOOT folder!!!

This generates BOOT.BIN, BOOT_bh.bin, and qemu_boot.img in the images/linux directory. The default DTB load address is 0x1000. For more information, see Bootgen User Guide (UG1283).

To change the DTB load address, use this command:

petalinux-package boot --plm --psmfw --u-boot --dtb --load <load_address>

This generates a BOOT.BIN with a specified load address for DTB. Ensure that you have also changed the load address for DTB in petalinux-config and the U-Boot menuconfig.

Note: The files versal-qemu-multiarch-pmc.dtb and versal-qemu-multiarch-ps.dtb are QEMU DTBS required to boot multiarch QEMU.

For detailed usage, see the --help option and petalinux-package boot.