petalinux-package --boot Examples - 2023.2 English

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
Release Date
2023.2 English

The following examples demonstrate the correct usage of the petalinux-package --boot command.

  • Create a BOOT.BIN file for an AMD Versal™ device.
    petalinux-package --boot --format BIN --plm --psmfw --u-boot --dtb -o

    It 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).

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

    It generates a BOOT.BIN with a specified load address for DTB.

    Note: The files versal-qemu-multiarch-pmc.dtb and versal-qemu-multiarch-ps.dtb are QEMU DTBs required to boot multi-arch QEMU. Use system.dtb for --dtb option, generated in image/linux/ directory or simply use --dtb option.
  • Create a BOOT.BIN file for an AMD Zynq™ device (including Zynq 7000 and AMD Zynq™ UltraScale+™ MPSoC).
    petalinux-package --boot --format BIN --fsbl <PATH-TO-FSBL> --u-boot -o
  • Create a BOOT.BIN file for a Zynq device that includes a PL bitstream and FITimage.
    petalinux-package --boot --format BIN --fsbl <PATH-TO-FSBL> --u-boot --fpga <PATH-TO-BITSTREAM> --kernel -o <PATH-TO-OUTPUT>
  • Create a x8 SMAP PROM MCS file for a MicroBlaze™ CPU design.
    petalinux-package --boot --format MCS --fsbl <PATH-TO-FSBL> --u-boot --fpga <PATH-TO-BITSTREAM> --flash-size <SIZE> --flash-intf SMAPx8 -o
  • Create a BOOT.BIN file for a Zynq UltraScale+ MPSoC that includes PMU firmware.
    petalinux-package --boot --u-boot --kernel --pmufw <PATH_TO_PMUFW>
  • Create bitstream file download.bit for a MicroBlaze CPU design.
    petalinux-package --boot --format DOWNLOAD.BIT --fpga <BITSTREAM> --fsbl