petalinux-boot Command Line Options - 2021.1 English

PetaLinux Tools Documentation Reference Guide (UG1144)

Document ID
UG1144
Release Date
2021-06-16
Version
2021.1 English

The following table details the command line options that are common to all petalinux-boot workflows.

Table 1. petalinux-boot Command Line Options
Option Functional Description Value Range Default Value
--jtag Use the JTAG workflow. Mutually exclusive with the QEMU workflow. One of the two, --jtag or --qemu is required. None None
--qemu Use the QEMU workflow. Mutually exclusive with the JTAG workflow. One of the two, --jtag or --qemu is required. None None
--prebuilt Boot a prebuilt image. This is optional.
  • 1 (bitstream /FSBL) (1)
  • 2 (U-Boot)
  • 3 (Linux kernel)
None
--boot-addr BOOT_ADDR Boot address. This is optional. None None
-i,--image IMAGEPATH Image to boot. This is optional. To specify U-Boot/Kernel image from an external path, use this option.

Example:

$ petalinux-boot --qemu --image ./images/linux/zImage --dtb ./images/linux/system.dtb
User-specified None
--u-boot This option can be use to download specified U-Boot binary along with dependent files to boot into the U-Boot. It will select an U-Boot ELF image from <plnx-proj-root>/images/linux/. This is optional. User-specified <plnx-proj-root>/images/linux/u-boot.elf
--kernel This option can be use to download specified kernel binary along with dependent files to boot kernel. This option will pick kernel image from <plnx-proj-root>/images/linux/. This is optional. User-specified
  • zImage for Zynq®-7000 devices
  • Image for Zynq® UltraScale+™ MPSoC, and Versal™ ACAP
  • image.elf for MicroBlaze™ CPU

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

-v,--verbose Displays additional output messages. This is optional. None None
-h,--help Displays tool usage information. This is optional. None None
  1. --prebuilt 1 is not a valid option for the QEMU workflow.