Using the App
The Mode-X Mesh app is how you talk to your node and to the rest of the network. It connects to your node over Bluetooth and gives you everything from messaging to live diagnostics.
The main screens
Dashboard - your node at a glance: battery, signal, role, how many neighbours it can hear, and whether it has a working uplink to the internet. A small icon shows which uplink is active - a house for a local gateway, a cloud for the public server.
Messages - conversations on each channel and private chats. The General channel is always here; your local town and region channels appear automatically.
Channels - the channels your node has joined, plus a browser to find and join more (see the Channels page of this handbook).
Map - nearby nodes and how they link together, drawn live.
Mesh - deeper network analytics: a live graph of the mesh, link quality between nodes, and role advice.
Settings - your node's name, location handling, role, sensors, and the connection to a server or gateway.
Pairing and reconnecting
The app remembers your node, so after the first pairing it reconnects automatically whenever you're nearby. You can pair more than one node and switch between them.
Choosing an uplink
If there's a Mode-X future local gateway on your Wi-Fi network, the app finds it automatically and offers it as your node's preferred uplink, with the public server as a fallback. The app remembers your choice per Wi-Fi network, so a node set up at home will favour your home gateway and still work away from it.
You don't need to understand any of this to use it - the app sets sensible defaults. It's there if you want control.
Notifications you'll see
The app keeps you informed without getting in the way:
- Role changes arrive as quiet notifications. If your node steps back from a demanding role - say it drops from Relay to Companion because the battery got low - you'll get a silent note explaining why, and the dashboard shows both the role you asked for and the one it's actually running.
- Movement is flagged with a small glyph when your node detects it's travelling, so you and your neighbours know it's mobile.
Tips
- Send
pingon any communal channel to check your path to the network. - Tap a node on the map to see its details, signal history and best neighbours.
- If your node has a sensor attached, its readings appear on the dashboard and in its history chart automatically.