Stephen: /* Option two: Update U-Boot images to SPI Nor Flash by partitions */

2023-04-01T08:46:21Z

‎Option two: Update U-Boot images to SPI Nor Flash by partitions

Stephen: /* Write U-Boot images to SPI Nor Flash or erase SPI Nor Flash */

2023-04-01T08:45:57Z

‎Write U-Boot images to SPI Nor Flash or erase SPI Nor Flash

Stephen at 06:48, 31 March 2023

2023-03-31T06:48:04Z

Stephen: Created page with "{{rock3_header}} {{Languages|rock3/install/spi}} ROCK 3 > Installation > rock3/install/spi-cm3io | Install the image to SPI Nor Flash..."

2023-03-31T04:18:02Z

Created page with "{{rock3_header}} {{Languages|rock3/install/spi}} ROCK 3 > Installation > rock3/install/spi-cm3io | Install the image to SPI Nor Flash..."

New page

{{rock3_header}}

{{Languages|rock3/install/spi}}

[[rock3 | ROCK 3]] > [[rock3/install | Installation]] > [[rock3/install/spi-cm3io | Install the image to SPI Nor Flash (Radxa CM3 IO)]]

== Install the image to SPI Nor Flash from USB port ==
ROCK 3 supports Maskrom mode, which is a special operation mode for CPU to wait for USB OTG port command. The Linux/macOS PC tool we use to communicate with ROCK 3 in Maskrom mode are the '''rkdeveloptool''' and '''RKDevTool'''. We use tool rkdeveloptool in Linux/macOS and RKDevTool tool under Windows.

Available boards:
* Radxa CM3 IO

=== Requirement ===
* Radxa CM3 IO with SPI Nor Flash and button (You can find SPI Nor Flash from [[ rock3/CM/CM3 | Radxa CM3]])
* Power adapter
* USB Male A to Micro USB cable

=== Install Tools&Drivers ===
Please check this guide, [[rock3/install/rockchip-flash-tools | Install rockchip flash tools under Windows/Linux/MacOS PC]].

=== Boot the board to Maskrom mode ===
To boot Radxa CM3 IO into Maskrom mode is simple:
* Power off the board
* Remove bootable devices like microSD card, etc
* Press '''SPI Flash disable button''' and hold it
* Power on Radxa CM3 IO
* Release '''SPI Flash disable button'''
* Plug the USB Male A to MicroUSB cable to Radxa CM3 IO OTG port(the Micro USB port), the other side to PC
* Check usb device
** For macOS host: lsusb result: '''Bus 000 Device 004: ID 2207:350a Fuzhou Rockchip Electronics Co., Ltd. Composite Device'''
** For Linux host: lsusb result: '''Bus 001 Device 112: ID 2207:350a Fuzhou Rockchip Electronics Company'''
** For Windows host: Open RKDevTool and you would see the device is in '''Found One MASKROM Device'''.

[[File:Rkdevtool-found-one-maskrom-device.png | 1000px]]

Alternatively, if you are running Android and can access ADB, you can reboot the device to loader mode 'adb reboot bootloader' then use the rkdeveloptool to reset the device into maskrom mode 'rkdeveloptool rd 3' or Windows RKDevTool '''Switch''' button to go to maskrom mode.

=== Get Radxa CM3 IO loader and U-Boot images ===
* [https://dl.radxa.com/rock3/images/loader/radxa-cm3-io/rk356x_spl_loader_ddr1056_v1.10.111.bin RK356X loader]
* [https://dl.radxa.com/rock3/images/loader/radxa-cm3-io/radxa-cm3-io-idbloader-g8684d740b9f.img Radxa CM3 IO idbloader]
* [https://dl.radxa.com/rock3/images/loader/radxa-cm3-io/radxa-cm3-io-u-boot-g8684d740b9f.itb Radxa CM3 IO u-boot.itb]

=== Create GPT U-Boot image ===
To avoid random mac address after every reboot, it is recommended to create a 16MB size gpt uboot image which contains idbloader.img and u-boot.itb.
Use these command on Linux to create the image:

dd if=/dev/zero of=spi_image.img bs=1M count=0 seek=16
/usr/sbin/parted -s spi_image.img mklabel gpt
/usr/sbin/parted -s spi_image.img unit s mkpart idbloader 64 7167
/usr/sbin/parted -s spi_image.img unit s mkpart vnvm 7168 7679
/usr/sbin/parted -s spi_image.img unit s mkpart reserved_space 7680 8063
/usr/sbin/parted -s spi_image.img unit s mkpart reserved1 8064 8127
/usr/sbin/parted -s spi_image.img unit s mkpart uboot_env 8128 8191
/usr/sbin/parted -s spi_image.img unit s mkpart reserved2 8192 16383
/usr/sbin/parted -s spi_image.img unit s mkpart uboot 16384 32734
dd if=./idbloader.img of=spi_image.img seek=64 conv=notrunc
dd if=./u-boot.itb of=spi_image.img seek=16384 conv=notrunc

There is an image made by the above commands using the u-boot file from [https://dl.radxa.com/rock3/images/loader/rock-3a/rock-3a-spi-image-gef9f6b1caad.img ROCK 3A SPI image]. You can unzip it to use in the following step.

=== Write U-Boot images to SPI Nor Flash or erase SPI Nor Flash ===

==== Linux/macOS PC ====

===== Option one: Write U-Boot images to SPI Nor Flash =====

On PC, run command rkdeveloptool.

Confirm that ROCK 3A is in maskrom mode.

rkdeveloptool ld
DevNo=1 Vid=0x2207,Pid=0x350a,LocationID=104 Maskrom

Download the loader (flash helper) to init the ram and prepare the flashing environment etc.

rkdeveloptool db rk356x_spl_loader_ddr1056_v1.10.111.bin

Write bootloader

rkdeveloptool wl 0 spi_image.img

Reboot the device

rkdeveloptool rd

Now the device should boot on SPI Nor Flash. And '''the blue led is on'''.

===== Option two: Update U-Boot images to SPI Nor Flash by partitions =====

There is no need to write the whole uboot image to SPI Nor Flash if you have already done that before. You can just update the idbloader.img and u-boot.itb to prevent overwriting the saved mac address in SPI Nor Flash.

On PC, run command rkdeveloptool.

Confirm that ROCK 3A is in maskrom mode.

rkdeveloptool ld
DevNo=1 Vid=0x2207,Pid=0x350a,LocationID=104 Maskrom

Download the loader (flash helper) to init the ram and prepare the flashing environment etc.

rkdeveloptool db rk356x_spl_loader_ddr1056_v1.10.111.bin

Write bootloader

rkdeveloptool wl 64 idbloader.img
rkdeveloptool wl 16384 u-boot.itb

Reboot the device

rkdeveloptool rd

Now the device should boot on SPI Nor Flash. And '''the blue led is on'''.

===== Option three: Erase SPI Nor Flash =====

Please notice that when you want to erase SPI Nor Flash, run following commands.

rkdeveloptool db rk356x_spl_loader_ddr1056_v1.10.111.bin
rkdeveloptool ef
rkdeveloptool rd

==== Windows PC ====
===== Option one: Write U-Boot images to SPI Nor Flash =====

Double click the '''RKDevTool.exe''' and click button '''Download Image'''.

[[File:Write_uboot_gpt_image_to_rk3568_spi.png | 1000px]]

====== Step 1: Write config ======

{| class="wikitable"
|-
! # || Address || Name || Path
|-
| 1 || 0x00000000 || Loader || /path/to/rk356x_spl_loader_ddr1056_v1.10.111.bin
|-
| 2 || 0x00000000 || ubootimage || /path/to/spi_image.img
|}

====== Step 2: Confirm "Found One Maskrom Device" ======
If your ROCK 3A is in maskrom mode and connects to PC, you can see that RKDevTool shows '''Found one MASKROM Device'''.

====== Step 3: Run ======
Finally, click the "run" button, and you will see the content on the right side. When RKDevTool shows '''Download image OK''', the download job is completed.

[[File:Rkdevtool-write-rock-3a-u-boot-sucess-log.png | 1000px]]

===== Option two: Update U-Boot images to SPI Nor Flash by partitions =====

There is no need to write the whole uboot image to SPI Nor Flash if you have already done that before. You can just update the idbloader.img and u-boot.itb to prevent overwriting the saved mac address in SPI Nor Flash.

Double click the '''RKDevTool.exe''' and click button '''Download Image'''.

[[File:Rkdevtool-write-uboot-to-spi-nor-flash.png | 1000px]]

====== Step 1: Write config ======

{| class="wikitable"
|-
! # || Address || Name || Path
|-
| 1 || 0x00000000 || Loader || /path/to/rk356x_spl_loader_ddr1056_v1.10.111.bin
|-
| 2 || 0x00000040 || idbloader || /path/to/idbloader.img
|-
| 3 || 0x00004000 || u-boot.itb || /path/to/u-boot.itb
|}

====== Step 2: Confirm "Found One Maskrom Device" ======
If your ROCK 3A is in maskrom mode and connects to PC, you can see that RKDevTool shows '''Found one MASKROM Device'''.

====== Step 3: Run ======
Finally, click the "run" button, and you will see the content on the right side. When RKDevTool shows '''Download image OK''', the download job is completed.

[[File:Rkdevtool-write-rock-3a-u-boot-sucess-log.png | 1000px]]

===== Option three: Erase SPI Nor Flash =====
Double click the '''RKDevTool.exe''' and click button "Advanced Function" to get into '''Advanced Function''' window.

[[File:rkdevtool-erase-device-1.png | 1000px]]

====== Step 1: Confirm "Found One Maskrom Device" ======
If your ROCK 3A is in maskrom mode and connects to PC, you can see that RKDevTool shows '''Found one MASKROM Device'''.

====== Step 2: Download RK356X Loader ======
Choose loader rk356x_spl_loader_ddr1056_v1.10.111.bin and download it.

[[File:rkdevtool-erase-device-2.png | 1000px]]

====== Step 3: Erase device ======
Click button "EraseAll" to erase device.

[[File:rkdevtool-erase-device-3.png | 1000px]]

====== Step 4: Reset device ======
Click button "ResetDevice" to reset device.

[[File:rkdevtool-erase-device-4.png | 1000px]]

Erasing job is done.

=== RK3568 SB-variant ===

Due to the version difference of the RK3568 chip, it may fail to burn the image to EMMC in MASKROM mode. If you find that your ROCK 3A cannot burn the image to EMMC through MASKROM mode, you need to use a specific loader to burn it [https://dl.radxa.com/rock3/images/loader/rk356x_spl_loader_ddr1056_v1.12.109_no_check_todly.bin rk356x_spl_loader_ddr1056_v1.12.109_no_check_todly.bin]
more information on forum: https://forum.radxa.com/t/radxa-rock-3-model-a-maskrom-mode-cannot-burn-the-image-to-emmc-solution/11373

=== Troubleshooting ===

* If you have issue with flashing via USB OTG, start a new post on the forum, https://forum.radxa.com/c/rock3.

@@ Line 112: / Line 112: @@
   rkdeveloptool rd
-Now the device should boot on SPI Nor Flash. And '''the blue led is on'''.
+Now the device should boot on SPI Nor Flash.
 ===== Option three: Erase SPI Nor Flash =====

@@ Line 40: / Line 40: @@
 * [https://dl.radxa.com/rock3/images/loader/radxa-cm3-io/radxa-cm3-io-idbloader-g8684d740b9f.img Radxa CM3 IO idbloader]
 * [https://dl.radxa.com/rock3/images/loader/radxa-cm3-io/radxa-cm3-io-u-boot-g8684d740b9f.itb Radxa CM3 IO u-boot.itb]
 === Create GPT U-Boot image ===
@@ Line 57: / Line 59: @@
   dd if=./u-boot.itb of=spi_image.img seek=16384 conv=notrunc
-There is an image made by the above commands using the u-boot file from [https://dl.radxa.com/rock3/images/loader/rock-3a/rock-3a-spi-image-gef9f6b1caad.img ROCK 3A SPI image]. You can unzip it to use in the following step.
+There is an image made by the above commands using the u-boot file from [https://dl.radxa.com/rock3/images/loader/radxa-cm3-io/radxa-cm3-io-spi-image-g8684d740b9f.img.gz Radxa CM3 IO SPI image]. You can unzip it to use in the following step.
 === Write U-Boot images to SPI Nor Flash or erase SPI Nor Flash ===
@@ Line 67: / Line 69: @@
 On PC, run command rkdeveloptool.
-Confirm that ROCK 3A is in maskrom mode.
+Confirm that Radxa CM3 IO is in Maskrom mode.
   rkdeveloptool ld
@@ Line 139: / Line 141: @@
 ====== Step 2: Confirm "Found One Maskrom  Device" ======
-If your ROCK 3A is in maskrom mode and connects to PC, you can see that RKDevTool shows '''Found one MASKROM Device'''.
+If your Radxa CM3 IO is in Maskrom mode and connects to PC, you can see that RKDevTool shows '''Found one MASKROM Device'''.
 ====== Step 3: Run ======
@@ Line 168: / Line 170: @@
 ====== Step 2: Confirm "Found One Maskrom  Device" ======
-If your ROCK 3A is in maskrom mode and connects to PC, you can see that RKDevTool shows '''Found one MASKROM Device'''.
+If your Radxa CM3 IO is in Maskrom mode and connects to PC, you can see that RKDevTool shows '''Found one MASKROM Device'''.
 ====== Step 3: Run ======
@@ Line 181: / Line 183: @@
 ====== Step 1: Confirm "Found One Maskrom  Device" ======
-If your ROCK 3A is in maskrom mode and connects to PC, you can see that RKDevTool shows '''Found one MASKROM Device'''.
+If your Radxa CM3 IO is in Maskrom mode and connects to PC, you can see that RKDevTool shows '''Found one MASKROM Device'''.
 ====== Step 2: Download RK356X Loader ======

Rock3/install/spi-cm3io - Revision history

Stephen: /* Option two: Update U-Boot images to SPI Nor Flash by partitions */

Stephen: /* Write U-Boot images to SPI Nor Flash or erase SPI Nor Flash */

Stephen at 06:48, 31 March 2023

Stephen: Created page with "{{rock3_header}} {{Languages|rock3/install/spi}} ROCK 3 > Installation > rock3/install/spi-cm3io | Install the image to SPI Nor Flash..."