{{rock5_header}}
{{Languages|rock5/downloads}}

__NOTOC__

Official ROCK images can also be downloaded from

* '''[http://rock.sh/rockpi-baidupan BaiduPan(China)]'''
* '''[https://github.com/radxa/debos-radxa/releases/latest ROCK 5 Image Development Build]''' - 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].

==== Tools====
<div class="table-responsive">
<table class="table table-hover table-bordered table-striped" style="text-align:center">
<tr>
<th>Description</th>
<th>Linux</th>
<th>MacOS</th>
<th>Windows</th>
</tr>
<tr>
<td>[https://www.balena.io/etcher Balena Etcher - A user friendly Image Writer]</td>
<td>[https://github.com/balena-io/etcher/releases/download/v1.10.6/balenaEtcher-1.10.6-x64.AppImage 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.10.6/balenaEtcher-1.10.6.dmg balenaEtcher-1.10.6.dmg]</td>
<td>[https://github.com/balena-io/etcher/releases/download/v1.10.6/balenaEtcher-Portable-1.10.6.exe balenaEtcher-Portable-1.10.6.exe]</td>
</tr>









</table>
</div>

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

==== Official Images====

{| class="wikitable" style="text-align: center"
|-
! style="width: 20%" | Distribution
! style="width: 30%" | Supported Boards
! style="width: 50%" | Description
|-
| [[File:Android-Logo.jpg | 200px | link=https://github.com/radxa/manifests]]
|
* [https://github.com/radxa/manifests/releases ROCK 5B]
|
|-
| [[File:Debian-logo.png | 200px | link=https://github.com/radxa-build]]
|
* [https://github.com/radxa/debos-radxa/releases/download/20221031-1045/rock-5b-debian-bullseye-xfce4-arm64-20221031-1558-gpt.img.xz ROCK 5B]
| Debian Product. 
[[Rock5/linux/debian | Installation Wiki]] 
Debian 11 Bullseye 
[https://github.com/radxa/debos-radxa/releases/latest Change Log].
|-
| [[File:Ubuntu_logo.png | 200px | link=https://github.com/radxa-build]]
|

* [https://github.com/radxa/debos-radxa/releases/download/20221031-1045/rock-5b-ubuntu-focal-server-arm64-20221031-1328-gpt.img.xz ROCK 5B]

| Ubuntu Server Product. 
[[Rock5/linux/ubuntu | Installation Wiki]] 
Ubuntu Server 20.04. 
[https://github.com/radxa/debos-radxa/releases/latest Change Log].
|}

==== Third Party Images====
<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:rebornos-arm.png| link=https://github.com/RebornOS-Developers/lxqt-rock5b-image/releases/download/92bb9c6/RebornOS-ARM-rock5b-2023-01-22.img.xz]]
</div>
</th>
<th width="45%" style="vertical-align: middle;">
<div class="caption" style="text-align: left;padding-left: 10px;">
=====[https://github.com/RebornOS-Developers/lxqt-rock5b-image/releases/download/92bb9c6/RebornOS-ARM-rock5b-2023-01-22.img.xz RebornOS ARM Rock5B Beta]=====

</div>
</th>
<th style="vertical-align: middle;">
<div class="caption" style="text-align: left;padding-left: 10px;">
RebornOS ARM on Arch.
[https://discord.gg/K3BKe2A9 Discussion Discord]
username and password are set upon installation
Live w/Calamares for custom tailored installation of over 10 DE’s based on preference. 
Installation Wiki [https://wiki.rebornos.org/arm/install]
'''Rolling ARM Distribution - - Made for you, made with you.'''
</div>
</th>
</div>
</tr>

</table>
</div>

==== Community Built Images====

Rock5/downloads

2023-02-02T01:28:14Z

Potter-91: /* Tools */

Rock5/downloads

2023-02-02T00:33:51Z

Potter-91:

Rock5/install/spi

2023-02-01T23:59:06Z

Potter-91: /* 3) Flash the SPI flash */

{{rock5_header}}
{{Languages|rock5/dev/spi}}

[[rock5 | ROCK 5]] > [[rock5/install | Installation]] > [[rock5/install/spi | Install the bootloader to the SPI NOR flash]]

ROCK 5 has a SPI flash on the board, it contains the bootloader for backup booting and supports booting other media that the SoC maskrom mode itself does not direct support (such as NVMe, SATA or USB 3).

This page describe how to write/install the bootloader to the SPI flash on the ROCK 5B.

There are two methods available to flash the SPI:
*[[#Simple_method | simple method]] - flash the SPI from the ROCK 5 itself
*[[#Advanced_(external)_method | advanced method]] - flash the SPI with the maskrom mode and an external computer

For advanced users:
[[#Addition:_erase_the_SPI_NOR_flash | How to erase the SPI]]

----

= Simple method =

== Requirements ==

* ROCK 5B with proper power
* SD card or eMMC module
* Linux image for ROCK 5B - ''(Android images are not supported yet)''

== Procedure ==

=== 1) Boot linux from µSD card/eMMC ===

The first step is to boot the ROCK 5 with linux from an µSD card or an eMMC module.

''(check [[rock5/install/microSD | this guide]] to flash a new image to an µSD card''
''or check [[rock5/install/eMMC | this guide]] to flash a new image to an eMMC module)''

=== 2) Download required files on the ROCK 5 ===

You can download files by using <code>wget DOWNLOADURLTOTHEFILE</code>

''for example to download the file to clear the spi: <code>wget https://dl.radxa.com/rock5/sw/images/others/zero.img.gz</code>''

Download the:
* [https://dl.radxa.com/rock5/sw/images/others/zero.img.gz spi clearing file]

and the latest SPI bootloader:
* [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/release/rock-5b-spi-image-g49da44e116d.img normal bootloader], recommend for everything except armbian - ''(for advanced users: this has the u-boot serial console disabled)''
* [https://github.com/huazi-yg/rock5b/releases/download/rock5b/rkspi_loader.img bootloader for armbian] (Use this if you like to boot armbian from the M.2 NVME SSD)

* or for advanced users the [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/debug/rock-5b-spi-image-g3caf61a44c2-debug.img debuging bootloader] with u-boot serial console enabled ''(This is an debug bootloader if you need to troubleshoot booting issue with serial)''

=== 3) Flash the SPI flash ===

Make sure the SPI flash is available:
ls /dev/mtdblock*

It should give <code>/dev/mtdblock0</code> back

extract/uncompress the prevois downloaded SPI clearing file ''(gzip should already be installed otherwise install it):''
gzip -d zero.img.gz

completely clear the SPI flash:
sudo dd if=zero.img of=/dev/mtdblock0

now write you desired bootloader to the SPI flash ''(replace <code>spi-image.img</code> with the name of you downloaded image - eg: <code>rock-5b-spi-image-g49da44e116d.img</code> for the normal bootloader):''

sudo dd if=spi-image.img of=/dev/mtdblock0
sync

=== 4) Reboot ===

Now you are done flashing a bootloader supporting NVMe booting.

''If you do not flashed the NVMe already check [[Rock5/install/nvme | this guide]] to flash it. (again there are two options available)''

Otherwise power off the ROCK 5, remove the µSD card or eMMC module and power it back up.

It should boot now from your NVMe. 😉

----

= Advanced (external) method =

== Requirements ==

* ROCK 5B with proper power
* Linux image for ROCK 5B, Android image is not supported yet
* SD card or eMMC module
* USB Type C cable
* Windows/linux/macOS PC

== Procedure ==

=== 1) Install Tools & Drivers ===

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

The PC tools we use to communicate with ROCK 5 in Maskrom mode are the '''rkdeveloptool''' on Linux/macOS and '''RkDevtool''' on Windows PC.

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

* Download the loader image from:
** [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/rk3588_spl_loader_v1.08.111.bin RK3588 loader] - USB flashing helper

* Download the latest SPI image from:
** [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/release/rock-5b-spi-image-g49da44e116d.img release version] with u-boot serial console disabled(Recommend)
** [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/debug/rock-5b-spi-image-g3caf61a44c2-debug.img debug version] with u-boot serial console enabled(Use it when you need to troubleshoot booting issue)
** [https://github.com/huazi-yg/rock5b/releases/download/rock5b/rkspi_loader.img armbian version] (Use it when you need to install the armbian Image to M.2 NVME SSD)

=== 3) 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: <code>lsusb</code> a result should be: <code>... ID 2207:350b Fuzhou Rockchip Electronics Co., Ltd. Composite Device</code>
** For Linux host: <code>lsusb</code> a result should be: <code>... ID 2207:350b Fuzhou Rockchip Electronics Company</code>
** For Windows host: Open RKDevTool and you would see the device is in '''Found One MASKROM Device'''

=== 4) Write u-boot images to SPI NOR flash or erase SPI NOR flash ===

==== Option 1: Flash with Linux PC/Mac ====

On linux or Mac, run the rkdeveloptool

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

This will load the loader (flash helper, downloaded from 2) to run on ROCK 5B and init the ram and prepare the flashing environment etc.

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

Next, write SPI image from PC/Mac to ROCK 5B SPI flash

You can use the image download from Step 2.

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'''.

==== Option 2: Flash with Windows PC ====

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: confirm 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: Load Configuration File ====

Right-click in the list box and select Load Config,Then select the configuration file in the resource management folder（The configuration file and RKDevTool are in the same directory）

==== Step 3: Select Loader ====

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

==== Step 4: Select SPI image ====

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

==== Step 5: 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: configuration.png |1000px]]

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

= Addition: erase the SPI NOR flash =

=== Option 1: Operate on ROCK 5B ===

Boot your ROCK 5B with linux running on µSD card or eMMC module:

Make sure the SPI flash is available:
ls /dev/mtdblock*

It should give <code>/dev/mtdblock0</code> back

sudo dd if=/dev/zero of=/dev/mtdblock0
sync

=== Option 2: Erase with Linux PC/Mac ===

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

=== Option 3: Erase with Windows PC ===

Before Erasing, please confirm that ROCK 5B is in maskrom mode

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

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

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

[[File: eraseall_new.png |700px]]

= Troubleshooting =

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

Rock5/install/spi

2023-02-01T23:58:06Z

Potter-91: /* 3) Flash the SPI flash */

{{rock5_header}}
{{Languages|rock5/dev/spi}}

[[rock5 | ROCK 5]] > [[rock5/install | Installation]] > [[rock5/install/spi | Install the bootloader to the SPI NOR flash]]

ROCK 5 has a SPI flash on the board, it contains the bootloader for backup booting and supports booting other media that the SoC maskrom mode itself does not direct support (such as NVMe, SATA or USB 3).

This page describe how to write/install the bootloader to the SPI flash on the ROCK 5B.

There are two methods available to flash the SPI:
*[[#Simple_method | simple method]] - flash the SPI from the ROCK 5 itself
*[[#Advanced_(external)_method | advanced method]] - flash the SPI with the maskrom mode and an external computer

For advanced users:
[[#Addition:_erase_the_SPI_NOR_flash | How to erase the SPI]]

----

= Simple method =

== Requirements ==

* ROCK 5B with proper power
* SD card or eMMC module
* Linux image for ROCK 5B - ''(Android images are not supported yet)''

== Procedure ==

=== 1) Boot linux from µSD card/eMMC ===

The first step is to boot the ROCK 5 with linux from an µSD card or an eMMC module.

''(check [[rock5/install/microSD | this guide]] to flash a new image to an µSD card''
''or check [[rock5/install/eMMC | this guide]] to flash a new image to an eMMC module)''

=== 2) Download required files on the ROCK 5 ===

You can download files by using <code>wget DOWNLOADURLTOTHEFILE</code>

''for example to download the file to clear the spi: <code>wget https://dl.radxa.com/rock5/sw/images/others/zero.img.gz</code>''

Download the:
* [https://dl.radxa.com/rock5/sw/images/others/zero.img.gz spi clearing file]

and the latest SPI bootloader:
* [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/release/rock-5b-spi-image-g49da44e116d.img normal bootloader], recommend for everything except armbian - ''(for advanced users: this has the u-boot serial console disabled)''
* [https://github.com/huazi-yg/rock5b/releases/download/rock5b/rkspi_loader.img bootloader for armbian] (Use this if you like to boot armbian from the M.2 NVME SSD)

* or for advanced users the [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/debug/rock-5b-spi-image-g3caf61a44c2-debug.img debuging bootloader] with u-boot serial console enabled ''(This is an debug bootloader if you need to troubleshoot booting issue with serial)''

=== 3) Flash the SPI flash ===

Make sure the SPI flash is available:
ls /dev/mtdblock*

It should give <code>/dev/mtdblock0</code> back

extract/uncompress the prevois downloaded SPI clearing file: ''(gzip should already be installed otherwise install it)''
gzip -d zero.img.gz

completely clear the SPI flash:
sudo dd if=zero.img of=/dev/mtdblock0

now write you desired bootloader to the SPI flash:

''(replace <code>spi-image.img</code> with the name of you downloaded image - eg: <code>rock-5b-spi-image-g49da44e116d.img</code> for the normal bootloader)''

sudo dd if=spi-image.img of=/dev/mtdblock0
sync

=== 4) Reboot ===

Now you are done flashing a bootloader supporting NVMe booting.

''If you do not flashed the NVMe already check [[Rock5/install/nvme | this guide]] to flash it. (again there are two options available)''

Otherwise power off the ROCK 5, remove the µSD card or eMMC module and power it back up.

It should boot now from your NVMe. 😉

----

= Advanced (external) method =

== Requirements ==

* ROCK 5B with proper power
* Linux image for ROCK 5B, Android image is not supported yet
* SD card or eMMC module
* USB Type C cable
* Windows/linux/macOS PC

== Procedure ==

=== 1) Install Tools & Drivers ===

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

The PC tools we use to communicate with ROCK 5 in Maskrom mode are the '''rkdeveloptool''' on Linux/macOS and '''RkDevtool''' on Windows PC.

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

* Download the loader image from:
** [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/rk3588_spl_loader_v1.08.111.bin RK3588 loader] - USB flashing helper

* Download the latest SPI image from:
** [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/release/rock-5b-spi-image-g49da44e116d.img release version] with u-boot serial console disabled(Recommend)
** [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/debug/rock-5b-spi-image-g3caf61a44c2-debug.img debug version] with u-boot serial console enabled(Use it when you need to troubleshoot booting issue)
** [https://github.com/huazi-yg/rock5b/releases/download/rock5b/rkspi_loader.img armbian version] (Use it when you need to install the armbian Image to M.2 NVME SSD)

=== 3) 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: <code>lsusb</code> a result should be: <code>... ID 2207:350b Fuzhou Rockchip Electronics Co., Ltd. Composite Device</code>
** For Linux host: <code>lsusb</code> a result should be: <code>... ID 2207:350b Fuzhou Rockchip Electronics Company</code>
** For Windows host: Open RKDevTool and you would see the device is in '''Found One MASKROM Device'''

=== 4) Write u-boot images to SPI NOR flash or erase SPI NOR flash ===

==== Option 1: Flash with Linux PC/Mac ====

On linux or Mac, run the rkdeveloptool

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

This will load the loader (flash helper, downloaded from 2) to run on ROCK 5B and init the ram and prepare the flashing environment etc.

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

Next, write SPI image from PC/Mac to ROCK 5B SPI flash

You can use the image download from Step 2.

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'''.

==== Option 2: Flash with Windows PC ====

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: confirm 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: Load Configuration File ====

Right-click in the list box and select Load Config,Then select the configuration file in the resource management folder（The configuration file and RKDevTool are in the same directory）

==== Step 3: Select Loader ====

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

==== Step 4: Select SPI image ====

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

==== Step 5: 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: configuration.png |1000px]]

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

= Addition: erase the SPI NOR flash =

=== Option 1: Operate on ROCK 5B ===

Boot your ROCK 5B with linux running on µSD card or eMMC module:

Make sure the SPI flash is available:
ls /dev/mtdblock*

It should give <code>/dev/mtdblock0</code> back

sudo dd if=/dev/zero of=/dev/mtdblock0
sync

=== Option 2: Erase with Linux PC/Mac ===

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

=== Option 3: Erase with Windows PC ===

Before Erasing, please confirm that ROCK 5B is in maskrom mode

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

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

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

[[File: eraseall_new.png |700px]]

= Troubleshooting =

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

Rock5/downloads

2023-02-01T23:55:15Z

Potter-91:

Rock5/5b/getting started

2023-02-01T23:16:46Z

Potter-91:

{{rock5_header}}
{{Languages|rock5/3a/getting_started}}

[[rock5 | ROCK 5]] > [[Rock5/5b | ROCK 5 Model B]] > [[Rock5/5b/getting_started | Getting started]]

__TOC__

= Getting Started =

This guide is designed for ROCK 5B enthusiast. The purpose is to learn about ROCK 5B as well as how to prepare and set up for basic use.
When you get a board, you need to know what model it is and which hardware version it is.
The information is printed in the top side of the board.
We will introduce the board information as much as possible.

== Close look of ROCK 5B ==
* ROCK 5B front view
[[File:Rock5b-v142-top.jpg|500px]]

* ROCK 5B front with an angle view
[[File:Rock5b-v142-angel.jpg|500px]]

* ROCK 5B back view
[[File:Rock5b-v142-bottom.jpg|500px]]

For the detailed hardware description and pinout, please refer [[Rock5/hardware/5b | ROCK 5B hardware page]].

== Features ==

== What you need ==

=== Necessary ===
* ROCK 5B main board

* One of the Storage media below:
** microSD, larger than 8GB
** eMMC module, larger than 8GB

* [[rock5/5b/power_supply | Power supply]]
** The ROCK 5B is powered by Type-C port and has a wide range of input voltage, from 5V to 21V. ROCK 5B supports USB Type-C PD 2.0 with 9V/2A, 12V/2A, 15V/2A and 20V/2A.
** The Type-C cable you using needs to support data communication. We call it USB Type-C charging data cable.

* USB Keyboard and Mouse
** With four USB-A connectors, ROCK 5B can be equipped with a full sized keyboard and mouse.

* Monitor and HDMI Cable
** ROCK 5B is equipped with a full sized HDMI connector. HDMI capable monitor is recommended.
** HDMI EDID display data is used to determine the best display resolution. On monitors and TVs that support 1080p (or 4K/8K) this resolution will be selected. If 1080p is not supported the next available resolution reported by EDID will be used. This selected mode will work with MOST but not all monitors/TVs.

*USB to TTL serial cable
**ROCK 5B exports a dedicated serial console for CPU, which can access the low level debug message.

*USB type A to type C cable
**If you want to write image on ROCK 5B from USB OTG port or use fastboot/adb commands you need an USB type A to type C cable to connect ROCK 5B and PC.

=== Optional ===

* microSD Card Reader
** For flashing the image to the microSD Card

* Ethernet cable
** ROCK 5B supports internet access via Ethernet.
** An Ethernet cable is used to connect your ROCK 5B to a local network and the Internet.

* USB type A to type C cable
** This is needed for fastboot/adb commands and the maskrom mode for advanced flashing.

* USB to TTL serial cable
** This is needed for serial console.

* Camera Module
** ROCK 5B supports camera function.

* LCD Module
** ROCK 5B supports LCD display function.

* Audio cable
** Audio can be played through speaker or headphones using a standard 3.5mm jack.

* [[rock5/hardware/wifi | WiFi/BT Cards]]

== Starting the board for the first time ==

ROCK 5B can be started with eMMC Module or μSD Card. Now, you are presented with three options when installing your new operating system onto your ROCK 5B.

=== Prepare ===
* When starting system with eMMC Module
(Option a) Insert the eMMC Module into ROCK Pi eMMC USB Reader. Then plug the ROCK Pi eMMC USB Reader into host PC.

(Option b) Insert eMMC Module into eMMC to μSD card converter board. Insert the converter board into μSD Card Reader. Then plug the Card Reader into host PC.

* When starting system with μSD Card
(Option c) Insert the μSD Card into μSD Card Reader. Then plug the Card Reader into host PC.

=== Write Image ===

* Download the official Ubuntu/Debian system image from [[rock5/downloads | Downloads]].

* Download the flash tool, etcher, from [[rock5/downloads | Downloads]]. Choose the right version for your host operation system. Here we operate on host Ubuntu 20.04.

* After unpacking the package, we run the tool by double-clicking BalenaEtcher icon.

If you get an error message: "No polkit authentication agent found" you can try and start it with sudo, but do know that this is running the tool as '''root'''.

* In the etcher window, click '''Select image'''.

[[File:etcher-rock-5b-1.png]]

* In the etcher window, click '''Select Drive'''.

[[File:etcher-rock-5b-2.png]]

* In the etcher window, click '''Flash'''.

[[File:etcher-rock-5b-3.png]]

* In the etcher window, once it shows us Flash Complete! It is done and can be put into the RockPi.

[[File:etcher-rock-5b-4.png]]

=== 3. Boot the board ===

* Now insert the system storage media, μSD Card or eMMC Module into the socket on the board.

* (Optional) Use the USB to TTL serial cable to setup a connection between PC and ROCK 5B board. See [[rock5/dev/serial-console | Serial Console]].

* Power on ROCK 5B by adapter with type C port.

* ROCK 5B will boot with the green power LED on. And after a while, another blue LED starts blinking.

=== 4. Access from the Host PC/Laptop ===

==== Option 1: HDMI monitor and Mouse ====

You would see Desktop on HDMI monitor.

==== Option 2: Serial console ====

Check [[rock5/dev/serial-console | Serial Console]]

==== Option 3: SSH ====
SSH server is enabled on port 22 of ROCK 5B default image.

Please use [https://angryip.org/ angryip] to find your board IP address.

To access ROCK 5B by SSH, try

ping rock-5b.local
ssh rock@rock-5b.local

or if your router/network doesn't support Local Domain, you need to check your network/router administrator page and look for the ROCK 5B ip address.

ping ip-of-device
ssh rock@ip-of-device

Note: You can also get the IP of ROCK 5B from option 1 if you can not access network administrator page.

=== 5.Network state ===

*Look at network configure:

$ sudo ifconfig

*Test network:

$ ping -c 5 www.google.com

=== 6.WIFI Connection ===

Check [[rock5/linux/debian#wifi-connection | WIFI Connection]].

=== 7.BT ===

Check [[rock5/linux/debian#BT | BT]].

=== 8.LED ===

ROCK 5B has Power LED and User LED.

* Power LED

The power LED is green. It is always on when ROCK 5B is connected to any power source.

* User LED

The user LED is blue. By default, its blink status shows the running kernel.

=== 9.GPIO ===

ROCK 5B has one 40-pin expansion headers. Each pin is distinguished by color, more information click [[rock5/hardware/5b/gpio | ROCK 5B GPIO]].

Development for GPIO. ROCK 5B supports libmraa GPIO library, click [[rock5/dev/libmraa | here]] to get more information.

== Next Step ==

* [[rock5/linux/debian | More Debian image usage and tips]]
* [[rock5/hardware | Checkout the hardware details]]
* Join the [https://forum.radxa.com/c/rock3 community] and the [https://t.me/rockpi4 discussion group]

2023-02-01T22:53:42Z

Potter-91:

2023-02-01T19:42:11Z

Potter-91:

{{rock5_header}}
{{Languages|rock5/dev/spi}}

[[rock5 | ROCK 5]] > [[rock5/install | Installation]] > [[rock5/install/spi | Install the image to SPI NOR flash]]

== Install the image to SPI NOR flash ==

ROCK 5 has a SPI flash on the board, it is useful to install the bootloader to the SPI flash for a back up booting and support other booting media that the SoC maskrom mode doesn't direct support, such as NVMe, SATA or USB 3.

This page describe how to write/install the image to the SPI flash on the ROCK 5B board.

There are two methods available:
*[[#Simple_Method | simple method]] - flash the SPI from the ROCK5 itself
*[[#Advanced_Method | advanced method]] - flash the SPI with an external computer

----

=== Simple Method ===

==== Requirements ====

* ROCK 5B with proper power
* SD card or eMMC module
* Linux image for ROCK 5B - ''(Android images are not supported yet)''

==== Procedere ====

===== 1) Flash linux to a µSD card/eMMC =====

The first step is to get a Debian or Ubuntu image from the [[rock5/downloads | downloads ]] section

* Download the latest SPI image from:
** [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/release/rock-5b-spi-image-g49da44e116d.img release version] with u-boot serial console disabled (Recommend)
** [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/debug/rock-5b-spi-image-g3caf61a44c2-debug.img debug version] with u-boot serial console enabled (Use it when you need to troubleshoot booting issue)
** [https://github.com/huazi-yg/rock5b/releases/download/rock5b/rkspi_loader.img armbian version] (Use it when you need to install the armbian image to M.2 NVME SSD)

----

=== Advanced (External) Method ===

==== Requirement ====

* ROCK 5B with proper power
* Linux image for ROCK 5B, Android image is not supported yet
* SD card or eMMC module
* USB Type C cable
* Windows/linux/macOS PC

=== Step 1: Install Tools & Drivers ===

Please check this guide, [[rock5/install/rockchip-flash-tools | Install rockchip flash tools under Windows/Linux/MacOS PC]]. The PC tools we use to communicate with ROCK 5 in Maskrom mode are the '''rkdeveloptool''' on Linux/macOS and '''RkDevtool''' on Windows PC.

=== Step 2: Get RK3588 loader and U-Boot images ===

==== For ROCK 5B ====

* Download the loader image from:
** [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/rk3588_spl_loader_v1.08.111.bin RK3588 loader] - USB flashing helper

* Download the latest SPI image from:
** [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/release/rock-5b-spi-image-g49da44e116d.img release version] with u-boot serial console disabled(Recommend)
** [https://dl.radxa.com/rock5/sw/images/loader/rock-5b/debug/rock-5b-spi-image-g3caf61a44c2-debug.img debug version] with u-boot serial console enabled(Use it when you need to troubleshoot booting issue)
** [https://github.com/huazi-yg/rock5b/releases/download/rock5b/rkspi_loader.img armbian version] (Use it when you need to install the armbian Image to M.2 NVME SSD)

=== Step 3: 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'''

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

==== Option 1: Operate on ROCK 5B ====

Boot your ROCK 5B with Linux running on SD card or eMMC module:

Make sure the SPI flash is available:
ls /dev/mtdblock*

sudo dd if=zero.img of=/dev/mtdblock0
sudo dd if=rock-5b-spi-image-g49da44e116d.img of=/dev/mtdblock0
sync

Get zero.img from [https://dl.radxa.com/rock5/sw/images/others/zero.img.gz here].

==== Option 2: Flash with Linux PC/Mac ====

On your PC or Mac, run the rkdeveloptool

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

This will load the loader (flash helper, downloaded from Step2) to run on ROCK 5B and init the ram and prepare the flashing environment etc.

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

Next, write SPI image from PC/Mac to ROCK 5B SPI flash

You can use the image download from Step 2.

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'''.

==== Option 3: Flash with Windows PC ====

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: Load Configuration File =====

Right-click in the list box and select Load Config,Then select the configuration file in the resource management folder（The configuration file and RKDevTool are in the same directory）

===== Step 3: Select Loader =====

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

===== Step 4: Select SPI image =====

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

===== Step 5: 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: configuration.png |1000px]]

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

== Addition: Erase the SPI Nor Flash ==

==== Option 1: Operate on ROCK 5B ====

Boot your ROCK 5B with Linux running on SD card or eMMC module:

Make sure the SPI flash is available:
ls /dev/mtdblk*

sudo dd if=/dev/zero of=/dev/mtdblock0
sync

==== Option 2: Erase with Linux PC/Mac ====

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

==== Option3: Erase with Windows PC====

Before Erasing, please confirm 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_new.png |700px]]

== Troubleshooting ==

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