vasilito
1bc5f8ac88
v3 USB-IMPLEMENTATION-PLAN supersedes v2 (archived). Comprehensive
audit-driven roadmap with 9 phases (P1–P9) to make USB a first-class
citizen in Red Bear OS:
P1: Trait unification (all 4 controllers implement UsbHostController)
+ panic hardening (usbscsid 0 panics, xhcid <20 unwraps)
+ remove 3 empty stubs (usbaudiod, acmd, ecmd)
P2: xHCI core — 51-quirk table, HCCPARAMS2 parsing, 36-code error
recovery (babble, transaction error, stall, split)
P3: Hub driver — full enumeration (wHubDelay, power timing, USB 3 SS)
+ interrupt-driven change detection + port LED
P4: Storage — UAS protocol, multi-LUN, SYNCHRONIZE_CACHE, UNMAP, mass-storage
quirks applied at runtime
P5: HID — report descriptor parser, usage→evdev mapping, LED sync, quirks,
multi-touch
P6: Class driver completeness — CDC ACM, CDC NCM, USB Audio, USB-serial
(FTDI/CP210x/PL2303/CH341), compliance test driver
P7: Power management — USB 2.0 LPM, USB 3.0 U1/U2/U3, runtime PM autosuspend
P8: Validation — hardware matrix ≥10 rows + 6 new QEMU scripts
+ error-injection tests
P9: Modern USB scope ADR (host-only; already written in v2 §12)
Linux 7.1 is the implementation of excellence — every feature has a
concrete cross-reference (file:line) and a 'port line-by-line' strategy
when implementation detail is in doubt.
USB-VALIDATION-RUNBOOK v3 replaces v2 (archived): test matrix with
per-phase exit gates, operator runbook for failures.
Stale items cleared:
- v2 active plan archived as USB-IMPLEMENTATION-PLAN-v2-2026-07.md
- v2 active runbook archived as USB-VALIDATION-RUNBOOK-2026-07.md
- archived/README.md supersession table extended
Archived Documentation
These documents were written during earlier phases of Red Bear OS development. They contain historical context and analysis but are superseded by more current plans. They are kept for reference only.
Superseded by
| Archived | Superseded By |
|---|---|
BOOT-PROCESS-IMPROVEMENT-PLAN.md |
BOOT-PROCESS-AUDIT-2026-05-03.md |
DEVICE-INIT-COMPREHENSIVE-IMPROVEMENT-PLAN.md |
CONSOLE-TO-KDE-DESKTOP-PLAN.md |
GREETER-LOGIN-ANALYSIS.md |
GREETER-LOGIN-IMPLEMENTATION-PLAN.md |
INTEL-HDA-IMPLEMENTATION-PLAN.md |
(Deferred — audio is P3 priority) |
ACPI-I2C-HID-IMPLEMENTATION-PLAN.md |
(Deferred — USB HID is primary input path) |
GRUB-INTEGRATION-PLAN.md |
GRUB is fully implemented (redbear-grub config, installer support, grub recipe) |
VFAT-IMPLEMENTATION-PLAN.md |
VFAT is fully implemented (fatd, fat-mkfs, fat-label, fat-check) |
USB-BOOT-INPUT-PLAN.md |
Superseded — USB HID in initfs, USB storage in initfs (Phase B2). Boot-input analysis remains historically useful; the live-input priority lives in USB-IMPLEMENTATION-PLAN.md v2. |
XHCID-DEVICE-IMPROVEMENT-PLAN.md |
Superseded by USB-IMPLEMENTATION-PLAN.md v2 — phases 1–7 absorbed into the new plan's P0–P3. |
USB-IMPLEMENTATION-PLAN-v1-2026-04.md |
Superseded by USB-IMPLEMENTATION-PLAN-v2-2026-07.md (archived). v1 overstated xHCI interrupt-driven operation; v2 rebased onto current source state and Redox 0.x USB HEAD. |
USB-IMPLEMENTATION-PLAN-v2-2026-07.md |
Superseded by USB-IMPLEMENTATION-PLAN.md v3 (current). v2 captured P0–P5 host-controller work; v3 expands to full USB first-class-citizen scope including UAS, error recovery, CDC ACM, HID report parsing, and hardware matrix. |
USB-VALIDATION-RUNBOOK-2026-07.md |
Historical validation runbook for P0 era. v3 validates against the expanded scope. |
ZSH-PORTING-PLAN.md |
Deferred indefinitely — ion is the default shell |