Changes between Version 46 and Version 47 of jtag_instructions

Timestamp:

12/29/2022 08:03:51 PM (23 months ago)

Author:

Tim Harvey

Comment:

updated mkimage_jtag usage notes and examples

jtag_instructions

@@ -193 +193 @@
 
 Notes:
- - for eMMC you can specify the '--partconf <boot0|boot1|user>' option to instruct {{{jtag_usbv4}}} to set the eMMC register that specifies the hardware to boot from
+ - Because JTAG is extremely slow for large flash parts such as eMMC it is advised that you use JTAG just to flash the boot firmware then use the boot firmware to flash the remainder of the device
  - the {{{-s}}} option invokes the 'scripted' mode which allows you to specify multiple objects
- - the {{{-e}}} option invokes the 'scripted' mode but also instructs {{{jtag_usbv4}}} to erase the entire part
- - Because JTAG is extremely slow for large flash parts such as eMMC it is advised that you use JTAG just to flash the boot firmware then use the boot firmware to flash the remainder of the device
+ - for eMMC:
+  * you must use the {{{-s}}} scripted mode and the {{{-e}}} flag to erase the entire part does nothing special as the erase mode is specified for each blob
+  * you can specify the '--partconf <boot0|boot1|user>' option to instruct {{{jtag_usbv4}}} to configure the eMMC to boot off the boot0, boot1, or user hardware partition
+  * each blob must match the format <blob-file>@<hardware-partition>:<erase_mode>:<start-block>-[end-block] where:
+   - hardware-partition specifies the eMMC hardware partition: boot0, boot1, or user
+   - erase-mode specifies what type of erase mode to use:
+     * erase_none - no erase
+     * erase_all - erase the entire hardware partition from block 0 to end of device
+     * erase_part - erase only part of the hardware partition specified by <start-block> and <end-block>
+     * if end block is not specified it will default to the last block of the hardware partition
+ - for NAND:
+  - you do not need to use the {{{-s}}} scripted mode and can instead use the following legacy syntax:
+    * mkimage_jtag <ubi> > firmware.bin # program ubi@17MB and erasing to the end of the device 
+    * mkimage_jtag <spl> <uboot> > firmware.bin # program the SPL and U-Boot only erasing 0 to 16MB (thus leaving U-Boot env and ubi in-tact)
+    * mkimage_jtag <spl> <uboot> <ubi> > firmware.bin # erase entire part and program the SPL, U-Boot, and UBI
+  - if you wish to erase the entire NAND part use the {{{-e}}} flag which also specifies scripted mode
 
 Examples:
- * Newport eMMC:
-  - update the boot firmware and set the hardware partition and erase the entire part:
-{{{#!bash
-./mkimage_jtag --emmc -e --partconf=user firmware-newport.img@user:erase_all:0-16M > firmware-newport.bin
+ * eMMC:
+  - configure the eMMC to boot from the user hardware partition, program the boot firmware to the user hardware partition but only erase from block 0 to block 32768 (0 to 16MiB):
+{{{#!bash
+./mkimage_jtag --emmc -s --partconf=user firmware.img@user:erase_part:0-32768 > firmware.bin
+}}}
+  - configure the eMMC to boot from the user hardware partition, program the boot firmware to the user hardware partition and erase the entire user hardware partition:
+{{{#!bash
+./mkimage_jtag --emmc -s --partconf=user firmware.img@user:erase_all:0-32768 > firmware.bin
 }}}
  * Ventana NAND: (see wiki:ventana/bootloader#nand here for NAND flash map)
@@ -209 +227 @@
 ./mkimage_jtag SPL u-boot.img > uboot.bin
 }}}
-  - update just the rootfs (does not touch boot firmware):
+  - program a UBI image erasing to the end of the device (does not touch boot firmware):
 {{{#!bash
 ./mkimage_jtag openwrt-ventana-rootfs.ubi > image.bin
 }}}
-  - update the boot firmware and the root filesystem (erases entire flash):
+  - program boot firmware and a UBI (erases entire flash):
 {{{#!bash
 ./mkimage_jtag SPL u-boot.img openwrt-ventana-rootfs.ubi > image.bin
 }}}
- - Program U-boot SPL, env, and erase entire part
+  - program U-boot SPL, env, and erase entire part using scripted mode
 {{{#!bash
 mkimage_jtag -e SPL@0 u-boot.img@14M env@16M > image.bin
-}}}
- - Program U-boot SPL and erase entire part
-{{{#!bash
-mkimage_jtag -e SPL@0 u-boot.img@14M > image.bin
 }}}