Additional Options for Booting with JTAG - 2024.2 English

Additional Options for Booting with JTAG - 2024.2 English - UG1144

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID

UG1144

Release Date

2024-11-13

Version

2024.2 English

To download a bitstream to the target board:

petalinux-boot jtag --fpga --bitstream <BITSTREAM> --hw_server-url <hostname:3121>

To download and run 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 and run 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 and run an image with a bitstream with --fpga --bitstream <BITSTREAM> option:
```
petalinux-boot jtag --u-boot --fpga --bitstream <BITSTREAM>
```
The previous command downloads the bitstream and the U-Boot image.
To see the verbose output of JTAG boot with -v option:
```
petalinux-boot jtag --u-boot -v
```
To download and run 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 and run 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>
```