101 lines
No EOL
2.1 KiB
Markdown
101 lines
No EOL
2.1 KiB
Markdown
# Flashing Ubuntu Touch on BraX3
|
||
|
||
Follow these steps carefully to flash Ubuntu Touch images onto your BraX3 device.
|
||
|
||
---
|
||
|
||
## Prerequisites
|
||
|
||
- **ADB** and **Fastboot** tools must be installed on your computer.
|
||
- Device must have **LunarOS** installed.
|
||
- **USB Debugging** enabled (Settings → Developer Options → USB Debugging).
|
||
- **Unlock the Bootloader**.
|
||
> Follow the official guide
|
||
here: [How to Unlock the Bootloader of Your BraX3](https://community.braxtech.net/t/how-to-unlock-the-bootloader-of-your-brax3/45).
|
||
|
||
---
|
||
|
||
## Flashing Steps
|
||
|
||
1. Connect your device and verify it is detected:
|
||
```bash
|
||
adb devices
|
||
```
|
||
|
||
2. Reboot into fastboot mode:
|
||
|
||
```bash
|
||
adb reboot fastboot
|
||
```
|
||
|
||
3. Set Device Slot to **slot a**:
|
||
```bash
|
||
fastboot --set-active=a
|
||
```
|
||
|
||
4. Flash the **system image**:
|
||
|
||
```bash
|
||
fastboot flash system ubuntu.img
|
||
```
|
||
|
||
5. Reboot bootloader:
|
||
|
||
```bash
|
||
fastboot reboot bootloader
|
||
```
|
||
|
||
6. Flash the **boot partitions**:
|
||
|
||
```bash
|
||
fastboot flash boot_a boot.img
|
||
fastboot flash boot_b boot.img
|
||
```
|
||
|
||
7. Flash the **init_boot partitions**:
|
||
|
||
```bash
|
||
fastboot flash init_boot_a init_boot.img
|
||
fastboot flash init_boot_b init_boot.img
|
||
```
|
||
|
||
8. Wipe and format userdata for Ubuntu Touch:
|
||
|
||
```bash
|
||
fastboot -w
|
||
fastboot format:ext4 userdata
|
||
```
|
||
9. Reboot the device:
|
||
|
||
```bash
|
||
fastboot reboot
|
||
```
|
||
|
||
> Just make sure your fastboot/adb version is >= 35.0.2-12147458s.
|
||
> First Ubuntu Touch boot may take 5–8 minutes.
|
||
|
||
---
|
||
|
||
## Troubleshooting
|
||
|
||
* **Device not detected by `adb` or `fastboot`**:
|
||
|
||
* Check your USB cable and port.
|
||
* Install proper USB drivers if on Windows.
|
||
* Make sure USB Debugging is enabled in Developer Options.
|
||
|
||
* **Bootloop after flashing**:
|
||
|
||
* Recheck that you flashed all images in the correct order.
|
||
* Confirm that you used the **latest platform tools**.
|
||
|
||
* **Still stuck?**
|
||
Contact us or ask your question on the [BraxTech Community Forum](https://community.braxtech.net/).
|
||
|
||
---
|
||
|
||
## Completion
|
||
|
||
After the process is complete, reboot your device. Ubuntu Touch should now be installed on your BraX3. 🎉
|
||
|
||
``` |