Radxa Wiki - User contributions [en]

Rock3/install/spi

2022-10-20T10:51:05Z

Dominik: info about rk3568 sb variant

{{rock3_header}}

{{Languages|rock3/install/spi}}

[[rock3 | ROCK 3]] > [[rock3/install | Installation]] > [[rock3/install/spi | Install the image to SPI Nor Flash]]

== 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:
* ROCK 3A

Here we do the test on ROCK 3A.

=== Requirement ===
* ROCK 3A with SPI Nor Flash (You can find SPI Nor Flash from [[rock3/hardware/3a | ROCK 3 Model A Main Board]])
* Power adapter
* '''USB Male A to Male A cable'''(important) USB-C has been seen as not working, an adaptor for USB-C to USB-A has worked. [https://forum.radxa.com/t/otg-flashing-not-working/717 See discussion].

=== 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 ROCK 3A into maskrom mode is simple:
* Power off the board
* Remove bootable devices like microSD card, eMMC module, etc
* Plug the USB Male A to Male A cable to ROCK 3A OTG port(the upper USB3.0 port), the other side to PC
[[File:Rock-3a-usb-otg-port.png | 600px]]
* Short-circuit the following pins. See the left yellow hat.
[[File:Rock-3a-disable-spi-nor-flash.png | 600px]]
* Power on the board
* Take off the yellow hat.
* 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 RK356X loader and U-Boot images ===
* [https://dl.radxa.com/rock3/images/loader/rock-3a/rk356x_spl_loader_ddr1056_v1.10.111.bin RK356X loader]
* [https://dl.radxa.com/rock3/images/loader/rock-3a/rock-3a-idbloader-gef9f6b1caad.img ROCK 3A idbloader]
* [https://dl.radxa.com/rock3/images/loader/rock-3a/rock-3a-u-boot-gef9f6b1caad.itb ROCK 3A 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, fire these commands. Get zero.img from [https://dl.radxa.com/rock3/images/others/zero.img.gz here].

rkdeveloptool db rk356x_spl_loader_ddr1056_v1.10.111.bin
rkdeveloptool wl 0 zero.img
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-emmc/11372

=== Troubleshooting ===

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

Rock3/install/usb-install

2022-10-20T10:50:23Z

Dominik: info about rk3568 sb variant

Rock3/dev/usb-install

2022-10-20T10:49:16Z

Dominik:

{{rock3_header}}

{{Languages|rock3/install/microSD}}

[[rock3 | ROCK 3]] > [[rock3/install | Installation]] > [[rock3/install/usb-install | Install to eMMC from USB port]]

=== Install on eMMC from USB port ===
Rock 3 supports Maskrom mode, which is a special operation mode for CPU to wait for USB OTG port command.
The PC tools we use to communicate with rock 3 in Maskrom mode are the '''rkdevelopment tool''' and '''AndroidTool tool'''.
We use '''the rkdevelopment tool in Linux/macOS ''' and '''the AndroidTool tool under Windows'''.
=== Requirement ===
* ROCK 3 mainboard
* eMMC module
* Power adapter
* '''USB Male A to Male A cable'''(important) USB-C has been seen as not working, an adaptor for USB-C to USB-A has worked. [https://forum.radxa.com/t/otg-flashing-not-working/717 See discussion].
=== Install Tools&Drivers ===

<div class="toccolours mw-collapsible" style="width:800px; overflow:auto;">
==== Windows ====
<div class="mw-collapsible-content">
=====Step 1：Install Android tool=====
The tool is provided in a compressed package. First, download the compressed package of this tool, and click the download link [https://dl.radxa.com/tools/windows/RKDevTool_Release_v2.81.zip (RKDevTool_Release_v2.81.zip)]. After downloading, unzip it. Installation is complete.

=====Step 2：Install driver=====
Using the RK driver assistant tool to install the driver.

There’s no need to connect your Rockchip device during this procedure just download and extract [https://dl.radxa.com/tools/windows/DriverAssitant_v5.0.zip RKDriverAssistant.zip]

Then double click on DriverInstall.exe in the RKDriverAssistant directory to start the utility. If you installed the Rockchip USB drivers for any other Rockchip devices already, make sure you click “Uninstall Driver” first.

[[File:RK_Driver_Assistant_Install_Uninstall.jpg]]

Then click “Install Driver”, the driver has finish installing.

</div>
</div>

<div class="toccolours mw-collapsible" style="width:800px; overflow:auto;">

==== Linux====
<div class="mw-collapsible-content">
For Linux, we build the rkdeveloptool, '''>=1.32''', from source code.

To build rkdeveloptool on a Debian based Linux distribution, follow the instruction below:

Install build dependency:
sudo apt-get install libudev-dev libusb-1.0-0-dev dh-autoreconf

Clone the source code and build:
git clone https://github.com/rockchip-linux/rkdeveloptool
cd rkdeveloptool
autoreconf -i
./configure
make

If you encounter compile error like below
./configure: line 4269: syntax error near unexpected token `LIBUSB1,libusb-1.0'
./configure: line 4269: `PKG_CHECK_MODULES(LIBUSB1,libusb-1.0)'

You should install pkg-config libusb-1.0
sudo apt-get install pkg-config libusb-1.0

Then re-run
autoreconf -i
./configure
make

Now you have rkdeveloptool executable at the current directory.
sudo cp rkdeveloptool /usr/local/bin/
</div>
</div>

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;">

==== MacOS ====
<div class="mw-collapsible-content">
For macOS, we build the rkdeveloptool, '''>=1.32''', from source code.

To build rkdeveloptool on macOS, you need [https://brew.sh/ homebrew](or similar package manager) to install required packages.

Install build dependency:

brew install automake autoconf libusb lsusb

Clone the source code and build:

git clone https://github.com/rockchip-linux/rkdeveloptool
cd rkdeveloptool
autoreconf -i
./configure
make

If you encounter compile error like below
./configure: line 4269: syntax error near unexpected token `LIBUSB1,libusb-1.0'
./configure: line 4269: `PKG_CHECK_MODULES(LIBUSB1,libusb-1.0)'

You should install pkg-config libusb-1.0
brew install pkg-config

Then re-run
autoreconf -i
./configure
make

Now you have rkdeveloptool executable at the current directory.

sudo cp rkdeveloptool /usr/local/bin/
</div>
</div>

=== Boot the board to maskrom mode ===

To boot ROCK Pi into maskrom mode is simple:

* 1. Power off the board
** remove microSD card
** remove the eMMc Module
* 2. Plug the USB Male A to Mail A cable to ROCK 3 OTG port(the upper USB3 port), the other side to PC
* 3. Short the follow pins, power on the board, and then disconnect the pins.

[[File:3a-maskrom.png | 400px]]

** 4. For Linux/macOS

Now on your Linux PC, '''lsusb''' command show show the following usb devices

Bus 003 Device 005: ID 2207:330c

** 4. For Windows

Open device manager in your Windows PC, check the Device Manager:

[[File:RK_Driver_Assistant_Install_Usb_driver.png]]

It means the device is in '''maskrom mode''' now.

* 5. Now plug the eMMC module and proceed the next step to flash.

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 AndroidTool '''Switch''' button to go to maskrom mode.

=== Begin Installation USB -> eMMC ===
<div class="toccolours mw-collapsible " style="width:800px; overflow:auto;">
==== Linux/macOS ====
<div class="mw-collapsible-content">
On your PC, run the rkdeveloptool

rkdeveloptool ld # List the device
DevNo=1 Vid=0x2207,Pid=0x330c,LocationID=305 Maskrom

Download the loader (flash helper) to init the ram and prepare the flashing environment etc. If you don't have it, you can download it from [https://dl.radxa.com/rock3/images/loader/ here]

rkdeveloptool db rk356x_loader_vxxxx.bin

Write the GPT image to eMMC, start to write from offset '''0'''.

rkdeveloptool wl 0 /path/to/rock3a-xxx-gpt.img

Reboot the device

rkdeveloptool rd

Now the device should boot the new image on eMMC

Please notice that when you want to erase eMMC on board, you can use this command. Get zero.img from [https://dl.radxa.com/rockpi4/images/others/zero.img.gz here].

rkdeveloptool db rk356x_loader_vxxxx.bin
rkdeveloptool wl 0 zero.img

</div>
</div>

<div class="toccolours mw-collapsible" style="width:800px; overflow:auto;">

==== Windows ====
<div class="mw-collapsible-content">

Double click the '''RKDevTool.exe''' and you will see the following interface:

Double click this red box and modify it to '''image''' in the second row.

[[File:Modify-options.jpeg | 600px]]

===== Step 1: Select Loader =====
If your ROCK 3 is in maskrom mode and connects to PC, you can see that the program detect it '''Found one MASKROM Device''' in the red box

Next, click the button in the first row on the right last columns select the loader "rk356x_xxx_ loader_ xxxxx.bin ",

[[File:select-loader-bin.jpeg | 600px]]

''Note:'' the loader (flash helper) is used to init the ram and prepare the flashing environment etc.
If you don't have it, you can download it from [https://dl.radxa.com/rock3/images/loader/rk356x_spl_loader_ddr1056_v1.06.110.bin here]

===== Step 2: Select Image =====

Then click the right last columns to in the Image row and choose the image you want to flash.You can download the image from [https://wiki.radxa.com/Rock3/downloads here]

''Note'': Normally the image name should ends with xxx-gpt.img. If the image name ends with xxx-rkupdate.img, you can not flash with this method.

===== Step 3: Run =====

Finally, click the "run" button, and you will see the content on the right. When the progress reaches 100% or show '''Download image OK''' in the red box, the download is completed.

[[File:3a-run-image.jpeg | 600px]]
</div>
</div>

=== 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-emmc/11372

=== Troubleshooting ===

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

Rock5/install/spi

2022-10-19T14:51:56Z

Dominik:

{{rock5_header}}
{{Languages|rock5/dev/usb-install}}
[[rock5 | ROCK 5]] > [[rock5/install | Installation]] > [[rock5/install/spi | Install the Image to SPI Nor Flash]]

== Install the image to SPI Nor Flash from USB port ==

Rock 5 supports Maskrom mode, which is a special operation mode for CPU to wait for USB OTG port command.
The PC tools we use to communicate with rock 5 in Maskrom mode are the '''rkdeveloptool''' and '''[https://dl.radxa.co/tools/windows/windows_RKDevTool_Release_v2.92.zip RKDevTool v2.92]'''.
We use '''the rkdeveloptool in Linux/macOS ''' and '''the [https://dl.radxa.co/tools/windows/windows_RKDevTool_Release_v2.92.zip RKDevTool] under Windows'''.

=== Requirement ===

* ROCK 5B
* Linux image for ROCK 5B, Android image is not supported yet
* type-c cable
* SPI Nor Flash on board
* Windows/linux/macOS PC

=== Install Tools&Drivers ===

Please check this guide, [[rock5/install/rockchip-flash-tools | Install rockchip flash tools under Windows/Linux/MacOS PC]].

=== Boot the board to Maskrom mode ===

[[File:Rock-5b-typec-maskrom.jpeg|400px]]

To boot ROCK 5B to Maskrom mode is simple:

* Power off the board.
* Remove bootable device like MicroSD card, eMMC module, etc.
* Press the golden (or silver on some board revisions) button and hold it.
* Plug the USB-A to Type-C cable to ROCK 5B Type-C port, the other side to PC.
* Release the golded button.
* Check usb device
** For macOS host: lsusb result: '''Bus 002 Device 032: ID 2207:350b Fuzhou Rockchip Electronics Co., Ltd. Composite Device'''
** For Linux host: lsusb result: '''Bus 001 Device 112: ID 2207:350b Fuzhou Rockchip Electronics Company'''
** For Windows host: Open RKDevTool and you would see the device is in '''Found One MASKROM Device'''.

=== Get RK3588 loader and U-Boot images ===

==== ROCK 5B ====
bin
* [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/rk3588_spl_loader_v1.08.111.RK3588 loader]
* [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/rock-5b-spi-image-g49da44e116d.img ROCK 5B SPI image]
** SPI image version
*** [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/release release version] without u-boot log
*** [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/debug debug version] with u-boot log

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

==== Linux/MacOS ====

On your PC, run the rkdeveloptool

sudo rkdeveloptool ld
DevNo=1 Vid=0x2207,Pid=0x350b,LocationID=106 Maskrom

Download the loader (flash helper) to init the ram and prepare the flashing environment etc. If you don't have it, you can download it from [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/rk3588_spl_loader_v1.08.111.bin here]

sudo rkdeveloptool db /path/to/rk3588_spl_loader_v1.08.111.bin # will output:
Downloading bootloader succeeded.

Write SPI image to SPI Nor Flash on board.

You can use our pre-built files.

sudo rkdeveloptool wl 0 rock-5b-spi-image-g49da44e116d.img
Write LBA from file (100%)

Reboot the device
rkdeveloptool rd

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

==== Windows ====

Double click the RKDevTool.exe and you will see the following interface:
Double click the '''RKDevTool.exe''' and you will see the following interface:

===== Step 1: comfirm that ROCK 5B is in Maskrom mode =====

If your ROCK 5B is in maskrom mode and connects to PC, you can see that the program detects it, as the red arrow below

===== Step 2: Select Loader =====

Next, click the right last columns in the "Loader" row to select rk3588_spl_loader_v1.08.111.bin

===== Step 3: Select SPI image =====

Next, click the right last columns in the "spi" row to select spi-image.

===== Step 4: Excute =====

Finally, click the "Excute" button, and you will see the content in the red box on the right. When the progress reaches 100%, the download is completed.

[[File: rock-5b-spi-flash-1.png |1000px]]

[[File: rock-5b-spi-flash-02.png |1000px]]

== Erase SPI Nor Flash ==

=== Linux/MacOS ===

Please notice that when you want to erase SPI Nor Flash, fire these commands. If you don't have zero.img, download this one please. [https://dl.radxa.com/rock5/sw/images/others/zero.img.gz zero.img]
And extract it.

rkdeveloptool db rk3588_spl_loader_v1.08.111.bin
rkdeveloptool wl 0 zero.img
rkdeveloptool rd

=== Windows ===

Before Erasing, please comfirm that ROCK 5B is in Maskrom mode

==== Step 1: Download ====
Choose the "Advanced features" button, then select rk3588_spl_loader_v1.08.111.bin, next click the "Download" button

==== Step 2: Erase all ====
Click the "erase all" button

==== Step 3: Reboot device ====

[[File: eraseall.jpg |700px]]

=== Verify Loader version ===

Version is display on UART console when board starts, one of the very first lines (older vs updated):
DDR Version V1.07 20220412
DDR Version V1.08 20220617

=== Troubleshooting ===

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

Rock3/downloads

2022-06-30T08:38:42Z

Dominik:

{{rock3_header}}
{{Languages|rock3/downloads}}

__NOTOC__

Official ROCK Pi system images can also be downloaded from

* '''[http://rock.sh/rockpi-baidupan ROCK Pi BaiduPan]'''
* '''[https://github.com/radxa/debos-radxa/releases/latest ROCK 3 Image Release]''' - The latest system images.

For usernames and passwords please check the [https://wiki.radxa.com/Rock/FAQ#What.27s_the_user_and_password_in_Lubuntu FAQ].

<div class="col-md-12">
====<span class="label forest"><i class="fa fa-wrench" ></i> Tools</span>====
<div class="table-responsive">
<table class="table table-hover table-bordered table-striped">
<tr>
<th>Description</th>
<th>Linux</th>
<th>MacOS</th>
<th>Windows</th>
</tr>
<tr>
<td><small>Etcher - A user friendly Image Writer</small></td>
<td>[https://github.com/balena-io/etcher/releases/download/v1.4.9/balena-etcher-electron-1.4.9-linux-x64.zip Linux 64bit] | [https://github.com/balena-io/etcher/releases/download/v1.4.9/balena-etcher-electron-1.4.9-linux-ia32.zip Linux 32bit]</td>
<td>[https://github.com/balena-io/etcher/releases/download/v1.4.9/balenaEtcher-1.4.9.dmg balenaEtcher-1.4.9.dmg]</td>
<td>[https://github.com/balena-io/etcher/releases/download/v1.4.9/balenaEtcher-Setup-1.4.9-x86.exe balenaEtcher-Setup-1.4.9-x86.exe]</td>
</tr>
</table>
</div>
</div>

<div class="col-md-12">
====<span class="label forest"><i class="fa fa-android" ></i> Official Images</span>====
<div class="table-responsive">
<table class="table table-hover table-bordered table-striped">
<tr>
<th>Distribution</th>
<th>Supoprted Boards</th>
<th>Description</th>
</tr>

<tr>
<td>[[File:Android-Logo.jpg | 200px | link=https://github.com/radxa/manifests]]</td>

<td>
* [https://dl.radxa.com/rock3/images/android/rock3a-android11-20220408_1204-gpt.img.xz ROCK 3A]
* [https://dl.radxa.com/rock3/images/android/rock3b-android11-20220408_1204-gpt.img.xz ROCK 3B]
* [https://dl.radxa.com/rock3/images/android/rock_cm3io-android11-20220408_1204-gpt.img.xz Radxa CM3 IO]
</td>
<td>
Version: Android11-20220408_1204

ROCK 3A/3B [https://wiki.radxa.com/Rock3/install/usb-install Install Wiki.]

CM3 IO [https://wiki.radxa.com/Rock3/installusb-install-radxa-cm3-io Install Wiki.]
</td>

</tr>

<tr>
<td>[[File:Debian-logo.png | 200px | link=https://github.com/radxa-build]]</td>
<td>
* [https://github.com/radxa-build/rock-3a/releases/latest ROCK 3A]
* [https://github.com/radxa-build/rock-3b/releases/latest ROCK 3B]
* [https://github.com/radxa-build/radxa-cm3-io/releases/latest Radxa CM3 IO]
* [https://github.com/radxa-build/radxa-cm3-io/releases/latest Radxa CM3 RASPCM4IO]*
* [https://github.com/radxa-build/radxa-e23/releases/latest Radxa E23]
* [https://github.com/radxa-build/radxa-e25/releases/latest Radxa E25]
</td>
<td>
Debian Product.

[https://wiki.radxa.com/Rock3/Debian Install Wiki.]

Debian Buster (10).

[https://github.com/radxa/debos-radxa/releases/latest Change Log].

User of Radxa CM3 RASPCM4IO will need to manually update /boot/uEnv.txt to use rk3566-radxa-cm3-rpi-cm4-io.dtb.
</td>
</tr>

<tr>
<td>[[File:Ubuntu_logo.png | 200px | link=https://github.com/radxa-build]]</td>
<td>
* [https://github.com/radxa-build/rock-3a/releases/latest ROCK 3A]
* [https://github.com/radxa-build/rock-3b/releases/latest ROCK 3B]
* [https://github.com/radxa-build/radxa-cm3-io/releases/latest Radxa CM3 IO]
* [https://github.com/radxa-build/radxa-cm3-io/releases/latest Radxa CM3 RASPCM4IO]*
* [https://github.com/radxa-build/radxa-e23/releases/latest Radxa E23]
* [https://github.com/radxa-build/radxa-e25/releases/latest Radxa E25]
</td>
<td>
Ubuntu Server Product.

[https://wiki.radxa.com/Rock3/Ubuntu Install Wiki.]

Ubuntu Server 20.04.

[https://github.com/radxa/debos-radxa/releases/latest Change Log].

User of Radxa CM3 RASPCM4IO will need to manually update /boot/uEnv.txt to use rk3566-radxa-cm3-rpi-cm4-io.dtb.
</td>
</tr>

</table>
</div>
</div>

<div class="col-md-12">

====<span class="label forest" style="margin-bottom:5px;"><i class="fa fa-linux"></i> Third Party Images</span>====
<div class="table-responsive">
<table align="center" class="table table-bordered table-striped">


<tr>
<div class="col-md-2 mwbs-color-darker">
<th width="8%">
<div class="thumbnail" style="display: table-cell;">[[File:Armbian-logo.png | link=https://discord.com/channels/855634073376260096/888960277788393553/912495051010084895]]
</div>
</th>
<th width="45%" style="vertical-align: middle;">
<div class="caption" style="text-align: left;padding-left: 10px;">
<h5 class="text-center" style="display: inline;">
<p class="text-left" >[https://www.armbian.com/rock-3a/ Armbian]</p>
</h5>
</div>
</th>
<th style="vertical-align: middle;">
<div class="caption" style="text-align: left;padding-left: 10px;">
<p class="text-left" >Build 2021-11-23.</p>
<p class="text-left" >user : pi , password : armbian</p>
<p class="text-left" >[https://discord.com/channels/855634073376260096/888960277788393553/912495237748899851 Discord discussion]</p>
</div>
</th>
</div>
</tr>


<tr>
<div class="col-md-2 mwbs-color-darker">
<th width="8%">
<div class="thumbnail" style="display: table-cell;">[[File:Cruxlogo.png | link=http://dl.slarm64.org/crux/images/rock_3/]]
</div>
</th>
<th width="45%" style="vertical-align: middle;">
<div class="caption" style="text-align: left;padding-left: 10px;">
<h5 class="text-center" style="display: inline;">[https://dl.slarm64.org/crux/images/rock_3/crux-arm-3.6-aarch64-core-rock_3-4.19.245-build-20220525.img.zst CRUX-ARM]</h5>
</div>
</th>
<th style="vertical-align: middle;">
<div class="caption" style="text-align: left;padding-left: 10px;">
<p class="text-left" >Build 2022-05-25.</p>
<p class="text-left" >[http://dl.slarm64.org/slackware/images/rock_3/README.TXT README.TXT].</p>
<p class="text-left" >[https://forum.radxa.com/t/rock-3-crux-arm-aarch64/7183 Forum discussion]</p>
</div>
</th>
</div>
</tr>


<tr>
<div class="col-md-2 mwbs-color-darker">
<th width="8%">
<div class="thumbnail" style="display: table-cell;">[[File:Logo.png | link=https://manjaro.org/download]]
</div>
</th>
<th width="45%" style="vertical-align: middle;">
<div class="caption" style="text-align: left;padding-left: 10px;">
=====[https://github.com/manjaro-arm/rock3-a-images/releases Manjaro Image Release]=====
</div>
</th>
<th style="vertical-align: middle;">
<div class="caption" style="text-align: left;padding-left: 10px;">
<p class="text-left" style="display: inline;">Manjaro Product.</p>
<p class="text-left" style="display: inline;">[https://www.manjaro.org/ Install Wiki]</p>
<p class="text-left" >[https://discord.com/channels/855634073376260096/866316562520473600/916175047390003270 Discussion Discord]</p>
</div>
</th>
</div>
</tr>


<tr>
<div class="col-md-2 mwbs-color-darker">
<th width="8%">
<div class="thumbnail" style="display: table-cell;">[[File:Slackware-logo.png | link=http://dl.slarm64.org/slackware/images/rock_3/]]
</div>
</th>
<th width="45%" style="vertical-align: middle;">
<div class="caption" style="text-align: left;padding-left: 10px;">
<h5 class="text-center" style="display: inline;">
<p class="text-left" >[https://dl.slarm64.org/slackware/images/rock_3/slarm64-current-aarch64-server-rock_3-5.17.8-build-20220516.img.zst Slarm64 Server (unofficial slackware)]</p>
<p class="text-left" >[https://dl.slarm64.org/slackware/images/rock_3/slarm64-current-aarch64-xfce-rock_3-5.17.8-build-20220516.img.zst Slarm64 XFCE (unofficial slackware)]</p>
</h5>
</div>
</th>
<th style="vertical-align: middle;">
<div class="caption" style="text-align: left;padding-left: 10px;">
<p class="text-left" >Build 2022-05-16.</p>
<p class="text-left" >[http://dl.slarm64.org/slackware/images/rock_3/README.TXT README.TXT].</p>
<p class="text-left" >[https://forum.radxa.com/t/rock-3-slarm64-aarch64-unofficial-slackware/7167/7 Forum discussion]</p>
</div>
</th>
</div>
</tr>

</table>
</div>
</div>

<div class="col-md-12">

====<span class="label forest" style="margin-bottom:5px;"><i class="fa fa-linux"></i> Community Built Images</span>====
<div class="table-responsive">
<table align="center" class="table table-bordered table-striped">

<tr>
<div class="col-md-2 mwbs-color-darker">
<th width="8%">
<div class="thumbnail" style="display: table-cell;">[[File:Community-logo.png | link=https://wiki.radxa.com/rock3/downloads/community_built_images]]
</div>
</th>
<th width="45%" style="vertical-align: middle;">
<div class="caption" style="text-align: left;padding-left: 10px;">
<h5 class="text-center" style="display: inline;">[https://wiki.radxa.com/rock3/downloads/community_built_images Community Image]</h5>
</div>
</th>
<th style="vertical-align: middle;">
<div class="caption" style="text-align: left;padding-left: 10px;">
<p class="text-left" style="display: inline;">Image built by Community members</p>
</div>
</th>
</div>
</tr>
</table>
</div>
</div>

Rock3/hardware/emmc

2022-01-21T10:54:05Z

Dominik:

{{rock3_header}}
{{Languages|rock3/hardware/eMMC}}

[[rock3 | ROCK 3]] > [[rock3/hardware | Hardware]] > [[rock3/hardware/emmc | eMMC Module]]

=== Introduction ===

ROCK 3 doesn't come with on board storag. It uses the eMMC module instead. The benefits of eMMC module is that the user can choose the storage as they need, it reduces the main board SKU for us. Also, pluggable eMMC module makes switching OS possible.

=== eMMC module ===

[[File:Emmc_module_black_top.png | 100px]] [[File:Emmc_module_black_bottom.png |100px]]

'''Note''': the green PCB and black PCB are the same, just color difference.

The eMMC socket on ROCK 3 uses two B2B connector to mount the eMMC module, the connector model is [http://www.lsmtron.com/pdf/Connector&Antenna_catalog.PDF GB042 Series], one connector(34pin) for eMMC signal, the other(30pin) is for mount purpose only. This pinout of the 34pin is compatible with Odroid(Thanks Odroid for sharing their pinout).

* on ROCK 3: GB042-34P-H10 (plug-34pin) + GB042-30P-H10 (plug-30pin)
* on eMMC module: GB042-34S-H10 (socket-34pin) + GB042-30S-H10 (socket-30pin)

The eMMC chip we use is branded as Foresee, by Longsys, a Shenzhen embedded storage company, who acquired Lexar Brand in 2017.

* [https://dl.radxa.com/rockpi/docs/hw/Test_Report_NCEMASLD-32G_20180313.pdf Download Foresee eMMC chip test report]

=== Benchmarks ===

Below is the test we did on different brand eMMC chips.

==== dd ====

dd if=/dev/zero of=/dev/mmcblk1 bs=1G count=1 oflag=direct
dd if=/dev/mmcblk1 of=/dev/null bs=1G count=1

result:
<pre>

| | brand | read | write |
| ---- | --------- | ------- | -------- |
| 8G | Sandisk | 270MB/s | 39.4MB/s |
| 16G | Sandisk | 230MB/s | 79.6MB/s |
| 16G | Kingston | 160MB/s | 50.1MB/s |
| 16G | Foresee | 189MB/s | 74.4MB/s |
| 16G | Foresee | 241MB/s | 79.5MB/s |
| 32G | Sandisk | 263MB/s | 139MB/s |
| 32G | Samsung | 263MB/s | 78.3MB/s |
| 32G | Kingston | 152MB/s | 87.2MB/s |
| 64G | Sandisk | 207MB/s | 100MB/s |
| 64G | Foresee | 215MB/s | 148MB/s |
| 64G | Foresee | 194MB/s | 148MB/s |
| 128G | Toshiba | 217MB/s | 143MB/s |
| 64G | Sandisk | 295MB/s | 240MB/s |
| 32G | SiliconGo | 250MB/s | 135MB/s |

</pre>

==== fio ====

1M Seq

fio --name=write --ioengine=libaio --iodepth=4 --rw=write --bs=1M --direct=1 --size=2G --numjobs=30 --runtime=60 --group_reporting --filename=/dev/mmcblk1

fio --name=read --ioengine=libaio --iodepth=4 --rw=read --bs=1M --direct=1 --size=2G --numjobs=30 --runtime=60 --group_reporting --filename=/dev/mmcblk1

4K random

fio --name=randwrite --ioengine=libaio --iodepth=4 --rw=randwrite --bs=4K --direct=1 --size=2G --numjobs=30 --runtime=60 --group_reporting --filename=/dev/mmcblk1

fio --name=randread --ioengine=libaio --iodepth=4 --rw=randread --bs=4K --direct=1 --size=2G --numjobs=30 --runtime=60 --group_reporting --filename=/dev/mmcblk1

result:

* Check full result at [https://gist.github.com/hipboi/4751181c26670af1a53096795a13f93d Github].

=== Dimension ===

* [https://dl.radxa.com/accessories/emmc-module/emmc_module_v1.1_20190402.dxf Download 2D .dxf file for eMMC module]

=== eMMC2sd adapter ===

[[File:Emmc2sd_adapter.png | 100px]]

With eMMC2sd adapter board, the user can write the image from PC with uSD card reader.

Adapter is not detected by some Lenovo/Dell internal UHS SD card readers. Read/write speeds with this adapter are significantly lower than on rock3.

=== USB3 eMMC Reader ===

* Check [[rock3/hardware/usb3_eMMC_reader| USB3 eMMC reader]] page

Rock3/hardware/emmc

2022-01-21T10:51:57Z

Dominik:

{{rock3_header}}
{{Languages|rock3/hardware/eMMC}}

[[rock3 | ROCK 3]] > [[rock3/hardware | Hardware]] > [[rock3/hardware/emmc | eMMC Module]]

=== Introduction ===

ROCK 3 doesn't come with on board storag. It uses the eMMC module instead. The benefits of eMMC module is that the user can choose the storage as they need, it reduces the main board SKU for us. Also, pluggable eMMC module makes switching OS possible.

=== eMMC module ===

[[File:Emmc_module_black_top.png | 100px]] [[File:Emmc_module_black_bottom.png |100px]]

'''Note''': the green PCB and black PCB are the same, just color difference.

The eMMC socket on ROCK 3 uses two B2B connector to mount the eMMC module, the connector model is [http://www.lsmtron.com/pdf/Connector&Antenna_catalog.PDF GB042 Series], one connector(34pin) for eMMC signal, the other(30pin) is for mount purpose only. This pinout of the 34pin is compatible with Odroid(Thanks Odroid for sharing their pinout).

* on ROCK 3: GB042-34P-H10 (plug-34pin) + GB042-30P-H10 (plug-30pin)
* on eMMC module: GB042-34S-H10 (socket-34pin) + GB042-30S-H10 (socket-30pin)

The eMMC chip we use is branded as Foresee, by Longsys, a Shenzhen embedded storage company, who acquired Lexar Brand in 2017.

* [https://dl.radxa.com/rockpi/docs/hw/Test_Report_NCEMASLD-32G_20180313.pdf Download Foresee eMMC chip test report]

=== Benchmarks ===

Below is the test we did on different brand eMMC chips.

==== dd ====

dd if=/dev/zero of=/dev/mmcblk1 bs=1G count=1 oflag=direct
dd if=/dev/mmcblk1 of=/dev/null bs=1G count=1

result:
<pre>

| | brand | read | write |
| ---- | -------- | ------- | -------- |
| 8G | Sandisk | 270MB/s | 39.4MB/s |
| 16G | Sandisk | 230MB/s | 79.6MB/s |
| 16G | Kingston | 160MB/s | 50.1MB/s |
| 16G | Foresee | 189MB/s | 74.4MB/s |
| 16G | Foresee | 241MB/s | 79.5MB/s |
| 32G | Sandisk | 263MB/s | 139MB/s |
| 32G | Samsung | 263MB/s | 78.3MB/s |
| 32G | Kingston | 152MB/s | 87.2MB/s |
| 64G | Sandisk | 207MB/s | 100MB/s |
| 64G | Foresee | 215MB/s | 148MB/s |
| 64G | Foresee | 194MB/s | 148MB/s |
| 128G | Toshiba | 217MB/s | 143MB/s |
| 64G | Sandisk | 295MB/s | 240MB/s |
| 32G | SiliconGo | 250MB/s | 135MB/s |

</pre>

==== fio ====

1M Seq

fio --name=write --ioengine=libaio --iodepth=4 --rw=write --bs=1M --direct=1 --size=2G --numjobs=30 --runtime=60 --group_reporting --filename=/dev/mmcblk1

fio --name=read --ioengine=libaio --iodepth=4 --rw=read --bs=1M --direct=1 --size=2G --numjobs=30 --runtime=60 --group_reporting --filename=/dev/mmcblk1

4K random

fio --name=randwrite --ioengine=libaio --iodepth=4 --rw=randwrite --bs=4K --direct=1 --size=2G --numjobs=30 --runtime=60 --group_reporting --filename=/dev/mmcblk1

fio --name=randread --ioengine=libaio --iodepth=4 --rw=randread --bs=4K --direct=1 --size=2G --numjobs=30 --runtime=60 --group_reporting --filename=/dev/mmcblk1

result:

* Check full result at [https://gist.github.com/hipboi/4751181c26670af1a53096795a13f93d Github].

=== Dimension ===

* [https://dl.radxa.com/accessories/emmc-module/emmc_module_v1.1_20190402.dxf Download 2D .dxf file for eMMC module]

=== eMMC2sd adapter ===

[[File:Emmc2sd_adapter.png | 100px]]

With eMMC2sd adapter board, the user can write the image from PC with uSD card reader.
Adapter is not detected by some Lenovo/Dell internal UHS SD card readers. Read/write speeds with this adapter are significantly lower than on rock3.

=== USB3 eMMC Reader ===

* Check [[rock3/hardware/usb3_eMMC_reader| USB3 eMMC reader]] page