cj-vana d26979ed94 forge: add patch 5 — hop-aware bot coordination
Bundles in-progress utility commands (TIME, LORA, ID, NEIGHBORS), neighbor
tracking, received_at_timestamp / personalized acks, and per-hop response
delay coordination. Tunes the coordinator so multi-hop senders actually get
responses: hop step 5s→1.5s, hop bias capped at 8s, pending TTL 15s→45s.

Verified on Heltec V3 bench bot: responds to #bot at 2, 4, and 6 hops.

BOT_PREFS_VERSION bumped 2→3, so existing bots will reset bot prefs (channel
names, known bots) to defaults on first boot of this firmware.
2026-05-16 12:48:00 -06:00

Colorado MeshCore Bot Firmware

Wrapper repository for Colorado Mesh firmware-only bot work on top of upstream MeshCore companion firmware.

Layout

  • vendor/MeshCore/ — pinned upstream MeshCore submodule.
  • patches/meshcore/ — ordered patch queue applied to the submodule.
  • colorado/ — Colorado Mesh overlay files, fixtures, and notes.
  • scripts/ — wrapper scripts for patch and build workflows.

Patch workflow

Initialize the submodule and apply patches:

git submodule update --init --recursive
bash scripts/apply-patches.sh

Develop firmware changes in vendor/MeshCore, commit them in that submodule worktree, then export the patch queue:

bash scripts/export-patches.sh origin/main

Representative builds

Build the release-gate companion environments and write size reports:

bash scripts/build-representative.sh --baseline

The build writes PlatformIO logs and summary.json to out/size/, and copied firmware artifacts to out/firmware/.

Representative companion build environments:

  • Heltec_v3_companion_radio_usb
  • Heltec_v3_companion_radio_ble
  • RAK_4631_companion_radio_usb
  • RAK_4631_companion_radio_ble
Description
No description provided
Readme MIT 453 KiB
Languages
C++ 75.9%
Shell 12.2%
Python 11.9%