Granboard über Bluetooth¶

Ein Granboard ist eine Softdartscheibe mit Bluetooth. Home Assistant empfängt seine Darts über sein eigenes Bluetooth, über einen Adapter des Rechners von Home Assistant oder einen ESPHome-Bluetooth-Proxy irgendwo im Haus, und spielt damit jedes Spiel, das Training und die Statistiken wie auf einer Dartscheibe ohne Autodarts. Niemand muss einen Dart eingeben, und kein Handy, kein Browser und keine Windows-App muss mit dem Board verbunden bleiben.

Experimentell. Die Integration liest die Frames des Granboards so, wie Open-Source-Apps für das Granboard sie lesen, und ihre Tests spielen sie ab, aber ein echtes Board hat sie noch nicht getroffen. Zählt ein Feld falsch, prüfe jedes Feld und melde es; die Kennzeichnung fällt, sobald ein echtes Board bestanden hat.

Auf dieser Seite: Was du brauchst · Einrichten · Spielen · Die Verbindung · Jedes Feld prüfen · Fehlersuche · Woher die Frames stammen

Was du brauchst¶

Ein Granboard mit Bluetooth. Die Frames sind die des Granboard 3s; ein anderes Modell, das andere Frames sendet, zeigt sie in der Diagnose.
Bluetooth von Home Assistant: ein Adapter des Rechners, auf dem Home Assistant läuft, oder ein ESPHome-Bluetooth-Proxy in Reichweite des Boards, mit aktiven Verbindungen, wie sie die fertigen Proxys haben. Home Assistant 2026.8 oder neuer, wie für die ganze Integration.
Das Board frei: Ein Granboard nimmt eine Verbindung zur Zeit an, also schließe die Granboard-App oder einen Browser, der mit ihm verbunden ist.

Einrichten¶

Schalte das Board ein. Home Assistant findet es von selbst und bietet es unter Einstellungen → Geräte & Dienste → Entdeckt an; wähle Hinzufügen. Hast du das Angebot verworfen, wähle die Schaltfläche oben oder öffne Einstellungen → Geräte & Dienste → Integration hinzufügen → Autodarts, wähle Granboard über Bluetooth (experimentell) und das Board.
Gib dem Board einen Namen, etwa Granboard oder Kneipe, und wähle Absenden. Die Integration legt ein Gerät mit diesem Namen und dem Modell Granboard an, mit den Entitäten der Spiele, des Trainings und der Statistiken und der Diagnose-Entität Granboard-Verbindung.
Lege das Dashboard an: Einstellungen → Dashboards → Dashboard hinzufügen → Autodarts. Seine Ansichten Live und Anzeigetafel zeigen die Darts, sobald sie das Board treffen.

Spielen¶

Starte ein Spiel auf der Anzeigetafel wie auf jedem Board und wirf:

Jeder Treffer ist ein Dart des Spielers am Board, in seinem Feld: Single, Double, Triple, Single-Bull oder Bullseye. Das innere und das äußere Single einer Zahl zählen gleich.
Die Taste neben dem Board beendet die Aufnahme, wie Nächster Spieler. Ohne Dart passt sie, wo das Spiel ein Passen erlaubt.
Ein Dart neben dem Board ist einer, den das Board nicht sieht: Tippe Fehlwurf auf dem Tastenfeld, oder beende die Aufnahme mit der Taste.
Ein Dart im falschen Feld, nach einem Abpraller oder einer klemmenden Spitze: Tippe ihn auf der Anzeigetafel an und lege ihn in ein anderes Feld, wie auf jeder Dartscheibe ohne Autodarts. Das Tastenfeld, die Aktionen und der Sprach-Blueprint funktionieren neben dem Board weiter.
Ein vierter Dart einer Aufnahme zählt nicht, und die Darts, während der Bot wirft, auch nicht; drücke zuerst die Taste.

Die Board-Ereignisse wie visit_completed oder leg_won kommen mit manual: true und der Quelle manual, wie für jeden in Home Assistant eingegebenen Dart, also funktionieren die Blueprints unverändert. Das Board meldet nicht, wo in einem Feld ein Dart steckt, also zählen seine Darts nicht für die Dartpositionen und ihre Streuung; das Trefferbild der Felder zählt sie.

Die Verbindung¶

Granboard-Verbindung, eine Diagnose-Entität des Boards, ist Verbunden, solange das Board es ist.
Ein Board, das weggeht, weil es schläft, ausgeschaltet oder außer Reichweite ist, verbindet sich wieder, sobald Home Assistant es erneut sieht. Eine Verbindung, die scheitert, wird nach 2, 4, 8 und bis zu 300 Sekunden erneut versucht.
In den ersten zwei Sekunden, nachdem sich das Board verbunden hat, werden seine Frames verworfen, weil ein Board seinen letzten Treffer beim Verbinden noch einmal melden kann.
Ohne Bluetooth von Home Assistant sagt es das Protokoll, und die Darts werden auf dem Tastenfeld eingegeben, bis Bluetooth eingerichtet und die Integration neu geladen ist.

Jedes Feld prüfen¶

Hilf mit deinem Board, die Kennzeichnung experimentell zu entfernen:

Öffne Einstellungen → Geräte & Dienste → Autodarts, das Menü (⋮) → Debug-Protokollierung aktivieren.
Drücke jedes Feld mit einem Dart oder einem Finger. Das Protokoll unter Einstellungen → System → Protokolle nennt jeden Frame und sein Feld, etwa Granboard frame '3.4': T20.
Ein Frame, den die Integration nicht kennt, heißt unknown. Die Diagnose des Boards, Diagnose herunterladen im selben Menü, listet die letzten zehn unter connection → granboard → unknown_frames, mit den Zahlen der Verbindungen, Frames, Darts und Tastendrücke.
Melde ein Feld, das falsch zählt, oder einen unbekannten Frame in einem Issue, mit dem Frame und dem Feld, das du getroffen hast. Die Diagnose lässt die Bluetooth-Adresse des Boards weg.

Fehlersuche¶

Symptom	Was zu tun ist
Kein Board gefunden	Schalte das Board ein, bringe es in Reichweite eines Adapters oder Proxys, und schließe jede App, die mit ihm verbunden ist. Einstellungen → Bluetooth listet, was Home Assistant sieht.
Granboard-Verbindung bleibt aus	Ein Proxy verbindet sich mit wenigen Geräten zugleich; gib einen frei oder stelle einen Proxy nahe ans Board. Das Debug-Protokoll nennt den Grund jedes gescheiterten Versuchs.
Ein Treffer zählt nicht	Ein vierter Dart, der Zug des Bots und die ersten zwei Sekunden nach dem Verbinden zählen nicht. Sonst prüfe das Feld.
Ein Feld zählt falsch	Prüfe jedes Feld und melde es. Korrigiere den Dart bis dahin auf der Anzeigetafel.

Woher die Frames stammen¶

Das Board sendet pro Treffer ein paar ASCII-Zeichen, die Zeile und den Pin des Schalters unter dem Feld, etwa 3.4@, und BTN@ für die Taste. Die Integration kennt sie so, wie die MIT-lizenzierten Apps gran-app von sobassy und granboard-app von bastiennoel93 sie lesen; die Tests von custom_components/autodarts/granboard.py spielen aufgezeichnete Frames gegen einen Ersatz für Bleak und das Bluetooth von Home Assistant ab. Die Lichter des Rings bleiben vorerst aus: Keine App dokumentiert, wie man sie verlässlich setzt. Entscheidung 0024 (auf Englisch) erklärt die Wahl.