From 64e54850f3b7e942668af15779012e578f6ebcb9 Mon Sep 17 00:00:00 2001
From: Timm <git@openwill.de>
Date: Tue, 12 Mar 2024 14:41:37 +0000
Subject: [PATCH] =?UTF-8?q?Dokumentation=20vervollst=C3=A4ndigt=20bis=20Re?=
 =?UTF-8?q?covery=20flashing=20und=20alle=20Referenzen=20setzen?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 85 +++++++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 70 insertions(+), 15 deletions(-)

diff --git a/README.md b/README.md
index 0c81b8c..c4a4356 100644
--- a/README.md
+++ b/README.md
@@ -4,9 +4,9 @@
 > Allgemeine Übersicht
 
 1. fastboot/adb an den Start bringen
-2. Geräteverbindung checken
-3. TWPR, Magisk, ROM laden
-4. TWPR recovery flashen (via fastboot Menü, Tastenkombination)
+2. Geräteverbindung checken (ggf. Bootloader entsperren)
+3. Recovery, Magisk, ROM laden
+4. Recovery flashen (z.B. TWRP via fastboot Menü, Tastenkombination)
 5. Magisk, ROM als Zip oä drauf bekommen (ggf. via SD Card)
 6. Bootmenü starten (Tastenkombination)
 7. Magisk & ROM installieren (Magisk zum rooten nutzen, ggf. nachträglich)
@@ -16,11 +16,16 @@
 
 - https://wiki.lineageos.org/adb_fastboot_guide.html
 - https://box4gsm.blogspot.com/2019/11/how-to-install-adb-and-fastboot-on-arch.html
-- https://twrp.me/
-- https://github.com/topjohnwu/Magisk
-- https://magisk.me/
 - https://doc.e.foundation/devices/axolotl/install
-- https://skyhawkrecovery.github.io/Devices.html (TWPR Theme + Features)
+- https://doc.e.foundation/build-status
+- https://magisk.me/
+- https://github.com/topjohnwu/Magisk
+
+
+**extra:**
+> - https://lineageosroms.com/axolotl/
+> - https://skyhawkrecovery.github.io/Devices.html (TWPR Theme + Features)
+> - https://twrp.me/
 
 
 
@@ -45,11 +50,13 @@ https://www.digitbin.com/install-use-adb-fastboot-linux/
 
 ### 2. Geräteverbindung aufbauen
 
-Laut Anleitung via Tastenkombination
+Laut [Anleitung](https://doc.e.foundation/devices/axolotl/install) via Tastenkombination
 
-`Volume Down + Power` FIXME
+`Volume Up + Power` 
 
-Startet den `FASTBOOT` Download Modus (Screenshot)
+Startet den `FASTBOOT` Download Modus 
+
+(Screenshot)
 
 Via Terminal überprüfen mit 
 
@@ -59,12 +66,60 @@ Via Terminal überprüfen mit
 
 > Falls Ausfall/zu lange nicht verwendet: Nochmal Tastenkombination bis das Gerät erneut in den Modus startet!
 
-### Software bereithalten
+Wenn der Fasstboot Check erfolgreich war, den Bootloader checken mit der Auswahl `Reboot to bootloader` und dort steht dann der lock/unlock status vom bootloader. 
+
+Falls Bootloader zu entsperren ist mit 
+
+`fastboot flashing unlock` 
+
+freigeben. 
+
+> ggf. kommt folgende Fehlermeldung:
+>
+>```
+>FAILED (remote: 'Flashing Unlock is not allowed')
+>fastboot: error: Command failed
+>```
+> in diesem Fall "OEM unlock" via erweiterter Geräteeinstellungen im OS notwendig, wenn keine Ausgabe möglich
+
+Erfolgreich wenn folgende Meldung erfolgt:
+
+```
+OKAY [  0.036s]
+Finished. Total time: 0.037s
+
+```
+> :warning: Das Bootloader entsperren resettet und rebootet das Gerät!
 
-1. [TWPR](https://eu.dl.twrp.me/santoni/)
-2. [Magisk]()
+Danach noch die Auswahl "UNLOCK THE BOOTLOADER" bestätigen. 
+
+> :exclamation: im Anschluss ist dadurch ein erneutes Freigeben vom USB-debugging notwendig via Geräte Settings (alle anderen Setup-Einstellungen überspringen, wird ohnehin überschrieben)
+
+
+> **Note:** der bootloader bleibt entsperrt, soweit das die Dokumentation ausweist! überprüfen?
+
+
+### 3. Recovery, Magisk, ROM laden
+> kann parallel zu den anderen Schritten zuvor geschehen
+
+Aktuell ist von eOS nur [Android T(13)](https://images.ecloud.global/dev/axolotl/) als "Test" Version verfügbar, sollte aber stabil laufen. Bekannte [Issues](https://gitlab.e.foundation/groups/e/-/issues/?label_name%5B%5D=axolotl&label_name%5B%5D=type%3A%3ABug) sind hier verlinkt.
+
+**Software bereithalten**
+
+1. [eOS, recovery](https://doc.e.foundation/devices/axolotl)
+2. [Magisk](https://magisk.me/zip/) (apk to zip benennen)
 3. Microg (bei eOS inkl.)
-4. (optional) [SHRP](https://sourceforge.net/projects/shrp/files/Santoni/)
-5. [eOS](https://doc.e.foundation/devices/axolotl)
 
 
+Nach dem freigeben vom adb (USB-Debugging) Modus (siehe Hinweis oben) wieder in den fastboot/bootloader Modus wechseln und Verbindung prüfen mit `fastboot devices`. 
+
+> Falls das Telefon noch gebootet ist, einfach via `adb reboot bootloader` die Abkürzung nehmen und ddamit auch die USB Verbindung überprüfen.
+
+Terminal in dem Verzeichnis des Recovery Files öffnen oder dort hin navigieren mit `cd ...`.
+
+Anschließend das Custom Recovery (e.g. eOS oder TWRP) flashen mit: 
+
+`fastboot flash recovery <recoveryfilename>.img`
+
+> e.g. `fastboot flash recovery recovery-e-1.20-t-20240221382228-dev-axolotl.img`
+