This document describes how to install an Android image to the ROCK 5 ITX.

ROCK 5 ITX can be booted from microSD card , EMMC and SPI+NVME, depending on the boot method, the system will be installed on different media.

Install the operating system

Before starting ROCK 5 ITX using microSD card/eMMC, it is necessary to erase the SPI as follows:

1. Download the Loader file locally

• Loader: RK3588_SPL_Loader_v1.15.113.bin

• System Image: Radxa ROCK 5 ITX Debian Build 6

• SPI Image: spi_image.img

• Android: MiniLoader.bin

2. Enter maskrom mode

• Disconnect the board from the power supply.

• Remove the SD card and insert the eMMC module.

• Connect the USB3.0 port of the Radxa ROCK 5 ITX to the PC side with USB cable.

• Press and hold the Maskrom key，Power up the board.

• Remove the right yellow jumper cap and keep the left yellow jumper cap.

• Check for USB devices

  • Linux/macOS: Check if "Bus 001 Device 112: ID 2207:350a Fuzhou Rockchip Electronics Company" is displayed after running lsusb.
  • Windows: Open RKDevTool and you will see the device in "maskrom mode".

3. Erase SPI as follows

Windows

Windows use rkdevtool

Linux/Mac

Linux/Mac use rkdeveloptool

dd if=/dev/zero of=zero.img bs=16M count=1
rkdeveloptool db rk3588_spl_loader_v1.15.113.bin (select the loader file downloaded in step 1)
rkdeveloptool wl 0 zero.img
rkdeveloptool rd

Install system to microSD card

Preparation

• 1x microSD card (capacity >=16GB, speed level >= class10)
• 1x microSD card reader
• 12V DC Power Supply

Image Download

Please go to Resource Download Summary to download the corresponding image file.

Install the system

Balena Etcher is a cross-platform and user friendly image file burning tool that we recommend you use.

1. Download Etcher and install it.

Windows

Please download balenaEtcher-Setup-1.18.11.exe After the download is complete, there is no need to perform any additional actions. After downloading, you can double click it to open it without any additional operation.

Linux

Please download balena-etcher_1.18.11_amd64.deb. Once the download is complete, please install it by executing the following command in the terminal:

sudo dpkg -i balena-etcher_1.18.11_amd64.deb

2. Open Etcher

   

3. Open Etcher and click Flash from file to select the image to write to.

   

4. Click Select target to select the device, please select carefully.

   

5. Click Flash! Start writing and wait for the write progress bar to complete.

   

6. When writing the image successfully, Etcher will display Flash Complete!.

   

**If there is an error in flashing, please try again. **

Boot the system

• After successfully burning the microSD card as described above, insert the microSD card into the microSD slot of ROCK 5 ITX.
• Using a 12V DC power adapter to power the ROCK 5 ITX.

Reference Documentation

Installing the system to eMMC

Preparation

Prepare installation media

• Type-C to Type-A USB connector cable
• 1x eMMC module (On board)
• 12V DC Power Supply

Download the image

Please go to Resource Download Summary to download the corresponding image file.

System Installation

Enter maskrom mode

• Disconnect the board from the power supply.
• Remove the SD card
• Use Type-C to Type-A USB cable to connect ROCK 5 ITX and PC
• Press and hold the Maskrom key，Power up the board.
• Check for USB devices
  • Linux/macOS: Check if "Bus 001 Device 112: ID 2207:350a Fuzhou Rockchip Electronics Company" is displayed after running lsusb.
  • Windows: Open RKDevTool and you will see the device in "maskrom mode".

Linux

Install rkdeveloptool

rkdeveloptool is Rockchip's software for USB burning on Linux/macOS platforms.

The rkdeveloptool can be thought of as an upgrade_tool for the open source version.

If your operating system does not provide rkdeveloptool, you will need to compile and install it from source.

Debian

Execute the following command from the command line to install:

sudo apt-get update
sudo apt-get install -y libudev-dev libusb-1.0-0-dev dh-autoreconf pkg-config libusb-1.0 build-essential git wget
git clone https://github.com/rockchip-linux/rkdeveloptool
cd rkdeveloptool
wget https://patch-diff.githubusercontent.com/raw/rockchip-linux/rkdeveloptool/pull/73.patch
wget https://patch-diff.githubusercontent.com/raw/rockchip-linux/rkdeveloptool/pull/85.patch
git am *.patch
autoreconf -i
./configure
make -j $(nproc)
sudo cp rkdeveloptool /usr/local/sbin/

Ubuntu

Execute the following command from the command line to install:

sudo apt-get update
sudo apt-get install -y libudev-dev libusb-1.0-0-dev dh-autoreconf pkg-config libusb-1.0 build-essential git wget
git clone https://github.com/rockchip-linux/rkdeveloptool
cd rkdeveloptool
wget https://patch-diff.githubusercontent.com/raw/rockchip-linux/rkdeveloptool/pull/73.patch
wget https://patch-diff.githubusercontent.com/raw/rockchip-linux/rkdeveloptool/pull/85.patch
git am *.patch
autoreconf -i
./configure
make -j $(nproc)
sudo cp rkdeveloptool /usr/local/sbin/

On Ubuntu 22.10 and later you can install it from the command line: sudo apt-get install rkdeveloptool

ArchLinux

rkdeveloptool can be installed from the AUR .

Enter Maskrom Mode

Using rkdeveloptool

Write to a file

tip

rkdeveloptool does not automatically decompress compressed files when writing to them.

You must first extract the used files and specify the extracted files in rkdeveloptool.

tip

rkdeveloptool does not support the selection of a Maskrom device, nor the selection of a storage medium to be written to. Normally, when using rkdeveloptool, only one device and one storage medium are connected in hardware. This step cannot be controlled by software.

If you need to write to multiple devices at the same time, use upgrade_tool.

1. Extract the image file (See File Download above for details of the image file, here rock_debian_bullseye-_desktop_release_b1.img.xz is used as an example)

xz -d rock_debian_bullseye-_desktop_release_b1.img.xz (if the image file is gz format，then use `gunzip -d xxx.gz` command)

2. Flash Loader(See File Download above for details of the loader file，here rkxxxx_spl_loader_v1.xxx.bin is just an example)

sudo rkdeveloptool db rkxxxx_spl_loader_v1.xxx.bin

3. Flash System Image (Here rock_debian_bullseye-_desktop_release_b1.img is an example, use the file got from step1 as a replacement)

sudo rkdeveloptool wl 0 rock_debian_bullseye-_desktop_release_b1.img

Reboot

sudo rkdeveloptool rd

Login

After rebooting the device, you can log in to the system via HDMI or serial port.

mac

Install rkdeveloptool

rkdeveloptool is Rockchip's software for USB burning on Linux/macOS platforms.

The rkdeveloptool can be thought of as an upgrade_tool for the open source version.

If your operating system does not provide rkdeveloptool, you will need to compile and install it from source.

Please install Homebrew first and then run the following command from the command line to install it:

brew install automake autoconf libusb pkg-config git wget
git clone https://github.com/rockchip-linux/rkdeveloptool
cd rkdeveloptool
wget https://patch-diff.githubusercontent.com/raw/rockchip-linux/rkdeveloptool/pull/73.patch
wget https://patch-diff.githubusercontent.com/raw/rockchip-linux/rkdeveloptool/pull/85.patch
git am *.patch
autoreconf -i
./configure
make -j $(nproc)
cp rkdeveloptool /opt/homebrew/bin/

Enter Maskrom Mode

Using rkdeveloptool

Write to a file

tip

rkdeveloptool does not automatically decompress compressed files when writing to them.

You must first extract the used files and specify the extracted files in rkdeveloptool.

tip

rkdeveloptool does not support the selection of a Maskrom device, nor the selection of a storage medium to be written to. Normally, when using rkdeveloptool, only one device and one storage medium are connected in hardware. This step cannot be controlled by software.

If you need to write to multiple devices at the same time, use upgrade_tool.

1. Extract the image file (See File Download above for details of the image file, here rock_debian_bullseye-_desktop_release_b1.img.xz is used as an example)

xz -d rock_debian_bullseye-_desktop_release_b1.img.xz (if the image file is gz format，then use `gunzip -d xxx.gz` command)

2. Flash Loader(See File Download above for details of the loader file，here rkxxxx_spl_loader_v1.xxx.bin is just an example)

sudo rkdeveloptool db rkxxxx_spl_loader_v1.xxx.bin

3. Flash System Image (Here rock_debian_bullseye-_desktop_release_b1.img is an example, use the file got from step1 as a replacement)

sudo rkdeveloptool wl 0 rock_debian_bullseye-_desktop_release_b1.img

Reboot

sudo rkdeveloptool rd

Login

After rebooting the device, you can log in to the system via HDMI or serial port.

Windows

Install RKDevTool

RKDevTool is Rockchip's software for USB burning on Windows platform. If RKDevTool is not installed on your Windows host, please follow the steps below to install it.

Please download and extract the following files to install RKDevTool:

• RKDevTool v2.96 (Includes Chinese documentation)
• DriverAssistant v5.0

Installation of drivers

Download and unzip DriverAssistant, then execute DriverInstall.exe and click the Install Driver button to install the driver. If you have already installed another version of driver, please click Uninstall Driver to uninstall the driver first, and then reinstall it again.

Install RKDevTool

unzip RKDevTool_Release_v2.96_zh.zip ，click RKDevTool.exe to open.

Enter Maskrom mode

If the operation is normal, RKDevTool will prompt A MASKROM device was found.

Follow the steps below to flash the operation image

System startup

Starting the ROCK 5 ITX

Power up the ROCK 5 ITX via the adapter.

Install system to SPI-NVME

Prepare installation media

• Type-C to Type-A USB connector cable
• 1x NVME ssd （M.2）
• 12V Power Supply

Download the image

Please go to Resource Download Summary to download the corresponding image file.

System Installation

Enter maskrom mode

• Disconnect the board from the power supply.
• Remove the SD card and insert the NVME SSD into the M.2 slot of the ROCK 5 ITX
• Use Type-C to Type-A USB cable to connect ROCK 5 ITX and PC
• Press and hold the Maskrom key，Power up the board.
• Check for USB devices
  • Linux/macOS: Check if "Bus 001 Device 112: ID 2207:350a Fuzhou Rockchip Electronics Company" is displayed after running lsusb.
  • Windows: Open RKDevTool and you will see the device in "maskrom mode".

Install the system

Linux

Install rkdeveloptool

rkdeveloptool is Rockchip's software for USB burning on Linux/macOS platforms.

The rkdeveloptool can be thought of as an upgrade_tool for the open source version.

If your operating system does not provide rkdeveloptool, you will need to compile and install it from source.

Debian

Execute the following command from the command line to install:

sudo apt-get update
sudo apt-get install -y libudev-dev libusb-1.0-0-dev dh-autoreconf pkg-config libusb-1.0 build-essential git wget
git clone https://github.com/rockchip-linux/rkdeveloptool
cd rkdeveloptool
wget https://patch-diff.githubusercontent.com/raw/rockchip-linux/rkdeveloptool/pull/73.patch
wget https://patch-diff.githubusercontent.com/raw/rockchip-linux/rkdeveloptool/pull/85.patch
git am *.patch
autoreconf -i
./configure
make -j $(nproc)
sudo cp rkdeveloptool /usr/local/sbin/

Ubuntu

Execute the following command from the command line to install:

sudo apt-get update
sudo apt-get install -y libudev-dev libusb-1.0-0-dev dh-autoreconf pkg-config libusb-1.0 build-essential git wget
git clone https://github.com/rockchip-linux/rkdeveloptool
cd rkdeveloptool
wget https://patch-diff.githubusercontent.com/raw/rockchip-linux/rkdeveloptool/pull/73.patch
wget https://patch-diff.githubusercontent.com/raw/rockchip-linux/rkdeveloptool/pull/85.patch
git am *.patch
autoreconf -i
./configure
make -j $(nproc)
sudo cp rkdeveloptool /usr/local/sbin/

On Ubuntu 22.10 and later you can install it from the command line: sudo apt-get install rkdeveloptool

ArchLinux

rkdeveloptool can be installed from the AUR .

Enter Maskrom Mode

Using rkdeveloptool

Write to a file

tip

rkdeveloptool does not automatically decompress compressed files when writing to them.

You must first extract the used files and specify the extracted files in rkdeveloptool.

tip

rkdeveloptool does not support the selection of a Maskrom device, nor the selection of a storage medium to be written to. Normally, when using rkdeveloptool, only one device and one storage medium are connected in hardware. This step cannot be controlled by software.

If you need to write to multiple devices at the same time, use upgrade_tool.

1. Extract the image file (See File Download above for details of the image file, here rock_debian_bullseye-_desktop_release_b1.img.xz is used as an example)

xz -d rock_debian_bullseye-_desktop_release_b1.img.xz (if the image file is gz format，then use `gunzip -d xxx.gz` command)

2. Flash Loader(See File Download above for details of the loader file，here rkxxxx_spl_loader_v1.xxx.bin is just an example)

sudo rkdeveloptool db rkxxxx_spl_loader_v1.xxx.bin

3. Flash System Image (Here rock_debian_bullseye-_desktop_release_b1.img is an example, use the file got from step1 as a replacement)

sudo rkdeveloptool wl 0 rock_debian_bullseye-_desktop_release_b1.img

Reboot

sudo rkdeveloptool rd

Login

After rebooting the device, you can log in to the system via HDMI or serial port.

mac

Install rkdeveloptool

rkdeveloptool is Rockchip's software for USB burning on Linux/macOS platforms.

The rkdeveloptool can be thought of as an upgrade_tool for the open source version.

If your operating system does not provide rkdeveloptool, you will need to compile and install it from source.

Please install Homebrew first and then run the following command from the command line to install it:

brew install automake autoconf libusb pkg-config git wget
git clone https://github.com/rockchip-linux/rkdeveloptool
cd rkdeveloptool
wget https://patch-diff.githubusercontent.com/raw/rockchip-linux/rkdeveloptool/pull/73.patch
wget https://patch-diff.githubusercontent.com/raw/rockchip-linux/rkdeveloptool/pull/85.patch
git am *.patch
autoreconf -i
./configure
make -j $(nproc)
cp rkdeveloptool /opt/homebrew/bin/

Enter Maskrom Mode

Using rkdeveloptool

Write to a file

tip

rkdeveloptool does not automatically decompress compressed files when writing to them.

You must first extract the used files and specify the extracted files in rkdeveloptool.

tip

rkdeveloptool does not support the selection of a Maskrom device, nor the selection of a storage medium to be written to. Normally, when using rkdeveloptool, only one device and one storage medium are connected in hardware. This step cannot be controlled by software.

If you need to write to multiple devices at the same time, use upgrade_tool.

1. Extract the image file (See File Download above for details of the image file, here rock_debian_bullseye-_desktop_release_b1.img.xz is used as an example)

xz -d rock_debian_bullseye-_desktop_release_b1.img.xz (if the image file is gz format，then use `gunzip -d xxx.gz` command)

2. Flash Loader(See File Download above for details of the loader file，here rkxxxx_spl_loader_v1.xxx.bin is just an example)

sudo rkdeveloptool db rkxxxx_spl_loader_v1.xxx.bin

3. Flash System Image (Here rock_debian_bullseye-_desktop_release_b1.img is an example, use the file got from step1 as a replacement)

sudo rkdeveloptool wl 0 rock_debian_bullseye-_desktop_release_b1.img

Reboot

sudo rkdeveloptool rd

Login

After rebooting the device, you can log in to the system via HDMI or serial port.

Windows

Install RKDevTool

RKDevTool is Rockchip's software for USB burning on Windows platform. If RKDevTool is not installed on your Windows host, please follow the steps below to install it.

Please download and extract the following files to install RKDevTool:

• RKDevTool v2.96 (Includes Chinese documentation)
• DriverAssistant v5.0

Installation of drivers

Download and unzip DriverAssistant, then execute DriverInstall.exe and click the Install Driver button to install the driver. If you have already installed another version of driver, please click Uninstall Driver to uninstall the driver first, and then reinstall it again.

Install RKDevTool

unzip RKDevTool_Release_v2.96_zh.zip ，click RKDevTool.exe to open.

Enter Maskrom mode

If the operation is normal, RKDevTool will prompt A MASKROM device was found.

Follow the steps below to flash the operation image

Boot the system

• Using a 12V power supply to power the ROCK 5 ITX

Reference Documentation