Mac OS 主机

文件下载

安装 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
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/

进入 Maskrom

拔出 microSD 卡和电源线
按住 Maskrom 按钮
通过 USB-A 转 USB-C 线连接PC 主机的 USB，如果如果PC端检测到有设备，则进入到 Maskrom 模式（Radxa ROCK 5 ITX 的 OTG 接口是 TYPE-C,可通过 USB-C 转 USB-A 线连接主机和进入 Maskrom 的主板进行通信）

使用 rkdeveloptool

写入文件

提示

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

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

提示

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

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



1. 解压镜像文件（镜像文件详见上文 "文件下载" 部分， 此处 以 rock-5-itx_debian_bullseye-test_kde_b3.img.xz 为例）
   xz -d rock-5-itx_debian_bullseye-test_kde_b3.img.xz
2. 烧录 Loader
   sudo rkdeveloptool db rk3588_spl_loader_v1.15.113.bin
3. 烧录镜像
   sudo rkdeveloptool wl 0 rock-5-itx_debian_bullseye-test_kde_b3.img

重启设备

sudo rkdeveloptool rd

登录设备

重启设备后，可以通过 HDMI 或者串口登录到系统。

提示

账号密码都为 radxa

Mac OS 主机

文件下载​

安装 rkdeveloptool​

进入 Maskrom​

使用 rkdeveloptool​

写入文件​

重启设备​

登录设备​