Additional Options for Booting with JTAG - 2021.2 English

PetaLinux Tools Documentation: Reference Guide

Document ID
UG1144
Release Date
2021-10-27
Version
2021.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 <plnx-proj-root>/images/linux/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 Zynq® UltraScale+™ MPSoC, this boots <plnx-proj-root>/images/linux/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 <plnx-proj-root>/images/linux/zynq_fsbl.elf, u-boot.elf, uImage, system.dtb, and rootfs.cpio.gz.u-boot on target board.
    • For Versal® ACAP, this boots <plnx-proj-root>/images/linux/BOOT.BIN, <plnx-proj-root>/images/linux/Image, <plnx-proj-root>/images/linux/ramdisk.cpio.gz.u-boot , and <plnx-proj-root>/images/linux/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 above command downloads the bitstream and then 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 ACAP, use Image
    $ petalinux-boot --jtag --kernel <specify custom Image path>
    For Zynq-7000 devices, use uImage
    $ 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>