Additional Options for Booting with JTAG - 2023.2 English

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
UG1144
Release Date
2023-10-18
Version
2023.2 English
  • To download a bitstream to target board:
    petalinux-boot --jtag --fpga --bitstream <BITSTREAM> --hw_server-url <hostname:3121>
  • To download newly built <plnx-proj-root>/images/linux/u-boot.elf to target board:
    petalinux-boot --jtag --u-boot --hw_server-url <hostname:3121>
  • To download newly built kernel to target board:
    petalinux-boot --jtag --kernel --hw_server-url <hostname:3121>
    • For MicroBlaze™ processors, this boots system.bit, u-boot.elf, linux.bin.ub, system.dtb, and rootfs.cpio.gz.u-boot on target board.
      Note: If using a MicroBlaze processor, you need to add --fpga to the petalinux-boot command as shown in the following example:
      petalinux-boot --jtag --fpga --kernel --hw_server-url <hostname:3121>
    • For AMD Zynq™ UltraScale+™ MPSoC, this boots pmufw.elf, zynqmp_fsbl.elf, u-boot.elf, Image, system.dtb, and ramdisk.cpio.gz.u-boot on target board.
    • For Zynq 7000 devices, this boots zynq_fsbl.elf, u-boot.elf, uImage, system.dtb, and rootfs.cpio.gz.u-boot on target board.
    • For AMD Versal™ adaptive SoC, this boots BOOT.BIN, Image, ramdisk.cpio.gz.u-boot, and boot.scr on target board.
  • To download a image with a bitstream with --fpga --bitstream <BITSTREAM> option:
    petalinux-boot --jtag --u-boot --fpga --bitstream <BITSTREAM>

    The previous command downloads the bitstream and download the U-Boot image.

  • To see the verbose output of JTAG boot with -v option:
    petalinux-boot --jtag --u-boot -v
  • To download a customized U-Boot image with the --u-boot/--uboot option:
    petalinux-boot --jtag --u-boot/--uboot <specify custom u-boot.elf path>
  • To download a customized kernel image with --kernel:
    For Zynq UltraScale+ MPSoC and Versal adaptive SoC, use Image
    petalinux-boot --jtag --kernel <specify custom Image path>
    For Zynq 7000 devices, use Image
    petalinux-boot --jtag --kernel <specify custom uImage path> 
    For MicroBlaze processors, use linux.bin.ub
    petalinux-boot --jtag --kernel <specify custom linux.bin.ub path>
  • To download a customized DTB image with --kernel:
    petalinux-boot --jtag --kernel <specify custom kernel path> --dtb <specify custom dtb path>
  • To download a customized DTB image with --uboot/--u-boot:
    petalinux-boot --jtag --u-boot/--uboot <specify custom u-boot path> --dtb <specify custom dtb path>
  • To download a customized pmufw image with kernel:
    petalinux-boot --jtag --kernel <specify custom kernel path> --pmufw <specify custom pmufw.elf path>