Skip to content

Latest commit

 

History

History
71 lines (56 loc) · 2.96 KB

File metadata and controls

71 lines (56 loc) · 2.96 KB

Documentation Index

Scope: Design specifications, protocol contracts, recovery rules, validation evidence, command references, and portfolio-facing summaries for the Secure Delta OTA Bootloader.

← Root README

Table of contents

Core design

Document What it answers
Architecture Which component owns each responsibility and trust boundary?
Memory Map Where do bootloader, application, metadata, artifact, reconstruction, and backup live?
UART OTA Protocol What exactly is exchanged between ESP32 and STM32?
Firmware Container What bytes are signed and what policy is encoded in SDOT v1 + SCX1?
Boot State Machine How does persistent update state drive reset recovery?
Metadata and Boot Decision How are A/B metadata records committed and selected?
Boot Jump How is the Cortex-M3 application vector validated and transferred safely?
External SPI Flash How is W25Q storage wired, partitioned, and protected?

Security and release

Document Focus
Threat Model Assets, trust boundaries, addressed threats, non-goals
Release Process Immutable release creation, key custody, full/delta selection
Toolchain Selection GCC/Clang selection and reproducibility boundary
Make Command Reference Public root targets and operational commands

Verification and results

Document Focus
Test Plan Required functional, recovery, and security checks
HIL Results Physical 9-scenario deterministic fault matrix
Results Report Consolidated hardware, security, footprint, delta, release results
Benchmark Guide What is measured and what is safe to claim

Portfolio views

Document Use
One-Page Summary Fast technical overview
5-Minute Demo Short demonstration flow
Claim / Evidence Map Maps each project claim to source/test/evidence

Recommended reading order

flowchart TD
    A["Architecture"] --> M["Memory Map"]
    M --> U["UART OTA Protocol"]
    U --> C["SDOT Container"]
    C --> S["Boot State Machine"]
    S --> P["Persistent Metadata"]
    P --> J["Boot Jump"]
    J --> T["Threat Model"]
    T --> R["Release Process"]
    R --> V["Test Plan"]
    V --> H["HIL Results"]
    H --> B["Benchmark / Results"]
Loading

← Root README