Jak to działa
Łączy przeglądarkę z urządzeniem Bluetooth Low Energy i pokazuje całe drzewo GATT: każdą usługę podstawową, zawarte w niej charakterystyki, obsługiwane przez nie operacje (odczyt, zapis, powiadomienie lub wskazanie) oraz powiązane deskryptory, wraz ze 128-bitowym UUID i krótkim 16-bitowym identyfikatorem, gdy element jest standardowy.
Wartości możliwe do odczytu są odczytywane automatycznie i interpretowane zgodnie ze specyfikacją Bluetooth SIG: poziom baterii pojawia się jako procent, usługa Device Information jako producent, model, numer seryjny oraz wersje firmware’u, sprzętu i oprogramowania, a PnP ID jako para identyfikatorów producenta i produktu. To, co nie ma zdefiniowanego znaczenia, jest pokazywane jako tekst, liczba lub zrzut szesnastkowy.
Możesz też subskrybować charakterystyki wysyłające powiadomienia, aby obserwować ich zmiany na żywo — tętno, temperaturę, licznik — i wyeksportować całe przejście do JSON. Narzędzie wyłącznie odczytuje: nigdy nie zapisuje niczego w urządzeniu. Cała komunikacja odbywa się między Twoim komputerem a urządzeniem peryferyjnym przez API Web Bluetooth; nic nie trafia na serwer.
Przykłady
0x180F → 0x2A195B → 91 %Usługa Battery udostępnia jeden bajt z pozostałym poziomem naładowania, więc 0x5B to 91 %.0x180A → 0x2A50 (PnP ID)USB Implementers Forum · VID 0x046D · PID 0xC52B · v1.0.0PnP ID identyfikuje producenta i produkt tymi samymi kodami co USB, więc możesz je wyszukać w katalogu usb.ids.6e400001-b5a3-f393-e0a9-e50e24dcca9eNordic UART ServiceUUID-y 128-bitowe należą do usług producenta; najbardziej rozpowszechnione, jak port szeregowy Nordic, są pokazywane z nazwą.Przypadki użycia
- Sprawdzić, ile baterii zostało czujnikowi, wadze lub urządzeniu ubieralnemu, bez instalowania aplikacji producenta.
- Sprawdzić model, numer seryjny i wersję firmware’u urządzenia przed aktualizacją lub zgłoszeniem gwarancyjnym.
- Podczas tworzenia firmware’u sprawdzić, czy urządzenie peryferyjne rozgłasza oczekiwane usługi i charakterystyki z właściwymi właściwościami.
- Poznać UUID charakterystyki producenta, aby móc jej użyć we własnej aplikacji.
- Sprawdzić na żywo, czy powiadomienia docierają i jak często, gdy aplikacja nie odbiera danych.
- Udokumentować całe drzewo GATT urządzenia, eksportując je do JSON i dołączając do raportu.
Najczęstsze pytania
Dlaczego nie działa na moim iPhonie ani w Firefoksie?
API Web Bluetooth jest zaimplementowane w przeglądarkach opartych na Chromium — Chrome, Edge i Opera — dla Windows, macOS, Linux, ChromeOS i Android. Firefox i Safari go nie implementują, a w iOS wszystkie przeglądarki korzystają z silnika systemu, więc tam również jest niedostępne. Potrzebne są też HTTPS i włączony Bluetooth.
Urządzenie jest włączone, ale nie pojawia się na liście.
Zwykle są trzy powody: urządzenie peryferyjne jest już połączone z inną aplikacją lub innym komputerem i przestało się rozgłaszać; nie jest w trybie wykrywalnym, który w wielu urządzeniach włącza się przytrzymaniem przycisku; albo wybrany filtr jest zbyt wąski. Wypróbuj opcję pokazującą wszystkie pobliskie urządzenia i zmniejsz odległość.
Dlaczego widzę mniej usług niż w aplikacji natywnej?
Strona internetowa widzi tylko usługi, o które poprosiła przed połączeniem, dlatego narzędzie żąda wszystkich standardowych i pozwala dodać znane Ci UUID producenta. Przeglądarka prowadzi też listę usług zablokowanych ze względów bezpieczeństwa — w tym urządzeń wejściowych (HID) i usług aktualizacji firmware’u — których żadna strona nie może odczytać.
Co oznaczają właściwości charakterystyki?
Odczyt oznacza, że wartość można pobrać w dowolnej chwili. Zapis i zapis bez odpowiedzi wskazują, że urządzenie przyjmuje dane — z potwierdzeniem lub bez. Powiadomienie i wskazanie oznaczają, że to urządzenie samo wysyła wartość przy zmianie; różnica polega na tym, że wskazanie wymaga potwierdzenia od klienta, więc jest wolniejsze, ale pewniejsze.
Dlaczego jedne elementy mają krótki UUID, a inne bardzo długi?
Identyfikatory 16-bitowe, takie jak 0x180F czy 0x2A19, są zarezerwowane przez Bluetooth SIG i mają znaczenie zdefiniowane w specyfikacji, dlatego narzędzie pokazuje ich oficjalne nazwy. UUID 128-bitowy należy do producenta: co zawiera, wie tylko jego własna aplikacja, choć zawartość i tak jest pokazywana jako tekst, liczba lub wartość szesnastkowa.
Czy narzędzie może coś zapisać lub zmienić w urządzeniu?
Nie. Odczytuje tylko wartości i włącza wybrane przez Ciebie powiadomienia, co jest subskrypcją, a nie zmianą konfiguracji urządzenia. Nigdy nie zapisuje do charakterystyki, więc nie ma ryzyka pozostawienia urządzenia w nieoczekiwanym stanie.
Czy dane urządzenia opuszczają mój komputer?
Nie. Połączenie realizuje przeglądarka przez adapter Bluetooth Twojego komputera, a żadna odczytana wartość nie trafia na serwer. Uprawnienie nadajesz osobno dla każdego urządzenia w selektorze przeglądarki i możesz je w każdej chwili cofnąć.