Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools


products:sbc:vim4:install-os:install-os-into-emmc-via-usb-tool

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
products:sbc:vim4:install-os:install-os-into-emmc-via-usb-tool [2022/07/01 05:45]
nick
products:sbc:vim4:install-os:install-os-into-emmc-via-usb-tool [2023/06/05 09:29] (current)
nick
Line 1: Line 1:
-====== Install OS into eMMC ======+{{indexmenu_n>20}}
  
-All VIM series boards have **onboard eMMC storage**, so you can install the **OS** into the **eMMC** using the **USB upgrade tool**. 
  
-===== Install on Windows =====+====== VIM4 Install OS into eMMC via USB Flash Tool ====== 
 + 
 +===== Install on Windows PC =====
  
 ==== Preparation ==== ==== Preparation ====
Line 11: Line 12:
 ==== Install USB Drivers  ==== ==== Install USB Drivers  ====
    
-  - Goto directory ''V3\Driver'' and double click ''dpscat.exe'' to install.Please note there is no GUI display.+  - Goto directory ''V3\Driver'' and double click ''dpscat.exe'' to install. Please note there is no GUI display.
   - Goto directory ''V3\Driver'' and double click ''dpinst64.exe'' to install.   - Goto directory ''V3\Driver'' and double click ''dpinst64.exe'' to install.
  
-==== Flash Image ====+==== Install the OS ====
  
-  - Goto root directory double click ''Aml_Burn_Tool.exe'' to open the USB upgrade tool+  - Goto ''V3'' directory double click ''Aml_Burn_Tool.exe'' to open the USB upgrade tool.
   - Click ''Setup-->Load Image'', then choose an [[dl>products/vim4/firmware/ | OS image]] for your board.   - Click ''Setup-->Load Image'', then choose an [[dl>products/vim4/firmware/ | OS image]] for your board.
   - Connect your board to your PC with a USB-C cable (the board will power on automatically).   - Connect your board to your PC with a USB-C cable (the board will power on automatically).
   - Put your board into [[boot-into-upgrade-mode | Upgrade Mode]].   - Put your board into [[boot-into-upgrade-mode | Upgrade Mode]].
-  - If you have performed steps 3 and 4 correctly, your PC will automatically discover your board as an attached USB-device. +  - If you have  correctlyperformed steps 3 and 4, your PC will automatically discover your board as an attached USB-device. 
-  - Now all you need to do is to click the ''Start'' button and wait for process to complete.+  - Now what you need to do is to click the ''Start'' button and wait for the process to complete.
  
-{{:products:sbc:vim4:install-os:usb-upgrade-tool-interface-en.png?800|}}+{{products:sbc:vim4:install-os:usb-upgrade-tool-interface-en.png?800|}}
  
  
-<note info>+<WRAP info>
  
-  * To interrupt flashing, click the ''Stop'' button, then close the USB Upgrade Tool. Note that the eMMC may already have been completely erased if you went past the 15% mark. +  * Click the ''Stop'' button to interrupt flashing, then close the USB Upgrade Tool. Note that the eMMC may have already been completely erased if you went past the 15% mark. 
-  * An [[extra-power-input | External Power Supply]] may be required in cases where your PC cannot provide enough electrical power for the burning process.+  * An [[products:sbc:vim4:hardware:external-power-supply | External Power Supply]] may be required when your PC cannot provide enough electrical power for the burning process.
   * If your system is a 32-bit system, please select ''dpinst32.exe'' when installing the driver.   * If your system is a 32-bit system, please select ''dpinst32.exe'' when installing the driver.
  
-</note>+</WRAP>
  
 +===== Install on Ubuntu PC =====
  
-===== Install on Ubuntu ===== +<WRAP important 
- +Tools were only verified to function properly on Ubuntu. No guarantees were made for other Linux distributions! 
- +</WRAP>
-<note warn> +
- +
-Tools were verified to function properly on Ubuntu only, we make no guarantees for other Linux distributions! +
- +
-</note>+
  
 ==== Preparation ==== ==== Preparation ====
  
 +Install the dependencies.
  
-```bash+```shell
 $ sudo apt-get install libusb-dev git parted $ sudo apt-get install libusb-dev git parted
 ``` ```
  
-==== Download Burning Tool ====+==== Download the Tool ====
  
 +/*is on Khadas GitHub*/ [[kg>utils|Flash tools for Ubuntu/Linux]].
  
-Image burning tool for Ubuntu is in this repository [[https://github.com/khadas/utils | utils]]. +```shell
- +
-```bash+
 $ git clone https://github.com/khadas/utils $ git clone https://github.com/khadas/utils
 ``` ```
Line 62: Line 59:
 Or just pull it (if you have already cloned this repository). Or just pull it (if you have already cloned this repository).
  
-```bash+```shell
 $ cd /path/to/utils $ cd /path/to/utils
 $ git pull $ git pull
 ``` ```
  
-==== Install Burning Tool ==== +==== Install the Flash Tool ====
  
 You need to install USB rules and create some links. You need to install USB rules and create some links.
  
-```bash+```shell
 $ cd /path/to/utils $ cd /path/to/utils
 $ sudo ./INSTALL $ sudo ./INSTALL
Line 79: Line 75:
 You will see this print-out if it was successful. You will see this print-out if it was successful.
  
-```bash+```txt
 Installing Amlogic flash-tool... Installing Amlogic flash-tool...
  
Line 107: Line 103:
 Done! Done!
 ``` ```
-<WRAP info> 
  
 +<wrap important >
 Root privilege is required. Root privilege is required.
- +</wrap>
-</WRAP>+
  
 ==== Check the USB Driver ==== ==== Check the USB Driver ====
  
  
-You must now place your board into `Upgrade Mode`. See [how to enter upgrade mode](BootIntoUpgradeMode.html). +You must now [[boot-into-upgrade-mode| put your board into Upgrade Mode]].
-Check to see if Ubuntu has detected your board as an attached USB-device.+
  
-```bash+Check to see if Ubuntu has detected your board as an attached USB device. 
 + 
 +```shell
 $ lsusb | grep Amlogic $ lsusb | grep Amlogic
-BUS 002 Device 036: ID 1b8e:c003 Amlogic, Inc.+Bus 003 Device 073: ID 1b8e:c004 Amlogic, Inc. DNL
 ``` ```
 +
 The message above means that your board is connected and recogized by Ubuntu. The message above means that your board is connected and recogized by Ubuntu.
  
-==== Install the OS on Ubuntu ====+==== Install the OS ====
  
 +<tabbox VIM1> 
  
 +```shell
 +$ burn-tool -v aml -b VIM1 -i /path/to/image
 +```
  
-```bash +<tabbox VIM2>  
-aml-burn-tool -i /path/to/image+ 
 +```shell 
 +$ burn-tool -v aml -b VIM2 -i /path/to/image
 ``` ```
  
-You will see these teminal logs if successful.+<tabbox VIM3/3L> 
  
-```bash +```shell 
-Rebooting the board ........[OK] +$ burn-tool -v aml -b VIM3 -i /path/to/image
-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]+
 ``` ```
  
-```bash +<tabbox VIM4>  
-aml-burn-tool -b VIM4 -i /path/to/image+ 
 +```shell 
 +$ burn-tool -v aml -b VIM4 -i /path/to/image
 ``` ```
  
 +<tabbox VIM1S> 
  
-For more information please refer to [docs](https://github.com/khadas/utils/tree/master/aml-flash-tool/docs).+```shell 
 +$ burn-tool -v aml -b VIM1S -i /path/to/image 
 +``` 
 +</tabbox>
  
-==== Uninstall Burning Tool ====+You will see these teminal logs if successful.
  
 +```txt
 +Burning image 'vim4-ubuntu-22.04-server-linux-5.4-fenix-1.0.11-220620-emmc-develop.img' for 'VIM4' to eMMC...
 +next try index 3, current opt arg vim4-ubuntu-22.04-server-linux-5.4-fenix-1.0.11-220620-emmc-develop.img
 +MSG[TLS]pkg path vim4-ubuntu-22.04-server-linux-5.4-fenix-1.0.11-220620-emmc-develop.img
 +MSG[TLS]exe run path:/storage/code/git/utils/aml-flash-tool/tools/adnl
 +MSG[FLW]Aml_flow_init version V1.1-trunk Nov  1 2019!
 +MSG[FLW]Tooltype 3
 +DBG[FLW]ok in load lib AmlImagePack.so
 +MSG[FLW]OK leave Aml_flow_init
 +
 +...
 +
 +MSG[TLS][105660110991160c00000000]LMsg[usbFlw]cmd[oem mwrite 0x1cefb normal store _aml_dtb]
 +MSG[TLS][105660110991160c00000000]LMsg[usbFlw][MWrite] finsihed
 +MSG[TLS]UI:Verifying__aml_dtb
 +MSG[TLS][105660110991160c00000000]LMsg[usbFlw]cmd[oem verify sha1sum 799ab7772f6dc4d78d9612916910b589e63df481]
 +MSG[TLS]UI:Downloading_bootloader] %98..
 +MSG[TLS][105660110991160c00000000]LMsg[usbFlw]cmd[oem mwrite 0x319000 normal store bootloader]
 +MSG[TLS][105660110991160c00000000]LMsg[usbFlw][MWrite] finsihed
 +MSG[TLS]UI:Verifying_bootloader
 +MSG[TLS][105660110991160c00000000]LMsg[usbFlw]cmd[oem verify sha1sum f5ab1b260d5153161fed73a7baca58330c105863]
 +MSG[TLS][105660110991160c00000000]LMsg[usbFlw]cmd[oem save_setting]
 +MSG[TLS][105660110991160c00000000]burn successful^_^
 +Time elapsed: 3 minute(s).
 +Done!
  
-```bash 
-$ cd /path/to/utils 
-$ sudo ./UNINSTALL 
 ``` ```
  
 +For more information please refer to [[https://github.com/khadas/utils/tree/master/aml-flash-tool/docs|aml-flash-tool docs]].
  
-==== See Also ====+==== Uninstall the Flash Tool ====
  
-[boot-into-upgrade-mode| Boot into Upgrade Mode).+```shell 
 +$ cd /path/to/utils 
 +$ sudo ./UNINSTALL 
 +```
  
Last modified: 2022/07/01 05:45 by nick