From 3fa4a5919358c1e462075f048b8eb6361ec01deb Mon Sep 17 00:00:00 2001 From: quatrixone Date: Sat, 7 Nov 2026 23:05:01 +0100 Subject: [PATCH 1/6] CONTRIBUTING: add Dipper single-slot recovery entry Name the sole boot partition the installer may write and the physical fastboot button path, as required before any single-slot port is flashed. --- CONTRIBUTING.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 43d63d13d..f5aa086a7 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -66,6 +66,10 @@ Every rule here exists because breaking it either bricks a phone or loses data n Keeping stock on slot A is how we avoid bricking phones during development, not a requirement for every phone. A phone with a single set of boot partitions (no `_a`/`_b` names) can become a supported device. With no second slot, a failed boot can't fall back to stock, so these rules replace the slot B rules above for that phone: +| Device | Boot partition the installer may write | Fastboot by buttons | +| --- | --- | --- | +| Xiaomi Mi 8 (`dipper`) | `boot` | Power off, then hold Volume Down + Power until FASTBOOT appears. | + - **The device's entry comes first.** Before any flash, the port adds its phone here: the codename, the boot partitions the installer writes (normally `boot` alone, plus `dtbo` or `vendor_boot` where the phone needs them), and how to reach fastboot or the vendor's download mode by the buttons. A device PR never writes its own exception into AGENTS.md or this file. - **We write only the boot partitions the entry names, and `userdata`.** Through `bin/omamobile flash`/`push` and `tools/install-phone`, with the serial pinned, the codename typed, the allowlist checked and a dry run first. No tool may write a partition named on its command line, and nothing is written from a rooted stock Android, where the storage guard doesn't run. - **A full read-only backup before the first flash,** of every partition except `userdata` and `super`, checked against checksums taken on the phone, stored outside the repository (§3.3). It includes stock's boot partitions, which are the way back: the device's notes say how to write them back by the buttons, step by step, and the owner reads that before the first flash. From a5cd983e7df58791eb2e210a8cc07da1d7631151 Mon Sep 17 00:00:00 2001 From: quatrixone Date: Sun, 8 Nov 2026 09:14:17 +0100 Subject: [PATCH 2/6] CONTRIBUTING: group single-slot recovery entries --- CONTRIBUTING.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index f5aa086a7..d245d495b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -66,10 +66,6 @@ Every rule here exists because breaking it either bricks a phone or loses data n Keeping stock on slot A is how we avoid bricking phones during development, not a requirement for every phone. A phone with a single set of boot partitions (no `_a`/`_b` names) can become a supported device. With no second slot, a failed boot can't fall back to stock, so these rules replace the slot B rules above for that phone: -| Device | Boot partition the installer may write | Fastboot by buttons | -| --- | --- | --- | -| Xiaomi Mi 8 (`dipper`) | `boot` | Power off, then hold Volume Down + Power until FASTBOOT appears. | - - **The device's entry comes first.** Before any flash, the port adds its phone here: the codename, the boot partitions the installer writes (normally `boot` alone, plus `dtbo` or `vendor_boot` where the phone needs them), and how to reach fastboot or the vendor's download mode by the buttons. A device PR never writes its own exception into AGENTS.md or this file. - **We write only the boot partitions the entry names, and `userdata`.** Through `bin/omamobile flash`/`push` and `tools/install-phone`, with the serial pinned, the codename typed, the allowlist checked and a dry run first. No tool may write a partition named on its command line, and nothing is written from a rooted stock Android, where the storage guard doesn't run. - **A full read-only backup before the first flash,** of every partition except `userdata` and `super`, checked against checksums taken on the phone, stored outside the repository (§3.3). It includes stock's boot partitions, which are the way back: the device's notes say how to write them back by the buttons, step by step, and the owner reads that before the first flash. @@ -77,6 +73,12 @@ Keeping stock on slot A is how we avoid bricking phones during development, not - **The initramfs's no-USB-host panic needs a review for the phone.** On an A/B phone it hands over to stock on slot A; on a single-slot phone it would restart into the same image. The device's descriptor and plan say what happens instead (stay up with the screen lit, or reboot into fastboot) before the first boot. - **Everything else in this section still applies:** never relock with a non-stock image, never flash an older factory image, the backup rules, the hang safety nets. +Phones with an entry: + +| Device | Boot partition the installer may write | Fastboot by buttons | +| --- | --- | --- | +| Xiaomi Mi 8 (`dipper`) | `boot` | Power off, then hold Volume Down + Power until FASTBOOT appears. | + ### 3.2 The read-only storage guard UFS holds the per-device calibration. The initramfs ([`initramfs/init`](initramfs/init)) guards it before anything else runs: From c3ceeeccc36bcd4f87839d2efad4d1431b29c1a2 Mon Sep 17 00:00:00 2001 From: quatrixone Date: Mon, 9 Nov 2026 16:38:07 +0100 Subject: [PATCH 3/6] CONTRIBUTING: record Dipper forced restart --- CONTRIBUTING.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d245d495b..c226eb300 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -75,9 +75,9 @@ Keeping stock on slot A is how we avoid bricking phones during development, not Phones with an entry: -| Device | Boot partition the installer may write | Fastboot by buttons | -| --- | --- | --- | -| Xiaomi Mi 8 (`dipper`) | `boot` | Power off, then hold Volume Down + Power until FASTBOOT appears. | +| Device | Boot partition the installer may write | Fastboot by buttons | Forced restart | +| --- | --- | --- | --- | +| Xiaomi Mi 8 (`dipper`) | `boot` only; stock `dtbo` stays untouched | Power off, then hold Volume Down + Power until FASTBOOT appears. | Hold Power alone for more than 10 seconds; observed to restart this handset on 2026-11-09. | ### 3.2 The read-only storage guard From 5c3aecb2b250466c22e44b27270ed5b522a89595 Mon Sep 17 00:00:00 2001 From: quatrixone Date: Mon, 9 Nov 2026 19:50:29 +0100 Subject: [PATCH 4/6] CONTRIBUTING: identify Dipper restart test context --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c226eb300..5b7e1641b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -77,7 +77,7 @@ Phones with an entry: | Device | Boot partition the installer may write | Fastboot by buttons | Forced restart | | --- | --- | --- | --- | -| Xiaomi Mi 8 (`dipper`) | `boot` only; stock `dtbo` stays untouched | Power off, then hold Volume Down + Power until FASTBOOT appears. | Hold Power alone for more than 10 seconds; observed to restart this handset on 2026-11-09. | +| Xiaomi Mi 8 (`dipper`) | `boot` only; stock `dtbo` stays untouched | Power off, then hold Volume Down + Power until FASTBOOT appears. | Hold Power alone for more than 10 seconds; observed from installed Android on 2026-11-09. | ### 3.2 The read-only storage guard From 7e231d9d41d357c81c88a58ddb1fc504bf42c6d1 Mon Sep 17 00:00:00 2001 From: quatrixone Date: Mon, 9 Nov 2026 22:05:16 +0100 Subject: [PATCH 5/6] CONTRIBUTING: record Dipper power-hold outcome --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 5b7e1641b..3a55c2d3b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -77,7 +77,7 @@ Phones with an entry: | Device | Boot partition the installer may write | Fastboot by buttons | Forced restart | | --- | --- | --- | --- | -| Xiaomi Mi 8 (`dipper`) | `boot` only; stock `dtbo` stays untouched | Power off, then hold Volume Down + Power until FASTBOOT appears. | Hold Power alone for more than 10 seconds; observed from installed Android on 2026-11-09. | +| Xiaomi Mi 8 (`dipper`) | `boot` only; stock `dtbo` stays untouched | Power off, then hold Volume Down + Power until FASTBOOT appears. | Hold Power alone for more than 10 seconds; observed to restart into Android from installed Android on 2026-11-09. Not yet tested under our RAM kernel. | ### 3.2 The read-only storage guard From c08fc611d0256425d1f11550ad4d857ab083b99e Mon Sep 17 00:00:00 2001 From: quatrixone Date: Mon, 9 Nov 2026 22:46:19 +0100 Subject: [PATCH 6/6] CONTRIBUTING: confirm Dipper restart under RAM kernel --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 3a55c2d3b..c41462101 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -77,7 +77,7 @@ Phones with an entry: | Device | Boot partition the installer may write | Fastboot by buttons | Forced restart | | --- | --- | --- | --- | -| Xiaomi Mi 8 (`dipper`) | `boot` only; stock `dtbo` stays untouched | Power off, then hold Volume Down + Power until FASTBOOT appears. | Hold Power alone for more than 10 seconds; observed to restart into Android from installed Android on 2026-11-09. Not yet tested under our RAM kernel. | +| Xiaomi Mi 8 (`dipper`) | `boot` only; stock `dtbo` stays untouched | Power off, then hold Volume Down + Power until FASTBOOT appears. | Hold Power alone for 10 seconds; confirmed to restart into Android under the Omarchy Mobile kernel. | ### 3.2 The read-only storage guard