Skip to main content

Mac OS Host

File Download

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 to Maskrom

  1. Remove the microSD card and power cable.
  2. Press and hold the Maskrom button.
  3. Insert the USB A-C cable into the Type-C port of ROCK 5B, with the other end plugged into the computer. This should normally put it into Maskrom mode.
rock 5b maskrom wire

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-5b_debian_bullseye-test_kde_b39.img.xz is used as an example)
   xz -d rock-5b_debian_bullseye-test_kde_b39.img.xz
2. Flash Loader
   sudo rkdeveloptool db rk3588_spl_loader_v1.08.111.bin
3. Flash System Image
   sudo rkdeveloptool wl 0 rock-5b_debian_bullseye-test_kde_b39.img
   

Reboot

sudo rkdeveloptool rd

Login

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

tip

Account and password are both radxa.