From b90201854bd521e92a2134dc7fbafa9cf129b914 Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Sat, 23 Jun 2018 19:26:28 +0200 Subject: Initial draft. --- ADMIN.md | 93 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ TECH.md | 75 +++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 168 insertions(+) create mode 100644 ADMIN.md create mode 100644 TECH.md 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" -- cgit v1.2.3