Hardware & setup

Off-the-shelf.
Your call.

Pick what fits your build and your budget. Everything below runs the same firmware family — buy it ready-made, repurpose a Meshtastic board, or design your own.

What you need

Two parts: a gateway and some nodes

The gateway 1 per setup

  • Heltec Wireless Stick V3 — ESP32-S3 + SX1262. The small USB dongle that bridges your computer to the radio fleet.

The nodes pick any

  • Heltec HT-CT62 — ESP32-C3 + SX1262. Tiny and about the cheapest way in. Great for pure light nodes.*
  • Heltec Wireless Stick Lite V3 — ESP32-S3 + SX1262, with onboard battery management.
  • Any Meshtastic-compatible board with a supported modem (SX1262 recommended) — e.g. Heltec WiFi LoRa 32 V3 / V4, LilyGo T3-S3, LilyGo T-Beam.

Custom & reference roadmap

  • Roll your own — design a custom node board around a supported chip and radio.
  • Reference designs (planned) — one or two ready-to-build boards with 2S battery low-voltage cut-off and reverse-polarity protection, plus a low-cost variant.

* The ESP32-C3 on the HT-CT62 doesn't have enough free pins for the e-paper start-block display. For start blocks, use an ESP32-S2 or ESP32-S3 board. Full hardware notes are in the node setup guide.

Up and running

From box to light show in four steps

01

Flash the firmware

Grab a ready-made firmware file from the GitHub releases (or build it yourself). After that, the WebUI updates devices over the air.

02

Plug in & open

Connect the USB gateway to a laptop or Raspberry Pi and open the WebUI — standalone, or inside RotorHazard.

03

Pair & group

Hit Discover Devices, then drop them into groups like Start Line or Pit Wall. See the operator guide.

04

Build a scene & run

Assemble a playlist of effects, press Run, and watch the whole track come alive. Enjoy the show.

Two ways to run it

Host mode or headless

Host mode

A laptop or Raspberry Pi runs the host with the USB gateway plugged in. You get the full WebUI: groups, scenes, telemetry and over-the-air updates. Run it standalone or inside RotorHazard.

Headless mode

No host, no gateway. One node becomes the master and remote-controls up to 40 devices straight from its button — ideal for practice nights and small meets with zero setup.

Step-by-step guides

Ready to build it?

The documentation walks through flashing, pairing and running a real event, end to end.