petalinux-package --boot Command Options - 2021.2 English

PetaLinux Tools Documentation: Reference Guide

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

The following table details the options that are valid when creating a bootable image with the petalinux-package --boot command:

Table 1. petalinux-package --boot Command Options
Option Functional Description Value Range Default Value
--format FORMAT Image file format to generate. This is optional.
  • BIN
  • MCS
  • DOWNLOAD.BIT
BIN
--fsbl FSBL Path on disk to FSBL elf binary. This is required. To skip loading FSBL, use --fsbl no or --fsbl none. This is optional. User-specified
  • zynqmp_fsbl.elf for Zynq® UltraScale+™ MPSoC
  • zynq_fsbl.elf for Zynq-7000 device
  • fs-boot.elf for MicroBlaze™ processor

The default image is in <plnx-proj-root>/images/linux.

--force Overwrite existing files on disk. This is optional. None None
--fpga BITSTREAM 1 Path on disk to bitstream file. This is optional. User-specified <plnx-proj-root>/images/linux/system.bit
--atf TF-A-IMG Path on disk to Arm® trusted firmware elf binary. This is optional. To skip loading TF-A, use --atf no or --atf none User-specified <plnx-proj-root>/images/linux/bl31.elf
--u-boot UBOOT-IMG Path on disk to U-Boot binary. This is optional. User-specified
  • u-boot.elf for Zynq device
  • u-boot-s.bin for MicroBlaze CPUs

The default image is in <plnx-proj-root>/images/linux

--kernel KERNEL-IMG Path on disk to Linux kernel image. This is optional. User-specified <plnx-proj-root>/images/linux/image.ub
--boot-script BOOT-SCRIPT Path to the boot.scr file location. This is optional. User-specified <plnx-proj-root>/images/linux/boot.scr
--qemu-rootfs ROOTFS-CPIO-FILE Path to the rootfs file location to create qemu_boot.img (cpio.gz.u-boot). Only valid for the Versal ACAP to generate the QEMU SD image. User specified <plnx-proj-root>/images/linux/rootfs.cpio.gz.u-boot
--pmufw PMUFW-ELF Optional and applicable only for Zynq® UltraScale+™ MPSoC. By default, prebuilt PMU firmware image is packed. Use this option to either specify a path for PMU firmware image or to skip packing of PMU firmware. To skip packing PMU firmware, use --pmufw no. User-specified <plnx-proj-root>/images/linux/pmufw.elf
--plm PLM-ELF Optional and applicable only for Versal® ACAP. By default, prebuilt PLM image is packed. Use this option to either specify a path for PLM image or to skip packing of PLM. To skip packing PLM, use --plm no. User-specified <plnx-proj-root>/images/linux/plm.elf
--psmfw PSMFW-ELF Optional and applicable only for Versal ACAP. By default, prebuilt PSM firmware image is packed. Use this option to either specify a path for PSM firmware image or to skip packing of PSM firmware. To skip packing PSM firmware, use --psmfw no. User-specified <plnx-proj-root>/images/linux/psmfw.elf
--addcdo CDOFILE Path on disk to add .cdo file pack into BOOT.BIN. User-specified None
--add DATAFILE Path on disk to arbitrary data to include. This is optional. User-specified None
--offset OFFSET Offset at which to load the prior data file. Only the .elf files are parsed. This is optional. User-specified None
--load <LOADADDR> Load address for specified data file. The RAM address where to load the specified data file.

Example: [ partition_type=raw, load=0x01000 ] <image>

User-specified None
--mmi MMIFILE Bitstream MMI file, valid for MicroBlaze CPUs only. It will be used to generate the download.bit with boot loader in the block RAM. Default will be the MMI file in the same directory as the FPGA bitstream. This is optional User-specified MMI in directory with FPGA bitstream
--flash-size SIZE Flash size in MB. Must be a power-of-2. Valid for MicroBlaze processor only. Not needed for parallel flash types. Ensure you just pass digit value to this option. Do not include MB in the value. This is optional. User-specified Auto-detect from system configuration. If it is not specified, the default value is 16.
--flash-intf INTERFACE Valid for MicroBlaze processor only. This is optional.
  • SERIALx1
  • SPIx1
  • SPIx2
  • SPIx4
  • BPIx8
  • BPIx16
  • SMAPx8
  • SMAPx16
  • SMAPx32
Auto-detect
-o, --output OUTPUTFILE Path on disk to write output image. This is optional. User-specified None
--cpu DESTINATION CPU Zynq UltraScale+ MPSoC only. The destination CPU of the previous data file. This is optional.
  • a53-0
  • a53-1
  • a53-2
  • a53-3
None
--file-attribute DATA File ATTR

Zynq-7000, Zynq® UltraScale+™ MPSoC, and Versal ACAP only. Data file file-attribute. This is optional.

Example:

petalinux-package --boot --u-boot --kernel images/linux/Image --offset 0x01e40000 --file-attribute partition_owner=uboot --add images/linux/system.dtb --offset 0x3AD1200 --file-attribute partition_owner=uboot --fpga
User-specified None
--bif-attribute ATTRIBUTE

Zynq-7000, Zynq® UltraScale+™ MPSoC, and Versal ACAP only.

Example:

petalinux-package --boot --bif-attribute fsbl_config --bif-attribute-value a53_x64 --u-boot
User-specified None
--bif-attribute-value VALUE

Zynq-7000, Zynq® UltraScale+™ MPSoC, and Versal ACAP only. The value of the attribute specified by --bif-attribute argument. This is optional.

Example:

petalinux-package --boot --bif-attribute fsbl_config --bif-attribute-value a53_x64 --u-boot
User-specified None
--fsblconfig BIF_FSBL_CONFIG Zynq® UltraScale+™ MPSoC only. BIF FSBL config value.

Example:

petalinux-package --boot --fsblconfig a53_x64 --u-boot
User-specified None
--bif BIF FILE Zynq-7000 devices, Zynq UltraScale+ MPSoC, and Versal ACAP. BIF file. For Zynq-7000 devices and Zynq UltraScale+ MPSoC, it overrides the following settings:
  • –fsbl
  • –fpga
  • –u-boot
  • –add
  • –fsblconfig
  • –file-attribute
  • –bif-attribute
  • –bif-attribute-value

For Versal ACAP, it overrides the following settings:

  • -fpga
  • -u-boot
  • -add
  • -file-attribute
  • -bif-attribute
  • -bit-attribute-value

This is optional.

User-specified None
--boot-device BOOT-DEV Zynq-7000, Zynq UltraScale+ MPSoC, and Versal ACAP. The boot device is updated in bootargs to boot. This is optional.
  • sd
  • flash
Default value is the one selected from the system select menu of boot image settings.

--bootgen-extra-args

ARGS

Zynq-7000, Zynq UltraScale+ MPSoC, and Versal ACAP only. Extra arguments to be passed while invoking bootgen command. This is optional. User-specified None
  1. When the FPGA manager option is enabled in petalinux-config, the --fpga option cannot be used. Bitstream will not be included in the BOOT.BIN.