Skip to content

docs: Fast restart bring-up knowledge from the warm-restart PRs - #141

Merged
henrikklee merged 1 commit into
mainfrom
fast-restart-doc
Nov 15, 2026
Merged

henrikklee merged 1 commit into
mainfrom
fast-restart-doc

Conversation

@henrikklee

Copy link
Copy Markdown
Contributor

Adds docs/bring-up/fast-restart.md: what Berkay Kösebay found and built for warm restart on the iPad 5 (J71t), Linux to Linux through kexec without DFU and a host, so the feature can be rebuilt later without reading the PR history.

Per subsystem it records the mechanism, the measurements and what stayed open: resident EL3 PSCI in m1n1, ANS NVMe hand-over, GPIO/SPI/touch quiesce, watchdog reset guard, GPU and VXD stops, retained AOP reload, display and device-tree state across kexec, and the userspace trigger. It also covers which chips the design can apply to, the review points, and a table of every PR, commit and tag.

Source PRs (content is Berkay's; the commit carries him as author): orchard #102, #105, #106, #107, #116, #125 (hand-over parts), #117 (restart parts); omarchy-a #38, #43.

Branch heads are kept as tags: contrib/brkosebay-j71t-psci, -warm-storage, -warm-peripherals, -warm-kernel, -reset-guard, -gpu-handover (orchard) and contrib/brkosebay-j71t-warm-restart, -warm-restart-shared (omarchy-a).

Documentation only; nothing was run again.

Berkay Kösebay built a warm restart for the iPad 5 (J71t): Restart goes
from Linux straight into Linux through kexec, without DFU and a host.
On 2026-11-12 it ran 20+ times without a freeze, back up in 7 to 30
seconds. The PRs are not merged; this page keeps what they found so the
feature can be rebuilt without reading their history.

It records, per subsystem, the mechanism, the measurements and what
stayed open: the resident EL3 PSCI in m1n1 (A7 to A9 only), the ANS
NVMe hand-over behind the S8003 PCIe port, the GPIO, SPI and touch
quiesce, the watchdog reset guard, the GPU and VXD stops, the retained
AOP reload, the display and device-tree state carried across kexec, and
the userspace trigger. It also lists which chips the design can apply
to, the points raised in review, and every PR, commit and tag.

Provenance: the content is Berkay Kösebay's work from orchard #102,
#105, #106, #107, #116, #125 (hand-over parts) and #117 (restart
parts), and omarchy-a #38 and #43. The branch heads are kept as tags
contrib/brkosebay-j71t-{psci,warm-storage,warm-peripherals,warm-kernel,
reset-guard,gpu-handover} in orchard and
contrib/brkosebay-j71t-{warm-restart,warm-restart-shared} in omarchy-a.
Written up from the PRs; nothing here was run again.

Assisted-by: LLM
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants