Bluetooth

Scan for nearby Bluetooth devices, inspect details, and connect to supported peripherals.

Bluetooth Overview: scanning status and nearby devices

Scan results are sorted by signal strength (RSSI)

Overview

The Bluetooth tool uses CoreBluetooth to scan for nearby devices, show signal strength (RSSI), and optionally connect to connectable peripherals.

Table of Contents

• Overview
• Overview Screen
• Device Details Screen
• Permissions And Requirements
• Notes And Limitations
• Troubleshooting

Overview Screen

Search

Use the search field at the top to filter devices by name.

Bluetooth Status Card

The status card shows:

• Current Bluetooth state (Powered On, Powered Off, Unauthorized, Unsupported, etc.)
• A scan control button (only when Bluetooth is Powered On)
  • Start Scanning
  • Stop Scanning

Device List

Devices are listed in a scrollable list and sorted by RSSI (strongest signal first).

Each row can show:

• Device name (or [No Name] when the name is not advertised)
• RSSI value
• A small status line:
  • Connected (green)
  • Connectable (blue)
  • Services: N when the device advertises services
  • Not connectable when the device cannot be connected

Tap a device row to open Device Details.

Device Details Screen

The Device Details screen includes:

• A back button to return to the device list
• A Connect / Disconnect button (when the device is connectable)
• A signal strength gauge
• Tabs:
  • Info: general device information
  • Services: discovered services and characteristics (only available when connected)
  • Data: live data view (when available)

When you connect, the tool discovers services and characteristics. Readable characteristics are read automatically, and notify-capable characteristics are subscribed to.

Permissions And Requirements

• If Bluetooth permission is denied, Lirum shows a permissions screen with a button to open iOS Settings.
• If Bluetooth is powered off, the tool is still accessible, but scanning controls are disabled until Bluetooth is turned on.

Notes And Limitations

• What you can see depends on what peripherals advertise and what iOS exposes via CoreBluetooth.
• RSSI for connected devices is refreshed periodically (every ~2 seconds).
• Some devices may appear as [No Name].

Troubleshooting

• No devices found: Make sure Bluetooth is on, stay on the Bluetooth screen for a few seconds, and try Start Scanning.
• Permission denied: Open iOS Settings from the permission prompt and re-enable Bluetooth access for Lirum.
• Connect fails: Many devices are not connectable, or require pairing in Settings first.