Difference between revisions of "Template:RK3399-BurnOS-with-TypeC"

From FriendlyELEC WiKi
Jump to: navigation, search
(updated by API)
 
(updated by API)
 
(16 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
====Flash Image under Windows with Type-C Cable====
 
====Flash Image under Windows with Type-C Cable====
Visit [http://download.friendlyarm.com/{{{1}}} download link] to download Windows utilities and image files:<br />
+
Visit [http://download.friendlyelec.com/{{{1}}} download link] to download Windows utilities and image files:<br />
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
   | colspan=2 | Image Files
+
   | colspan=2 | '''Android OS'''
 
|-
 
|-
   | rk3399-typec-android8-YYYYMMDD.img.zip
+
   | rk3399-usb-android10-YYYYMMDD.img.zip
   | Android 8.1 image file
+
   | Android10 image file
 
|-
 
|-
   | rk3399-typec-android7-YYYYMMDD.tgz
+
   | rk3399-usb-android8-YYYYMMDD.img.zip
   | Android 7.1.2 Image File
+
   | Android8.1 image file
 
|-
 
|-
   | rk3399-typec-friendlycore-bionic-4.4-arm64-YYYYMMDD.tgz
+
   | rk3399-usb-android7-YYYYMMDD.img.zip
   | FriendlyCore Image File(Qt 5.10)
+
   | Android7.1.2  image file
 
|-
 
|-
   | rk3399-typec-friendlydesktop-bionic-4.4-arm64-YYYYMMDD.tgz
+
   | colspan=2 | '''Linux OS'''
  | FriendlyDesktop with X Window
+
 
|-
 
|-
   | rk3399-typec-lubuntu-desktop-YYYYMMDD.tgz
+
   | rk3399-usb-debian-bullseye-core-arm64-YYYYMMDD.img.gz
   | Lubuntu Desktop with X Window
+
   | '''Debian 11(Bullseye) Core'''<br />No desktop environment, command line only<br />Kernel version 4.19.y
 
|-
 
|-
   | colspan=2 | Flash Utility:
+
   | rk3399-usb-debian-bullseye-minimal-arm64-YYYYMMDD.img.gz
 +
  | '''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
 
|-
 
|-
   | AndroidTool_Release_v2.42.7z
+
   | rk3399-usb-debian-bullseye-desktop-arm64-YYYYMMDD.img.gz
   | Windows utility provided by Rockchip
+
   | '''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
 +
<!--
 
|-
 
|-
   | DriverAssitant_v4.5.tgz
+
   | rk3399-usb-debian-buster-desktop-arm64-YYYYMMDD.img.zip
   | USB driver for Windows provided by Rockchip. This is needed when using AndroidTool to flash OS
+
   | Debian 10(buster) Desktop, Uses LXDE as default desktop, Supports hardware acceleration, Kernel version 4.19.y
 +
-->
 
|-
 
|-
|}
+
  | rk3399-usb-buildroot-4.19-arm64-YYYYMMDD.img.zip
Here are the steps:<br />
+
  | [[Buildroot for RK3399|Buildroot]] image file with Qt5-wayland (base on Rockchip Linux SDK)
* 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
+
   | rk3399-usb-friendlydesktop-bionic-4.4-arm64-YYYYMMDD.img.zip
 +
  | 64-bit [[FriendlyDesktop 18.04 for RK3399|FriendlyDesktop]] image file based on Ubuntu desktop 18.04 64bit
 
|-
 
|-
   | rk3399-typec-android8-YYYYMMDD.img.zip
+
   | rk3399-usb-friendlycore-focal-4.19-arm64-YYYYMMDD.img.zip
   | Android 8.1 image file
+
   | 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-android7-YYYYMMDD.tgz
+
   | rk3399-usb-friendlycore-bionic-4.4-arm64-YYYYMMDD.img.zip
   | Android 7.1.2 Image File
+
   | 64-bit [[FriendlyCore (based on ubuntu-core with Qt)|FriendlyCore]] image file(Qt 5.10.0) based on Ubuntu core 18.04 64bit
 
|-
 
|-
   | rk3399-typec-friendlycore-bionic-4.4-arm64-YYYYMMDD.tgz
+
   | rk3399-usb-lubuntu-desktop-xenial-4.4-armhf-YYYYMMDD.img.zip
   | FriendlyCore Image File(Qt 5.10)
+
   | [[Lubuntu desktop 16.04 for RK3399|Lubuntu Desktop(with Qt 5.10.0)]]
 
|-
 
|-
   | rk3399-typec-friendlydesktop-bionic-4.4-arm64-YYYYMMDD.tgz
+
   | colspan=2 | '''Linux Lite OS'''
  | FriendlyDesktop with X Window
+
 
|-
 
|-
   | rk3399-typec-lubuntu-desktop-YYYYMMDD.tgz
+
   | rk3399-usb-friendlycore-lite-focal-5.10-arm64-20211029.img.zip
   | Lubuntu Desktop with X Window
+
   | 64-bit FriendlyCore Lite image file based on Ubuntu core 20.04 64bit, kernel version 5.15.y
 
|-
 
|-
   | colspan=2 | Flash Utility:
+
   | rk3399-usb-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
 
|-
 
|-
   | Linux_Upgrade_Tool_1.27.rar
+
   | colspan=2 | '''FriendlyWrt'''
  | Linux utility provided by Rockchip
+
 
|-
 
|-
 +
  | rk3399-usb-friendlywrt-21.02-YYYYMMDD.img.gz
 +
  | [[How to Build FriendlyWrt|FriendlyWrt]] image file, based on OpenWrt 21.02, kernel version 5.15.y
 +
|-
 +
  | rk3399-usb-friendlywrt-21.02-docker-YYYYMMDD.img.gz
 +
  | [[How to Build FriendlyWrt|FriendlyWrt]] image file,based on OpenWrt 21.02, Pre-installed Docker,kernel version 5.15.y
 +
|-
 +
  | rk3399-usb-friendlywrt-22.03-YYYYMMDD.img.gz
 +
  | [[How to Build FriendlyWrt|FriendlyWrt]] image file,based on OpenWrt 22.03,kernel version 5.15.y
 +
|-
 +
  | rk3399-usb-friendlywrt-22.03-docker-YYYYMMDD.img.gz
 +
  | [[How to Build FriendlyWrt|FriendlyWrt]] image file,based on OpenWrt 22.03, Pre-installed Docker,kernel version 5.15.y
 +
|-
 +
  | rk3399-usb-friendlywrt-kernel4-YYYYMMDD.img.zip
 +
  | [[How to Build FriendlyWrt|FriendlyWrt]] image file, based on OpenWrt 21.02, kernel version 4.19.y
 +
|-
 +
  | colspan=2 | '''Flash Utility:'''
 +
|-
 +
  | DriverAssitant_v4.5.tgz
 +
  | USB driver for Windows provided by Rockchip. This is needed when using AndroidTool to flash OS
 
|}
 
|}
 +
Video Tutorial:<br />
 +
https://www.youtube.com/watch?v=Wh7gyIjB9UY<br />
 +
<br />
 +
Here are the steps:<br />
 +
* Download DriverAssitant_v4.5.tgz, extract it and install it on a Windows PC;
 +
* Download your wanted image,AndroidTools.exe tool and configuration file (config.cfg) have been built in;
 +
* Run AndroidTool.exe as administrator;
 +
* 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;
 +
* Go to "Update Firmware" -> Select "MiniLoaderAll.bin" and then click on "Erase Flash";
 +
* Back to AdnroidTools home ui,Click on "Run" to download image to eMMC. A while later after the image is flashed successfully your board will be rebooted automatically.
 +
About loader and maskrom mode:<br />
 +
* If the eMMC has no system or the eMMC system is erased or damaged, it will be displayed as a MASKROM device;
 +
* You can also press and hold the BOOT button and then long press the Power button to turn on (keep pressing the BOOT button for more than 5 seconds), it will be forced to enter the MASKROM mode;<br />
 +
* If it displays "No device found", please check whether the driver has been successfully installed, check the Type-C data cable and then reboot according to the above method, or press and hold the Recovery button and then press the Reset button;<br />
 +
* You can execute the "reboot loader" command on the terminal to restart {{{1}}}, will enter the LOADER mode;<br />
  
 +
====Flash Image to eMMC under Linux with Type-C Cable====
 +
Note: it is not supported to burn Android10 through Typc-C under Linux; <br /><br />
 
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.
 
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.
 
* Install upgrade_tool: download Linux_Upgrade_Tool_1.27.rar, extract it and set upgrade_tool's access right
 
* Install upgrade_tool: download Linux_Upgrade_Tool_1.27.rar, extract it and set upgrade_tool's access right
Line 83: Line 102:
 
* Download your wanted image from images-for-eflasher and extract it. For example the image for Lubuntu is "lubuntu-desktop-images.tgz".
 
* Download your wanted image from images-for-eflasher and extract it. For example the image for Lubuntu is "lubuntu-desktop-images.tgz".
 
* 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;
 
* 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;
* Run the following commands to flash Lubuntu to eMMC and reboot your board:
+
* '''Linux''': Run the following commands to flash '''Linux''' to eMMC and reboot your board:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
  sudo upgrade_tool ul MiniLoaderAll.bin
 
  sudo upgrade_tool ul MiniLoaderAll.bin
Line 95: Line 114:
 
  sudo upgrade_tool RD
 
  sudo upgrade_tool RD
 
</syntaxhighlight>
 
</syntaxhighlight>
* If you want to flash Android 7 to eMMC you can download and extract its image file and run the following commands:
+
* '''Android 7''': Run the following commands to flash '''Android 7''' to eMMC and reboot your board:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
sudo upgrade_tool ul MiniLoaderAll.bin
+
sudo upgrade_tool ul MiniLoaderAll.bin
sudo upgrade_tool di -p parameter.txt
+
sudo upgrade_tool di -p parameter.txt
sudo upgrade_tool di uboot uboot.img
+
sudo upgrade_tool di uboot uboot.img
sudo upgrade_tool di trust trust.img
+
sudo upgrade_tool di trust trust.img
sudo upgrade_tool di misc misc.img
+
sudo upgrade_tool di misc misc.img
sudo upgrade_tool di resource resource.img
+
sudo upgrade_tool di resource resource.img
sudo upgrade_tool di kernel kernel.img
+
sudo upgrade_tool di kernel kernel.img
sudo upgrade_tool di boot boot.img
+
sudo upgrade_tool di boot boot.img
sudo upgrade_tool di recovery recovery.img
+
sudo upgrade_tool di recovery recovery.img
sudo upgrade_tool di system system.img
+
sudo upgrade_tool di system system.img
sudo upgrade_tool RD
+
sudo upgrade_tool RD
 +
</syntaxhighlight>
 +
* '''Android 8''': Run the following commands to flash '''Android 8''' to eMMC and reboot your board:
 +
<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 di vendor vendor.img
 +
sudo upgrade_tool di oem oem.img
 +
sudo upgrade_tool RD
 
</syntaxhighlight>
 
</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 />
+
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.
 
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">
 
<syntaxhighlight lang="bash">

Latest revision as of 07:51, 23 May 2023

1 Flash Image under Windows with Type-C Cable

Visit download link to download Windows utilities and image files:

Android OS
rk3399-usb-android10-YYYYMMDD.img.zip Android10 image file
rk3399-usb-android8-YYYYMMDD.img.zip Android8.1 image file
rk3399-usb-android7-YYYYMMDD.img.zip Android7.1.2 image file
Linux OS
rk3399-usb-debian-bullseye-core-arm64-YYYYMMDD.img.gz Debian 11(Bullseye) Core
No desktop environment, command line only
Kernel version 4.19.y
rk3399-usb-debian-bullseye-minimal-arm64-YYYYMMDD.img.gz Debian 11(Bullseye) Desktop
Uses LXDE as default desktop
No pre-installed recommended software
Supports hardware acceleration
Kernel version 4.19.y
rk3399-usb-debian-bullseye-desktop-arm64-YYYYMMDD.img.gz Debian 11(Bullseye) Desktop
Uses LXDE as default desktop
Pre-installed mpv, smplayer and chromium brower
Supports hardware acceleration
Kernel version 4.19.y
rk3399-usb-buildroot-4.19-arm64-YYYYMMDD.img.zip Buildroot image file with Qt5-wayland (base on Rockchip Linux SDK)
rk3399-usb-friendlydesktop-bionic-4.4-arm64-YYYYMMDD.img.zip 64-bit FriendlyDesktop image file based on Ubuntu desktop 18.04 64bit
rk3399-usb-friendlycore-focal-4.19-arm64-YYYYMMDD.img.zip 64-bit FriendlyCore image file(Qt 5.10.0) based on Ubuntu core 20.04 64bit
rk3399-usb-friendlycore-bionic-4.4-arm64-YYYYMMDD.img.zip 64-bit FriendlyCore image file(Qt 5.10.0) based on Ubuntu core 18.04 64bit
rk3399-usb-lubuntu-desktop-xenial-4.4-armhf-YYYYMMDD.img.zip Lubuntu Desktop(with Qt 5.10.0)
Linux Lite OS
rk3399-usb-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-usb-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-usb-friendlywrt-21.02-YYYYMMDD.img.gz FriendlyWrt image file, based on OpenWrt 21.02, kernel version 5.15.y
rk3399-usb-friendlywrt-21.02-docker-YYYYMMDD.img.gz FriendlyWrt image file,based on OpenWrt 21.02, Pre-installed Docker,kernel version 5.15.y
rk3399-usb-friendlywrt-22.03-YYYYMMDD.img.gz FriendlyWrt image file,based on OpenWrt 22.03,kernel version 5.15.y
rk3399-usb-friendlywrt-22.03-docker-YYYYMMDD.img.gz FriendlyWrt image file,based on OpenWrt 22.03, Pre-installed Docker,kernel version 5.15.y
rk3399-usb-friendlywrt-kernel4-YYYYMMDD.img.zip FriendlyWrt image file, based on OpenWrt 21.02, kernel version 4.19.y
Flash Utility:
DriverAssitant_v4.5.tgz USB driver for Windows provided by Rockchip. This is needed when using AndroidTool to flash OS

Video Tutorial:
https://www.youtube.com/watch?v=Wh7gyIjB9UY

Here are the steps:

  • Download DriverAssitant_v4.5.tgz, extract it and install it on a Windows PC;
  • Download your wanted image,AndroidTools.exe tool and configuration file (config.cfg) have been built in;
  • Run AndroidTool.exe as administrator;
  • 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;
  • Go to "Update Firmware" -> Select "MiniLoaderAll.bin" and then click on "Erase Flash";
  • Back to AdnroidTools home ui,Click on "Run" to download image to eMMC. A while later after the image is flashed successfully your board will be rebooted automatically.

About loader and maskrom mode:

  • If the eMMC has no system or the eMMC system is erased or damaged, it will be displayed as a MASKROM device;
  • You can also press and hold the BOOT button and then long press the Power button to turn on (keep pressing the BOOT button for more than 5 seconds), it will be forced to enter the MASKROM mode;
  • If it displays "No device found", please check whether the driver has been successfully installed, check the Type-C data cable and then reboot according to the above method, or press and hold the Recovery button and then press the Reset button;
  • You can execute the "reboot loader" command on the terminal to restart {{{1}}}, will enter the LOADER mode;

2 Flash Image to eMMC under Linux with Type-C Cable

Note: it is not supported to burn Android10 through Typc-C under Linux;

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.

  • Install upgrade_tool: download Linux_Upgrade_Tool_1.27.rar, extract it and set upgrade_tool's access right
 sudo cp upgrade_tool /usr/local/sbin
 sudo chown root:root /usr/local/sbin/upgrade_tool
 sudo chmod 0755 /usr/local/sbin/upgrade_tool
  • Download your wanted image from images-for-eflasher and extract it. For example the image for Lubuntu is "lubuntu-desktop-images.tgz".
  • 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;
  • Linux: Run the following commands to flash Linux to eMMC and reboot your board:
 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 resource resource.img
 sudo upgrade_tool di kernel kernel.img
 sudo upgrade_tool di boot boot.img
 sudo upgrade_tool di rootfs rootfs.img
 sudo upgrade_tool RD
  • Android 7: Run the following commands to flash Android 7 to eMMC and reboot your board:
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
  • Android 8: Run the following commands to flash Android 8 to eMMC and reboot your board:
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 di vendor vendor.img
sudo upgrade_tool di oem oem.img
sudo upgrade_tool RD

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.
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.

 sudo upgrade_tool EF MiniLoaderAll.bin

If it succeeds you will see a prompt showing "Erase flash ok."