Obsługa i rozwiązywanie problemów

Jak używać panelu

Po poprawnym skonfigurowaniu, panel wyświetla bieżącą glikemię:

Na ekranie widzimy, od lewej:

• migający wskaźnik aktualności glikemii
• wartość glikemii
• deltę 5 minutową
• strzałkę trendu

Wskaźnik aktualności glikemii

Pokazuje, jak dawno temu pomiar został wykonany: - migająca 1-sza zielona kropka - mniej niż minutę temu - migająca 2-ga zielona kropka - mniej niż dwie minuty temu i tak dalej,

• 🟩 kropki zielone to odpowiednio od 1 do 5 minuty
• 🟨 kropki żółte to od 6 do 10 minuty
• 🟧 kropki pomarańczowe to od 11 do 15 minuty
• 🟥 a czerwone - od 16 do 20

W trybie nocnym kropki nie migają, a w konfiguracji odcieni szarości, zamiast kolorów - rozmiar (ilość pixeli) w kropkach wskazuje przedział czasu:

• ⠛ kropki z 4 pixeli to od 1 do 5 minuty
• ⠋ kropki z 3 pixeli to od 6 do 10 minuty
• ⠉ kropki z 2 pixeli to od 11 do 15 minuty
• ⠁ kropki jedno pixelowe - od 16 do 20

Glikemia

Bieżąca glikemia wyrażona w mg/dL

Na dziś system nie obsługuje jednostki mmol/L. (Zbyt mało użytkowników w Polsce/Europie z niej korzysta, i nie mam dostępu do testowego źródła danych. Jeśli chcesz wesprzeć projekt w tym temacie, skontaktuj się ze mną.)

Delta 5 minut

Delta to różnica pomiędzy poprzednim pomiarem, 5 minut temu, a bieżącym. Pokazuje jak szybko zmienia się glikemia. Ta wartość pochodzi z Nightscouta.

Trend

Strzałka trendu wizualizuje jak szybko zmienia się glikemia (jaka jest delta) - określana jest na podstawie delty i wyliczana przez Nightscout

Komunikaty błędów

Brak / stare odczyty

Czasami zdarzają się "dziury" w odczytach z CGM/FGM. Jest bardzo wiele ich powodów - niektóre z nich to zakłócenia Bluetooth, chwilowe wstrzymanie odczytu w sensorze (bo pomiary surowe za bardzo "wariują"), problemy w odbiorniku (Android ubije aplikację odczytującą, zanik WiFi) lub na serwerze Nightscout (restart, aktualizacja). To wszystko spowoduje, że najpierw wyświetlany wynik będzie coraz starszy, ponad typowe max 6-7 minut. Zauważysz to po zmianie koloru/wyglądu wskaźnika aktualności glikemii:

Gdy wynik jest zbyt stary lub "dziura" w danych jest zbyt długa - albo w Nightscout nie ma danych glikemii - pojawia się komunikat o starych danych:

Problemy z WiFi

W przypadku zaniku internetu - tzn. sieć WiFi działa, ale nie ma dostępu do internetu - zobaczysz komunikat o błędzie WiFi lub Łączeniu do Nightscouta. Te komunikaty mogą wyświetlać się przez kilka minut w czasie prób łączenia do WiFi / Nightscouta, ale jeśli trwają dłużej - sprawdź Internet w domu, WiFi i czy serwer Nightscout poprawnie działa i jest dostępny (np. będąc na WiFi, wejdź na telefonie na swój adres Nightscout; to samo sprawdź, przełączając się na internet mobilny)

Szczególnym przypadkiem jest komunikat Brak WiFi. Oznacza on, że sterownik nie widzi wcześniej skonfigurowanej sieci WiFi. Sprawdź telefonem, czy dana sieć nadal jest widoczna. Jeśli nie - sprawdź ustawienia lub zrestartuj router. Jeśli jest widoczna na telefonie - zrestartuj sterownik. Jeśli to nie pomoże - ustaw sterownik w inny sposób lub bliżej routera WiFi. Jeśli to nie pomaga, a masz sterownik na bazie ESP32-C3 SuperMini - rozważ przejście na urządzenie na bazie Seeed Xiao ESP32-C3 lub S3, które mają zewnętrzną, większą antenkę WiFi i lepiej radzą sobie z widocznością sieci WiFi.

Problemy z Nightscout-em

Jeśli nie można połączyć się z serwerem Nightscout z powodów związanych z siecią, ale sterownik ma dostęp do internetu (tylko nie potrafi połączyć się z Nightscout) wyświetlony zostanie komunikat NS Offline. Sprawdź czy coś nie blokuje Twojej strony Nightscout (np.: operator, narzędzia typu Firewall/Z-Scaller, zabezpieczenia wbudowane w routerze).

Jeśli z jakiegoś powodu sterownik nie potrafi "zrozumieć" odpowiedzi z Nightscout wyświetli czerwony komunikat Serwer NS. To nie powinno nigdy się zdarzyć - może masz złą wersję serwera lub "coś" między serwerem a sterownikiem dodaje/modyfikuje odpowiedź. Sprawdź co pokazuje zakładka Nightscout w Panelu Administracyjnym Nightscout - czy nie ma tam śmieci, błędów lub innych głupot.

Jeśli podany przez Ciebie adres URL wskazuje na Nightscout, ale sterownik wykrył, że serwer uległ awarii lub wyświetla nie mające sensu (lub niekompatybilne ze sterownikiem) dane - zobaczysz komunikat Serwer padł

Sprawdź wtedy, czy na telefonie, w przeglądarce Chrome jesteś w stanie połączyć się do Nightscouta. Jeśli adres nie działa lub wyświetla błąd - napraw lub zrestartuj serwer Nightscout zgodnie z instrukcją producenta.

Jeśli korzystasz z tworzonego przeze mnie projektu "Nightscout na Mikr.us-ie":

• poczekaj kilka minut, możliwe że watchdog wykryje problem i zrestartuje serwer
• upewnij się że - jeśli korzystasz z AAPS - ustawiłeś flagę Wysyłaj dane wolniej (AAPS → menu trzy kropki → Ustawienia → NSClientV3 → Ustawienia zaawansowane)
• regularnie sprzątaj na serwerze, jeśli brakuje miejsca - posprzątaj!
• zrestartuj kontenery, serwer i sprawdź inne problemy

„W xDrip-ie jest już wynik, a na panelu jeszcze nie!”

To normalne i oczekiwane, że wynik ma 6-7 minut, po czym aktualizuje się i ma minutę!

Zanim wynik trafi na wyświetlacz, sensor przesyła go do swojej aplikacji, następnie zazwyczaj jest "wyciągany" z zamkniętego ekosystemu producenta do otwartego za pomocą kolejnej aplikacji (BYODA, xDrip, Juggluco, patched...) i wysyłany do Nightscouta. Cały ten proces trwa czasami nawet 2-3 minuty. Aplikacje dalej w tym "łańcuszku" nie wiedzą, czy nowy wynik jest już dostępny, czy nie - muszą to aktywnie sprawdzać. Aby oszczędzać baterię i nie przeciążać serwera, większość tych aplikacji - i nasz sterownik - nie sprawdza dostępności wyniku co sekundę, a co kilkadziesiąt sekund/kilka minut - stąd opóźnienie.

Tak naprawdę większość systemów CGM i FGM bada glikemię w płynie śródtkankowym, a nie w krwi włośniczkowej (jak glukometr) czy pełnej (jak przy badaniach krwi). Już to sprawia, że pokazywana glikemia jest opóźniona (kilka-kilkanaście minut) i różni się od tej bieżącej. Plus, każdy glukometr i CGM/FGM mają błąd pomiaru wpisany w mechanizm ich działania - określa to MARD. Dla glukometrów zazwyczaj jest to ±15 mg/dL poniżej zakresu i ±15% w zakresie i powyżej, dla Libre 2 około 20%.

Dlaczego to piszę? To, co pokazuje Twój CGM/FGM, Nightscout, a w konsekwencji - panel - zawsze jest niedokładne i opóźnione. To nie jest tylko "dupokrytka" że dokumentacja zaczyna się od zdania, aby nie polegać na wskazaniach panelu w terapii! Zawsze przed podaniem insuliny na wysoki cukier, albo przed dosłodzeniem na hipo - sprawdź glukometrem. Panel ma być TYLKO kolejnym miejscem na które "rzuca się okiem" aby stale być czujnym, oprócz zegarków, tapet, widżetów i aplikacji na telefonach - które przypominają nam o stanie glikemii.

Dołożyłem wszelkich starań, aby sterownik możliwie szybko aktualizował wynik, jednocześnie nie psując serwera Nightscout. Logika ustalania, kiedy i jak często odświeżać wynik, jest w sterowniku bardzo rozbudowana - i celowo przemyślana!

Cierpliwości!

Doświadczenie z projektu "Nightscout na Mikr.us-e", który rozpocząłem i pomagam administrować - pokazuje że dziesiątki osób i wiele aplikacji/gadżetów jest źle zaprogramowana i/lub skonfigurowana. Potrafią kilkanaście razy na sekundę sprawdzać czy jest nowy wynik, efektywnie robiąc DDoS serwerowi (zasypując go pracą).

Czasami jest to wynik "niecierpliwości" lub OCD rodzica/pacjenta/użytkownika, ustawiającego odświeżanie wyniku "co sekundę" zamiast np. "co minutę". To - z wszystkich powodów opisanych powyżej - nie ma sensu! A praktyka terapeutyczna pokazuje, że zbyt kompulsywne śledzenie glikemii często łączy się z jej "micro managementem" i ręcznym "pomaganiem" systemom takim jak pętle - co daje paradoksalnie gorsze wyniki!

To jest tanie rozwiązanie

Aby nie było wątpliwości - projekt używa takich paneli LED, których główną zaletą jest to, że są tanie. Dlatego musimy dostosować nasze oczekiwania i uważać na istotne ograniczenia tego panelu - w stosunku do rozwiązań takich jak dedykowane wyświetlacze, lub Ulanzi TC001:

• panel jest "głupi" - nic nie wie o sterowniku ani o tym co wyświetla. Jeśli straci zasięg sterownika - będzie uparcie wyświetlał ostatnią animację którą otrzymał. Nie daje też znać sterownikowi co sam wyświetla.
• panel nie ma funkcji alarmu - nie ma głośnika, nie będzie alarmował dźwiękiem o niskich lub wysokich cukrach
• to zabawka! - nie mam pojęcia jak długo przeżyje, czy diody LED są podatne na wypalenie

Aby - przy tych ograniczeniach - zapewnić w miarę bezpieczne korzystanie, zaprojektowałem szereg rozwiązań, które mogą być widoczne (i irytujące), ale ich celem jest zapobiegnięcie mylącemu działaniu panelu:

1. Sterownik wysyła do panelu animacje GIF - bo jedyne działają stabilnie i da się w nich "zaszyć" czas wyświetlania poszczególnych informacji/klatek. Panel wspiera wiele innych trybów - animowane kolorowe teksty itp., ale ich praktyczne łączenie w przewidywalny i niezawodny sposób okazało się niemożliwe.

2. Domyślna i jedyna wgrana na stałe animacja to informacja o wersji z animacją łączenia do sterownika. W wypadku restartu lub utraty zasięgu wyświetla się domyślnie, sugerując, że panel oczekuje na sterownik, który dopiero go ustawi.

   

3. Animacja glikemii jest wysyłana jako animacja tymczasowa, co minutę, chyba że wynik z Nightscouta przyjdzie szybciej. Animacja ma wygenerowane klatki "w przyszłość", które pokazują rosnący wiek glikemii, po czym błąd połączenia. W razie utraty zasięgu sterownika lub jego awarii - panel pokaże, że glikemia jest coraz starsza, a potem - że sterownik nie jest podłączony i nie aktualizuje glikemii.

   

4. Animacja domyślna wgrywana jest przy każdym parowaniu z panelem, na wszelki wypadek - bo nie wiemy jaki jest stan jego pamięci.

W zamian masz tanie rozwiązanie, które da się w miarę łatwo kupić, a panel jest sam w sobie gotowym produktem, nie wymaga lutowania, ma opakowanie - jeśli kupisz w Action, to nawet z gwarancją.

Inne rozdzielczości matryc

Panel 32x32

Rozwiązywanie problemów, krok po kroku

1. Sprawdź, czy Twój sensor i system CGM/FGM działa i pokazuje aktualne odczyty?
2. Sprawdź, czy w Nightscout jest aktualny wynik z CGM/FGM? Czy serwer Nightscout działa? Czy odpowiednia aplikacja wysyła do niego glikemię?
3. Sprawdź, czy sieć WiFi, do której podłączony jest sterownik, działa, a sterownik ma prawidłowe hasło?
4. Zobacz, czy możesz połączyć się do Access Pointa sterownika z telefonu komórkowego (sieć WiFi akszon-led-skaut-****, adres: 192.168.5.1)? Czy w panelu nie ma dodatkowych szczegółów błędu? Czy w panelu widać Twoją sieć WiFi i urządzenie BLA panela LED?
5. Czy panel pokazuje komunikat błędu? Czy wskaźnik aktualności glikemii się animuje?
6. Odłącz i podłącz ponownie do zasilania: panel i sterownik. Zrestartuj domowe WiFi.
7. Sprawdź, czy nie ma nowszej wersji firmware sterownika. Jeśli jest, zrób aktualizację OTA
8. Przeczytaj jeszcze raz sekcję powyżej odnośnie komunikatów o błędach i sposobie ich rozwiązywania.
9. Jeśli nic nie pomaga - poszukaj postów w temacie na grupie Technologie Diabetyka.
10. Najpierw użyj lupki - dopiero potem napisz posta z pytaniem!
11. Zanim zapytasz - przeczytaj artykuł Jak mądrze zadawać pytania

Szanujmy się...

Pominięcie kolejności wymienionej powyżej będzie skutkować asertywną ale szorstką reakcją z mojej strony

Na grupie jest kilka tysięcy użytkowników, kilku administratorów i jeden ja. Rozumiem, że wygodniej jest zapytać w minutę, niż czytać przez 5 minut, ale nie jestem (i nie jesteśmy jako admini) w stanie 24/7 odpisywać na prywatne wiadomości. Ekosystem narzędzi cukrzycowych DIY / Open Source jest skomplikowany i różnorodny, to jego największa bolączka a zarazem siła. Od tego mamy grupę wsparcia na FB aby razem uczyć się i wspólnie rozwiązywać problemy.

To jest projekt DIY - "zrób to sam", trochę inicjatywy i wysiłku w jego skonfigurowaniu i użytkowaniu będzie od Ciebie wymagane! Nawet jeśli stworzyłem dla Ciebie to darmowe oprogramowanie lub odsprzedałem po kosztach kilka części; nawet jeśli wsparłeś dodatkowo ten projekt finansowo lub w inny sposób - nie będę w stanie indywidualnie, za każdym razem i na każde zawołanie go konfigurować lub naprawiać!

Jako admin TD dostawałem "pilne" wiadomości na priv w niedzielę w wannie i w tygodniu w środku spotkania w pracy Taki brak empatii lub roszczeniowa postawa jest na szczęście bardzo rzadka, ale w skali, w jakiej działamy - to kilka-kilanaście osób. Sam jestem chory, robię to w wolnym czasie, bo wierzę, że to czyni świat lepszym i w ten sposób "spłacam" mój dług wobec reszty osób, które zaangażowały się i stworzyły Nightscouta, AAPSa - i setkę innych technologii. Będę dumny i szczęśliwy, jeśli panel choć trochę pomoże Ci w codziennym życiu z cukrzycą. Proszę - doceń, wspieraj ten projekt i szanuj mój czas i dobrowolne zaangażowanie