diff --git a/docs/en/user/connections.md b/docs/en/user/connections.md index 3adc991606..80b447e98f 100644 --- a/docs/en/user/connections.md +++ b/docs/en/user/connections.md @@ -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