Vitoconnect

vitoconnect
Zweck / Funktion
Steuerung von Viessmann Heizungen
Allgemein
Typ	Gerätemodul
Details
Dokumentation	EN / DE Thema
Support (Forum)	Heizungssteuerung/Raumklima
Modulname	98_vitoconnect.pm
Ersteller	Marc (Forum /Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Vitoconnect ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen.

Mit dem FHEM Modul vitoconnect können die Daten, die über die Internetschnittstelle an den Herstellerserver gemeldet und von diesem über eine API zur Verfügung gestellt werden, in FHEM in Form von Readings angezeigt werden. Auch eine Steuerung der Heizung ist mit diesem Modul möglich.

Wen stört, dass die Daten in der Herstellercloud liegen, sei das Modul Vitotronic 200 (Viessmann Heizungssteuerung) empfohlen.

Die Idee zu dem Modul enstand aus dem Thread "Viessmann VitoConnect API". Es basiert auf dem PHP Modul von thetrueavatar.

Aktuelle Entwicklung des Moduls

Das "offizielle" Modul im SVN ist derzeit "verwaist", der Maintainer (mcp) nicht mehr aktiv:

• Ursprüngliches Forenthema (86073): geschlossen; enthält "inoffizielle" Modulupdates von verschiedenen Autoren in verschiedenen Beiträgen
• Neues Forenthema (Vitoconnect - Verbesserte Version), Benutzer stefanru  ; dieses Forenthema wird der neue "Entwicklungsthread" zum Modul. Dort werden auch (im ersten Beitrag) die Modul-Downloads zu finden sein.

Disclaimer zur Ursprungsversion des Moduls

Das Modul wurde nach bestem Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Viessmann API erfolgen, sollte die Nutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!

Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread "Neues Modul: vitoconnect" statt.

Einrichtung

Vorbereitung

Zur Nutzung des Moduls muss vorhanden sein:

• Eine aktuelle FHEM Installation
• Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)
• Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.
• Seit 15. Juli 2021 auch einen persönlichen API Key (=Client-ID), diesen gibts hier: https://developer.viessmann.com
• Das Modul benötigt mindestens folgende Perl Libraries: Path::Tiny, JSON und DateTime. Diese können mit sudo apt install libtypes-path-tiny-perl libjson-perl libdatetime-perl oder via cpan. Sollten Libraries fehlen erhält man folgende Fehlermeldung "cannot load module vitoconnect". Dann bitte ins Logfile schauen, welche Lib fehlt.

Define des Devices

Dann kann das Gerät angelegt werden: define <name> vitoconnect <user> <password> <interval>

Z.B. : define vitoconnect vitoconnect user@mail.xx geheim 60

User und Passwort sind das gleiche wie in der ViCare App.

Da die Parameter, die beim Definieren des Devices angelegt werden im Klartext in der Detailansicht lesbar sind, kann man beim Definieren einfach ein falsches Passwort eingeben und das richtige später mit einem "set"-Kommando setzen. Also zum Beispiel:

define vitoconnect vitoconnect user@mail.xx fakePassword 60
set vitoconnect password correctPassword 60

Nachträgliches Ändern des Intervalls:
Man kann einfach das DEF aufrufen und dort die Parameter korrigieren (z.B. von 60 Sek. auf 180 Sek.) - dies gilt natürlich ebenso für nachträgliches Ändern des Usernamens oder Passwortes.

Betrieb

Der Zugriff auf die API von Viessmann ist aktuell auf 1450 pro Tag in der gratis Version beschränkt, daraus ergibt sich ein Maximum von ca. einer Abfrage pro Minute. Die Anzahl der Zugriffe ist im Entwicklerportal einsehbar: https://developer.viessmann.com/de/clients/history

Readings

Readings

Die Readings werden so ausgegeben, wie sie von der API geliefert werden! Alle Reading für HK1 sind auch für HK2 und HK3 verfügbar sofern die Heizung solche Readings liefert.

Name	Datentyp/ Wertebereich	Bedeutung
Aktive_Heizkreise	0,1,2	Liste der aktiven Heizkreise. 0 entspricht HK1
Aussen_Status	connected/notConnected	Ist ein Außensensor angeschlossen?
Aussen_StatusWired	connected/notConnected	Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)
Aussen_StatusWireless	connected/notConnected	Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)
Aussentemperatur	2.4	Außentemperatur in °C
Brenner_Betriebsstunden	934.336944444444	Brenner Betriebsstunden
Brenner_Fehlercode	0	Brenner Fehlercode
Brenner_Modulation	11	Brenner Modulation in %
Brenner_Starts	2717	Brenner Starts
Brenner_Status	ok	Brenner Status
Brenner_aktiv	0,1	Brenneraktiv
Controller_Seriennummer	1234567890123456	Controller Seriennummer
Device_Time_Offset	61	???
Fehlereinträge_Historie	ErrorListChanges	??? (noch nicht implementiert)
Fehlereinträge_aktive	ErrorListChanges	??? (noch nicht implementiert)
Gasverbrauch_Heizung/Jahr	3293,0,0	Liste der jährlichen Gasverbräuche Heizung in kWH (aktuelles Jahr und die letzten beiden) (bis zum 09.12.2018 lieferte die API Werte, die noch durch 8 geteilt werden mussten, um auf kWh zu kommen! Außerdem liefert Viessmann für manche Heizungstypen (noch) keine getrennten Werte für Heizung und WW. D.h. in den Reading für WW und Heizung steht der gleiche Wert (vermutlich der Gesamtverbrauch)!
Gasverbrauch_Heizung/Monat	1078,1384,590,241,0,0,0,0,0,0,0,0,0	Liste der monatlichen Gasverbräuche Heizung in kWH
Gasverbrauch_Heizung/Tag	76,104,113,99,76,65,60,70	Liste der täglichen Gasverbräuche Heizung in kWH (aktueller und die letzten 7 Tage)
Gasverbrauch_Heizung/Woche	555,409,416,472,289,196,254,209,24,46, 183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0	Liste der wöchentlichen Gasverbräuche Heizung in kWH
Gasverbrauch_WW/Jahr	235,705,0	Liste der jährlichen Gasverbräuche Warmwasser in kWH
Gasverbrauch_WW/Monat	27,208,213,193,215,84,0,0,0,0,0,0,0	Liste der monatlichen Gasverbräuche Warmwasser in kWH
Gasverbrauch_WW/Tag	2,6,0,0,0,2,9,0	Liste der täglichen Gasverbräuche Warmwasser in kWH
Gasverbrauch_WW/Woche	17,0,37,43,51,50,41,53,52,47,41,52,44,49,41,45,52,47,45,49,51,33,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0	Liste der wöchentlichen Gasverbräuche Warmwasser in kWH
HK1-Betriebsart	standby, dwh, dhwAndHeating, forcedReduced, forcedNormal	Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb
HK1-External_Temperatur	0	Temperatur Raumsensor?
HK1-External_aktiv	0	Raumsensor aktiv?
HK1-Frostschutz_Status	on, off	Frostschutz Status
HK1-Heizkurve-Niveau	0	Heizkurve-Niveau
HK1-Heizkurve-Steigung	1.4	Heizkurve-Steigung
HK1-Programmstatus	standby, reduced, normal, forcedReduced, forcedNormal	Programmstatus
HK1-Raum_Status	error	Raumsensor?
HK1-Raum_Temperatur	20	Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"
HK1-Reduzierte_Temperatur_erzwungen	0,1	xxx
HK1-Solltemperatur_aktiv	0,1	Solltemperatur aktiv
HK1-Solltemperatur_comfort	22	Comfort Solltemeratur
HK1-Solltemperatur_comfort_aktiv	0,1	Comfort aktiv
HK1-Solltemperatur_eco	24	Eco Solltemperatur
HK1-Solltemperatur_eco_aktiv	0,1	Eco aktiv
HK1-Solltemperatur_erzwungen	0,1	Solltemperatur erzwungen
HK1-Solltemperatur_normal	24	Solltemperatur normal
HK1-Solltemperatur_reduziert	16	Solltemperatur reduziert
HK1-Solltemperatur_reduziert_aktiv	0,1	Reduziert aktiv
HK1-Standby_aktiv	0,1	Standby aktiv
HK1-Urlaub_Ende	2019-02-16T00:00:00.000Z	Urlaubsabsenkung Ende
HK1-Urlaub_Start	2019-02-02T23:59:59.000Z	Urlaubsabsenkung Start
HK1-Urlaub_aktiv	0,1	Urlaubsabsenkung aktiv
HK1-Vorlauftemperatur	81	Vorlauftemperatir
HK1-Vorlauftemperatur_aktiv	connected	Vorlauftemperatursensor verbunden
HK1-WW_aktiv	0,1	Modus WW (dhw) aktiv
HK1-WW_und_Heizen_aktiv	0,1	Modus WW und Heizen (dhwAndHeating) aktiv
HK1-Zeitsteuerung_Heizung	wed start:05:00 mode:normal end:08:00 position:0, mode:normal end:23:00 position:1 start:16:00, sat position:0 end:23:00 mode:normal start:06:00, thu position:0 mode:normal end:08:00 start:05:00, start:16:00 end:23:00 mode:normal position:1, sun start:06:00 position:0 end:23:00 mode:normal, mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00, fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00, tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00,	Zeitplan für Heizung
HK1-Zeitsteuerung_Heizung_aktiv	0,1	Zeitplan Heizung aktiv
HK1-Zeitsteuerung_Zirkulation	0,1	Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?
HK1-Zeitsteuerung_Zirkulation_aktiv	0,1	Zirkulationspumpe zeitgesteuert
HK1-Zirkulationspumpe	on,off	Zirkulationspumpe aktiv (neu seit 16.12.18?)
HK1-aktiv	1	HK1 aktiv
Kessel_Common_Supply	error	??? (neu seit 16.12.18?)
Kessel_Status	connected	xxx
Kesseltemperatur	53	xxx
Kesseltemperatur_exact	53	??? (neu seit 16.12.18?)
Mehrfamilienhaus_aktiv	0,1	xxx
Service_Betriebsstunden_seit_letzten	0	(wird seit 16.12.18 nicht mehr geliefert?)
Service_Intervall_Betriebsstunden	0	(wird seit 16.12.18 nicht mehr geliefert?)
Service_Intervall_Monate	0	???
Service_Letzter	1970-01-01T00:00:00.000Z	???
Service_Letzter_brennerbasiert	1970-01-01T00:00:00.000Z	(wird seit 16.12.18 nicht mehr geliefert?)
Service_Monate_aktiv_seit_letzten_Service	0	???
Service_fällig	0,1	Service fällig?
Service_fällig_brennerbasiert		(wird seit 16.12.18 nicht mehr geliefert?)
Stromverbrauch/Jahr	35573,66052,0	Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)
Stromverbrauch/Monat	11860,23713,22851,19264,17924,6013,0,0,0,0,0,0,0	Stromverbrauch im Monat(analog Gasverbrauch) (neu seit 15.02.19?)
Stromverbrauch/Tag	409,828,720,733,731,727,708,682	Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)
Stromverbrauch/Woche	4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236, 4075,4633,4307,3675,3721,4148,4594,1419,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0	Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)
WW-Aufladung	0,1	WW Vorrat wird erhitzt (neu seit 16.12.18?)
WW-Haupttemperatur	54	?? (neu seit 16.12.18?)
WW-Isttemperatur	56	WW Ist-Temperatur
WW-Sensoren_Auslauf_Status	error	??? (neu seit 16.12.18?)
WW-Solltemperatur	53	WW Solltemperatur
WW-Temperatur_aktiv	connected	WW aktiv
WW-Zeitplan	fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30, thu start:06:30 position:0 mode:on end:22:30, tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,	WW Zeitplan
WW-Zirkulationspumpe_Zeitsteuerung_aktiv	0,1	Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)
WW-Zirkulationspumpe_Status	on	Status Zirkulationspumpe(neu seit 16.12.18?)
WW-Zirkulationspumpe_Zeitplan	wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on, sun start:04:30 position:0 mode:on end:22:30, sat start:04:30 position:0 end:22:30 mode:on, thu start:04:30 end:22:30 mode:on position:0, tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,	Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)
WW-Zirkulationspumpe_primaer	off	(neu seit 16.12.18?)
WW-aktiv	0,1	WW aktiv
WW-onTimeCharge_aktiv	0,1	einmaliges WW Aufladen aktiv
WW-zeitgesteuert_aktiv	0,1	WW zeitgesteuert
state	ok, Login failure	Status

Settings

Set Befehle

Benutzung der Set-Befehle auf eigenes Risiko!

Das Modul prüft nicht, ob ein Befehl oder die Parameter für die Heizung sinnvoll und möglich sind. Die API scheint dies mit einem Fehler quittieren.

Befehle für HK1 sind auch für HK2 und HK3 verfügbar.

Name	Datentyp/ Wertebereich	Beschreibung
update		löst ein Update der Reading zwischen manuell aus
clearReadings		clear all readings immeadiatlely
password <passwd>	String	store password in key store
logResponseOnce		dumps the json response of Viessmann server to entities.json, gw.json, actions.json in FHEM log directory
HK1-Heizkurve-Niveau <shift>	-13 bis 40	set shift of heating curve
HK1-Heizkurve-Steigung <slope>	0.2 bis 3.5	set slope of heating curve
HK1-Betriebsart <mode>	standby,dhw,dhwAndHeating,forcedReduced or forcedNormal	set HK1-Betriebsart
HK1-Solltemperatur_comfort_aktiv <activate,deactivate>		activate/deactivate comfort temperature
HK1-Solltemperatur_comfort <targetTemperature>		set comfort target temperatur
HK1-Solltemperatur_eco_aktiv activate,deactivate		activate/deactivate eco temperature
HK1-Urlaub_Start <start>	2019-02-02 (früher war das Format mal 2019-02-02T23:59:59.000Z)	set holiday start time
HK1-Urlaub_Ende <end>	2019-02-16 (früher war das Format mal 2019-02-16T00:00:00.000Z)	set holiday end time (geht nur, wenn schon eine Startzeit gesetzt ist)
HK1-Urlaub_unschedule		remove holiday start and end time
HK1-Solltemperatur_normal <targetTemperature>	3 and 37	sets the normale target temperature
HK1-Solltemperatur_reduziert <targetTemperature>	3 and 37	sets the reduced target temperature
WW-einmaliges_Aufladen activate,deactivate		activate or deactivate one time charge for hot water
WW-Zirkulationspumpe_Zeitplan <schedule>		not implemented
WW-Zeitplan <schedule>		not implemented
WW-Haupttemperatur <targetTemperature>	10 and 60	sets hot water main temperature to targetTemperature
WW-Solltemperatur <targetTemperature>	10 and 60	sets hot water temperature to targetTemperature

Get

Derzeit gibt es keine "get"-Kommandos.

Name	Beschreibung

Attribute

Attribute

Name	Datentyp/ Wertebereich	Default-Wert	Beschreibung
disable	0,1		disable updates
verbose	0,1,2,3,4,5		Loglevel
vitoconnect_raw_readings	0,1		lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an
vitoconnect_actions_active	0,1		erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'

Hilfsmittel

Attribut zum Speichern der wichtigsten Werte mittels DbLog

attr vitoconnect DbLogInclude Gasverbrauch_gestern,Gasverbrauch_Heizung/Jahr,Gasverbrauch_aktuelle_Woche,Gasverbrauch_aktueller_Monat,Gasverbrauch_heute,WW-aktiv,
HK1-Frostschutz_Status,HK1-WW_und_Heizen_aktiv,HK1-WW_aktiv,HK1-Betriebsart,HK1-Programmstatus,Aussentemperatur,HK1-Solltemperatur_normal,Brenner_aktiv,
HK1-Vorlauftemperatur,Kesseltemperatur,WW-Isttemperatur,WW-Solltemperatur

Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen

attr vitoconnect userReadings
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },

Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },

Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }

ReadingsGroup für eine kompakte Darstellung

defmod vitoconnect_rg readingsGroup
vitoconnect:Aussentemperatur
<Brenner>
vitoconnect:Brenner_Betriebsstunden
vitoconnect:Brenner_Fehlercode
vitoconnect:Brenner_Modulation
vitoconnect:Brenner_Starts
vitoconnect:Brenner_Status
vitoconnect:Brenner_aktiv
<HK1>
vitoconnect:HK1-aktiv
vitoconnect:HK1-Betriebsart

vitoconnect:HK1-Frostschutz_Status

vitoconnect:HK1-Heizkurve-Niveau
vitoconnect:HK1-Heizkurve-Steigung

vitoconnect:HK1-Programmstatus
vitoconnect:HK1-Raum_Status
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen
vitoconnect:HK1-Solltemperatur_aktiv
vitoconnect:HK1-Solltemperatur_erzwungen
vitoconnect:HK1-Solltemperatur_normal
vitoconnect:HK1-Solltemperatur_reduziert
vitoconnect:HK1-Solltemperatur_reduziert_aktiv
vitoconnect:HK1-Standby_aktiv

vitoconnect:HK1-Urlaub_Ende
vitoconnect:HK1-Urlaub_Start
vitoconnect:HK1-Urlaub_aktiv

vitoconnect:HK1-Vorlauftemperatur

vitoconnect:HK1-WW_aktiv
vitoconnect:HK1-WW_und_Heizen_aktiv

vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv

vitoconnect:HK1-Zirkulationspumpe
<Kessel>
vitoconnect:Kesseltemperatur
vitoconnect:Kesseltemperatur_exact
<WW>
vitoconnect:WW-Aufladung
vitoconnect:WW-Haupttemperatur
vitoconnect:WW-Isttemperatur
vitoconnect:WW-Solltemperatur
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv
vitoconnect:WW-Zirkulationspumpe_Status
vitoconnect:WW-Zirkulationspumpe_primaer
vitoconnect:WW-aktiv
vitoconnect:WW-onTimeCharge_aktiv
vitoconnect:WW-zeitgesteuert_aktiv

attr vitoconnect_rg alias Heizung
attr vitoconnect_rg cellStyle { 
"c:0"=>'style="text-align:left"', 
"c:1"=>'style="text-align:left"', 
"r:2"=>'style="text-align:right;;;;font-weight:bold"'
}
attr vitoconnect_rg mapping {
"Aussentemperatur" => "Aussentemperatur",

"Brenner_Betriebsstunden" => "Betriebsstunden",
"Brenner_Fehlercode" => "Fehlercode",
"Brenner_Modulation" => "Modulation",
"Brenner_Starts" => "Starts",
"Brenner_Status" => "Status",
"Brenner_aktiv" => "aktiv",

"HK1-aktiv" => "aktiv",
"HK1-Betriebsart" => "Betriebsart",
"HK1-Frostschutz_Status" => "Frostschutz_Status",
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",
"HK1-Programmstatus" => "Programmstatus",
"HK1-Raum_Status" => "Raum Status",
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",
"HK1-Solltemperatur_normal" => "Solltemperatur normal",
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",
"HK1-Standby_aktiv" => "Standby aktiv",
"HK1-Urlaub_Ende" => "Urlaub Ende",
"HK1-Urlaub_Start" => "Urlaub Start",
"HK1-Urlaub_aktiv" => "Urlaub aktiv",
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",
"HK1-WW_aktiv" => "WW aktiv",
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",

"Kesseltemperatur" => "Kesseltemperatur",
"Kesseltemperatur_exact" => "Kesseltemperatur exact",

"WW-Aufladung" => "Aufladung",
"WW-Haupttemperatur" => "Haupttemperatur",
"WW-Isttemperatur" => "Isttemperatur",
"WW-Solltemperatur" => "Solltemperatur",
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",
"WW-aktiv" => "aktiv",
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"
}

attr vitoconnect_rg nostate 1
attr vitoconnect_rg notime 1
attr vitoconnect_rg room Heizung
attr vitoconnect_rg sortby 1
attr vitoconnect_rg valueFormat { "Brenner_Betriebsstunden" => "%2d" }
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', 
'Brenner_aktiv.1' => 'icoHEIZUNG',
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'
}

attr vitoconnect_rg valueSuffix {
Aussentemperatur => "°C", 

Brenner_Betriebsstunden => "h",
Brenner_Modulation => "%",

'HK1-Solltemperatur_normal' => "°C",
'HK1-Solltemperatur_reduziert' => "°C",
'HK1-Vorlauftemperatur' => " °C",

Kesseltemperatur => "°C",
Kesseltemperatur_exact => "°C",

'WW-Solltemperatur' => " °C",
'WW-Isttemperatur' => " °C",

'WW-Solltemperatur' => "°C"
}

ReadingsGroup für eine kompakte Darstellung der Verbräuche

defmod Heizung_Verbrauch readingsGroup <>,<Periode>,<Heizung>,<Wasser>,<Strom>
vitoconnect:,<heute>,Gasverbrauch_heute,Gasverbrauch_WW_heute,Stromverbrauch_heute
vitoconnect:,<gestern>,Gasverbrauch_gestern,Gasverbrauch_WW_gestern,Stromverbrauch_gestern
vitoconnect:,<Woche>,Gasverbrauch_aktuelle_Woche,Gasverbrauch_WW_aktuelle_Woche,Stromverbrauch_aktuelle_Woche
vitoconnect:,<letzte>,Gasverbrauch_letzte_Woche,Gasverbrauch_WW_letzte_Woche,Stromverbrauch_letzte_Woche
vitoconnect:,<Monat>,Gasverbrauch_aktueller_Monat,Gasverbrauch_WW_aktueller_Monat,Stromverbrauch_aktueller_Monat
vitoconnect:,<letzter>,Gasverbrauch_letzter_Monat,Gasverbrauch_WW_letzter_Monat,Stromverbrauch_letzter_Monat
vitoconnect:,<Jahr>,Gasverbrauch_aktuelles_Jahr,Gasverbrauch_WW_aktuelles_Jahr,Stromverbrauch_aktuelles_Jahr
vitoconnect:,<letztes>,Gasverbrauch_letztes_Jahr,Gasverbrauch_WW_letztes_Jahr,Stromverbrauch_letztes_Jahr

attr Heizung_Verbrauch cellStyle { 
"r:1"=>'style="text-align:left;;;;font-weight:bold"',
"c:1"=>'style="text-align:right;;;;font-weight:bold"'
}
attr Heizung_Verbrauch mapping &nbsp;;
attr Heizung_Verbrauch nostate 1
attr Heizung_Verbrauch room Heizung
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"
attr Heizung_Verbrauch valueFormat {
Gasverbrauch_heute				=> "%.0f kWh",
Gasverbrauch_WW_heute			=> "%.0f kWh",
Stromverbrauch_heute			=> "%.0f kWh",
Gasverbrauch_gestern			=> "%.0f kWh",
Gasverbrauch_WW_gestern			=> "%.0f kWh",
Stromverbrauch_gestern			=> "%.0f kWh",
Gasverbrauch_aktuelle_Woche		=> "%.0f kWh",
Gasverbrauch_WW_aktuelle_Woche	=> "%.0f kWh",
Stromverbrauch_aktuelle_Woche	=> "%.0f kWh",
Gasverbrauch_letzte_Woche		=> "%.0f kWh",
Gasverbrauch_WW_letzte_Woche	=> "%.0f kWh",
Stromverbrauch_letzte_Woche		=> "%.0f kWh",
Gasverbrauch_aktueller_Monat	=> "%.0f kWh",
Gasverbrauch_WW_aktueller_Monat	=> "%.0f kWh",
Stromverbrauch_aktueller_Monat	=> "%.0f kWh",
Gasverbrauch_letzter_Monat		=> "%.0f kWh",
Gasverbrauch_WW_letzter_Monat	=> "%.0f kWh",
Stromverbrauch_letzter_Monat	=> "%.0f kWh",
Gasverbrauch_aktuelles_Jahr		=> "%.0f kWh",
Gasverbrauch_WW_aktuelles_Jahr	=> "%.0f kWh",
Stromverbrauch_aktuelles_Jahr	=> "%.0f kWh",
Gasverbrauch_letztes_Jahr		=> "%.0f kWh",
Gasverbrauch_WW_letztes_Jahr	=> "%.0f kWh",
Stromverbrauch_letztes_Jahr		=> "%.0f kWh"
}

SVG Graphen

Gas- und Stromverbrauch

weitere Graphen

Speichern der wichtigsten Werte mittels FileLog und Erzeugung der entspr. SVG Plots

FileLog erstellen

Zunächst wird das FileLog mit ausgewählten Parametern erstellt. Dies ist die Voraussetzung für die SVG Plots.

define FileLog_VitoConnect FileLog ./log/VitoConnect-%Y-%m.log vitoconnect:Aussentemperatur|vitoconnect:Brenner_Modulation|vitoconnect:Brenner_aktiv|vitoconnect:Gasverbrauch_Heizung/Jahr|vitoconnect:Gasverbrauch_aktuelle_Woche|vitoconnect:Gasverbrauch_aktueller_Monat|vitoconnect:Gasverbrauch_gestern|vitoconnect:Gasverbrauch_heute|vitoconnect:HK1-Betriebsart|vitoconnect:HK1-Frostschutz_Status|vitoconnect:HK1-Programmstatus|vitoconnect:HK1-Solltemperatur_aktiv|vitoconnect:HK1-Solltemperatur_normal|vitoconnect:HK1-Solltemperatur_reduziert|vitoconnect:HK1-Solltemperatur_reduziert_aktiv|vitoconnect:HK1-Vorlauftemperatur|vitoconnect:HK1-WW_aktiv|vitoconnect:HK1-WW_und_Heizen_aktiv|vitoconnect:HK1-Zirkulationspumpe|vitoconnect:Kessel_Common_Supply_Temperatur|vitoconnect:Kesseltemperatur_exact|vitoconnect:WW-Isttemperatur|vitoconnect:WW-Sensoren_Auslauf_Wert|vitoconnect:WW-Solltemperatur|vitoconnect:WW-Zirkulationspumpe_Status|vitoconnect:WW-zeitgesteuert_aktiv
attr FileLog_VitoConnect room Log

SVG Graphen aus FileLog erstellen

Nachdem das FileLog erstellt wurde, kann aus dem Log nun der Plot von ausgewählten Werten erstellt werden.

SVG Plot für Heizkreis1

Im folgenden Beispiel werden hier verschiedene Graphen für Heizkreis1 (HK1) genommen.

Einige der Logwerte speichern "on"- oder "off"-Werte, diese müssten beispielsweise mit der Formel

$fld[3]=~"on"?1.5:0

erst in Werte (on=1.5, off=0) gewandelt werden.

SVG Plot mit Plot Editor:


… mit dem entsprechenden Code:

defmod SVG_FileLog_VitoConnect_1 SVG FileLog_VitoConnect:SVG_FileLog_VitoConnect_1:CURRENT
attr SVG_FileLog_VitoConnect_1 room Heizung

setstate SVG_FileLog_VitoConnect_1 initialized

SVG_FileLog_VitoConnect_1.gplot:

# Created by FHEM/98_SVG.pm, 2019-11-04 20:35:38
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title 'HK1 Temps'
set ytics 
set y2tics 
set grid
set ylabel "°C"
set y2label "boolean"
set y2range [0:4]

#FileLog_VitoConnect 4:vitoconnect.Aussentemperatur\x3a::
#FileLog_VitoConnect 4:vitoconnect.HK1-Solltemperatur_normal\x3a::
#FileLog_VitoConnect 4:vitoconnect.HK1-Solltemperatur_reduziert\x3a::
#FileLog_VitoConnect 4:vitoconnect.HK1-Solltemperatur_aktiv\x3a::
#FileLog_VitoConnect 4:vitoconnect.HK1-Solltemperatur_reduziert_aktiv\x3a::
#FileLog_VitoConnect 4:vitoconnect.HK1-Vorlauftemperatur\x3a::
#FileLog_VitoConnect 4:vitoconnect.Kesseltemperatur_exact\x3a::
#FileLog_VitoConnect 4:vitoconnect.HK1-Zirkulationspumpe\x3a::$fld[3]=~"on"?1.5:0

plot "<IN>" using 1:2 axes x1y1 title 'Außentemperatur' ls l7 lw 1 with lines,\
     "<IN>" using 1:2 axes x1y1 title 'Soll normal' ls l0 lw 1 with lines,\
     "<IN>" using 1:2 axes x1y1 title 'Soll reduziert' ls l1 lw 1 with lines,\
     "<IN>" using 1:2 axes x1y2 title 'normal-prg' ls l0fill lw 2 with lines,\
     "<IN>" using 1:2 axes x1y2 title 'reduziert-prg' ls l1fill lw 2 with lines,\
     "<IN>" using 1:2 axes x1y1 title 'Vorlauf' ls l2 lw 1 with lines,\
     "<IN>" using 1:2 axes x1y1 title 'Kesseltemp.' ls l5 lw 1 with lines
     "<IN>" using 1:2 axes x1y2 title 'Zirk.pumpe' ls l8fill lw 2 with lines,\

SVG Plot für Warmwasser

Im folgenden Beispiel werden hier verschiedene Graphen für Warmwasser (WW) genommen.

Einige der Logwerte speichern "on"- oder "off"-Werte, diese müssten beispielsweise mit der Formel

$fld[3]=~"on"?1.5:0

erst in Werte (on=1.5, off=0) gewandelt werden.

SVG Plot mit Plot Editor:


… mit dem entsprechenden Code:

defmod SVG_FileLog_VitoConnect_2 SVG FileLog_VitoConnect:SVG_FileLog_VitoConnect_2:CURRENT
attr SVG_FileLog_VitoConnect_2 room Heizung

setstate SVG_FileLog_VitoConnect_2 initialized

SVG_FileLog_VitoConnect_1.gplot:

# Created by FHEM/98_SVG.pm, 2019-11-04 21:08:37
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title 'WW Temps'
set ytics 
set y2tics 
set grid
set ylabel "°C"
set y2label "boolean"
set y2range [0:4]

#FileLog_VitoConnect 4:vitoconnect.Brenner_aktiv\x3a::
#FileLog_VitoConnect 4:vitoconnect.WW-Solltemperatur\x3a::
#FileLog_VitoConnect 4:vitoconnect.WW-Isttemperatur\x3a::
#FileLog_VitoConnect 4:vitoconnect.WW-Sensoren_Auslauf_Wert\x3a::
#FileLog_VitoConnect 4:vitoconnect.Kesseltemperatur\x3a::
#FileLog_VitoConnect 4:vitoconnect.WW-Zirkulationspumpe_Status\x3a::$fld[3]=~"on"?1.5:0

plot "<IN>" using 1:2 axes x1y2 title 'Brenner' ls l0fill lw 2 with lines,\
     "<IN>" using 1:2 axes x1y1 title 'WW soll' ls l1 lw 1 with lines,\
     "<IN>" using 1:2 axes x1y1 title 'WW ist' ls l2 lw 1 with lines,\
     "<IN>" using 1:2 axes x1y1 title 'WW Auslaufwert' ls l3 lw 1 with lines,\
     "<IN>" using 1:2 axes x1y1 title 'Kesseltemp.' ls l4 lw 1 with lines,\
     "<IN>" using 1:2 axes x1y2 title 'Zirk.pumpe' ls l8fill lw 2 with lines,\

Weblinks

• "Thread zum Modul im Forum"