Skip to main content

Image Burning for Linux/MacOS

Burning in Linux Environment​

upgrade_tool is a tool designed for Linux to flash original firmware, RK firmware, and partition images to eMMC. It is a closed-source command-line tool provided by Rockchip. This tool exclusively supports flashing using SPI NAND FLASH. If you wish to flash the firmware to a TF card, you will need to use SocToolKit software in a Windows environment for the flashing process.

The currently tested and supported systems include Ubuntu 18.04, Ubuntu 20.04, and Ubuntu 22.04. For other systems, further research and exploration may be required for successful flashing.

  1. Press the boot button to connect to the host, use the 'lsusb' command to check the device. If the device is not recognized, try changing the Type-C cable to resolve the issue.

  2. Download, extract, and install upgrade_tool:

    sudo unzip upgrade_tool_v2.17.zip
    cd upgrade_tool_v2.17_for_linux/
    sudo cp upgrade_tool /usr/local/bin
    sudo chmod +x /usr/local/bin/upgrade_tool

  3. Test if the installation was successful:

    ubuntu@ubuntu:~$ sudo upgrade_tool -v
    Upgrade Tool v2.17

  4. Run the program to flash the firmware:

    luckfox@luckfox:~$ sudo upgrade_tool uf update.img 
    Loading firmware...
    Support Type:1106   FW Ver:0.0.00   FW Time:2023-11-16 16:24:18
    Loader ver:1.01 Loader Time:2023-11-16 16:22:58
    Start to upgrade firmware...
    Download Boot Start
    Download Boot Success
    Wait For Maskrom Start
    Wait For Maskrom Success
    Test Device Start
    Test Device Success
    Check Chip Start
    Check Chip Success
    Get FlashInfo Start
    Get FlashInfo Success
    Prepare IDB Start
    Prepare IDB Success
    Download IDB Start
    Download IDB Success
    Download Firmware Start
    Download Image... (100%)
    Download Firmware Success
    Upgrade firmware ok.

  5. The result is as follows:

Burning in MacOS Environment​

upgrade_tool not only has a Linux version, but also a MacOS version.

Note: It only supports flashing using SPI NAND FLASH. If you need to flash the firmware to a TF card, you will need to use SocToolKit software in a Windows environment.

  1. Download and extractupgrade_tool ：

    sudo ditto -xk upgrade_too_v2.25_for_mac.zip .

  2. Run the program to flash the firmware (please modify the path according to the actual location of the image):

    cd upgrade_too_v2.25_for_mac
     sudo ./upgrade_tool uf /Users/cjw/update.img

  3. The result is as follows:：

FAQ​

Question :USB can recognize and display "Fuzhou Rockchip Electronics Company rk3xxx", but the flashing tool shows "not connected".​

Reference: https://forums.luckfox.com/viewtopic.php?t=17