Die BlueBattery-Integration installieren

Jetzt wird es spannend: Dein BB-Display schickt seine Werte an Mosquitto, HACS ist eingerichtet – es fehlt nur noch das Stück, das aus diesen Werten übersichtliche Geräte in Home Assistant macht. Das ist die BlueBattery-Integration.

Installation und Einrichtung sind in wenigen Minuten erledigt. Und am Ende siehst du dein BB-Display mit allen gekoppelten Geräten in Home Assistant – bereit für Frostschutz, Vorheizen und Warnungen.

⏱️ Dauer	ca. 10 Minuten
🎓 Schwierigkeit	Einsteiger
🧰 Du brauchst	HACS und ein BB-Display, das mit Mosquitto verbunden ist (BB-Display einbinden)
🎯 Ergebnis	BlueBattery mit allen gekoppelten Geräten unter Einstellungen → Geräte & Dienste

Inhalt

• Warum die Integration?
• Schritt 1 – Die Integration über HACS installieren
• Schritt 2 – BlueBattery einrichten
• Ein kurzer Rundgang
• Geräte später hinzufügen
• Wenn etwas nicht klappt
• Wie geht es weiter?

Was die Integration mitbringt

Die Integration setzt auf dem auf, was das BB-Display ohnehin liefert, und macht daraus übersichtliche Geräte. Du richtest sie über die Oberfläche ein, ohne eine Konfigurationsdatei anzufassen. Dazu bringt sie fertige Vorlagen mit:

• 🧩 Fertige Vorlagen: Frostschutz, Vorheizen, Heizungsstörung, Tank- und Batteriewarnung – mit wenigen Klicks eingerichtet.
• 🏠 Alles an einem Ort: Das BB-Display erscheint als Zentrale, darunter alle gekoppelten Geräte – Batteriecomputer, Tanks, Temperatursensoren, Heizung.
• 🔔 Neue Geräte meldet sie von selbst: Koppelst du im Display einen weiteren Sensor, fragt Home Assistant, ob er übernommen werden soll.
• 🔥 Die Heizung sicher im Griff: Befehle werden geprüft und bestätigt, Störungen kommen mit Fehlercode an.

Schritt 1 – Die Integration über HACS installieren

BlueBattery steht noch nicht im allgemeinen Verzeichnis von HACS. Der folgende Knopf trägt sie mit einem Klick bei dir ein:

1. Auf den Knopf klicken → Open link. HACS fragt, ob das Repository hinzugefügt werden soll → Hinzufügen.
2. Unten rechts Herunterladen → die neueste Version bestätigen → Herunterladen.
3. Home Assistant neu starten: Einstellungen → System → ⏻ → Home Assistant neu starten.

🔍 Zum Vergrößern ins Bild klicken

Knopf klappt nicht? So geht es von Hand

1. HACS öffnen → ⋮ oben rechts → Benutzerdefinierte Repositories.
2. Repository: https://github.com/sahomm/BlueBattery, Typ: Integration → Hinzufügen.
3. In HACS nach BlueBattery suchen → Herunterladen → neueste Version bestätigen.
4. Home Assistant neu starten.

Schritt 2 – BlueBattery einrichten

Nach dem Neustart hat Home Assistant dein BB-Display meist schon entdeckt.

Im Menü: Einstellungen → Geräte & Dienste → oben unter „Entdeckt“ steht BlueBattery – BB-Display → Hinzufügen.

1. Bestätigen. Die Integration prüft kurz, ob das Display aktuelle Daten sendet. Das kann bis zu einer Minute dauern.
2. Geräte auswählen: Angezeigt werden alle Geräte, die im Display gekoppelt sind. Hake an, was du in Home Assistant haben möchtest.
3. Fertig.

Nicht unter „Entdeckt“? Dann unten rechts Integration hinzufügen → „BlueBattery“ → das Topic aus dem Display eingeben. In der Werkseinstellung ist das BlueBattery/BB-Display.

Ein kurzer Rundgang

Klick in der Liste auf ein Gerät, und du siehst alle seine Werte. Ein paar Dinge, die du wissen solltest:

Was	Was du dort findest
BB-Display	Innentemperatur, Luftfeuchte, Taupunkt, Verbindung – und einen Link zur Einstellungsseite des Displays
Batteriecomputer	Ladezustand, Spannung, Strom, Solar, Booster, Starterbatterie, Energiezähler
Tanks	Füllstand in % und Litern, Neigung (für die Wasserwaage)
Temperatursensoren	Temperatur, Luftfeuchte, Batterie
Heizung	Thermostat, Boiler, Fehlercode – mehr in Heizung steuern

Warum sehe ich nur einen Batteriecomputer? Das BB-Display reicht genau einen Batteriecomputer weiter – den, der im Display ausgewählt ist.

Geräte später hinzufügen

Neuer Tank, weiterer Temperatursensor, TIN-Adapter nachgerüstet? Kein Problem:

1. Das Gerät im BB-Display koppeln.
2. Kurz warten – Home Assistant meldet unter Einstellungen → Reparaturen: „Neues BlueBattery-Gerät gefunden“.
3. Einstellungen → Geräte & Dienste → BlueBattery → Konfigurieren → das neue Gerät anhaken → Speichern.

Vorhandene Geräte, Werte und ihr Verlauf bleiben dabei unverändert. Ein abgewähltes Gerät wird nur deaktiviert, der Verlauf bleibt. Ist ein Gerät kurz außer Reichweite, erscheint es als „nicht verfügbar“, wird aber nicht entfernt.

Wenn etwas nicht klappt

BlueBattery erscheint nicht unter „Entdeckt“

• Zeigt das Display oben das Verbindungssymbol ⇄? Wenn nicht, ist es nicht mit Mosquitto verbunden – siehe BB-Display einbinden.
• Ist die Integration über HACS installiert und Home Assistant danach neu gestartet?
• Einrichtung von Hand: Integration hinzufügen → „BlueBattery“ → Topic BlueBattery/BB-Display.

Ein Gerät fehlt in der Auswahl

Die Integration zeigt nur Geräte, die im BB-Display gekoppelt sind und von dort gerade gemeldet werden. Gerät im Display koppeln bzw. als Batteriecomputer auswählen, Reichweite prüfen und dann Konfigurieren erneut öffnen.

Alle Werte stehen auf „nicht verfügbar“

Das Display sendet gerade keine Daten, zum Beispiel weil es aus oder außer WLAN-Reichweite ist. Sobald es wieder sendet, erscheinen die Werte von selbst. Die Integration zeigt bewusst „nicht verfügbar“ statt alter Werte – damit du dich auf die Anzeige verlassen kannst.

Ich sehe alle Werte doppelt

Die Home-Assistant-Anbindung im Display ist noch eingeschaltet. Schalte im Display unter MQTT den Schalter „Home Assistant“ aus – mehr dazu in Wechsel auf die Integration.

HACS meldet „Failed to download … 404“

Beim Herunterladen wurde statt einer Version eine Kennung wie 21ff56e gewählt. HACS → BlueBattery → ⋮ → Erneut herunterladen und die neueste Version auswählen.

Einen Fehler melden

Einstellungen → Geräte & Dienste → BlueBattery → ⋮ → Diagnose herunterladen (Adressen sind darin geschwärzt) und die Datei an einen Eintrag auf GitHub anhängen – oder unten einen Kommentar schreiben.

---

Wie geht es weiter?

Geschafft – dein Fahrzeug ist in Home Assistant angekommen! Jetzt wird es richtig nützlich: In Heizung steuern bedienst du Truma oder Alde aus Home Assistant, und in den Praxisbeispielen richtest du Frostschutz, Vorheizen und Warnungen mit fertigen Vorlagen ein.

Kapitel 4 von 7 im Thema BlueBattery

Fragen oder Anregungen? Schreib gern einen Kommentar!