Anbindung einer HomeMatic an die Solaranzeige ab V4.x · In der HomeMatic Zentrale werden unter „Einstellungen → Systemvariable“ die Systemvariablen neu angelegt, die verwendet

Solaranzeige.deInformationen

Version 2.1 vom April 2020

Anbindung einer HomeMatic an dieSolaranzeige ab V4.x.x

Inhaltsverzeichnis

Solaranzeige.de......................................................................................................1

1.Einleitung..............................................................................................................21.1Beispiele................................................................................................................................3

2.Betrieb und Konfigurationszugang.......................................................................42.1Mit angeschlossener Tastatur & Monitor...............................................................................42.2Ohne angeschlossener Tastatur & Monitor...........................................................................4

3.Vorbereitung: Normale Installation ohne HomeMatic...........................................4

4.Datenübertragung von Solaranzeige zur HomeMatic...........................................54.1Systemvariable(n) in der Homematic anlegen......................................................................54.2Zu übertragende Werte in der Solaranzeige definieren........................................................84.3Konfiguration der Verbindungsdaten zur CCU......................................................................84.4Funktionskontrolle.................................................................................................................94.5Übertragungsintervall............................................................................................................94.6Firewall in der Homematic...................................................................................................10

5.Datenübertragung von HomeMatic zur Solaranzeige.........................................115.1Beispiele..............................................................................................................................115.2Konfiguration in der Solaranzeige.......................................................................................12

5.2.1Konfiguration der Übertragung von Gerätewerten zur Solaranzeige.......................................125.2.2Konfiguration der Übertragung von Systemvariablen zur Solaranzeige..................................135.2.3Werte im Grafana auswählen.................................................................................................14

6.Sonstiges............................................................................................................14

www.solaranzeige.de HomeMatic Anbindung: Seite 1 von 14 Seiten

http://www.solaranzeige.de/

1. Einleitung

Dieses Dokument beschreibt die Anbindung einer HomeMatic an die Solaranzeige.

Kompatibel sind alle Wechselrichter, welche ab Solaranzeige Version V4.x unterstützt werden.

Getestet wurde dies mit der HomeMatic Version 3.4.x

Diese Anbindung kann bidirektional eingerichtet werden:

1. Datenübertragung von Werten der Solaranzeige in Systemvariablen der HomeMatic

2. Übertragung von Gerätewerten und Systemvariablen der HomeMatic in die Datenbank der Solaranzeige

Es bestehen dann z.B. die Möglichkeiten, Daten aus der HomeMatic in der Solaranzeige zu visualisieren oder Daten aus der Solaranzeige in die Logiken der HomeMatic einfließen zu lassen.

Die Werte werden per HTTP GET auf Port 8181 zur CCU übertragen.

Die erforderlichen Schritte werden im Folgenden beschrieben.

Wichtig: Es ist nur eine Verbindung je Raspberry der Solaranzeige zur HomeMatic zulässig!

Bei Verwendung der Multi-Regler-Version darf also max. eine Verbindung in den x.user.config.php Dateien je Raspberry konfiguriert werden!

Sind mehrere Verbindungen je Raspberry zur CCU erforderlich, dann müssen diese mit dem MQTT Protokoll realisiert werden.



1.1 Beispiele1. Ein Aktor wird aktiviert, wenn die Photovoltaikanlage genügend elektrische Energie produziert

2. Werte des offiziellen Stromzählers vom EVU werden in der Solaranzeige visualisiert

3. Der DutyCycle wird in der Solaranzeige visualisiert

4. So könnte es in der CloudMatic App aussehen:

5. Steuerung einer Heizung

Auf dem Dash- board unsererFinca-Demo aufMallorca sieht mandie Schaltzuständevon HomeMaticGeräten sowie dieTemperatur einesSonoff TH16Relais mitTemperatursensor.Die Solaranzeigemeldet die Aussen-temperatur an dieHomeMatic, diedann diese Werteunter anderem zurSteuerung derGasheizungbenutzt.

Durch die Kopplung von der Solaranzeige, der HomeMatic und einzelnen Sonoff Geräten mit Tasmota Firmware ist ein Datenaustausch in alle Richtungen gewährleistet. Auch andere Smart Home Zentralen und Geräte können über das MQTT Protokoll eingebunden werden.



2. Betrieb und KonfigurationszugangDer Raspberry Pi der Solaranzeige kann sowohl mit Tastatur & Monitor als auch ohne Tastatur & Monitor betrieben und konfiguriert werden.

2.1 Mit angeschlossener Tastatur & MonitorMit angeschlossenem Monitor kann der Raspi direkt für die Visualisierung (Grafana) verwendet werden, bei einer angeschlossenen Tastatur kann der Raspi darüber auch konfiguriert werden.

Weiterhin sind alle Zugänge auch ohne angeschlossener Tastatur & Monitor möglich, siehe das folgende Kapitel.

2.2 Ohne angeschlossener Tastatur & MonitorDie Visualisierung (Grafana) kann von jedem Gerät mit einem Browser (z.B. TV, Notebook, Tablet, Smartphone) aufgerufen werden:

http://xxx.xxx.xxx.xxxx:3000 oder http://solaranzeige.local:3000

(xxx.xxx.xxx.xxx. Ist die IP Adresse des Raspberry Pi).

Ein angeschlossener Monitor ist dafür nicht erforderlich.

Die Konfiguration kann z.B. mit Putty auchaus der Ferne erfolgen, Tastatur & Monitormüssen dafür nicht am Raspi angeschlossensein.

Übrigens:Der Raspi kann auch nur als Weiterleitungfür die Daten zur HomeMatic Zentralebenutzt werden, ohne die Visualisierung zunutzen.

3. Vorbereitung: Normale Installation ohne HomeMaticDie Solaranzeige sollte im ersten Schritt ohne eine HomeMatic Anbindung eingerichtet werden. Erst wenn in der normalen Variante alles wunschgemäß funktioniert, sollte die Verbindung zur CCU der HomeMatic eingerichtet werden. Dies vereinfacht eine eventuelle Fehlersuche erheblich.

Siehe dazu die entsprechenden Anleitungen zur Ersteinrichtung.



http://solaranzeige.local:3000/

http://xxx.xxx.xxx.xxxx:3000/

4. Datenübertragung von Solaranzeige zur HomeMaticEs können maximal 20 Werte von der Solaranzeige zur HomeMatic übermittelt werden. Es wird nun Schritt für Schritt erklärt, wie diese Verbindung eingerichtet wird.

4.1 Systemvariable(n) in der Homematic anlegenIn der HomeMatic Zentrale werden unter „Einstellungen → Systemvariable“ die Systemvariablen neu angelegt, die verwendet werden sollen (siehe Bild). Die Variablen müssen genau wie in der Solaranzeige benannt werden. Bitte unbedingt auf Groß- und Kleinschreibung achten!

Dafür stehen bestimmte Werte der Solaranzeige zur Verfügung, siehe unten.

Die Maximalwerte sollten an die individuellen Gegebenheiten angepasst werden:



Zur Verfügung stehende Variablen (Stand Anfang 2019):// Hier werden die HomeMatic Variablen ausgewählt.// Die Namen der Variablen sind fix und dürfen nicht geändert werden.// Folgende Variablen sind möglich bei den einzelnen Reglern://// IVT-Hirschau SCplus oder SCDplus Regler No. 1//--------------------------------------------------------// Batteriespannung// Solarleistung// SolarleistungTag// BatterieLadestrom// Solarspannung// BatterieEntladestrom////// Regler der Tracer Serie No. 3//--------------------------------------------------// BatterieLadestatus// BatteriestatusText// Batteriespannung// Solarleistung// SolarleistungTag// BatterieLadestrom// Solarspannung////// BlueSolar und SmartSolar von Victron No. 4//-------------------------------------------------------// BatterieLadestatus// BatteriestatusText// Batteriespannung// Solarleistung// SolarleistungTag// BatterieLadestrom// Solarspannung////// Wechselrichter von AEconversion und Fronius No. 5,11//-------------------------------------------------------------------// Geraetestatus// Solarspannung// Solarstrom// Solarleistung// acAusgangsspannung// acAusgangsstrom// acWirkleistung// SolarleistungTag//// Wechselrichter No. 7, 8//---------------------------------------------------// Batteriespannung// Solarleistung// SolarleistungTag// Netzspannung// Netzfrequenz// acAusgangsspannung// acAusgangsfrequenz// acScheinleistung// acWirkleistung// Batteriekapazitaet// Temperatur// BatterieLadestrom// Solarspannung// Betriebsart////// Wechselrichter MPPSolar und Andere No. 9//-------------------------------------------------------// Batteriespannung// Batteriestrom// Batteriestromrichtung// Batteriekapazitaet// Temperatur// Solarleistung// Solarspannung1// Solarspannung2// Betriebsart//////// SolarMax S-Serie No. 10//--------------------------------------------------



// Solarspannung// Solarstrom// acAusgangsspannung// acAusgangsstrom// acWirkleistung// SolarleistungTag////// Joulie-16 von AutarcTech No. 13//--------------------------------------------------// Spannung// Strom// Fehlercode// SOC// Kapazitaet//// SolarEdge No. 16 + 20//--------------------------------------------------// AC_Spannung// AC_Leistung// Einspeisung (nur bei Regler 16)// Verbrauch (nur bei Regler 16)// Einspeisung (nur bei Regler 16)// Solarspannung// Solarstrom// Solarleistung// Temperatur// LeistungTag////// Kostal Plenticore No. 17//--------------------------------------------------// Ausgangslast// Verbrauch// Einspeisung// Solarspannung1// Solarspannung2// Solarspannung3// Solarleistung// SOC// Batteriespannung// Batteriestrom// LeistungTag////// S10 E von E3/DC No. 18//--------------------------------------------------// Wallbox// Verbrauch// Bezug// Solarleistung// Batterieladung// LeistungTag// String1_Leistung// String2_Leistung// String3_Leistung// SOC//////// Falls Sie die Wetterdaten vom Wetterserver abholen, dann// können auch folgende Variablen zusätzlich benutzt werden.// -----------------------------------------------------------// Wolkendichte 0 - 100 %// Wind m/s// AussenTemperatur °C

Die aktuell zur Verfügung stehenden Werte stehen in der Datei homematic.php

Aufruf mit : sudo mcedit /var/www/html/homematic.php



4.2 Zu übertragende Werte in der Solaranzeige definierenIn der Datei homematic.php werden die zu übertragenden Variablen festgelegt. Diese Variablen sollten zusätzlich in die Datei user.config.php eingetragen werden, damit diese bei einem Update der Datei homematic.php nicht verloren gehen.

Mit folgendem Aufruf können die Variablen angegeben werden:mcedit /var/www/html/homematic.php

Nach der Eingangsbeschreibung gibt es folgende Zeile:$HomeMaticVarBak = „BatterieLadestatus,BatteriestatusText,... “;

Zwischen die Gänsefüßchen alle Variablen eintragen, die übertragen werden sollen. Auf Gross- und Kleinschreibung achten. Die Namen genau so eintragen, wie oben in der Tabelle und in der HomeMatic angegeben. Jede Variable mit einem Komma trennen. Achten Sie auf die Gänsefüßchen und auf das Semikolon am Ende. Die müssen so bleiben und dürfen nicht gelöscht werden.

Hinweis:Die Wettervariablen können nur verwendet werden, wenn die Wetterdaten vom Wetterserver abgeholt werden. Siehe /var/www/html/user.config.sys ($Wetterdaten = true;)

4.3 Konfiguration der Verbindungsdaten zur CCUDie Verbindungsdaten zur CCU werden in die Datei user.config.php eingetragen, bei Multi-Regler Systeme ist es meistens die Datei 1.user.config.php.

Die Datei user.config.php im Unterverzeichnis /var/www/html/ des Raspberry Pi mit einem Editor aufrufen: mcedit /var/www/html/user.config.php

In der Mitte der Datei folgenden Einträge suchen und ändern:

$Homematic = true;

$Homematic_IP = „xxx.xxx.xxx.xxx“; (x.x.x.x durch die IP-Adresse der CCU ersetzen)



Die IP Adresse muss innerhalb des gleichen Subnetzes wie der Raspberry Pi sein. Fortgeschrittene Benutzer können verschiedene Subnetze verwenden, wenn die Gateways im Raspi der Solaranzeige und in der CCU der HomeMatic eingetragen sind und der Router/Firewallentsprechend konfiguriert ist.

Alle benutzten Variablen hier auch noch einmal zur Sicherheit aufführen.

Dann mit F2 abspeichern und den Editor mit F10 verlassen.

4.4 FunktionskontrolleNach dem Speichern werden die Daten jede Minute zur HomeMatic übertragen.

Nach ein paar Minuten sind in der HomeMatic die aktuellen Werte zu sehen. Auf der Seite „Status und Bedienung → Systemvariable“ in der HomeMatic Zentrale können die Werte und damit die Funktion geprüft werden.

Die Log-Datei solaranzeige.log sollte auf Fehlermeldungen bezüglich der Variablen geprüft werden: cat /var/www/log/solaranzeige.log

Fehlt eine Variable oder gibt es einen Schreibfehler, dann bricht die Übertragung ab und die nachfolgenden Variablen werden nicht mehr übertragen. Dies wiederholt sich jede Minute. Dadurch kann es vorkommen, dass in der HomeMatic nur einzelne Variablen richtige Werte haben. Hinweise dazu sind dann in der LOG Datei zu finden. Fehler werden jede volle Minute in der LOG Datei protokolliert.

4.5 ÜbertragungsintervallDie Daten werden pro Minute 1 mal an die HomeMatic übertragen. Auch wenn man Wiederholungen auf 6 stehen hat. (Alle 10 Sekunden) Es ist nicht vorgesehen, dass man das leicht ändern kann. Eine Änderung ist möglich, erfordert aber Programmierkenntnisse.



4.6 Firewall in der HomematicDie Firewall in der HomeMatic bzw. RaspberryMatic muss passend konfiguriert sein.

Menü: Einstellungen → Systemsteuerung → Firewall konfigurieren

Unter Remote Homamatic-Script API muss „Vollzugriff“ oder zumindest „Eingeschränkt“ ausgewählt sein. Bei „Eingeschränkt“ ist im unteren Feld das lokale Netzwerk und ggfls. Das Subnetz des Wechselrichters einzutragen. Siehe dazu die Dokumentation zur Homematic.

Wenn dies nicht passend konfiguriert ist, dann blockt die Firewall die Daten von der Solaranzeige. Entsprechend können die Daten in der HomeMatic nicht verarbeitet und angezeigt werden.



5. Datenübertragung von HomeMatic zur SolaranzeigeEs besteht die Möglichkeit, Daten (z.B. Werte oder Zustände) der HomeMatic zur Solaranzeige zu übertragen und dort zu visualisieren.

5.1 BeispieleIn diesem Beispiel wird der Status des HM-Aktors am Wasserboiler auf zwei verschiedene Arten visualisiert:

1. In Form einer Tabelle. Die Farben der Felder sind vom Wert abhängig

2. In Form eines Diagramms, einer Kurve.

Hier wird der DutyCycle der Homematic visualisiert



5.2 Konfiguration in der SolaranzeigeIn der user.config.php müssen einige Einträge erstellt werden, damit die Solaranzeige diese Werte aus der HomeMatic holen kann. Je Gerätewert in der HomeMatic sind vier Angaben und jeSystemvariable zwei Angaben erforderlich.

Aufruf der user.config.php im Editor wie immer mit mcedit /var/www/html/user.config.php

5.2.1 Konfiguration der Übertragung von Gerätewerten zur Solaranzeige

Folgende vier Variable müssen je Gerätewert angegeben werden:

$HM[x]["Variable"] = frei wählbarer Name, wird in der Influx Datenbank so gespeichert

$HM[x]["Interface"] = bitte aus der Homematic übernehmen

Beispiele: BidCos-RF, HmIP-RF, BidCos-wired

$HM[x]["Seriennummer"] = Die Seriennummer der Gerätes, muß aus der HomeMatic übernommen werden

$HM[x]["Datenpunkt"] = siehe „HomeMatic-Script Dokumentation, Teil 4: Datenpunkte“

Beispiele: STATE, TEMPERATURE, IEC_POWER

x = laufende Nummerierung, siehe unten

In diesem Bild sind drei der vier Variablen erkennbar (die vierte Variable ist der HomeMatic-ScriptDokumentation, Teil 4 Datenpunkte, zu entnehmen):

Die vier Variablen sind je Gerätewert durchzunummerieren. Der erste Gerätewert bekommt die Nummer 0, der zweite die Nummer 1, usw. Siehe Beispiel:

// ***************************************************************************// Anbindung an eine vorhandene HomeMatic Zentrale// Funktioniert nur mit den Reglern von Victron (BlueSolar und SmartSolar)// Falls Bedarf für andere Regler besteht, bitte melden.// Für die genaue Einrichtung bitte das PDF Dokument "Homematic_Anschluss.pdf" lesen.// Es befindet sich auf unserem Support Server im Bereich "Verschiedene PDF Dokumente"********************************************************************************/// Sollen die Daten an eine vorhandene Homematic Zentrale gesendet werden?// Diese Werte kann dann die Zentrale dann verarbeiten.// Folgende Werte werden übertragen:// * Ladestatus 0 = Keine Ladung, 2 = Fehler, 3 = Ladung (bulk); 4 = Nachladung (absorbtion),



// 5 = Erhaltungsladung (float)// * Ladestatus als Textzeile (Keine_Ladung, Normale_Ladung, Nachladung, Erhaltungsladung, Fehler// * Batteriespannung in Volt// * Erzeugte Leistung am Tage in kWh// * Aktuell erzeugte Solar-Leistung// * Batteriestatus in % (Wie voll ist die Batterie?) Nicht bei allen Geräten!//// true / false$Homematic = true;//// Welche IP Adresse hat Ihre Homematic Zentrale? Sie muss sich im selben// Netzwerk wie der Raspberry Pi befinden. Beispiel: 192.168.33.200$Homematic_IP = "192.168.178.4";//// Hier die Variablen eintragen, die zur HomeMatic Zentrale übermittelt werden// sollen. Siehe Dokument "HomeMatic_Anbindung.pdf"// Beispiel: "AC_Leistung,AC_Spannung,LeistungTag,Solarleistung,ImportGesamt,ExportGesamt,Temperatur,Verb$HomeMaticVar = "AC_Leistung,AC_Spannung,LeistungTag,Solarleistung,WR-ImportGesamt,WR-ExportGesamt//// Den Status einzelner Geräte aus der HomeMatic Zentrale auslesen und in die// Influx Datenbank schreiben, damit man den Status im Dashboard anzeigen kann.// Nähere Einzelheiten stehen im Dokument "HomeMatic Anbindung"$HM_auslesen = true;//// Für jedes Gerät, dessen Status ausgelesen werden soll, müssen 4 Variablen// angegeben werden.// $HM[0]["Variable"] = Kann man nennen wie man will// $HM[0]["Interface"] = Steht in der HomeMatic, bitte übernehmen// $HM[0]["Seriennummer"] = Steht auch in der HomeMatic// $HM[0]["Datenpunkt"] = STATE, POWER, ACTUAL_TEMPERATURE usw. Siehe HomeMatic// -----------------------------------------------------------------------// Beispiele: ( Die zwei Schrägstich bei Aktivierung bitte entfernen. )$HM[0]["Variable"] = "Wasserboiler";$HM[0]["Interface"] = "BidCos-RF";$HM[0]["Seriennummer"] = "OEQ1150699:1";$HM[0]["Datenpunkt"] = "STATE";

$HM[1]["Variable"] = "Thermometer_aussen";$HM[1]["Interface"] = "BidCos-RF";$HM[1]["Seriennummer"] = "LEQ1068901:1";$HM[1]["Datenpunkt"] = "TEMPERATURE";

$HM[2]["Variable"] = "Temp_aussen_Feuchte";$HM[2]["Interface"] = "BidCos-RF";$HM[2]["Seriennummer"] = "LEQ1068901:1";$HM[2]["Datenpunkt"] = "HUMIDITY";

$HM[3]["Variable"] = "EVUzaehler_aktLeistung";$HM[3]["Interface"] = "BidCos-RF";$HM[3]["Seriennummer"] = "NEQ0860725:1";$HM[3]["Datenpunkt"] = "IEC_POWER";

5.2.2 Konfiguration der Übertragung von Systemvariablen zur Solaranzeige

Folgende zwei Variable müssen je Gerätewert angegeben werden:

$HM[x]["Variable"] = frei wählbarer Name, wird in der Influx Datenbank so gespeichert

$HM[x]["Systemvariable"] = Name der Systemvariable in der HomeMatic

In diesem Bild ist die Systemvariable erkennbar:

$HM[4]["Variable"] = "DutyCycle";$HM[4]["Systemvariable"] = "DutyCycle";



5.2.3 Werte im Grafana auswählen

Die Werte aus der HomeMatic finden sich dann im Grafana unter dem Measurement „HomeMatic“ wieder:

6. Sonstiges

Bei offenen Fragen steht das Forum unter www.solaranzeige.de zur Verfügung.

Copyright [ www.solaranzeige.de ] Nachdruck ohne Genehmigung verboten.





Documents

Anbindung einer HomeMatic an die Solaranzeige ab V4.x · In der HomeMatic Zentrale werden unter „Einstellungen → Systemvariable“ die Systemvariablen neu angelegt, die verwendet