Specyfikacja techniczna

Generator Broadcast Android do emulacji danych CGM xDrip+

1. Cel projektu

Opracowanie aplikacji Android (Foreground Service), generującej realistyczne dane CGM/glukozy i wysyłającej je przez zgodny z xDrip broadcast:

Intent("com.eveningoutpost.dexdrip.BgEstimate")

Aplikacja jest przeznaczona do:

• testowania backendu Nightscout,
• testowania powiadomień Telegram,
• testowania pipeline'u przetwarzania,
• testowania odbiornika Android,
• demonstracji,
• środowisk CI/staging,
• opracowywania SaaS dla CGM.

2. Główne wymagania

Aplikacja musi:

• działać bez sensora,
• nie wymagać sprzętu BLE,
• działać offline,
• obsługiwać Foreground Service,
• działać w tle,
• przetrwać reboot,
• automatycznie się odzyskiwać,
• obsługiwać Android 10–16,
• obsługiwać zgodność z xDrip+.

3. Format broadcast

Akcja

com.eveningoutpost.dexdrip.BgEstimate

Extras

Przykład broadcast

val intent = Intent(
 "com.eveningoutpost.dexdrip.BgEstimate"
)

intent.putExtra("mgdl", 126.0)

intent.putExtra(
 "timestamp",
 System.currentTimeMillis()
)

intent.putExtra("direction", "Flat")
intent.putExtra("noise", 1)

sendBroadcast(intent)

4. Realistyczny model glukozy

Zamiast generatora losowego użyć silnika krzywej

Generator powinien budować:

• płynne zmiany,
• realistyczne nachylenia,
• realistyczne opóźnienia,
• realistyczną zmienność.

5. Obsługiwane stany

5.1 Normalna glukoza

Zakres:

80–140 mg/dL

Zmiany:

• płynne,
• bez nagłych skoków,
• realistyczny dryf.

5.2 Symulacja posiłku

Wsparcie:

• mały posiłek,
• średni posiłek,
• wysokowęglowodanowy posiłek.

Zachowanie:

Po posiłku:

• wzrost po 10–20 minutach,
• szczyt po 45–90 minutach,
• stopniowy spadek.

Przykład krzywej

100
110
125
145
165
180
170
150
130
115

5.3 Symulacja insuliny

Wsparcie:

• szybka insulina,
• bolus korekcyjny.

Zachowanie:

• opóźniony początek,
• stopniowe zmniejszenie,
• logika zapobiegania hipoglikemii.

Przykład

190
180
165
150
135
120
105

5.4 Symulacja hipoglikemii

Zakres:

40–69 mg/dL

Wsparcie:

• stopniowa hipoglikemia,
• szybka hipoglikemia,
• hipoglikemia nocna.

Wartości kierunku

Wsparcie:

• DoubleUp
• SingleUp
• FortyFiveUp
• Flat
• FortyFiveDown
• SingleDown
• DoubleDown

5.5 Niskie wartości kompresji

Symulacja:

• ostrego fałszywego spadku,
• szumów w odczytach,
• szybkiego powrotu.

Przykład

120
118
85
60
52
48
110
115

5.6 Błędy sensora

Wsparcie:

• tymczasowe nieprawidłowe odczyty,
• niemożliwe wartości,
• luki w znacznikach czasu,
• utknięte wartości.

Typy błędów

Skok błędu

400 mg/dL

Zamrożenie sensora

120
120
120
120

Brak pakietów

Brak broadcastów.

5.7 Symulacja rozgrzewki

Po uruchomieniu:

• 30–120 minut rozgrzewki,
• opcjonalny tryb bez danych,
• opcjonalne niestabilne odczyty.

6. Symulacja utraty pakietów

Wsparcie:

• konfigurowalna stawka utraty pakietów,
• opóźnione pakiety,
• zdublowane pakiety.

Przykłady

Utrata:

co 10. pakiet jest pomijany

Opóźnienie:

pakiet wysyłany z opóźnieniem 30–90 sek

7. Symulacja szumów

Poziomy szumów:

8. Foreground Service

Wymagania

Aplikacja musi:

• pokazywać powiadomienie persistent,
• nie być usuwana przez system,
• działać po zablokowaniu ekranu,
• obsługiwać autostart.

9. Wymagania UI

Ekran główny

Powinien wyświetlać:

• aktualną glukozę,
• aktualny trend,
• aktualny tryb,
• aktywną symulację,
• licznik pakietów,
• status broadcastu.

Przyciski

10. Ustawienia

Interwał wysyłania

Konfigurowalny:

1–5 minut

Jednostka

Wsparcie:

• mg/dL
• mmol/L

Mnożnik prędkości

Dla przyspieszonej symulacji:

x1
x2
x5
x10

11. Architektura

Zalecany stack

12. Logowanie

Logować:

• wysłane broadcasty,
• wartości glukozy,
• utraty pakietów,
• błędy,
• stan symulacji.

13. Eksport

Wsparcie:

• eksport JSON,
• eksport CSV,
• odtwarzanie sesji.

14. Dodatkowe funkcje (opcjonalne)

Wsparcie MQTT

Publikacja:

glucose/current

HTTP POST

Wysyłanie do backendu:

{
 "glucose": 125,
 "timestamp": 1234567890,
 "direction": "Flat"
}

15. Zgodność

Sprawdzić zgodność z:

• xDrip+
• Nightscout
• słuchaczami Juggluco
• niestandardowym BroadcastReceiver
• AndroidAPS

16. Kryteria gotowości

Projekt uznaje się za gotowy, jeśli:

• broadcasty są odbierane przez xDrip+,
• glukoza jest wyświetlana poprawnie,
• symulacja działa stabilnie,
• wykonanie w tle nie jest zatrzymywane,
• utrata pakietów jest poprawnie symulowana,
• realistyczne krzywe wyglądają wiarygodnie.