blueflare/bfe-core1106-sdk
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: ASCII typography and style normalization across all repo text

Browse Source 
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:
BFE Engineering
2026-08-31 12:31:27 -06:00
parent 80d9a9539b
commit 42fb386f60
111 changed files with 1261 additions and 1261 deletions
Download Patch File Download Diff File Expand all files Collapse all files
kernel/rv1106-enablement/OVERNIGHT-PLAN.md
+13 -13
View File
@@ -1,23 +1,23 @@
# Overnight autonomous kernel-completion workflow
**Directive (2026-08-24 night):** port/enable **every** remaining RV1106
hardware capability on the self-built 6.18 kernel, **open-source-first** — we want
hardware capability on the self-built 6.18 kernel, **open-source-first**: we want
*source* we can read, harden, and bend to our needs (vendor SDK source, upstream,
community repos, or reverse-engineering), never binary blobs. Not just ports —
community repos, or reverse-engineering), never binary blobs. Not just ports,
**new drivers if necessary**. Leave zero hardware capability or customization on
the table. Fully autonomous, runs overnight; the display's last mile is deferred
to tomorrow morning (needs eyes on the panel).
## Open-source sourcing policy (in order of preference)
1. **Vendor SDK source** — `flare-edge/sdk/sysdrv/source/kernel/drivers/…`. Every
1. **Vendor SDK source**: `flare-edge/sdk/sysdrv/source/kernel/drivers/...`. Every
driver below ships as C source there (aic8800, rknpu, rga, rtc, tsadc, i2s all
have source — the *only* closed pieces are userspace runtimes like RKNN, not
the kernel drivers). Port 5.10 → 6.18.
2. **Mainline / sibling** — reuse rv1126/px30 data where the IP matches (clk,
have source: the *only* closed pieces are userspace runtimes like RKNN, not
the kernel drivers). Port 5.10 -> 6.18.
2. **Mainline / sibling**: reuse rv1126/px30 data where the IP matches (clk,
pinctrl, vop, saradc, usb2phy all used this).
3. **Community open drivers** — deep web research (AICSemi upstream/github, the
3. **Community open drivers**: deep web research (AICSemi upstream/github, the
NPU reverse-engineering efforts, etc.) for a cleaner or better-understood base.
4. **Reverse-engineering** — register maps from the TRM + the vendor source, as a
4. **Reverse-engineering**: register maps from the TRM + the vendor source, as a
last resort or to harden.
For each: understand it, prefer the most upstream-aligned source, harden it, and
add a regression check where feasible.
@@ -36,17 +36,17 @@ add a regression check where feasible.
| 8 | **eth0 USB gadget** | dr_mode + configfs | `eth0` to xps |
| 9 | **Capabilities audit** | TRM + SDK sweep | enable/port everything else |
### Capabilities audit (#9) — nothing left on the table
### Capabilities audit (#9): nothing left on the table
Enumerate every RV1106 block and confirm a 6.18 driver: crypto accelerator + TRNG,
mailbox/HPMCU integration, DSMC/flexbus, SFC/SPI-NOR, remaining SPI, CAN, PWM
(fan/other), DMA2, DDR monitor, the second/other UARTs, GMAC (if wired), pvtm,
otp/nvmem, dsmc. Anything with hardware present and no driver → port or write it.
otp/nvmem, dsmc. Anything with hardware present and no driver -> port or write it.
## Execution model
Pipeline: research (Sonnet subagents, in background) ∥ port (me) → build → flash to
c8a3 slot _b → verify on hardware → commit to warden-sdk. Serial bottleneck is
Pipeline: research (Sonnet subagents, in background) ∥ port (me) -> build -> flash to
c8a3 slot _b -> verify on hardware -> commit to warden-sdk. Serial bottleneck is
c8a3; research/porting overlaps verification. **Resilience:** krecover is hardened
(serial-primary + Pi/rkdeveloptool bootcount-reset fallback); on a port that won't
land, capture the state, mark it in DRIVER-PARITY.md, and move on — never leave
land, capture the state, mark it in DRIVER-PARITY.md, and move on; never leave
c8a3 stuck, never block the whole run on one driver. Commit after every landed
driver so progress is durable.