Files
bfe-core1106-sdk/docs/decisions/0005-driver-source-of-truth.md
T
BFE EngineeringandClaude Opus 4.8 189f7aec38 sdk: bootstrap standalone repo (P0)
- Dual license (LICENSE / LICENSE-MIT / LICENSE-APACHE) matching the crate manifests.
- ADRs 0001-0005: kernel base (direct 5.10->6.18.46 forward-port), tiered MC/DC,
  standalone repo, CI runner (3rd repo-scoped runner on 0640), driver source-of-truth.
- README goal 1 reconciled to the verified 6.18.46 forward-port (was stale plan44/6.6).
- Drop tracked build objects (*.o now gitignored).
- Capture the display (VOP dclk-pol + WIN1) and GT911 touch bring-up VERIFIED docs
  + capabilities-audit update from this session.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017wB8KB3MMQztRDXCMCkPrf
2026-08-25 13:46:08 -06:00

1.0 KiB

ADR 0005 — Hardened drivers live in warden-sdk/drivers/

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 warden-sdk/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 warden-sdk 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.