Initial commit: build env for the Ubtouch OS

Change-Id: I4bf8c32811d2785bd86a532f4cb435794f5c14d2
2025-10-08 16:49:47 +03:00 · 2025-10-08 16:49:47 +03:00 · efb4feb07b
commit efb4feb07b
9 changed files with 740 additions and 0 deletions
--- a/HOW_TO_FLASH.md
+++ b/HOW_TO_FLASH.md
@ -0,0 +1,101 @@
+# 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. 🎉
+
+```