petalinux-package --boot Examples - 2021.2 English

PetaLinux Tools Documentation: Reference Guide

Document ID
UG1144
Release Date
2021-10-27
Version
2021.2 English

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

  • Create a BOOT.BIN file for a Versal® device.
    $ petalinux-package --boot --format BIN --plm --psmfw --u-boot --dtb -o
    <PATH-TO-OUTPUT-WITH-FILE-NAME>

    It generates BOOT.BIN, BOOT_bh.bin, and qemu_boot.img in images/linux directory. The default DTB load address will be 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 a Zynq® device (including Zynq-7000 and Zynq® UltraScale+™ MPSoC).
    $ petalinux-package --boot --format BIN --fsbl <PATH-TO-FSBL> --u-boot -o
    <PATH-TO-OUTPUT-WITH-FILE-NAME>
  • 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
    <PATH-TO-OUTPUT-WITH-FILE-NAME>
  • 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
    <FSBOOT_ELF>