Upgrade Firmware

Boot mode description


AIO-3399JD4 has a flexible startup mode. Generally, the AIO-3399JD4 development board does not brick unless the hardware is damaged.

If the accident appeared in the process of upgrading, bootloader damage, leading to unable to upgrade again, while still can enter MaskRom mode to repair.

Loading way

AIO-3399JD4 has 32KB BootRom and 200KB internal SRAM and supports loading the system from the following devices:

  • SPI interface

  • eMMC interface

  • SDMMC interface

AIO-3399JD4 also supports downloading system code from USB OTG interface.

Boot order

The order of startup :

  1. Main control power on initialization

  2. BootRom code runs on SRAM and verifies the bootloader in the storage device

  3. Verify pass, load and run bootloader boot code

  4. Bootloader boot code is responsible for initializing DDR memory, loading the complete bootloader code into DDR memory and running it

  5. Bootloader loads the Linux kernel on the storage device and gives the execution power to the Linux kernel

Boot mode

AIO-3399JD4 has three startup modes:

  • Normal mode

  • Loader mode

  • MaskRom mode

Normal mode

Normal mode is the Normal startup process. Each component loads in turn and enters the system normally.

Loader mode

In Loader mode, bootloader will enter the upgrade state and wait for the host command for firmware upgrade.To enter the Loader mode, must let the bootloader detected in startup RECOVERY (RECOVERY) key press, and USB connection status. The method to put the device into upgrade mode is as follows:

Disconnect the power adapter

  • Dual male usb data cable connects the device and host.

  • press the RECOVERY button on the device and hold it.

  • plug in

  • about two seconds later, release the RECOVERY key.

MaskRom mode

MaskRom mode is used for system repair when bootloader is damaged.

Generally, it is not necessary to enter MaskRom mode. BootRom code will enter MaskRom mode only if bootloader validation fails (IDR block cannot be read, or bootloader is damaged). At this point, BootRom code waits for the host to transfer the bootloader code through the USB interface and load and run it.

force into MaskRom mode, please refer to the chapter of MaskRom.

Upgrade instructions (important)

1. Tools (download the corresponding version according to the following table)

2. Firmware

  • Ubuntu:
    The official Ubuntu firmware provided by cloud plate with GPT words for the new SDK the GPT compiled firmware, and currently only GPT firmware support is available.

  • Android 7.1:
    Android7.1 firmware can be divided into tvbox version and industry version (mainly for maintenance), both of which are compatible with AIO-3399JD4.

Please read the following table carefully before upgrading : _images/3399c-upgrade-table-en.jpg

Upgrade the firmware


This article describes how to upgrade the firmware file on the host to the flash memory of the development board through the Dual male usb data cable. When upgrading, you need to choose the appropriate upgrade mode according to the host operating system and firmware type.

Preparatory work

  • AIO-3399JD4

  • Firmware

  • host computer

  • Dual male usb data cable

There are two types of firmware files:

  • A single unified firmware update.img that packs the boot loader, parameters, and all partition images together for firmware publishing.

  • Multiple partition images, such as kernel.img, rootfs.img, recovery.img, etc. are generated in the development stage.

  • You can find the compiled unified [AIO-3399JD4 firmware] here, download it and unpack it.You can also refer to the instructions for compiling firmware to compile by yourself.

Host operating system support:

  • Windows XP (32/64 bits)

  • Windows 7 (32/64 bits)

  • Windows 8 (32/64 bits)

  • Linux (32/64 bits)


Note : Different firmware may use different versions of tools, please download the corresponding version according to the upgrade instructions .

Install RK USB drive

Download Release_DriverAssistant.zip , extract, and then run the DriverInstall.exe inside . In order for all devices to use the updated driver, first select 驱动卸载 and then select 驱动安装.


Connected devices

You can put the device into upgrade mode as follows:

  • disconnect the power adapter first :

    • Dual male usb data cable connects one end to the host and the other end to the development board

    • press the RECOVERY button on the device and hold.

    • connect to the power supply

    • about two seconds later, release the RECOVERY button.

The host should prompt for new hardware and configure the driver. Open Device manager and you will see the new Device” Rockusb Device” appear as shown below. If not, you need to go back to the previous step and reinstall the driver.


Upgrade the firmware

Download AndroidTool,extract,Run AndroidTool.exe in the AndroidTool_Release_xxx directory. (note: if it is Windows 7/8, you need to press the right mouse button and choose to run as an administrator), as shown below: _images/upgrade_firmware3.png

Upgrade unified firmware - update.img

The steps to update the unified firmware update.img are as follows:

  1. Switch to the “upgrade firmware” page.

  2. Press the “firmware” button to open the firmware file to be upgraded. The upgrade tool displays detailed firmware information.

  3. Press the “upgrade” button to start the upgrade.

  4. If the upgrade fails, you can try to erase the Flash by pressing the “erase Flash” button first, and then upgrade. Be sure to erase and upgrade according to upgrade instructions.

Note: if the firmware laoder you wrote is inconsistent with the original one, please execute “wipe Flash” before upgrading the firmware.


Upgrade Partition image

Each firmware partition may be different, please note the following two points:

  1. When upgrading ubuntu(MBR) and Android7.1 firmware with Androidtool_2.38, the default configuration can be used.

  2. When upgrading ubuntu(GPT) with Androidtool_2.58, the default configuration can be used. Please first perform the following actions to upgrade Android8.1 firmware:
    Switch to “download image page “; Right click on the table and select “import configuration “; Select the “rk3399-Android81.cfg”.
    The steps to upgrade the partition image are as follows:

    1. Switch to the “download image” page.

    2. Check the partition to be burned, and select multiple.

    3. Make sure the path of the image file is correct. If necessary, click the blank table cell on the right side of the path to select it again.

    4. Click “execute” button to start the upgrade, and the device will restart automatically after the upgrade.



There is no need to install device driver under Linux. Please refer to the Windows section to connect the device.

Note : Different firmware may use different versions of tools, please download the corresponding version according to the upgrade instructions.


Download Linux_Upgrade_Tool, And install it into the system as follows for easy invocation:

unzip Linux_Upgrade_Tool_xxxx.zip
cd Linux_UpgradeTool_xxxx
sudo mv upgrade_tool /usr/local/bin
sudo chown root:root /usr/local/bin/upgrade_tool

Upgrade unified firmware - update.img

sudo upgrade_tool uf update.img

If the upgrade fails, try erasing before upgrading. Be sure to erase and upgrade against the table (upgrade_table.md) in [upgrade instructions][烧写须知].

# erase flash : Using the ef parameter requires the loader file or the corresponding update.img to be specified
# update.img :The ubuntu firmware you need to upgrade .
sudo upgrade_tool ef update.img
# upgrade again
sudo upgrade_tool uf update.img 

Upgrade Partition image

Ubuntu(MBR)、Android7.1 Using the following methods:

sudo upgrade_tool di -b /path/to/boot.img
sudo upgrade_tool di -k /path/to/kernel.img
sudo upgrade_tool di -s /path/to/system.img
sudo upgrade_tool di -r /path/to/recovery.img
sudo upgrade_tool di -m /path/to/misc.img
sudo upgrade_tool di resource /path/to/resource.img
sudo upgrade_tool di -p paramater   # upgrade parameter
sudo upgrade_tool ul bootloader.bin # upgrade bootloader

Ubuntu(GPT): Using the following methods:

sudo upgrade_tool ul $LOADER
sudo upgrade_tool di -p $PARAMETER
sudo upgrade_tool di -uboot $UBOOT
sudo upgrade_tool di -trust $TRUST
sudo upgrade_tool di -b $BOOT
sudo upgrade_tool di -r $RECOVERY
sudo upgrade_tool di -m $MISC
sudo upgrade_tool di -oem $OEM
sudo upgrade_tool di -userdata $USERDATA
sudo upgrade_tool di -rootfs $ROOTFS

If the upgrade fails due to flash problems, you can try low-level formatting and erase nand flash:

sudo upgrade_tool lf update.img	# low-level formatting
sudo upgrade_tool ef update.img	# erase


Q1: How to enter MaskRom mode

A1 : If the board does not enter Loader mode, you can try to force your way into MaskRom mode. See operation method “How to enter MaskRom mode”.

MaskRom mode

See startup mode for an introduction “startup mode”

MaskRom pattern is the last line of defense equipment burn out. Forced entry MaskRom involved hardware operation, have certain risk, so only in the equipment into the Loader mode, can try MaskRom mode.

Please read carefully and operate carefully!
The operation steps are as follows:

  1. Disconnect all power supplies.

  2. Unplug the SD card.

  3. Connect the equipment and host machine with Dual male usb data cable.

  4. Use metal tweezers to connect the two test points on the core board as shown in the figure below and hold.

  5. Plug the device into the power supply.

  6. Wait a moment, then loosen the tweezers.

At this point, the device should go into MaskRom mode. _images/maskrom2.jpg