docs(plan): deferred-with-docs table for X670E

2026-08-05 07:50:38 +03:00
parent 4f5588aeec
commit 56a414422c
2 changed files with 56 additions and 1 deletions
@@ -0,0 +1,47 @@
+# Task 39 Evidence — Deferred-with-docs table for Ryzen 7000 / X670E
+
+**Todo:** `.omo/plans/ryzen-7000-x670e-compat.md` todo 39  
+**Target doc:** `local/docs/RYZEN-7000-X670E-COMPATIBILITY-PLAN.md` §7.1  
+**Pattern reference:** `local/docs/LG-GRAM-16Z90TP-COMPATIBILITY-PLAN.md` §9.6  
+**Completed:** 2026-08-05
+
+## What changed
+
+Replaced the §7.1 placeholder row with a complete "permanent no-driver (for now)" table
+containing every deferred device, a one-line reason, and a concrete unblock condition.
+
+## Table rows (9 data rows)
+
+| # | Device |
+|---|--------|
+| 1 | TPM2 CRB (`MSFT0101`) |
+| 2 | sp5100_tco watchdog |
+| 3 | AMD PSP [1022:1649] |
+| 4 | MSI Mystic Light [1462:7d70], MEG AIO [0db0:6a05], Nuvoton [0db0:9ba6] |
+| 5 | USB Audio UAC 2.0 [0db0:d6e7] |
+| 6 | Multi-segment `Segment:BDF` identity |
+| 7 | Suspend/S3 |
+| 8 | NVIDIA RTX 4080 [10de:2704] |
+| 9 | HDMI audio via Raphael iGPU |
+
+## Verification
+
+- Row count in table section: 9 data rows (≥ 8 required).
+- `grep -c '|'` over the §7.1 table block: each data row contributes 4 pipe characters;
+  header + separator + 9 rows = 44 pipe characters in the block.
+- Every row has a non-empty `Reason` and `What would unblock` cell.
+- No device from the deferred inventory was dropped.
+- No TODO-without-reason rows remain.
+- No other part of the document was edited.
+
+## Sources consulted
+
+- Todo 39 text (`.omo/plans/ryzen-7000-x670e-compat.md` lines 441–446).
+- LG Gram §9.6 table pattern (`local/docs/LG-GRAM-16Z90TP-COMPATIBILITY-PLAN.md` lines 514–525).
+- Host evidence index (`local/docs/evidence/ryzen-x670e/README.md`) and `lspci.txt` for PSP/sp5100_tco.
+- `redbear-usbaudiod` source (`recipes/system/redbear-usbaudiod/source/src/main.rs`) for exact UAC1 assumptions.
+- Todo 17 text for the MCFG segment conditional.
+
+## Result
+
+`local/docs/RYZEN-7000-X670E-COMPATIBILITY-PLAN.md` §7.1 now contains the completed deferred-with-docs table.
@@ -423,4 +423,12 @@ bare-metal afterward.

 | Device | Reason | What would unblock |
 |---|---|---|
-| *(todo 39 fills rows during execution)* | | |
+| TPM2 CRB (`MSFT0101`) | No measured-boot/attestation consumer exists in Red Bear OS | A secure-boot or remote-attestation stack that consumes PCR quotes and needs the CRB command/response protocol |
+| sp5100_tco watchdog | No watchdog consumer today; init does not expect a hardware watchdog | A userspace watchdog daemon or init integration that services the FCH TCO timer |
+| AMD PSP [1022:1649] | No crypto consumer (no kernel keyring, no disk-encryption, no firmware TPM) | A Red Bear subsystem that needs CCP/SEV/PSP crypto services or firmware TPM via PSP |
+| MSI Mystic Light [1462:7d70], MEG AIO [0db0:6a05], Nuvoton [0db0:9ba6] | Vendor-protocol USB HID devices; RGB/AIO control is vendor-software domain, not a first-class OS driver | A policy decision to carry and maintain vendor-specific HID protocols (e.g. for LED control) |
+| USB Audio UAC 2.0 [0db0:d6e7] | `redbear-usbaudiod` is UAC 1.0 only: it hardcodes UAC1 class-specific descriptor subtypes (`AUDIO_CS_INTERFACE = 0x24` with `AC_HEADER/INPUT_TERMINAL/OUTPUT_TERMINAL/FEATURE_UNIT/AS_GENERAL/FORMAT_TYPE`), assumes `bInterfaceProtocol = 0x00`, uses max-packet-size heuristics instead of parsing `FORMAT_TYPE` descriptors, and only supports 8/16-bit PCM at ≤48 kHz with 1–2 channels; UAC2 adds Clock Source/Selector/Multiplier entities, high-capability sample rates, and alternate channel-cluster descriptors | A UAC 2.0 parser in `redbear-usbaudiod` (or a new `redbear-usbaudiod-uac2`) that handles clock entities, `bInterfaceProtocol = 0x20`, and high-capability AS format descriptors |
+| Multi-segment `Segment:BDF` identity | Deferred **pending todo-17 MCFG confirmation**; single-socket desktop platforms are expected to be segment 0 only, and making identity segment-aware is an end-to-end change across pcid, driver-manager, pcid-interface, and IOMMU — not a local patch | Todo-17 evidence showing a non-zero MCFG segment on this board, plus an end-to-end identity refactor |
+| Suspend/S3 | Desktop target policy: S5 (shutdown) only; sleep states are tracked in `ACPI-IMPROVEMENT-PLAN` | A platform-wide suspend/resume design in `ACPI-IMPROVEMENT-PLAN` with driver suspend callbacks |
+| NVIDIA RTX 4080 [10de:2704] | Explicitly operator-excluded — no nouveau/NVK work of any kind | Operator policy change to allow NVIDIA GPU enablement |
+| HDMI audio via Raphael iGPU | Separate display audio function; out of scope for the AMD HDA (`ihdad`) widening in todo 35 | A dedicated display-audio driver or integration path once the iGPU DRM/KMS display path is proven |