Device Scanning

This guide explains how RADR discovers nearby Bluetooth devices and establishes connections.

Automatic Scanning

When you power on RADR, it automatically scans for nearby supported Bluetooth devices.

Scan Behavior

• Duration: 5 seconds
• LED Indicator: Blue pulsing during scan
• Status Message: "Searching for nearby devices..."

During the scan:

1. RADR broadcasts as "OSSM-REMOTE" with high transmit power (9 dBm)
2. It searches for devices advertising supported service UUIDs
3. Discovered devices are added to the device list

Manual Scanning

To start a manual scan:

1. From the main menu, select Device Search
2. RADR scans for 5 seconds
3. After scanning, the device list appears

Device List

After scanning, the device list shows all discovered devices:

• Devices are shown by their advertised Bluetooth name
• If a device has no name, it appears as "Unknown Device"
• The list is scrollable if multiple devices are found

Navigating the Device List

Connecting to a Device

When you select a device from the list, RADR initiates a connection:

Connection Status Messages

You'll see these status messages in sequence:

1. "Initializing connection..." — Setting up the connection process
2. "Checking existing connections..." — Verifying no conflicts
3. "Attempting fast reconnect..." — Trying quick reconnection if previously paired
4. "Creating new connection..." — Establishing a new Bluetooth connection
5. "Connecting to [address]..." — Connecting to the specific device
6. "Connected! Setting up device..." — Connection established, configuring
7. "Discovering device capabilities..." — Reading device features
8. "Device ready!" — Connection complete, entering control mode

Connection Parameters

RADR uses optimized connection parameters for responsive control:

Connection Failures

If connection fails, you'll see:

• "Connection failed, please try again." — General connection failure
• "Connection limit reached!" — Too many active BLE connections
• "Device service not found!" — Device doesn't have expected services

Troubleshooting Connection Issues

One Device at a Time

To disconnect and switch devices:

1. From the control screen, press left button to access the menu (when paused)
2. Navigate back to the main menu
3. Start a new device search

Device Registry

RADR uses a two-tier device registry to identify supported devices:

Built-in Registry

• Hardcoded support for Research And Desire devices (OSSM)
• Always available and cannot be modified
• Provides full-featured control interfaces

Dynamic Registry (registry.json)

• Stored in RADR's internal filesystem (LittleFS)
• Contains Buttplug.io device UUIDs and configurations
• Can be updated via firmware updates without changing the core application
• This allows faster device support additions

When scanning, RADR checks both registries to identify devices by their Bluetooth service UUIDs.

Supported Device Types

Reconnection Behavior

If RADR loses connection to a device:

1. RADR automatically attempts to reconnect within 2–5 seconds
2. For OSSM: The machine gradually ramps down for safety
3. If reconnection fails, return to the main menu and rescan

Tips