Zum Hauptinhalt gehen

Home Assistant

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 uns senden (Netzleistung, Solarproduktion, Batteriestatus)
  • Optionale Batteriesteuerung: Erhalte Lade-/Entladeanweisungen von uns
  • 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)

  1. 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)
  2. Sobald Get HACS installiert ist, einmal den Home Assistant neustarten (Einstellungen -> System -> oben rechts auf On/Off ).
  3. Gehe nun auf Einstellungen -> Geräte und Dienste
  4. Drücken unten rechts auf "Integration hinzufügen"
  5. Suche nach HACS und wähle es aus, hake die Optionen und bestätige.
  6. Verknüpfe deinen Github Account
  7. Wähle HACS links aus der Liste aus
  8. Klicke auf die drei Punkte in der oberen rechten Ecke
  9. Wähle "Benutzerdefinierte Repositories" (Custom repositories)
  10. Füge https://github.com/clever-PV/home-assistant-clever-PV mit der Kategorie "Integration" hinzu
  11. Klicke auf "Hinzufügen"
  12. Suche nach "clever-PV" und installiere es
  13. Starte Home Assistant neu
  14. Gehe zum Tab "Einstellungen" - "Geräte & Dienste"
  15. Klicke auf den Button "+ Integration hinzufügen"
  16. Suche nach "clever-PV" und füge es hinzu
  17. Folge dem Setup-Prozess

Manuelle Installation

  1. Kopiere den Ordner custom_components/cleverpv in das Verzeichnis config/custom_components/ deines Home Assistant
  2. Starte Home Assistant neu

Konfiguration in Home Assistant

  1. Gehe zu Einstellungen Geräte & Dienste
  2. Klicke auf Integration hinzufügen
  3. Suche nach "clever-PV"
  4. Gib deine Push-URL ein
  5. 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
  6. Konfiguriere optionale Funktionen:
    • Batteriesteuerung aktivieren (optional): Wenn aktiviert, können wir 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 uns: 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 uns:

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, können wir 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 Account mit aktiviertem Smart Battery Price Control
  • Ein konfigurierter dynamischer Stromtarif

Funktionsweise

  1. Die Integration sendet batteryControlEnabled: true mit jedem Push
  2. wir antworten mit Steuerungsbefehlen (falls verfügbar)
  3. 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:

  1. Gehe zu Einstellungen Geräte & Dienste
  2. Suche die clever-PV Integration
  3. Klicke auf Konfigurieren
  4. 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
Powered by Zendesk