Autor: WiB

Kategorien
Allgemein

OpenDTU Einbindung in HomeAssistant

OpenDTU Einbindung in Home Assistant


Hier eine kurze Anleitung zur Einbindung von OpenDTU in Home Assistant.

Voraussetzungen:
– das Home Assistant AddOn „Mosquitto broker“ muss bereits installiert und aktiv sein
– OpenDTU ist bereits im Netzwerk verfügbar und aktiv

Testsetup:
– Home Assistant 2023.7
– mein DTU-Kombi Modul für die HM- und HMS/HMT-Serie,
– einen Hoymiles HM-800 (Name in OpenDTU „HM800-Ost“)
– einen Hoymiles HMS-500 (Name in OpenDTU „HMS500-West“)

Beginnen wir mit der Konfiguration in OpenDTU:

Bevor wir jedoch MQTT aktivieren, bitte bedenken, dass der Name, der in OpenDTU beim Wechselrichter hinterlegt ist, auch der Name der Home Assistant Entität ist. Wollt ihr den Namen ändern, wäre jetzt ein guter Zeitpunkt.

Unter „Einstellungen->MQTT“:

Wenn auch die einzelnen Module/Paneele angezeigt werden sollen, weiter runterscrollen und die Option „Einzelne Paneele“ aktivieren:

Danach die Einstellungen speichern. Die Konfiguration in OpenDTU ist somit abgeschlossen.

Nun die Einstellungen in Home Assistant:

Wenn die Einstellungen für den MQTT-Broker korrekt konfiguriert wurden, sollten die Wechselrichter direkt beim MQTT-AddOn als neue Geräte auftauchen. Geht dazu in Home Assistant auf „Einstellungen -> Geräte & Dienste -> MQTT“ und wählt die Geräte aus. Hier sollten nach ein paar Minuten (abhängig von den eingestellten Abfrage-Intervall in OpenDTU) die Wechselrichter als Geräte auftauchen:

Öffnet eines der Geräte und es werden alle Sensoren/Entitäten des Wechselrichters angezeigt.
Neben den Sensoren werden auch die Parameter für die Konfiguration des Wechselrichters angezeigt, welche zum Beispiel zum Setzen der Limits verwendet werden können.
 
 


Happy testing,
WiB

PS: Ich habe keine Verbindung zur Entwicklung der OpenDTU Software, sondern bin nur ein großer Fan 🙂

Kategorien
Allgemein

OpenDTU – Olimex-PoE – Pin-Mapping einstellen für opendtu-generic Firmware

OpenDTU - Olimex-PoE - Pin-Mapping einstellen für opendtu-generic Firmware

Nach dem Flashen mit der opendtu-generic.bin kann nur eine Verbindung über WLAN hergestellt werden. Zum Aktivieren des LAN-Moduls muss (einmalig) ein spezielles „Pin-Mapping“ aktiviert werden.

Zuerst wird die Datei „olimex_esp32_poe.json“ benötigt. Diese befindet sich auf der OpenDTU-Projekt-Seite auf GitHub:
olimex_esp32_poe.json
Speichern der Datei mit rechter Maustaste „Speichern unter…“

Nun mit dem Browser auf die OpenDTU Seite verbinden und den Menüpunkt „Einstellungen -> Konfigurationsverwaltung“ wählen:

Im Bereich „Wiederherstellen“ den Eintrag „Pin Mapping“ auswählen, auf „Durchsuchen“ klicken und die heruntergeladene Datei „olimex_esp32_poe.json“ auswählen. Punkt „Wiederherstellen“ wählen.
OpenDTU starten jetzt neu.

Nach dem Neustart im Menüpunkt „Einstellungen->Hardware“ das Profil „Olimex ESP32-POE“ auswählen und am Ende der Seite „Speichern“ klicken:

OpenDTU startet jetzt noch einmal neu.

Das LAN-Modul sollte nun aktiv sein.
Höchste Priorität hat immer das LAN-Modul. Sollte hier keine Verbindung möglich sein, wird automatisch auf WLAN gewechselt. Sobald eine Verbindung über LAN hergestellt wird, wird wieder auf die LAN-Verbindung gewechselt.

Happy testing,
WiB

PS: Ich habe keine Verbindung zur Entwicklung der OpenDTU Software, sondern bin nur ein großer Fan 🙂

Kategorien
Allgemein

OpenDTU? – Was ist das?

OpenDTU? Was ist das?

OpenDTU ist eine kostenlose Open-Source-Software zum Auslesen von Hoymiles Wechselrichter.

 

Die Software läuft auf einem ESP32-Mikrocontroller und kommuniziert über ein zusätzliches Funkmodul mit dem Hoymiles Wechselrichter.
Von Hoymiles werden unterschiedliche Funkmodule/Frequenzen verwendet. Die HM-Serie verwendet ein 2,4GHz Modul und die HMS/HMT Serie ein Sub-1G Modul.
Eine Übersicht, welcher Wechselrichter welches Modul erfordert, ist auf der OpenDTU-Projektseite zu finden: OpenDTU-Wechselrichter

Hier eine Liste der wichtigsten Funktionen von OpenDTU:

  • Auslesen der Echtzeitdaten vom Wechselrichter
  • Keine Cloud-Anbindung erforderlich
  • Daten können via MQTT weitergeleitet werden
  • Daten können via WEB-API abgefragt werden
  • Unterstützung von bis zu 10 Wechselrichter
  • Anzeige und Einstellen der Wechselrichter-Limits (auch via MQTT möglich)

Eine Liste aller Funktionen und Aufbau der Hardware gibt es auf der Projektseite:

OpenDTU – Projekt

 

Happy testing,
WiB

PS: Ich habe keine Verbindung zur Entwicklung der OpenDTU Software, sondern bin nur ein großer Fan 🙂

Kategorien
Allgemein

OpenDTU – Display (re-)aktivieren

OpenDTU - Display (re-) aktivieren

Ein Display mit Standard-Verkabelung (wie auf GitHub beschrieben) an einem ESP32 kann wie folgt (re-) aktiviert werden:

Zuerst wird die Datei „nodemcu_esp32.json“ benötigt. Diese befindet sich auf der OpenDTU-Projekt-Seite auf GitHub:
nodemcu_esp32.json
Speichern der Datei mit rechter Maustaste „Speichern unter…“

Nun mit dem Browser auf die OpenDTU Seite verbinden und den Menüpunkt „Einstellungen -> Konfigurationsverwaltung“ wählen.
Im Bereich „Wiederherstellen“ den Eintrag „Pin Mapping“ auswählen, auf „Durchsuchen“ klicken und die heruntergeladene Datei „nodemcu_esp32.json“ auswählen. Punkt „Wiederherstellen“ wählen.
OpenDTU starten jetzt neu.

Nach dem Neustart im Menüpunkt „Einstellungen->Hardware“ das Profil „Generic NodeMCU 32 mit SSD1306“ auswählen und am Ende der Seite „Speichern“ klicken.
OpenDTU startet jetzt noch einmal neu.

Das Display sollte jetzt aktiv sein.

Wenn das Display um 180° gedreht werden soll, kann dies unter „Einstellungen -> Hardware -> Display“ angepasst werden.

Links zum Projekt (englisch):
– https://github.com/tbnobody/OpenDTU
 

Happy testing,
WiB

PS: Ich habe keine Verbindung zur Entwicklung der OpenDTU Software, sondern bin nur ein großer Fan 🙂

Kategorien
Allgemein

OpenDTU – MQTT Topics

OpenDTU - MQTT Topics

Eine Beschreibung aller MQTT Topics ist auf GitHub zu finden:
https://github.com/tbnobody/OpenDTU/blob/master/docs/MQTT_Topics.md

Happy testing,
WiB

PS: Ich habe keine Verbindung zur Entwicklung der OpenDTU Software, sondern bin nur ein großer Fan 🙂

Kategorien
Modbus

WiB-MBG Einrichtung

Am Modul WiB-MBG (ModBusGateway) befindet sich die kostenlose Open-Source-Software Tasmota.

Zum Einrichten muss zuerst das Modul in das eigene WLAN (2,4GHz) eingebunden werden.
Beim Model WiB-MBG-PoE und Verwendung eines LAN-Kabels kann dieser Schritt übersprungen werden und es geht weiter mit Punkt 5.

  1. Nach dem Anschließen an eine Stromquelle aktiviert das Modul ein eigenes WLAN (HotSpot). Nun mit einem Gerät (z.B. Handy oder PC) mit dem WLAN „Tasmota-xxxxxx“ verbinden (der Hinweis „Nicht mit dem Internet verbunden.“ ist in OK und kann bei der Einrichtung ignoriert werden)
  2. Im Browser die URL http://192.168.4.1 öffnen
  3. Nun die Zugangsdaten für das eigene 2,4GHz WLAN eingeben (5GHz WLAN wird nicht unterstützt!) und speichern.
  4. Wenn die Daten korrekt eingegeben wurden, verbindet sich das Modul jetzt mit dem eingegebenen WLAN und die neue IP-Adresse wird angezeigt:
  5. Sollte die angezeigte IP-Adresse nicht erreichbar sein, bitte am WLAN-Router unter den DHCP-Clients nachsehen, welche IP-Adresse das Modul bekommen hat. Der Name beginnt meistens mit ESP32 oder Tasmota (abhängig vom Router).
    Alternativ können auch Tools wie Advanced IP Scanner oder Angry IP Scanner verwendet werden, um Geräte/IP-Adressen im internen Netzwerk zu finden.
  6. Das Gerät ist jetzt fertig konfiguriert. Das Modbus/TCP Gateway ist unter der IP-Adresse des Moduls auf Port 502 verfügbar.
  7. Fixe IP-Adresse einstellen (Optional):
    1. mit dem Browser auf die IP-Adresse des Moduls verbindem
    2. Menü „Consoles“
    3. Menü „Console“
    4. Zum Ändern der IP-Adresse auf 192.168.0.70 (als Beispiel) folgende Befehle eingeben:
      savedata 1
      ipaddress1 192.168.0.70
      savedata 0
    5. Nach einem Neustart sollte das Modul auf der IP-Adresse 192.168.0.70 erreichbar sein.

Wichtiger Hinweis:
Führen Sie kein Firmware-Update durch, da in der Standard-Firmware Modebus/TCP deaktiviert ist!

Links zum Projekt (englisch):
– https://www.tasmota.info/
– https://tasmota.github.io/docs/

Kategorien
Modbus

WiB-MBG Beschreibung

WiB-MBG (ModeBusGateway) ist eine Hardware-Lösung mit der Open-Source-Software Tasmota und aktivierter Modbus/TCP Funktion.

Damit besteht die Möglichkeit, über das Netzwerk auf Modbus-Daten (z.B. PV-Wechselrichter) zuzugreifen und diese in Smart-Home Lösungen zu integrieren.

Zur Stromversorgung wird ein handelsübliches USB-Netzteil benötigt.
Für die Verbindung zum Modbus, ist ein 1 Meter langes Kabel direkt mit dem Modul verbunden.
Das Modul hat eine Abmessung von ca. 5cm x 4cm x 3cm (HxBxT).
Hinweis: Ein Modul mit LAN-Modul und PowerOverEthernet (PoE) ist in Planung (bei Interesse bitte melden).

Für alle, die noch nicht mit Modbus gearbeitet haben, empfehle ich,  sich mit den Grundlagen (Register, Function-Codes, etc) von Modbus vertraut zu machen.
Zum Einsteigen: https://de.wikipedia.org/wiki/Modbus

Wichtig:
– Das Gerät wird bei der Ersteinrichtung in das eigene WLAN eingebunden (es wird nur ein 2,4GHz WLAN unterstützt!).
– Zur Stromversorgung muss das Gerät an ein normales USB Ladegerät angeschlossen werden (muss nicht am PC angeschlossen sein).
– Tasmota erlaubt (derzeit) nur eine Verbindung zum Modbus/TCP Modul
– der Preis ist für die Hardware-Lösung (Tasmota ist eine kostenlose Open-Source-Software)


Links zum Projekt und Source-Code:
– https://github.com/arendst/Tasmota
– https://www.tasmota.info/
– https://github.com/arendst/Tasmota/blob/development/LICENSE.txt

Kategorien
Allgemein

Firmware Upgrade

Wichtiger Hinweis:

Ich übernehme keine Gewährleistung oder Support für die Firmware und für das Firmware-Upgrade. Dieser erfolgt auf eigene Gefahr!
Daher: wenn das Modul stabil läuft, sollte man überlegen, ob ein Upgrade überhaupt Sinn macht.

Informationen direkt vom Entwickler zum selber kompilieren gibt es hier: Flashing and starting up
Aktuell Informationen zu den Versionen von OpenDTU gibt es hier im Change Log
Wichtig: Beachtet auch die Breaking changes.

Für ein Upgrade kann die Datei „opendtu-generic.bin“ von GitHub verwendet werden.
https://github.com/tbnobody/OpenDTU/releases

Die Datei „opendtu-generic.bin“ kann direkt über die OpenDTU Web-Oberfläche zum Updaten verwendet werden (Breaking changes beachten!).

Nutzer des Olimex-PoE Modules müssen zusätzlich einmalig das korrekte Pin-Mapping konfigurieren.
Eine Anleitung findet ihr hier: OpenDTU – Olimex-PoE – Pin-Mapping einstellen für opendtu-generic Firmware

PS: Ich habe keine Verbindung zur Entwicklung der OpenDTU Software, sondern bin nur ein großer Fan 🙂

Kategorien
Allgemein

Einbindung OpenDTU in IP-Symcon​

Es gibt nun auch ein OpenSource Modul für IP-Symcon (ab Version 6), um direkt ein OpenDTU einzubinden.
Das Modul heißt „Hoymiles OpenDTU“ und ist direkt im Module Store von IP-Symcon zu finden.

Details zum Modul und wie es aktiviert werden kann, gib es auf GitHub:
https://github.com/roastedelectrons/HoymilesOpenDTU

Standardmäßig werden nur die Gesamt-Informationen vom Wechselrichter angezeigt. Sollen auch die Informationen der einzelnen Strings angezeigt werden, dann können diese in der Instanz-Konfiguration aktiviert werden:

Ist alles eingerichtet, dann sieht das so aus:

Happy testing,
WiB
Kategorien
Allgemein

WiB-DTU-PoE Beschreibung

WiB-DTU-PoE ist eine Hardware-Lösung für die OpenSource Software OpenDTU.
Die Lösung besteht aus den Modulen ESP32 mit Power-Over-Ethernet (PoE) und nRF24L01+ mit externer Antenne (Long-Range Version). Das ganze verpackt in einem kleinen Gehäuse und einem 1 Meter USB-Kabel.
WiB-DTU-PoE besitzt zusätzlich zum WLAN einen LAN-Anschluss (100MB) mit PoE. Daher kann es wahlweise über WLAN oder LAN betrieben werden.
Dadurch ist nicht zwingend ein WLAN und Stromanschluss in der Nähe des Wechselrichters erforderlich, da beides über das LAN-Kabel zum Modul geleitet werden kann.
Sollte ihr Router/Switch kein PoE integriert haben, so kann dies auch über einen sogenannten PoE-Injector umgesetzt werden.

Funktionsumfang:

  • Anzeige aktueller Daten der Inverter (Wechselrichter)
  • Anzeige vom Inverter Eventlog
  • Anzeige von Inverter-Informationen wie Firmware-Version, Hardware-Revision, Hardware-Version
  • Anzeige und setzen des Inverter-Limits
  • Unterstützt bis zu 10 Inverter
  • MQTT Support
  • Home Assistant MQTT Auto Discovery Funktion
  • Firmware Upgrade über die Web-Oberfläche
  • Passwortschutz zum Ändern der Einstellungen

Folgende Hoymiles Modelle werden derzeit von OpenDTU unterstützt (Quelle):
– HM-300
– HM-350
– HM-400
– HM-600
– HM-700
– HM-800
– HM-1000
– HM-1200
– HM-1500
– TSUN TSOL-M350 (anscheinend abhängig von der Firmware)
– TSUN TSOL-M800 (anscheinend abhängig von der Firmware)
– TSUN TSOL-M1600 (anscheinend abhängig von der Firmware)

Folgende Werte werden vom Wechselrichter angezeigt:
– Gesamtwert aller Wechselrichter
– Leistung einzelner Wechselrichter
– Leistung der einzelnen Eingänge am Wechselrichter

OpenDTU unterstützt auch das Einstellen eines Limits am Wechselrichter (temporär oder fix):Am Gerät selbst werden keine Daten gespeichert und die Daten werden auch nicht ins Internet (Cloud) gesendet!

Wichtig:
– Diese Lösung ist für alle gedacht, die nur die aktuellen Werte der PV Anlage ablesen möchten bzw. diese in eine eigene SmartHome-Lösung integrieren wollen.
– Es können keine TOR-Settings (Grid-Profile) eingestellt werden
– Wer eine fertige Cloud-Lösung mit historischen Daten und Statistiken sucht, sollte sich eher die vom Hersteller angebotenen Module DTU-Wlite oder DTU-Pro ansehen.
– Es werden derzeit nur die oben genannten Wechselrichter unterstützt.
– Zur Stromversorgung kann das Gerät entweder über PoE (>=37V) oder an ein normales USB Ladegerät angeschlossen werden.
– Das Gerät wird bei der Ersteinrichtung wahlweise in das eigene WLAN (es wird nur ein 2,4GHz WLAN unterstützt!) oder direkt über LAN in das eigene Netzwerk eingebunden.
– Ich habe keine Verbindung zur Entwicklung des OpenDTU Projektes. Der Preis ist für die Hardware-Lösung. Ich installiere jedoch die aktuelle OpenDTU Version (Kurzanleitung zur Installation wird mitgeliefert bzw. kann hier online abgerufen werden).

Kosten für das fertige Modul: 60€ (exkl. Versand)
Bei Interesse oder Fragen: info@wib-dtu.eu

Links zum Projekt (englisch):
– https://github.com/tbnobody/OpenDTU
– https://github.com/tbnobody/OpenDTU/blob/master/LICENSE

Ich möchte mich an dieser Stelle bei allen beteiligten Entwicklern von OpenDTU und Ahoy bedanken, die eine tolle Leistung bei der Entwicklung vollbracht haben und noch immer vollbringen.
Danke!