The following table details the options that are valid when creating a bootable
image with the petalinux-package boot
command:
Option | Functional Description | Value Range | Default Value |
---|---|---|---|
--format
FORMAT
|
Image file format to generate. This is optional. |
|
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 |
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 |
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: |
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. |
|
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. |
|
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 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:
For Versal adaptive SoC, it overrides the following settings:
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. |
|
Default value is the one selected from the system select menu of boot image settings. |
|
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 |
|