petalinux-package --boot Examples - 2021.1 English

PetaLinux Tools Documentation Reference Guide (UG1144)

Document ID
UG1144
Release Date
2021-06-16
Version
2021.1 English

The following examples demonstrate proper 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 will generate 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 will generate 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. You need to use system.dtb for --dtb option, generated in image/linux/ directory or simply use --dtb option it will pick from there.
  • 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>