Install OS into eMMC

The operation for VIM series are almost the same, so this documentation will take VIM1 as an example.

All the VIM series boards have onboard eMMC storage, so you can install the OS via USB upgrade tool.

Preparation

  • Dowload the USB Upgrade Tool and extract it.
  • Run setup_v2.x.x.exe to install the tool for upgrading your board.
    Image of USB_Upgrade_tool_setup_v217

Installation

Make sure that you have installed the correct USB upgrade Tool, then follow the steps below:

  1. Open USB_Burning_tool_v2.x.x.exe, click File-->Import Image to choose an image for your board.

  2. Connect your board to your PC with a USB-C data cable (the board will power on automatically).

  3. Put your board into Upgrade Mode.

  4. If you have performed steps 2 and 3 correctly, your PC will automatically discover your board as a connected USB-device.

    Now all you need to do is to click the Start button of the tool and wait for upgrading to complete:
    Image of USB_Upgrade_Tool_Interface_v217

Tips
  • To cancel an upgrade, click the Stop button, then close the USB Upgrade Tool. Note that the eMMC might already have been completely erased if you went past the 15% mark.
  • Extra power supply may be required in cases whereby your PC cannot provide enough electrical-current for the upgrade.
Note

We only verify the tool on Ubuntu, for other distributions may not work properly!

Preparation

1
$ sudo apt-get install libusb-dev git parted

Download Burning Tool

Image burning tool for Ubuntu is in this repository utils.

1
$ git clone https://github.com/khadas/utils

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

1
2
$ cd /path/to/utils
$ git pull

Install Burning Tool

You need to install USB rules and create some links.

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

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
Installing Amlogic flash-tool...

===============================================

Host PC: Ubuntu 16.04

===============================================

Installing USB rules...
[sudo] password for frank:
Installing flash-tool...
Done!

Installing Rockchip flash-tool...

===============================================

Host PC: Ubuntu 16.04

===============================================

Installing USB rules...
Installing flash-tool...
Done!
Installing Khadas burn-tool...
Done!
Note

Root privilege required.

Check The USB Driver

You must now place your board into Upgrade Mode.See how to enter upgrade mode.
Check to see if Ubuntu has detected your board as a connected USB-device.

1
2
$ lsusb | grep Amlogic
BUS 002 Device 036: ID 1b8e:c003 Amlogic, Inc.

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

Install the System on Ubuntu

There are two commands that be used to install the system: burn-tool and aml-burn-tool.

For example, install the system for VIM3:

  • General command burn-tool:
1
$ burn-tool -v aml -b VIM3 -i /path/to/image
  • Amlogic command aml-burn-tool:
1
$ aml-burn-tool -b VIM3 -i /path/to/image
Note

For VIM3/VIM3L, you must specify the board with -b VIM3 or it will fail. For VIM1 or VIM2 you can ignore this.

You will see these teminal logs if successful.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Rebooting the board ........[OK]
Unpacking image [OK]
Initializing ddr ........[OK]
Running u-boot ........[OK]
Create partitions [OK]
Writing device tree [OK]
Writing bootloader [OK]
Wiping data partition [OK]
Wiping cache partition [OK]
Writing boot partition [OK]
Writing data partition [OK]
Writing logo partition [OK]
Writing system partition [OK]
Do you want to reset the board? y/n [n]? y
Resetting board [OK]

For more information please refer to docs.

Uninstall Burning Tool

1
2
$ cd /path/to/utils
$ sudo ./UNINSTALL

See Also