clariphy how to enter Boot modes, and modernize to cover Samsung Galaxy S10

1 files changed, 87 insertions, 41 deletions

diff --git a/ADMIN.md b/ADMIN.md
index b6f1d5e..2eb4078 100644
--- a/ADMIN.md
+++ b/ADMIN.md
@@ -7,6 +7,44 @@ install rescue system "TWRP", system "LineageOS",
 and apps from repository "F-droid".
 
 
+### Modernize
+
+Before installing a custom system,
+first upgrade to newest upstream-provided system
+as some upgrades may include firmware changes kept on special storage,
+which survives system reset or wipeout of user data:
+
+ 1. Fully charge the phone.
+ 2. Turn on the phone, booting into Nomal mode.
+ 3. Optionally do a factory reset:
+    If not immediately presented with an initial setup wizard
+    (or in any case just to be extra cautious),
+    at Settings -> System -> Reset options,
+    do a factory reset.
+ 4. Minimally complete the initial setup wizard.
+ 5. Update the system
+    (Play Store updates are irrelevant and can be stopped),
+    and repeat (after each reboot) until no system update is offered.
+
+Samsung Galaxy S10 or newer requires unlocking
+(skip this for older Samsung Galaxy S phones):
+
+ 1. Fully charge the phone.
+ 2. Turn on the phone, booting into Nomal mode.
+ 3. Enable developer setting:
+    At Settings -> About phone,
+    tab many times on Build number.
+ 4. at Settings -> System -> Advanced -> Developer options,
+    enable OEM mode.
+ 5. Enter Download mode:
+    Disconnect any cables and turn off the phone,
+    press and hold buttons VOL-DOWN and SELECT (and keep them held down!),
+    then connect USB-to-PC data cable,
+    release the held buttons when a warning screen appears,
+    long-press button VOL-UP,
+    and confirm doing a full system reset.
+
+
 ### Install rescue system
 
 Rescue system is installed using the tool Heimdall,
@@ -27,13 +65,16 @@ Downloading newest rescue system needs faking the refererhint
 Install rescue system onto phone using Heimdall:
 
  1. Fully charge the phone.
- 2. Disconnect any cables and turn off the phone.
- 3. Press and hold keys VOL-DOWN and SELECT (and keep them held down!),
-    press key POWER and release it (only that one key!) when logo appears (~2 seconds),
- 4. When a warning screen appears, release keys VOL-DOWN and SELECT,
-    and press key VOL-UP.
- 5. Connect USB-to-PC data cable.
- 6. Execute from terminal:
+ 2. Boot into **Download mode**:
+    Disconnect any cables and turn off the phone,
+    press and hold buttons VOL-DOWN and SELECT (and keep them held down!),
+    then connect USB-to-PC data cable
+    (or on Galaxy S9 or older,
+    press and hold POWER until logo appears after ~2 seconds),
+    release held buttons when a warning screen appears,
+    and press button VOL-UP.
+ 3. Connect USB-to-PC data cable (if not already done in previous step).
+ 4. Execute from terminal:
     heimdall flash --no-reboot --RECOVERY twrp-[TAB...].img
 
 Phone screen tells you to not turn off,
@@ -41,22 +82,31 @@ but when terminal is done you can ignore that
 and either turn off the phone go directly to next section.
 
 
-### Reset storage
+### Recovery
 
 When taking over a phone from someone else,
 or loosing full-disk-encryption password and needing to start over,
-reset most possible before installing a fresh system onto phone:
+reset most possible.
+
+First optionally recover data as needed, if possible.
+
+Then wipe data and system partitions:
 
- 1. Disconnect any cables and turn off the phone.
- 2. Press and hold keys VOL-UP and SELECT (and keep them held down!),
-    press key POWER and release it (only that one key!) when logo appears (~2 seconds),
- 3. When TWRP intro screen appears, release keys VOL-UP and SELECT,
+ 1. Fully charge the phone.
+ 2. Boot into **Recovery mode**:
+    Disconnect any cables and turn off the phone,
+    connect USB-to-PC data cable,
+    press and hold buttons VOL-UP and SELECT (and keep them held down!),
+    press and hold POWER as well
+    (or on Galaxy S9 or older,
+    press and hold POWER only until logo appears after ~2 seconds),
+    release held buttons when TWRP intro screen appears,
     and [Swipe] to enter home screen.
- 4. Select Wipe, Format Data; type "yes"
- 5. Select HOME, Reboot, Recovery (avoid installing any addons if offered!)
- 6. [Swipe] to enter rescue mode
- 7. Select Wipe, Advanced wipe, check all except "Micro SD card" and "USB OTG", [Swipe]
- 8. Select HOME, Reboot, Poweroff (avoid installing any addons if offered!)
+ 3. Select Wipe, Format Data; type "yes"
+ 4. Select HOME, Reboot, Recovery (avoid installing any addons if offered!)
+ 5. [Swipe] to enter rescue mode
+ 6. Select Wipe, Advanced wipe, check all except "Micro SD card" and "USB OTG", [Swipe]
+ 7. Select HOME, Reboot, Poweroff (avoid installing any addons if offered!)
 
 To install system after this (and phone is fully charged!),
 you can skip step 8 above and go directly to step 5 below.
@@ -72,18 +122,15 @@ Locate and download newest system for your phone
 Install system onto phone:
 
  1. Fully charge the phone.
- 2. Disconnect any cables and turn off the phone.
- 3. Press and hold keys VOL-UP and SELECT (and keep them held down!),
-    press key POWER and release it (only that one key!) when logo appears (~2 seconds),
- 4. When TWRP intro screen appears, release keys VOL-UP and SELECT,
-    and [Swipe] to enter home screen.
- 5. Select Wipe; [Swipe]
- 6. Select Home, Advanced, ADB Sideload; [Swipe]
- 7. Connect USB-to-PC data cable.
- 8. Execute from terminal:
+ 2. Boot into **Recovery mode**:
+    (see [above](#Recovery)).
+ 3. Select Wipe; [Swipe]
+ 4. Select Home, Advanced, ADB Sideload; [Swipe]
+ 5. Connect USB-to-PC data cable (if not already done in previous step).
+ 6. Execute from terminal:
     adb sideload lineage-[TAB...]-signed.zip (takes ~2 minutes)
- 9. Select HOME, Wipe; [Swipe]
- 10. Select HOME, Reboot, System (avoid installing any addons if offered!)
+ 7. Select HOME, Wipe; [Swipe]
+ 8. Select HOME, Reboot, System (avoid installing any addons if offered!)
 
 Initial boot after fresh install takes ~3 minutes on a Samsung S3,
 probably less on a newer phone.
@@ -91,19 +138,17 @@ probably less on a newer phone.
 
 ### Add F-droid appstore integration
 
- 1. Disconnect any cables and turn off the phone.
- 2. Press and hold keys VOL-UP and SELECT (and keep them held down!),
-    press key POWER and release it (only that one key!) when logo appears (~2 seconds),
- 3. When TWRP intro screen appears, release keys VOL-UP and SELECT,
-    and [Swipe] to enter home screen.
- 4. Select Home, Advanced, ADB Sideload; [Swipe]
- 5. Execute from terminal:
+ 1. Fully charge the phone.
+ 2. Boot into **Recovery mode**:
+    (see [above](#Recovery)).
+ 3. Select Home, Advanced, ADB Sideload; [Swipe]
+ 4. Execute from terminal:
     fdroidcl update
     fdroidcl download org.fdroid.fdroid.privileged.ota
- 6. Connect USB-to-PC data cable.
- 7. Execute from terminal:
+ 5. Connect USB-to-PC data cable.
+ 6. Execute from terminal:
     adb sideload ~/.cache/fdroidcl/apks/org.fdroid.fdroid.privileged.ota_[TAB...].zip
- 8. Select HOME, Reboot, System (avoid installing any addons if offered!)
+ 7. Select HOME, Reboot, System (avoid installing any addons if offered!)
 
 Boot takes ~30 seconds
 
@@ -112,10 +157,11 @@ Boot takes ~30 seconds
 
  1. Enable developer setting:
     At Settings -> About phone,
-    Tab many times on Build number.
+    tab many times on Build number.
  2. at Settings -> System -> Advanced -> Developer options,
     enable Android Debugging.
- 3. Execute from terminal:
+ 3. Connect USB-to-PC data cable.
+ 4. Execute from terminal:
     fdroidcl install org.dmfs.tasks at.bitfire.davdroid org.birthdayadapter com.zegoggles.smssync org.smssecure.smssecure
     fdroidcl install org.sufficientlysecure.viewer com.llamacorp.equate
     fdroidcl install net.kismetwireless.android.smarterwifimanager