Generate Boot Image - Generate Boot Image - 2023.1 English - UG1144

PetaLinux Tools Documentation: Reference Guide (UG1144)
Document_ID
UG1144
Release_Date
2023-05-16
Version
2023.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
[INFO] Sourcing buildtools
INFO: File in BOOT BIN: "/wrk/everest_fcv_nobkup/project/release/_zcu102_/xilinx-vck190-2023.1/project-spec/hw-description/vpl_gen_fixed.pdi"
INFO: File in BOOT BIN: "/wrk/everest_fcv_nobkup/project/release/_zcu102_/xilinx-vck190-2023.1/images/linux/plm.elf"
INFO: File in BOOT BIN: "/wrk/everest_fcv_nobkup/project/release/_zcu102_/xilinx-vck190-2023.1/images/linux/psmfw.elf"
INFO: File in BOOT BIN: "/wrk/everest_fcv_nobkup/project/release/_zcu102_/xilinx-vck190-2023.1/images/linux/system-default.dtb"
INFO: File in BOOT BIN: "/wrk/everest_fcv_nobkup/project/release/_zcu102_/xilinx-vck190-2023.1/images/linux/bl31.elf"
INFO: File in BOOT BIN: "/wrk/everest_fcv_nobkup/project/release/_zcu102_/xilinx-vck190-2023.1/images/linux/u-boot.elf"
INFO: Generating versal binary package BOOT.BIN...


****** Bootgen v2023.1
  **** Build date : Feb 16 2023-10:14:28
    ** Copyright 1986-2022 Xilinx, Inc. All Rights Reserved.
    ** Copyright 2022-2023 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/project/release/_zcu102_/xilinx-vck190-2023.1/images/linux/BOOT.BIN
INFO:  File in qemu_boot.img: /wrk/everest_fcv_nobkup/project/release/_zcu102_/xilinx-vck190-2023.1/images/linux/ramdisk.cpio.gz.u-boot
INFO:  File in qemu_boot.img: /wrk/everest_fcv_nobkup/project/release/_zcu102_/xilinx-vck190-2023.1/images/linux/boot.scr
INFO: Binary is ready.
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 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 in the U-Boot menuconfig.

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

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