petalinux-boot jtag Options - 2024.2 English - UG1144

PetaLinux Tools Documentation: Reference Guide (UG1144)
Document ID
UG1144
Release Date
2024-11-13
Version
2024.2 English

The following table contains details of options specific to the JTAG boot workflow.

Table 1. petalinux-boot jtag Options
Option Functional Description Value Range Default Value
--prebuilt Boot a prebuilt image. This is optional.
  • 1 (bitstream /FSBL)
  • 2 (U-Boot)
  • 3 (Linux kernel)
    Note: 1 is not a valid option for the QEMU workflow.
 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 selects 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 picks the kernel image from <plnx-proj-root>/images/linux/. This is optional. User-specified
  • zImage for AMD Zynq™ 7000 devices
  • Image for AMD Zynq™ UltraScale+™ MPSoC, and AMD Versal™ adaptive SoC
  • image.elf for MicroBlaze™ CPU

The default image is in <plnx-proj-root>/images/linux.
--xsdb-connect COMMAND Customized XSDB connection command to run prior to boot. This is optional. User-specified None
--hw_server-url URL URL of the hw_server to connect to. This is optional. User-specified None
--tcl OUTPUTFILE Log JTAG Tcl commands used for boot. This is optional. User-specified None
--fpga Program FPGA bitstream. This is optional. None If no bitstream is specified with the --bitstream option, it uses the bitstream from one of the following locations:
  • If you are using build images to boot, it picks the bitstream from <plnx-proj-root>/images/linux/system.bit
  • If you are using prebuilt images to boot, it picks the bitstream pick <plnx-proj-root>/prebuilt/linux/implementation/download.bit
before-connect <CMD> Extra command to run before XSDB connect command. Ensure the command is properly quoted in your shell. This is optional and can be used multiple times. None None
after-connect <CMD> Extra commands to run after XSDB connect command. Ensure the command is properly quoted in your shell. This is optional and can be used multiple times. None None
--rootfs Specify the cpio rootfile system needs to be used for jtag boot. Supports for: Zynq, Zynq UltraScale+ MPSoC, Versal, and MicroBlaze. User-specified <plnx-proj-root>/images/linux/rootfs.cpio.gz.u-boot