跳到主要内容

Linux 主机

文件下载

请到下载页面下载 Loader 和 系统镜像文件

安装 rkdeveloptool

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

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

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

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

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/

进入 Maskrom

什么是 Maskrom 模式

Maskrom模式,也称为Loader模式,是一种特殊的启动模式,一般用于恢复或维修有问题的设备。这种模式允许用户直接与设备的硬件进行交互,而不需要经过操作系统。在Maskrom模式下,用户可以通过电脑或其他设备与设备进行通信,并执行一系列命令来解决设备的问题。

MacOS 端:

执行 lsusb 后的结果 Output:Bus 000 Device 004: ID 2207:350b Fuzhou Rockchip Electronics Co., Ltd. Composite Device

Linux 端:

执行 lsusb 后的结果 Output:Bus 001 Device 030: ID 2207:350b Fuzhou Rockchip Electronics Company

Windows 端:

打开 RKDevTool,就会看到设备处于 Found One MASKROM Device(找到一个 MASKROM 设备)状态。

如何进入Maskrom 状态

  • 按住 Maskrom button
  • 上电 (将 USB A-C 电缆插入 ROCK 2F 的 Type-C Power端口,另一端接入电源。)
  • 此时正常情况下会进入 Maskrom 状态
rock-2f pack rock-2f pack

使用 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 xxx.gz命令)
  2. 烧录 Loader (实际文件见上文 “文件下载” 部分,这里以 rkxxxx_spl_loader_v1.xxx.bin 为例)

    sudo rkdeveloptool db rrkxxxx_spl_loader_v1.xxx.bin
  3. 烧录镜像 (以下镜像名只是示例,实际镜像文件是步骤1解压后的文件)

 sudo rkdeveloptool wl 0 rock_debian_bullseye_desktop_release_b1.img

重启设备

sudo rkdeveloptool rd

设备登录

详情请参考 快速上手