petalinux-package boot Command Options - 2024.2 English

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
UG1144
Release Date
2024-11-13
Version
2024.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 AMD 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.To skip loading BITSTREAM, use - -fpga no or - -fpga none 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 adaptive SoC 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 AMD 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 AMD Versal™ adaptive SoC. 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 adaptive SoC. 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 is used to generate the download.bit with boot loader in the block RAM. Default is 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 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, AMD Zynq™ UltraScale+™ MPSoC, and Versal adaptive SoC 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, AMD Zynq™ UltraScale+™ MPSoC, and Versal adaptive SoC 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, AMD Zynq™ UltraScale+™ MPSoC, and Versal adaptive SoC 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 AMD 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 adaptive SoC. 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 adaptive SoC, 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 adaptive SoC. 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 adaptive SoC 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 is not included in the BOOT.BIN.