Screenshots Aus der README von PalmManiac/battery-smartflow-ai.
Überblick
Battery SmartFlow AI steuert das Laden und Entladen von Zendure SolarFlow Batterien anhand von PV-Leistung, Last, Ladezustand und Preisen. Es fügt Entitäten vom Typ Zahl, Auswahl und Sensor für Grenzwerte, Preisschwellen, Betriebsmodus und manuelle Aktionen hinzu. Zu den optionalen Eingaben gehören Strompreisprognosen, Solarprognosequellen, ein zweites Batteriesystem und Netzzähler wie Shelly 3EM Geräte. Unterstützte Zendure Systeme können direkt über die Cloud, lokales MQTT oder ZenSDK verbunden oder über vorhandene Home Assistant Entitäten gesteuert werden. Ein optionales HEMS-Dashboard kann zur Seitenleiste hinzugefügt werden, und eine Debug-Aufzeichnung kann ein Diagnosepaket exportieren. Es arbeitet lokal, wird in der Oberfläche eingerichtet und steuert derzeit ein Batteriesystem.
Zusammenfassung der README und des Codes von PalmManiac/battery-smartflow-ai, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich
Unterstützt
Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.
Stellt bereit
- Sensoren
Einrichtung
Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.
Netzmessung konfigurieren
- Netzleistung (Single)Ein einzelner Sensor mit positiver Leistung bei Bezug und negativer bei Einspeisung.
- Netzbezug (Split)Sensor mit aktueller Netzbezugsleistung in Watt.
- Netzeinspeisung (Split)Sensor mit aktueller Netzeinspeisung in Watt.
- Hostname oder IP-Adresse des Shelly Pro 3EM Gen2Lokaler Hostname oder lokale IP-Adresse des Shelly Pro 3EM Gen2. Eine reservierte/statische Adresse verwenden. Für Modbus TCP Modbus in den Shelly-Einstellungen aktivieren (TCP-Port 502); Modbus verwendet das optionale HTTP-Passwort nicht.
- Shelly-Pro-3EM-Passwort (optional)Optionales Gerätepasswort. Shelly verwendet lokal eine SHA-256-Digest-Anmeldung.
- Hostname oder IP-Adresse des Shelly 3EM Gen1Lokaler Hostname oder lokale IP-Adresse des klassischen Shelly 3EM. Eine reservierte/statische Adresse verwenden.
- Shelly-3EM-Passwort (optional)Optionales Gerätepasswort. Gen1 verwendet unverschlüsselte HTTP-Basic-Authentifizierung; nur im vertrauenswürdigen lokalen Netzwerk verwenden.
Wird auch beim Ändern der Verbindung abgefragt.
Bei Zendure anmelden
- App Token
Zendure-System auswählen
- Zendure-SystemEs wird genau ein Hauptsystem ausgewählt; Packs können nicht eigenständig gesteuert werden. Wähle einen unterstützten Kommunikationsweg für dieses System.
- KommunikationswegCloud ist für Legacy-Geräte der empfohlene Startweg und funktioniert direkt nach der Kontoerkennung. Lokales MQTT erst wählen, wenn das Gerät selbst aktuelle Daten an den lokalen Broker sendet. ZenSDK bleibt für unterstützte neuere Systeme empfohlen.
- Native Zendure-Steuerung aktivierenAktiviert BSFAI-Befehle über den ausgewählten, unterstützten nativen Kommunikationsweg. Ist die Steuerung deaktiviert, bleibt die Zendure-Verbindung auf Nur-Lesen; HA-Entitäten werden nicht zur Steuerung verwendet.
- Lokaler MQTT-ServerWird nur bei einer verifizierten Legacy-Familie angezeigt. Bei der ersten Umstellung auf Lokal richtet BSFAI das Gerät per Bluetooth ein, sofern dies nicht bewusst übersprungen wird.
- Lokaler MQTT-PortFür einen lokalen unverschlüsselten Broker normalerweise 1883.
- Lokaler MQTT-BenutzernameZugangsdaten des vorhandenen Brokers für BSFAI.
- Lokales MQTT-PasswortDie Punktmaske unverändert lassen, um das gespeicherte private Passwort weiterzuverwenden.
- Feste ZenSDK-IP-Adresse (optional)Optionale private IPv4-Adresse für dieses Zendure-System. Im Router eine DHCP-Reservierung einrichten. Bei gesetzter Adresse verwenden ZenSDK-Anfragen nur diese Adresse und umgehen mDNS für dieses Gerät.
Battery SmartFlow AI einrichten
- Zusatzakku Ladeleistung (optional)Optionaler Sensor eines zweiten Akkusystems. Wenn dieser Sensor eine positive Ladeleistung meldet, wird die Entladung von Battery SmartFlow AI blockiert.
- Zusatzakku Entladeleistung (optional)Optionaler Sensor eines zweiten Akkusystems. Wenn dieser Sensor eine positive Entladeleistung meldet, wird das Laden von Battery SmartFlow AI blockiert, damit kein Akku-zu-Akku-Laden entsteht.
- Installierte PV-Leistung (Wp)Installierte theoretische PV-Modulleistung der Anlage in Wp. Dieser Wert wird für relative PV-Kontextschwellen und weitere PV-bezogene Logik verwendet.
- PV-Leistung SensorSensor mit der aktuellen PV-Leistung in Watt.
- PV-Prognose heute (optional)Optionaler Sensor mit der PV-Tagesprognose für heute, z. B. aus Solcast PV Forecast. Die Prognose ist nur ein zusätzlicher Planungs-Input und keine Voraussetzung für die Integration.
- PV-Prognose morgen (optional)Optionaler Sensor mit der PV-Tagesprognose für morgen, z. B. aus Solcast PV Forecast. Die Prognose ist nur ein zusätzlicher Planungs-Input und keine Voraussetzung für die Integration.
- Solarprognose-Quellen (optional)Wähle eine oder mehrere Solarprognose-Integrationen aus, die auch im Home-Assistant-Energie-Dashboard verfügbar sind. Mehrere Quellen werden zusammengeführt.
- Aktueller StrompreisAktueller Strompreis. Ermöglicht preisabhängige Entladung.
- Preisverlauf (z. B. Tibber / EPEX)Preisprognosedaten für die nächsten Stunden. Ermöglicht intelligente Ladeplanung.
- NetzmessungBestimmt, wie Netzbezug und Einspeisung erfasst werden.
- Netzleistung (Single)Ein kombinierter Netzsensor (positiv = Bezug, negativ = Einspeisung).
- Netzbezug (Split)Sensor für Netzbezug (Split-Modus).
- Netzeinspeisung (Split)Sensor für Netzeinspeisung (Split-Modus).
- EinspeisevergütungVergütung pro eingespeister kWh in ganzer Währung. Sie dient als Rückfallwert, wenn kein gültiger dynamischer Einspeisepreis verfügbar ist.
- Aktueller dynamischer Einspeisepreis (optional)Optionaler numerischer Home-Assistant-Sensor für den aktuellen dynamischen Einspeisepreis. Ein gültiger Sensorwert einschließlich null oder eines negativen Preises hat Vorrang vor der festen Einspeisevergütung.
Battery SmartFlow AI einrichten
- GeräteprofilWähle das passende Geräteprofil für dein Zendure-System. Die Regelparameter werden automatisch angepasst.
- Batterie-SoC SensorSensor mit dem aktuellen Ladezustand der Batterie in Prozent.
- SoC-Limit Status (optional)Optionaler Statussensor aus der Zendure-Integration zur Erkennung aktiver BMS-Sperren.
- Kapazität pro Akku-Pack (kWh)Nutzbare Kapazität eines einzelnen Akku-Packs in kWh. Wird mit der Anzahl der installierten Packs multipliziert, um die Gesamtkapazität zu berechnen.
- Batterie Leistungssensor (W)Sensor für die AC-Leistung der Batterie. Der Wert muss bei Entladung positiv sein. Empfohlen: sensor.solarflow_2400_ac_bat_in_out
- Zusatzakku Ladeleistung (optional)Optionaler Sensor eines zweiten Akkusystems. Wenn dieser Sensor eine positive Ladeleistung meldet, wird die Entladung von Battery SmartFlow AI blockiert.
- Zusatzakku Entladeleistung (optional)Optionaler Sensor eines zweiten Akkusystems. Wenn dieser Sensor eine positive Entladeleistung meldet, wird das Laden von Battery SmartFlow AI blockiert, damit kein Akku-zu-Akku-Laden entsteht.
- Kapazitätssensor (optional)Optionaler Sensor mit der automatisch berechneten verfügbaren Batteriekapazität in kWh (z. B. aus der Zendure-Integration). Falls gesetzt, überschreibt er die manuelle Berechnung.
- Installierte PV-Leistung (Wp)Installierte theoretische PV-Modulleistung der Anlage in Wp. Dieser Wert wird für relative PV-Kontextschwellen und weitere PV-bezogene Logik verwendet.
- PV-Leistung SensorSensor mit der aktuellen PV-Leistung in Watt.
- Native PV-Leistung des Batteriesystems (optional)Optionaler Sensor für die direkt am Batteriesystem angeschlossene PV-Leistung. Bei AC-Ladung erhält diese Leistung innerhalb der maximalen Ladeleistung Vorrang. Hier nicht den Sensor der gesamten Haus-PV auswählen.
- PV-Prognose heute (optional)Optionaler Sensor mit der PV-Tagesprognose für heute, zum Beispiel von Solcast PV Forecast. Die Prognose ist nur eine zusätzliche Planungsgrundlage und wird für die Integration nicht benötigt.
- PV-Prognose morgen (optional)Optionaler Sensor mit der PV-Tagesprognose für morgen, zum Beispiel von Solcast PV Forecast. Die Prognose ist nur eine zusätzliche Planungsgrundlage und wird für die Integration nicht benötigt.
- Solarprognosequellen (optional)Wähle eine oder mehrere Solarprognose-Integrationen aus, die im Home Assistant Energie-Dashboard bereitgestellt werden. Mehrere Quellen werden kombiniert.
- Aktueller StrompreisAktueller Strompreis. Ermöglicht preisabhängiges Entladen.
Battery SmartFlow AI neu konfigurieren
- GeräteprofilWähle das passende Geräteprofil für dein Zendure-System. Das Profil enthält abgestimmte Regelparameter.
- Batterie-SoC SensorSensor mit dem aktuellen Ladezustand (State of Charge) der Batterie in Prozent. Zentrale Grundlage für alle Entscheidungen.
- SoC-Limit Status (optional)Optionaler Sensor aus der Zendure-Integration, der aktive BMS-Grenzen meldet (z. B. Lade- oder Entladesperre).
- Kapazität pro Akku-Pack (kWh)Nutzbare Kapazität eines einzelnen Akku-Packs in kWh. Wird mit der Anzahl der installierten Packs multipliziert, um die Gesamtkapazität zu berechnen.
- Batterie Leistungssensor (W)Sensor für die AC-Leistung der Batterie. Der Wert muss bei Entladung positiv sein. Empfohlen: sensor.solarflow_2400_ac_bat_in_out
- Zusatzakku Ladeleistung (optional)Optionaler Sensor eines zweiten Akkusystems. Wenn dieser Sensor eine positive Ladeleistung meldet, wird die Entladung von Battery SmartFlow AI blockiert.
- Zusatzakku Entladeleistung (optional)Optionaler Sensor eines zweiten Akkusystems. Wenn dieser Sensor eine positive Entladeleistung meldet, wird das Laden von Battery SmartFlow AI blockiert, damit kein Akku-zu-Akku-Laden entsteht.
- Kapazitätssensor (optional)Optionaler Sensor mit der automatisch berechneten verfügbaren Batteriekapazität in kWh (z. B. aus der Zendure-Integration). Falls gesetzt, überschreibt er die manuelle Berechnung.
- Installierte PV-Leistung (Wp)Installierte theoretische PV-Modulleistung der Anlage in Wp. Dieser Wert wird für relative PV-Kontextschwellen und weitere PV-bezogene Logik verwendet.
- PV-Leistung SensorSensor mit der aktuellen PV-Leistung in Watt. Wird zur Erkennung von Überschuss verwendet.
- Native PV-Leistung des Batteriesystems (optional)Optionaler Sensor für die direkt am Batteriesystem angeschlossene PV-Leistung. Bei AC-Ladung erhält diese Leistung innerhalb der maximalen Ladeleistung Vorrang. Hier nicht den Sensor der gesamten Haus-PV auswählen.
- PV-Prognose heute (optional)Optionaler Sensor mit der PV-Tagesprognose für heute, zum Beispiel von Solcast PV Forecast. Die Prognose ist nur eine zusätzliche Planungsgrundlage und wird für die Integration nicht benötigt.
- PV-Prognose morgen (optional)Optionaler Sensor mit der PV-Tagesprognose für morgen, zum Beispiel von Solcast PV Forecast. Die Prognose ist nur eine zusätzliche Planungsgrundlage und wird für die Integration nicht benötigt.
- Solarprognosequellen (optional)Wähle eine oder mehrere Solarprognose-Integrationen aus, die im Home Assistant Energie-Dashboard bereitgestellt werden. Mehrere Quellen werden kombiniert.
- Aktueller StrompreisSensor mit dem aktuellen Strompreis, zum Beispiel Tibber. Wird für wirtschaftliche Entscheidungen verwendet.
Nach der Einrichtung
- HEMS-Dashboard in der Seitenleiste anzeigen
- SmartMode 1 im Standby beibehaltenStandardmäßig aktiviert. Die Option greift, wenn das ausgewählte Modell und der Kommunikationsweg direkte SmartMode-Schreibzugriffe unterstützen. Wenn deaktiviert, verwenden Modelle ihr bisheriges Standby-Verhalten, einschließlich SmartMode 0, sofern dies in der Gerätematrix festgelegt ist.
- Gruppenname
- Systeme in der Gruppe
- Gruppe
- Gruppenname
- Systeme in der Gruppe
- Gruppe
- Name des Scopes
- Zugewiesene Batteriegruppen
- Messmodus des Netzes
- Netzleistungssensoren mit Vorzeichen
- Netzsensoren pro Phase mit Vorzeichen
- Netzbezugssensoren
- Netzeinspeisesensoren
- Sensor für den aktuellen Bezugspreis
- Sensor für den dynamischen Einspeisepreis
- EnergyScope
Texte aus dem Code von PalmManiac/battery-smartflow-ai. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.
Entitäten
- ZahlenAnzahl Akku-Packs, PV-Ladestart ab Einspeisung, SoC Minimum, SoC Maximum, Max. AC-Ladeleistung, Max. Entladeleistung, Notladeleistung, Notladung ab SoC, Sehr-teuer-Schwelle, Gewinnmarge (%), Peakpreis-Aufschlag, Talpreis-Abschlag und 2 weitere
- AuswahlfelderBetriebsmodus, Manuelle Aktion, Off-Grid-Modus
- SensorenNetzleistung, Shelly-Netzleistung Phase A, Shelly-Netzleistung Phase B, Shelly-Netzleistung Phase C, Status nativer Zendure-Test, Native Zendure-Steuerung, Gefundene native Zendure-Geräte, Empfangene native Zendure-Nachrichten, Letzte native Zendure-Nachricht, Paket des nativen Zendure-Erstabgleichs, Fehler nativer Zendure-Test, Zendure-Hardwareverbindung und 188 weitere
Aktionen
- Debug-Aufzeichnung startenTechnische Diagnosedaten zeitlich begrenzt erfassen und automatisch als JSON-Paket exportieren.Felder: Konfiguration, Dauer
- Debug-Aufzeichnung stoppenDie aktive Aufzeichnung jetzt beenden und ihr JSON-Paket exportieren.Felder: Konfiguration
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
Erscheint in Vulpo
Auswahl-Karte, Diagrammkarte, Apple Watch.Informationen
- Installationen
- 97 teilen Analysedaten
- GitHub-Sterne
- 70
- Verbindung
- Funktioniert lokal
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- 5.2.6,
- Kategorie
- KI und Sprache, KI-Modelle
- Art
- Marketplace-Integration
- Voraussetzung
- Braucht den Marketplace (HACS bis Home Assistant 2026.10)
- Domain
battery_smartflow_ai- Probleme
- Problem melden













