# MeshMapper Wardriving Guide

## MeshMapper Wardriving Guide

MeshMapper is a platform for mapping *actual measured* RF coverage of a MeshCore network - not just node locations, but real signal coverage at road level. This is the ground truth that theoretical planners cannot provide. MeshMapper is a MeshCore tool (Android, iOS, and web); for Meshtastic coverage mapping see meshmap.net or the Meshtastic Site Planner instead.

### Getting the App

- **Android:** Google Play - search "MeshMapper"
- **iOS:** App Store - search "MeshMapper"
- **Web interface:** [wd.meshmapper.net](https://wd.meshmapper.net)
- The app is **free**.

### Connecting Your Radio (BLE)

For wardriving, MeshMapper connects directly to your MeshCore radio over **Bluetooth LE (BLE)** - it does not require an MQTT connection to collect coverage data. Pair your MeshCore device to the app over BLE before starting a session.

**Important:** MeshCore devices only support one BLE connection at a time. **Disconnect the MeshCore companion app** before launching MeshMapper or the connection will fail.

### Observer / Region-Admin Setup (Optional)

Separately from the per-user wardriving flow above, an MQTT observer can be configured to aggregate mesh traffic for region administrators. This is **not** part of normal per-user wardriving. If you are running an observer, connect to one of these brokers:

- `mqtt-us-v1.letsmesh.net:443` (WebSocket TLS)
- `mqtt.meshmapper.cc:443` (WebSocket TLS)

### Operating Modes

<table id="bkmrk-modedescriptionbest-"> <thead><tr><th>Mode</th><th>Description</th><th>Best For</th></tr></thead> <tbody> <tr> <td>**Hybrid** (recommended)</td> <td>Alternates discovery requests and channel messages. 50% fewer transmissions than legacy Active mode.</td> <td>General wardriving - balances coverage data quality with network impact</td> </tr> <tr> <td>**Passive**</td> <td>Discovery requests every 30 seconds; no channel messages.</td> <td>Minimal network impact; good for densely populated mesh areas</td> </tr> <tr> <td>**Manual Ping**</td> <td>Single on-demand ping.</td> <td>Spot-checking coverage at a specific location without driving</td> </tr> <tr> <td>**Active**</td> <td>Legacy channel-message-only mode.</td> <td>Backward compatibility - Hybrid is superior in all cases</td> </tr> <tr> <td>**Trace**</td> <td>Focus on a single repeater identified by its hex node ID.</td> <td>Antenna alignment, diagnosing a specific repeater's coverage, post-installation validation</td> </tr> </tbody></table>

### Coverage Map Color Meanings

<table id="bkmrk-colorcodemeaning-gre"> <thead><tr><th>Color</th><th>Code</th><th>Meaning</th></tr></thead> <tbody> <tr><td style="background:#22c55e;color:#fff;">Green</td><td>BIDIR</td><td>**Two-way confirmed contact** - gold standard coverage. Your device and the repeater can hear each other.</td></tr> <tr><td style="background:#06b6d4;color:#fff;">Cyan</td><td>DISC</td><td>**Discovery-based two-way confirmation** - confirmed via discovery protocol rather than channel message.</td></tr> <tr><td style="background:#f97316;color:#fff;">Orange</td><td>TX</td><td>**Transmit-only path** - your signal reaches the repeater but return path is incomplete (asymmetric link).</td></tr> <tr><td style="background:#a855f7;color:#fff;">Purple</td><td>RX</td><td>**Receive-only** - you can hear the repeater but it cannot hear you.</td></tr> <tr><td style="background:#6b7280;color:#fff;">Grey</td><td>DEAD</td><td>**Signal heard but not relayed** - marginal contact; unreliable for mesh routing.</td></tr> <tr><td style="background:#ef4444;color:#fff;">Red</td><td>DROP</td><td>**No repeater responded** - no coverage at this location.</td></tr> </tbody></table>

### Wardriving Best Practices

- Mount your device with the antenna as high as practical in the vehicle (dashboard or roof magnet mount).
- Drive at normal road speeds - the app samples frequently enough.
- Cover roads in a grid pattern for systematic area mapping.
- Use **Trace mode** after installing a new repeater to confirm its actual coverage footprint.
- Share your coverage data back to the community map so others benefit.