Hoymiles Mikrowechselrichter mit OpenDTU

Modul für IP-Symcon zur Integration der Hoymiles Mikrowechselrichter der Serien HM, HMS und HMT für Photovoltaik-Module über eine OpenDTU.

OpenDTU ist eine Firmware für den ESP32 und bildet zusamen mit einem NRF24L01+ bzw. CMT2300A Funkmodul ein Gateway zur Kommunikation mit den Wechselrichtern. OpenDTU stellt ein Webinterface zur Konfiguration und zum Auslesen der Wechselrichter zur Verfügung und kann mittels MQTT in andere Systeme eingebunden werden. Weitere Infos zum Bau und Einrichtung der OpenDTU gibt es im OpenDTU GitHub-Repository.

Inhaltsverzeichnis

1. Voraussetzungen
2. Enthaltene Module
3. Software-Installation
4. Einrichtung in IP-Symcon
5. Einrichtung in OpenDTU
6. Changelog
7. Lizenz

1. Voraussetzungen

• IP-Symcon ab Version 6.0
• OpenDTU (Dokumentation)
• Hoymiles Modulwechselrichter Serien HM, HMS und HMT

2. Enthaltene Module

• Hoymiles Microinverter (Dokumentation)
  Das Modul stellt alle Daten der Hoymiles Modulwechselrichter Serien HM, HMS und HMT, die an einem OpenDTU Gateway angemeldet sind in IP-Symcon bereit. Außerdem kann aus IP-Symcon heraus die Leistungsbegrenzung des Wechselrichters geändert werden.

• OpenDTU (Dokumentation)
  Das Modul stellt die Betriebsdaten der OpenDTU in IP-Symcon bereit. Außerdem ermöglicht es den Neustart der OpenDTU und ein Wiederverbinden der MQTT Verbindung.

• OpenDTU Configurator (Dokumentation)
  Der Konfigurator erkennt automatisch alle OpenDTU's, die am IP-Symcon MQTT Server angemeldet sind und ermöglicht so die einfache Erstellung der Instanz für den Hoymiles Modulwechselrichter ohne weiteren Konfigurationsaufwandt.

3. Software-Installation

Über den Module Store das 'Hoymiles OpenDTU'-Modul installieren.

4. Einrichtung in IP-Symcon

Hinweis: Die Einrichtung sollte erfolgen, wenn der Wechselrichter eingeschaltet ist (es liegt eine ausreichende DC-Spannung am Modul-Eingang an), da nur dann alle notwendigen Daten von OpenDTU bereitgestellt werden.

Vor der Einrichtung in IP-Symcon sollten die MQTT-Einstellungen in OpenDTU, wie im nächsten Kapitel beschrieben, vorgenommen werden.

Die Installation und Einrichtung der Hoymiles Microinverter-Instanzen erfolgt am einfachtsen mit dem OpenDTU Configurator. Der Konfigurator erkennt automatisch alle OpenDTU's und Wechselrichter, die am Symcon MQTT-Server angemeldet sind. Werden neue Instanzen aus dem Konfigurator heraus angelegt, werden sie automatisch eingerichtet und sind sofort funktionsbereit.

5. Einrichtung in OpenDTU

Im Webinterface der OpenDTU müssen unter Settings->MQTT die folgenden MQTT Broker Parameter angepasst werden:

• Hostname: IP oder Hostname des IP-Symcon Servers
• Port: Port des IP-Symcon MQTT-Servers
• Base Topic: Dieser Wert kann beliebig gesetzt werden und muss in IP-Symcon in der Hoymiles Microinverter-Instanz eingetragen werden, sofern nicht der Konfigurator benutzt wird.

6. Changelog

Version 1.2.0 (2023-05-23)

• Neu: Support für Wechselrichter der Serien HMT und HMS mit bis zu 6 PV-Modulen

Version 1.1.0 (2023-04-26)

• Neu: OpenDTU Instanz (Objektbaum -> Splitter Instanzen)
  • Statusvariablen für Hostname, IP, RSSI, Uptime, Online-Status
  • Statusvariablen für Gesamtenergie und -leistung aller Wechselrichter (ab OpenDTU Version v23.4.25)
  • Reboot() startet OpenDTU neu (über WebAPI)
  • ReconnectMQTT() versucht eine MQTT-Verbindung wiederherzustellen (über WebAPI)
  • Schalter für automatischen Reconnect bei MQTT-Verbindungsproblemen
  • Neuer Datenfluss (wird automatisch angepasst): MQTT-Server <-> OpenDTU (Splitter) <-> Microinverter (Device)
• Fix: Variablen mit Aktion können nun ohne Fehlermeldung deaktiviert werden
• Change: Funktionen UpdateVariableList und ResetVariableList auf Grund der Richtlinien des Module-Stores entfernt

Version 1.0.2

• Fix: Probleme mit utf-8 Kodierung bei Umlauten in Wechselrichternamen und Topics in Symcon 6.3
• Neu: Button zum Zurücksetzten des Konfigurators

Version 1.0.1

• FIX: Konfigurator hat falsche Wechselrichter-Namen angezeigt

Version 1.0.0

• Inital stable release

7. Lizenz

MIT License

Copyright (c) 2023 Tobias Ohrdes