BLE GATT Integration

Strukturierter 6-Schritte-BLE-GATT-Debug-Workflow, der Radio, Discovery, Attribute, Sicherheit und Durchsatz trennt

von easyzoom · easyzoom/aix-skills

Getestet · Funktioniert ★ 9.2/10

BLE GATT Integration — Strukturierter 6-Schritte-BLE-GATT-Debug-Workflow, der Radio, Discovery, Attribute, Sicherheit und Durchsatz trennt

Was es kann

Eine Debugging-Checkliste für BLE-GATT-Integrationsprobleme – Benachrichtigungen kommen nicht an, CCCD-Probleme, MTU-Abschneidung, Pairing/Bonding/Verschlüsselungsmissverständnisse und geringer Durchsatz – über Zephyr, ESP-IDF, nRF Connect SDK, NimBLE, BlueZ, Android und iOS. Löst aus, wenn ein Benutzer GATT-Dienste, -Merkmale, -Benachrichtigungen oder Verbindungsparameter erstellt oder debuggt; weicht explizit auf Radio/Controller-Bring-up-Anleitungen aus, wenn das Gerät überhaupt nicht werben oder verbinden kann.

Testbericht

Ein Zwei-Fehler-BLE-Szenario wurde damit behandelt (CCCD-Schreiben 'erfolgreich', aber keine Benachrichtigungen kommen an, MTU bleibt bei Standard 23 mit einer 40-Byte-Nutzlast, kein Pairing konfiguriert für eine verschlüsselungspflichtige Eigenschaft) – die Common Failures-Tabelle des Skills ordnet sich direkt beiden realen Ursachen zu (Verschlüsselung ohne Bonding-Gate, ATT-Nutzlast-Abschneidung) und sein 6-Schritte-Workflow deckt beide systematisch auf, während eine ungesteuerte Antwort zu generischen CCCD/Sniffer-Ratschlägen griff und niemals das Sicherheitstor als wahrscheinlichen Hauptblocker nannte.

Getestet am: 2026-07-16 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/easyzoom/aix-skills
mkdir -p ~/.claude/skills
cp -r aix-skills/skills/ble-gatt-integration ~/.claude/skills/ble-gatt-integration

Befehle & Beispiel-Prompts

  • /ble-gatt-integrationStrukturierter 6-Schritte-BLE-GATT-Debug-Workflow, der Radio, Discovery, Attribute, Sicherheit und Durchsatz trennt

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

  • My BLE notifications aren't arriving even though the CCCD write succeeded.
  • Debug why my peripheral's MTU stays at 23 bytes with a 40-byte payload.
  • Pairing seems fine but my encrypted characteristic still won't notify.