Mesh delivery failures have a small set of root causes — wrong channel, disabled radio, mismatched key phrase, or range. Work through the checks below in order.
Messages send but no mesh delivery icon (stays gray or only shows satellite)
Check 1 — Is Mesh Radio enabled?
-
Open the Somewear plugin and tap Hardware Settings.
-
Scroll to the Mesh Radio toggle.
-
Tap the toggle to turn Mesh Radio ON.
Check 2 — Is another device nearby? Are all devices on the same channel?
Node requires an implicit acknowledgement from a nearby Node repeating a message it originated to mark a mesh message as successfully delivered. All Nodes must share the same Mesh Radio Channel to communicate with one another over that network, a mismatch may prevent message receipt.
-
Tap Hardware Settings → Mesh Radio Channel.
-
Note the channel shown.
-
Coordinate with teammates to confirm every device shows the same channel.
-
If your channel differs, tap the correct channel, then tap Change to confirm.
Check 3 — Are devices within mesh range?
The Node uses two LoRa mesh radios with a limited operational range. Terrain, structures, and foliage reduce effective range significantly.
-
Tap Hardware Settings → Mesh Transmission Strength.
-
Tap High, then tap Change to confirm.
-
If devices remain out of range at High strength, close the distance or move to terrain with better line of sight.
Check 4 — Are both LoRa antennas functioning?
- Tap Hardware Settings → Network.
- Check Radio 1 and Radio 2.
| Status | Meaning |
|---|---|
| Green check | Antenna connected and functioning |
| Missing check or warning | Antenna hardware issue — do not operate until resolved |
If either radio shows no green check, the Node has a hardware fault. Do not attempt field repair. Replace the Node or contact your support chain.
Teammate cannot receive mesh messages after a key rotation
Cause: The teammate’s device missed the key rotation broadcast. Their Mesh Key Phrase (a human-readable representation of the active encryption key — display only, not the key itself) no longer matches the rest of the team, and mesh messages are silently discarded.
Fix — Admin rebroadcast:
-
Tap Hardware Settings → Mesh Key Phrase.
-
Tap Rebroadcast Key.
-
Allow 1–2 minutes for all team devices to receive and apply the updated key.
If the key phrase mismatch persists after rebroadcast, have the Admin manually re-enter the key phrase on the affected device.