docs: ASCII typography and style normalization across all repo text
Replace every em dash with real punctuation (rewrites, not hyphen swaps) in docs, code comments, scripts, configs, and the port records; convert en dashes, curly quotes, ellipsis glyphs, arrows, and section signs to ASCII; drop machine-writing tell phrases from living docs. ADR titles now use a colon. The M2 bring-up DTS model string carried an em dash into the patch series and its record echoes; fixed at both, and the full series re-verified to apply cleanly onto pristine 6.18.46. One comment in freshness.h deliberately names the em dash glyph the UI renders as the unknown mark; that is data, kept as prose naming it. Verified: cargo tests (sim, config-lint, rs485-bridge), shellcheck, both driver MC/DC harnesses, patches-apply.
This commit is contained in:
@@ -1,17 +1,17 @@
|
||||
# Driver provenance & openness ledger
|
||||
|
||||
Standing directive: **every** driver we run on the self-built 6.18 kernel must be
|
||||
open source we can read, harden, and bend — not a binary blob — and this applies
|
||||
open source we can read, harden, and bend (not a binary blob) and this applies
|
||||
to the drivers *already* ported, not just the new ones. This ledger records, for
|
||||
each, where the source came from and under what license. Every entry is GPL-2.0
|
||||
kernel source; nothing here is a binary-only kernel module.
|
||||
|
||||
## Legend
|
||||
- **vendor-src** — C source from the Rockchip 5.10 vendor SDK
|
||||
(`flare-edge/sdk/sysdrv/source/kernel/`), forward-ported 5.10 → 6.18.
|
||||
- **mainline-sibling** — 6.18 mainline driver, extended with an rv1106 data table
|
||||
- **vendor-src**: C source from the Rockchip 5.10 vendor SDK
|
||||
(`flare-edge/sdk/sysdrv/source/kernel/`), forward-ported 5.10 -> 6.18.
|
||||
- **mainline-sibling**: 6.18 mainline driver, extended with an rv1106 data table
|
||||
derived from a sibling SoC (rv1126/px30/rk3562) whose IP block matches.
|
||||
- All Rockchip vendor kernel code is a GPL-2.0 fork of mainline Linux → GPL-clean.
|
||||
- All Rockchip vendor kernel code is a GPL-2.0 fork of mainline Linux -> GPL-clean.
|
||||
|
||||
## Already-ported drivers (audited for openness per directive)
|
||||
| Driver | Origin | License | Openness notes |
|
||||
@@ -30,18 +30,18 @@ kernel source; nothing here is a binary-only kernel module.
|
||||
|---|---|---|---|
|
||||
| AIC8800 wifi/BT | vendor-src (AICSemi) | `MODULE_LICENSE("GPL")` | full full-MAC source; 50 files use GPL-only kernel/cfg80211/sdio symbols; **no** proprietary/redistribution restriction in-tree |
|
||||
|
||||
## The one unavoidable blob — and why it is *not* kernel code
|
||||
## The one unavoidable blob, and why it is *not* kernel code
|
||||
- **`aic8800dc_fw`** (`/oem/usr/ko/`) is device firmware that the GPL host driver
|
||||
*uploads to the wifi chip's on-die processor*. It never runs on the A7; it is not
|
||||
linked into the kernel. This is the standard Linux firmware split (cf. every
|
||||
ath10k/mt76 device) and is the only binary in the wifi path — the driver itself
|
||||
ath10k/mt76 device) and is the only binary in the wifi path: the driver itself
|
||||
is source. No open re-implementation of the AIC on-die MAC firmware exists;
|
||||
reverse-engineering it is out of scope for the panel and buys nothing (the host
|
||||
driver is where our control + hardening lives).
|
||||
|
||||
## NPU — the openness line we will not cross
|
||||
## NPU: the openness line we will not cross
|
||||
The **kernel** rknpu driver is portable GPL source (`npu/PORT-PLAN.md`). What is
|
||||
closed is the *userspace* RKNN runtime + the regcmd stream format — a binary blob.
|
||||
closed is the *userspace* RKNN runtime + the regcmd stream format, a binary blob.
|
||||
Per directive we do **not** ship that blob; if NPU compute is ever wanted, the open
|
||||
path is a from-scratch/reverse-engineered regcmd encoder, tracked separately, never
|
||||
a vendored binary runtime. (See `npu/PORT-PLAN.md` and the graphics investigation.)
|
||||
|
||||
Reference in New Issue
Block a user