Zero/install/eMMC Android9 - Revision history

RadxaYuntian at 02:01, 16 May 2022

2022-05-16T02:01:17Z

RadxaYuntian at 11:17, 1 December 2021

2021-12-01T11:17:14Z

Jack-ma: /* Step 1: Install pyamlboot tool */

2021-11-23T07:04:50Z

‎Step 1: Install pyamlboot tool

Sawyer at 03:07, 26 October 2021

2021-10-26T03:07:39Z

Sawyer at 03:07, 26 October 2021

2021-10-26T03:07:02Z

Sawyer at 03:05, 26 October 2021

2021-10-26T03:05:29Z

Sawyer at 02:50, 26 October 2021

2021-10-26T02:50:36Z

Sawyer at 02:48, 26 October 2021

2021-10-26T02:48:42Z

Sawyer at 07:37, 21 October 2021

2021-10-21T07:37:00Z

Sawyer: Created page with "{{Zero_header}} {{Languages|zero/install/eMMC_aml_tool}} Radxa Zero > Install > Install Android9 to eMMC ===..."

2021-10-21T07:27:14Z

Created page with "{{Zero_header}} {{Languages|zero/install/eMMC_aml_tool}} Radxa Zero > Install > Install Android9 to eMMC ===..."

New page

{{Zero_header}}

{{Languages|zero/install/eMMC_aml_tool}}

[[Zero | Radxa Zero]] > [[zero/install | Install]] > [[zero/install/eMMC_Android9 | Install Android9 to eMMC]]

=== How to install raw images to Radxa Zero eMMC ===

This guide describes how to install the raw images to Radxa Zero eMMC. Raw images is compared to amlupdate format image(which is a private image format). Raw images can be mount and open on host PCs. Most of the Linux images released are raw images. Currently Android images are released in amlupdate format but this may change in the future.

== Requirement ==

* Radxa Zero
* USB A to C cable
* A PC/laptop running Windows, Linux/macOS.

== Preparation ==
* Download and extract [https://dl.radxa.com/zero/images/android/ Android9 image]

After extract your will see file list like this:

$ ls
android-info.txt dtbo.img flash-all.sh product.img vbmeta.img
boot.img dt.img logo.img recovery.img vendor.img
bootloader.img flash-all.bat odm.img system.img

File bootloader.img will be needed to run Zero to fastboot mode.

== Windows ==

===== Step 1: Install drivers =====

Press and hold the USB boot button on the Zero, plug in the USB to PC.

Download [https://github.com/pbatard/libwdi/releases/download/b755/zadig-2.6.exe Zagdig], install it.
Confirm that the device is GX-CHIP, USB ID is 1B8E:C003 and choose '''libusb-win32''', then click ''Install Driver''.

[[File:Zagdig-libusb.png]]

Download the Android driver from Google:

[https://dl.google.com/android/repository/usb_driver_r13-windows.zip Click here to download the Google USB Driver ZIP file (ZIP)]

Unzip it and right click the '''.inf''' file to install the driver.

[[File:Install-win-android-driver.png]]

===== Step 2: Use RZ USB helper to run Zero to fastboot mode =====

RZ USB helper is a tool by Radxa for Windows users to manage Radxa Zero booting easier. Download it from [https://dl.radxa.com/zero/tools/windows/RZ_USB_Boot_Helper_V1.0.0.zip Radxa DL].

Press and hold the USB boot button on the Zero

[[File:Zero_usb_boot.jpg | 400px]]

plug in the USB to PC, '''Maskrom mode''' should be detected.

[[File:Rz-usb-helper-maskrom.png | 500px]]

Select the '''bootloader.img''' in the Android9 image and click '''Run'''.

[[File:Rz-usb-helper-fastboot.png | 500px]]

===== Step 3: Execute flash-all.bat to flash =====

Execute flash-all.bat in Android9 image to flash all partitions to emmc.<br>
If zero do not reboot automatically after finish, you should reconnect usb cable to reboot it.

== Linux ==
For Linux, we use amlogic boot tool to download the bootloader and boot the Zero into fastboot mode, then we can execute '''flash-all.sh''' to write all partitions to eMMC.

===== Step 1: Install pyamlboot tool =====

sudo apt install python3-pip
sudo pip3 install pyamlboot
===== Step 2: Install fastboot =====

Nexus Tools is an installer for the Android SDK Platform Tools package, which includes ADB, Fastboot, and other applications. We use Nexus Tools to install fastboot. If you already have fastboot installed, you can skip this step.

bash <(curl -s https://raw.githubusercontent.com/corbindavenport/nexus-tools/master/install.sh)

After it finishes,

which fastboot

should return you the install location.

===== Step 3: Boot into fastboot mode =====

Press and hold the USB boot button on Zero, plug in it to PC, '''lsusb''' should see the following:

Bus 001 Device 075: ID 1b8e:c003 Amlogic, Inc.

Download the fastboot loader and run it on Zero

boot-g12.py Android9_image/bootloader.img

It should output:
<pre>
Firmware Version :
ROM: 3.2 Stage: 0.0
Need Password: 0 Password OK: 1
Writing factory-loader.img at 0xfffa0000...
[DONE]
Running at 0xfffa0000...
[DONE]
AMLC dataSize=16384, offset=65536, seq=0...
[DONE]
AMLC dataSize=49152, offset=393216, seq=1...
[DONE]
AMLC dataSize=16384, offset=229376, seq=2...
[DONE]
AMLC dataSize=49152, offset=81920, seq=3...
[DONE]
AMLC dataSize=16384, offset=65536, seq=4...
[DONE]
AMLC dataSize=49152, offset=393216, seq=5...
[DONE]
AMLC dataSize=16384, offset=229376, seq=6...
[DONE]
AMLC dataSize=49152, offset=180224, seq=7...
[DONE]
AMLC dataSize=16384, offset=65536, seq=8...
[DONE]
AMLC dataSize=49152, offset=393216, seq=9...
[DONE]
AMLC dataSize=16384, offset=229376, seq=10...
[DONE]
AMLC dataSize=49152, offset=245760, seq=11...
[DONE]
AMLC dataSize=49152, offset=294912, seq=12...
[DONE]
AMLC dataSize=16384, offset=65536, seq=13...
[DONE]
AMLC dataSize=1207664, offset=81920, seq=14...
[DONE]
[BL2 END]
</pre>

Now lsusb should show the following device:

Bus 001 Device 076: ID 18d1:0d02 Google Inc. Celkon A88

===== Step 4: Write image to eMMC =====

run flash-all.sh to write all partitions images to emmc

$ ./flash-all.sh
error: no devices/emulators found
OKAY [ 0.040s]
Finished. Total time: 0.040s
OKAY [ 0.039s]
Finished. Total time: 0.039s
...
Finished. Total time: 0.038s
Rebooting OKAY [ 0.002s]
Finished. Total time: 0.454s

If zero do not reboot automatically, you should reconnect usb cable to reboot it.

== macOS (Apple Silicon/Intel) ==

For macOS, we use amlogic boot tool to download the bootloader and boot the Zero into the USB Disk mode to export the eMMC to mac as a USB Disk, then we can use dd or other tools to write images to the USB Disk(eMMC).

===== Step 1: Install pyamlboot tool =====

brew install python lsusb
pip3 install pyamlboot

===== Step 2: Install fastboot =====

Nexus Tools is an installer for the Android SDK Platform Tools package, which includes ADB, Fastboot, and other applications. We use Nexus Tools to install fastboot. If you already have fastboot installed, you can skip this step.

bash <(curl -s https://raw.githubusercontent.com/corbindavenport/nexus-tools/master/install.sh)

After it finishes,

which fastboot

should return you the install location.

===== Step 3: Boot into fastboot mode =====

Press and hold the USB boot button on Zero, plug in it to PC, '''lsusb''' should see the following:

Bus 002 Device 030: ID 1b8e:c003 Amlogic, Inc. GX-CHIP

Download the fastboot loader and run it on Zero

boot-g12.py Android9_image/bootloader.img

It should output:
<pre>
Firmware Version :
ROM: 3.2 Stage: 0.0
Need Password: 0 Password OK: 1
Writing rz-fastboot-loader.bin at 0xfffa0000...
[DONE]
Running at 0xfffa0000...
[DONE]
AMLC dataSize=16384, offset=65536, seq=0...
[DONE]
AMLC dataSize=49152, offset=393216, seq=1...
[DONE]
AMLC dataSize=16384, offset=229376, seq=2...
[DONE]
AMLC dataSize=49152, offset=245760, seq=3...
[DONE]
AMLC dataSize=49152, offset=294912, seq=4...
[DONE]
AMLC dataSize=16384, offset=65536, seq=5...
[DONE]
AMLC dataSize=1406320, offset=81920, seq=6...
[DONE]
[BL2 END]
</pre>

Now lsusb should show the following device:

Bus 002 Device 016: ID 18d1:0d02 Google Inc. USB download gadget Serial: 1234567890

The Zero is in fastboot mode now.

===== Step 4: Write image to eMMC =====

run flash-all.sh to write all partitions images to emmc

$ ./flash-all.sh
error: no devices/emulators found
OKAY [ 0.040s]
Finished. Total time: 0.040s
OKAY [ 0.039s]
Finished. Total time: 0.039s
...
Finished. Total time: 0.038s
Rebooting OKAY [ 0.002s]
Finished. Total time: 0.454s

If zero do not reboot automatically, you should reconnect usb cable to reboot it.

@@ Line 9: / Line 9: @@
 =<font color="#FF0000">STOP!</font>=
-This guide is quite messy with a lot of information duplicated from other guides. We have concentrated everything into [[Zero/install/eMMC | this new place]]. As such this page will no longer be maintained and could contain out-of-date info, and its content should not be followed anymore. This page is preserved for historical reference.
+This guide is quite messy with a lot of information duplicated from other guides. We have concentrated everything into [[Zero/install/eMMC_Android | this new place]]. As such this page will no longer be maintained and could contain out-of-date info, and its content should not be followed anymore. This page is preserved for historical reference.
 __TOC__

@@ Line 248: / Line 248: @@
 == FAQ ==
-. How to erase Android?<br>
+===1. How to erase Android?===
 A: <br>
 * To erase partitions
@@ Line 254: / Line 254: @@
 * [https://wiki.radxa.com/Zero/install/eMMC_Android9 To erase emmc u-boot]
 <br>
-. Why is there no fastboot device?<br>
+=== 2. Why is there no fastboot device? ===
 A: If the board not able to run into fastboot, please try: <br>
 * If you can boot to android, try "adb reboot fastboot" or (uart console) "reboot fastboot"
 * If you can visit u-boot console, execute command "fastboot"

@@ Line 247: / Line 247: @@
-==== FAQ ====
+== FAQ ==
 . How to erase Android?<br>
 A: <br>

← Older revision		Revision as of 03:05, 26 October 2021
Line 245:		Line 245:

	If zero do not reboot automatically, you should reconnect usb cable to reboot it.		If zero do not reboot automatically, you should reconnect usb cable to reboot it.
		+
		+
		+	==== FAQ ====
		+	1. How to erase Android?<br>
		+	A: <br>
		+	* To erase partitions
		+	<pre>dd if=/dev/zero of=/dev/<emmc device> bs=1M count=500</pre>
		+	* [https://wiki.radxa.com/Zero/install/eMMC_Android9 To erase emmc u-boot]
		+	<br>
		+	2. Why is there no fastboot device?<br>
		+	A: If the board not able to run into fastboot, please try: <br>
		+	* If you can boot to android, try "adb reboot fastboot" or (uart console) "reboot fastboot"
		+	* If you can visit u-boot console, execute command "fastboot"

@@ Line 1: / Line 1: @@
 {{Zero_header}}
-{{Languages|zero/install/eMMC_aml_tool}}
+{{Languages|zero/install/eMMC_Android9}}
-  [[Zero | Radxa Zero]] > [[zero/install | Install]] > [[zero/install/eMMC_Android9 | Install Android9 to eMMC]]
+  [[Zero | Radxa Zero]] > [[zero/install | Install]] > [[zero/install/eMMC_Android9 | Install Android9 to eMMC '''(deprecated)''']]
 === How to install raw images to Radxa Zero eMMC ===

@@ Line 172: / Line 172: @@
 ===== Step 1: Install pyamlboot tool =====
-     brew install python lsusb
+     brew install python lsusb libusb
      pip3 install pyamlboot

@@ Line 82: / Line 82: @@
 Nexus Tools is an installer for the Android SDK Platform Tools package, which includes ADB, Fastboot, and other applications. We use Nexus Tools to install fastboot. If you already have fastboot installed, you can skip this step.
+<pre>
      bash <(curl -s https://raw.githubusercontent.com/corbindavenport/nexus-tools/master/install.sh)
 After it finishes,
@@ Line 177: / Line 178: @@
 Nexus Tools is an installer for the Android SDK Platform Tools package, which includes ADB, Fastboot, and other applications. We use Nexus Tools to install fastboot. If you already have fastboot installed, you can skip this step.
+<pre>
      bash <(curl -s https://raw.githubusercontent.com/corbindavenport/nexus-tools/master/install.sh)
+</pre>
 After it finishes,

@@ Line 18: / Line 18: @@
 * Download and extract [https://dl.radxa.com/zero/images/android/ Android9 image]
-After extract your will see file list like this:
+After extract your will see files list like this:
      $ ls

@@ Line 46: / Line 46: @@
 [[File:Install-win-android-driver.png]]
-===== Step 2: Use RZ USB helper to run Zero to fastboot mode =====
+===== Step 2: Install fastboot =====
 RZ USB helper is a tool by Radxa for Windows users to manage Radxa Zero booting easier. Download it from [https://dl.radxa.com/zero/tools/windows/RZ_USB_Boot_Helper_V1.0.0.zip Radxa DL].
@@ Line 62: / Line 67: @@
 [[File:Rz-usb-helper-fastboot.png | 500px]]
-===== Step 3: Execute flash-all.bat to flash =====
+===== Step 4: Execute flash-all.bat to flash =====
 Execute flash-all.bat in Android9 image to flash all partitions to emmc.<br>