nRF53 Universal — BLE API
Dokumentacja API BLE dla klientów urządzenia nRF53 Universal (Perun).
Architektura komunikacji
Urządzenie udostępnia jeden custom serwis BLE Perun Service z trzema charakterystykami:
| Charakterystyka | UUID (suffix) | Operacje | Przeznaczenie |
|---|---|---|---|
| Data | ...a201 |
Notify | Strumień danych z sensorów |
| Control | ...a202 |
Write + Indicate | Komendy SET/GET i odpowiedzi |
| Device Info | ...a203 |
Read | Informacje o urządzeniu |
flowchart LR
subgraph Urządzenie
S[Sensory] --> A[Aggregator] --> D[Data char\nNotify]
C[Control char\nWrite+Indicate]
I[Device Info\nRead]
end
subgraph Klient
APP[Aplikacja]
end
D -- "Notify" --> APP
APP -- "Write" --> C
C -- "Indicate" --> APP
APP -- "Read" --> I
Szybki start
- Połącz się z urządzeniem (advertising z UUID
457bbb14-...-a200) - Włącz Notify na Data (CCCD) — zaczniesz otrzymywać ramki danych
- Włącz Indicate na Control (CCCD) — umożliwi odbiór odpowiedzi
- Wysyłaj komendy Write na Control — steruj modułami
Sekcje
- Serwis Perun BLE — UUID-y, MTU, format advertising
- Ramka Data — format nagłówka i payload
- Protokół Control — SET/GET, statusy, format ramek
- Moduły — lista modułów i ich ID
- Klucze komend — uniwersalne i moduł-specyficzne
- Kody błędów — poziomy, źródła, przyczyny
- Plik kontekstu AI — jeden plik z całym API do wrzucenia do AI