Files
RedBear-OS/local/docs
vasilito 48dfbc5ffc docs: add Phase II Architecture section to SLEEP-IMPLEMENTATION-PLAN
Documents the full S3 state machine, modeled after
Linux 7.1's `arch/x86/kernel/acpi/wakeup_64.S` and
`arch/x86/kernel/acpi/sleep.c`. The S3 round-trip
is now fully wired:

1. acpid's enter_sleep_state(3) does the AML prep
   (\\_TTS(3), \\_PTS(3), \\_SST(3))
2. acpid's kstop_enter_s3(0) writes the kernel's
   s3_trampoline address to FACS.xfirmware_waking_vector
   via the new SetS3WakingVector AcPiVerb
3. acpid writes 's3<SLP_TYP>' to /scheme/sys/kstop
4. kernel stop::enter_s3 reads S3_SLP_TYP, writes
   SLP_TYP|SLP_EN to PM1a_CNT
5. firmware enters S3
6. on wake, firmware jumps to FACS.waking_vector
   (the s3_trampoline)
7. kernel s3_trampoline restores state, jumps to
   kmain_resume_from_s3
8. acpid receives kstop_reason=3, runs the standard
   S3 wake AML sequence (\\_SST(2) -> \\_WAK(3) ->
   \\_SST(1))

Hardware-agnostic: works on any x86_64 system with
standard ACPI S3 support (Dell, HP, Lenovo, LG Gram 14).

The status table at the top of this file is also updated
to reflect the latest Phase II.X.W completion and the
Phase K deferral (submodule conversion of remaining local
sources).
2026-07-01 17:13:55 +03:00
..