Sende deine PV-Anlagendaten (Netzleistung, Solarproduktion, Batteriestatus) an die clever-PV Push-API und erhalte bei Bedarf Steuerungsbefehle für die Batterie.
Features
- Daten per Push an clever-PV senden (Netzleistung, Solarproduktion, Batteriestatus)
- Optionale Batteriesteuerung: Erhalte Lade-/Entladeanweisungen von clever-PV
- Unterstützt Netzleistung, Solarproduktion, Batterie-SOC und Ladeleistung
- Konfigurierbares Push-Intervall (10-300 Sekunden, Standard: 30)
- Verschiedene Sensoren zur Überwachung des Push-Status und des Batteriesteuerungszustands
Installation
HACS (Empfohlen)
- Installiere HACS in Home Assistant, folge dazu einfach den Schritten (https://my.home-assistant.io/redirect/supervisor_addon/?addon=cb646a50_get&repository_url=https%3A%2F%2Fgithub.com%2Fhacs%2Faddons)
- Sobald Get HACS installiert ist, einmal den Home Assistant neustarten (Einstellungen -> System -> oben rechts auf On/Off ).
- Gehe nun auf Einstellungen -> Geräte und Dienste
- Drücken unten rechts auf "Integration hinzufügen"
- Suche nach HACS und wähle es aus, hake die Optionen und bestätige.
- Verknüpfe deinen Github Account
- Wähle HACS links aus der Liste aus
- Klicke auf die drei Punkte in der oberen rechten Ecke
- Wähle "Benutzerdefinierte Repositories" (Custom repositories)
- Füge
https://github.com/clever-PV/home-assistant-clever-PVmit der Kategorie "Integration" hinzu - Klicke auf "Hinzufügen"
- Suche nach "clever-PV" und installiere es
- Starte Home Assistant neu
- Gehe zum Tab "Einstellungen" - "Geräte & Dienste"
- Klicke auf den Button "+ Integration hinzufügen"
- Suche nach "clever-PV" und füge es hinzu
- Folge dem Setup-Prozess
Manuelle Installation
- Kopiere den Ordner
custom_components/cleverpvin das Verzeichnisconfig/custom_components/deines Home Assistant - Starte Home Assistant neu
Konfiguration in clever-PV
- Füge ein Push-API-Gerät gemäß dieser Anleitung hinzu: https://support.clever-pv.com/hc/de/articles/22801081762066-Push-API
- Optional: Aktiviere die KI-Batteriesteuerung
Konfiguration in Home Assistant
- Gehe zu Einstellungen Geräte & Dienste
- Klicke auf Integration hinzufügen
- Suche nach "clever-PV"
- Gib deine clever-PV Push-URL ein (aus deinem clever-PV Account)
- Wähle die zu übertragenden Entitäten aus:
- Netzleistung (Grid Power) (erforderlich): Sensor, der die Netzleistung in Watt anzeigt (positiv = Bezug, negativ = Einspeisung)
- Solarproduktion (Solar Production) (optional): Sensor, der die aktuelle Solarproduktion in Watt anzeigt
- Batterie-SOC (optional): Sensor, der den Ladezustand der Batterie in Prozent anzeigt
- Batterieleistung (Battery Power) (optional): Sensor, der die Lade-/Entladeleistung der Batterie in Watt anzeigt
- Konfiguriere optionale Funktionen:
- Batteriesteuerung aktivieren (optional): Wenn aktiviert, kann clever-PV Steuerungsbefehle an Home Assistant zurücksenden
Entitäten
Die Integration erstellt die folgenden Diagnose-Sensoren:
| Sensor | Beschreibung |
|---|---|
| Push Status | Erfolgs- oder Fehlerstatus des letzten Push-Vorgangs |
| Last Push | Zeitstempel des letzten erfolgreichen Push-Vorgangs |
| Last Response | Antwortnachricht der clever-PV API |
| Last Payload | JSON-Daten (Payload) des letzten Push-Vorgangs |
| Push Count | Gesamtanzahl der erfolgreichen Push-Vorgänge |
Wenn die Batteriesteuerung aktiviert ist, werden zusätzliche Sensoren erstellt:
| Sensor | Beschreibung |
|---|---|
| Battery Control State | Aktueller Befehl von clever-PV: Normal, Idle, Force Charge, Force Discharge oder Limit Charge Power |
| Battery Force Power | Ziel-Leistung in Watt (nur gesetzt bei Force Charge/Discharge) |
Datenformat
Die Integration sendet die folgenden Daten an clever-PV:
| Feld | Beschreibung |
|---|---|
watt | Netzleistung (positiv = Bezug, negativ = Einspeisung) |
producingWatt | Solarproduktion in Watt |
soc | Batterieladezustand (0-100%) |
chargingPower | Batterieleistung in Watt |
powerStorageState | 0=Standby, 1=Laden, 2=Deaktiviert, 3=Entladen |
batteryControlEnabled | Wenn "true", werden Steuerungsbefehle angefordert |
Batteriesteuerung
Wenn die Batteriesteuerung aktiviert ist, kann clever-PV Befehle senden, um deine Batterie basierend auf Strompreisen und Solarprognosen zu optimieren. Diese Befehle werden in zwei Sensoren gehalten:
Battery Control State: Normal, Idle (Pause), Force Charge (Zwangsladen), Force Discharge (Zwangsentladen) oder Limit Charge Power (Ladeleistung begrenzen)Battery Force Power: Gewünschte Leistung für die Batterie (außer im Normal- oder Idle-Modus)
Voraussetzungen
- Ein clever-PV Account mit aktiviertem Smart Battery Price Control
- Ein in clever-PV konfigurierter dynamischer Stromtarif
Funktionsweise
- Die Integration sendet
batteryControlEnabled: truemit jedem Push - clever-PV antwortet mit Steuerungsbefehlen (falls verfügbar)
- Die Befehle erscheinen als Sensorwerte in Home Assistant
Steuerungszustände
| Zustand | Beschreibung |
|---|---|
| Normal | Eigenverbrauchsmodus (Standardverhalten) |
| Idle | Laden und Entladen pausieren |
| Force Charge | Batterie mit angegebener Leistung laden |
| Force Discharge | Batterie mit angegebener Leistung entladen |
| Limit Charge Power | Eigenverbrauch mit begrenzter Ladeleistung |
Verwendung der Sensoren
Du kannst die Sensoren der Batteriesteuerung in Home Assistant Automatisierungen verwenden, um deinen Wechselrichter zu steuern. Erstelle beispielsweise eine Automatisierung, die den Sensor Battery Control State ausliest und den entsprechenden Befehl an deinen Wechselrichter sendet.
Rekonfiguration
Um Einstellungen nach der Ersteinrichtung zu ändern:
- Gehe zu Einstellungen Geräte & Dienste
- Suche die clever-PV Integration
- Klicke auf Konfigurieren
- Aktualisiere die Push-URL oder die Entitätenauswahl
Fehlersuche (Troubleshooting)
Aktiviere das Debug-Logging durch Hinzufügen folgender Zeilen in deine configuration.yaml:
logger:
default: info
logs:
custom_components.cleverpv: debug