Max, the edge firmware

Edge hardware · Layer 3

"Gets his hands dirty with actual hardware."

What Max does

Max is the firmware that runs on your devices. It reads sensors, switches relays, and reports to the platform over WiFi, BLE, MQTT or LoRa.

The Mx framework

A FreeRTOS-based firmware stack for ESP32-S3 boards in the Heltec V3 and V4 class, with a staged boot and managers for each subsystem.

LoRa

An SX1262 radio gives you long range and low power with no internet needed, including mesh links between devices.

WiFi and BLE

WiFi for the network and a local web dashboard, BLE for setup from your phone.

MQTT telemetry

Sensor readings, voltage and relay state are published as structured JSON that Mona can show.

Over-the-air updates

Firmware goes out through a MAC-keyed device registry, so you never hardcode an IP address. Build once, update every device in the class.

Sensors and relays

I2C and SPI sensor buses, GPIO expanders such as the MCP23017, scheduled tasks, and pulse or toggle control of outputs.

How it works

From a bare board to a managed device.

  1. Flash the board once over USB.
  2. The device registers in the registry by its MAC address.
  3. It publishes telemetry over MQTT and accepts commands.
  4. New firmware goes out over the air to every device in the class.

Where it fits in the four layers

1 Infrastructure & roles Vera, Grant, the bus, the device registry
2 Data pipeline & state Flo, DynaRAG, the carousel
3 Reasoning & inference Rick, Annie, Max, Hank
4 UI & collaboration Marco, Noted, Norm, the graph

Max is the edge-native part of layer 3. It can act on its own, using rules from Chip, and it publishes to the same bus as everything else. The registry in layer 1 delivers its updates.