Zendure HA integration – Troubleshoot & Mini Anleitung - Kieft-C/Zendure-BKW-PV GitHub Wiki

TroubleShot Sammlung:

Integration scheint zu funktionieren, aber mein xtes Gerät wird nicht angezeigt

Die Geräte dürfen **nicht **den selben Namen haben. Wenn man zwei Geräte in der Integration nutzen möchte, muss man diese vorab in der officiellen Zendure App umbenennen . Zusätzlich vermeide Sonderzeichen bei der Namensgebung. Klein-, Großschreibung und Zahlen sollten kein Problem sein.


Integration sieht funktional aus, aber Überschuss Laden hängt bei 50W oder startet nicht mehr richtig

Gegenfalls wurden Sensoren / Entitäten deaktiviert die für einen sauberen Betrieb benötigt werden. Mindestens benötigt werden:

  • *gridInputPower (Stromnetz-/Offgrid-Eingangsleistung)
  • *outputHomePower (Ausgangsleistung)
  • *packInputPower (BatterieAusgangsLeistung)
  • *outputPackPower (BatterieEingangsLeistung)
  • *socLimit
  • *outputLimit
  • inputLimit
  • *minSoc
  • *socSet
  • *socStatus
  • *pass
  • *electricLevel
  • *acMode
  • *hemsState
  • für Geräte mit PV *solarInputPower
  • optional *gridOffPower ist nötigt wenn offGrid Steckdose genutzt wird

Zendure Manager Erläuterung:

"off"

  • AC In & AC Out Werte pro Geräteeinstellung werden nutzbar
  • ignoriert Fuse-Gruppen-Zuordnung

"manual"

  • Der manuelle Power-Wert im Zendure Manager wird zur Entladung genutzt, über die definierte Sicherungsgruppe

"smart"

  • Versucht, den zugewiesenen Leistungssensor bei 0 W (Nulleinspeisung) zu halten (mit exakter Entlade- oder Ladeleistung der Geräte in der Sicherungsgruppe)
  • Überschuss-Laden ist aktiv: Wenn Überschuss erkannt wird, lädt er das Gerät mit dieser Leistung

"smart discharging"

  • wie „Smart“, jedoch Überschuss-Laden deaktiviert

"smart charging"

  • wie „Smart“, jedoch ohne Null-Einspeisung/0-W-System und nur mit Überschuss-Laden aktiv

Zendure Manager - Smart - Strategie der Leistungsverteilung (bei mehr als einem Gerät)

Verwendet ein Gerät so lange wie möglich und wechselt nicht zu häufig zwischen den Geräten. Bis 85 % Geräteauslastung wird nur ein Gerät genutzt, darüber wird die Leistung gleichmäßig aufgeteilt.

Für die Verteilung wird der relative SOC für alle Geräte berechnet => kWh * (electricLevel-minsoc). Dieser SOC wird in Schritten von 0,5 kWh berechnet, um häufiges Umschalten zu vermeiden. Wenn ein Gerät den SOC-Min-Grenzwert erreicht hat, wird es nicht mehr für die Verteilung verwendet.

Zum Entladen der Geräte wird in der Reihenfolge des größten relativen SOC gearbeitet. Zum Laden der Geräte wird in der Reihenfolge des kleinsten relativen SOC gearbeitet.

Auf diese Weise bleibt die maximale „Spitzenleistung“ so lange wie möglich verfügbar. (Achtung: Stand ist ggf. ab Version 1.2.X nicht mehr vollständig korrekt)


BLE Verbindung wird nicht angezeigt bzw. nur sporadisch und damit klappt Umschaltung auf lokal MQTT nicht

  • vermutlich liegt es an der schlechten Reichweite von Bluetooth-Stick & Zendure Device
  • einfachste Lösung: Abstand verringern und/oder Fenster/Türen öffnen bei der Umschaltung von Cloud zu lokal
  • mittels https://github.com/agittins/bermuda kann man die Geräte-Signalstärke via RSSI-Angabe besser einschätzen

Sollten eure Geräte/Batterien nur teilweise auftauchen und/oder ggf. nur teilweise Entitäten Werte anzeigen

  1. Bei "Eintellungen" -> "Geräte und Dienste" -> "Zendure Integration" -> Drei punkte "neu laden" drücken
  2. anschließend HA neustarten und dann sollte es korrekt angezeigt werden

Nach Update von der HA Integration geht nichts mehr, davor lief es ohne Probleme

  • vermutlich hast du von einer sehr alten Version auf eine relativ neue geupdatet mit Einführung des Zendure-API-Tokens ist die Integration nicht mehr mit dem Zwei-Account-Modell kompatibel und muss neu konfiguriert werden
  • bitte lösche die Integration und entferne sie einmal aus HACS und arbeite anschließend das Tutorial durch: LINK

Smartmode aus dem ZendureManager funktioniert nicht.

  • Integration mit mind. Version 1.1.3 installiert?
  • Fusegroup und/oder P1 Power Sensor korrekt angegeben?
  • HEMS in der Zendure App deaktiviert??
  • Zendure Gerät hat neusten Updates bekommen?

Die Umschaltung auf lokal gelingt mir nicht

  • Bluetooth Stick ist korrekt installiert, in HA erkannt und in Reichweite zum Zendure Gerät?
  • bei der Umschaltung von Cloud auf lokal mind. 5min gewartet ?
    • die Umschaltung & das Update der BLE Daten erfolgt nur alle 5min, daher hier bitte entsprechend geduld mitbringen
    • steht bei dem Zendure Kopf Gerät eine Bluetooth MAC-Adresse? Dies ist das Zeichen, dass die BLE Verbindung vorhanden ist
    • ist die Entität "Verbindungsstatus: Verbunden" bei Cloud? falls nein -> Integration neu konfigurieren und Daten prüfen

Bei mir gibt es kein ZenSDK, wann kommt das Update?

  • ZenSDK ist die neue Kommunikationsart um die lokale Kommunikation via MQTT herzustellen, ohne Umstellung via Bluetooth
  • SF800 Pro & 2400AC können ZenSDK und vermutlich alle zukünftigen Zendure Geräte
  • HUB1200, HUB2000, AIO2400, HYPER2000 und SF800 benötigen eine Bluetooth Verbindung für die Umstellung auf lokales MQTT und sind nicht ZenSDK kompatibel

Bei mir funktioniert "nichts", trotz des Tutorials nicht alles richig und ich komme nicht weiter, aber meine Daten zur Installation stimmen 100%

Dann ist es hilfreich, ein Debug-Log zu erstellen und in GitHub ein Issue zu eröffnen mit dem Debug-Log als Anhang.

  1. Debug-Protokollierung aktivieren bei der Zendure HA Integration
  2. Integration löschen, aber nicht auch HACS löschen, nur bei "Geräte & Dienste"
  3. Neustart von HA (nicht vom gesamten System) und nach dem Neustart 5 Minuten warten, damit alles vollständig initialisiert wurde
  4. Installiere die Zendure Integration erneut bei "Geräte & Dienste"
  5. nach 5–10 Minuten kann das Debug-Log deaktiviert werden, da dann genügend Daten gesammelt wurden
  6. jeder hat mit der Nutzung von HACS ein Profil bei GitHub, damit könnt ihr euch einloggen
  7. "New Issue" erstellen mit: https://github.com/Zendure/Zendure-HA/issues/new/choose
  8. Problem dort möglichst genau, aber dennoch kurz beschreiben und Debug-Log anhängen

Bei mir funktioniert "Dies" oder "Das" nicht, aber der rest geht, ich versteh schon wieder nicht was los ist

  • dann ist ebenfalls hilfreich ein Debug Log zu erstellen und in Github un dem DebugLog als Anhang zu eröffnen
  1. gehe 1:1 genauso vor wie bei der vorherigen Troubleshoot-Anleitung
  2. schalte / probiere an den Entitäten, die nicht funktionieren, entsprechend hin und her
  3. aber mit mindestens 5 Minuten Abstand bei jedem Schaltvorgang
  4. anschließend geht es weiter wie bei Punkt 5 oben

Wie erstelle ich ein DebugLog ?

  1. Bei "Eintellungen" -> "Geräte und Dienste" -> "Zendure Integration" -> Drei punkte oben rechts in der Statusleiste "Debug-Protokoll aktivieren" drücken
  2. anschließend sollte diese Zeile auftauchen:
  3. sobald Ihr wieder es deaktiviert, wird das Debug-Logfile lokal auf euer Gerät gespeichert
  • auf dem Telefon muss ggf. das Speichern noch als extra Schritt erfolgen (bei Apple Geräten zb.:)

Zusatzinfo: zusätzlich sollte bei dem Setup herstellen, dass mqtt logging aktiviert worden sein, für eine bessere Fehleranalyse


MQTT Logging zeigt bei Umschaltung von "CLOUD" zu "LOCAL" - Device XXXXX nicht authorisiert

  1. Einstellungen -> Personen -> Benutzer: Check ob das Device XXXXX nicht dort aufgelistet ist, dann:
  2. Starte DebugLog der Zendure Integration
  3. Starte HA neu
  4. NeuLaden der Zendure Integration via dreiPunkte Menü bei Geräte&Dienste
  5. Check in Einstellungen -> Personen -> Benutzer ob das Device XXXXX angelegt wurde, falls ja:
  6. Umschaltung von Communication CLOUD zu LOCAL durchführen