mirror of
https://github.com/meshtastic/Meshtastic-Android.git
synced 2026-09-16 07:07:44 -04:00
195 lines
14 KiB
HTML
195 lines
14 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="en" dir="ltr">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
<title>Nodes</title>
|
||
<link rel="stylesheet" href="../styles/docs.css">
|
||
</head>
|
||
<body data-page="nodes" data-locale="en">
|
||
<pre class="markdown-content"># Nodes
|
||
|
||
The Nodes screen lists every node visible on your mesh.
|
||
|
||
## Node List
|
||
|
||
The node list shows every node your radio has heard, including:
|
||
- **Node name** — user-configured long name
|
||
- **Short name** — 4-character identifier
|
||
- **Signal quality** — SNR, RSSI, and a quality word, shown only for nodes your radio heard directly. In the Complete layout a node reached through a relay shows its hop count here instead; a node heard only over MQTT shows neither
|
||
- **Last heard** — time since last communication
|
||
- **Distance** — estimated distance (if positions are shared)
|
||
- **Battery** — remote node battery level (if telemetry is enabled)
|
||
|
||
### Choosing What the List Shows
|
||
|
||
The list has two densities, set at **Settings → Node Layout**. **Complete** shows every field a node has reported and hides the ones it hasn't. **Compact** fits more nodes on screen and lets you pick the fields yourself — **Power**, **Last Heard Time**, **Relative Last Heard Time**, **Distance and Bearing**, **Hops Away**, **Signal (Direct Only)**, **Channel**, and **Device & Role**. The **Environment Metrics** toggle applies to both densities. A preview above the toggles shows the effect before you leave the screen.
|
||
|
||
### Node Status Indicators
|
||
|
||
Indicator | Meaning |
|
||
-------|---------|
|
||
Green last-heard time | Node heard within the last 2 hours |
|
||
Plain last-heard time | Node not heard for over 2 hours |
|
||
⭐ Favorite | Node you marked as a favorite. |
|
||
|
||
There is no separate "away" tier.
|
||
|
||
### Node Roles
|
||
|
||
Nodes can be configured with different roles that affect their mesh behavior:
|
||
|
||
Role | Description |
|
||
------|-------------|
|
||
Client | Standard end-user node |
|
||
Client Base | Treats favorited-node traffic as Router Late priority; all other traffic as Client |
|
||
Client Mute | Receives but doesn't retransmit |
|
||
Client Hidden | Like Client Mute, plus hides from node list |
|
||
Router | Prioritizes message forwarding; stays awake to relay |
|
||
Router Late | Infrastructure node that rebroadcasts once, but only after all other modes (provides supplemental coverage) |
|
||
~~Router Client~~ | ⚠️ **Deprecated** (removed in firmware 2.3.15) — no longer selectable; use Router or Client instead |
|
||
~~Repeater~~ | ⚠️ **Deprecated** (removed in firmware 2.7.11) — no longer selectable; use Router instead |
|
||
Tracker | Optimized for position reporting at regular intervals |
|
||
Sensor | Optimized for telemetry reporting |
|
||
TAK | Interoperates with TAK systems (sends/receives CoT) |
|
||
TAK Tracker | TAK position reporting only |
|
||
Lost and Found | Sends its position to the default channel as a text message at regular intervals, to help recover a lost radio |
|
||
|
||
### Choosing a Role
|
||
|
||
Most users should keep the default **Client** role. Consider a different role when:
|
||
|
||
- **Router** — You have a node in a fixed, elevated location with reliable power (rooftop, hilltop). Routers stay awake continuously to relay messages for others and are essential for extending mesh coverage. Don't use Router on battery-powered handheld radios.
|
||
- **Router Late** — An infrastructure node that always rebroadcasts packets once but only after all other routing modes have had their turn. Provides supplemental coverage for local clusters without competing with primary routers.
|
||
- **Client Base** — Treats traffic from/to your favorited nodes with Router Late priority (ensuring those messages get extra relay coverage) while handling everything else as a normal Client.
|
||
- **Client Mute** — You want to receive mesh traffic but not contribute to relaying. Useful for monitoring-only radios or to reduce congestion in dense areas.
|
||
- **Tracker** — An unattended radio whose sole purpose is broadcasting its GPS position (e.g., a vehicle, pet, or asset). Sleeps between broadcasts to conserve battery.
|
||
- **Sensor** — An unattended radio reporting environmental telemetry (temperature, humidity, air quality). Similar power profile to Tracker.
|
||
- **TAK / TAK Tracker** — Only needed if interoperating with ATAK/WinTAK systems. See [TAK Integration](tak) for details.
|
||
|
||
> 💡 **Tip:** The mesh works best when most nodes are **Client** or **Router**. Too many Client Mute nodes reduce mesh resilience; too many Routers in a dense area can cause congestion. A good rule of thumb: one Router per 5–10 Clients in your area.
|
||
|
||
### Security indicators
|
||
|
||
Each node carries one security icon beside its name in the node list. Tap it to read what it means, and choose **Show All Meanings** in that dialog for the full legend. The detail screen shows the same state in words, as a **Security** row that opens the same dialog.
|
||
|
||
Icon | Meaning | Shown for |
|
||
------|---------|-----------|
|
||
Person with a shield check (green) | **Verified contact** — you verified this node's key in person by exchanging contact QR codes, so its identity is confirmed. The strongest trust the list shows. Your own connected node carries it too | Any firmware version |
|
||
Nodes icon with a shield check (green) | **Signed node** — this node signs its broadcasts with its identity key, so its identity is consistent over time, but you have not verified it in person. On firmware 2.8 the icon appears from the version alone, before any signed broadcast has been heard | Firmware 2.8 or newer, and any node whose signed broadcast your node has verified |
|
||
🔒 Closed lock | A public key is on file and matches, so direct messages to this node are encrypted | Firmware before 2.8, or no reported version |
|
||
🔓 Open lock | No public key has been received for this node, so it cannot be direct messaged — use **Request User Info** on the node detail page to ask for one | Firmware before 2.8, or no reported version |
|
||
⚠️ Mismatch | **Public key mismatch** — a different key arrived for this node after one was stored. Investigate before trusting | Any firmware version |
|
||
|
||
Every node on firmware 2.8 or newer signs its broadcasts, so on that firmware the signed state is the baseline and the locks are not shown.
|
||
|
||
Direct messages always use public-key encryption, so your node needs the other node's public key before it can send one. It refuses the send rather than falling back to channel encryption. Keys arrive inside node info, which is why an open lock usually clears itself once that node is heard from properly.
|
||
|
||
A mismatch never replaces the key you already hold. The app keeps the first key it recorded and refuses the new one, as the firmware does, so a stray or hostile node info cannot silently break encrypted messaging to a contact. To clear a mismatch, first confirm through another trusted channel that the key change was intentional — a factory reset causes one. Then touch & hold the node, choose **Remove**, and let the two nodes exchange keys again the next time yours hears it.
|
||
|
||
## Quick Actions
|
||
|
||
From the node list, you can:
|
||
- **Tap** a node to view its detail page
|
||
- **Touch & hold** for quick actions:
|
||
- Mark/remove favorite
|
||
- Mute/unmute notifications
|
||
- Send a direct message
|
||
- Trace route
|
||
- Ignore/unignore
|
||
- Remove
|
||
|
||
Touch & hold **your own node** instead and you get one action, **Update status**, which opens the
|
||
User settings screen with the cursor already in the Status Message field. It only appears while the
|
||
radio is connected and running firmware 2.8 or newer — see
|
||
[Settings — Radio & User](settings-radio-user.md) for the field itself.
|
||
|
||
## Sharing a Contact
|
||
|
||
On a node's detail screen, tap **Share Contact** to produce a link and a QR code for that node. From the same dialog, **Share link** opens the Android share sheet (on desktop it copies the link instead), **Write to NFC tag** saves it to a writable NFC tag, and **Copy** puts it on the clipboard. While that dialog is open and in front of you, the phone also offers the same link to any NFC reader, so someone can take the contact by tapping their phone against yours with no tag involved.
|
||
|
||
Sharing your own contact this way marks it as verified in person, so whoever imports it sees the **Verified contact** icon rather than the signed one. Relaying someone else's contact passes on only what your app had already recorded about them.
|
||
|
||
To add someone else's contact, use the import button on the node list and choose **Scan Shared Contact QR Code**, **Scan Shared Contact NFC**, or **Input Shared Contact URL**. The app asks you to confirm with **Import Shared Contact?**, and warns you when the contact is one you already have.
|
||
|
||
## Filtering & Sorting
|
||
|
||
### Text Search
|
||
|
||
Type in the search field to filter nodes by name or short name. The filter updates in real time as you type.
|
||
|
||
### Filter Toggles
|
||
|
||
Filter | Description |
|
||
--------|-------------|
|
||
**Hide offline nodes** | Show only nodes heard within the last 2 hours |
|
||
**Only show direct nodes** | Show only nodes your radio heard directly, with no relay in between |
|
||
**Include unknown** | Show nodes that haven't sent user info yet. **On by default**, so a node heard before its info arrives stays visible; these carry a badge marking them incomplete, and cannot be direct messaged until their user info brings a public key |
|
||
**Exclude infrastructure** | Hide infrastructure-role nodes (Router, Router Late, Client Base, and legacy Repeater nodes) and any node that cannot be messaged, whatever its role |
|
||
**Exclude MQTT** | Hide nodes heard only via MQTT internet bridge |
|
||
**Signed only** | Show only nodes whose signed broadcasts your node has actually heard and verified. Stricter than the icon: a node on 2.8 shows as signed by its firmware version before any signed broadcast arrives, and a contact verified in person on older firmware is not signed at all |
|
||
**Encrypted only** | Show nodes with a matching public key on file, the key an encrypted direct message needs. A node with a key mismatch is excluded |
|
||
**Only show ignored Nodes** | Replace the list with the nodes you have ignored. Every other node is hidden while this is on, and a banner appears at the top of the list to take you back |
|
||
|
||
### Sort Options
|
||
|
||
Sort | Description |
|
||
------|-------------|
|
||
**Last heard** | Most recently heard nodes first |
|
||
**A-Z** | Sorted by node long name |
|
||
**Distance** | Nearest nodes first (requires position sharing) |
|
||
**Hops away** | Fewest relay hops first |
|
||
**Channel** | Grouped by channel index |
|
||
**via MQTT** | Grouped by MQTT vs. radio-heard |
|
||
**via Favorite** (default) | Favorited nodes first, then the rest |
|
||
|
||
## Nodes per Hop
|
||
|
||
Tap the hop-histogram icon in the node list's app bar to open a bar chart of how many nodes sit at each hop distance (0 = direct, 1 = one relay away, and so on). Filter the chart to a **last heard** window — All time, 1 hour, 8 hours, or 24 hours — to see how the mesh looks right now versus over a longer period. It's a quick way to gauge how busy and spread out your local mesh is.
|
||
|
||
## Node Detail
|
||
|
||
Tapping a node opens the detail view with comprehensive information. See [Node Metrics](node-metrics) for full details on metrics and telemetry.
|
||
|
||
Signal quality is rated against your modem preset. The same SNR can be good on a long-range preset and poor on a faster one. Traceroute and neighbor-info SNR colors use that preset too. RSSI text has its own strength colors; it affects the quality rating only when a noise-floor reading is also available.
|
||
|
||
The Details card carries the node's short name, role, IDs, last heard time, hops away, uptime, and its SNR and RSSI:
|
||
|
||
|
||
|
||
Inline status indicators show key metrics at a glance:
|
||
|
||
Indicator | Screenshot |
|
||
-----------|------------|
|
||
Signal quality |  |
|
||
Battery level |  |
|
||
Hop count |  |
|
||
Last heard |  |
|
||
Distance |  |
|
||
|
||
### Device Links ("I want one")
|
||
|
||
When a node's hardware is recognized, the detail view shows a collapsible **"I want one"** section linking to places to buy or learn more about that device: the vendor's product page, product variants, and regional marketplace listings (such as AliExpress, Amazon, and supported retailers), filtered to your country. Each link opens through the `msh.to` redirect service. Devices with no matching links don't show the section.
|
||
|
||
A full, browsable directory of every link is also available at **Settings → Device Links**. The item is hidden while you have Settings open for a remote node.
|
||
|
||
Some of these are affiliate links. Both places say so above the links: product links may be affiliate links, and purchases may earn Meshtastic a commission.
|
||
|
||
## When No Nodes Appear
|
||
|
||
The list stays empty until your radio hears another node.
|
||
|
||
- **No device connected** — the app is not connected to a radio. See [Connections](connections).
|
||
- **Searching for nodes** — the radio is connected and listening, but nothing has arrived yet. Check that its region and modem preset match the mesh around you, and leave **Include unknown** on so a node that has not yet sent its name still appears. See [Settings — Radio & User](settings-radio-user).
|
||
- A node you expect is missing — check the filter toggles. **Only show direct nodes**, **Exclude MQTT**, and **Exclude infrastructure** each hide a whole category of node.
|
||
|
||
## Related Topics
|
||
|
||
- [Node Metrics](node-metrics) — detailed telemetry dashboards for each node
|
||
- [Messages & Channels](messages-and-channels) — send a direct message to a node
|
||
- [Map & Waypoints](map-and-waypoints) — view node positions geographically
|
||
- [Local Mesh Discovery](discovery) — traceroute and neighbor info for topology exploration
|
||
- [Signal Meter](signal-meter) — understand what the signal bars mean
|
||
</pre>
|
||
</body>
|
||
</html> |