Explanation
Design rationale for non-obvious choices.
Explanation pages cover design decisions, trade-offs, and the reasoning behind non-obvious choices.
Architecture
| Explanation |
Covers |
| Architecture |
Layer separation rationale, the machine boundary, target platforms, build configurations |
Configuration
| Explanation |
Covers |
| Configuration Interface |
TLM_ interface rationale, OTA single source of truth, parse-time validation, class hierarchy |
Security
| Explanation |
Covers |
| Secure Boot Chain |
Two-stage boot chain: NXP HAB/AHAB and U-Boot FIT image signing |
| CVE Database Freshness |
NVD fetch problem, backup seed, scheduled refresh, per-branch update policy |
Update
| Explanation |
Covers |
| Update Design |
Feature flag design, two-layer configuration model, runtime argument composition, anti-rollback checks |
| Encrypted Updates |
Feature boundary, signing vs. encryption, on-device key delivery design space |