docs(connections): describe the screen with no saved devices as it is (#7447)

This commit is contained in:
James Rich authored and GitHub committed 2026-09-29 19:37:31 +00:00
1 parent 9e0594cc5f
commit 17aa3ffc83
1 file changed
+8 -4
+8 -4
View File
@@ -2,7 +2,7 @@
title: Connections
parent: User Guide
nav_order: 2
last_updated: 2026-08-30
last_updated: 2026-09-29
description: Connect your phone or desktop to a Meshtastic radio via Bluetooth, USB, or TCP/IP.
aliases:
- bluetooth
@@ -44,7 +44,7 @@ The screen names anything on the app's side that is blocking a scan, with the fi
| A card asking for **Nearby devices** | The permission has not been granted. **Grant permission** requests it; once Android stops prompting, the button becomes **Open settings**. |
| **Bluetooth is off** | The adapter is disabled — the card opens Bluetooth settings. |
| **Bluetooth scanning also needs location services** | Android 11 and older only: the permission is held but the system location toggle is off. |
| No card, empty list | Nothing on this side is blocking the scan — the radio is out of range, off, or already connected elsewhere. |
| No card, and **No Bluetooth devices seen** under the header | Nothing on this side is blocking the scan. The radio is out of range, off, or already connected elsewhere. |
The explanation lives in that card, not in the scan control: tapping **Scan for Bluetooth devices** after you have declined once asks Android again directly.
@@ -63,9 +63,13 @@ When connecting, a status indicator shows the current connection state — tap *
![Connecting status](../../assets/screenshots/connections_connecting.png)
If no devices are found, the app shows an empty state with instructions:
With no radio chosen yet, the connection card reads **No device selected**. A pane with nothing to list says so under its header, with a hint:
![No devices found](../../assets/screenshots/connections_empty_state.png)
| Pane | What it shows |
|---|---|
| Bluetooth | **No Bluetooth devices seen**, and "Ensure you're within range of the device." Start a scan from the header. |
| Network | **No network devices seen**, and "Ensure you're connected to the same network as the device." Shown only while nothing has been discovered and **Recent Network Devices** is empty. **Add device manually…** stays below it. |
| USB | **No USB devices detected**, and "Connect a device with a USB data cable to use serial." |
### Troubleshooting Bluetooth