Repository navigation
feat(docs): build a Node and a Hub from the docs - #120
Merged
snovak7 merged 4 commits intoOct 19, 2026
Merged
Conversation
…ed and reviewed via bmad-loop (awaiting operator)
…uild-a-node-and-a-hub-from-the-docs
Add a reference Node and Hub design under hardware/ (schematics as connection tables, BOM, wiring with the switched probe power and battery divider, enclosure and probe sealing) and an adopter build guide under docs/build/ (flashing with espflash from release binaries or source, first boot and the setup code, the irreversible eFuse burn and dev mode, power budget and placement). A new Docs workflow resolves every relative link and referenced path and runs the guide's build commands against the firmware crates, build only. Closes #119 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XJ9QyLY9aHkpAdZQsUJN3n
…uild-a-node-and-a-hub-from-the-docs
snovak7
deleted the
feat/epm-t140-gh119-build-a-node-and-a-hub-from-the-docs
branch
October 19, 2026 20:56
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
hardware/: a reference Node and Hub design under Apache-2.0, labelled "not yet bench-verified". It has ASCII block diagrams and connection tables, a BOM with the requirement each part must meet, and a full pin-to-pin wiring list tied topins.rs(switched probe power, high-side switched battery divider). It also has enclosure notes and probe sealing.docs/build/: an adopter build guide.flash.mdopens with the irreversible eFuse burn and dev mode. It covers flashing over USB withespflashfrom release binaries (with aSHA256SUMScheck) or from source, first boot and the setup code (Hub at first boot, Node on a 3 s press), download mode, the buttons, WPA2, anderase-regionrecovery.power.mdcovers panel placement above the canopy, the ≤ ~100 µA sleep budget and how to measure it, and why soil % and battery % are approximate.Docsworkflow, which is not a required check, andci.ymlis untouched:docs/check-links.shresolves every relative link and referenced repo path.docs/check-commands.shruns every<!-- ci:run -->block against the firmware crates (build only) and checks the subcommands of<!-- ci:hardware -->blocks.docs/test.shholds 44 fixture tests, including a check that the documented toolchain pins matchci.yml.Story 10-2 (bmad-loop). It is finished as far as an agent can take it. A human still owes the bench build, a real flash, datasheet checks and the sleep-current measurement; these are listed under
operator_actionsin the spec.Closes #119
Test plan
docs/test.sh: 44 passeddocs/check-links.sh: 419 links and paths in 25 files resolvedocs/check-commands.sh: 14 blocks pass locally (Hub and Node release and dev-mode builds,save-image --merge, espflash subcommands)Docsworkflow green on this PR (first run on GitHub)🤖 Generated with Claude Code
https://claude.ai/code/session_01XJ9QyLY9aHkpAdZQsUJN3n