Difference between revisions of "Template:RK3399-BurnOS-To-EMMC"

From FriendlyELEC WiKi
Jump to: navigation, search
(updated by API)
(updated by API)
 
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
===Flash Image to eMMC===
 
===Flash Image to eMMC===
As for a RK3399 based ARM board developed by FriendlyELEC there are three ways to flash an image to eMMC:
+
{{#switch: {{{1}}}
* Use eflasher to make a bootable SD card and flash an image to eMMC with this card
+
| NanoPC-T4 =
* Use a Windows' utility "AndroidTool_Release_v2.42" provided by Rockchip to flash an image to eMMC with a Type-C cable
+
NanoPC-T4 there are three ways to flash an image to eMMC:
 +
* Use [[EFlasher]] to make a bootable SD card and flash an image to eMMC with this card
 +
* Use a Windows' utility "AndroidTool_Release_v2.54" provided by Rockchip to flash an image to eMMC with a Type-C cable
 
* Use a Linux utility Linux_Upgrade_Tool_1.27 provided by Rockchip to flash an image to eMMC with a Type-C cable
 
* Use a Linux utility Linux_Upgrade_Tool_1.27 provided by Rockchip to flash an image to eMMC with a Type-C cable
 
If you are not familiar with the two utilities provided by Rockchip or you don't have a Type-C cable we suggest you try the first method.
 
If you are not familiar with the two utilities provided by Rockchip or you don't have a Type-C cable we suggest you try the first method.
 
+
| #default =
 +
<br />
 +
}}
 
====Download Image and Utilities====
 
====Download Image and Utilities====
Visit [http://download.friendlyarm.com/{{{1}}} download link] to download image files and utilities.<br />
+
Visit [http://download.friendlyelec.com/{{{1}}} download link] to download image files and utilities.<br />
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
   | colspan=2 | Image Files
+
   | colspan=2 | '''Android OS'''
 
|-
 
|-
   | rk3399-eflasher-android-YYYYMMDD.img.zip
+
   | rk3399-eflasher-android10-YYYYMMDD.img.zip
   | Android 7.1.2 image file
+
   | Android10 image file
 
|-
 
|-
   | rk3399-eflasher-friendlydesktop-arm64-YYYYMMDD.img.zip
+
   | rk3399-eflasher-android8-YYYYMMDD.img.zip
   | 64-bit FriendlyDesktop image file based on Ubuntu desktop 18.04 64bit
+
   | Android8.1 image file
 
|-
 
|-
   | rk3399-eflasher-friendlycore-arm64-YYYYMMDD.img.zip
+
   | rk3399-eflasher-android7-YYYYMMDD.img.zip
   | 64-bit FriendlyCore image file(Qt 5.10.0) based on Ubuntu core 18.04 64bit
+
   | Android7.1.2  image file
 
|-
 
|-
   | rk3399-eflasher-lubuntu-YYYYMMDD-.img.zip
+
   | colspan=2 | '''Linux OS'''
  | Lubuntu Desktop(with Qt 5.10.0)
+
 
|-
 
|-
   | colspan=2 | Flash Utility:
+
   | rk3399-eflasher-debian-bullseye-core-4.19-arm64-YYYYMMDD.img.gz
 +
  | '''Debian 11(Bullseye) Core'''<br />No desktop environment, command line only<br />Kernel version 4.19.y
 +
<!--
 
|-
 
|-
   | win32diskimager.rar
+
   | rk3399-eflasher-debian-bullseye-minimal-4.19-arm64-YYYYMMDD.img.gz
   | Windows utility. Under Linux users can use "dd"
+
   | '''Debian 11(Bullseye) Desktop'''<br />Uses LXDE as default desktop<br />No pre-installed recommended software<br />Supports hardware acceleration<br >Kernel version 4.19.y
 
|-
 
|-
|}
+
  | rk3399-eflasher-debian-bullseye-desktop-4.19-arm64-YYYYMMDD.img.gz
 
+
  | '''Debian 11(Bullseye) Desktop'''<br />Uses LXDE as default desktop<br />Pre-installed mpv, smplayer and chromium brower<br />Supports hardware acceleration<br >Kernel version 4.19.y
====Flash Image to eMMC with eflasher and SD card====
+
-->
* Get a 8G SDHC card;
+
* Download the "rk3399-eflasher-YYYYMMDD-XXXX.img.zip" and "win32diskimager" and extract them on a Windows PC;
+
* Run the "win32diskimager" utility as administrator, select your TF card, wanted file and click on "Write" to start flash the image to your TF card;
+
* After it is done take out the TF card and insert it to your {{{1}}}'s microSD slot;
+
* Connect a DC power cord and an HDMI monitor to your {{{1}}}, press and hold the Power button for at least 1.5 seconds and you will see the PWR led is on and the image on SD card is booted. Around 15 seconds later the HDMI monitor will display a Window;
+
* Select your wanted OS with a USB mouse and click on "Next" to continue;
+
* After flashing is done press and release the Power button to shut down the system. After the PWR is off take out the TF card. Press and hold the Power button for at least 1.5 seconds the image will be booted from eMMC.
+
 
+
====Flash Image under Windows with Type-C Cable====
+
Visit [http://download.friendlyarm.com/{{{1}}} download link] to download Windows utilities and image files:<br />
+
{| class="wikitable"
+
 
|-
 
|-
   | colspan=2 | Image Files
+
   | rk3399-eflasher-debian-buster-desktop-arm64-YYYYMMDD.img.gz
 +
  | Debian 10(buster) Desktop, Uses LXDE as default desktop, Supports hardware acceleration, Kernel version 4.19.y
 
|-
 
|-
   | rk3399-typec-android-nougat-YYYYMMDD.tgz
+
   | rk3399-eflasher-buildroot-4.19-arm64-YYYYMMDD.img.gz
   | Android 7.1.2 Image File
+
   | [[Buildroot for RK3399|Buildroot]] image file with Qt5-wayland (base on Rockchip Linux SDK)
 
|-
 
|-
   | rk3399-typec-friendlycore-arm64-YYYYMMDD.tgz
+
   | rk3399-eflasher-friendlydesktop-bionic-4.4-arm64-YYYYMMDD.img.zip
   | FriendlyCore Image File(Qt 5.10)
+
   | 64-bit [[FriendlyDesktop 18.04 for RK3399|FriendlyDesktop]] image file based on Ubuntu desktop 18.04 64bit
 
|-
 
|-
   | rk3399-typec-friendlydesktop-arm64-YYYYMMDD.tgz
+
   | rk3399-eflasher-friendlycore-focal-4.19-arm64-YYYYMMDD.img.gz
   | FriendlyDesktop with X Window
+
   | 64-bit [[FriendlyCore (based on ubuntu-core with Qt)|FriendlyCore]] image file(Qt 5.10.0) based on Ubuntu core 20.04 64bit
 
|-
 
|-
   | rk3399-typec-lubuntu-desktop-YYYYMMDD.tgz
+
   | rk3399-eflasher-friendlycore-bionic-4.4-arm64-YYYYMMDD.img.gz
   | Lubuntu Desktop with X Window
+
   | 64-bit [[FriendlyCore (based on ubuntu-core with Qt)|FriendlyCore]] image file(Qt 5.10.0) based on Ubuntu core 18.04 64bit
 
|-
 
|-
   | colspan=2 | Flash Utility:
+
   | rk3399-eflasher-lubuntu-desktop-xenial-4.4-armhf-YYYYMMDD.img.zip
 +
  | [[Lubuntu desktop 16.04 for RK3399|Lubuntu Desktop(with Qt 5.10.0)]]
 
|-
 
|-
   | AndroidTool_Release_v2.42.7z
+
   | colspan=2 | '''Linux Lite OS'''
  | Windows utility provided by Rockchip
+
 
|-
 
|-
   | DriverAssitant_v4.5.tgz
+
   | rk3399-eflasher-friendlycore-lite-focal-5.10-arm64-20211029.img.zip
   | USB driver for Windows provided by Rockchip. This is needed when using AndroidTool to flash OS
+
   | 64-bit FriendlyCore Lite image file based on Ubuntu core 20.04 64bit, kernel version 5.15.y
 
|-
 
|-
|}
+
  | rk3399-eflasher-friendlycore-lite-focal-4.19-arm64-20211029.img.zip
Here are the steps:<br />
+
  | 64-bit FriendlyCore Lite  image file based on Ubuntu core 20.04 64bit, kernel version 4.19.y
* Download DriverAssitant_v4.5.tgz, extract it and install it on a Windows PC;
+
* Download your wanted image from images-for-eflasher and extract it. For example the image for Android 7 is "android-nougat-images.tgz". You can ignore the "idbloader.img" and "info.conf" files.  
+
* Download AndroidTool_Release_v2.42.7z, extract it and run AndroidTool.exe as administrator.
+
* Import a parameter.txt for sections and configure a file for each section if needed:
+
[[File:AndroidTools_DI_01.png|Download Android Image]]
+
* Connect a DC power cord and an HDMI monitor to your {{{1}}}, connect your {{{1}}} to a PC with a Type-C cable. Press and hold the Recovery button and the Power button for at least 1.5 seconds AndroidTools will prompt that a LOADER device is found
+
<br />a) If eMMC hasn't been flashed with an image or the image inside is removed or damaged this eMMC will be recognized as a MASKROM device;
+
<br />b) You can hold both the BOOT button and the Power button for at least 5 seconds to force the board to enter the MASKROM mode;
+
<br />c) If your system shows "no device is found" you need to check if you have installed a driver or if your Type-C cable works and then try it again;
+
<br />d) If your system is booted successfully you can run "reboot loader" on your board via adb or SSH and force your board to enter the LOADER mode.
+
* Click on "Run" to download your wanted image to eMMC. A while later after the image is flashed successfully your board will be rebooted automatically.
+
* If you want to update your system e.g. you want to replace the Linux system on your board with an Android system, you need to erase your eMMC by following the steps below:<br/>
+
Go to "Update Firmware" -> Select "MiniLoaderAll.bin" and then click on "Erase Flash"<br/>
+
[[File:Rk-clean-emmc.png]]
+
<br/>
+
 
+
====Flash Image to eMMC under Linux with Type-C Cable====
+
Visit [http://download.friendlyarm.com/{{{1}}} download link] to download Windows utilities and image files<br />
+
{| class="wikitable"
+
 
|-
 
|-
   | colspan=2 | Image Files
+
   | colspan=2 | '''FriendlyWrt'''
 
|-
 
|-
   | rk3399-typec-android-nougat-YYYYMMDD.tgz
+
   | rk3399-eflasher-friendlywrt-21.02-YYYYMMDD.img.gz
   | Android 7.1.2 Image File
+
   | [[How to Build FriendlyWrt|FriendlyWrt]] image file, based on OpenWrt 21.02, kernel version 5.15.y
 
|-
 
|-
   | rk3399-typec-friendlycore-arm64-YYYYMMDD.tgz
+
   | rk3399-eflasher-friendlywrt-21.02-docker-YYYYMMDD.img.gz
   | FriendlyCore Image File(Qt 5.10)
+
   | [[How to Build FriendlyWrt|FriendlyWrt]] image file,based on OpenWrt 21.02, Pre-installed Docker,kernel version 5.15.y
 
|-
 
|-
   | rk3399-typec-friendlydesktop-arm64-YYYYMMDD.tgz
+
   | rk3399-eflasher-friendlywrt-22.03-YYYYMMDD.img.gz
   | FriendlyDesktop with X Window
+
   | [[How to Build FriendlyWrt|FriendlyWrt]] image file,based on OpenWrt 22.03,kernel version 5.15.y
 
|-
 
|-
   | rk3399-typec-lubuntu-desktop-YYYYMMDD.tgz
+
   | rk3399-eflasher-friendlywrt-22.03-docker-YYYYMMDD.img.gz
   | Lubuntu Desktop with X Window
+
   | [[How to Build FriendlyWrt|FriendlyWrt]] image file,based on OpenWrt 22.03, Pre-installed Docker,kernel version 5.15.y
 
|-
 
|-
   | colspan=2 | Flash Utility:
+
   | rk3399-eflasher-friendlywrt-kernel4-YYYYMMDD.img.zip
 +
  | [[How to Build FriendlyWrt|FriendlyWrt]] image file, based on OpenWrt 21.02, kernel version 4.19.y
 
|-
 
|-
   | Linux_Upgrade_Tool_1.27.rar
+
   | colspan=2 | '''Flash Utility:'''
  | Linux utility provided by Rockchip
+
 
|-
 
|-
 +
  | win32diskimager.rar
 +
  | Windows utility. Under Linux users can use "dd"
 
|}
 
|}
  
Linux_Upgrade_Tool is a Linux utility provided by Rockchip. You need to use it together with a Type-C cable. It can be used to install an image to eMMC, delete image files from eMMC, read from and write to eMMC and etc.
+
====Flash Image to eMMC with eflasher and SD card====
* Install upgrade_tool: download Linux_Upgrade_Tool_1.27.rar, extract it and set upgrade_tool's access right
+
* Get an 8G SDHC card and backup its data if necessary;
<syntaxhighlight lang="bash">
+
* Download and extract the rk3399-eflasher-OSNAME-YYYYMMDD.img.zip and win32diskimager;
sudo cp upgrade_tool /usr/local/sbin
+
* Run the win32diskimager utility under Windows as administrator. On the utility's main window select your SD card's drive, the wanted image file [[EFlasher/zh|EFlasher]] and click on "write" to start flashing the SD card. Under Linux run "dd" to flash the rk3399-eflasher-OSNAME-YYYYMMDD.img file to your SD card;
sudo chown root:root /usr/local/sbin/upgrade_tool
+
* Take out the SD and insert it to {{{1}}}'s microSD card slot;
sudo chmod 0755 /usr/local/sbin/upgrade_tool
+
{{#switch: {{{1}}}
</syntaxhighlight>
+
  | NanoPC-T4 =
* Download your wanted image from images-for-eflasher and extract it. For example the image for Lubuntu is "lubuntu-desktop-images.tgz".
+
* Press and hold {{{1}}}'s Power button and wait until the PWR LED is on which indicates the system is booted from the SD card and the [[EFlasher/zh|EFlasher]] utility will be automatically launched. You can work with the [[EFlasher/zh|EFlasher]] in multiple ways:
* Refer to the steps in "Flash Image to eMMC with AndroidTool" to boot your board and force it to enter either LOADER or MASKROM mode;
+
1: Connect an LCD or HDMI monitor to your board and work with EFlasher's GUI. If the LCD doesn't support touch functions you need to connect a USB mouse to your board and proceed;<br />
* Run the following commands to flash Lubuntu to eMMC and reboot your board:
+
2: Connect your board to a LAN, login onto the board with SSH and type "eflasher" in a commandline utility and proceed with prompts;(Note: when you login with SSH the username is root and the password is fa. Your board's IP address can be found by checking the router's system)<br />
<syntaxhighlight lang="bash">
+
3: Login onto your board via a serial terminal and type "eflasher" to proceed; <br />
  sudo upgrade_tool ul MiniLoaderAll.bin
+
4: Connect a [[Matrix - LCD2USB|lcd2usb]] to {{{1}}}, press the K1 button on the LCD2USB board to select your wanted OS and press the K2 button to confirm. The installation process will be shown on [[Matrix - LCD2USB|lcd2usb]];<br />
sudo upgrade_tool di -p parameter.txt
+
* After installation is done press the Power button to turn off the board and take out the SD card from {{{1}}};
  sudo upgrade_tool di uboot uboot.img
+
* Press and hold the Power button to turn on your board and it will be booted from eMMC;
sudo upgrade_tool di trust trust.img
+
| #default =
sudo upgrade_tool di resource resource.img
+
* Power on {{{1}}} and it will be booted from your SD card and the [[EFlasher/zh|EFlasher]] utility will be automatically launched. You can work with the [[EFlasher/zh|EFlasher]] in multiple ways:
sudo upgrade_tool di kernel kernel.img
+
1: Connect an HDMI monitor and a USB mouse to your board and work with EFlasher's GUI;<br />
sudo upgrade_tool di boot boot.img
+
2: Connect your board to a LAN, login onto the board with SSH and type "eflasher" in a commandline utility and proceed with prompts;(Note: when you login with SSH the username is root and the password is fa. Your board's IP address can be found by checking the router's system)<br />
sudo upgrade_tool di rootfs rootfs.img
+
3: Login onto your board via a serial terminal and type "eflasher" to proceed; <br />
sudo upgrade_tool RD
+
4: Connect a [[Matrix - LCD2USB|lcd2usb]] to {{{1}}}, press the K1 button on the LCD2USB board to select your wanted OS and press the K2 button to confirm. The installation process will be shown on [[Matrix - LCD2USB|lcd2usb]];<br />
</syntaxhighlight>
+
* After installation is done turn off the board and take out the SD card from {{{1}}}, power on the board and it will be booted from eMMC;
* If you want to flash Android 7 to eMMC you can download and extract its image file and run the following commands:
+
}}
<syntaxhighlight lang="bash">
+
sudo upgrade_tool ul MiniLoaderAll.bin
+
sudo upgrade_tool di -p parameter.txt
+
sudo upgrade_tool di uboot uboot.img
+
sudo upgrade_tool di trust trust.img
+
sudo upgrade_tool di misc misc.img
+
sudo upgrade_tool di resource resource.img
+
sudo upgrade_tool di kernel kernel.img
+
sudo upgrade_tool di boot boot.img
+
sudo upgrade_tool di recovery recovery.img
+
sudo upgrade_tool di system system.img
+
sudo upgrade_tool RD
+
</syntaxhighlight>
+
 
+
If the image's MiniLoaderAll.bin has a different version or the image you want to flash to eMMC is different from the image that already exists in eMMC you need to erase eMMC and then flash your new image to it.<br />
+
Boot your board and enter the LOADER mode, run the following commands to erase eMMC. If a prompt shows "Download Boot Start" and it lasts for 10 seconds you need to press the Reset button and run the following commands again.
+
<syntaxhighlight lang="bash">
+
sudo upgrade_tool EF MiniLoaderAll.bin
+
</syntaxhighlight>
+
If it succeeds you will see a prompt showing "Erase flash ok."
+

Latest revision as of 07:51, 23 May 2023

1 Flash Image to eMMC


1.1 Download Image and Utilities

Visit download link to download image files and utilities.

Android OS
rk3399-eflasher-android10-YYYYMMDD.img.zip Android10 image file
rk3399-eflasher-android8-YYYYMMDD.img.zip Android8.1 image file
rk3399-eflasher-android7-YYYYMMDD.img.zip Android7.1.2 image file
Linux OS
rk3399-eflasher-debian-bullseye-core-4.19-arm64-YYYYMMDD.img.gz Debian 11(Bullseye) Core
No desktop environment, command line only
Kernel version 4.19.y
rk3399-eflasher-debian-buster-desktop-arm64-YYYYMMDD.img.gz Debian 10(buster) Desktop, Uses LXDE as default desktop, Supports hardware acceleration, Kernel version 4.19.y
rk3399-eflasher-buildroot-4.19-arm64-YYYYMMDD.img.gz Buildroot image file with Qt5-wayland (base on Rockchip Linux SDK)
rk3399-eflasher-friendlydesktop-bionic-4.4-arm64-YYYYMMDD.img.zip 64-bit FriendlyDesktop image file based on Ubuntu desktop 18.04 64bit
rk3399-eflasher-friendlycore-focal-4.19-arm64-YYYYMMDD.img.gz 64-bit FriendlyCore image file(Qt 5.10.0) based on Ubuntu core 20.04 64bit
rk3399-eflasher-friendlycore-bionic-4.4-arm64-YYYYMMDD.img.gz 64-bit FriendlyCore image file(Qt 5.10.0) based on Ubuntu core 18.04 64bit
rk3399-eflasher-lubuntu-desktop-xenial-4.4-armhf-YYYYMMDD.img.zip Lubuntu Desktop(with Qt 5.10.0)
Linux Lite OS
rk3399-eflasher-friendlycore-lite-focal-5.10-arm64-20211029.img.zip 64-bit FriendlyCore Lite image file based on Ubuntu core 20.04 64bit, kernel version 5.15.y
rk3399-eflasher-friendlycore-lite-focal-4.19-arm64-20211029.img.zip 64-bit FriendlyCore Lite image file based on Ubuntu core 20.04 64bit, kernel version 4.19.y
FriendlyWrt
rk3399-eflasher-friendlywrt-21.02-YYYYMMDD.img.gz FriendlyWrt image file, based on OpenWrt 21.02, kernel version 5.15.y
rk3399-eflasher-friendlywrt-21.02-docker-YYYYMMDD.img.gz FriendlyWrt image file,based on OpenWrt 21.02, Pre-installed Docker,kernel version 5.15.y
rk3399-eflasher-friendlywrt-22.03-YYYYMMDD.img.gz FriendlyWrt image file,based on OpenWrt 22.03,kernel version 5.15.y
rk3399-eflasher-friendlywrt-22.03-docker-YYYYMMDD.img.gz FriendlyWrt image file,based on OpenWrt 22.03, Pre-installed Docker,kernel version 5.15.y
rk3399-eflasher-friendlywrt-kernel4-YYYYMMDD.img.zip FriendlyWrt image file, based on OpenWrt 21.02, kernel version 4.19.y
Flash Utility:
win32diskimager.rar Windows utility. Under Linux users can use "dd"

1.2 Flash Image to eMMC with eflasher and SD card

  • Get an 8G SDHC card and backup its data if necessary;
  • Download and extract the rk3399-eflasher-OSNAME-YYYYMMDD.img.zip and win32diskimager;
  • Run the win32diskimager utility under Windows as administrator. On the utility's main window select your SD card's drive, the wanted image file EFlasher and click on "write" to start flashing the SD card. Under Linux run "dd" to flash the rk3399-eflasher-OSNAME-YYYYMMDD.img file to your SD card;
  • Take out the SD and insert it to {{{1}}}'s microSD card slot;
  • Power on {{{1}}} and it will be booted from your SD card and the EFlasher utility will be automatically launched. You can work with the EFlasher in multiple ways:

1: Connect an HDMI monitor and a USB mouse to your board and work with EFlasher's GUI;
2: Connect your board to a LAN, login onto the board with SSH and type "eflasher" in a commandline utility and proceed with prompts;(Note: when you login with SSH the username is root and the password is fa. Your board's IP address can be found by checking the router's system)
3: Login onto your board via a serial terminal and type "eflasher" to proceed;
4: Connect a lcd2usb to {{{1}}}, press the K1 button on the LCD2USB board to select your wanted OS and press the K2 button to confirm. The installation process will be shown on lcd2usb;

  • After installation is done turn off the board and take out the SD card from {{{1}}}, power on the board and it will be booted from eMMC;