Catcrafts/fp6-img
Watch
2
0
Fork
You've already forked fp6-img
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

install.sh: one-command modem-preserving installer

Browse source 
erase dtbo + flash userdata + RAM-boot + dd boot_a from Linux + verify
modem NV and report honestly. Shipped in dist/ with every release; README
points at it. The one believed-safe-but-unisolated step (userdata flash)
is self-verified by the script's final check.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Jorijn van der Graaf 2026-08-09 01:29:17 +02:00
commit ccf23abf81
3 changed files with 110 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

21
README.md
View file

@ -29,22 +29,19 @@ carriers are very welcome.
Download `boot.img` and `fairphone-fp6.img` from the latest release and unlock
the bootloader ([Fairphone's official process](https://support.fairphone.com/hc/en-us/articles/10492476238737)).
**Recommended — modem-preserving install** (`fastboot boot` streams the
kernel to RAM without writing; all writes then happen from Linux, which the
bootloader's boot-flash NV-wipe never sees — see the warning below):
**Recommended — modem-preserving install**: with the phone in fastboot mode,
run [`install.sh`](install.sh) (also attached to every release) from the
directory holding the two images:
```sh
fastboot boot boot.img
# wait ~60s; the phone comes up on the USB network as 172.16.42.1
# (fresh devices land in the initramfs debug shell; telnet 172.16.42.1)
# then write both images through Linux, e.g. over the USB network:
ssh user@172.16.42.1 # or the debug shell on virgin devices
# on the phone: fetch/receive the images and
# dd of=/dev/disk/by-partlabel/boot_a for boot.img
# dd of=/dev/disk/by-partlabel/userdata for fairphone-fp6.img
fastboot erase dtbo # one-time, on the next fastboot visit (safe: verified)
sh install.sh
```
It erases dtbo, flashes the rootfs, **RAM-boots** the kernel (`fastboot
boot` — verified to write nothing), writes the boot partition from inside
Linux where the bootloader's NV-wipe cannot see it, then reads the modem NV
back and reports the result. The bootloader never writes `boot`.
**Classic install** (simpler, but `fastboot flash boot` **zeroes the modem's
NV** — cellular will be dead until you restore your `modemst` backup):