📡 Observer Matrix — Chicago Mesh

auto-refresh 30s
📡 Got a node? Add your packet data to the live map ↓
Observer Key Prefix Model Firmware

Connecting to MQTT sources…

Connect Your Observer

Configure a MeshCore observer node to publish packet data to the Chicago Mesh MQTT broker. Your node's data will appear in the matrix above and feed into CoreScope, Live Map, and Health Check.

What's an observer? An observer is a MeshCore node running firmware that captures packets heard over LoRa radio and publishes them to an MQTT broker over WiFi. It's like a packet sniffer for the mesh — you don't need to be a repeater or route traffic, just listen and report.

Prerequisites

Recommended Chicagoland Firmware v0.6.0

Flash the Chicagoland firmware — all MQTT brokers, radio settings, and IATA region are baked in. Just add WiFi and identity.

Step 1: Flash

  1. Download the *-merged.bin for your board from the latest release
  2. Open flasher.meshcore.co.uk in Chrome/Edge
  3. Select Custom Firmware, pick your file, enable "Erase device", and flash

Step 2: Configure via Serial (115200 baud)

# Set identity
set name MyObserver

# Configure WiFi
set wifi.ssid YourNetworkName
set wifi.pwd YourPassword

# Set location (find yours at latlong.net)
set lat 41.8781
set lon -87.6298

# Apply and reboot
reboot

Note: mqtt.iata is pre-set to ORD (Chicago) in the Chicagoland firmware — you do not need to set it manually. MQTT brokers and radio parameters are also baked in.

What's Baked In

Advanced Plain TCP (Any MeshCore Firmware)

If you're running stock MeshCore firmware (not chioff-flex), you can point it at our plain TCP broker manually:

set mqtt.server mqtt.chicagooffline.com
set mqtt.port 1883
set mqtt.iata ORD
reboot

Connection Details

Alternative: mctomqtt Bridge

If you're running meshcore-packet-capture (mctomqtt) on a Raspberry Pi or similar, it can bridge packets from a USB-connected node to the MQTT broker — no observer firmware needed.

# TCP (production)
mctomqtt --broker mqtt://mqtt.chicagooffline.com:1883 --topic meshcore/ORD

# WSS (dev — requires WS support in mctomqtt)
mctomqtt --broker wss://wsmqtt.chicagooffline.com/mqtt --topic meshcore/ORD

Verification

After configuring and rebooting, confirm your node is connected:

  1. Check serial output — look for [MQTT] Connected
  2. Check the matrix above — your node should appear within a few minutes
  3. Check CoreScope — look for your packets at scope.chicagooffline.com

Troubleshooting

More Resources