跳到主要内容

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
autoreconf -i
./configure
make -j $(nproc)
cp rkdeveloptool /opt/homebrew/bin/

进入 Maskrom​

  1. 移除 microSD 卡,插入 eMMC
  2. 将 USB 3.0 座子下方的拨码开关调至 device 侧
  3. 短接 Maskrom 引脚,其位于 USB 3.0 座子和以太网中间
  4. 使用 USB-A 转 USB-A 线从 OTG 端口连接 PC 主机
  5. 插入电源线上电,如果电源绿灯常亮则成功进入 Maskrom 模式
rock 3b otgrock 3b maskrom wire

使用 rkdeveloptool​

写入文件​

提示

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

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

提示

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

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



1. 解压镜像文件(镜像文件请到  "文件下载" 部分下载, 此处 以 rock-3b_debian_bullseye-test_xfce_18.img.xz 为例)
   xz -d rock-3b_debian_bullseye-test_xfce_18.img.xz
2. 烧录 Loader (Loader文件请到本文 "文件下载" 部分下载)
   sudo rkdeveloptool db rk356x_spl_loader__v1.15.113.bin
3. 烧录镜像
   sudo rkdeveloptool wl 0 rock-3b_debian_bullseye-test_xfce_18.img
   

重启设备​

sudo rkdeveloptool rd

登录设备​

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

提示

账号密码都为 radxa

    您需要登录 GitHub 才能发表评论。如果您已登录,请忽略此消息。

    Radxa-docs © 2026 by Radxa Computer (Shenzhen) Co.,Ltd. is licensed under CC BY 4.0