Skip to main content

Linux Host

File Download​

Please download the system image and Loader refer to Summary of resource downloads.

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.

Enter Maskrom Mode​

  1. Remove the MicroSD card from the base Board
  2. Simultaneously press and hold the Maskrom Button (SPI Flash) and Maskrom Button (eMMC) on the CM3I.
  3. Connect a PC host from the OTG port using a USB-A to USB-A cable
  4. Connect the power supply, you can enter the MASKROM mode
cm3i modulecm3i module

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_debian_bullseye-_desktop_release_b1.img.xz is used as an example)
xz -d rock_debian_bullseye-_desktop_release_b1.img.xz (if the image file is gz format，then use `gunzip -d xxx.gz` command)
  1. Flash Loader(See File Download above for details of the loader file，here rkxxxx_spl_loader_v1.xxx.bin is just an example)
sudo rkdeveloptool db rkxxxx_spl_loader_v1.xxx.bin
  1. Flash System Image (Here rock_debian_bullseye-_desktop_release_b1.img is an example, use the file got from step1 as a replacement)
sudo rkdeveloptool wl 0 rock_debian_bullseye-_desktop_release_b1.img

Reboot​

sudo rkdeveloptool rd

Login​

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