Initial draft.

2 files changed, 168 insertions, 0 deletions

diff --git a/ADMIN.md b/ADMIN.md
new file mode 100644
index 0000000..acfc041
--- /dev/null
+++ b/ADMIN.md
@@ -0,0 +1,93 @@
+# Phone Administration
+
+## Install
+
+### Install rescue system
+
+Rescue system is installed using the tool Heimdall,
+and apps are initially installed using fdroidcl.
+First install those tools onto your Debian system:
+
+    sudo apt install heimdall fdroidcl
+
+Next, locate newest rescue system for your phone:
+
+    https://twrp.me/Devices/
+
+Downloading newest rescue system needs faking the refererhint
+(here using Samsung Galaxy S3 International Exynos as example):
+
+    wget --referer=https://eu.twrp.me/i9300/twrp-3.2.1-0-i9300.img.html https://eu.twrp.me/i9300/twrp-3.2.1-0-i9300.img
+
+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 VOL-DOWN+KEY, press POWER until logo appears (~2 seconds), release VOL-DOWN+KEY when next screen appears.
+ 4. Press VOL-UP when asked.
+ 5. Connect USB-to-PC data cable.
+ 6. Execute from terminal:
+    heimdall flash --no-reboot --RECOVERY twrp-[TAB...].img
+ 7. Disconnect any cables and turn off the phone.
+
+
+### Reset storage
+
+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:
+
+ 1. Disconnect any cables and turn off the phone.
+ 2. Press and hold VOL-UP+KEY, press POWER until logo appears (~2 seconds), release VOL-UP+KEY when next screen appears.
+ 3. [Swipe] to enter rescue mode
+ 4. Select Wipe, Format Data; type "yes"
+ 5. Select HOME, Reboot, Rescue
+ 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
+
+
+### Install system
+
+Locate and download newest system for your phone
+(use menu icon in top left corner):
+
+    https://download.lineageos.org/
+
+Install system onto phone:
+
+ 1. Fully charge the phone.
+ 2. Disconnect any cables and turn off the phone.
+ 3. Press and hold VOL-UP+KEY, press POWER until logo appears (~2 seconds), release VOL-UP+KEY when next screen appears.
+ 4. [Swipe] to enter rescue mode
+ 5. Select Wipe; [Swipe]
+ 6. Select Home, Advanced, ADB Sideload; [Swipe]
+ 7. Connect USB-to-PC data cable.
+ 8. Execute from terminal:
+    adb sideload lineage-[TAB...]-signed.zip (takes ~2 minutes)
+ 9. Select HOME, Wipe; [Swipe]
+ 10. Select HOME, Reboot, System, Do Not Install - or [Swipe] if no install is offered (takes ~3 minutes)
+
+
+### Add F-droid appstore integration
+
+ 1. Disconnect any cables and turn off the phone.
+ 3. Press and hold VOL-UP+KEY, press POWER until logo appears (~2 seconds), release VOL-UP+KEY when next screen appears.
+ 3. Select Home, Advanced, ADB Sideload; [Swipe]
+ 4. Execute from terminal:
+    fdroidcl update
+    fdroidcl download org.fdroid.fdroid.privileged.ota
+ 5. Connect USB-to-PC data cable.
+ 6. Execute from terminal:
+    adb sideload ~/.cache/fdroidcl/apks/org.fdroid.fdroid.privileged.ota_[TAB...].zip
+ 7. Select HOME, Reboot, System (takes ~30 seconds)
+
+
+### Add selected apps, including F-droid appstore
+
+ 1. Execute from terminal:
+    fdroidcl install org.dmfs.tasks at.bitfire.davdroid org.birthdayadapter com.zegoggles.smssync com.moez.QKSMS
+    fdroidcl install org.sufficientlysecure.viewer com.llamacorp.equate com.gabm.screenrotationcontrol
+    fdroidcl install net.kismetwireless.android.smarterwifimanager
+    fdroidcl install com.fsck.k9 org.sufficientlysecure.keychain eu.siacs.conversations
+    fdroidcl install net.osmand.plus com.vonglasow.michael.satstat com.rareventure.gps2 de.grobox.liberario org.ametro
diff --git a/TECH.md b/TECH.md
new file mode 100644
index 0000000..d3f36bf
--- /dev/null
+++ b/TECH.md
@@ -0,0 +1,75 @@
+# Android administration
+
+## Baseband radio
+
+Baseband code is in official releases from Samsung,
+but separatefrom Android source (AOSP)
+and (probably therefore) not in CyanogenMod (CM) nor Replicant.
+
+### Updating Baseband radio
+
+Requires. Debian package "heimdall-flash" and binary blob "modem.bin".
+
+Samsung releases are issued only via their Windows-based Kies tool.
+Unofficial redistribution are at...:
+
+  * http://www.gsm-file.com/ (need login)
+  * http://samsung-updates.com/ (rate-limited)
+  * https://samsung-firmware.org/ (rate-limited, need login)
+  * https://www.sammobile.com/ (rate-limited, need login)
+
+ 1) Fully charge the phone.
+ 2) Disconnect any cables and turn off the phone.
+ 3) Hold VOL-DOWN+KEY, press POWER for 2 seconds, then release them all.
+ 3) Press VOL-UP when asked.
+ 4) Connect USB-to-PC data cable.
+ 5) Run "heimdall flash --RADIO modem.bin"
+
+### Version numbers
+
+Version numbers for Samsung releases are strings like "I9300XXUGPB1"
+where last 2 characters (the "PB" here)
+indicate year and month as roman numbers.
+
+Samsung releases has 3 version numbers.
+Commonly only PDA is listed, sometimes also CSC.
+Baseband version is different from those,
+often listed last (if at all).
+
+Always use baseband version GM2 or newer,
+due to its use of [EFSv2][].
+
+CyanogenMod 13 (based on Android 6.0.1)
+is [rumored][] to need recent baseband for GPS to work.
+
+Concrete experience:
+Two phones bought second-hand in Denmark (but originating elsewhere)
+has working GPS with CM13 and these baseband versions:
+  * I9300XXUGOK1 e.g. from I9300XXUGOK1_VNZ_NEW_ZEALAND_4.3.zip
+    sha1 of modem.bin: 2d4625021ad5931377865eddba7cf1fb18a111da
+  * I9300BOUGNB1 e.g. from TNL-I9300XXUGOL2-20160120152855.zip)
+    sha1 of modem.bin: c893aaa146d2120fd316cb7d1af4111e1069e990
+
+[EFSv2]: http://forum.xda-developers.com/galaxy-s3/general/ref-imei-efs-stuff-i9300-including-t2393289
+  "forum post covering EFS formats and relationship to baseband versions"
+
+[rumored]: https://forum.cyanogenmod.org/topic/123415-gt-i9300-gps-issue-fixed/
+  "forum post listing failing and succeeding baseband versions for CM13"
+
+
+## Recovery
+
+Recovery is a separate minimal rescue system.
+
+Some Recovery systems follow the [IsoRec] structure,
+allowing Recovery and regular systems from different vendors
+to work together.
+
+[IsoRec]: http://forum.xda-developers.com/galaxy-s2/orig-development/isorec-isolated-recovery-galaxy-s2-t3291176
+  "forum post covering Isolated Recovery"
+
+
+## Partition
+
+[REPIT]; https://github.com/Lanchon/REPIT
+  "tool to automatic repartition select devices while preserving data"