Bluetooth-communicatie

Dit document behandelt de Bluetooth Low Energy (BLE)-communicatieprotocollen die RADR gebruikt om met ondersteunde apparaten te communiceren.

BLE-overzicht

RADR gebruikt Bluetooth Low Energy (BLE) voor alle apparaatcommunicatie. Als centraal BLE-apparaat scant RADR naar randapparaten zoals OSSM en Lovense-speelgoed en maakt er verbinding mee.

Scanparameters

Tijdens actief scannen verzendt RADR scanverzoekpakketten naar apparaten om hun volledige advertentiegegevens, inclusief apparaatnamen, op te halen.

Verbindingsparameters

RADR gebruikt geoptimaliseerde verbindingsparameters voor responsieve bediening:

Het verbindingsinterval van 15ms zorgt voor een responsieve bediening met minimale latentie tussen encoderbewegingen en de reactie van het apparaat.

Apparaatdetectie

RADR identificeert ondersteunde apparaten aan de hand van hun geadverteerde service-UUID's:

Research And Desire-apparaten

Lovense-apparaten

Buttplug.io-apparaten

Apparaten die worden ondersteund via het Buttplug.io-protocol worden geïdentificeerd met behulp van UUID's uit het dynamische register (registry.json). Dit register kan worden bijgewerkt via firmware-updates zonder codewijzigingen.

OSSM-protocol

RADR communiceert met OSSM via een aangepast BLE-protocol:

Dienststructuur

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

Commandoformaat

Commando's worden als byte-arrays naar het juiste kenmerk verzonden:

Patroonselectie

Patronen worden geselecteerd op index:

Lovense-protocol

Voor Lovense-apparaten met directe integratie (Domi) gebruikt RADR het Lovense-BLE-protocol:

Trillingsregeling

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

Batterijstatus opvragen

Command: Battery;
Response: {percentage}

Voedingsregeling

Command: PowerOff;

Buttplug.io-apparaten

Voor apparaten die via Buttplug.io worden ondersteund, implementeert RADR een subset van het Buttplug-protocol:

• Vibrate — Trillingsniveau instellen (0-1 float, toegewezen aan het apparaatbereik)
• Linear — Voor apparaten met stuwbeweging
• Rotate — Voor roterende apparaten

Niet alle apparaten ondersteunen alle opdrachten. RADR vraagt tijdens de verbinding de apparaatmogelijkheden op.

Verbindingsherstel

Als RADR de verbinding met een apparaat verliest:

1. Detectie — Verbindingsverlies gedetecteerd binnen supervisietime-out (1500ms)
2. Opnieuw verbinden — Automatische poging tot opnieuw verbinden binnen 2-5 seconden
3. Veiligheid — Voor OSSM: geleidelijke afbouw tijdens ontkoppeling
4. Fout — Na een mislukte herverbinding keert RADR terug naar het hoofdmenu

Beveiliging

RADR maakt gebruik van open BLE-verbindingen zonder koppeling of bonding:

• Geen pincode vereist
• Geen versleuteling (opdrachten zijn platte tekst)
• Eén verbinding tegelijk

Foutopsporing

Voor BLE-foutopsporing tijdens de ontwikkeling:

1. Gebruik een BLE-sniffer (nRF Connect, Wireshark met BLE-adapter)
2. Schakel seriële logging in de firmware in (LOG_LEVEL_DEBUG)
3. Bewaak verbindingsgebeurtenissen en schrijfbewerkingen van kenmerken

Verder lezen