Skip to content

MWT API V2.0

Dokumentacja BLE API systemu MWT (Military War Tech) — rodziny bezprzewodowych modułów sensorycznych Bluetooth Low Energy produkowanych przez Perun.

Architektura komunikacji

Urządzenie udostępnia custom serwis BLE Perun Service z czterema charakterystykami:

Charakterystyka UUID (suffix) Operacje Przeznaczenie
Data ...a201 Notify Strumień danych z modułów
Control ...a202 Write + Indicate Komendy SET/GET i odpowiedzi
Device Info ...a203 Read Informacje o urządzeniu (TLV)
RTCM Stream ...a204 Write Without Response Poprawki RTCM3 → GNSS (RTK)

Dodatkowo: standardowy Battery Service (BAS) z procentem baterii.

flowchart TD
    APP(["Aplikacja mobilna"])

    APP -- "READ · NOTIFY" --> BAS["Battery Level\n(BAS)"]
    APP -- "READ" --> DI["Device Info"]
    APP -- "WRITE" --> CTRL["Control"]
    CTRL -- "SET / GET" --> MOD(["Moduły"])
    MOD -- "odpowiedź" --> CTRL
    CTRL -- "INDICATE" --> APP
    MOD -- "dane" --> DATA["Data"]
    DATA -- "NOTIFY" --> APP
    APP -- "WRITE NO RSP" --> RTCM["RTCM Stream"]
    RTCM -- "RTCM3 → UART2" --> GNSS(["ZED-F9P"])

    classDef app fill:#bfdbfe,stroke:#1d4ed8,stroke-width:2px,color:#1e3a5f,font-weight:bold
    classDef svc fill:#bbf7d0,stroke:#15803d,stroke-width:2px,color:#14532d,font-weight:bold
    classDef char fill:#bae6fd,stroke:#0369a1,stroke-width:2px,color:#0c4a6e,font-weight:bold
    classDef mod fill:#fde68a,stroke:#b45309,stroke-width:2px,color:#78350f,font-weight:bold

    class APP app
    class BAS svc
    class DI,CTRL,DATA,RTCM char
    class MOD,GNSS mod

Quick Start

  1. Połącz się z urządzeniem (advertising z UUID service 457bbb14-...-a200)
  2. Ustaw MTU na ≥ 247 B (244 payload + 3B ATT overhead)
  3. Włącz Notify na Data (CCCD) — zaczniesz otrzymywać ramki danych
  4. Włącz Indicate na Control (CCCD) — umożliwi odbiór odpowiedzi
  5. Wysyłaj komendy Write na Control — steruj modułami

Spis treści

Sekcja Opis
Urządzenia Warianty MWT i ich moduły
Perun Service UUID-y, charakterystyki, advertising
Battery Service Standardowy BAS
Device Info TLV z dostępnymi modułami
Ramka Data Format nagłówka i payload
Protokół Control Komendy SET/GET, statusy
Moduły Lista modułów i ich ID
Kody błędów Poziomy, źródła, przyczyny
Klucze komend Uniwersalne i moduł-specyficzne
Kontekst AI Pełne API w jednym pliku dla AI