So funktioniert es
Verbindet den Browser mit einem Bluetooth-Low-Energy-Gerät und zeigt dessen kompletten GATT-Baum: jeden primären Dienst, die enthaltenen Merkmale, die von jedem unterstützten Operationen (Lesen, Schreiben, Benachrichtigen oder Anzeigen) und die zugehörigen Deskriptoren – mit 128-Bit-UUID und der kurzen 16-Bit-Kennung, sofern das Element standardisiert ist.
Lesbare Werte werden automatisch ausgelesen und gemäß der Bluetooth-SIG-Spezifikation ausgewertet: Der Akkustand erscheint als Prozentwert, der Dienst Device Information als Hersteller, Modell, Seriennummer sowie Firmware-, Hardware- und Software-Version, und die PnP ID als Paar aus Hersteller- und Produktkennung. Alles ohne definierte Bedeutung wird als Text, als Zahl oder als Hex-Dump angezeigt.
Du kannst dich außerdem für Merkmale mit Benachrichtigungen anmelden und ihre Änderungen live verfolgen – Herzfrequenz, Temperatur, Zähler – und den gesamten Durchlauf als JSON exportieren. Das Werkzeug liest nur: Es schreibt nie auf das Gerät. Die gesamte Kommunikation läuft über die Web-Bluetooth-API zwischen deinem Rechner und dem Peripheriegerät; nichts geht an einen Server.
Beispiele
0x180F → 0x2A195B → 91 %Der Dienst Battery stellt ein einzelnes Byte mit der Restladung bereit, 0x5B entspricht also 91 %.0x180A → 0x2A50 (PnP ID)USB Implementers Forum · VID 0x046D · PID 0xC52B · v1.0.0Die PnP ID identifiziert Hersteller und Produkt mit denselben Codes wie USB – du kannst sie also im Katalog usb.ids nachschlagen.6e400001-b5a3-f393-e0a9-e50e24dcca9eNordic UART Service128-Bit-UUIDs gehören zu herstellereigenen Diensten; die verbreitetsten, etwa der serielle Port von Nordic, werden mit ihrem Namen angezeigt.Anwendungsfälle
- Nachsehen, wie viel Akku einem Sensor, einer Waage oder einem Wearable bleibt – ohne die Hersteller-App zu installieren.
- Modell, Seriennummer und Firmware-Version eines Geräts prüfen, bevor du es aktualisierst oder einen Garantiefall meldest.
- Während der Firmware-Entwicklung prüfen, ob das Peripheriegerät die erwarteten Dienste und Merkmale mit den richtigen Eigenschaften bereitstellt.
- Die UUID eines herstellereigenen Merkmals herausfinden, um es in der eigenen Anwendung zu nutzen.
- Live prüfen, ob und wie häufig Benachrichtigungen ankommen, wenn eine Anwendung keine Daten empfängt.
- Den kompletten GATT-Baum eines Geräts als JSON exportieren und einem Bericht beilegen.
Häufige Fragen
Warum funktioniert es auf meinem iPhone und in Firefox nicht?
Die Web-Bluetooth-API ist in Chromium-basierten Browsern implementiert – Chrome, Edge und Opera – unter Windows, macOS, Linux, ChromeOS und Android. Firefox und Safari unterstützen sie nicht, und unter iOS nutzen alle Browser die System-Engine, also ist sie dort ebenfalls nicht verfügbar. Zusätzlich sind HTTPS und eingeschaltetes Bluetooth nötig.
Das Gerät ist eingeschaltet, erscheint aber nicht in der Liste.
Meist gibt es drei Gründe: Das Peripheriegerät ist bereits mit einer anderen Anwendung oder einem anderen Rechner verbunden und sendet keine Werbepakete mehr; es ist nicht im sichtbaren Modus, der bei vielen Geräten durch langes Drücken einer Taste aktiviert wird; oder der gewählte Filter ist zu eng. Probiere die Option mit allen Geräten in der Nähe und verringere den Abstand.
Warum sehe ich weniger Dienste als in einer nativen Anwendung?
Eine Webseite sieht nur die Dienste, die sie vor dem Verbinden angefragt hat. Deshalb fordert das Werkzeug alle Standarddienste an und lässt dich bekannte herstellereigene UUIDs ergänzen. Zusätzlich pflegt der Browser eine Sperrliste aus Sicherheitsgründen – darunter Eingabegeräte (HID) und Firmware-Update-Dienste –, die keine Seite lesen darf.
Was bedeuten die Eigenschaften eines Merkmals?
Lesen bedeutet, dass der Wert jederzeit abgefragt werden kann. Schreiben und Schreiben ohne Antwort zeigen an, dass das Gerät Daten annimmt – mit oder ohne Bestätigung. Benachrichtigung und Anzeige bedeuten, dass das Gerät den Wert bei Änderungen selbst sendet; der Unterschied ist, dass die Anzeige eine Bestätigung des Clients verlangt und daher langsamer, aber zuverlässiger ist.
Warum haben manche Elemente eine kurze UUID und andere eine sehr lange?
16-Bit-Kennungen wie 0x180F oder 0x2A19 sind vom Bluetooth SIG reserviert und in der Spezifikation definiert, deshalb zeigt das Werkzeug sie mit ihrem offiziellen Namen. Eine 128-Bit-UUID gehört dem Hersteller: Nur dessen eigene Anwendung weiß, was darin steckt – der Inhalt wird trotzdem als Text, Zahl oder Hexadezimalwert angezeigt.
Kann das Werkzeug etwas auf dem Gerät schreiben oder ändern?
Nein. Es liest nur Werte und aktiviert die von dir gewählten Benachrichtigungen – das ist ein Abonnement und keine Änderung der Gerätekonfiguration. In ein Merkmal wird nie geschrieben, es besteht also kein Risiko, das Peripheriegerät in einem unerwarteten Zustand zu hinterlassen.
Verlassen die Gerätedaten meinen Rechner?
Nein. Die Verbindung stellt der Browser über den Bluetooth-Adapter deines Rechners her, und kein ausgelesener Wert wird an einen Server gesendet. Die Berechtigung erteilst du Gerät für Gerät in der Browser-Auswahl und kannst sie jederzeit widerrufen.