Files
bfe-core1106-sdk/docs/decisions/0005-driver-source-of-truth.md
T
BFE Engineering d465d97b99 docs: repo renamed to bfe-core1106-sdk
The last product-first artifact after ADR-0008 was the repo name itself.
Current and forward-looking references updated; period-bound history in
the ADRs keeps the old name, with the rename recorded in ADR-0008.
Crate names, WARDEN_* env vars, and binaries are unchanged.
2026-08-31 07:17:00 -06:00

1007 B

ADR 0005 — Driver Source of Truth

Status: Accepted (2026-08-25).

Context

Our own hardware-facing driver code (relays, modbus master, RGA wrapper, HPMCU supervisor, devmem/reset ladder, freshness) is the Tier-1 MC/DC target, but it currently lives in flare-edge. The kernel driver source lives in an un-versioned scratch tree (flare-edge/research/linux-6.18.46/).

Decision

Bring hardened copies into this repo's drivers/ as the canonical source-of-truth, each with its HAL seam and a 100% MC/DC host harness. The RV1106 kernel deltas are formalized as a patch series in patches/. flare-edge consumes this repo later (separate, maintainer-gated step).

Consequences

  • Realizes the seam architecture (ADR-referenced in docs/architecture.md).
  • flare-edge is not edited now; a later integration step points flare-edge at these.
  • Risk: temporary duplication of shared constants between the two repos until the integration lands — tracked, acceptable for the bring-up window.