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.
- Install KiekR (Android, iOS TestFlight) and pair it with your MeshCore radio.
- Open Settings → Community upload.
- Enter your IATA code (3-letter airport code near you:
HKTPhuket,USMSamui,BKKBangkok,SGNHo Chi Minh City …) and an observer name. - 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 |
- 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
- Flash Companion (USB) firmware with the MeshCore flasher. No custom firmware needed.
- Set the radio parameters of your country (see Frequencies) and give it a clear name, e.g.
Observer Phuket. - 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.