Repository navigation
Description
Decision
Clients offer a signal survey: a passive log of the signal of each packet the connected radio hears, tagged with where the radio is, drawn on the map as measured coverage. It only listens and never transmits.
Coverage is drawn as squares rated with the signal rating the node list already uses, so a color means the same thing on the map, in the node list and on every client.
Context
Site Planner (design#119) predicts coverage from terrain. Nothing in the clients measures it. Ping-based wardriving costs every node airtime on a flooding mesh, so this spec is passive only.
Every live reception already carries what is needed (rx_rssi, rx_snr, rx_time, hop_start, hop_limit), and the phone knows where it is. No firmware or protocol change is required.
Android ships this in meshtastic/Meshtastic-Android#8066.
Required Client Behavior
-
Off until the user turns it on. Each recording is a session, listed newest first with show on map, export and delete.
-
Log only live LoRa receptions:
rx_rssipresent, not via MQTT, andrx_timewithin 30 seconds. Skip the first 15 seconds after connecting, while the radio hands over packets it queued. -
Place a reading where the radio is. Use the radio's own GPS position while it is under 15 seconds old, otherwise the phone's fix when it is under 15 seconds old and within 50 m. A position set on the radio, or a radio GPS reporting no ground speed, holds until the radio reports another. A position the phone gave the radio is not the radio's own. Without a usable position, log nothing rather than a misplaced reading.
-
A radio reached over the network may be somewhere else, so once it reports a position of its own, never place its readings by the phone. Use the phone only while it reports none.
-
Record whether each reading was direct (
hop_start == hop_limit). A relayed copy carries the last relay's signal, not the sender's. -
Store the modem preset with the session, so a session keeps its colors after the radio changes preset.
-
Draw visible sessions as squares, 50 m across at street level, growing as the map zooms out so a session stays visible at city scale. A square stands for its clearest reading: best SNR, with RSSI breaking ties and standing in when no reading has an SNR.
-
Rate a square by SNR margin over the session preset's demodulation floor, in the node list's four bands and colors. Fall back to the node list's RSSI bands only without an SNR.
-
Draw the session being recorded, growing as readings arrive.
-
Tapping a square shows its SNR, RSSI, reading count, nodes heard and last reading time, without a scrim over the map. Draw a line to each node heard there directly that shares a position, colored by that node's reading, ending at the position it reports at the precision it shares. Count nodes without a position instead. The selection follows the tapped spot, so it survives zooming.
-
An optional heatmap draws one layer per signal band, counting squares rather than readings, so standing still adds no heat. Leave gaps between passes empty: filling them is a prediction, which is Site Planner's job.
-
Where the client has an AR view, it may paint visible sessions on the ground out to about 300 m, and say when a survey is recording.
-
Export is CSV per session.
-
Say why nothing is logging: not connected, or, while the radio reports no position of its own, no location permission, location off or no fix, with a one tap fix where there is one.
States
| State | Record control | Status line |
|---|---|---|
| Idle | Off | Reading count across sessions |
| Recording, logging | On | Reading count of the live session |
| Recording, blocked | On | The reason, with a fix where one exists |
Accessibility
Signal quality is never conveyed by color alone: the tap card names the band and the legend names all four.
Acceptance Criteria
- With no radio, or no permission or fix while the radio reports no position, recording logs nothing and says which.
- A radio with a fresh GPS fix places readings over the phone; a radio reached over the network that reports a position is never placed by the phone.
- A packet via MQTT, or handed over in the first 15 seconds, is never logged.
- A LongFast session keeps its colors after a preset change, and the same SNR rates lower on a faster preset.
- The live session draws while recording, and squares merge as the map zooms out.
- Tapping a square shows its details and lines to directly heard nodes with a position; zooming keeps the selection.
- The heatmap never paints between passes, and a long stop adds no more heat than a pass.
- Export holds one row per reading of one session.
Platform Tracking
- Android: Passive signal survey on the map Meshtastic-Android#8072, shipped in feat(map): signal survey with live map overlay, heatmap and AR ground view Meshtastic-Android#8066
- Apple: Passive signal survey on the map Meshtastic-Apple#3031
- Web: not filed yet. A browser often has no position of its own, so it would rely on a radio that reports one.
- Firmware: out of scope. Every field needed is already on
MeshPacket. - Device UI: out of scope. The device has no phone position to tag readings with.
Metadata
Metadata
Assignees
Labels
Type
Projects
- StatusShow more project fieldsIn Progress
Activity