Files
RedBear-OS/local/docs
vasilito b56b810c07 quirks: implement R7-R9 — xHCI closure, PciQuirkPhase, USB storage resync
Phase R7 (xHCI closure, multi-session R7-R10 first commit):

* R7-A xHCI TOML layer: brings xHCI to 3-layer parity with PCI
  (compiled-in + TOML + DMI). Adds XHCI_CONTROLLER_FLAG_NAMES (28
  entries: 19 pre-R6 + 5 R6 + 3 R7-C with chronological markers),
  read_toml_xhci_entries(), parse_xhci_toml(),
  load_xhci_controller_quirks_toml(), updated
  lookup_xhci_controller_quirks() to OR TOML flags, new
  lookup_xhci_controller_quirks_full() as 3-layer entry point.
  New quirks.d/25-xhci.toml with 8 example entries sourced from
  Linux 7.1 xhci-pci.c.

* R7-B DMI xHCI bridge: mirrors the PCI DMI bridge. Linux itself
  has no DMI-based xHCI quirks so DMI_XHCI_QUIRK_RULES is empty;
  the wiring exists so future DMI rules can be added without
  re-architecting. Adds DmiXhciQuirkRule struct,
  apply_dmi_xhci_quirk_rules() OR-accumulator, DMI_XHCI_QUIRK_RULES
  constant, load_dmi_xhci_quirks() public function,
  read_toml_dmi_xhci_toml()/parse_dmi_xhci_toml() in toml_loader
  for the new [[dmi_xhci_system_quirk]] section.

* R7-C 3 high-priority xHCI flags (already in 0.2.3 branch from
  R7-C stand-alone commit): DEFAULT_PM_RUNTIME_ALLOW (bit 33),
  SNPS_BROKEN_SUSPEND (bit 35), RESET_TO_DEFAULT (bit 44). Bit
  positions match Linux 7.1 xhci.h:1586-1660 exactly. Six new
  PCI entries: AMD 0x43f7, 0x15e0, 0x15e1, Intel 0x9a13/0x51e0/0x54ee.
  Seven new R7-C tests.

Phase R8 (PciQuirkPhase data structure, no PM consumers):

* PciQuirkPhase enum: Header, Final, Enable, Resume, ResumeEarly.
  Mirrors Linux DECLARE_PCI_FIXUP_* macro family.
* phase: PciQuirkPhase field on PciQuirkEntry. All 31 existing
  compiled-in entries default to Final via ..WILDCARD.
* phase_visible(phase, pm_available) helper. Boot-time phases
  always visible; Resume/ResumeEarly gated by pm_available.
* lookup_pci_quirks_full_with_pm() public function gates all
  three layers. load_pci_quirks() defaults to pm_available=false
  for safe existing-caller behavior.
* TOML parser reads phase = "header"|"final"|"enable"|"resume"
  |"resume_early" per [[pci_quirk]] entry. Unknown/omitted
  defaults to Final (graceful degradation).
* Seven R8 tests: header/resume/resume_early parse, omitted default,
  unknown default, boot-phase visibility, resume-phase gating.

Phase R9 (USB storage gap closure, data-only):

* Resynced 30-storage.toml header to reference Linux 7.1 (was 7.0).
* Fixed one entry: VIA Labs VL817 SATA Bridge (0x2109:0x0715)
  revision was "9999-9999" — corrected to wildcard "0000-9999"
  to match Linux UNUSUAL_DEV(0x2109, 0x0715, 0x0000, 0x9999, ...).
* Verification: python3 local/scripts/extract-linux-quirks.py
  local/reference/linux-7.1/drivers/usb/storage/unusual_devs.h
  produces 214 entries. diff against 30-storage.toml = 0 lines.
  The R1-R6 review's "108 missing" estimate was stale; the file
  is in full sync with Linux 7.1.

Test count: 90 (R7-C) + 9 (R7-A, R7-B) + 7 (R8) = 106/106 passing.
No new clippy warnings beyond two Result<_, ()> stylistic lints
that follow the existing convention (7+ functions use this pattern).

Consumer wiring status: BROKEN_MSI consumer in xhcid main.rs:69,
ZERO_64B_REGS consumer in xhci/mod.rs:524,542. R7-C and R7-A new
flags are observability-only via log_unenforced_xhci_quirks()
(R6) until xhcid's suspend/resume path lands.

Deferred to next session: R10 HID infrastructure (24 flags +
500 entries) and any R7/R8 PM execution work when PM lands.

Multi-session plan: this is the first of 4 atomic commits for
R7-R10. R10 HID lands in a separate session.
2026-06-07 11:57:24 +03:00
..