diff --git a/data/backlog.json b/data/backlog.json index 5778eef1..ad7d5bd1 100644 --- a/data/backlog.json +++ b/data/backlog.json @@ -182,7 +182,7 @@ {"project":"linux-phone-oco/google-walleye-lab","id":"walleye-follows-template","title":"google-walleye-lab follows device-template's release: its copy of the list gone, its rust job in its own workflow, the pin a release, stale PR 208 closed","status":"open","note":"Migration for decision 2026-11-18-device-template-follows-by-release; no phone. Measured drift today: generic copy 5 entries behind, ffs-acm-rs job inside the template's check.yml, devicebase.toml template = 2026-11-17, PR #208 (the template's #15 by hand) open though main has it.","opened":"2026-11-18","waits":null,"blocked_by":"template-releases","hardware":null,"needs":"build","device":"google-walleye","proof":"docs research/device-template/2026-11-18/template-drift.sh device-template ideal-knowledge-base google-walleye-lab: every google-walleye-lab line says ok","rank":null,"about":"device-template"} {"project":"linux-phone-oco/docs","id":"bringup-steps","title":"Bring-up steps as data: every step that makes Linux run on a machine, generic in docs, each device's status claimed in its own base, a guidebook and helpers made from it","status":"open","note":"Decided 2026-11-18-bringup-steps-generic-in-docs-status-in-each-base (research bringup-steps-landscape). The pieces are the items about bringup-steps, unranked for the author.","opened":"2026-11-18","waits":null,"blocked_by":"bringup-steps-schema,bringup-steps-seed,feed-device-steps,walleye-steps-claimed","hardware":null,"needs":null,"device":null,"proof":"research/bringup-steps/2026-11-18/bringup-chain-walleye.sh passes in docs: tad q bringup-chain --device google-walleye lists walleye's steps in order, each proven one with its proof and run, none unknown (fails today: no query bringup-chain)","rank":null,"about":"commons-only"} {"project":"linux-phone-oco/docs","id":"bringup-steps-schema","title":"The bring-up step tables in docs: bringup_steps, bringup_step_edges, step_status, the records bringup-step and bringup-edge, and the query bringup-chain","status":"done","note":"Landed: tables bringup_stages (the stage list as rows, so it changes with ikb bringup-stage and no schema change), bringup_steps, bringup_step_edges, step_status (declared only; a feed fills it); records bringup-step, bringup-edge (refuses a cycle, a self-edge, a group mixing hard and soft), bringup-stage; query bringup-chain [--device] with a computed ready/waits. Reviewed by the programmer subagent (group-name collision, UNION for the depth walk, stage tie, device guard fixed). tad check: 37 tables; make verify twice clean. Test research/bringup-steps/2026-11-18/bringup-chain-walleye.sh: was 'no query bringup-chain'; with the schema and seed it gets 26 steps in order and fails only for lack of claims (walleye kernel-reaches-init is unknown, not done): walleye-steps-claimed and feed-device-steps make it pass.","opened":"2026-11-18","waits":null,"blocked_by":null,"hardware":null,"needs":null,"device":null,"proof":"tad check passes with the three tables; tad r bringup-edge refuses an edge that closes a cycle; tad q bringup-chain answers with no device (every status unknown)","rank":null,"about":"bringup-steps"} -{"project":"linux-phone-oco/docs","id":"bringup-steps-seed","title":"Seed the generic steps: 26 steps and 37 edges from walleye's real chain, surya's road checked against it","status":"open","note":"sh research/bringup-steps/2026-11-18/seed.sh in docs, through the records","opened":"2026-11-18","waits":null,"blocked_by":"bringup-steps-schema","hardware":null,"needs":null,"device":null,"proof":"tad q bringup-chain lists 26 steps, bootloader and stock steps at depth 0, health-suite-runs last; tad check passes","rank":null,"about":"bringup-steps"} +{"project":"linux-phone-oco/docs","id":"bringup-steps-seed","title":"Seed the generic steps: 26 steps and 37 edges from walleye's real chain, surya's road checked against it","status":"done","note":"Landed: 8 stages, 26 steps and 37 edges recorded through ikb bringup-stage, bringup-step and bringup-edge (research/bringup-steps/2026-11-18/seed.sh, rerunnable). tad q bringup-chain lists 26 steps in order: stock-measured, stock-facts-read, slot-state-known and initramfs-gadget-emulated at depth 0, bootloader-unlocked at 1 (a soft need on stock-measured: an unlock may wipe the stock system), health-suite-runs last at 12; every status unknown until a base claims. Stages are rows of bringup_stages (prepare, boot, console, kernel, power, storage, userspace, lab), the draft awaiting the author's word: change them with ikb bringup-stage, no schema change. tad check passes; make verify twice clean.","opened":"2026-11-18","waits":null,"blocked_by":"bringup-steps-schema","hardware":null,"needs":null,"device":null,"proof":"tad q bringup-chain lists 26 steps, bootloader and stock steps at depth 0, health-suite-runs last; tad check passes","rank":null,"about":"bringup-steps"} {"project":"linux-phone-oco/device-template","id":"steps-contract","title":"The steps contract in the template: a steps table, the record step, contract steps = 1 in devicebase.toml, data/steps.json empty, in the template's followed files","status":"open","note":"Reaches labs by the template release (decision 2026-11-18-device-template-follows-by-release), never by hand. A new device starts with no claim: every step not known yet.","opened":"2026-11-18","waits":null,"blocked_by":"bringup-steps-schema,template-releases","hardware":null,"needs":null,"device":null,"proof":"in the template, tad check passes with an empty steps table; tad r step --step shell-on-console --status done --proof X --run Y writes one row and refuses a status outside the six","rank":null,"about":"bringup-steps"} {"project":"linux-phone-oco/docs","id":"feed-device-steps","title":"Pull each device base's steps into step_status: records/feed-device-steps.sql and a device-steps-unknown fallback in bin/run-feeds.sh","status":"open","note":"As feed-device-parts: read devicebase.toml (steps = 1) and data/steps.json from the base on main; a step not claimed is unknown, not known yet; a claim of a step docs does not know is dropped and named.","opened":"2026-11-18","waits":null,"blocked_by":"bringup-steps-schema,steps-contract","hardware":null,"needs":null,"device":null,"proof":"run against a base without steps = 1, every step of that device is unknown with the reason; against google-walleye-lab after its claims, research/bringup-steps/2026-11-18/bringup-chain-walleye.sh passes","rank":null,"about":"bringup-steps"} {"project":"linux-phone-oco/google-walleye-lab","id":"walleye-steps-claimed","title":"walleye claims its bring-up steps in its own base, from its records","status":"open","note":"The 26 claims are written out in research/bringup-steps/2026-11-18/claims-walleye.sh, each run a record of google-walleye-lab. Data only; no phone.","opened":"2026-11-18","waits":null,"blocked_by":"steps-contract,walleye-follows-template","hardware":null,"needs":"build","device":"google-walleye","proof":"research/bringup-steps/2026-11-18/bringup-chain-walleye.sh passes in docs after make feeds","rank":null,"about":"bringup-steps"} diff --git a/data/bringup_stages.json b/data/bringup_stages.json new file mode 100644 index 00000000..07e3d7e9 --- /dev/null +++ b/data/bringup_stages.json @@ -0,0 +1,8 @@ +{"id":"prepare","ord":1,"title":"Prepare","what":"Read what the machine is and what it allows before anything is changed: the stock system, the boot facts, the way back."} +{"id":"boot","ord":2,"title":"Boot","what":"Get an image of ours accepted by the bootloader and run, one part swapped at a time, until it is known what refuses it."} +{"id":"console","ord":3,"title":"Console","what":"A window onto the running kernel: a banner, a shell, over UART or the USB gadget."} +{"id":"kernel","ord":4,"title":"Kernel","what":"Our kernel builds, reaches its init and says nothing worse than it should."} +{"id":"power","ord":5,"title":"Power","what":"The PMIC, the charger and the watchdog: what keeps the machine alive and safe to leave running."} +{"id":"storage","ord":6,"title":"Storage","what":"Internal storage seen, first read-only."} +{"id":"userspace","ord":7,"title":"Userspace","what":"A distribution's root boots, the network is up and the health suite runs on every boot."} +{"id":"lab","ord":8,"title":"Lab","what":"What the lab needs of a machine to work on it without hands: the ways in, a try that cannot brick."} diff --git a/data/bringup_step_edges.json b/data/bringup_step_edges.json new file mode 100644 index 00000000..9fce8f55 --- /dev/null +++ b/data/bringup_step_edges.json @@ -0,0 +1,37 @@ +{"step":"bootloader-unlocked","requires":"stock-measured","kind":"soft","group":null,"why":"an unlock may wipe the stock system"} +{"step":"control-image-boots","requires":"bootloader-unlocked","kind":"hard","group":null,"why":"fastboot boot needs an unlocked bootloader"} +{"step":"control-image-boots","requires":"slot-state-known","kind":"hard","group":null,"why":"walleye: refusals were the slot state (walleye-load-error-first-state)"} +{"step":"boot-image-packs","requires":"stock-facts-read","kind":"hard","group":null,"why":"the header and offsets are the stock image's"} +{"step":"kernel-builds","requires":"stock-facts-read","kind":"soft","group":null,"why":"the dtb ids the bootloader matches"} +{"step":"dtbo-accepted","requires":"kernel-builds","kind":"hard","group":null,"why":"it is our dtb that must merge"} +{"step":"stock-kernel-runs-our-init","requires":"control-image-boots","kind":"hard","group":null,"why":"the control is the image swapped into"} +{"step":"stock-kernel-runs-our-init","requires":"boot-image-packs","kind":"hard","group":null,"why":"the swap repacks"} +{"step":"stock-kernel-runs-our-init","requires":"initramfs-gadget-emulated","kind":"soft","group":null,"why":"an init proven emulated spends no phone time"} +{"step":"crash-window","requires":"stock-facts-read","kind":"soft","group":null,"why":"the ramoops region is the stock fdt's"} +{"step":"reference-kernel-boots","requires":"control-image-boots","kind":"hard","group":null,"why":"same bootloader path"} +{"step":"reference-kernel-boots","requires":"boot-image-packs","kind":"hard","group":null,"why":"packed the device's way"} +{"step":"kernel-reaches-init","requires":"kernel-builds","kind":"hard","group":null,"why":"it is our kernel"} +{"step":"kernel-reaches-init","requires":"boot-image-packs","kind":"hard","group":null,"why":"packed the device's way"} +{"step":"kernel-reaches-init","requires":"control-image-boots","kind":"hard","group":null,"why":"the bootloader accepts images"} +{"step":"kernel-reaches-init","requires":"dtbo-accepted","kind":"hard","group":null,"why":"walleye: no start without the merge (walleye-dtbo-overlay-merge-why)"} +{"step":"kernel-reaches-init","requires":"crash-window","kind":"soft","group":null,"why":"without one a dead kernel says nothing"} +{"step":"kernel-reaches-init","requires":"reference-kernel-boots","kind":"soft","group":null,"why":"the bisect reference"} +{"step":"uart-console","requires":"kernel-builds","kind":"hard","group":null,"why":"it is our kernel's log"} +{"step":"gadget-enumerates","requires":"kernel-reaches-init","kind":"hard","group":null,"why":"our kernel's gadget"} +{"step":"gadget-enumerates","requires":"initramfs-gadget-emulated","kind":"hard","group":null,"why":"the init makes the gadget"} +{"step":"banner-on-console","requires":"gadget-enumerates","kind":"hard","group":"console","why":"the console over the gadget"} +{"step":"banner-on-console","requires":"uart-console","kind":"hard","group":"console","why":"or over UART"} +{"step":"shell-on-console","requires":"banner-on-console","kind":"hard","group":null,"why":"a console that carries text first"} +{"step":"first-dmesg-mapped","requires":"shell-on-console","kind":"hard","group":null,"why":"dmesg is read through the shell"} +{"step":"dmesg-clean","requires":"first-dmesg-mapped","kind":"hard","group":null,"why":"the map names what to clean"} +{"step":"pmic-bound","requires":"shell-on-console","kind":"hard","group":null,"why":"read through the shell"} +{"step":"pmic-bound","requires":"first-dmesg-mapped","kind":"soft","group":null,"why":"the map names the PMIC's faults"} +{"step":"charger-online","requires":"pmic-bound","kind":"hard","group":null,"why":"the charger is a PMIC child"} +{"step":"watchdog-way-back","requires":"kernel-reaches-init","kind":"hard","group":null,"why":"it is our kernel that hangs"} +{"step":"watchdog-way-back","requires":"pmic-bound","kind":"soft","group":null,"why":"walleye's way is the PMIC watchdog"} +{"step":"storage-readonly","requires":"shell-on-console","kind":"hard","group":null,"why":"read through the shell"} +{"step":"storage-readonly","requires":"dmesg-clean","kind":"soft","group":null,"why":"smmu and supplier faults stop DMA devices"} +{"step":"usb-network","requires":"gadget-enumerates","kind":"hard","group":null,"why":"the network rides the gadget"} +{"step":"rootfs-boots","requires":"storage-readonly","kind":"hard","group":null,"why":"the root is on the storage"} +{"step":"rootfs-boots","requires":"usb-network","kind":"hard","group":null,"why":"ssh is the proof"} +{"step":"health-suite-runs","requires":"rootfs-boots","kind":"hard","group":null,"why":"the suite runs on the root"} diff --git a/data/bringup_steps.json b/data/bringup_steps.json new file mode 100644 index 00000000..4925ff2f --- /dev/null +++ b/data/bringup_steps.json @@ -0,0 +1,26 @@ +{"id":"bootloader-unlocked","title":"Bootloader unlocked","stage":"prepare","ord":1,"applies":"boot:android","done_when":"fastboot getvar all says unlocked: yes","proof":"fastboot-unlocked","proof_kind":"host-check","helper":"lpoco lab fastboot getvar","component":null,"guide":"Unlocking wipes the user's data and is the owner's act. Read the state before anything else (walleye google-walleye-bootloader-first-look, surya first-fastboot-probe).","sources":null,"checked_on":"2026-11-18"} +{"id":"stock-measured","title":"The stock system measured","stage":"prepare","ord":2,"applies":"any","done_when":"what works on the stock system, its battery and its partitions are recorded as the reference","proof":"android-reference","proof_kind":"research","helper":null,"component":null,"guide":"Measure the stock system before anything is flashed: it is the reference 'as good as Android' is judged by, and an unlock may wipe it (walleye android-reference-walleye-measured).","sources":null,"checked_on":"2026-11-18"} +{"id":"stock-facts-read","title":"The stock boot's facts read","stage":"prepare","ord":3,"applies":"any","done_when":"the stock cmdline, boot header and offsets, dtb ids (msm-id, board-id), running fdt and ramoops region are recorded","proof":"stock-facts-recorded","proof_kind":"research","helper":"lpoco bringup image info","component":null,"guide":"Read them from the running stock system and its boot image (walleye walleye-stock-ids-recorded, walleye-boot-cmdline-known). The running fdt is worth keeping whole: on walleye it named the cause of the dead dtbs (walleye-our-dts-gpio-reserved).","sources":null,"checked_on":"2026-11-18"} +{"id":"slot-state-known","title":"Slots read, a way back known","stage":"prepare","ord":4,"applies":"boot:android-ab","done_when":"both slots' flags are reported before and after every try, and the phone returns to the stock system by itself","proof":"slot-report","proof_kind":"host-check","helper":"lpoco lab fastboot state","component":null,"guide":"On walleye the Load Error was the slot state left by refusals, not the image: restore the first state (Android booted to completion on a good slot) before each try (walleye-load-error-first-state).","sources":null,"checked_on":"2026-11-18"} +{"id":"control-image-boots","title":"A known-good image boots from memory","stage":"boot","ord":1,"applies":"boot:android","done_when":"fastboot boot of a known-good stock-format image leaves fastboot and runs, nothing written","proof":"fastboot-boot-control","proof_kind":"host-check","helper":"lpoco lab fastboot boot","component":null,"guide":"The control tells 'the bootloader refuses' from 'our image is wrong' (walleye walleye-loaderror-control).","sources":null,"checked_on":"2026-11-18"} +{"id":"boot-image-packs","title":"Our boot image packs as the device wants","stage":"boot","ord":2,"applies":"boot:android","done_when":"header version, offsets, page size, dtb placement and os word match the control where they should","proof":"bringup-pack-matches-mkbootimg","proof_kind":"build-check","helper":"lpoco bringup image pack, check","component":null,"guide":"Pack from the device's [boot] declaration and count it against the control (walleye walleye-bootimage). The helper packs header v0 only.","sources":null,"checked_on":"2026-11-18"} +{"id":"dtbo-accepted","title":"The bootloader's dtbo overlay accepted","stage":"boot","ord":3,"applies":"boot:android-dtbo","done_when":"our dtb, built with -@ and the overlay's labels, merges with the stock dtbo, or the bootloader does not need it","proof":"dtbo-overlay-merges","proof_kind":"build-check","helper":null,"component":null,"guide":"On walleye our dtb with -@ and the 137 labels merged; the dtbo stub that was planned was never needed (walleye-dtb-overlay-symbols-build, walleye-loaderror-dtbo-stub).","sources":null,"checked_on":"2026-11-18"} +{"id":"initramfs-gadget-emulated","title":"Our initramfs brings the gadget up, emulated","stage":"boot","ord":4,"applies":"usb:gadget","done_when":"in QEMU with dummy_hcd our initramfs makes the gadget (ACM console and a window) and the host side sees it","proof":"selftest-initramfs","proof_kind":"build-check","helper":"lpoco bringup initramfs build","component":null,"guide":"Prove the init before any phone time (walleye walleye-initramfs-usb-gadget). The generic init under lpoco is backlog bringup-generic-init.","sources":null,"checked_on":"2026-11-18"} +{"id":"stock-kernel-runs-our-init","title":"The stock kernel runs our init","stage":"boot","ord":5,"applies":"boot:android","done_when":"the stock kernel with only our ramdisk swapped runs our /init, and it shows (a gadget, a mass-storage window)","proof":"massstorage-window-read","proof_kind":"host-check","helper":"lpoco bringup image swap","component":null,"guide":"Proves the image path apart from our kernel. On walleye the NCM function panics the vendor 4.4 kernel; a mass-storage window works (walleye-ncm-split, walleye-massstorage-window).","sources":null,"checked_on":"2026-11-18"} +{"id":"crash-window","title":"A window on a dead boot","stage":"boot","ord":6,"applies":"any","done_when":"a dead or hung boot leaves something the host reads: UART, pstore at the phone's own ramoops region, or a timing channel","proof":"crash-window-read","proof_kind":"host-check","helper":null,"component":null,"guide":"On walleye ramoops survives only at the region the stock fdt names and only across a warm reset (walleye-pstore-warm-reset, walleye-pstore-t1-try); a timing channel told alive from dead (walleye-ml4-timing-channel); UART waits a cable (walleye-get-uart-setup).","sources":null,"checked_on":"2026-11-18"} +{"id":"kernel-builds","title":"Our kernel and dts build","stage":"kernel","ord":1,"applies":"any","done_when":"the mainline kernel and the device's dts build with no dtc warning from our file, and the dtb carries the ids the bootloader matches","proof":"dtb-builds-with-ids","proof_kind":"build-check","helper":null,"component":null,"guide":"Start from the nearest sibling's dts in mainline (walleye from taimen, walleye-kernel-dts).","sources":null,"checked_on":"2026-11-18"} +{"id":"reference-kernel-boots","title":"Someone else's mainline kernel boots here","stage":"kernel","ord":2,"applies":"any","done_when":"another project's mainline kernel and dtb for this device or a sibling reach their init on this phone","proof":"reference-alive","proof_kind":"host-check","helper":"lpoco bringup image bisect","component":null,"guide":"The reference to bisect against when ours is dead: swap one part at a time (walleye pk5 alive against ours dead: walleye-bisect-porthole-vs-ours, walleye-our-dtb-bisect, walleye-property-bisect).","sources":null,"checked_on":"2026-11-18"} +{"id":"kernel-reaches-init","title":"Our kernel reaches our init","stage":"kernel","ord":3,"applies":"any","done_when":"our kernel and our dtb reach /init: the phone stays up as long as /init says, with no early reset","proof":"kernel-alive","proof_kind":"host-check","helper":"lpoco bringup image bisect","component":null,"guide":"Two traps on walleye: earlycon on an undeclared UART kills the kernel (walleye-no-earlycon); a pinctrl node without gpio-reserved-ranges touches the secure world's pins and resets the phone (walleye-our-dts-gpio-reserved).","sources":null,"checked_on":"2026-11-18"} +{"id":"uart-console","title":"Kernel log on UART","stage":"console","ord":1,"applies":"any","done_when":"the kernel's log reaches the host over the debug UART","proof":"uart-log","proof_kind":"host-check","helper":null,"component":null,"guide":"Needs the device's debug cable or pads; on walleye it waits the cable (walleye-get-uart-setup), so the USB gadget was the console.","sources":null,"checked_on":"2026-11-18"} +{"id":"gadget-enumerates","title":"The host sees our gadget","stage":"console","ord":2,"applies":"usb:gadget","done_when":"the host enumerates our own kernel's gadget by its vendor:product and serial","proof":"gadget-enumerates","proof_kind":"host-check","helper":null,"component":null,"guide":"walleye y2: 1d6b:0104 18 s after the jump (walleye-try-y).","sources":null,"checked_on":"2026-11-18"} +{"id":"banner-on-console","title":"The banner on the console","stage":"console","ord":3,"applies":"any","done_when":"/init's banner with a heartbeat reaches the host on the console, read as the lab user","proof":"banner-seen","proof_kind":"host-check","helper":null,"component":null,"guide":"The gadget serial must be the one the host's udev rule names, or the tty is root's (walleye-banner-serial-fix, walleye-try-banner2).","sources":null,"checked_on":"2026-11-18"} +{"id":"shell-on-console","title":"A shell answers on the console","stage":"console","ord":4,"applies":"any","done_when":"commands sent on the console answer, one at a time, reliably across hangups","proof":"shell-answers","proof_kind":"host-check","helper":null,"component":null,"guide":"On walleye an interactive ash stayed silent; a plain read/exec loop and the host tty raw and -hupcl made it answer (walleye-shell-reliable, walleye-command-loop, walleye-try-z6).","sources":null,"checked_on":"2026-11-18"} +{"id":"first-dmesg-mapped","title":"The first dmesg mapped","stage":"kernel","ord":4,"applies":"any","done_when":"the first full dmesg of our kernel is read and every line placed: works, defers, fails, and whose","proof":"dmesg-map","proof_kind":"research","helper":null,"component":null,"guide":"The map orders what follows (walleye-z6-dmesg-map, research walleye-bringup-order-plan).","sources":null,"checked_on":"2026-11-18"} +{"id":"dmesg-clean","title":"dmesg clean","stage":"kernel","ord":5,"applies":"any","done_when":"no WARN, oops or -110, and no probe deferred but the known ones","proof":"dmesg-clean","proof_kind":"host-check","helper":null,"component":null,"guide":"walleye z7: the GPU smmu off cleared the gpu_gx WARNs (walleye-dmesg-clean); on a rootfs the suite's no-oops and boot-warnings carry it.","sources":null,"checked_on":"2026-11-18"} +{"id":"pmic-bound","title":"The PMIC bound","stage":"power","ord":1,"applies":"any","done_when":"the PMIC's children bind on their bus, the RTC and the power-on reason read","proof":"pmic-bound","proof_kind":"host-check","helper":null,"component":null,"guide":"walleye: pm8998 and pmi8998 on SPMI (walleye-pmic-spmi, proven in z7). UFS rails are RPM regulators and do not wait for it (walleye-bringup-order-plan).","sources":null,"checked_on":"2026-11-18"} +{"id":"charger-online","title":"The charger online","stage":"power","ord":2,"applies":"power:battery","done_when":"a power_supply of type USB appears, online follows the cable, and the voltage rises while connected","proof":"charger-online","proof_kind":"host-check","helper":null,"component":null,"guide":"Until it works, tries are rationed by the battery. walleye c2: the charger defers on its tps61099 supplier (walleye-charger-wait-tps61099, walleye-charger-supplier).","sources":null,"checked_on":"2026-11-18"} +{"id":"watchdog-way-back","title":"A hung kernel comes back by itself","stage":"power","ord":3,"applies":"any","done_when":"a hung kernel resets by itself and the phone returns to a known system without hands","proof":"way-back","proof_kind":"host-check","helper":null,"component":null,"guide":"surya: qcom_wdt kept armed through sleep (way-back.sh). walleye: the PMIC watchdog (walleye-pmic-wdt-proof).","sources":null,"checked_on":"2026-11-18"} +{"id":"storage-readonly","title":"Internal storage read-only","stage":"storage","ord":1,"applies":"any","done_when":"the internal storage lists its partitions by name, nothing written","proof":"storage-lists","proof_kind":"host-check","helper":null,"component":null,"guide":"Gives the firmware partitions every later part needs (walleye-ufs-readonly).","sources":null,"checked_on":"2026-11-18"} +{"id":"usb-network","title":"Network over USB","stage":"userspace","ord":1,"applies":"usb:gadget","done_when":"ssh over the USB gadget's network answers","proof":"gadget-up","proof_kind":"host-check","helper":null,"component":null,"guide":"walleye: walleye-usb-net. surya had the distribution's own gadget.","sources":null,"checked_on":"2026-11-18"} +{"id":"rootfs-boots","title":"A distribution root boots","stage":"userspace","ord":2,"applies":"any","done_when":"a distribution's root filesystem boots to its init and ssh answers","proof":"rootfs-ssh","proof_kind":"host-check","helper":"lpoco lab flash, provision","component":null,"guide":"surya boots Nura through U-Boot, systemd-boot and an EFI kernel (first-fastboot-probe).","sources":null,"checked_on":"2026-11-18"} +{"id":"health-suite-runs","title":"The health suite runs after every boot","stage":"userspace","ord":3,"applies":"any","done_when":"the phone's own suite runs after every boot and its run is filed in the device's base","proof":"suite-filed","proof_kind":"phone-suite","helper":"lpoco lab suite put, run","component":null,"guide":"From here a part's status is measured, not judged (surya 2026-11-17-health-on-the-phone).","sources":null,"checked_on":"2026-11-18"} diff --git a/docs/backlog.md b/docs/backlog.md index 6049bb66..605e6761 100644 --- a/docs/backlog.md +++ b/docs/backlog.md @@ -4578,10 +4578,10 @@ Project : linux-phone-oco/docs Status -: open +: done Note -: sh research/bringup-steps/2026-11-18/seed.sh in docs, through the records +: Landed: 8 stages, 26 steps and 37 edges recorded through ikb bringup-stage, bringup-step and bringup-edge (research/bringup-steps/2026-11-18/seed.sh, rerunnable). tad q bringup-chain lists 26 steps in order: stock-measured, stock-facts-read, slot-state-known and initramfs-gadget-emulated at depth 0, bootloader-unlocked at 1 (a soft need on stock-measured: an unlock may wipe the stock system), health-suite-runs last at 12; every status unknown until a base claims. Stages are rows of bringup_stages (prepare, boot, console, kernel, power, storage, userspace, lab), the draft awaiting the author's word: change them with ikb bringup-stage, no schema change. tad check passes; make verify twice clean. Opened : 2026-11-18 diff --git a/docs/bringup_stages.md b/docs/bringup_stages.md index 1b1036b9..b800f073 100644 --- a/docs/bringup_stages.md +++ b/docs/bringup_stages.md @@ -1,3 +1,82 @@ # Bringup Stages + + +### Prepare + +Ord +: 1 + +What +: Read what the machine is and what it allows before anything is changed: the stock system, the boot facts, the way back. + + + +### Boot + +Ord +: 2 + +What +: Get an image of ours accepted by the bootloader and run, one part swapped at a time, until it is known what refuses it. + + + +### Console + +Ord +: 3 + +What +: A window onto the running kernel: a banner, a shell, over UART or the USB gadget. + + + +### Kernel + +Ord +: 4 + +What +: Our kernel builds, reaches its init and says nothing worse than it should. + + + +### Power + +Ord +: 5 + +What +: The PMIC, the charger and the watchdog: what keeps the machine alive and safe to leave running. + + + +### Storage + +Ord +: 6 + +What +: Internal storage seen, first read-only. + + + +### Userspace + +Ord +: 7 + +What +: A distribution's root boots, the network is up and the health suite runs on every boot. + + + +### Lab + +Ord +: 8 + +What +: What the lab needs of a machine to work on it without hands: the ways in, a try that cannot brick. diff --git a/docs/bringup_step_edges.md b/docs/bringup_step_edges.md index 40811b10..20207561 100644 --- a/docs/bringup_step_edges.md +++ b/docs/bringup_step_edges.md @@ -1,3 +1,563 @@ # Bringup Step Edges + +### Row 1 + +Step +: bootloader-unlocked + +Requires +: stock-measured + +Kind +: soft + +Why +: an unlock may wipe the stock system + + +### Row 2 + +Step +: control-image-boots + +Requires +: bootloader-unlocked + +Kind +: hard + +Why +: fastboot boot needs an unlocked bootloader + + +### Row 3 + +Step +: control-image-boots + +Requires +: slot-state-known + +Kind +: hard + +Why +: walleye: refusals were the slot state (walleye-load-error-first-state) + + +### Row 4 + +Step +: boot-image-packs + +Requires +: stock-facts-read + +Kind +: hard + +Why +: the header and offsets are the stock image's + + +### Row 5 + +Step +: kernel-builds + +Requires +: stock-facts-read + +Kind +: soft + +Why +: the dtb ids the bootloader matches + + +### Row 6 + +Step +: dtbo-accepted + +Requires +: kernel-builds + +Kind +: hard + +Why +: it is our dtb that must merge + + +### Row 7 + +Step +: stock-kernel-runs-our-init + +Requires +: control-image-boots + +Kind +: hard + +Why +: the control is the image swapped into + + +### Row 8 + +Step +: stock-kernel-runs-our-init + +Requires +: boot-image-packs + +Kind +: hard + +Why +: the swap repacks + + +### Row 9 + +Step +: stock-kernel-runs-our-init + +Requires +: initramfs-gadget-emulated + +Kind +: soft + +Why +: an init proven emulated spends no phone time + + +### Row 10 + +Step +: crash-window + +Requires +: stock-facts-read + +Kind +: soft + +Why +: the ramoops region is the stock fdt's + + +### Row 11 + +Step +: reference-kernel-boots + +Requires +: control-image-boots + +Kind +: hard + +Why +: same bootloader path + + +### Row 12 + +Step +: reference-kernel-boots + +Requires +: boot-image-packs + +Kind +: hard + +Why +: packed the device's way + + +### Row 13 + +Step +: kernel-reaches-init + +Requires +: kernel-builds + +Kind +: hard + +Why +: it is our kernel + + +### Row 14 + +Step +: kernel-reaches-init + +Requires +: boot-image-packs + +Kind +: hard + +Why +: packed the device's way + + +### Row 15 + +Step +: kernel-reaches-init + +Requires +: control-image-boots + +Kind +: hard + +Why +: the bootloader accepts images + + +### Row 16 + +Step +: kernel-reaches-init + +Requires +: dtbo-accepted + +Kind +: hard + +Why +: walleye: no start without the merge (walleye-dtbo-overlay-merge-why) + + +### Row 17 + +Step +: kernel-reaches-init + +Requires +: crash-window + +Kind +: soft + +Why +: without one a dead kernel says nothing + + +### Row 18 + +Step +: kernel-reaches-init + +Requires +: reference-kernel-boots + +Kind +: soft + +Why +: the bisect reference + + +### Row 19 + +Step +: uart-console + +Requires +: kernel-builds + +Kind +: hard + +Why +: it is our kernel's log + + +### Row 20 + +Step +: gadget-enumerates + +Requires +: kernel-reaches-init + +Kind +: hard + +Why +: our kernel's gadget + + +### Row 21 + +Step +: gadget-enumerates + +Requires +: initramfs-gadget-emulated + +Kind +: hard + +Why +: the init makes the gadget + + +### Row 22 + +Step +: banner-on-console + +Requires +: gadget-enumerates + +Kind +: hard + +Group +: console + +Why +: the console over the gadget + + +### Row 23 + +Step +: banner-on-console + +Requires +: uart-console + +Kind +: hard + +Group +: console + +Why +: or over UART + + +### Row 24 + +Step +: shell-on-console + +Requires +: banner-on-console + +Kind +: hard + +Why +: a console that carries text first + + +### Row 25 + +Step +: first-dmesg-mapped + +Requires +: shell-on-console + +Kind +: hard + +Why +: dmesg is read through the shell + + +### Row 26 + +Step +: dmesg-clean + +Requires +: first-dmesg-mapped + +Kind +: hard + +Why +: the map names what to clean + + +### Row 27 + +Step +: pmic-bound + +Requires +: shell-on-console + +Kind +: hard + +Why +: read through the shell + + +### Row 28 + +Step +: pmic-bound + +Requires +: first-dmesg-mapped + +Kind +: soft + +Why +: the map names the PMIC's faults + + +### Row 29 + +Step +: charger-online + +Requires +: pmic-bound + +Kind +: hard + +Why +: the charger is a PMIC child + + +### Row 30 + +Step +: watchdog-way-back + +Requires +: kernel-reaches-init + +Kind +: hard + +Why +: it is our kernel that hangs + + +### Row 31 + +Step +: watchdog-way-back + +Requires +: pmic-bound + +Kind +: soft + +Why +: walleye's way is the PMIC watchdog + + +### Row 32 + +Step +: storage-readonly + +Requires +: shell-on-console + +Kind +: hard + +Why +: read through the shell + + +### Row 33 + +Step +: storage-readonly + +Requires +: dmesg-clean + +Kind +: soft + +Why +: smmu and supplier faults stop DMA devices + + +### Row 34 + +Step +: usb-network + +Requires +: gadget-enumerates + +Kind +: hard + +Why +: the network rides the gadget + + +### Row 35 + +Step +: rootfs-boots + +Requires +: storage-readonly + +Kind +: hard + +Why +: the root is on the storage + + +### Row 36 + +Step +: rootfs-boots + +Requires +: usb-network + +Kind +: hard + +Why +: ssh is the proof + + +### Row 37 + +Step +: health-suite-runs + +Requires +: rootfs-boots + +Kind +: hard + +Why +: the suite runs on the root diff --git a/docs/bringup_steps.md b/docs/bringup_steps.md index 62842ba9..74b8d116 100644 --- a/docs/bringup_steps.md +++ b/docs/bringup_steps.md @@ -1,3 +1,763 @@ # Bringup Steps + + +### Bootloader unlocked + +Stage +: prepare + +Ord +: 1 + +Applies +: boot:android + +Done when +: fastboot getvar all says unlocked: yes + +Proof +: fastboot-unlocked + +Proof kind +: host-check + +Helper +: lpoco lab fastboot getvar + +Guide +: Unlocking wipes the user's data and is the owner's act. Read the state before anything else (walleye google-walleye-bootloader-first-look, surya first-fastboot-probe). + +Checked on +: 2026-11-18 + + + +### The stock system measured + +Stage +: prepare + +Ord +: 2 + +Applies +: any + +Done when +: what works on the stock system, its battery and its partitions are recorded as the reference + +Proof +: android-reference + +Proof kind +: research + +Guide +: Measure the stock system before anything is flashed: it is the reference 'as good as Android' is judged by, and an unlock may wipe it (walleye android-reference-walleye-measured). + +Checked on +: 2026-11-18 + + + +### The stock boot's facts read + +Stage +: prepare + +Ord +: 3 + +Applies +: any + +Done when +: the stock cmdline, boot header and offsets, dtb ids (msm-id, board-id), running fdt and ramoops region are recorded + +Proof +: stock-facts-recorded + +Proof kind +: research + +Helper +: lpoco bringup image info + +Guide +: Read them from the running stock system and its boot image (walleye walleye-stock-ids-recorded, walleye-boot-cmdline-known). The running fdt is worth keeping whole: on walleye it named the cause of the dead dtbs (walleye-our-dts-gpio-reserved). + +Checked on +: 2026-11-18 + + + +### Slots read, a way back known + +Stage +: prepare + +Ord +: 4 + +Applies +: boot:android-ab + +Done when +: both slots' flags are reported before and after every try, and the phone returns to the stock system by itself + +Proof +: slot-report + +Proof kind +: host-check + +Helper +: lpoco lab fastboot state + +Guide +: On walleye the Load Error was the slot state left by refusals, not the image: restore the first state (Android booted to completion on a good slot) before each try (walleye-load-error-first-state). + +Checked on +: 2026-11-18 + + + +### A known-good image boots from memory + +Stage +: boot + +Ord +: 1 + +Applies +: boot:android + +Done when +: fastboot boot of a known-good stock-format image leaves fastboot and runs, nothing written + +Proof +: fastboot-boot-control + +Proof kind +: host-check + +Helper +: lpoco lab fastboot boot + +Guide +: The control tells 'the bootloader refuses' from 'our image is wrong' (walleye walleye-loaderror-control). + +Checked on +: 2026-11-18 + + + +### Our boot image packs as the device wants + +Stage +: boot + +Ord +: 2 + +Applies +: boot:android + +Done when +: header version, offsets, page size, dtb placement and os word match the control where they should + +Proof +: bringup-pack-matches-mkbootimg + +Proof kind +: build-check + +Helper +: lpoco bringup image pack, check + +Guide +: Pack from the device's [boot] declaration and count it against the control (walleye walleye-bootimage). The helper packs header v0 only. + +Checked on +: 2026-11-18 + + + +### The bootloader's dtbo overlay accepted + +Stage +: boot + +Ord +: 3 + +Applies +: boot:android-dtbo + +Done when +: our dtb, built with -@ and the overlay's labels, merges with the stock dtbo, or the bootloader does not need it + +Proof +: dtbo-overlay-merges + +Proof kind +: build-check + +Guide +: On walleye our dtb with -@ and the 137 labels merged; the dtbo stub that was planned was never needed (walleye-dtb-overlay-symbols-build, walleye-loaderror-dtbo-stub). + +Checked on +: 2026-11-18 + + + +### Our initramfs brings the gadget up, emulated + +Stage +: boot + +Ord +: 4 + +Applies +: usb:gadget + +Done when +: in QEMU with dummy_hcd our initramfs makes the gadget (ACM console and a window) and the host side sees it + +Proof +: selftest-initramfs + +Proof kind +: build-check + +Helper +: lpoco bringup initramfs build + +Guide +: Prove the init before any phone time (walleye walleye-initramfs-usb-gadget). The generic init under lpoco is backlog bringup-generic-init. + +Checked on +: 2026-11-18 + + + +### The stock kernel runs our init + +Stage +: boot + +Ord +: 5 + +Applies +: boot:android + +Done when +: the stock kernel with only our ramdisk swapped runs our /init, and it shows (a gadget, a mass-storage window) + +Proof +: massstorage-window-read + +Proof kind +: host-check + +Helper +: lpoco bringup image swap + +Guide +: Proves the image path apart from our kernel. On walleye the NCM function panics the vendor 4.4 kernel; a mass-storage window works (walleye-ncm-split, walleye-massstorage-window). + +Checked on +: 2026-11-18 + + + +### A window on a dead boot + +Stage +: boot + +Ord +: 6 + +Applies +: any + +Done when +: a dead or hung boot leaves something the host reads: UART, pstore at the phone's own ramoops region, or a timing channel + +Proof +: crash-window-read + +Proof kind +: host-check + +Guide +: On walleye ramoops survives only at the region the stock fdt names and only across a warm reset (walleye-pstore-warm-reset, walleye-pstore-t1-try); a timing channel told alive from dead (walleye-ml4-timing-channel); UART waits a cable (walleye-get-uart-setup). + +Checked on +: 2026-11-18 + + + +### Our kernel and dts build + +Stage +: kernel + +Ord +: 1 + +Applies +: any + +Done when +: the mainline kernel and the device's dts build with no dtc warning from our file, and the dtb carries the ids the bootloader matches + +Proof +: dtb-builds-with-ids + +Proof kind +: build-check + +Guide +: Start from the nearest sibling's dts in mainline (walleye from taimen, walleye-kernel-dts). + +Checked on +: 2026-11-18 + + + +### Someone else's mainline kernel boots here + +Stage +: kernel + +Ord +: 2 + +Applies +: any + +Done when +: another project's mainline kernel and dtb for this device or a sibling reach their init on this phone + +Proof +: reference-alive + +Proof kind +: host-check + +Helper +: lpoco bringup image bisect + +Guide +: The reference to bisect against when ours is dead: swap one part at a time (walleye pk5 alive against ours dead: walleye-bisect-porthole-vs-ours, walleye-our-dtb-bisect, walleye-property-bisect). + +Checked on +: 2026-11-18 + + + +### Our kernel reaches our init + +Stage +: kernel + +Ord +: 3 + +Applies +: any + +Done when +: our kernel and our dtb reach /init: the phone stays up as long as /init says, with no early reset + +Proof +: kernel-alive + +Proof kind +: host-check + +Helper +: lpoco bringup image bisect + +Guide +: Two traps on walleye: earlycon on an undeclared UART kills the kernel (walleye-no-earlycon); a pinctrl node without gpio-reserved-ranges touches the secure world's pins and resets the phone (walleye-our-dts-gpio-reserved). + +Checked on +: 2026-11-18 + + + +### Kernel log on UART + +Stage +: console + +Ord +: 1 + +Applies +: any + +Done when +: the kernel's log reaches the host over the debug UART + +Proof +: uart-log + +Proof kind +: host-check + +Guide +: Needs the device's debug cable or pads; on walleye it waits the cable (walleye-get-uart-setup), so the USB gadget was the console. + +Checked on +: 2026-11-18 + + + +### The host sees our gadget + +Stage +: console + +Ord +: 2 + +Applies +: usb:gadget + +Done when +: the host enumerates our own kernel's gadget by its vendor:product and serial + +Proof +: gadget-enumerates + +Proof kind +: host-check + +Guide +: walleye y2: 1d6b:0104 18 s after the jump (walleye-try-y). + +Checked on +: 2026-11-18 + + + +### The banner on the console + +Stage +: console + +Ord +: 3 + +Applies +: any + +Done when +: /init's banner with a heartbeat reaches the host on the console, read as the lab user + +Proof +: banner-seen + +Proof kind +: host-check + +Guide +: The gadget serial must be the one the host's udev rule names, or the tty is root's (walleye-banner-serial-fix, walleye-try-banner2). + +Checked on +: 2026-11-18 + + + +### A shell answers on the console + +Stage +: console + +Ord +: 4 + +Applies +: any + +Done when +: commands sent on the console answer, one at a time, reliably across hangups + +Proof +: shell-answers + +Proof kind +: host-check + +Guide +: On walleye an interactive ash stayed silent; a plain read/exec loop and the host tty raw and -hupcl made it answer (walleye-shell-reliable, walleye-command-loop, walleye-try-z6). + +Checked on +: 2026-11-18 + + + +### The first dmesg mapped + +Stage +: kernel + +Ord +: 4 + +Applies +: any + +Done when +: the first full dmesg of our kernel is read and every line placed: works, defers, fails, and whose + +Proof +: dmesg-map + +Proof kind +: research + +Guide +: The map orders what follows (walleye-z6-dmesg-map, research walleye-bringup-order-plan). + +Checked on +: 2026-11-18 + + + +### dmesg clean + +Stage +: kernel + +Ord +: 5 + +Applies +: any + +Done when +: no WARN, oops or -110, and no probe deferred but the known ones + +Proof +: dmesg-clean + +Proof kind +: host-check + +Guide +: walleye z7: the GPU smmu off cleared the gpu_gx WARNs (walleye-dmesg-clean); on a rootfs the suite's no-oops and boot-warnings carry it. + +Checked on +: 2026-11-18 + + + +### The PMIC bound + +Stage +: power + +Ord +: 1 + +Applies +: any + +Done when +: the PMIC's children bind on their bus, the RTC and the power-on reason read + +Proof +: pmic-bound + +Proof kind +: host-check + +Guide +: walleye: pm8998 and pmi8998 on SPMI (walleye-pmic-spmi, proven in z7). UFS rails are RPM regulators and do not wait for it (walleye-bringup-order-plan). + +Checked on +: 2026-11-18 + + + +### The charger online + +Stage +: power + +Ord +: 2 + +Applies +: power:battery + +Done when +: a power_supply of type USB appears, online follows the cable, and the voltage rises while connected + +Proof +: charger-online + +Proof kind +: host-check + +Guide +: Until it works, tries are rationed by the battery. walleye c2: the charger defers on its tps61099 supplier (walleye-charger-wait-tps61099, walleye-charger-supplier). + +Checked on +: 2026-11-18 + + + +### A hung kernel comes back by itself + +Stage +: power + +Ord +: 3 + +Applies +: any + +Done when +: a hung kernel resets by itself and the phone returns to a known system without hands + +Proof +: way-back + +Proof kind +: host-check + +Guide +: surya: qcom_wdt kept armed through sleep (way-back.sh). walleye: the PMIC watchdog (walleye-pmic-wdt-proof). + +Checked on +: 2026-11-18 + + + +### Internal storage read-only + +Stage +: storage + +Ord +: 1 + +Applies +: any + +Done when +: the internal storage lists its partitions by name, nothing written + +Proof +: storage-lists + +Proof kind +: host-check + +Guide +: Gives the firmware partitions every later part needs (walleye-ufs-readonly). + +Checked on +: 2026-11-18 + + + +### Network over USB + +Stage +: userspace + +Ord +: 1 + +Applies +: usb:gadget + +Done when +: ssh over the USB gadget's network answers + +Proof +: gadget-up + +Proof kind +: host-check + +Guide +: walleye: walleye-usb-net. surya had the distribution's own gadget. + +Checked on +: 2026-11-18 + + + +### A distribution root boots + +Stage +: userspace + +Ord +: 2 + +Applies +: any + +Done when +: a distribution's root filesystem boots to its init and ssh answers + +Proof +: rootfs-ssh + +Proof kind +: host-check + +Helper +: lpoco lab flash, provision + +Guide +: surya boots Nura through U-Boot, systemd-boot and an EFI kernel (first-fastboot-probe). + +Checked on +: 2026-11-18 + + + +### The health suite runs after every boot + +Stage +: userspace + +Ord +: 3 + +Applies +: any + +Done when +: the phone's own suite runs after every boot and its run is filed in the device's base + +Proof +: suite-filed + +Proof kind +: phone-suite + +Helper +: lpoco lab suite put, run + +Guide +: From here a part's status is measured, not judged (surya 2026-11-17-health-on-the-phone). + +Checked on +: 2026-11-18 diff --git a/docs/index.md b/docs/index.md index 237a081c..0f447008 100644 --- a/docs/index.md +++ b/docs/index.md @@ -5,9 +5,9 @@ The memory of linux-phone-oco, whose goal is Linux phones as good as Android for everyday use, and better: which phone supports which hardware, how we know, why decisions were made, and what is next. Plain versioned data; see AGENTS.md. The plan, and where Linux phones stand against Android and iOS: [the grand picture](picture.md), and the main screen, [features against Android and iOS](feature_support.md). - [Backlog](backlog.md): 194 -- [Bringup Stages](bringup_stages.md): 0 -- [Bringup Step Edges](bringup_step_edges.md): 0 -- [Bringup Steps](bringup_steps.md): 0 +- [Bringup Stages](bringup_stages.md): 8 +- [Bringup Step Edges](bringup_step_edges.md): 37 +- [Bringup Steps](bringup_steps.md): 26 - [Components](components.md): 21 - [Concepts](concepts.md): 10 - [Decisions](decisions.md): 72 diff --git a/research/bringup-steps/2026-11-18/seed.sh b/research/bringup-steps/2026-11-18/seed.sh index e5ec2c24..6e401ec1 100755 --- a/research/bringup-steps/2026-11-18/seed.sh +++ b/research/bringup-steps/2026-11-18/seed.sh @@ -1,10 +1,21 @@ #!/bin/sh -# Seeds the generic bring-up steps and their edges through the records (decision -# 2026-11-18-bringup-steps-generic-in-docs-status-in-each-base). Run in docs once records/bringup-step.sql and -# records/bringup-edge.sql exist. The steps are walleye's real chain generalised; surya's path checked them. +# Seeds the stages, the generic bring-up steps and their edges through the records (ikb; decision +# 2026-11-18-bringup-steps-generic-in-docs-status-in-each-base). Run in docs; the records are bringup-stage, +# bringup-step and bringup-edge. The steps are walleye's real chain generalised; surya's path checked them. +# The stage list is the draft's and waits the author's word: stages are rows, changed with ikb bringup-stage. set -eu -st() { tad r bringup-step --checked-on 2026-11-18 "$@" >/dev/null; } -ed() { tad r bringup-edge "$@" >/dev/null; } +st() { ikb bringup-step --checked-on 2026-11-18 "$@" >/dev/null; } +ed() { ikb bringup-edge "$@" >/dev/null; } +sg() { ikb bringup-stage "$@" >/dev/null; } + +sg --id prepare --ord 1 --title "Prepare" --what "Read what the machine is and what it allows before anything is changed: the stock system, the boot facts, the way back." +sg --id boot --ord 2 --title "Boot" --what "Get an image of ours accepted by the bootloader and run, one part swapped at a time, until it is known what refuses it." +sg --id console --ord 3 --title "Console" --what "A window onto the running kernel: a banner, a shell, over UART or the USB gadget." +sg --id kernel --ord 4 --title "Kernel" --what "Our kernel builds, reaches its init and says nothing worse than it should." +sg --id power --ord 5 --title "Power" --what "The PMIC, the charger and the watchdog: what keeps the machine alive and safe to leave running." +sg --id storage --ord 6 --title "Storage" --what "Internal storage seen, first read-only." +sg --id userspace --ord 7 --title "Userspace" --what "A distribution's root boots, the network is up and the health suite runs on every boot." +sg --id lab --ord 8 --title "Lab" --what "What the lab needs of a machine to work on it without hands: the ways in, a try that cannot brick." st --id bootloader-unlocked --title "Bootloader unlocked" --stage prepare --ord 1 --applies boot:android \ --done-when "fastboot getvar all says unlocked: yes" --proof fastboot-unlocked --proof-kind host-check \