Installation der Home-Assistant-Integration

Diese Integration zeigt die Daten Ihres JK BMS Web Gateway (Zellspannungen, Gesamtspannung/-strom/-leistung, SOC/SOH, Temperaturen, MOSFET- und Alarmstatus) direkt in Home Assistant an — ganz ohne Firmware-Änderungen. Sie verbindet sich einfach mit der bestehenden lokalen Schnittstelle des Geräts, genau wie dessen eigenes Web-Dashboard.

Was Sie benötigen

• Ein JK BMS Web Gateway mit aktivierter Lizenz (über seine eigene Webseite — das Feld „Licencia" in der Kopfzeile). Ohne dies schlägt die Einrichtung der Integration mit einem Lizenzfehler fehl.
• Home Assistant, erreichbar im selben lokalen Netzwerk wie das Gerät.
• Eine Möglichkeit, Dateien in den config-Ordner Ihres Home Assistant hochzuladen — z. B. die Add-ons Studio Code Server, Samba share oder File editor (alle im Add-on Store verfügbar).

1. Integration herunterladen und installieren

2. Dashboard hinzufügen

Es gibt drei fertige Dashboards, jedes als eigener Download. Wählen Sie eines:

A. Automatisches Dashboard (empfohlen)

Findet alle in der Integration eingerichteten Akkus und ihre tatsächliche Zellenzahl selbst — ein Tab pro RS485-Adresse 00–15. Nichts anzupassen.

Automatisches Dashboard herunterladen (.zip)

strategy:
  type: custom:jkbms-fleet-strategy

B. Statisches Dashboard (YAML)

Klassisches YAML für einen 16-Zellen-Akku mit festen Entitätsnamen. Praktisch, wenn Sie es von Hand anpassen möchten.

Statisches Dashboard herunterladen (.zip)

Hat Ihr Akku nicht 16 Zellen, passen Sie die Zeilen sensor.jk_bms_cell_<n>_voltage / _resistance an. Wird „In YAML bearbeiten“ beim Standard-Dashboard nicht angeboten, verwenden Sie ein neues Dashboard von Grund auf.

C. JK-BMS Overview (Aussehen des Gateways, mit Diagrammen)

Es sieht aus wie das eigene Dashboard des Gateways: die Batterie mit Ladezustand, Gerätedaten, Zellen, Temperaturen, Status und alle Schutzeinstellungen des BMS, dazu Wettervorhersage und Spotpreise, wenn sie im Gateway eingeschaltet sind. Zusätzlich zeichnet es den Verlauf von Spannung, Strom, Leistung, Ladezustand und Zellstreuung für 1 Stunde bis 7 Tage, mit einer Summe der geladenen und entladenen Energie. Es braucht keine HACS-Karten. Erforderlich ist die Integration in Version 1.4.0 oder neuer (oben erneut herunterladen und Home Assistant neu starten).

Was das Dashboard zeigt

• Reiter Gerät 00 – 15 — wie am Gateway. Beim Öffnen wird die erste Batterie angezeigt, die Daten liefert; Adressen ohne Batterie sind abgeblendet.
• Batterie — eine große Ladezustandsanzeige mit zehn Segmenten.
• Gerätedaten — Anbieter-ID, Seriennummer, Hardware- und Firmware-Version, Einschaltzähler, Gesamtlaufzeit und Datum des ersten Einschaltens.
• Hauptwerte — Batteriespannung, Strom, Leistung, Ladezustand, verbleibende und volle Kapazität, Zyklenzahl.
• Verlauf in einem Diagramm — Leistung als Balken (grün Laden, orange Entladen) und Linien für Spannung, Strom, Ladezustand und Zelldifferenz. Zeitraum 1 h, 6 h, 24 h oder 7 Tage; der Cursor zeigt alle Werte zum gewählten Zeitpunkt.
• Zusammenfassung des Zeitraums — geladene und entladene Energie in kWh, Lade- und Entladespitze, niedrigste und höchste Spannung, größte Zelldifferenz.
• Zellen — die Spannung jeder Zelle mit Balken, niedrigste und höchste Zelle farblich abgesetzt, Durchschnitt, Differenz in mV und Balancing-Zustand.
• Temperaturen und Status — Sensoren T1 – T5 und MOSFET, Lade- und Entlade-MOSFET, Gesundheitszustand (SOH), Laufzeit. Aktive Alarme erscheinen in einem roten Banner.
• BMS-Schutzeinstellungen — 29 Werte in sechs Gruppen: Zellspannungsschutz, Packspannung, Stromschutz, Temperaturschutz, Balancing und Sonstiges. Nur lesbar.
• Wetter und Strom — die Vorhersage mit geschätztem PV-Ertrag und Spotpreise, sofern sie in den Einstellungen des Gateways eingeschaltet sind.

JK-BMS Overview herunterladen (.zip)

views:
  - title: JK-BMS Overview
    type: panel
    cards:
      - type: custom:jkbms-overview-card

Die Reiter „Gerät 00“ bis „Gerät 15“ öffnen die in der Integration eingerichteten Batterien; beim Öffnen wird die erste angezeigt, die Daten liefert. Die Diagramme nutzen Verlauf und Statistiken von Home Assistant und füllen sich daher erst einige Minuten nach dem Hinzufügen der Integration. Strom und Leistung tragen das Vorzeichen des Gateways: + Laden, − Entladen. Alle drei Dashboards tragen einen Link „Erstellt von: www.jkbms.sk“ — JK-BMS Overview oben rechts, das automatische und das statische als letzte Karte jedes Reiters.

Farbstufen des Akkus

Die Dashboards A und B färben Ladezustand, Akkuspannung und jede Zelle nach denselben LiFePO4-Stufen und enthalten eine Legendenkarte mit dieser Tabelle. Akkuspannung = Zellspannung × Zellenzahl (hier 16S).

Die Anzeigen für SOC und Akkuspannung sind Standardkarten von Home Assistant. Die Zellbalken brauchen sensor-bar-card-plus und das Leistungsdiagramm apexcharts-card — beide über HACS → Frontend installieren (nach Namen suchen → Herunterladen).

Sensoren werden kurz „Unavailable" — das ist normal

Wenn manche Sensoren gelegentlich für ein paar Sekunden „Unavailable" anzeigen und dann mit einem echten Wert zurückkehren, ist das kein Fehler der Integration oder des Dashboards — genau so reagiert das System, wenn das Gerät gerade keine Daten vom BMS über den RS485-Bus lesen konnte (z. B. vorübergehende Störung). Die Integration zeigt bewusst nie einen veralteten oder erfundenen Wert an. Sind Sensoren dauerhaft nicht verfügbar, liegt ein anderes, echtes Problem vor — siehe Fehlerbehebung unten.

Fehlerbehebung

• Lizenzfehler beim Hinzufügen: öffnen Sie zuerst die eigene Webseite des Geräts und aktivieren Sie dort die Lizenz (Licencia → Overiť), dann erneut versuchen.
• „Cannot connect" beim Hinzufügen: IP-Adresse/Host prüfen und ob das Gerät von Home Assistant aus überhaupt erreichbar ist — versuchen Sie, http://<Geräte-IP>/api/info im Browser im selben Netzwerk zu öffnen.
• Sensoren sind dauerhaft nicht verfügbar, nicht nur gelegentlich: prüfen Sie die Diagnosesensoren „License verified" und „Last error" unter dem Gerät in Home Assistant sowie, ob das Gateway überhaupt eingeschaltet und erreichbar ist.
• Zu Hause funktioniert alles, aber außerhalb des Heim-WLANs (im Mobilfunknetz) lädt Home Assistant nicht: Integration und Home Assistant laufen nur in Ihrem Netz. Wie Sie von außen per VPN hineinkommen, beschreibt die Anleitung Fernzugriff.
• Option „Im YAML-Editor bearbeiten" fehlt: ein Standard-Dashboard bietet diese Option erst an, nachdem Sie es einmal bearbeitet oder ein neues von Grund auf angelegt haben.

DEYE Web Gateway in Home Assistant

Für das DEYE Web Gateway (dreiphasige DEYE-Hybridwechselrichter SUN-xK-SG04LP3 / SG05LP3) gibt es eine eigene Integration und ein fertiges Dashboard im selben Aussehen wie der Reiter „Übersicht“ des Gateways: das Haus mit animierten Energieflüssen, Tageserzeugung und -verbrauch, Diagramme, Wettervorhersage, Spot-Strompreise und die AC-Anschlüsse je Phase. Es gelten dieselben Voraussetzungen wie oben — aktivierte Lizenz auf dem Gateway und dasselbe lokale Netzwerk.

Was das Dashboard zeigt

• Vier Hauptkacheln — PV-Erzeugung (jetzt, heute, gesamt, PV1 und PV2), Hausverbrauch, Batterie (Ladezustand, Laden oder Entladen) und Netz (Bezug und Einspeisung heute).
• Das Haus mit Energieflüssen — PV, Netz, Haus, Batterie und der GEN-Anschluss (Generator, Smart Load oder Mikrowechselrichter) mit animierten Punkten. Die Richtung zeigt, wohin die Energie fließt; Anzahl und Tempo der Punkte steigen mit der Leistung.
• Tageserzeugung und -verbrauch — wie viel der Erzeugung ins Haus, ins Netz und in die Batterie ging und wie viel des Verbrauchs von der Sonne, aus dem Netz und aus der Batterie kam — in kWh und in Prozent.
• Vier Diagramme des Tages — PV-Leistung, Batteriestand, Hausverbrauch und Netzleistung (Bezug oben, Einspeisung unten).
• Wettervorhersage — für die kommenden Tage mit Sonnenstunden, Temperaturen und einer Ertragsschätzung in kWh aus Ihrer PV-Spitzenleistung (kWp).
• Strom — der aktuelle Spotpreis (OKTE für die Slowakei, OTE für Tschechien) mit der Einstufung günstig / Durchschnitt / teuer, Bezugs- und Einspeisepreis mit Ihren Gebühren und MwSt., Bezug und Einspeisung von heute in Geld und ein Diagramm für heute und morgen.
• Drei Tabellen — Erzeugung und Verbrauch heute, Batteriestatus (Leistung, Spannung, Strom, Temperatur, geladene und entladene kWh) und Wechselrichterausgang (Phasen, Frequenz, Temperaturen, Netzspannung).
• AC-Anschlüsse je Phase — Netz, Last, GEN-Anschluss und Wechselrichterausgang — Spannung, Leistung und Strom auf L1, L2 und L3.
• Zustand des Wechselrichters — online oder offline, Betriebszustand sowie aktive Warnungen und Fehler.

Die Integration legt außerdem rund 80 Entitäten an (Leistungen, Energien, Batterie, Phasen, Temperaturen), die Sie in Automationen und im Energie-Dashboard verwenden können.

1. Integration

DEYE-Integration herunterladen (.zip)

2. Dashboard

DEYE-Dashboard herunterladen (.zip)

views:
  - title: DEYE Gateway
    type: panel
    cards:
      - type: custom:deye-overview-card

Die Karte findet ihre Entitäten selbst, es muss nichts angepasst werden. Wettervorhersage, Standort, PV-Spitzenleistung (kWp), Spotpreise und Gebühren, Hausnummer und Kennzeichen kommen aus den Einstellungen des Gateways (Webserver-Einstellungen auf dessen Seite) — eine Änderung erscheint in Home Assistant innerhalb von 10 Minuten, sofort nach ⋮ → Neu laden an der Integration. Die Diagramme nutzen die Statistiken von Home Assistant und füllen sich daher erst einige Minuten nach dem Hinzufügen der Integration. Vorzeichen wie am Gateway: Batterieleistung + = Entladen, Netzleistung + = Bezug. Oben rechts steht ein Link „Erstellt von: www.jkbms.sk“.