Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools



Edge2 Install OS into eMMC via USB Flash Tool


This document mainly introduces how to use the USB flash tool to install the OS image to Khadas SBC onboard eMMC.

Install on Windows PC


Dowload rk-dev-tool and driver-assitant then extract them to somewhere.

Install USB Drivers

  1. Enter driver-assitant folder, then run DriverInstall.exe.
  2. Double click Unistall to uninstall.
  3. Double click Install to install.

Install the OS

  1. Run RKDevTool.exe. Then clink Upgrade FirmwareFirmware to select a image.
  2. Connect Edge and PC with a USB-C data-cable (Edge will power-on automatically).
  3. Put your board into Upgrade Mode.
  4. Your PC should have found your Edge device as a connected USB device.
  5. Now all you need to do is to click the Upgrade button of the tool and wait for upgrading to complete.

Install on Ubuntu PC

Tools were only verified to function properly on Ubuntu. No guarantees were made for other Linux distributions!


Install the dependencies.

$ sudo apt-get install libusb-dev git parted

Download the Tool

Flash tools for Ubuntu/Linux.

$ git clone

Or just pull it (if you have already cloned this repository).

$ cd /path/to/utils
$ git pull

Install the Flash Tool

You need to install USB rules and create some links.

$ cd /path/to/utils
$ sudo ./INSTALL

You will see this print-out if it was successful.

Installing Amlogic flash-tool...
Host PC: Ubuntu 16.04
Installing USB rules...
[sudo] password for User:
Installing flash-tool...
Installing Rockchip flash-tool...
Host PC: Ubuntu 16.04
Installing USB rules...
Installing flash-tool...
Installing Khadas burn-tool...

Root privilege is required.

Check the USB Driver

You must now put your board into Upgrade Mode.

Check to see if Ubuntu has detected your board as an attached USB device.

VIM Series

$ lsusb | grep Amlogic
Bus 003 Device 073: ID 1b8e:c004 Amlogic, Inc. DNL

Edge Series

$ lsusb | grep Rockchip
Bus 003 Device 117: ID 2207:350b Fuzhou Rockchip Electronics Company 

The message above means that your board is connected and recogized by Ubuntu.

Install the OS on Ubuntu


$ burn-tool -v aml -b VIM1 -i /path/to/image


$ burn-tool -v aml -b VIM2 -i /path/to/image


$ burn-tool -v aml -b VIM3 -i /path/to/image


$ burn-tool -v aml -b VIM4 -i /path/to/image


$ burn-tool -v aml -b VIM1S -i /path/to/image


$ rk-burn-tool -i /path/to/image


$ burn-tool -v rk -i /path/to/image

For more information please refer to flash-tool docs.

Uninstall the Flash Tool

$ cd /path/to/utils
$ sudo ./UNINSTALL
2022/07/07 06:30 · frank
Last modified: 2024/01/12 22:03 by nick