Glucose on your watch face: setup guide

Dialforge faces with a glucose field show the last reading from LibreLinkUp, Dexcom Share or Nightscout (which also takes xDrip+, Linx and others). It is a number only, with an arrow and the age of the reading. No alarms.

Not a medical device. The glucose field does not replace your reader, sensor app or alarms and must not be used for treatment decisions. Your credentials stay on your phone and watch and go only to your sensor maker's server or your own Nightscout. Dialforge never receives them.

Quick start

On your phone open Garmin Connect (or Connect IQ), go to your watch, Watch faces, pick the face, Settings.
Find Glucose: source and choose Nightscout, LibreLinkUp or Dexcom Share.
Fill in only the fields for that source (below), then save.
In the face settings pick Glucose in one of the data fields (in Steady faces glucose is always shown).
Wait up to 5 minutes. The watch fetches a new reading about every 5 minutes through your phone's connection, so keep the watch connected to the phone.

Some watches with very little memory have no glucose field or only LibreLinkUp. The face description in the store lists them. After the free trial ends, settings are locked until you unlock the face.

LibreLinkUp (FreeStyle Libre 2 and 3)

The face reads from the LibreLinkUp sharing service, so you need an account in the LibreLinkUp app that sees your sensor. It is not the same as your LibreView or Libre app login.

In your Libre sensor app, share your data with a LibreLinkUp account (Connected apps, LibreLinkUp, add connection). You can use a second e-mail address for yourself.
Install LibreLinkUp, log in with that account and accept the invitation. Check that you see the glucose value there.
In the watch face settings: source LibreLinkUp, account = the LibreLinkUp e-mail, password = its password.
Server region: Outside USA is the default (Europe and the rest of the world). Pick USA or Japan if your account is there. If it is wrong, the app usually redirects by itself.

Dexcom Share (G6, G7, ONE+)

In the Dexcom app turn on Share and add at least one follower (the face reads through the Share service). Without a follower the service may return nothing.
Settings: source Dexcom Share, account = your Dexcom user name or e-mail, password, region (USA, Outside USA, Japan).

This source is new and still in testing. If it does not work for you, please send me the 4-digit code from the watch (see below).

Nightscout and xDrip+ (Linx, Medtronic, Eversense and others)

Nightscout is the general connector. xDrip+ and many other apps can upload to it, so any sensor they support works. You need a Nightscout site reachable from the internet (your own hosting or a service).

In xDrip+: Settings, Cloud Upload, Nightscout Sync (REST-API), enable it and enter your Nightscout address.
If your site is protected, create a read-only access token in Nightscout (Admin tools, Subjects, role readable).
In the watch face settings: source Nightscout, address = https://your-site.example (no extra path), token = the read-only token (leave empty for an open site).

Test the address in a browser: https://your-site.example/api/v1/entries/current.json (add ?token=YOUR_TOKEN if you use one). If you see a reading there, the watch can read it too. This source has been confirmed working by a user with Nightscout Pro.

What the 4-digit code under the dashes means

When the glucose field has no reading it shows dashes and a code. The code tells you where it fails.

Code	Meaning and fix
5001	Missing settings: account, password or address is empty. Fill it in and save. If the fields look empty after saving, update the face to the latest version and enter them again.
1xxx	Login failed: wrong account or password, wrong region, or the invitation was not accepted. Try the same login in the sensor app.
2xxx	The server refused the request: wrong or expired token, or a session that needs a new login. Re-enter the token or password.
3001	No data: no sharing connection, the sensor is warming up, or the follower is missing.
3002	The reading came in an unexpected format. Send me the code.
4000	The request itself failed: the phone has no internet, the watch is not connected to the phone, or Garmin Connect is blocked from running in the background.

The reading turns grey when it is older than 15 minutes in Steady faces. In other faces the age is shown next to the value.

Still stuck

Keep the watch connected to the phone and let Garmin Connect run in the background (turn off battery optimization for it on Android).
If a password contains the characters & < > +, some phones mangle it. Try a password without them.
After you change the source or the account, the first reading can take up to 5 minutes.
Write to kontakt@dialforge.dev with the watch model, the source you use and the code shown. I read everything.

Product names (FreeStyle Libre, LibreLinkUp, Dexcom, Nightscout, xDrip+, Garmin) belong to their owners and are used only to say which services work with the face.

Glukoza na tarczy: jak to ustawić

Tarcze Dialforge z polem glukozy pokazują ostatni odczyt z LibreLinkUp, Dexcom Share albo Nightscouta (przez niego wchodzą też xDrip+, Linx i inne). To sama liczba, ze strzałką i wiekiem odczytu. Bez alarmów.

To nie jest wyrób medyczny. Pole glukozy nie zastępuje czytnika, aplikacji czujnika ani alarmów i nie służy do decyzji o leczeniu. Login i hasło zostają na telefonie i zegarku i trafiają tylko na serwer producenta czujnika albo na Twój Nightscout. Dialforge ich nie dostaje.

Szybki start

W telefonie otwórz Garmin Connect (albo Connect IQ), wejdź w zegarek, Tarcze zegarka, wybierz tarczę, Ustawienia.
Znajdź Glukoza: źródło i wybierz Nightscout, LibreLinkUp albo Dexcom Share.
Uzupełnij tylko pola dla tego źródła (niżej) i zapisz.
W ustawieniach tarczy wybierz Glukoza w jednym z pól danych (w tarczach Steady glukoza jest zawsze).
Poczekaj do 5 minut. Zegarek pobiera nowy odczyt mniej więcej co 5 minut przez połączenie telefonu, więc trzymaj zegarek połączony z telefonem.

Kilka zegarków z bardzo małą pamięcią nie ma pola glukozy albo ma tylko LibreLinkUp. Lista jest w opisie tarczy w sklepie. Po końcu wersji próbnej ustawienia są zablokowane do odblokowania tarczy.

LibreLinkUp (FreeStyle Libre 2 i 3)

Tarcza czyta z usługi udostępniania LibreLinkUp, więc potrzebujesz konta w aplikacji LibreLinkUp, które widzi Twój czujnik. To nie jest ten sam login co LibreView czy aplikacja Libre.

W aplikacji czujnika Libre udostępnij dane kontu LibreLinkUp (Połączone aplikacje, LibreLinkUp, dodaj połączenie). Możesz użyć drugiego adresu e-mail dla siebie.
Zainstaluj LibreLinkUp, zaloguj się tym kontem i przyjmij zaproszenie. Sprawdź, że widzisz tam glukozę.
W ustawieniach tarczy: źródło LibreLinkUp, konto = e-mail LibreLinkUp, hasło = jego hasło.
Region serwera: domyślnie Poza USA (Europa i reszta świata). Wybierz USA albo Japonię, jeśli tam masz konto. Przy złym regionie aplikacja zwykle sama przekierowuje.

Dexcom Share (G6, G7, ONE+)

W aplikacji Dexcom włącz Share i dodaj co najmniej jednego obserwującego (tarcza czyta przez usługę Share). Bez obserwującego usługa może nic nie zwracać.
Ustawienia: źródło Dexcom Share, konto = nazwa użytkownika lub e-mail Dexcom, hasło, region (USA, Poza USA, Japonia).

To źródło jest nowe i w testach. Jeśli u Ciebie nie działa, prześlij mi czterocyfrowy kod z zegarka (patrz niżej).

Nightscout i xDrip+ (Linx, Medtronic, Eversense i inne)

Nightscout to uniwersalny łącznik. xDrip+ i wiele innych aplikacji potrafi do niego wysyłać dane, więc działa każdy czujnik, który obsługują. Potrzebujesz strony Nightscout dostępnej z internetu (własny hosting albo usługa).

W xDrip+: Ustawienia, Cloud Upload, Nightscout Sync (REST-API), włącz i wpisz adres swojego Nightscouta.
Jeśli strona jest chroniona, utwórz w Nightscout token tylko do odczytu (Admin tools, Subjects, rola readable).
W ustawieniach tarczy: źródło Nightscout, adres = https://twoja-strona.pl (bez dodatkowej ścieżki), token = token tylko do odczytu (puste, jeśli strona jest otwarta).

Sprawdź adres w przeglądarce: https://twoja-strona.pl/api/v1/entries/current.json (dopisz ?token=TWOJ_TOKEN, jeśli go używasz). Jeśli widzisz tam odczyt, zegarek też go odczyta. To źródło potwierdził jako działające użytkownik z Nightscout Pro.

Co znaczy czterocyfrowy kod pod kreskami

Gdy pole glukozy nie ma odczytu, pokazuje kreski i kod. Kod mówi, gdzie jest problem.

Kod	Znaczenie i co zrobić
5001	Brak ustawień: konto, hasło albo adres jest puste. Uzupełnij i zapisz. Jeśli po zapisie pola wyglądają na puste, zaktualizuj tarczę do najnowszej wersji i wpisz je jeszcze raz.
1xxx	Logowanie się nie udało: zły login lub hasło, zły region albo niezaakceptowane zaproszenie. Spróbuj tego samego loginu w aplikacji czujnika.
2xxx	Serwer odrzucił żądanie: zły lub wygasły token albo sesja wymaga nowego logowania. Wpisz token lub hasło jeszcze raz.
3001	Brak danych: brak połączenia udostępniania, czujnik się rozgrzewa albo brakuje obserwującego.
3002	Odczyt przyszedł w nieoczekiwanym formacie. Prześlij mi kod.
4000	Samo żądanie nie przeszło: telefon nie ma internetu, zegarek nie jest połączony z telefonem albo Garmin Connect ma zablokowane działanie w tle.

W tarczach Steady odczyt robi się szary, gdy jest starszy niż 15 minut. W pozostałych tarczach wiek jest pokazany obok wartości.

Nadal nie działa

Trzymaj zegarek połączony z telefonem i pozwól Garmin Connect działać w tle (na Androidzie wyłącz dla niego oszczędzanie baterii).
Jeśli hasło zawiera znaki & < > +, niektóre telefony je psują. Spróbuj hasła bez nich.
Po zmianie źródła albo konta pierwszy odczyt może trwać do 5 minut.
Napisz na kontakt@dialforge.dev: model zegarka, używane źródło i kod z tarczy. Czytam wszystko.

Nazwy produktów (FreeStyle Libre, LibreLinkUp, Dexcom, Nightscout, xDrip+, Garmin) należą do ich właścicieli i służą tylko do wskazania, z jakimi usługami współpracuje tarcza.