Rockchip Factory Tool (RKDevTool) – How to Flash Rockchip Firmware
Learn how to use RKDevTool (Rockchip Factory Tool) to flash firmware on Rockchip-based Android TV boxes, tablets, and single-board computers. This guide covers DriverAssistant setup, Maskrom vs Loader mode, unified IMG and partition-based flashing, and troubleshooting detection and flash failures.
Pre-Flight Checklist
Complete ALL items before proceeding. Skipping any step increases the risk of bricking your device.
-
Rockchip device confirmed (RK3188, RK3288, RK3328, RK3399, RK3568, RK3588, etc.)Rockchip Factory Tool only works with Rockchip-based devices: Android TV boxes, tablets, development boards (Pine64, Rock Pi, Orange Pi, Radxa, etc.), and some Chromebooks.
-
Correct Rockchip firmware (.img or .zip) for your deviceRockchip firmware comes as a single unified .img file (contains all partitions) or a .zip with individual partition images. Match the firmware exactly to your board revision and chipset.
-
Rockchip Driver Assistant (DriverAssitant) installedInstall the Rockchip DriverAssistant tool which installs the required Rockchip USB drivers for Maskrom and Loader mode. Run as Administrator.
-
RKDevTool (Rockchip Factory Tool) downloadedDownload RKDevTool from the Rockchip developer resources or a trusted mirror. This is the official Rockchip flashing utility.
-
USB-A to USB-A OTG cable or USB-C data cableMany Rockchip boards use USB-A OTG ports for flashing. Confirm which port on your device is the OTG/flashing port.
-
Data backup completedFlashing will erase all data on the device.
Guide Steps
Extract and run DriverAssistant.exe as Administrator. Click Install Driver. This installs Rockchip Maskrom USB and Rockchip Loader USB drivers.
Do NOT connect your device yet.
Extract and run RKDevTool.exe. The tool opens showing "No Devices Found" in the status bar at the bottom — this is expected before connecting.
You will see two main tabs: Download Image (for unified .img flashing) and Upgrade Firmware (for partitioned flashing).
Maskrom Mode (preferred for recovery / full flash):
- Power off the device completely.
- Hold the RECOVERY button (or short the Maskrom pads on the PCB).
- While holding, connect the USB cable to your PC.
- Release after 2–3 seconds.
Loader Mode (for routine upgrades on a working device):
- Power on the device normally.
- Connect USB — the device enters Loader mode automatically if RKDevTool is open.
RKDevTool status bar shows "Found One MASKROM Device" or "Found One LOADER Device".
For a unified firmware .img file:
- Click the Upgrade Firmware tab.
- Click Firmware and browse to your
.imgfile. - RKDevTool reads the firmware header and displays chipset info — verify it matches your device.
For individual partition files:
- Click the Download Image tab.
- For each row, check the checkbox and click the path cell to browse to the corresponding partition image (parameter, uboot, trust, boot, recovery, system, userdata).
Click Upgrade (on the Upgrade Firmware tab) or Run (on Download Image tab). RKDevTool flashes each partition in sequence.
The progress log on the right shows each partition name and write status. Total time: 2–8 minutes.
On success, RKDevTool shows Download image OK and the device reboots.
The device boots into the freshly flashed firmware. Rockchip Android/Linux boots are typically faster than phone Android — expect 1–3 minutes on first boot.
For Android devices, verify in Settings → About Device. For Linux single-board computers, connect via UART serial console to confirm boot messages.
Congratulations! Flash Successful!
You've successfully completed all steps. Your device should now be running the new firmware. If it's booting normally — you're done! Check the troubleshooting section below if you encounter any issues.
Troubleshooting & FAQ
Common errors and their solutions. Read this before asking for help.
The loader file embedded in the firmware is incompatible with your chip revision. Try clicking Download instead of Upgrade and manually specify the loader file (MiniLoaderAll.bin) from your firmware package. Also ensure you're using a correct USB cable — cheap cables cause data errors.
Hold the RECOVERY/MASKROM button longer (5+ seconds) before connecting USB. On some boards, the Maskrom pads must be shorted (use tweezers or a resistor). Check your board's specific documentation for the Maskrom method.
RKDevTool is Windows-only. On Linux, use rkdeveloptool (open-source CLI alternative) or upgrade_tool from Rockchip. On macOS, rkdeveloptool can be compiled from source. These work identically to RKDevTool but via command line.
Maskrom mode is the lowest level — it's burned into the chip ROM and is always available regardless of software state. It is used for full recovery when the bootloader itself is corrupt. Loader mode requires a working bootloader and is used for routine firmware upgrades. For brick recovery, always use Maskrom.
Prioritize our guides in your Google search results.
No comments yet. Be the first to share your experience with this guide!