Files
meshcore-bot-firmware/README.md

1.2 KiB

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