Hoymiles WiFi Wechselrichter

Integration der Hoymiles Wechselrichter mit integrierten WiFi

• HMS-600W/700W/800W/900W/1000W-2T (Wi-Fi integrated)
• HMS-300W/350W/400W/450W/500W-1T (Wi-Fi integrated)

Inhaltsverzeichnis

• 1. Funktionsumfang
• 2. Voraussetzungen
  • Firmware der DTU
• 3. Software-Installation
• 4. Enthaltende Module
• 5. Anhang
  • 1. GUID der Module
  • 2. Changelog
  • 3. Spenden
• 6. Lizenz

1. Funktionsumfang

• Auslesen der Werte von DTU, Wechselrichter und Solar-Anschlüssen (Leistung, Ertrag, Spannung, Strom, Temperatur, Versionen)
• Leistungslimit in Prozent (dauerhaft) und in Watt (Laufzeit-Limit, HMS-W-2T-Familie)
• Wechselrichter ein- und ausschalten
• Warnliste des Wechselrichters
• Geräteinformationen (Seriennummern, Versionen, Modell und Nennleistung)
• Unterstützung der verschlüsselten Kommunikation ab DTU-Firmware V01.01.01
• Schlafmodus und Power-On Überwachung für Wechselrichter, die nachts abschalten

2. Voraussetzungen

• Symcon ab Version 8.1
• Hoymiles Wechselrichter mit WiFi (integrierte DTU)
• DTU-Firmware ab V01.01.01 empfohlen (siehe Firmware der DTU)

Firmware der DTU

Getestet mit den DTU-Firmware-Versionen V00.01.11 und V01.01.01. Die installierte Version zeigt die Statusvariable Software-Version der DTU-Instanz.

• Ab V01.01.01 kommuniziert die DTU verschlüsselt. Diese Firmware wird erst ab Version 1.23 dieser Library unterstützt, ältere Versionen melden Data has wrong length..
• Die Warnliste des Wechselrichters (Statusvariablen Aktive Warnungen, Aktuelle Warnung und Letzte Warnung) wird erst ab V01.01.01 geliefert, mit V00.01.11 bleibt sie leer.

Die Firmware wird über die App S-Miles Installer aktualisiert:

1. App S-Miles Installer öffnen.
2. Anlage öffnen, sofern die App nicht direkt zur Anlage springt.
3. Unten rechts über das letzte Icon die weiteren Funktionen öffnen und Geräteliste wählen.
4. Kategorie DTU auswählen und die Kachel der DTU antippen.
5. In der Liste der Eigenschaften unter Gerätewartung die Firmware-Aktualisierung wählen.
6. Mit Aktualisieren abschließen.

Während der Aktualisierung ist die DTU nicht erreichbar, die IO-Instanz meldet in dieser Zeit einen Fehler und verbindet sich danach selbstständig neu.

[!IMPORTANT] Vor einer Firmware-Aktualisierung (DTU oder Wechselrichter) die IO-Instanz schließen (Haken Öffnen entfernen) und danach wieder öffnen. Solange Symcon die DTU abfragt, kann die Aktualisierung bei 0 % stehen bleiben. Der Schlafmodus (HMSWIFI_SetInactive) reicht nicht, wenn ein Watchdog eingestellt ist, da dieser die Instanz wieder aktiviert.

[!WARNING] Eine Rückkehr zu einer älteren Firmware ist über die App nicht möglich.

3. Software-Installation

Über den 'Module-Store' in IPS das Modul 'Hoymiles WiFi' hinzufügen.
Bei kommerzieller Nutzung (z.B. als Errichter oder Integrator) wenden Sie sich bitte an den Autor.

4. Enthaltende Module

Nach der Installation der Library muss eine Instanz des Configurator-Moduls angelegt werden.
Dadurch wird automatisch der benötigte IO erstellt.

• Hoymiles WiFi IO (Dokumentation)
  IO Instanz zur Kommunikation mit der integrierten DTU.

• Hoymiles WiFi Configurator (Dokumentation)
  Konfigurator Instanz zum auslesen der bekannten Geräte und einfachen anlegen von Instanzen in Symcon.

• Hoymiles WiFi DTU (Dokumentation)
  Geräte Instanz für die integrierte DTU.

• Hoymiles WiFi Inverter (Dokumentation)
  Geräte Instanz für den integrierten Inverter.

• Hoymiles WiFi SolarPort (Dokumentation)
  Geräte Instanz für jeweils einen Anschluss von Solarmodulen.

5. Anhang

1. GUID der Module

Modul	Typ	GUID
Hoymiles WiFi IO	IO	{5972AA13-358F-A088-CEBD-207C289C9395}
Hoymiles WiFi Konfigurator	Configurator	{4062635D-2680-4A39-C364-05EB8B196DA9}
Hoymiles WiFi DTU	Device	{BB414362-B36F-81C5-2701-E968A29F58AD}
Hoymiles WiFi Inverter	Device	{52D8E128-5588-B496-4BE5-14E8EFD737B8}
Hoymiles WiFi SolarPort	Device	{65B18475-D1B7-825C-5958-5300C1100845}

2. Changelog

Version 1.26:

• Neu: Laufzeit-Leistungslimit in Watt für die HMS-W-2T-Familie (HMSWIFI_SetPowerLimitWatt, Statusvariable Leistungslimit (Watt) über die Instanz-Konfiguration). Wird bei einem Neustart des Wechselrichters zurückgesetzt, beschreibt keinen Flash-Speicher und eignet sich daher für häufige Änderungen, z.B. eine Nulleinspeisung
• Neu: IO zeigt Geräteinformationen (Seriennummern, Versionen, Modell und Nennleistung der Wechselrichter) in der Konfiguration an, abrufbar per HMSWIFI_GetDeviceInfo
• Erkennt die Instanz die Nennleistung des Inverters, wird sie als Maximum für Leistungslimit (Watt) genutzt
• Ein in der App geändertes Leistungslimit wird erkannt und in Leistungslimit (%) übernommen
• Dokumentation: Warnung, dass jedes Setzen des Leistungslimit in % den Flash-Speicher von DTU und Wechselrichter beschreibt
• Fix: Kamen zwei Anfragen gleichzeitig (z.B. zyklische Abfrage und HMSWIFI_SetInverterState), beantwortete die DTU nur eine davon; die andere meldete eine Zeitüberschreitung, obwohl der Befehl teilweise trotzdem ausgeführt wurde. Anfragen an die DTU werden jetzt nacheinander gesendet
• Fix: Scheiterte nach der nächtlichen Abschaltung die erste Abfrage einer verschlüsselten DTU, blieb das IO inaktiv, bis es manuell aktiviert wurde
• Fix: Statusvariable DTU WLAN Signalstärke zeigte in der Kachel-Visualisierung kein WLAN-Symbol
• SolarPort: Statusvariablen Leistung gesamt und Leistung täglich heißen bei neuen Instanzen Ertrag gesamt und Ertrag täglich (bestehende Variablen bei Bedarf selbst umbenennen)
• Dokumentation: Zusammenspiel von Leistungslimit in % und in Watt (es gilt der zuletzt gesendete Befehl), Hinweise zu HMSWIFI_RebootDTU und HMSWIFI_RebootInverter mit aktueller Firmware, Abschnitte Visualisierung (mit Screenshots von Kachel-Visualisierung und WebFront) und Aktionen in den Modul-Dokumentationen, aktuelle Screenshots der Konfiguration

Version 1.25:

• Die Statusvariable Inverter Warnungen gesamt (ein interner Ereigniszähler des Wechselrichters) entfällt, die Anzahl der aktuellen Warnungen liefert Aktive Warnungen. Die bestehende Variable wird nicht mehr aktualisiert und kann gelöscht werden
• Fix: Nach der Abfrage der Warnungen lieferte die DTU teilweise keine aktuellen Werte mehr (Daten blieben stehen). Die DTU wird jetzt nur noch bei neuen Warn-Ereignissen und sonst höchstens alle 30 Minuten zur Aktualisierung der Warnliste aufgefordert, dazwischen wird die Liste alle 5 Minuten nur gelesen
• Dokumentation: Hinweise zur DTU-Firmware und Anleitung zur Aktualisierung
• Warncodes mit zusätzlichen Status-Bits (z.B. 8408 oder 28888) werden mit Klartext angezeigt
• Fix: HMSWIFI_RebootDTU und HMSWIFI_RebootInverter meldeten einen Fehler, obwohl der Neustart ausgeführt wurde (die DTU bestätigt den Befehl nicht)
• Fix: Fehler im IO führten bei HMSWIFI_SetPowerLimit, HMSWIFI_SetInverterState, HMSWIFI_RebootDTU und HMSWIFI_RebootInverter zu einem PHP-Fehler statt zur Rückgabe false
• Fix: Statusvariable Link wechselte kurz auf Alarm, wenn die DTU den Link-Status in einer Antwort nicht mitgeliefert hat. Alarm erst nach 3 Abfragen in Folge ohne Link-Status

Version 1.24:

• Neue Statusvariablen Inverter: Aktive Warnungen, Aktuelle Warnung und Letzte Warnung
• Neue Instanz-Funktion HMSWIFI_GetWarnings liefert die Warnliste des Inverters
• Fehler bei der Abfrage der Warnliste werden nur im Debug ausgegeben und ändern nicht den Status des IO
• Fix: Leistungslimit sprang auf 0 %, wenn die DTU kein Limit mitgeliefert hat
• Leistungslimit kann nur noch im gültigen Bereich von 2 bis 100 % gesetzt werden
• Statusvariable Inverter Warnungen heißt jetzt Warnungen gesamt (bestehende Variable bei Bedarf selbst umbenennen)
• Fix: Leistungsfaktor wird als cos φ ohne Einheit dargestellt (vorher fälschlich in %)
• Fix: Schaltfläche Wechselrichter neu starten war zu schmal
• Fix: Ungültige Parameter der Darstellung von Leistungsfaktor und Link entfernt

Version 1.23:

• Unterstützung für DTUs mit verschlüsselter Kommunikation (neuere DTU-Firmware, Fehler Data has wrong length.)
• Antworten der DTU werden vollständig anhand der Länge im Header gelesen
• Erweiterte Debug-Ausgaben im IO
• Protobuf-Bibliothek auf Version 5.36.2 aktualisiert (behebt Deprecation-Meldungen mit neueren PHP-Versionen)
• Fehlermeldungen des IO übersetzt
• Neue Statusvariablen DTU: WLAN Signalstärke, Software-, Hardware- und WLAN-Version
• Neue Statusvariablen Inverter: Blindleistung, Warnungen, Software- und Hardware-Version
• Neue Instanz-Funktionen HMSWIFI_RebootDTU und HMSWIFI_RebootInverter (inkl. Schaltflächen in der Instanz-Konfiguration)
• Schlüsselmaterial verschlüsselter DTUs wird im Debug maskiert

Version 1.22:

• Fix: Support Links
• Update Submodule

Version 1.21:

• Unter bestimmten Umständen konnte die Instanz-Konfiguration des IO nicht mehr geöffnet werden
• Startverhalten des IO beim Symcon Neustart angepasst
• Umkonfigurieren der IO Instanz berücksichtigt nicht mehr den gespeicherten letzten Zustand (aktiv/inaktiv)
• Neue Power-On Überwachung mit zusätzlich Netzwerk-Ping oder eigener Bedingung

Version 1.2:

• Version für Symcon 8.1 und neuer
• Durchgängige Nutzung von Darstellungen anstatt von Profilen
• Neue Instanz-Funktion HMSWIFI_SetInverterState für die Inverter-Instanz

Version 1.0:

• Erstes Release nach Beta

3. Spenden

Die Library ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:

6. Lizenz

IPS-Modul:
Custom NC-SA

Klartexte der Warn-/Alarmcodes der Hoymiles Wechselrichter

• Quelle: ioBroker.hoymiles (https://github.com/Eistee82/ioBroker.hoymiles) (src/lib/alarmCodes.ts und src/lib/alarmCodesData.ts)
• MIT License, Copyright (c) Eistee82
• Die Texte stammen dort aus dem Hoymiles-Cloud-Wörterbuch (mwc) und der warn_code.json der S-Miles App.

Laufzeit-Leistungslimit in Watt und Feldnummern der Warnliste

• Quelle: ioBroker.hoymiles (https://github.com/Eistee82/ioBroker.hoymiles)
• MIT License, Copyright (c) Eistee82

Modell und Nennleistung aus der Hardware-Teilenummer

• Quelle: OpenDTU (https://github.com/tbnobody/OpenDTU) (lib/Hoymiles/src/parser/DevInfoParser.cpp)
• GPL-2.0, Copyright (c) Thomas Basler und Mitwirkende
• Übernommen wurde nur das Schema der Modelltabelle (Anzahl Eingänge und Leistung je Eingang), kein Code.