🔋 Custom BMS Battery Cells Card für Home Assistant - HACS

jayjojayson · 25. Dezember 2025 um 10:41

BMS Battery Cells Card

Visualisierung der Einzelzellenspannungen deines Batteriespeichersystems (BMS)

Meine neue Card ist fertig, danke auch an @Dr.Big fürs testen und den ein oder anderen Gedankenanstoß. Ich hoffe euch gefällt die Card, es werden bestimmt einige Hausspeicher im Einsatz haben und da ist so eine Visualisierung schön.

Die BMS Battery Cells Card ist eine benutzerdefinierte Lovelace-Karte zur Visualisierung der einzelnen Zellspannungen deines Batteriespeichers (BMS). Sie bietet eine übersichtliche Darstellung des Zustands aller Zellen, inklusive Min/Max-Werten und Balancing-Status.

Die Karte ist vollständig über die Benutzeroberfläche des Karteneditors konfigurierbar.
Du benötigst die entsprechenden Entitäten deines BMS (z.B. Victron, JK-BMS, Daly), die die Zellspannungen in Home Assistant bereitstellen. Es funktionieren natürlich auch normale Batterien (AGM und Co) soweit ihr dafür Entitäten in HA erhaltet.

Wenn euch die custom Card gefällt, würde ich mich sehr über eine Stern auf github freuen.

Features

Visualisierung einzelner Zellspannungen
Min / Max / Drift / Durchschnitts-Anzeige
Dynamische Farbgebung (Schwellenwerte)
Balancing Indikatoren
Animierte Zellen (Power in/out)
Batterie Voltage, Current, Temp & Power Status (in/out)
Flexibles Layout (Grid/Liste)
UI-Konfiguration

Installation

HACS (Empfohlen)

Das github über den Link in Home Assistant einfügen.
Die „BMS Battery Cells Card“ sollte nun in HACS verfügbar sein. Klicke auf „INSTALLIEREN“ („INSTALL“).
Die Ressource wird automatisch zu deiner Lovelace-Konfiguration hinzugefügt.

Manuelle Installation über Hacs

Manuelle Installation über Hacs

Öffne HACS in Home Assistant.

Gehe zu „Frontend“ und klicke auf die drei Punkte in der oberen rechten Ecke.
Wähle „Benutzerdefinierte Repositories“ („Custom repositories“) aus.
Füge die URL zu deinem GitHub-Repository hinzu und wähle „Lovelace“ als Kategorie.
Klicke auf „HINZUFÜGEN“ („ADD“).
Die „BMS Battery Cells Card“ sollte nun in HACS verfügbar sein. Klicke auf „INSTALLIEREN“ („INSTALL“).
Die Ressource wird automatisch zu deiner Lovelace-Konfiguration hinzugefügt.

Manuelle Installation in HA

Manuelle Installation in HA

Dateien herunterladen:
- Lade die bms-battery-cells-card.js aus diesem Repository herunter.
Dateien in Home Assistant hochladen:
- Erstelle einen neuen Ordner namens bms-battery-cells-card im www/community-Verzeichnis deiner Home Assistant-Konfiguration. (Das www-Verzeichnis befindet sich im selben Ordner wie deine configuration.yaml).
- Kopiere alle heruntergeladenen Dateien in diesen neuen Ordner. Deine Ordnerstruktur sollte wie folgt aussehen:
```
/config/www/community/bms-battery-cells-card/bms-battery-cells-card.js
```
Ressource zu Home Assistant hinzufügen:
- Gehe in Home Assistant zu Einstellungen > Dashboards.
- Klicke auf das Menü mit den drei Punkten oben rechts und wähle Ressourcen.
- Klicke auf + Ressource hinzufügen.
- Gebe als URL /local/community/bms-battery-cells-card/bms-battery-cells-card.js ein.
- Wähle als Ressourcentyp JavaScript-Modul.
- Klicke auf Erstellen.

Konfiguration

Nach der Installation kannst du die Karte zu deinem Dashboard hinzufügen:

Bearbeitungsmodus aktivieren:
- Öffne das Dashboard, zu dem die Karte hinzufügt werden soll, und klicke auf Bearbeiten.
Karte hinzufügen:
- Klicke auf + Karte hinzufügen und suche nach der „BMS Battery Cells Card“.
Optionen konfigurieren:
- Ein Konfigurationsfenster wird angezeigt, in dem alle Einstellungen bequem angepasst werden können.
- BMS Entity: Die Hauptentitäten oder Liste der Sensoren.
- Voltage Range: Definiere Min und Max Spannung für die grafische Darstellung.
- Details: Blende Zusatzwerte wie Battery Power, Temp, Drif oder Durschnittsspannung an.

YAML-Modus (Alternative)

Obwohl die UI-Konfiguration empfohlen wird, kann die Karte auch manuell über den YAML-Editor konfiguriert werden:

Optionen

name	typ	erforderlich	Beschreibung	Standard
`type`	`string`	Ja	Kartentyp. Muss `custom:bms-battery-cells-card` sein.
`title`	`string`	Nein	Titel, der oben in der Karte angezeigt wird.	`"Batterie Zellen"`
`cells`	`list`	Ja	Liste der Zellen (jeweils mit Entität und optionalem Namen).	4 Beispiel-Zellen
`cells[].entity`	`string`	Ja	Sensor-Entität der Zellspannung.
`cells[].name`	`string`	Nein	Anzeigename der Zelle.	Zell-Index
`show_legend`	`boolean`	Nein	Zeigt die Spannungs-Skala (Y-Achse) auf der linken Seite an.	`true`
`container_padding`	`number`	Nein	Innenabstand des Karten-Containers in Pixeln.	`16`
`card_height`	`number`	Nein	Feste Höhe der Karte in Pixeln.	`380`
`cell_gap`	`number`	Nein	Abstand zwischen einzelnen Zellen in Pixeln.	`4`
`show_values`	`boolean`	Nein	Zeigt die exakten Zellspannungen als Text an.	`true`
`show_values_on_top`	`boolean`	Nein	Zeigt Statistikwerte oberhalb der Icons an.	`false`
`enable_animations`	`boolean`	Nein	Aktiviert Lade- und Entlade-Animationen.	`true`
`min_voltage`	`number`	Nein	Minimale Zellspannung für die Skalierung.	`2.60`
`max_voltage`	`number`	Nein	Maximale Zellspannung für die Skalierung.	`3.65`
`show_min_max`	`boolean`	Nein	Markiert die Zellen mit minimaler und maximaler Spannung.	`true`
`show_average`	`boolean`	Nein	Zeigt die durchschnittliche Zellspannung in den Statistiken an.	`false`
`soc_entity`	`string`	Nein	Sensor-Entität für den Ladezustand (SoC).
`watt_entity`	`string`	Nein	Leistungs-Sensor (positiv = Laden, negativ = Entladen).
`cell_diff_sensor`	`string`	Nein	Sensor für die Zellspannungs-Abweichung (mV).
`temp_entity`	`string`	Nein	Sensor-Entität für die Batterietemperatur.

Beispielkonfiguration

Einfaches Beispiel:

type: custom:bms-battery-cells-card
title: Batterie Zellen
cells:
  - entity: sensor.cell_1
    name: "1"
  - entity: sensor.cell_2
    name: "2"
  - entity: sensor.cell_3
    name: "3"
  - entity: sensor.cell_4
    name: "4"

Erweitertes Beispiel:

type: custom:bms-battery-cells-card
cells:
  - name: "1"
    entity: sensor.vrm_maximum_cell_voltage_batt_1
  - name: "2"
    entity: sensor.vrm_minimum_cell_voltage_batt_1
  - name: "3"
    entity: sensor.vrm_maximum_cell_voltage_batt_2
  - name: "4"
    entity: sensor.vrm_minimum_cell_voltage_batt_2
soc_entity: sensor.victron_system_battery_soc
watt_entity: sensor.vrm_battery_power_batt_1024
cell_diff_sensor: sensor.vrm_minimum_cell_voltage_batt_1
temp_entity: sensor.vrm_battery_temperature_batt_1
show_values_on_top: false
enable_animations: true
title: Batterie Zellen
thicker_borders: true
min_voltage: 2.6
max_voltage: 3.65
show_average: false

CSS Elemente

CSS Elements

Selector	Description
`.header`	Kopfbereich der Karte.
`.card-header`	Header mit Titel und Statistiken.
`.title`	Karten-Titel.
`.stats`	Container für Statistikwerte.
`.stat-item`	Einzelner Statistikblock.
`.stat-label`	Beschriftung der Statistik.
`.stat-value-row`	Zeile mit Icon und Wert.
`.vertical-layout`	Vertikale Anordnung von Icon/Wert.
`.main-container`	Hauptcontainer der Zellen.
`.cells-container`	Container für alle Zell-Elemente.
`.legend-col`	Spannungs-Skala (Y-Achse).
`.cell-wrapper`	Wrapper einer einzelnen Zelle.
`.cell-item`	Einzelne Batteriezelle.
`.min-cell`	Markierung der Zelle mit Minimalspannung.
`.max-cell`	Markierung der Zelle mit Maximalspannung.
`.custom-tooltip`	Tooltip bei Klick / Hover.
`.cell-track-bg`	Hintergrund mit Farbverlauf.
`.cell-bar`	Spannungs-Balken.
`.is-charging`	Lade-Animation aktiv.
`.is-discharging`	Entlade-Animation aktiv.
`.charging-overlay`	Animiertes Overlay.
`.cell-info-layer`	Overlay für Labels.
`.cell-name-wrap`	Container für Zellnamen.
`.cell-name-badge`	Badge mit Zellnamen.
`.cell-val-wrap`	Container für Spannungswert.
`.cell-val-badge`	Spannungs-Anzeige.
`.cell-voltage`	Kennzeichnung Spannungswert.
`ha-card`	Home Assistant Kartencontainer.
`ha-icon`	Icons in Statistikbereich.

Header & Titel anpassen

type: custom:bms-battery-cells-card
title: Batterie Zellen
cells:
  - entity: sensor.cell_1
    name: "1"
  - entity: sensor.cell_2
    name: "2"
card_mod:
  style: |
    .title {
      font-size: 1.6rem;
      font-weight: 600;
      color: #00e676;
    }
    .header.card-header {
      border-bottom: 1px solid rgba(0,224,118,0.3);
    }

Min-/Max-Zellen hervorheben

type: custom:bms-battery-cells-card
title: Batterie Zellen
cells:
  - entity: sensor.cell_1
    name: "1"
  - entity: sensor.cell_2
    name: "2"
card_mod:
  style: |
    .cell-wrapper.min-cell {
      border: 2px solid #2196f3;
      box-shadow: 0 0 12px rgba(33,150,243,0.8) inset;
    }

    .cell-wrapper.max-cell {
      border: 2px solid #f44336;
      box-shadow: 0 0 12px rgba(244,67,54,0.8) inset;
    }

Zellnamen dezenter darstellen

type: custom:bms-battery-cells-card
title: Batterie Zellen
cells:
  - entity: sensor.cell_1
    name: "1"
  - entity: sensor.cell_2
    name: "2"
card_mod:
  style: |
    .cell-name-badge {
      background: rgba(255,255,255,0.08);
      color: #e0e0e0;
      font-weight: 500;
      letter-spacing: 0.4px;
    }

Tooltip Design anpassen (Touch, Hover)

type: custom:bms-battery-cells-card
title: Batterie Zellen
cells:
  - entity: sensor.cell_1
    name: "1"
  - entity: sensor.cell_2
    name: "2"
card_mod:
  style: |
    .cell-name-badge {
      background: rgba(255,255,255,0.08);
      color: #e0e0e0;
      font-weight: 500;
      letter-spacing: 0.4px;
    }

| | | | |

meins57 · 25. Dezember 2025 um 10:51

Sehr cool wie immer wenn du was machst. Werde sie so wie es aussieht aber leider nicht nutzen können. Glaube mein BKW von Anker stellt die Entitäten nicht bereit.

Edit: Auch hier ist das Problem mit den Theme.

jayjojayson · 25. Dezember 2025 um 10:57

Danke schön, ja musst du schauen was da für Sensoren bereitgestellt werden. Bei mir kann ich aktuell auch nur die höchste und niedrigste Zelle auslesen, also nicht alle 16 direkt. Da muss ich erst noch etwas für basteln. Du könntest die kompakte Card Ansicht aber nutzen.

EDIT: ja das stimmt leider, ich weiß noch nicht woran das liegt. Einfacher workaround ist, einfach die HA Card Auswahl zu öffnen, dann wird im Hintergrund der Cardeditor der Card aktualisiert. Der Weg über Theme kurz ändern geht auch. Zum Glück ist das ja nur einmalig, bei Installtion oder Update.

Timo · 25. Dezember 2025 um 11:08

Ausserhalb von vrm geht das nicht oder ? ich nutze ein Seplos bms mit bluetooh. Habe zwar auch ein Bluetooth stick aber das BMS bekomme ich leider nicht in HA.

jayjojayson · 25. Dezember 2025 um 11:12

Hi, nein das klappt dann leider nicht. Die Sensoren müssen in HA zur Verfügung stehen. Ist ja nur ein Card zur Visualisierung, nicht zum Einlesen der Daten von irgendwoher. Wenn du Daten über Bluetooth irgendwie in HA bekommst, dann kannst du die Card nutzen.

Dr.Big · 25. Dezember 2025 um 11:28

Schon „schick“ was Jan da mal wieder zusammengebaut hat!

Timo · 25. Dezember 2025 um 11:30

wie hast du die Temp dahin bekommen ?

Gefunden

Dr.Big · 25. Dezember 2025 um 11:33

sollte aktuell “default” so sein!

Timo · 25. Dezember 2025 um 11:35

alles gut passt

danke schön

hrglzpf · 25. Dezember 2025 um 13:27

Cool - super Sache, danke dafür.
Dann werd ich meinen BYD Speicher mal ins Netzwerk hängen und die Daten abholen.

Die Chefin wird dann zwar fragen für was man das braucht, und wenn ich dann sage “eigentlich für nix, aber…” wird sie´s dann verstehen (oder auch nicht )

mafe68 · 25. Dezember 2025 um 13:44

Die Zellspannungen und Akkuspannungen zu sehen ist wichtiger als der SOC!

jayjojayson · 25. Dezember 2025 um 13:47

Das habe ich auch von mafe gelernt. Der SoC kann schon manchmal ganz schön abweichen und dann sind die Zellspannungen viel Aussagekräftiger.

Timo · 27. Dezember 2025 um 12:52

Hallo

habe jetzt auch alle 16 Zellen drinne . Hätte noch die Möglichkeit welche Zellen gerade balancieren.

Verfügbarer Energie Gehalt wird mir auch angezeigt.

Kann das deine Integration ? So das zb die Zahlen rot werden der jeweiligen Zelle. Ist nur ne nachfrage.

Gruß Timo

jayjojayson · 27. Dezember 2025 um 12:55

Hi, nein das kann sie noch nicht! Muss ich schauen, so lange ich das nicht live bei mir testen kann. Was hast du für einen Sensor, der die Info dafür bereitstellt? Irgendwie muss man ja wissen, welche Zellen gerade balancieren.

Timo · 27. Dezember 2025 um 12:58

ich habe ein Seplos BMS was mit Bluetooth ausgelesen wird über diese Integration

jayjojayson · 27. Dezember 2025 um 12:59

Schaue mir mal in Ruhe an.

Timo · 27. Dezember 2025 um 13:03

Jo so wie ich das sehe gibt der akku nur 16 x ne 0 oder ne 1 raus. Kann ich dir später sagen wenn er balanciert

Dr.Big · 27. Dezember 2025 um 14:00

wüsste ich beim JK-BMS auch nicht woher nehmen !

Timo · 27. Dezember 2025 um 14:03

bei mir steht das bei

binary_sensor.sp00b_balancer

dann unten Attribute

da steht bei mir 16 x 0 denke mal das dann welche auf 1 gehen

Also so geht es wohl

- sensor:
    - name: "Balancer Zelle 1"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[0] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}
    - name: "Balancer Zelle 2"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[1] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}
    - name: "Balancer Zelle 3"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[2] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}
    - name: "Balancer Zelle 4"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[3] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}
    - name: "Balancer Zelle 5"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[4] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}
    - name: "Balancer Zelle 6"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[5] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}
    - name: "Balancer Zelle 7"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[6] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}
    - name: "Balancer Zelle 8"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[7] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}
    - name: "Balancer Zelle 9"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[8] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}
    - name: "Balancer Zelle 10"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[9] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}
    - name: "Balancer Zelle 11"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[10] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}
    - name: "Balancer Zelle 12"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[11] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}
    - name: "Balancer Zelle 13"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[12] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}
    - name: "Balancer Zelle 14"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[13] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}
    - name: "Balancer Zelle 15"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[14] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}
    - name: "Balancer Zelle 16"
      state: >-
        {% if state_attr('binary_sensor.sp00b_balancer', 'channels')[15] == 1 %}
          An
        {% else %}
          Aus
        {% endif %}

mafe68 · 27. Dezember 2025 um 15:48

Ist das dein Seplos BMS, welche Version hast du davon?

🔋 Custom BMS Battery Cells Card für Home Assistant - HACS

BMS Battery Cells Card

Features

Visualisierung einzelner Zellspannungen

Min / Max / Drift / Durchschnitts-Anzeige

Dynamische Farbgebung (Schwellenwerte)

Balancing Indikatoren

Animierte Zellen (Power in/out)

Batterie Voltage, Current, Temp & Power Status (in/out)

Flexibles Layout (Grid/Liste)

UI-Konfiguration