Please enable javascript, or click here to visit my ecommerce web site powered by Shopify.
Jump to: navigation, search

Difference between revisions of "Zero/install/eMMC"

< Zero‎ | install
(Windows)
Line 10: Line 10:
  
 
* Radxa Zero
 
* Radxa Zero
* USB A to C cable
+
* A PC/laptop running Windows, Linux, or macOS
* A PC/laptop running Windows, Linux/macOS.
+
* USB A to C cable or C to C cable, depending on your host
  
 
== Windows ==
 
== Windows ==
  
===== Step 1: Install drivers =====
+
===== Step 1: Wipe eMMC =====
  
Press and hold the USB boot button on the Zero, plug in the USB to PC.
+
Please follow [[Zero/install/eMMC_erase#Windows | this guide]] to wipe eMMC. Do not close RZ USB Boot Helper when you finish.
  
Download [https://github.com/pbatard/libwdi/releases/download/b755/zadig-2.6.exe Zagdig], install it.
+
===== Step 2: Download rz-udisk-loader =====
Confirm that the device is GX-CHIP, USB ID is 1B8E:C003 and choose '''libusb-win32''', then click ''Install Driver''.
+
  
[[File:Zagdig-libusb.png]]
+
Now download the [https://dl.radxa.com/zero/images/loader/rz-udisk-loader.bin RZ USB disk loader], select <code>rz-udisk-loader.bin</code> in RZ USB Boot Helper, and click '''Run'''.
  
Download the Android driver from Google:
+
Your computer should detect a new storage device after the code is loaded.
 
+
[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 erase eMMC and boot to USB disk 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 loader in the RZ_USB_Boot_Helper zip and click '''Run'''.
+
 
+
[[File:Rz-usb-helper-fastboot.png | 500px]]
+
 
+
Click '''Erase''' to erase the eMMC completely.
+
 
+
[[File:Rz-usb-helper-erase.png | 500px]]
+
 
+
Now download the [https://dl.radxa.com/zero/images/loader/rz-udisk-loader.bin RZ USB disk loader], select the RZ USB disk loader and click '''Run'''.
+
  
 
===== Step 3: Use Etcher to write images to eMMC =====
 
===== Step 3: Use Etcher to write images to eMMC =====
  
Download the [https://github.com/balena-io/etcher/releases/download/v1.5.122/balenaEtcher-Setup-1.5.122.exe latest Etcher and install it].
+
You can now flash your image using balenaEtcher similar to [[Zero/getting_started#Write_Image | flash microSD card]]. Except you don't have to insert a card this time. Choose the new device detected in step 2 and flash as normal.
 
+
== Linux ==
+
For Linux, we use amlogic boot tool to download the bootloader and boot the Zero into the USB Disk mode to export the eMMC to host PC 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 =====
+
 
+
    sudo apt install python3-pip
+
    sudo pip3 install pyamlboot
+
 
+
===== Step 2: Erase Android if installed(optional) =====
+
  
If you have Android installed on Zero before, we suggest to wipe it. Check [[zero/install/eMMC_erase#Linux |Erase eMMC]] page. If you have installed Linux or other distribution already, you can skip this step.
+
== Linux & macOS ==
 +
For Linux and macOS, we use amlogic boot tool to download the bootloader and boot the Zero into the USB Disk mode. This is to expose the eMMC to host PC as a USB Disk. Then we can use dd or other tools to write images to the USB Disk(eMMC).
  
===== Step 3: Boot into USB Disk mode =====
+
===== Step 1: Wipe eMMC =====
  
Press and hold the USB boot button on Zero, plug in it to PC, lsusb should see the following:
+
Please follow [[https://wiki.radxa.com/Zero/install/eMMC_erase#Linux_.26_macOS | this guide]] to wipe eMMC. This will result in Radxa Zero booting into maskrom mode.
  
    Bus 001 Device 081: ID 1b8e:c003 Amlogic, Inc.
+
===== Step 2: Boot into USB Disk mode =====
  
 
Download the USB disk loader and run it on Zero
 
Download the USB disk loader and run it on Zero
Line 109: Line 71:
 
Now lsusb should show the following device:
 
Now lsusb should show the following device:
  
     Bus 001 Device 082: ID 1b8e:2200 Amlogic, Inc.
+
     Bus 001 Device 082: ID 1b8e:2200 Amlogic, Inc. USB download gadget  Serial: AMLG12A-RADXA-ZERO
  
The Zero is in USB disk mode now, your PC should popup a new USB drive.
+
The Zero is in USB disk mode now, your computer should popup a new USB drive. On macOS you will get a disk not readable popup. Just click Ignore:
  
 +
[[File:Rz-udisk-mac-popup.jpg]]
 +
 +
On Linux you will get following output from <code>sudo dmesg</code>:
 
<pre>
 
<pre>
 
[74292.229573] usb 1-10.2.3: new high-speed USB device number 84 using xhci_hcd
 
[74292.229573] usb 1-10.2.3: new high-speed USB device number 84 using xhci_hcd
Line 140: Line 105:
 
</pre>
 
</pre>
  
===== Step 4: Write image to eMMC =====
+
===== Step 3: Write image to eMMC =====
 
+
You can use dd to write the Linux image to the eMMC on Zero now.
+
 
+
    sudo dd if=/path/to/image of=/dev/sdx bs=1M
+
    sync
+
 
+
Carefully Eject the Zero USB drive and unplug and plug the power, Zero should boot the new image now.
+
 
+
== 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: Erase Android if installed(optional) =====
+
 
+
If you have Android installed on Zero before, we suggest to wipe it. Check [[zero/install/eMMC_erase#macOS_.28Apple_Silicon.2FIntel.29 |Erase eMMC]] page. If you have installed Linux or other distribution already, you can skip this step.
+
 
+
===== Step 3: Boot into USB Disk mode =====
+
 
+
Press and hold the USB boot button on Zero, plug in it to mac, '''lsusb''' should see the following:
+
 
+
    Bus 002 Device 030: ID 1b8e:c003 Amlogic, Inc. GX-CHIP
+
 
+
Download the USB disk loader and run it on Zero
+
 
+
    wget https://dl.radxa.com/zero/images/loader/rz-udisk-loader.bin
+
    boot-g12.py rz-udisk-loader.bin
+
 
+
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 013: ID 1b8e:2200 Amlogic, Inc. USB download gadget  Serial: AMLG12A-RADXA-ZERO
+
 
+
The Zero is in USB disk mode now, your mac should popup a new USB drive. Just click Ignore.
+
 
+
[[File:Rz-udisk-mac-popup.jpg]]
+
 
+
===== Step 4: Write image to eMMC =====
+
  
You can use dd to write the raw image to the eMMC of Zero now.
+
You can use dd to write the raw image to the eMMC on Zero now.
  
     sudo dd if=/path/to/image of=/dev/rdiskx bs=1m
+
     sudo dd if=/path/to/image of=/dev/new_dev bs=1M
 
     sync
 
     sync
  
 
Carefully Eject the Zero USB drive and unplug and plug the power, Zero should boot the new image now.
 
Carefully Eject the Zero USB drive and unplug and plug the power, Zero should boot the new image now.

Revision as of 10:46, 1 December 2021

    Radxa Zero >  Installation >  Install image 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
  • A PC/laptop running Windows, Linux, or macOS
  • USB A to C cable or C to C cable, depending on your host

Windows

Step 1: Wipe eMMC

Please follow this guide to wipe eMMC. Do not close RZ USB Boot Helper when you finish.

Step 2: Download rz-udisk-loader

Now download the RZ USB disk loader, select rz-udisk-loader.bin in RZ USB Boot Helper, and click Run.

Your computer should detect a new storage device after the code is loaded.

Step 3: Use Etcher to write images to eMMC

You can now flash your image using balenaEtcher similar to flash microSD card. Except you don't have to insert a card this time. Choose the new device detected in step 2 and flash as normal.

Linux & macOS

For Linux and macOS, we use amlogic boot tool to download the bootloader and boot the Zero into the USB Disk mode. This is to expose the eMMC to host PC as a USB Disk. Then we can use dd or other tools to write images to the USB Disk(eMMC).

Step 1: Wipe eMMC

Please follow [| this guide] to wipe eMMC. This will result in Radxa Zero booting into maskrom mode.

Step 2: Boot into USB Disk mode

Download the USB disk loader and run it on Zero

   wget https://dl.radxa.com/zero/images/loader/rz-udisk-loader.bin
   boot-g12.py rz-udisk-loader.bin

It should output:

Firmware Version :
ROM: 3.2 Stage: 0.0
Need Password: 0 Password OK: 1
Writing rz-udisk-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]

Now lsusb should show the following device:

   Bus 001 Device 082: ID 1b8e:2200 Amlogic, Inc. USB download gadget  Serial: AMLG12A-RADXA-ZERO

The Zero is in USB disk mode now, your computer should popup a new USB drive. On macOS you will get a disk not readable popup. Just click Ignore:

Rz-udisk-mac-popup.jpg

On Linux you will get following output from sudo dmesg:

[74292.229573] usb 1-10.2.3: new high-speed USB device number 84 using xhci_hcd
[74292.330483] usb 1-10.2.3: New USB device found, idVendor=1b8e, idProduct=c003, bcdDevice= 0.20
[74292.330487] usb 1-10.2.3: New USB device strings: Mfr=1, Product=2, SerialNumber=0
[74292.330488] usb 1-10.2.3: Product: GX-CHIP
[74292.330489] usb 1-10.2.3: Manufacturer: Amlogic
[74303.432510] usb 1-10.2.3: USB disconnect, device number 84
[74303.665204] usb 1-10.2.3: new high-speed USB device number 85 using xhci_hcd
[74303.769674] usb 1-10.2.3: New USB device found, idVendor=1b8e, idProduct=2200, bcdDevice=99.99
[74303.769678] usb 1-10.2.3: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[74303.769679] usb 1-10.2.3: Product: USB download gadget
[74303.769680] usb 1-10.2.3: Manufacturer: Radxa
[74303.769681] usb 1-10.2.3: SerialNumber: AMLG12A-RADXA-ZERO
[74303.771008] usb-storage 1-10.2.3:1.0: USB Mass Storage device detected
[74303.771133] scsi host4: usb-storage 1-10.2.3:1.0
[74304.785353] scsi 4:0:0:0: Direct-Access     Linux    Radxa Zero UDisk  0ff PQ: 0 ANSI: 2
[74304.785506] sd 4:0:0:0: Attached scsi generic sg2 type 0
[74304.785679] sd 4:0:0:0: [sdc] 60749504 512-byte logical blocks: (31.1 GB/29.0 GiB)
[74304.785796] sd 4:0:0:0: [sdc] Write Protect is off
[74304.785798] sd 4:0:0:0: [sdc] Mode Sense: 0f 00 00 00
[74304.785916] sd 4:0:0:0: [sdc] Write cache: enabled, read cache: enabled, doesn't support DPO or FUA
[74304.833523]  sdc: sdc1
[74304.861751] sd 4:0:0:0: [sdc] Attached SCSI removable disk
[74305.424709] EXT4-fs (sdc1): recovery complete
[74305.425517] EXT4-fs (sdc1): mounted filesystem with writeback data mode. Opts: (null). Quota mode: none.
Step 3: Write image to eMMC

You can use dd to write the raw image to the eMMC on Zero now.

   sudo dd if=/path/to/image of=/dev/new_dev bs=1M
   sync

Carefully Eject the Zero USB drive and unplug and plug the power, Zero should boot the new image now.