upgrade_tool

upgrade_tool is the software developed by Rockchip for USB flashing on Linux platform.

---

Installation for upgrade_tool

Please download and extract the following file to install upgrade_tool:

• upgrade_tool v2.1

Usage for upgrade_tool

Command Line Mode

upgrade_tool is used in command line mode similar to rkdeveloptool.

tip

In command line mode, upgrade_tool does not support the selection of a Maskrom device, nor can it select the storage media to be written to.

If you need to select a specific one from multiple devices, use interactive mode.

View connected Maskrom devices

./upgrade_tool ld

Write file

tip

upgrade_tool does not automatically decompress compressed files when writing to them.

First extract the used files and specify the extracted files in upgrade_tool.

sudo ./upgrade_tool db <loader>
sudo ./upgrade_tool wl 0 <image>

Download links for the required Loader and Image files can be found below.

Reboot device

sudo ./upgrade_tool rd

Interactive Mode

If upgrade_tool is executed without any arguments, it will automatically enter interactive mode.

This mode will first ask to select the device to be written to:

$ sudo ./upgrade_tool
Using /home/rock/Linux_Upgrade_Tool/config.ini
Program Log will save in the /root/upgrade_tool/log/
List of rockusb connected
DevNo=1 Vid=0x2207,Pid=0x350b,LocationID=21     Mode=Maskrom
DevNo=2 Vid=0x2207,Pid=0x350b,LocationID=22     Mode=Maskrom
DevNo=3 Vid=0x2207,Pid=0x350b,LocationID=23     Mode=Maskrom
Found 3 rockusb,Select input DevNo,Rescan press <R>,Quit press <Q>:

After selecting the device, upgrade_tool displays all commands available in the current mode. Thereafter the operation is similar to command line mode.

SPI U-Boot and Loader

tip

The SPI/U-boot/loader file is related to the SoC model, you can find it in the following list according to the corresponding SoC model of the product.

• ROCK 3 Family: (Corresponding SoC models: RK3566/RK3568/RK3568J)

  • CM3 IO SPI U-Boot image
  • rk356x_spl_loader_ddr1056_v1.12.109_no_check_todly.bin(recommanded)
  • rk356x_spl_loader_ddr1056_v1.10.111.bin

• ROCK 4 Family: (Corresponding SoC models: RK3399/RK3399-T/RK3399(Rockchip OP1))

  • rk3399_loader_v1.27.126.bin

• ROCK 5 Family: (Corresponding SoC models: RK3588/RK3588S/RK3588S2)

  • ROCK 5A SPI U-Boot image
  • ROCK 5B SPI U-Boot image
  • rk3588_spl_loader_v1.15.113.bin

---

Parallel Write

Since upgrade_tool blocks the current terminal when writing to a device, if you need to write to multiple devices at the same time, you need to execute upgrade_tool multiple times to create multiple interactive mode sessions.