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. | User-specified | <plnx-proj-root>/images/linux/system.bit |
--atf
ATF-IMG
|
Path on disk to
Arm®
trusted firmware elf binary. This is optional. To skip loading ATF,
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 |
--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 |
--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
|
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
|
Example: petalinux-package --boot
--bif-attribute fsbl_config --bif-attribute-value a53_x64
--u-boot
|
User-specified | None |
--bif-attribute-value VALUE
|
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
|
For Zynq-7000 devices and Zynq UltraScale+ MPSoC, it
overrides the following settings:
This is optional. |
User-specified | None |
--boot-device
BOOT-DEV
|
|
Default value is the one selected from the system select menu of boot image settings. | |
|
User-specified | None | |
|