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 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: |
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. |
|
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, 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 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:
For Versal ACAP, it overrides the following settings:
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. |
|
Default value is the one selected from the system select menu of boot image settings. |
|
|
Zynq-7000, Zynq UltraScale+ MPSoC, and Versal ACAP only. Extra arguments to be passed while invoking bootgen command. This is optional. | User-specified | None |
|
|||