====== Install OS into eMMC on Ubuntu ======


<WRAP important >
Tools were only verified to function properly on Ubuntu. No guarantees were made for other Linux distributions!
</WRAP>


===== Preparation =====

Install the dependencies.

```shell
$ sudo apt-get install libusb-dev git parted
```

===== Download the Tool =====

[[kg>utils|Flash tools for Ubuntu/Linux]].

```shell
$ git clone https://github.com/khadas/utils
```

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

```shell
$ cd /path/to/utils
$ git pull
```

===== Install the Flash Tool =====

You need to install USB rules and create some links.

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

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

```txt
Installing Amlogic flash-tool...

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

Host PC: Ubuntu 16.04

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

Installing USB rules...
[sudo] password for User:
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!
```

<wrap important >
Root privilege is required.
</wrap>

===== Check the USB Driver =====


You must now put your board into [[boot-into-upgrade-mode| Upgrade Mode]].

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

<tabbox VIM Series>

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

<tabbox Edge Series>

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

</tabbox>


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

===== Install the OS on Ubuntu =====

<tabbox VIM1> 

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

<tabbox VIM2> 

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

<tabbox VIM3/3L> 

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

<tabbox VIM4> 

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

<tabbox VIM1S> 

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

<tabbox Edge1/Edge2> 
```shell
$ rk-burn-tool -i /path/to/image
```

Or

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


</tabbox>


For more information please refer to [[kg>/utils/|flash-tool docs]].

===== Uninstall the Flash Tool =====

```shell
$ cd /path/to/utils
$ sudo ./UNINSTALL
```