An observer is a MeshCore radio connected to a small computer with internet access (for example a Raspberry Pi). It listens to the mesh and reports what it hears – who was heard, signal strength (RSSI, SNR), packet type, path – to MeshCore Asia. From many observers the platform builds the live network map, statistics and the actually measured coverage.

MeshCore nodes  →  LoRa  →  Observer (Pi + radio)  →  internet  →  mqtt.meshcore.asia

Only network metadata is used. Private messages cannot be read, and channel messages are not decrypted or stored.

There are two ways:

  • Option 1 – phone app (easiest): your phone with the KiekR app reports what your radio hears. Good for trying it out; it only reports while the phone is connected to the radio.
  • Option 2 – Raspberry Pi (24/7): a small computer with its own radio runs day and night. Best for a permanent observer at a good location.

Option 1: KiekR app

KiekR is an independent MeshCore app for Android and iOS (by Marcel Verdult) that can upload what your radio hears to analyzers – including MeshCore Asia.

  1. Install KiekR (Android, iOS TestFlight) and pair it with your MeshCore radio.
  2. Open Settings → Community upload.
  3. Enter your IATA code (3-letter airport code near you: HKT Phuket, USM Samui, BKK Bangkok, SGN Ho Chi Minh City …) and an observer name.
  4. Under Custom instances tap Add custom instance and enter:
Field Value
Name MeshCore Asia
Host mqtt.meshcore.asia
Port 443
Protocol WSS
TLS on
Authentication JWT
Audience (under Advanced) mqtt.meshcore.asia
  1. Save and switch it on. A green dot means connected.

Tips: check the host spelling (mqtt with q). KiekR logs in with its own generated key per target – your radio’s identity is not uploaded. Packets are only forwarded while the phone stays connected to the radio over Bluetooth.

Option 2: Raspberry Pi

What you need

  • A Raspberry Pi (Zero 2, 3, 4 or 5) or another computer that is always on
  • A MeshCore radio for your frequency band, connected by USB – e.g. Heltec V3/V4 or RAK4631 (for Thailand: 915/920 MHz version)
  • Good antenna, ideally high up – an observer only reports what it can hear
  • No account needed: your observer logs in with the key of its own radio

1. Prepare the radio

  1. Flash Companion (USB) firmware with the MeshCore flasher. No custom firmware needed.
  2. Set the radio parameters of your country (see Frequencies) and give it a clear name, e.g. Observer Phuket.
  3. Plug it into the Pi.

2. Install the capture software

We use the open-source meshcore-packet-capture (MIT), which works with normal companion radios.

Ready-made config: meshcore-asia.toml – download it, adjust iata and the port, then either install manually

uv tool install git+https://github.com/agessaman/[email protected]
meshcore-packet-capture --config meshcore-asia.toml --verbose

(the package is not on PyPI yet, so it is installed from GitHub). We pin a tested release; if you prefer living on the edge, try @main – but please fall back to @v2.2.1 before reporting any issues.

Or use the system installer on the Pi, which sets it up as a service:

sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/agessaman/meshcore-packet-capture/main/install.sh)"

The installer sets it up as a service and asks a few questions.

3. Connect to MeshCore Asia

Put this into /etc/meshcore-packet-capture/config.d/99-user.toml (use your own location code and port):

[general]
iata = "HKT"            # 3-letter airport code near you: HKT Phuket, USM Samui, BKK Bangkok

[capture]
connection_type = "serial"

[serial]
ports = ["/dev/ttyACM0"]   # or /dev/ttyUSB0 – check with: ls /dev/tty*

[[broker]]
name = "meshcore-asia"
enabled = true
server = "mqtt.meshcore.asia"
port = 443
transport = "websockets"
websocket_path = "/"
keepalive = 60

[broker.tls]
enabled = true
verify = true

[broker.auth]
method = "token"              # login with your radio's own key – no password
audience = "mqtt.meshcore.asia"

Restart the service afterwards. The software reads the key from the radio (companion firmware with key export) and signs a login token with it – the key itself never leaves the Pi. Questions? [email protected] Leave include_decoded off – MeshCore Asia does not want decrypted message content.

You can send to other analyzers at the same time (e.g. LetsMesh) by adding more [[broker]] blocks.

Status

The observer system is new. The first observer is being set up in Phuket. Live maps and statistics from observer data follow.