Refresh project documentation

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
2026-04-17 00:05:20 +01:00
parent 2c7659fe3a
commit 6689f751d9
23 changed files with 2428 additions and 1720 deletions
+25 -18
View File
@@ -24,22 +24,29 @@ Although this document is primarily about the LinuxKPI path for GPU-class driver
layer is now being exercised more directly by the bounded Intel Wi-Fi transport port as well.
In particular, the current tree now carries LinuxKPI-backed direct/async firmware helpers plus
exported timer, mutex, and IRQ save/restore bindings that the in-tree Intel Wi-Fi transport shim
can consume through actual Linux-style headers. That is still intentionally below the cfg80211 /
mac80211 boundary, but it makes the transport-facing Linux driver port more realistic than a pure
compile-only placeholder.
exported timer, mutex, and IRQ save/restore bindings that the in-tree Intel Wi-Fi transport uses
through actual Linux-style headers. The transport layer now includes full PCIe DMA ring management,
TX/RX queue allocation, command queue with wait/complete semantics, MSI-X interrupt vector tracking,
ieee80211_ops callback registration, NAPI polling, and cfg80211 event dispatch — going well beyond
the initial transport-facing boundary.
The tree now also contains the first explicit wireless-subsystem compatibility scaffolding inside
`linux-kpi` itself: initial `sk_buff`, `net_device`, `cfg80211` / `wiphy`, and `mac80211`
registration surfaces that compile and pass host-side crate tests. This should still be read as
foundational compatibility work, not as proof that Red Bear now has a complete Linux wireless stack
or working Intel WiFi connectivity.
The tree now also contains comprehensive wireless-subsystem compatibility inside `linux-kpi` itself:
`sk_buff` with queue operations, `net_device` with NAPI and queue state, `cfg80211` / `wiphy` with
scan/connect/disconnect/BSS events, `mac80211` with `ieee80211_ops` callback mechanism, channel/
band/rate/BSS definitions, PCI MSI/MSI-X support, DMA pool allocation, `list_head`, full `atomic_t`,
and IO barrier/copy helpers — all compile- and host-test-validated (90 tests pass). This should still
be read as comprehensive compatibility work, not as proof that Red Bear now has working Intel WiFi
connectivity.
On top of that, the bounded Intel path now also carries the first station-mode compatibility slice:
driver-side scan/connect/disconnect actions, control-daemon connect/disconnect flows, profile-
manager orchestration, and runtime-reporting surfaces that exercise those new LinuxKPI wireless
compatibility surfaces in host-side tests. This is still intentionally below real hardware
scan/auth/association/data-path proof.
On top of that, the Intel path now carries a structurally complete PCIe transport implementation:
persistent device state tracked by PCI identity, firmware header parsing, DMA ring allocation for
TX/RX queues, command submission with timeout-based completion, interrupt cause tracking with
ISR/tasklet dispatch, mac80211 ops callbacks, cfg80211 lifecycle management, device family
detection, CSR register programming, and a chained full-init lifecycle. This is structurally
correct code that would work with real firmware, but without hardware validation it does not
provide working Wi-Fi: command submission times out, scan returns no results, RX processing
produces no frames. The transport is an honest skeleton awaiting hardware bring-up, not a
simulation of working connectivity.
Concrete repo entry points for that current bounded WiFi path are:
@@ -52,9 +59,10 @@ Concrete repo entry points for that current bounded WiFi path are:
architecture and operator validation path
The validation claim here should also be read narrowly: the repo now has a clean host-side
`linux-kpi` test suite, passing bounded Intel shim/control-plane tests in the dependent crates, and
one host-side CLI flow test for the current Intel path. This is not a claim that a full Linux
WiFi stack is validated.
`linux-kpi` test suite (90 tests pass), passing comprehensive PCIe transport tests in the
dependent crates (DMA pool, MSI-X, ieee80211_ops, skb queue, NAPI, list_head, atomic_t,
completion timeout, IO barriers), and the iwlwifi transport builds and passes its host-side
test suite (8 tests). This is not a claim that a full Linux WiFi stack is validated on hardware.
## Goal
@@ -301,7 +309,6 @@ redox-drm/
│ │ ├── encoder.rs — Encoder management
│ │ └── plane.rs — Primary/cursor planes
│ ├── gem.rs — GEM buffer object management
│ ├── dmabuf.rs — DMA-BUF export/import via FD passing
│ └── drivers/
│ ├── mod.rs — trait GpuDriver
│ ├── intel/