Zero/dev/maskrom - Revision history

Rauxon: /* Enable maskrom */

2022-11-26T21:03:51Z

‎Enable maskrom

RadxaYuntian: /* Enable maskrom */

2022-04-19T06:26:18Z

‎Enable maskrom

RadxaYuntian at 04:12, 21 February 2022

2022-02-21T04:12:01Z

RadxaYuntian at 04:10, 21 February 2022

2022-02-21T04:10:49Z

RadxaYuntian: /* Windows */

2022-02-15T02:18:06Z

‎Windows

RadxaYuntian: /* Side loading binaries */

2022-02-07T01:38:08Z

‎Side loading binaries

RadxaYuntian: /* Side loading binaries */

2022-02-07T01:37:16Z

‎Side loading binaries

RadxaYuntian at 03:10, 26 January 2022

2022-01-26T03:10:33Z

RadxaYuntian at 03:09, 26 January 2022

2022-01-26T03:09:19Z

RadxaYuntian at 09:12, 17 January 2022

2022-01-17T09:12:52Z

@@ Line 25: / Line 25: @@
 On Windows, you can open Device Manager and find the device:
-PENDING PICTURE
+[[File:Windows-GX-CHIP.png]]
 On Linux, you can run <code>lsusb</code> to confirm the device is indeed in maskrom mode:

@@ Line 21: / Line 21: @@
 [[File:Zero_usb_boot.jpg | 300px]]
-Hold the button while plug Zero into your computer. You can let go the button when you see power LED is on.
+Hold this button, then plug Zero into your computer. You can let go the button when you see power LED is on.
 On Windows, you can open Device Manager and find the device:

@@ Line 39: / Line 39: @@
 [[File:Zagdig-libusb.png]]
-You can also [https://dl.google.com/android/repository/usb_driver_r13-windows.zip download the Android driver] from Google.
+Additionally you can install '''fastboot with '''nexus-tools''' by running the following command in PowerShell:
-Unzip it and right click the '''.inf''' file to install the driver.
+ iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/corbindavenport/nexus-tools/master/install.ps1'))
-[[File:Install-win-android-driver.png]]
+You will also need [https://dl.google.com/android/repository/usb_driver_r13-windows.zip the Android driver] from Google.
-Additionally you can install '''fastboot with '''nexus-tools''' by running the following command in PowerShell:
+Unzip it and right click the '''.inf''' file to install the driver.
- iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/corbindavenport/nexus-tools/master/install.ps1'))
+[[File:Install-win-android-driver.png]]
 '''fastboot''' is for installing Android, or manually clear eMMC bootloader. If you do not need those you can skip this step.

@@ Line 45: / Line 45: @@
 [[File:Install-win-android-driver.png]]
-Additionally you can install adb and fastboot tools with '''nexus-tools''' by running the following command in PowerShell:
+Additionally you can install '''fastboot with '''nexus-tools''' by running the following command in PowerShell:
   iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/corbindavenport/nexus-tools/master/install.ps1'))
 RZ USB Boot Helper is a Windows tool made by Radxa for maskrom sideloading. Download it from [https://dl.radxa.com/zero/tools/windows/RZ_USB_Boot_Helper_V1.0.0.zip Radxa DL] and unzip everything to a convenient location.
@@ Line 68: / Line 70: @@
   sudo pip3 install pyamlboot
-Additionally you can install adb and fastboot tools with '''nexus-tools''':
+Additionally you can install '''fastboot''' with '''nexus-tools''':
   bash <(curl -s https://raw.githubusercontent.com/corbindavenport/nexus-tools/master/install.sh)
 === Side loading binaries ===

@@ Line 45: / Line 45: @@
 [[File:Install-win-android-driver.png]]
-Additionally you can install adb and fastboot tools with '''nexus-tools''':
+Additionally you can install adb and fastboot tools with '''nexus-tools''' by running the following command in PowerShell:
   iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/corbindavenport/nexus-tools/master/install.ps1'))

@@ Line 89: / Line 89: @@
 * [https://dl.radxa.com/zero/images/loader/factory-loader.img factory-loader.img]: used to erase eMMC on Windows. Not recommended.
-* [https://dl.radxa.com/zero/images/loader/radxa-zero-erase-emmc.bin radxa-zero-erase-emmc.bin]: erase eMMC, then present eMMC as a USB storage device. This is the recommended way to load a new Linux image.
+* [https://dl.radxa.com/zero/images/loader/radxa-zero-erase-emmc.bin radxa-zero-erase-emmc.bin]: automatically erase eMMC, then present eMMC as a USB storage device. This is the recommended way to load a new Linux image.
 * [https://dl.radxa.com/zero/images/loader/rz-fastboot-loader.bin rz-fastboot-loader.bin]: enable fastboot mode. This cannot be used to install our official Android.
 * [https://dl.radxa.com/zero/images/loader/android-bootloader.img android-bootloader.img]: this is the same <b>bootloader.img</b> from our official Android image. Some distro uses this bootloader.

@@ Line 89: / Line 89: @@
 * [https://dl.radxa.com/zero/images/loader/factory-loader.img factory-loader.img]: used to erase eMMC on Windows. Not recommended.
-* [https://dl.radxa.com/zero/images/loader/radxa-zero-erase-emmc.bin radxa-zero-erase-emmc.bin]: erase eMMC.
+* [https://dl.radxa.com/zero/images/loader/radxa-zero-erase-emmc.bin radxa-zero-erase-emmc.bin]: erase eMMC, then present eMMC as a USB storage device. This is the recommended way to load a new Linux image.
 * [https://dl.radxa.com/zero/images/loader/rz-fastboot-loader.bin rz-fastboot-loader.bin]: enable fastboot mode. This cannot be used to install our official Android.
-* [https://dl.radxa.com/zero/images/loader/android-bootloader.img android-bootloader.img]: this is the same <b>bootloader.img</b> from our official Android image. When sideloaded it will boot the device in fastboot mode, with support for eMMC boot partition.
+* [https://dl.radxa.com/zero/images/loader/android-bootloader.img android-bootloader.img]: this is the same <b>bootloader.img</b> from our official Android image. Some distro uses this bootloader.
 * [https://dl.radxa.com/zero/images/loader/rz-udisk-loader.bin rz-udisk-loader.bin]: expose embedded eMMC as a USB Mass Storage device.
-* [https://dl.radxa.com/zero/images/loader/u-boot.bin u-boot.bin]: U-Boot bootloader. Useful when you have a corrupted boot loader.
+* [https://dl.radxa.com/zero/images/loader/u-boot.bin u-boot.bin]: mainline U-Boot bootloader for USB boot. Won't work if you flashed it to eMMC/microSD.
 Once Radxa Zero enters into maskrom mode, it will reboot into maskrom mode until the power is cut. As such, it is recommended to completely shut down, unplug, and replug Radxa Zero when you are finish with the maintenance task.

@@ Line 102: / Line 102: @@
 * A: Please make sure your USB driver is installed and Zero is in maskrom mode. You should see the following device in your Device Manager:
-[[File:libusb.png | 500px]]
+[[File:libusb.png]]
 * Q: RZ USB Boot Helper's Erase button is disabled.
 * A: You can use [https://dl.radxa.com/zero/images/loader/radxa-zero-erase-emmc.bin radxa-zero-erase-emmc.bin] to erase eMMC. It will wipe the device once you click "Run" button.

← Older revision		Revision as of 03:09, 26 January 2022
Line 96:		Line 96:

	Once Radxa Zero enters into maskrom mode, it will reboot into maskrom mode until the power is cut. As such, it is recommended to completely shut down, unplug, and replug Radxa Zero when you are finish with the maintenance task.		Once Radxa Zero enters into maskrom mode, it will reboot into maskrom mode until the power is cut. As such, it is recommended to completely shut down, unplug, and replug Radxa Zero when you are finish with the maintenance task.
		+
		+	=== Troubleshooting ===
		+
		+	* Q: RZ USB Boot Helper says "Not detected".
		+	* A: Please make sure your USB driver is installed and Zero is in maskrom mode. You should see the following device in your Device Manager:
		+
		+	[[File:libusb.png \| 500px]]
		+
		+	* Q: RZ USB Boot Helper's Erase button is disabled.
		+	* A: You can use [https://dl.radxa.com/zero/images/loader/radxa-zero-erase-emmc.bin radxa-zero-erase-emmc.bin] to erase eMMC. It will wipe the device once you click "Run" button.