本文档将介绍如何把 Android 镜像安装到 ROCK 5 ITX。

ROCK 5 ITX 可以从 microSD 卡启动，也可以从 EMMC 启动，还可以从 SPI+NVME 启动 ，基于不同的启动方式，安装系统到不同的介质上.

安装操作系统

在使用 microSD 卡/ eMMC 启动 ROCK 5 ITX 之前，需要擦除 SPI ，步骤如下：

1. 下载 Loader 文件到本地

• Loader For Linux: rk3588_spl_loader_v1.15.113.bin

• ROCK 5 ITX 系统镜像（5.10 内核）: Radxa ROCK 5 ITX Debian11 b6

• ROCK 5 ITX 系统镜像（6.1 内核）: Radxa ROCK 5 ITX Debian12 b3

• SPI Image: spi_image.img

• Loader For Android: MiniLoader.bin

• Android（用于SD卡启动）: Android12_ROCK5_ITX_hdmi0_dp0_dp1_dsi0_gpt

• Android（用于EMMC启动）: Android12_ROCK5_ITX_hdmi0_dp0_dp1_dsi0_update

• Android（用于SSD启动）: Android12_ROCK5_ITX_hdmi0_dp0_dp1_dsi0_spi_nvme

2. 设备进入 Maskrom 模式

主板上有一个专用的 Maskrom 按键，在给主板上电前按住 Maskrom 按键，通电后系统检测到 Maskrom 按键被按下，主板就会自动进入 Maskrom 模式。

详细步骤：

① : 按住 Maskrom 按键

② : 使用电源适配器给主板上电

③ : 松开 Maskrom 按键

④ : 使用数据线连接主板的 OTG 端口和电脑的 USB 端口

3. 按以下操作擦除 SPI

Windows

Windows 使用 rkdevtool 工具进行操作

Linux/Mac

Linux/Mac 使用 rkdeveloptool 工具进行操作

dd if=/dev/zero of=zero.img bs=16M count=1
rkdeveloptool db rk3588_spl_loader_v1.15.113.bin (需选择步骤 1 中 下载的 loader 文件)
rkdeveloptool wl 0 zero.img
rkdeveloptool rd

安装系统到 microSD 卡

准备工作

• 1x microSD 卡(容量 >=16GB，读写速度等级 >= class10)
• 1x microSD 读卡器
• 12V DC 电源

镜像下载

请到 资源下载汇总 下载对应的镜像文件

安装系统

我们推荐使用由瑞莎合作伙伴 Balena 开发的开源镜像烧录工具 Etcher 。它界面友好，功能强大，系统支持 Windows / Linux / macOS。下面我们介绍如何用 Etcher 写镜像到 SD 卡。

1. 下载 Etcher 并安装。

Windows

请下载 balenaEtcher-2.1.4.Setup.exe。下载完成后，无需进行额外操作，双击即可打开使用。

Linux

请下载 balena-etcher_2.1.4_amd64.deb。下载完成后，请在终端执行以下命令进行安装：

sudo dpkg -i balena-etcher_2.1.4_amd64.deb

2. 打开 Etcher

   

3. 打开 Etcher，单击 Flash from file 以选择需要写入的镜像。

镜像说明

下载的系统镜像为压缩格式，使用 Balena Etcher 进行镜像烧录前，需先完成解压操作。

4. 点击 Select target 以选择设备，请注意小心选择。

   

5. 点击 Flash! 开始写入，然后等待写入进度条完成。

   

6. 当写入镜像成功时，Etcher 将会显示 Flash Complete!。

   

如果刷写操作系统镜像错误, 请手动再试一次。

启动系统

• 按照上述步骤成功烧录 microSD 卡后，将 microSD 卡插入 ROCK 5 ITX 的 microSD 插槽内
• 使用 12V DC 电源为 ROCK 5 ITX 供电

安装系统到 eMMC

准备工作

准备安装介质

• Type-C 转 Type-A USB 接口线缆
• 1x eMMC 模块（已板载）
• 12V DC 电源

镜像下载

请到 资源下载汇总 下载对应的镜像文件

系统安装

进入 maskrom 模式

• 断开瑞莎 ROCK 5 ITX电源
• 移除 SD 卡
• 用 Type-C 转 Type-A USB 线缆连接 Radxa ROCK 5 ITX 的 Type-C 口 和 PC 端
• 按住 maskrom 按键，给瑞莎 ROCK 5 ITX上电
• 查看是否有 USB 设备
  • Linux/macOS: 检查执行 lsusb 后是否有显示 "Bus 001 Device 112: ID 2207:350a Fuzhou Rockchip Electronics Company"
  • Windows: 打开 RKDevTool 您会看到设备处于 "maskrom mode".

Linux

安装 rkdeveloptool

rkdeveloptool 是 Rockchip 为 Linux/macOS 平台下进行 USB 烧录所开发的软件。

rkdeveloptool 可以被认为是开源版本的 upgrade_tool。

如果你的操作系统没有提供 rkdeveloptool，则需要从源代码编译安装。

Debian

从命令行中执行以下命令进行安装：

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
git am *.patch
autoreconf -i
./configure
make -j $(nproc)
sudo cp rkdeveloptool /usr/local/sbin/

Ubuntu

从命令行中执行以下命令进行安装：

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
autoreconf -i
./configure
make -j $(nproc)
sudo cp rkdeveloptool /usr/local/sbin/

在 Ubuntu 22.10 以后可以通过命令行安装： sudo apt-get install rkdeveloptool

ArchLinux

可从 AUR 安装 rkdeveloptool。

进入 Maskrom

使用 rkdeveloptool

写入文件

提示

写入文件时，rkdeveloptool 不会自动对压缩文件进行解压缩。

请首先将使用到的文件进行解压缩，并在 rkdeveloptool 中指定解压缩后的文件。

提示

rkdeveloptool 不支持选择 Maskrom 设备，也无法选择待写入的存储介质。 通常使用 rkdeveloptool 时，只会硬件连接一部设备和一个存储介质。这一步无法用软件控制。

如果需要同时写入多个设备，请使用 upgrade_tool。

1. 解压镜像文件 (镜像文件详见上文 "文件下载" 部分， 此处 以 rock_debian_bullseye_desktop_release_b1.img.xz 为例)

   xz -d rock_debian_bullseye_desktop_release_b1.img.xz (如果是gz格式，请使用gunzip -d <image>.gz命令)

2. 烧录 Loader (实际文件见上文 “文件下载” 部分，这里以 <loader-file>.bin 为例)

   sudo rkdeveloptool db <loader-file>.bin

3. 烧录镜像 (以下镜像名只是示例，实际镜像文件是步骤1解压后的文件)

 sudo rkdeveloptool wl 0 rock_debian_bullseye_desktop_release_b1.img

重启设备

sudo rkdeveloptool rd

mac

安装 rkdeveloptool

rkdeveloptool 是 Rockchip 为 Linux/macOS 平台下进行 USB 烧录所开发的软件。

rkdeveloptool 可以被认为是开源版本的 upgrade_tool。

如果你的操作系统没有提供 rkdeveloptool，则需要从源代码编译安装。

请首先安装 Homebrew，然后从命令行中执行以下命令进行安装：

brew install automake autoconf libusb pkg-config git wget
git clone https://github.com/rockchip-linux/rkdeveloptool
cd rkdeveloptool
autoreconf -i
./configure
make -j $(nproc)
cp rkdeveloptool /opt/homebrew/bin/

进入 Maskrom

使用 rkdeveloptool

写入文件

提示

写入文件时，rkdeveloptool 不会自动对压缩文件进行解压缩。

请首先将使用到的文件进行解压缩，并在 rkdeveloptool 中指定解压缩后的文件。

提示

rkdeveloptool 不支持选择 Maskrom 设备，也无法选择待写入的存储介质。 通常使用 rkdeveloptool 时，只会硬件连接一部设备和一个存储介质。这一步无法用软件控制。

如果需要同时写入多个设备，请使用 upgrade_tool。

1. 解压镜像文件 (镜像文件详见上文 "文件下载" 部分， 此处 以 rock_debian_bullseye_desktop_release_b1.img.xz 为例)

   xz -d rock_debian_bullseye_desktop_release_b1.img.xz (如果是gz格式，请使用gunzip -d <image>.gz命令)

2. 烧录 Loader (实际文件见上文 “文件下载” 部分，这里以 <loader-file>.bin 为例)

   sudo rkdeveloptool db <loader-file>.bin

3. 烧录镜像 (以下镜像名只是示例，实际镜像文件是步骤1解压后的文件)

 sudo rkdeveloptool wl 0 rock_debian_bullseye_desktop_release_b1.img

重启设备

sudo rkdeveloptool rd

Windows

安装 RKDevTool

RKDevTool 是 Rockchip 为 Windows 平台下进行 USB 烧录所开发的软件。如果您的 Windows 主机上没有安装 RKDevTool， 请按照以下步骤进行安装。

请下载并解压以下文件以安装 RKDevTool：

• RKDevTool (含中文使用文档)
• DriverAssitant

安装驱动

下载并解压 DriverAssitant，然后执行 DriverInstall.exe 并点击 Install Driver 按钮来安装驱动。 如果你之前已经安装过其他版本的驱动，请先点击 Uninstall Driver 卸载驱动，然后再重新安装。

安装 RKDevTool

解压 RKDevTool_Release.zip 后，点击 RKDevTool.exe 即可使用。

进入 Maskrom 模式

按照以下操作烧入镜像

系统启动

启动 ROCK 5 ITX

• 通过适配器为 ROCK 5 ITX 供电

安装系统到 SPI-NVME

准备工作

• 1x NVME ssd （M.2）
• Type-C 转 Type-A USB 接口线缆
• 12V 电源

镜像下载

请到 资源下载汇总 下载对应的镜像文件

系统安装

进入 maskrom 模式

• 断开瑞莎 ROCK 5 ITX电源
• 移除 SD 卡，将 NVME ssd 插入到 ROCK 5 ITX 的 M.2 插槽内
• 用 Type-C 转 Type-A USB 线缆连接 ROCK 5 ITX 的 Type-C 口 和 PC 端
• 按住 maskrom 按键，给瑞莎 ROCK 5 ITX上电
• 查看是否有 USB 设备
  • Linux/macOS: 检查执行 lsusb 后是否有显示 "Bus 001 Device 112: ID 2207:350a Fuzhou Rockchip Electronics Company"
  • Windows: 打开 RKDevTool 您会看到设备处于 "maskrom mode".

Linux

安装 rkdeveloptool

rkdeveloptool 是 Rockchip 为 Linux/macOS 平台下进行 USB 烧录所开发的软件。

rkdeveloptool 可以被认为是开源版本的 upgrade_tool。

如果你的操作系统没有提供 rkdeveloptool，则需要从源代码编译安装。

Debian

从命令行中执行以下命令进行安装：

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
git am *.patch
autoreconf -i
./configure
make -j $(nproc)
sudo cp rkdeveloptool /usr/local/sbin/

Ubuntu

从命令行中执行以下命令进行安装：

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
autoreconf -i
./configure
make -j $(nproc)
sudo cp rkdeveloptool /usr/local/sbin/

在 Ubuntu 22.10 以后可以通过命令行安装： sudo apt-get install rkdeveloptool

ArchLinux

可从 AUR 安装 rkdeveloptool。

进入 Maskrom

使用 rkdeveloptool

写入文件

提示

写入文件时，rkdeveloptool 不会自动对压缩文件进行解压缩。

请首先将使用到的文件进行解压缩，并在 rkdeveloptool 中指定解压缩后的文件。

提示

rkdeveloptool 不支持选择 Maskrom 设备，也无法选择待写入的存储介质。 通常使用 rkdeveloptool 时，只会硬件连接一部设备和一个存储介质。这一步无法用软件控制。

如果需要同时写入多个设备，请使用 upgrade_tool。

1. 解压镜像文件 (镜像文件详见上文 "文件下载" 部分， 此处 以 rock_debian_bullseye_desktop_release_b1.img.xz 为例)

   xz -d rock_debian_bullseye_desktop_release_b1.img.xz (如果是gz格式，请使用gunzip -d <image>.gz命令)

2. 烧录 Loader (实际文件见上文 “文件下载” 部分，这里以 <loader-file>.bin 为例)

   sudo rkdeveloptool db <loader-file>.bin

3. 烧录镜像 (以下镜像名只是示例，实际镜像文件是步骤1解压后的文件)

 sudo rkdeveloptool wl 0 rock_debian_bullseye_desktop_release_b1.img

重启设备

sudo rkdeveloptool rd

mac

安装 rkdeveloptool

rkdeveloptool 是 Rockchip 为 Linux/macOS 平台下进行 USB 烧录所开发的软件。

rkdeveloptool 可以被认为是开源版本的 upgrade_tool。

如果你的操作系统没有提供 rkdeveloptool，则需要从源代码编译安装。

请首先安装 Homebrew，然后从命令行中执行以下命令进行安装：

brew install automake autoconf libusb pkg-config git wget
git clone https://github.com/rockchip-linux/rkdeveloptool
cd rkdeveloptool
autoreconf -i
./configure
make -j $(nproc)
cp rkdeveloptool /opt/homebrew/bin/

进入 Maskrom

使用 rkdeveloptool

写入文件

提示

写入文件时，rkdeveloptool 不会自动对压缩文件进行解压缩。

请首先将使用到的文件进行解压缩，并在 rkdeveloptool 中指定解压缩后的文件。

提示

rkdeveloptool 不支持选择 Maskrom 设备，也无法选择待写入的存储介质。 通常使用 rkdeveloptool 时，只会硬件连接一部设备和一个存储介质。这一步无法用软件控制。

如果需要同时写入多个设备，请使用 upgrade_tool。

1. 解压镜像文件 (镜像文件详见上文 "文件下载" 部分， 此处 以 rock_debian_bullseye_desktop_release_b1.img.xz 为例)

   xz -d rock_debian_bullseye_desktop_release_b1.img.xz (如果是gz格式，请使用gunzip -d <image>.gz命令)

2. 烧录 Loader (实际文件见上文 “文件下载” 部分，这里以 <loader-file>.bin 为例)

   sudo rkdeveloptool db <loader-file>.bin

3. 烧录镜像 (以下镜像名只是示例，实际镜像文件是步骤1解压后的文件)

 sudo rkdeveloptool wl 0 rock_debian_bullseye_desktop_release_b1.img

重启设备

sudo rkdeveloptool rd

Windows

安装 RKDevTool

RKDevTool 是 Rockchip 为 Windows 平台下进行 USB 烧录所开发的软件。如果您的 Windows 主机上没有安装 RKDevTool， 请按照以下步骤进行安装。

请下载并解压以下文件以安装 RKDevTool：

• RKDevTool (含中文使用文档)
• DriverAssitant

安装驱动

下载并解压 DriverAssitant，然后执行 DriverInstall.exe 并点击 Install Driver 按钮来安装驱动。 如果你之前已经安装过其他版本的驱动，请先点击 Uninstall Driver 卸载驱动，然后再重新安装。

安装 RKDevTool

解压 RKDevTool_Release.zip 后，点击 RKDevTool.exe 即可使用。

进入 Maskrom 模式

按照以下操作烧入镜像

启动系统

• 使用 12V 电源为 ROCK 5 ITX 供电