Installation Zendure Home Assistant integration – Tutorial - Kieft-C/Zendure-BKW-PV GitHub Wiki

Dieses Tutorial führt durch die Installation der offiziellen Zendure-Integration von FireSon in Home Assistant und ermöglicht die Automatisierung von Zendure-Geräten.

Voraussetzung:

  • Homeassistant, als Basis system laufend
  • Home Assistant Community Store (HACS) muss installiert sein und erreichbar sein
  • Home Assistant Zendure integration version mind. v1.1.3
  • optional: für lokal MQTT: Bluetooth Stick bzw. Bluetooth Funktionalität in HA installiert

Step 1: Installation von HACS (wenn nicht bereits installiert)

Step 2: Hinzufügen der Zendure Integration via HACS

  • Nachdem HACS eingerichtet ist, können Sie die Zendure-Integration ganz einfach hinzufügen, indem Sie hier klicken: LINK

  • Zugriff auf HACS:

    • Wenn Sie zum ersten Mal darauf zugreifen, müssen Sie sich möglicherweise mit Ihrem GitHub-Konto autorisieren.

  • Fügen Sie die Zendure-Integration hinzu:

  • Installieren Sie die Zendure-Integration:

    • Klicken Sie auf die Schaltfläche „Installieren“ oder „Herunterladen“ oder "erneut herunterladen"
    • HACS lädt die Zendure-Integration automatisch herunter und installiert sie in Ihrer Home Assistant-Instanz.
      • Es gibt hier die Möglichkeit auch "eine andere Versionen" herunter zuladen und ggf. bei Problemen zurück zu springen, falls der neue Release fehler aufzeigen sollte

Step 3: Einrichtung der Zendure Integration

  • Gehe zu "Einstellungen" -> "Geräte & Dienste" - > "+ Integration hinzufügen" und dort Zendure Integration suchen
  • Dann öffnet sich ein Fenster welches Daten abfragt zur Einrichtung:
  • Zendure Token:
    • Der Token-API-Schlüssel findet Ihr in dem Zendure-Konto in der Zendure App
    • Zendure App -> Profil -> "Autorisierung-Cloud-Schlüssel" dieser wird für euch erstellt und darf mit niemanden geteilt werden
    • der Token muss in dem Zendure Account abgefragt worden sein, welcher euer Hauptaccount ist wo die Geräte registriert wurden, NICHT mit einem Zweitaccount (wie anfangs die Integration genutzt wurde, bevor es den Token gab)
  • "P1 Sensor für Smart Matching"
    • möchtet Ihr die zendure Integration nicht zur Datenanzeige nutzen, sondern auch zur Nulleinspeiseregelung, gebt Ihr hier die Entität an, welche zum Abgleich der Nulleinspeisung genutzt werden soll
    • bei mir ist ein Shelly 3em pro und der total active power sensor
    • möglich ist aber hier jeder sensor der den entsprechend Wert liefert zum abgleich
  • MQTT-Kommunikation loggen
    • bietet sich an dies einzuschalten, falls man zum troubleshot ein Debug-Log erstellt, werden diese Informationen mit im Logfile geschrieben
  • Lokalen Mosquitto MQTT AddOn verwenden
    • möchte man sich von der Cloud abkoppeln, muss dies optional aktiviert werden
    • HINWEIS: erweiterte Kenntnisse und Schritte nötig, nichts für einsteiger!
    • wenn ihr dies aktiviert, folgt ein weiteres popup was weitere daten abfragt.
    • Mosquitto AddOn muss vorab installiert worden sein LINK
      • mqttserver: ist die IP von euerem HA-Server
      • mqttport: 1883 (standard-port)
      • mqttuser: user den Ihr im mosquitto addon angelegt habt oder bei HA "Einstellungn"->"personen"->"Benutzer"
      • mqttpsw: zugehöriges passwort zum angelegten user
      • Wifi SSID: euer lokaler WLAN Name (bevorzugt geraten wird zu 2,4Ghz)
      • Wifi Passwort: das dazugehörige passwort zum WLAN
    • wenn Ihr dies alles richtig eingetragen habt und "ok" gedrückt habt, tauchen nun im besten Falle eure Geräte in einer Liste auf

// Via MQTT Explorer lässt sich prüfen ob die Daten aus dem HA Server abgerufen werden können und man kann somit prüfen ob die Daten korrekt sind. https://mqtt-explorer.com/

  • Es werden folgende Geräte getrennt angelegt:
    • Zendure Manager, mit folgenden Auswahl möglichkeiten.
      • smarte Leistungsregelung - ist die Nulleinspeisung mit dem Abgleich eures P1-Power Sensors
    • jeder Akku wird separat aufgelistet
    • Jedes "Kopf" Zendure Gerät wird einzeln aufgelistet (z.B. Hyper, oder SF800 etc.)
    • jedes "Kopf" Gerät muss noch eine Geräte Sicherungsgruppe (oder Fusegroup) zugeordnet bekommen, ohne diese Zuordnung funktioniert der Smartmatch Mode NICHT (!)
      • daher erforderliche nächste Aktion, sonst funktioniert nichts: Gehen Sie zu jedem Gerät und wählen Sie dessen „Gerätesicherungsgruppe“ aus. Wenn sich die Geräte in derselben Phase befinden, können Sie „Sicherungsgruppe max. Y Watt“ auswählen, wobei Y die maximale Leistung ist, die der Wechselstromanschluss verarbeiten kann. Gehen Sie dann zum zweiten Gerät und wählen Sie: „Teil von Gerät X Sicherungsgruppe“. Auf diese Weise können Sie Geräte gruppieren, und die Integration stellt sicher, dass sie zusammen die maximale Leistung nicht überschreiten. Wenn ein Gerät allein steht, wählen Sie einfach „Gerät hat eigenen Stromkreis oder eigene Phase“.

Step 4: optional Umschaltung "CLOUD" zu "Lokal"

  • Wenn man sich von der Cloud abkoppeln möchte und den smartmatch mode der integration sauber laufen hat, gibt es pro "Kopf" Gerät die Einstellung der "Verbindungsart"
  • diese kann bei korrekten Daten auf lokal umgestellt werden. Nicht zu hektisch hier hin & her schalten (!) Immer mind. 5min dazwischen pause.
  • Bluetooth stick muss installiert sein für lokale Kommunikation und in HA via "bluetooth" auch angezeigt werden
  • die Bluetooth Verbindung wird beim einmaligen umstellen von Cloud zu lokal oder anders herum benötigt, anschließend senden die MQTT Daten via Wifi

Wenn alles erfolgreich eingetragen hat un die umstellung auf lokal geklappt hat, bekommt man ab version 1.1.4 auch solch eine Benachrichtigung.

Verbindungsstatus

Es gibt die Entität "Verbindungsstatus" welche euch ab 1.1.4 vermutlich anzeigen wird ob die Umschaltung auf lokal MQTT erfolgreich war. "0": "Unbekannt" "1": "HEMS" "2": "Keine Sicherungsgruppe" "10": "Verbunden (Cloud)" "11": "Verbunden (Local)" "12": "Verbunden (zenSDK)"

TroubleShot Sammlung: LINK