Bluetooth-Kommunikation

Dieses Dokument behandelt die Bluetooth Low Energy (BLE)-Kommunikationsprotokolle, die RADR zur Kommunikation mit unterstützten Geräten verwendet.

BLE-Übersicht

RADR nutzt Bluetooth Low Energy (BLE) für die gesamte Gerätekommunikation. Als BLE-Zentralgerät scannt RADR nach Peripheriegeräten wie OSSM und Lovense-Spielzeugen und verbindet sich mit ihnen.

Scan-Parameter

Während des aktiven Scannens sendet RADR Scananforderungspakete an Geräte, um deren vollständige Advertising-Daten einschließlich der Gerätenamen abzurufen.

Verbindungsparameter

RADR verwendet optimierte Verbindungsparameter für eine reaktionsfähige Steuerung:

Das Verbindungsintervall von 15ms ermöglicht eine reaktionsfähige Steuerung mit minimaler Latenz zwischen Encoderumdrehungen und Gerätereaktion.

Geräteerkennung

RADR identifiziert unterstützte Geräte anhand ihrer angekündigten Service-UUIDs:

Research And Desire-Geräte

Lovense-Geräte

Buttplug.io-Geräte

Über das Buttplug.io-Protokoll unterstützte Geräte werden mithilfe von UUIDs aus der dynamischen Registrierung (registry.json) identifiziert. Diese Registrierung kann über Firmware-Updates ohne Codeänderungen aktualisiert werden.

OSSM-Protokoll

RADR kommuniziert mit OSSM über ein benutzerdefiniertes BLE-Protokoll:

Servicestruktur

Service: 522B443A-4F53-534D-0001-420BADBABE69
├── Position Characteristic
├── Speed Characteristic
├── Depth Characteristic
├── Sensation Characteristic
├── Stroke Characteristic
└── Pattern Characteristic

Befehlsformat

Befehle werden als Byte-Arrays an das entsprechende Merkmal gesendet:

Musterauswahl

Muster werden nach Index ausgewählt:

Lovense-Protokoll

Für Lovense-Geräte mit direkter Integration (Domi) verwendet RADR das Lovense-BLE-Protokoll:

Vibrationssteuerung

Command: Vibrate:{level};
Level: 0-16

Batterieabfrage

Command: Battery;
Response: {percentage}

Steuerung der Stromversorgung

Command: PowerOff;

Buttplug.io-Geräte

Für über Buttplug.io unterstützte Geräte implementiert RADR eine Teilmenge des Buttplug-Protokolls:

• Vibrate – Vibrationsstufe einstellen (0-1-Gleitkommazahl, auf den Gerätebereich abgebildet)
• Linear – Für Geräte mit Schubbewegung
• Rotate – Für rotierende Geräte

Nicht alle Geräte unterstützen alle Befehle. RADR fragt während der Verbindung die Gerätefunktionen ab.

Verbindungswiederherstellung

Wenn RADR die Verbindung zu einem Gerät verliert:

1. Erkennung – Verbindungsverlust innerhalb des Überwachungszeitlimits (1500ms) erkannt
2. Wiederverbindung – Automatischer Wiederverbindungsversuch innerhalb von 2-5 Sekunden
3. Sicherheit – Für OSSM sanftes Herunterregeln während der Trennung
4. Fehler – Nach fehlgeschlagener Wiederverbindung kehrt RADR zum Hauptmenü zurück

Sicherheit

RADR nutzt offene BLE-Verbindungen ohne Pairing oder Bonding:

• Keine PIN erforderlich
• Keine Verschlüsselung (Befehle sind Klartext)
• Einzelne Verbindung gleichzeitig

Debuggen

Zum BLE-Debugging während der Entwicklung:

1. Verwenden Sie einen BLE-Sniffer (nRF Connect, Wireshark mit BLE-Adapter)
2. Aktivieren Sie die serielle Protokollierung in der Firmware (LOG_LEVEL_DEBUG)
3. Überwachen Sie Verbindungsereignisse und Schreibvorgänge an Merkmalen

Weiterführende Literatur