Skip to content

Hardware support

Jump to bottom
Elliot edited this page Jul 28, 2026 · 1 revision

Hardware Support

The initial hardware target is the Heltec WiFi LoRa 32 V3. VTOC Agent is designed to be extended, but extension is evidence-driven: compatible CPU family alone is never enough to declare a board supported.

Support levels

Level Meaning What users may do
Supported Exact board profile, reproducible build, tested serial recovery, and public release evidence exist. Install the matching verified release.
Experimental A board profile is under review or physical verification is incomplete. Contributors may test only with an explicit recovery plan.
Planned The board is documented as a possible target, but no profile or evidence exists. Do not flash VTOC Agent firmware.
Unsupported The board cannot meet the profile or safety requirements. Do not use VTOC Agent images.

Adding an ESP32-class board

  1. Record the manufacturer, exact model, board revision, chip variant, flash size, PSRAM availability, and a stable source for the schematic.
  2. Map every firmware-relevant connection: serial interface, reset and boot behavior, display, radio, sensors, power controls, LEDs, and battery path.
  3. Add a board profile that makes those mappings explicit rather than relying on a similarly named board definition.
  4. Build both the normal image and the recovery image from the pinned toolchain.
  5. Verify serial flashing, boot, basic health reporting, rollback or recovery, and the absence of unintended radio or network behavior on physical hardware.
  6. Capture sanitized evidence, checksums, toolchain version, and test results in a pull request. Never publish local network settings or device-specific secrets.
  7. Publish a board-specific release only after the review and recovery evidence are complete.

Board-profile accountability

Each supported board must have a traceable profile and release trail:

flowchart LR
  A[Board revision and schematic] --> B[Explicit board profile]
  B --> C[Pinned reproducible build]
  C --> D[Normal and recovery images]
  D --> E[Physical-board verification]
  E --> F[Sanitized evidence and review]
  F --> G[Board-specific release manifest]
  G --> H[Owner-authorized browser flash]
Loading

A binary for one profile must not be presented as compatible with another profile until this chain is complete for that other board.

Clone this wiki locally