http://wiki.fhem.de/w/api.php?action=feedcontributions&feedformat=atom&user=Andreas13
FHEMWiki - Benutzerbeiträge [de]
2026-04-10T21:06:10Z
Benutzerbeiträge
MediaWiki 1.43.6
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=31288
Vitoconnect
2019-09-28T20:37:47Z
<p>Andreas13: /* Vorbereitung */</p>
<hr />
<div>{{SEITENTITEL:vitoconnect}} <br />
{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModCmdRef=vitoconnect<br />
|ModType=d<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen. <br />
<br />
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.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann 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!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
=== Vorbereitung ===<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* 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.<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
===Readings ===<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Betriebsstunden|| 934.336944444444 || Brenner Betriebsstunden<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 || Brenner Modulation in %<br />
|-<br />
|Brenner_Starts|| 2717 || Brenner Starts<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||??? (noch nicht implementiert)<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||??? (noch nicht implementiert)<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || 235,705,0 || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || 27,208,213,193,215,84,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || 2,6,0,0,0,2,9,0 ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|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<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Raum_Temperatur || 20 ||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 || Solltemperatur aktiv<br />
|-<br />
|HK1-Solltemperatur_comfort || 22 || Comfort Solltemeratur<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 || Comfort aktiv<br />
|-<br />
|HK1-Solltemperatur_eco || 24 || Eco Solltemperatur<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 || Eco aktiv<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1 || Solltemperatur erzwungen<br />
|-<br />
|HK1-Solltemperatur_normal || 24 || Solltemperatur normal<br />
|-<br />
|HK1-Solltemperatur_reduziert || 16 || Solltemperatur reduziert<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 || Reduziert aktiv<br />
|-<br />
|HK1-Standby_aktiv || 0,1 || Standby aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || 2019-02-16T00:00:00.000Z ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || 2019-02-02T23:59:59.000Z ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 || Vorlauftemperatir<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected || Vorlauftemperatursensor verbunden<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||Modus WW (dhw) aktiv<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 || Modus WW und Heizen (dhwAndHeating) aktiv<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || <br />
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,<br />
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,<br />
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,<br />
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,<br />
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00, <br />
|| Zeitplan für Heizung<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 || Zeitplan Heizung aktiv<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation'' || 0,1 || Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation_aktiv'' || 0,1 || Zirkulationspumpe zeitgesteuert<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || Zirkulationspumpe aktiv (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || 1 ||HK1 aktiv<br />
|-<br />
| || ||<br />
|-<br />
|Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || connected ||xxx<br />
|-<br />
|Kesseltemperatur || 53 ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| 53 ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 || ???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z || ???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || 0 || ???<br />
|-<br />
|Service_fällig || 0,1 || Service fällig?<br />
|-<br />
|''Service_fällig_brennerbasiert'' || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|Stromverbrauch/Jahr|| 35573,66052,0 || Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|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?)<br />
|-<br />
|Stromverbrauch/Tag|| 409,828,720,733,731,727,708,682 || Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|Stromverbrauch/Woche|| 4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,<br />
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 <br />
|| Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| 0,1 || WW Vorrat wird erhitzt (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| 54 || ?? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 || WW Ist-Temperatur<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 || WW Solltemperatur<br />
|-<br />
|WW-Temperatur_aktiv || connected || WW aktiv<br />
|-<br />
|WW-Zeitplan ||<br />
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,<br />
thu start:06:30 position:0 mode:on end:22:30,<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,<br />
|| WW Zeitplan<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || 0,1 || Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| on || Status Zirkulationspumpe(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan ||<br />
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,<br />
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,<br />
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,<br />
|| Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| off || (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 || WW aktiv<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 || einmaliges WW Aufladen aktiv<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 || WW zeitgesteuert<br />
|-<br />
| || ||<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02 (früher war das Format mal 2019-02-02T23:59:59.000Z)|| set holiday start time <br />
|-<br />
|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)<br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<syntaxhighlight lang="Perl">attr vitoconnect DbLogInclude Gasverbrauch_gestern,Gasverbrauch_Heizung/Jahr,Gasverbrauch_aktuelle_Woche,Gasverbrauch_aktueller_Monat,Gasverbrauch_heute,WW-aktiv,<br />
HK1-Frostschutz_Status,HK1-WW_und_Heizen_aktiv,HK1-WW_aktiv,HK1-Betriebsart,HK1-Programmstatus,Aussentemperatur,HK1-Solltemperatur_normal,Brenner_aktiv,<br />
HK1-Vorlauftemperatur,Kesseltemperatur,WW-Isttemperatur,WW-Solltemperatur</syntaxhighlight><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<syntaxhighlight lang="Perl"><br />
attr vitoconnect userReadings<br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },<br />
<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },<br />
<br />
Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },<br />
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },<br />
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },<br />
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },<br />
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },<br />
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },<br />
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },<br />
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }<br />
<br />
</syntaxhighlight><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
defmod vitoconnect_rg readingsGroup<br />
vitoconnect:Aussentemperatur<br />
<Brenner><br />
vitoconnect:Brenner_Betriebsstunden<br />
vitoconnect:Brenner_Fehlercode<br />
vitoconnect:Brenner_Modulation<br />
vitoconnect:Brenner_Starts<br />
vitoconnect:Brenner_Status<br />
vitoconnect:Brenner_aktiv<br />
<HK1><br />
vitoconnect:HK1-aktiv<br />
vitoconnect:HK1-Betriebsart<br />
<br />
vitoconnect:HK1-Frostschutz_Status<br />
<br />
vitoconnect:HK1-Heizkurve-Niveau<br />
vitoconnect:HK1-Heizkurve-Steigung<br />
<br />
vitoconnect:HK1-Programmstatus<br />
vitoconnect:HK1-Raum_Status<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_aktiv<br />
vitoconnect:HK1-Solltemperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_normal<br />
vitoconnect:HK1-Solltemperatur_reduziert<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv<br />
vitoconnect:HK1-Standby_aktiv<br />
<br />
vitoconnect:HK1-Urlaub_Ende<br />
vitoconnect:HK1-Urlaub_Start<br />
vitoconnect:HK1-Urlaub_aktiv<br />
<br />
vitoconnect:HK1-Vorlauftemperatur<br />
<br />
vitoconnect:HK1-WW_aktiv<br />
vitoconnect:HK1-WW_und_Heizen_aktiv<br />
<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv<br />
<br />
vitoconnect:HK1-Zirkulationspumpe<br />
<Kessel><br />
vitoconnect:Kesseltemperatur<br />
vitoconnect:Kesseltemperatur_exact<br />
<WW><br />
vitoconnect:WW-Aufladung<br />
vitoconnect:WW-Haupttemperatur<br />
vitoconnect:WW-Isttemperatur<br />
vitoconnect:WW-Solltemperatur<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv<br />
vitoconnect:WW-Zirkulationspumpe_Status<br />
vitoconnect:WW-Zirkulationspumpe_primaer<br />
vitoconnect:WW-aktiv<br />
vitoconnect:WW-onTimeCharge_aktiv<br />
vitoconnect:WW-zeitgesteuert_aktiv<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
attr vitoconnect_rg alias Heizung<br />
attr vitoconnect_rg cellStyle { <br />
"c:0"=>'style="text-align:left"', <br />
"c:1"=>'style="text-align:right"', <br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'<br />
}<br />
attr vitoconnect_rg mapping {<br />
"Aussentemperatur" => "Aussentemperatur",<br />
<br />
"Brenner_Betriebsstunden" => "Betriebsstunden",<br />
"Brenner_Fehlercode" => "Fehlercode",<br />
"Brenner_Modulation" => "Modulation",<br />
"Brenner_Starts" => "Starts",<br />
"Brenner_Status" => "Status",<br />
"Brenner_aktiv" => "aktiv",<br />
<br />
"HK1-aktiv" => "aktiv",<br />
"HK1-Betriebsart" => "Betriebsart",<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",<br />
"HK1-Programmstatus" => "Programmstatus",<br />
"HK1-Raum_Status" => "Raum Status",<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",<br />
"HK1-Standby_aktiv" => "Standby aktiv",<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",<br />
"HK1-Urlaub_Start" => "Urlaub Start",<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",<br />
"HK1-WW_aktiv" => "WW aktiv",<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",<br />
<br />
"Kesseltemperatur" => "Kesseltemperatur",<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",<br />
<br />
"WW-Aufladung" => "Aufladung",<br />
"WW-Haupttemperatur" => "Haupttemperatur",<br />
"WW-Isttemperatur" => "Isttemperatur",<br />
"WW-Solltemperatur" => "Solltemperatur",<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",<br />
"WW-aktiv" => "aktiv",<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"<br />
}<br />
<br />
attr vitoconnect_rg nostate 1<br />
attr vitoconnect_rg notime 1<br />
attr vitoconnect_rg room Heizung<br />
attr vitoconnect_rg sortby 1<br />
attr vitoconnect_rg valueFormat { "Brenner_Betriebsstunden" => "%2d" }<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', <br />
'Brenner_aktiv.1' => 'icoHEIZUNG',<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'<br />
}<br />
<br />
attr vitoconnect_rg valueSuffix {<br />
Aussentemperatur => "°C", <br />
<br />
Brenner_Betriebsstunden => "h",<br />
Brenner_Modulation => "%",<br />
<br />
'HK1-Solltemperatur_normal' => "°C",<br />
'HK1-Solltemperatur_reduziert' => "°C",<br />
'HK1-Vorlauftemperatur' => " °C",<br />
<br />
Kesseltemperatur => "°C",<br />
Kesseltemperatur_exact => "°C",<br />
<br />
'WW-Solltemperatur' => " °C",<br />
'WW-Isttemperatur' => " °C",<br />
<br />
'WW-Solltemperatur' => "°C"<br />
}<br />
</syntaxhighlight><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]<br />
<br />
=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===<br />
<br />
<syntaxhighlight lang="Perl" style="width:100%;"><br />
defmod Heizung_Verbrauch readingsGroup <>,<Periode>,<Heizung>,<Wasser>,<Strom>\<br />
vitoconnect:,<heute>,Gasverbrauch_heute,Gasverbrauch_WW_heute,Stromverbrauch_heute\<br />
vitoconnect:,<gestern>,Gasverbrauch_gestern,Gasverbrauch_WW_gestern,Stromverbrauch_gestern\<br />
vitoconnect:,<Woche>,Gasverbrauch_aktuelle_Woche,Gasverbrauch_WW_aktuelle_Woche,Stromverbrauch_aktuelle_Woche\<br />
vitoconnect:,<letzte>,Gasverbrauch_letzte_Woche,Gasverbrauch_WW_letzte_Woche,Stromverbrauch_letzte_Woche\<br />
vitoconnect:,<Monat>,Gasverbrauch_aktueller_Monat,Gasverbrauch_WW_aktueller_Monat,Stromverbrauch_aktueller_Monat\<br />
vitoconnect:,<letzter>,Gasverbrauch_letzter_Monat,Gasverbrauch_WW_letzter_Monat,Stromverbrauch_letzter_Monat\<br />
vitoconnect:,<Jahr>,Gasverbrauch_aktuelles_Jahr,Gasverbrauch_WW_aktuelles_Jahr,Stromverbrauch_aktuelles_Jahr\<br />
vitoconnect:,<letztes>,Gasverbrauch_letztes_Jahr,Gasverbrauch_WW_letztes_Jahr,Stromverbrauch_letztes_Jahr\<br />
<br />
attr Heizung_Verbrauch cellStyle { \<br />
"r:1"=>'style="text-align:left;;;;font-weight:bold"',\<br />
"c:1"=>'style="text-align:right;;;;font-weight:bold"'\<br />
}<br />
attr Heizung_Verbrauch mapping &nbsp;;<br />
attr Heizung_Verbrauch nostate 1<br />
attr Heizung_Verbrauch room Heizung<br />
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"<br />
attr Heizung_Verbrauch valueFormat {\<br />
Gasverbrauch_heute => "%.0f kWh",\<br />
Gasverbrauch_WW_heute => "%.0f kWh",\<br />
Stromverbrauch_heute => "%.0f kWh",\<br />
Gasverbrauch_gestern => "%.0f kWh",\<br />
Gasverbrauch_WW_gestern => "%.0f kWh",\<br />
Stromverbrauch_gestern => "%.0f kWh",\<br />
Gasverbrauch_aktuelle_Woche => "%.0f kWh",\<br />
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",\<br />
Stromverbrauch_aktuelle_Woche => "%.0f kWh",\<br />
Gasverbrauch_letzte_Woche => "%.0f kWh",\<br />
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",\<br />
Stromverbrauch_letzte_Woche => "%.0f kWh",\<br />
Gasverbrauch_aktueller_Monat => "%.0f kWh",\<br />
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",\<br />
Stromverbrauch_aktueller_Monat => "%.0f kWh",\<br />
Gasverbrauch_letzter_Monat => "%.0f kWh",\<br />
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",\<br />
Stromverbrauch_letzter_Monat => "%.0f kWh",\<br />
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",\<br />
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",\<br />
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",\<br />
Gasverbrauch_letztes_Jahr => "%.0f kWh",\<br />
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",\<br />
Stromverbrauch_letztes_Jahr => "%.0f kWh"\<br />
}<br />
</syntaxhighlight><br />
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gas- und Stromverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]<br />
[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]<br />
<br />
==== weitere Graphen ====<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=30586
Vitoconnect
2019-06-01T17:31:51Z
<p>Andreas13: /* Set Befehle */</p>
<hr />
<div>{{SEITENTITEL:vitoconnect}} <br />
{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModCmdRef=vitoconnect<br />
|ModType=d<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen. <br />
<br />
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.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann 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!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
=== Vorbereitung ===<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
===Readings ===<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Betriebsstunden|| 934.336944444444 || Brenner Betriebsstunden<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 || Brenner Modulation in %<br />
|-<br />
|Brenner_Starts|| 2717 || Brenner Starts<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||??? (noch nicht implementiert)<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||??? (noch nicht implementiert)<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || 235,705,0 || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || 27,208,213,193,215,84,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || 2,6,0,0,0,2,9,0 ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|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<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Raum_Temperatur || 20 ||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 || Solltemperatur aktiv<br />
|-<br />
|HK1-Solltemperatur_comfort || 22 || Comfort Solltemeratur<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 || Comfort aktiv<br />
|-<br />
|HK1-Solltemperatur_eco || 24 || Eco Solltemperatur<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 || Eco aktiv<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1 || Solltemperatur erzwungen<br />
|-<br />
|HK1-Solltemperatur_normal || 24 || Solltemperatur normal<br />
|-<br />
|HK1-Solltemperatur_reduziert || 16 || Solltemperatur reduziert<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 || Reduziert aktiv<br />
|-<br />
|HK1-Standby_aktiv || 0,1 || Standby aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || 2019-02-16T00:00:00.000Z ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || 2019-02-02T23:59:59.000Z ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 || Vorlauftemperatir<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected || Vorlauftemperatursensor verbunden<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||Modus WW (dhw) aktiv<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 || Modus WW und Heizen (dhwAndHeating) aktiv<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || <br />
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,<br />
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,<br />
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,<br />
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,<br />
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00, <br />
|| Zeitplan für Heizung<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 || Zeitplan Heizung aktiv<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation'' || 0,1 || Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation_aktiv'' || 0,1 || Zirkulationspumpe zeitgesteuert<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || Zirkulationspumpe aktiv (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || 1 ||HK1 aktiv<br />
|-<br />
| || ||<br />
|-<br />
|Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || connected ||xxx<br />
|-<br />
|Kesseltemperatur || 53 ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| 53 ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 || ???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z || ???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || 0 || ???<br />
|-<br />
|Service_fällig || 0,1 || Service fällig?<br />
|-<br />
|''Service_fällig_brennerbasiert'' || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|Stromverbrauch/Jahr|| 35573,66052,0 || Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|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?)<br />
|-<br />
|Stromverbrauch/Tag|| 409,828,720,733,731,727,708,682 || Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|Stromverbrauch/Woche|| 4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,<br />
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 <br />
|| Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| 0,1 || WW Vorrat wird erhitzt (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| 54 || ?? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 || WW Ist-Temperatur<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 || WW Solltemperatur<br />
|-<br />
|WW-Temperatur_aktiv || connected || WW aktiv<br />
|-<br />
|WW-Zeitplan ||<br />
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,<br />
thu start:06:30 position:0 mode:on end:22:30,<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,<br />
|| WW Zeitplan<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || 0,1 || Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| on || Status Zirkulationspumpe(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan ||<br />
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,<br />
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,<br />
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,<br />
|| Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| off || (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 || WW aktiv<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 || einmaliges WW Aufladen aktiv<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 || WW zeitgesteuert<br />
|-<br />
| || ||<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02 (früher war das Format mal 2019-02-02T23:59:59.000Z)|| set holiday start time <br />
|-<br />
|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)<br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<syntaxhighlight lang="Perl">attr vitoconnect DbLogInclude Gasverbrauch_gestern,Gasverbrauch_Heizung/Jahr,Gasverbrauch_aktuelle_Woche,Gasverbrauch_aktueller_Monat,Gasverbrauch_heute,WW-aktiv,<br />
HK1-Frostschutz_Status,HK1-WW_und_Heizen_aktiv,HK1-WW_aktiv,HK1-Betriebsart,HK1-Programmstatus,Aussentemperatur,HK1-Solltemperatur_normal,Brenner_aktiv,<br />
HK1-Vorlauftemperatur,Kesseltemperatur,WW-Isttemperatur,WW-Solltemperatur</syntaxhighlight><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<syntaxhighlight lang="Perl"><br />
attr vitoconnect userReadings<br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },<br />
<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },<br />
<br />
Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },<br />
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },<br />
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },<br />
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },<br />
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },<br />
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },<br />
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },<br />
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }<br />
<br />
</syntaxhighlight><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
defmod vitoconnect_rg readingsGroup<br />
vitoconnect:Aussentemperatur<br />
<Brenner><br />
vitoconnect:Brenner_Betriebsstunden<br />
vitoconnect:Brenner_Fehlercode<br />
vitoconnect:Brenner_Modulation<br />
vitoconnect:Brenner_Starts<br />
vitoconnect:Brenner_Status<br />
vitoconnect:Brenner_aktiv<br />
<HK1><br />
vitoconnect:HK1-aktiv<br />
vitoconnect:HK1-Betriebsart<br />
<br />
vitoconnect:HK1-Frostschutz_Status<br />
<br />
vitoconnect:HK1-Heizkurve-Niveau<br />
vitoconnect:HK1-Heizkurve-Steigung<br />
<br />
vitoconnect:HK1-Programmstatus<br />
vitoconnect:HK1-Raum_Status<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_aktiv<br />
vitoconnect:HK1-Solltemperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_normal<br />
vitoconnect:HK1-Solltemperatur_reduziert<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv<br />
vitoconnect:HK1-Standby_aktiv<br />
<br />
vitoconnect:HK1-Urlaub_Ende<br />
vitoconnect:HK1-Urlaub_Start<br />
vitoconnect:HK1-Urlaub_aktiv<br />
<br />
vitoconnect:HK1-Vorlauftemperatur<br />
<br />
vitoconnect:HK1-WW_aktiv<br />
vitoconnect:HK1-WW_und_Heizen_aktiv<br />
<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv<br />
<br />
vitoconnect:HK1-Zirkulationspumpe<br />
<Kessel><br />
vitoconnect:Kesseltemperatur<br />
vitoconnect:Kesseltemperatur_exact<br />
<WW><br />
vitoconnect:WW-Aufladung<br />
vitoconnect:WW-Haupttemperatur<br />
vitoconnect:WW-Isttemperatur<br />
vitoconnect:WW-Solltemperatur<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv<br />
vitoconnect:WW-Zirkulationspumpe_Status<br />
vitoconnect:WW-Zirkulationspumpe_primaer<br />
vitoconnect:WW-aktiv<br />
vitoconnect:WW-onTimeCharge_aktiv<br />
vitoconnect:WW-zeitgesteuert_aktiv<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
attr vitoconnect_rg alias Heizung<br />
attr vitoconnect_rg cellStyle { <br />
"c:0"=>'style="text-align:left"', <br />
"c:1"=>'style="text-align:right"', <br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'<br />
}<br />
attr vitoconnect_rg mapping {<br />
"Aussentemperatur" => "Aussentemperatur",<br />
<br />
"Brenner_Betriebsstunden" => "Betriebsstunden",<br />
"Brenner_Fehlercode" => "Fehlercode",<br />
"Brenner_Modulation" => "Modulation",<br />
"Brenner_Starts" => "Starts",<br />
"Brenner_Status" => "Status",<br />
"Brenner_aktiv" => "aktiv",<br />
<br />
"HK1-aktiv" => "aktiv",<br />
"HK1-Betriebsart" => "Betriebsart",<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",<br />
"HK1-Programmstatus" => "Programmstatus",<br />
"HK1-Raum_Status" => "Raum Status",<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",<br />
"HK1-Standby_aktiv" => "Standby aktiv",<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",<br />
"HK1-Urlaub_Start" => "Urlaub Start",<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",<br />
"HK1-WW_aktiv" => "WW aktiv",<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",<br />
<br />
"Kesseltemperatur" => "Kesseltemperatur",<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",<br />
<br />
"WW-Aufladung" => "Aufladung",<br />
"WW-Haupttemperatur" => "Haupttemperatur",<br />
"WW-Isttemperatur" => "Isttemperatur",<br />
"WW-Solltemperatur" => "Solltemperatur",<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",<br />
"WW-aktiv" => "aktiv",<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"<br />
}<br />
<br />
attr vitoconnect_rg nostate 1<br />
attr vitoconnect_rg notime 1<br />
attr vitoconnect_rg room Heizung<br />
attr vitoconnect_rg sortby 1<br />
attr vitoconnect_rg valueFormat { "Brenner_Betriebsstunden" => "%2d" }<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', <br />
'Brenner_aktiv.1' => 'icoHEIZUNG',<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'<br />
}<br />
<br />
attr vitoconnect_rg valueSuffix {<br />
Aussentemperatur => "°C", <br />
<br />
Brenner_Betriebsstunden => "h",<br />
Brenner_Modulation => "%",<br />
<br />
'HK1-Solltemperatur_normal' => "°C",<br />
'HK1-Solltemperatur_reduziert' => "°C",<br />
'HK1-Vorlauftemperatur' => " °C",<br />
<br />
Kesseltemperatur => "°C",<br />
Kesseltemperatur_exact => "°C",<br />
<br />
'WW-Solltemperatur' => " °C",<br />
'WW-Isttemperatur' => " °C",<br />
<br />
'WW-Solltemperatur' => "°C"<br />
}<br />
</syntaxhighlight><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]<br />
<br />
=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===<br />
<br />
<syntaxhighlight lang="Perl" style="width:100%;"><br />
defmod Heizung_Verbrauch readingsGroup <>,<Periode>,<Heizung>,<Wasser>,<Strom>\<br />
vitoconnect:,<heute>,Gasverbrauch_heute,Gasverbrauch_WW_heute,Stromverbrauch_heute\<br />
vitoconnect:,<gestern>,Gasverbrauch_gestern,Gasverbrauch_WW_gestern,Stromverbrauch_gestern\<br />
vitoconnect:,<Woche>,Gasverbrauch_aktuelle_Woche,Gasverbrauch_WW_aktuelle_Woche,Stromverbrauch_aktuelle_Woche\<br />
vitoconnect:,<letzte>,Gasverbrauch_letzte_Woche,Gasverbrauch_WW_letzte_Woche,Stromverbrauch_letzte_Woche\<br />
vitoconnect:,<Monat>,Gasverbrauch_aktueller_Monat,Gasverbrauch_WW_aktueller_Monat,Stromverbrauch_aktueller_Monat\<br />
vitoconnect:,<letzter>,Gasverbrauch_letzter_Monat,Gasverbrauch_WW_letzter_Monat,Stromverbrauch_letzter_Monat\<br />
vitoconnect:,<Jahr>,Gasverbrauch_aktuelles_Jahr,Gasverbrauch_WW_aktuelles_Jahr,Stromverbrauch_aktuelles_Jahr\<br />
vitoconnect:,<letztes>,Gasverbrauch_letztes_Jahr,Gasverbrauch_WW_letztes_Jahr,Stromverbrauch_letztes_Jahr\<br />
<br />
attr Heizung_Verbrauch cellStyle { \<br />
"r:1"=>'style="text-align:left;;;;font-weight:bold"',\<br />
"c:1"=>'style="text-align:right;;;;font-weight:bold"'\<br />
}<br />
attr Heizung_Verbrauch mapping &nbsp;;<br />
attr Heizung_Verbrauch nostate 1<br />
attr Heizung_Verbrauch room Heizung<br />
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"<br />
attr Heizung_Verbrauch valueFormat {\<br />
Gasverbrauch_heute => "%.0f kWh",\<br />
Gasverbrauch_WW_heute => "%.0f kWh",\<br />
Stromverbrauch_heute => "%.0f kWh",\<br />
Gasverbrauch_gestern => "%.0f kWh",\<br />
Gasverbrauch_WW_gestern => "%.0f kWh",\<br />
Stromverbrauch_gestern => "%.0f kWh",\<br />
Gasverbrauch_aktuelle_Woche => "%.0f kWh",\<br />
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",\<br />
Stromverbrauch_aktuelle_Woche => "%.0f kWh",\<br />
Gasverbrauch_letzte_Woche => "%.0f kWh",\<br />
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",\<br />
Stromverbrauch_letzte_Woche => "%.0f kWh",\<br />
Gasverbrauch_aktueller_Monat => "%.0f kWh",\<br />
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",\<br />
Stromverbrauch_aktueller_Monat => "%.0f kWh",\<br />
Gasverbrauch_letzter_Monat => "%.0f kWh",\<br />
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",\<br />
Stromverbrauch_letzter_Monat => "%.0f kWh",\<br />
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",\<br />
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",\<br />
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",\<br />
Gasverbrauch_letztes_Jahr => "%.0f kWh",\<br />
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",\<br />
Stromverbrauch_letztes_Jahr => "%.0f kWh"\<br />
}<br />
</syntaxhighlight><br />
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gas- und Stromverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]<br />
[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]<br />
<br />
==== weitere Graphen ====<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29831
Vitoconnect
2019-03-10T16:30:41Z
<p>Andreas13: /* ReadingsGroup für eine kompakte Darstellung der Verbräuche */</p>
<hr />
<div>{{SEITENTITEL:vitoconnect}} <br />
{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=d<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen. <br />
<br />
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.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann 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!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
=== Vorbereitung ===<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
===Readings ===<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Betriebsstunden|| 934.336944444444 || Brenner Betriebsstunden<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 || Brenner Modulation in %<br />
|-<br />
|Brenner_Starts|| 2717 || Brenner Starts<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||??? (noch nicht implementiert)<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||??? (noch nicht implementiert)<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || 235,705,0 || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || 27,208,213,193,215,84,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || 2,6,0,0,0,2,9,0 ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|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<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Raum_Temperatur || 20 ||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 || Solltemperatur aktiv<br />
|-<br />
|HK1-Solltemperatur_comfort || 22 || Comfort Solltemeratur<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 || Comfort aktiv<br />
|-<br />
|HK1-Solltemperatur_eco || 24 || Eco Solltemperatur<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 || Eco aktiv<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1 || Solltemperatur erzwungen<br />
|-<br />
|HK1-Solltemperatur_normal || 24 || Solltemperatur normal<br />
|-<br />
|HK1-Solltemperatur_reduziert || 16 || Solltemperatur reduziert<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 || Reduziert aktiv<br />
|-<br />
|HK1-Standby_aktiv || 0,1 || Standby aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || 2019-02-16T00:00:00.000Z ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || 2019-02-02T23:59:59.000Z ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 || Vorlauftemperatir<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected || Vorlauftemperatursensor verbunden<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||Modus WW (dhw) aktiv<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 || Modus WW und Heizen (dhwAndHeating) aktiv<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || <br />
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,<br />
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,<br />
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,<br />
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,<br />
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00, <br />
|| Zeitplan für Heizung<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 || Zeitplan Heizung aktiv<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation'' || 0,1 || Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation_aktiv'' || 0,1 || Zirkulationspumpe zeitgesteuert<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || Zirkulationspumpe aktiv (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || 1 ||HK1 aktiv<br />
|-<br />
| || ||<br />
|-<br />
|Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || connected ||xxx<br />
|-<br />
|Kesseltemperatur || 53 ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| 53 ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 || ???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z || ???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || 0 || ???<br />
|-<br />
|Service_fällig || 0,1 || Service fällig?<br />
|-<br />
|''Service_fällig_brennerbasiert'' || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|Stromverbrauch/Jahr|| 35573,66052,0 || Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|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?)<br />
|-<br />
|Stromverbrauch/Tag|| 409,828,720,733,731,727,708,682 || Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|Stromverbrauch/Woche|| 4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,<br />
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 <br />
|| Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| 0,1 || WW Vorrat wird erhitzt (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| 54 || ?? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 || WW Ist-Temperatur<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 || WW Solltemperatur<br />
|-<br />
|WW-Temperatur_aktiv || connected || WW aktiv<br />
|-<br />
|WW-Zeitplan ||<br />
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,<br />
thu start:06:30 position:0 mode:on end:22:30,<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,<br />
|| WW Zeitplan<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || 0,1 || Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| on || Status Zirkulationspumpe(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan ||<br />
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,<br />
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,<br />
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,<br />
|| Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| off || (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 || WW aktiv<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 || einmaliges WW Aufladen aktiv<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 || WW zeitgesteuert<br />
|-<br />
| || ||<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<syntaxhighlight>attr vitoconnect DbLogInclude Gasverbrauch_gestern,Gasverbrauch_Heizung/Jahr,Gasverbrauch_aktuelle_Woche,Gasverbrauch_aktueller_Monat,Gasverbrauch_heute,WW-aktiv,<br />
HK1-Frostschutz_Status,HK1-WW_und_Heizen_aktiv,HK1-WW_aktiv,HK1-Betriebsart,HK1-Programmstatus,Aussentemperatur,HK1-Solltemperatur_normal,Brenner_aktiv,<br />
HK1-Vorlauftemperatur,Kesseltemperatur,WW-Isttemperatur,WW-Solltemperatur</syntaxhighlight><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<syntaxhighlight><br />
attr vitoconnect userReadings<br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },<br />
<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },<br />
<br />
Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },<br />
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },<br />
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },<br />
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },<br />
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },<br />
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },<br />
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },<br />
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }<br />
<br />
</syntaxhighlight><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
defmod vitoconnect_rg readingsGroup<br />
vitoconnect:Aussentemperatur<br />
<Brenner><br />
vitoconnect:Brenner_Betriebsstunden<br />
vitoconnect:Brenner_Fehlercode<br />
vitoconnect:Brenner_Modulation<br />
vitoconnect:Brenner_Starts<br />
vitoconnect:Brenner_Status<br />
vitoconnect:Brenner_aktiv<br />
<HK1><br />
vitoconnect:HK1-aktiv<br />
vitoconnect:HK1-Betriebsart<br />
<br />
vitoconnect:HK1-Frostschutz_Status<br />
<br />
vitoconnect:HK1-Heizkurve-Niveau<br />
vitoconnect:HK1-Heizkurve-Steigung<br />
<br />
vitoconnect:HK1-Programmstatus<br />
vitoconnect:HK1-Raum_Status<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_aktiv<br />
vitoconnect:HK1-Solltemperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_normal<br />
vitoconnect:HK1-Solltemperatur_reduziert<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv<br />
vitoconnect:HK1-Standby_aktiv<br />
<br />
vitoconnect:HK1-Urlaub_Ende<br />
vitoconnect:HK1-Urlaub_Start<br />
vitoconnect:HK1-Urlaub_aktiv<br />
<br />
vitoconnect:HK1-Vorlauftemperatur<br />
<br />
vitoconnect:HK1-WW_aktiv<br />
vitoconnect:HK1-WW_und_Heizen_aktiv<br />
<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv<br />
<br />
vitoconnect:HK1-Zirkulationspumpe<br />
<Kessel><br />
vitoconnect:Kesseltemperatur<br />
vitoconnect:Kesseltemperatur_exact<br />
<WW><br />
vitoconnect:WW-Aufladung<br />
vitoconnect:WW-Haupttemperatur<br />
vitoconnect:WW-Isttemperatur<br />
vitoconnect:WW-Solltemperatur<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv<br />
vitoconnect:WW-Zirkulationspumpe_Status<br />
vitoconnect:WW-Zirkulationspumpe_primaer<br />
vitoconnect:WW-aktiv<br />
vitoconnect:WW-onTimeCharge_aktiv<br />
vitoconnect:WW-zeitgesteuert_aktiv<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
attr vitoconnect_rg alias Heizung<br />
attr vitoconnect_rg cellStyle { <br />
"c:0"=>'style="text-align:left"', <br />
"c:1"=>'style="text-align:right"', <br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'<br />
}<br />
attr vitoconnect_rg mapping {<br />
"Aussentemperatur" => "Aussentemperatur",<br />
<br />
"Brenner_Betriebsstunden" => "Betriebsstunden",<br />
"Brenner_Fehlercode" => "Fehlercode",<br />
"Brenner_Modulation" => "Modulation",<br />
"Brenner_Starts" => "Starts",<br />
"Brenner_Status" => "Status",<br />
"Brenner_aktiv" => "aktiv",<br />
<br />
"HK1-aktiv" => "aktiv",<br />
"HK1-Betriebsart" => "Betriebsart",<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",<br />
"HK1-Programmstatus" => "Programmstatus",<br />
"HK1-Raum_Status" => "Raum Status",<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",<br />
"HK1-Standby_aktiv" => "Standby aktiv",<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",<br />
"HK1-Urlaub_Start" => "Urlaub Start",<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",<br />
"HK1-WW_aktiv" => "WW aktiv",<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",<br />
<br />
"Kesseltemperatur" => "Kesseltemperatur",<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",<br />
<br />
"WW-Aufladung" => "Aufladung",<br />
"WW-Haupttemperatur" => "Haupttemperatur",<br />
"WW-Isttemperatur" => "Isttemperatur",<br />
"WW-Solltemperatur" => "Solltemperatur",<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",<br />
"WW-aktiv" => "aktiv",<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"<br />
}<br />
<br />
attr vitoconnect_rg nostate 1<br />
attr vitoconnect_rg notime 1<br />
attr vitoconnect_rg room Heizung<br />
attr vitoconnect_rg sortby 1<br />
attr vitoconnect_rg valueFormat { "Brenner_Betriebsstunden" => "%2d" }<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', <br />
'Brenner_aktiv.1' => 'icoHEIZUNG',<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'<br />
}<br />
<br />
attr vitoconnect_rg valueSuffix {<br />
Aussentemperatur => "°C", <br />
<br />
Brenner_Betriebsstunden => "h",<br />
Brenner_Modulation => "%",<br />
<br />
'HK1-Solltemperatur_normal' => "°C",<br />
'HK1-Solltemperatur_reduziert' => "°C",<br />
'HK1-Vorlauftemperatur' => " °C",<br />
<br />
Kesseltemperatur => "°C",<br />
Kesseltemperatur_exact => "°C",<br />
<br />
'WW-Solltemperatur' => " °C",<br />
'WW-Isttemperatur' => " °C",<br />
<br />
'WW-Solltemperatur' => "°C"<br />
}<br />
</syntaxhighlight><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]<br />
<br />
=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===<br />
<br />
<syntaxhighlight style="width:100%;"><br />
defmod Heizung_Verbrauch readingsGroup <>,<Periode>,<Heizung>,<Wasser>,<Strom>\<br />
vitoconnect:,<heute>,Gasverbrauch_heute,Gasverbrauch_WW_heute,Stromverbrauch_heute\<br />
vitoconnect:,<gestern>,Gasverbrauch_gestern,Gasverbrauch_WW_gestern,Stromverbrauch_gestern\<br />
vitoconnect:,<Woche>,Gasverbrauch_aktuelle_Woche,Gasverbrauch_WW_aktuelle_Woche,Stromverbrauch_aktuelle_Woche\<br />
vitoconnect:,<letzte>,Gasverbrauch_letzte_Woche,Gasverbrauch_WW_letzte_Woche,Stromverbrauch_letzte_Woche\<br />
vitoconnect:,<Monat>,Gasverbrauch_aktueller_Monat,Gasverbrauch_WW_aktueller_Monat,Stromverbrauch_aktueller_Monat\<br />
vitoconnect:,<letzter>,Gasverbrauch_letzter_Monat,Gasverbrauch_WW_letzter_Monat,Stromverbrauch_letzter_Monat\<br />
vitoconnect:,<Jahr>,Gasverbrauch_aktuelles_Jahr,Gasverbrauch_WW_aktuelles_Jahr,Stromverbrauch_aktuelles_Jahr\<br />
vitoconnect:,<letztes>,Gasverbrauch_letztes_Jahr,Gasverbrauch_WW_letztes_Jahr,Stromverbrauch_letztes_Jahr\<br />
<br />
attr Heizung_Verbrauch cellStyle { \<br />
"r:1"=>'style="text-align:left;;;;font-weight:bold"',\<br />
"c:1"=>'style="text-align:right;;;;font-weight:bold"'\<br />
}<br />
attr Heizung_Verbrauch mapping &nbsp;;<br />
attr Heizung_Verbrauch nostate 1<br />
attr Heizung_Verbrauch room Heizung<br />
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"<br />
attr Heizung_Verbrauch valueFormat {\<br />
Gasverbrauch_heute => "%.0f kWh",\<br />
Gasverbrauch_WW_heute => "%.0f kWh",\<br />
Stromverbrauch_heute => "%.0f kWh",\<br />
Gasverbrauch_gestern => "%.0f kWh",\<br />
Gasverbrauch_WW_gestern => "%.0f kWh",\<br />
Stromverbrauch_gestern => "%.0f kWh",\<br />
Gasverbrauch_aktuelle_Woche => "%.0f kWh",\<br />
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",\<br />
Stromverbrauch_aktuelle_Woche => "%.0f kWh",\<br />
Gasverbrauch_letzte_Woche => "%.0f kWh",\<br />
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",\<br />
Stromverbrauch_letzte_Woche => "%.0f kWh",\<br />
Gasverbrauch_aktueller_Monat => "%.0f kWh",\<br />
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",\<br />
Stromverbrauch_aktueller_Monat => "%.0f kWh",\<br />
Gasverbrauch_letzter_Monat => "%.0f kWh",\<br />
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",\<br />
Stromverbrauch_letzter_Monat => "%.0f kWh",\<br />
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",\<br />
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",\<br />
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",\<br />
Gasverbrauch_letztes_Jahr => "%.0f kWh",\<br />
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",\<br />
Stromverbrauch_letztes_Jahr => "%.0f kWh"\<br />
}<br />
</syntaxhighlight><br />
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gas- und Stromverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]<br />
[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]<br />
<br />
==== weitere Graphen ====<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29830
Vitoconnect
2019-03-10T16:29:45Z
<p>Andreas13: </p>
<hr />
<div>{{SEITENTITEL:vitoconnect}} <br />
{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=d<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen. <br />
<br />
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.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann 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!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
=== Vorbereitung ===<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
===Readings ===<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Betriebsstunden|| 934.336944444444 || Brenner Betriebsstunden<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 || Brenner Modulation in %<br />
|-<br />
|Brenner_Starts|| 2717 || Brenner Starts<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||??? (noch nicht implementiert)<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||??? (noch nicht implementiert)<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || 235,705,0 || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || 27,208,213,193,215,84,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || 2,6,0,0,0,2,9,0 ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|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<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Raum_Temperatur || 20 ||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 || Solltemperatur aktiv<br />
|-<br />
|HK1-Solltemperatur_comfort || 22 || Comfort Solltemeratur<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 || Comfort aktiv<br />
|-<br />
|HK1-Solltemperatur_eco || 24 || Eco Solltemperatur<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 || Eco aktiv<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1 || Solltemperatur erzwungen<br />
|-<br />
|HK1-Solltemperatur_normal || 24 || Solltemperatur normal<br />
|-<br />
|HK1-Solltemperatur_reduziert || 16 || Solltemperatur reduziert<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 || Reduziert aktiv<br />
|-<br />
|HK1-Standby_aktiv || 0,1 || Standby aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || 2019-02-16T00:00:00.000Z ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || 2019-02-02T23:59:59.000Z ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 || Vorlauftemperatir<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected || Vorlauftemperatursensor verbunden<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||Modus WW (dhw) aktiv<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 || Modus WW und Heizen (dhwAndHeating) aktiv<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || <br />
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,<br />
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,<br />
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,<br />
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,<br />
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00, <br />
|| Zeitplan für Heizung<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 || Zeitplan Heizung aktiv<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation'' || 0,1 || Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation_aktiv'' || 0,1 || Zirkulationspumpe zeitgesteuert<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || Zirkulationspumpe aktiv (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || 1 ||HK1 aktiv<br />
|-<br />
| || ||<br />
|-<br />
|Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || connected ||xxx<br />
|-<br />
|Kesseltemperatur || 53 ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| 53 ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 || ???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z || ???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || 0 || ???<br />
|-<br />
|Service_fällig || 0,1 || Service fällig?<br />
|-<br />
|''Service_fällig_brennerbasiert'' || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|Stromverbrauch/Jahr|| 35573,66052,0 || Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|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?)<br />
|-<br />
|Stromverbrauch/Tag|| 409,828,720,733,731,727,708,682 || Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|Stromverbrauch/Woche|| 4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,<br />
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 <br />
|| Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| 0,1 || WW Vorrat wird erhitzt (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| 54 || ?? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 || WW Ist-Temperatur<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 || WW Solltemperatur<br />
|-<br />
|WW-Temperatur_aktiv || connected || WW aktiv<br />
|-<br />
|WW-Zeitplan ||<br />
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,<br />
thu start:06:30 position:0 mode:on end:22:30,<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,<br />
|| WW Zeitplan<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || 0,1 || Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| on || Status Zirkulationspumpe(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan ||<br />
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,<br />
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,<br />
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,<br />
|| Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| off || (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 || WW aktiv<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 || einmaliges WW Aufladen aktiv<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 || WW zeitgesteuert<br />
|-<br />
| || ||<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<syntaxhighlight>attr vitoconnect DbLogInclude Gasverbrauch_gestern,Gasverbrauch_Heizung/Jahr,Gasverbrauch_aktuelle_Woche,Gasverbrauch_aktueller_Monat,Gasverbrauch_heute,WW-aktiv,<br />
HK1-Frostschutz_Status,HK1-WW_und_Heizen_aktiv,HK1-WW_aktiv,HK1-Betriebsart,HK1-Programmstatus,Aussentemperatur,HK1-Solltemperatur_normal,Brenner_aktiv,<br />
HK1-Vorlauftemperatur,Kesseltemperatur,WW-Isttemperatur,WW-Solltemperatur</syntaxhighlight><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<syntaxhighlight><br />
attr vitoconnect userReadings<br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },<br />
<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },<br />
<br />
Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },<br />
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },<br />
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },<br />
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },<br />
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },<br />
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },<br />
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },<br />
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }<br />
<br />
</syntaxhighlight><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
defmod vitoconnect_rg readingsGroup<br />
vitoconnect:Aussentemperatur<br />
<Brenner><br />
vitoconnect:Brenner_Betriebsstunden<br />
vitoconnect:Brenner_Fehlercode<br />
vitoconnect:Brenner_Modulation<br />
vitoconnect:Brenner_Starts<br />
vitoconnect:Brenner_Status<br />
vitoconnect:Brenner_aktiv<br />
<HK1><br />
vitoconnect:HK1-aktiv<br />
vitoconnect:HK1-Betriebsart<br />
<br />
vitoconnect:HK1-Frostschutz_Status<br />
<br />
vitoconnect:HK1-Heizkurve-Niveau<br />
vitoconnect:HK1-Heizkurve-Steigung<br />
<br />
vitoconnect:HK1-Programmstatus<br />
vitoconnect:HK1-Raum_Status<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_aktiv<br />
vitoconnect:HK1-Solltemperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_normal<br />
vitoconnect:HK1-Solltemperatur_reduziert<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv<br />
vitoconnect:HK1-Standby_aktiv<br />
<br />
vitoconnect:HK1-Urlaub_Ende<br />
vitoconnect:HK1-Urlaub_Start<br />
vitoconnect:HK1-Urlaub_aktiv<br />
<br />
vitoconnect:HK1-Vorlauftemperatur<br />
<br />
vitoconnect:HK1-WW_aktiv<br />
vitoconnect:HK1-WW_und_Heizen_aktiv<br />
<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv<br />
<br />
vitoconnect:HK1-Zirkulationspumpe<br />
<Kessel><br />
vitoconnect:Kesseltemperatur<br />
vitoconnect:Kesseltemperatur_exact<br />
<WW><br />
vitoconnect:WW-Aufladung<br />
vitoconnect:WW-Haupttemperatur<br />
vitoconnect:WW-Isttemperatur<br />
vitoconnect:WW-Solltemperatur<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv<br />
vitoconnect:WW-Zirkulationspumpe_Status<br />
vitoconnect:WW-Zirkulationspumpe_primaer<br />
vitoconnect:WW-aktiv<br />
vitoconnect:WW-onTimeCharge_aktiv<br />
vitoconnect:WW-zeitgesteuert_aktiv<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
attr vitoconnect_rg alias Heizung<br />
attr vitoconnect_rg cellStyle { <br />
"c:0"=>'style="text-align:left"', <br />
"c:1"=>'style="text-align:right"', <br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'<br />
}<br />
attr vitoconnect_rg mapping {<br />
"Aussentemperatur" => "Aussentemperatur",<br />
<br />
"Brenner_Betriebsstunden" => "Betriebsstunden",<br />
"Brenner_Fehlercode" => "Fehlercode",<br />
"Brenner_Modulation" => "Modulation",<br />
"Brenner_Starts" => "Starts",<br />
"Brenner_Status" => "Status",<br />
"Brenner_aktiv" => "aktiv",<br />
<br />
"HK1-aktiv" => "aktiv",<br />
"HK1-Betriebsart" => "Betriebsart",<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",<br />
"HK1-Programmstatus" => "Programmstatus",<br />
"HK1-Raum_Status" => "Raum Status",<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",<br />
"HK1-Standby_aktiv" => "Standby aktiv",<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",<br />
"HK1-Urlaub_Start" => "Urlaub Start",<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",<br />
"HK1-WW_aktiv" => "WW aktiv",<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",<br />
<br />
"Kesseltemperatur" => "Kesseltemperatur",<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",<br />
<br />
"WW-Aufladung" => "Aufladung",<br />
"WW-Haupttemperatur" => "Haupttemperatur",<br />
"WW-Isttemperatur" => "Isttemperatur",<br />
"WW-Solltemperatur" => "Solltemperatur",<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",<br />
"WW-aktiv" => "aktiv",<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"<br />
}<br />
<br />
attr vitoconnect_rg nostate 1<br />
attr vitoconnect_rg notime 1<br />
attr vitoconnect_rg room Heizung<br />
attr vitoconnect_rg sortby 1<br />
attr vitoconnect_rg valueFormat { "Brenner_Betriebsstunden" => "%2d" }<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', <br />
'Brenner_aktiv.1' => 'icoHEIZUNG',<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'<br />
}<br />
<br />
attr vitoconnect_rg valueSuffix {<br />
Aussentemperatur => "°C", <br />
<br />
Brenner_Betriebsstunden => "h",<br />
Brenner_Modulation => "%",<br />
<br />
'HK1-Solltemperatur_normal' => "°C",<br />
'HK1-Solltemperatur_reduziert' => "°C",<br />
'HK1-Vorlauftemperatur' => " °C",<br />
<br />
Kesseltemperatur => "°C",<br />
Kesseltemperatur_exact => "°C",<br />
<br />
'WW-Solltemperatur' => " °C",<br />
'WW-Isttemperatur' => " °C",<br />
<br />
'WW-Solltemperatur' => "°C"<br />
}<br />
</syntaxhighlight><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]<br />
<br />
=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===<br />
<br />
<syntaxhighlight style="width:50%;"><br />
defmod Heizung_Verbrauch readingsGroup <>,<Periode>,<Heizung>,<Wasser>,<Strom>\<br />
vitoconnect:,<heute>,Gasverbrauch_heute,Gasverbrauch_WW_heute,Stromverbrauch_heute\<br />
vitoconnect:,<gestern>,Gasverbrauch_gestern,Gasverbrauch_WW_gestern,Stromverbrauch_gestern\<br />
vitoconnect:,<Woche>,Gasverbrauch_aktuelle_Woche,Gasverbrauch_WW_aktuelle_Woche,Stromverbrauch_aktuelle_Woche\<br />
vitoconnect:,<letzte>,Gasverbrauch_letzte_Woche,Gasverbrauch_WW_letzte_Woche,Stromverbrauch_letzte_Woche\<br />
vitoconnect:,<Monat>,Gasverbrauch_aktueller_Monat,Gasverbrauch_WW_aktueller_Monat,Stromverbrauch_aktueller_Monat\<br />
vitoconnect:,<letzter>,Gasverbrauch_letzter_Monat,Gasverbrauch_WW_letzter_Monat,Stromverbrauch_letzter_Monat\<br />
vitoconnect:,<Jahr>,Gasverbrauch_aktuelles_Jahr,Gasverbrauch_WW_aktuelles_Jahr,Stromverbrauch_aktuelles_Jahr\<br />
vitoconnect:,<letztes>,Gasverbrauch_letztes_Jahr,Gasverbrauch_WW_letztes_Jahr,Stromverbrauch_letztes_Jahr\<br />
<br />
attr Heizung_Verbrauch cellStyle { \<br />
"r:1"=>'style="text-align:left;;;;font-weight:bold"',\<br />
"c:1"=>'style="text-align:right;;;;font-weight:bold"'\<br />
}<br />
attr Heizung_Verbrauch mapping &nbsp;;<br />
attr Heizung_Verbrauch nostate 1<br />
attr Heizung_Verbrauch room Heizung<br />
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"<br />
attr Heizung_Verbrauch valueFormat {\<br />
Gasverbrauch_heute => "%.0f kWh",\<br />
Gasverbrauch_WW_heute => "%.0f kWh",\<br />
Stromverbrauch_heute => "%.0f kWh",\<br />
Gasverbrauch_gestern => "%.0f kWh",\<br />
Gasverbrauch_WW_gestern => "%.0f kWh",\<br />
Stromverbrauch_gestern => "%.0f kWh",\<br />
Gasverbrauch_aktuelle_Woche => "%.0f kWh",\<br />
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",\<br />
Stromverbrauch_aktuelle_Woche => "%.0f kWh",\<br />
Gasverbrauch_letzte_Woche => "%.0f kWh",\<br />
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",\<br />
Stromverbrauch_letzte_Woche => "%.0f kWh",\<br />
Gasverbrauch_aktueller_Monat => "%.0f kWh",\<br />
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",\<br />
Stromverbrauch_aktueller_Monat => "%.0f kWh",\<br />
Gasverbrauch_letzter_Monat => "%.0f kWh",\<br />
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",\<br />
Stromverbrauch_letzter_Monat => "%.0f kWh",\<br />
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",\<br />
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",\<br />
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",\<br />
Gasverbrauch_letztes_Jahr => "%.0f kWh",\<br />
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",\<br />
Stromverbrauch_letztes_Jahr => "%.0f kWh"\<br />
}<br />
</syntaxhighlight><br />
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gas- und Stromverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]<br />
[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]<br />
<br />
==== weitere Graphen ====<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29606
Vitoconnect
2019-02-20T08:33:24Z
<p>Andreas13: /* SVG Graphen */</p>
<hr />
<div>{{SEITENTITEL:vitoconnect}} <br />
{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=d<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen. <br />
<br />
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.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann 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!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
=== Vorbereitung ===<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
===Readings ===<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Betriebsstunden|| 934.336944444444 || Brenner Betriebsstunden<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 || Brenner Modulation in %<br />
|-<br />
|Brenner_Starts|| 2717 || Brenner Starts<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||??? (noch nicht implementiert)<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||??? (noch nicht implementiert)<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || 235,705,0 || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || 27,208,213,193,215,84,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || 2,6,0,0,0,2,9,0 ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|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<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Raum_Temperatur || 20 ||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 || Solltemperatur aktiv<br />
|-<br />
|HK1-Solltemperatur_comfort || 22 || Comfort Solltemeratur<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 || Comfort aktiv<br />
|-<br />
|HK1-Solltemperatur_eco || 24 || Eco Solltemperatur<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 || Eco aktiv<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1 || Solltemperatur erzwungen<br />
|-<br />
|HK1-Solltemperatur_normal || 24 || Solltemperatur normal<br />
|-<br />
|HK1-Solltemperatur_reduziert || 16 || Solltemperatur reduziert<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 || Reduziert aktiv<br />
|-<br />
|HK1-Standby_aktiv || 0,1 || Standby aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || 2019-02-16T00:00:00.000Z ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || 2019-02-02T23:59:59.000Z ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 || Vorlauftemperatir<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected || Vorlauftemperatursensor verbunden<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||Modus WW (dhw) aktiv<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 || Modus WW und Heizen (dhwAndHeating) aktiv<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || <br />
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,<br />
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,<br />
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,<br />
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,<br />
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00, <br />
|| Zeitplan für Heizung<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 || Zeitplan Heizung aktiv<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation'' || 0,1 || Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation_aktiv'' || 0,1 || Zirkulationspumpe zeitgesteuert<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || Zirkulationspumpe aktiv (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || 1 ||HK1 aktiv<br />
|-<br />
| || ||<br />
|-<br />
|Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || connected ||xxx<br />
|-<br />
|Kesseltemperatur || 53 ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| 53 ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 || ???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z || ???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || 0 || ???<br />
|-<br />
|Service_fällig || 0,1 || Service fällig?<br />
|-<br />
|''Service_fällig_brennerbasiert'' || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|Stromverbrauch/Jahr|| 35573,66052,0 || Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|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?)<br />
|-<br />
|Stromverbrauch/Tag|| 409,828,720,733,731,727,708,682 || Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|Stromverbrauch/Woche|| 4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,<br />
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 <br />
|| Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| 0,1 || WW Vorrat wird erhitzt (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| 54 || ?? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 || WW Ist-Temperatur<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 || WW Solltemperatur<br />
|-<br />
|WW-Temperatur_aktiv || connected || WW aktiv<br />
|-<br />
|WW-Zeitplan ||<br />
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,<br />
thu start:06:30 position:0 mode:on end:22:30,<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,<br />
|| WW Zeitplan<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || 0,1 || Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| on || Status Zirkulationspumpe(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan ||<br />
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,<br />
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,<br />
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,<br />
|| Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| off || (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 || WW aktiv<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 || einmaliges WW Aufladen aktiv<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 || WW zeitgesteuert<br />
|-<br />
| || ||<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<syntaxhighlight>attr vitoconnect DbLogInclude Gasverbrauch_gestern,Gasverbrauch_Heizung/Jahr,Gasverbrauch_aktuelle_Woche,Gasverbrauch_aktueller_Monat,Gasverbrauch_heute,WW-aktiv,<br />
HK1-Frostschutz_Status,HK1-WW_und_Heizen_aktiv,HK1-WW_aktiv,HK1-Betriebsart,HK1-Programmstatus,Aussentemperatur,HK1-Solltemperatur_normal,Brenner_aktiv,<br />
HK1-Vorlauftemperatur,Kesseltemperatur,WW-Isttemperatur,WW-Solltemperatur</syntaxhighlight><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<syntaxhighlight><br />
attr vitoconnect userReadings<br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },<br />
<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },<br />
<br />
Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },<br />
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },<br />
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },<br />
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },<br />
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },<br />
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },<br />
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },<br />
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }<br />
<br />
</syntaxhighlight><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
defmod vitoconnect_rg readingsGroup<br />
vitoconnect:Aussentemperatur<br />
<Brenner><br />
vitoconnect:Brenner_Beriebsstunden<br />
vitoconnect:Brenner_Fehlercode<br />
vitoconnect:Brenner_Modulation<br />
vitoconnect:Brenner_Starts<br />
vitoconnect:Brenner_Status<br />
vitoconnect:Brenner_aktiv<br />
<HK1><br />
vitoconnect:HK1-aktiv<br />
vitoconnect:HK1-Betriebsart<br />
<br />
vitoconnect:HK1-Frostschutz_Status<br />
<br />
vitoconnect:HK1-Heizkurve-Niveau<br />
vitoconnect:HK1-Heizkurve-Steigung<br />
<br />
vitoconnect:K1-Programmstatus<br />
vitoconnect:HK1-Raum_Status<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_aktiv<br />
vitoconnect:HK1-Solltemperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_normal<br />
vitoconnect:HK1-Solltemperatur_reduziert<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv<br />
vitoconnect:HK1-Standby_aktiv<br />
<br />
vitoconnect:HK1-Urlaub_Ende<br />
vitoconnect:HK1-Urlaub_Start<br />
vitoconnect:HK1-Urlaub_aktiv<br />
<br />
vitoconnect:HK1-Vorlauftemperatur<br />
<br />
vitoconnect:HK1-WW_aktiv<br />
vitoconnect:HK1-WW_und_Heizen_aktiv<br />
<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv<br />
<br />
vitoconnect:HK1-Zirkulationspumpe<br />
<Kessel><br />
vitoconnect:Kesseltemperatur<br />
vitoconnect:Kesseltemperatur_exact<br />
<WW><br />
vitoconnect:WW-Aufladung<br />
vitoconnect:WW-Haupttemperatur<br />
vitoconnect:WW-Isttemperatur<br />
vitoconnect:WW-Solltemperatur<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv<br />
vitoconnect:WW-Zirkulationspumpe_Status<br />
vitoconnect:WW-Zirkulationspumpe_primaer<br />
vitoconnect:WW-aktiv<br />
vitoconnect:WW-onTimeCharge_aktiv<br />
vitoconnect:WW-zeitgesteuert_aktiv<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
attr vitoconnect_rg alias Heizung<br />
attr vitoconnect_rg cellStyle { <br />
"c:0"=>'style="text-align:left"', <br />
"c:1"=>'style="text-align:right"', <br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'<br />
}<br />
attr vitoconnect_rg mapping {<br />
"Aussentemperatur" => "Aussentemperatur",<br />
<br />
"Brenner_Beriebsstunden" => "Beriebsstunden",<br />
"Brenner_Fehlercode" => "Fehlercode",<br />
"Brenner_Modulation" => "Modulation",<br />
"Brenner_Starts" => "Starts",<br />
"Brenner_Status" => "Status",<br />
"Brenner_aktiv" => "aktiv",<br />
<br />
"HK1-aktiv" => "aktiv",<br />
"HK1-Betriebsart" => "Betriebsart",<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",<br />
"HK1-Raum_Status" => "Raum Status",<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",<br />
"HK1-Standby_aktiv" => "Standby aktiv",<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",<br />
"HK1-Urlaub_Start" => "Urlaub Start",<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",<br />
"HK1-WW_aktiv" => "WW aktiv",<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",<br />
<br />
"Kesseltemperatur" => "Kesseltemperatur",<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",<br />
<br />
"WW-Aufladung" => "Aufladung",<br />
"WW-Haupttemperatur" => "Haupttemperatur",<br />
"WW-Isttemperatur" => "Isttemperatur",<br />
"WW-Solltemperatur" => "Solltemperatur",<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",<br />
"WW-aktiv" => "aktiv",<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"<br />
}<br />
<br />
attr vitoconnect_rg nostate 1<br />
attr vitoconnect_rg notime 1<br />
attr vitoconnect_rg room Heizung<br />
attr vitoconnect_rg sortby 1<br />
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', <br />
'Brenner_aktiv.1' => 'icoHEIZUNG',<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'<br />
}<br />
<br />
attr vitoconnect_rg valueSuffix {<br />
Aussentemperatur => "°C", <br />
<br />
Brenner_Beriebsstunden => "h",<br />
Brenner_Modulation => "%",<br />
<br />
'HK1-Solltemperatur_normal' => "°C",<br />
'HK1-Solltemperatur_reduziert' => "°C",<br />
'HK1-Vorlauftemperatur' => " °C",<br />
<br />
Kesseltemperatur => "°C",<br />
Kesseltemperatur_exact => "°C",<br />
<br />
'WW-Solltemperatur' => " °C",<br />
'WW-Isttemperatur' => " °C",<br />
<br />
'WW-Solltemperatur' => "°C"<br />
}<br />
</syntaxhighlight><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]<br />
<br />
=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===<br />
<br />
<syntaxhighlight style="width:50%;"><br />
defmod Heizung_Verbrauch readingsGroup <>,<Periode>,<Heizung>,<Wasser>,<Strom>\<br />
vitoconnect:,<heute>,Gasverbrauch_heute,Gasverbrauch_WW_heute,Stromverbrauch_heute\<br />
vitoconnect:,<gestern>,Gasverbrauch_gestern,Gasverbrauch_WW_gestern,Stromverbrauch_gestern\<br />
vitoconnect:,<Woche>,Gasverbrauch_aktuelle_Woche,Gasverbrauch_WW_aktuelle_Woche,Stromverbrauch_aktuelle_Woche\<br />
vitoconnect:,<letzte>,Gasverbrauch_letzte_Woche,Gasverbrauch_WW_letzte_Woche,Stromverbrauch_letzte_Woche\<br />
vitoconnect:,<Monat>,Gasverbrauch_aktueller_Monat,Gasverbrauch_WW_aktueller_Monat,Stromverbrauch_aktueller_Monat\<br />
vitoconnect:,<letzter>,Gasverbrauch_letzter_Monat,Gasverbrauch_WW_letzter_Monat,Stromverbrauch_letzter_Monat\<br />
vitoconnect:,<Jahr>,Gasverbrauch_aktuelles_Jahr,Gasverbrauch_WW_aktuelles_Jahr,Stromverbrauch_aktuelles_Jahr\<br />
vitoconnect:,<letztes>,Gasverbrauch_letztes_Jahr,Gasverbrauch_WW_letztes_Jahr,Stromverbrauch_letztes_Jahr\<br />
<br />
attr Heizung_Verbrauch cellStyle { \<br />
"r:1"=>'style="text-align:left;;;;font-weight:bold"',\<br />
"c:1"=>'style="text-align:right;;;;font-weight:bold"'\<br />
}<br />
attr Heizung_Verbrauch mapping &nbsp;;<br />
attr Heizung_Verbrauch nostate 1<br />
attr Heizung_Verbrauch room Heizung<br />
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"<br />
attr Heizung_Verbrauch valueFormat {\<br />
Gasverbrauch_heute => "%.0f kWh",\<br />
Gasverbrauch_WW_heute => "%.0f kWh",\<br />
Stromverbrauch_heute => "%.0f kWh",\<br />
Gasverbrauch_gestern => "%.0f kWh",\<br />
Gasverbrauch_WW_gestern => "%.0f kWh",\<br />
Stromverbrauch_gestern => "%.0f kWh",\<br />
Gasverbrauch_aktuelle_Woche => "%.0f kWh",\<br />
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",\<br />
Stromverbrauch_aktuelle_Woche => "%.0f kWh",\<br />
Gasverbrauch_letzte_Woche => "%.0f kWh",\<br />
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",\<br />
Stromverbrauch_letzte_Woche => "%.0f kWh",\<br />
Gasverbrauch_aktueller_Monat => "%.0f kWh",\<br />
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",\<br />
Stromverbrauch_aktueller_Monat => "%.0f kWh",\<br />
Gasverbrauch_letzter_Monat => "%.0f kWh",\<br />
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",\<br />
Stromverbrauch_letzter_Monat => "%.0f kWh",\<br />
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",\<br />
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",\<br />
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",\<br />
Gasverbrauch_letztes_Jahr => "%.0f kWh",\<br />
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",\<br />
Stromverbrauch_letztes_Jahr => "%.0f kWh"\<br />
}<br />
</syntaxhighlight><br />
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gas- und Stromverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]<br />
[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]<br />
<br />
==== weitere Graphen ====<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29605
Vitoconnect
2019-02-20T08:29:05Z
<p>Andreas13: /* ReadingsGroup für eine kompakte Darstellung der Verbräuche */</p>
<hr />
<div>{{SEITENTITEL:vitoconnect}} <br />
{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=d<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen. <br />
<br />
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.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann 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!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
=== Vorbereitung ===<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
===Readings ===<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Betriebsstunden|| 934.336944444444 || Brenner Betriebsstunden<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 || Brenner Modulation in %<br />
|-<br />
|Brenner_Starts|| 2717 || Brenner Starts<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||??? (noch nicht implementiert)<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||??? (noch nicht implementiert)<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || 235,705,0 || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || 27,208,213,193,215,84,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || 2,6,0,0,0,2,9,0 ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|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<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Raum_Temperatur || 20 ||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 || Solltemperatur aktiv<br />
|-<br />
|HK1-Solltemperatur_comfort || 22 || Comfort Solltemeratur<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 || Comfort aktiv<br />
|-<br />
|HK1-Solltemperatur_eco || 24 || Eco Solltemperatur<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 || Eco aktiv<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1 || Solltemperatur erzwungen<br />
|-<br />
|HK1-Solltemperatur_normal || 24 || Solltemperatur normal<br />
|-<br />
|HK1-Solltemperatur_reduziert || 16 || Solltemperatur reduziert<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 || Reduziert aktiv<br />
|-<br />
|HK1-Standby_aktiv || 0,1 || Standby aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || 2019-02-16T00:00:00.000Z ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || 2019-02-02T23:59:59.000Z ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 || Vorlauftemperatir<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected || Vorlauftemperatursensor verbunden<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||Modus WW (dhw) aktiv<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 || Modus WW und Heizen (dhwAndHeating) aktiv<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || <br />
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,<br />
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,<br />
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,<br />
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,<br />
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00, <br />
|| Zeitplan für Heizung<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 || Zeitplan Heizung aktiv<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation'' || 0,1 || Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation_aktiv'' || 0,1 || Zirkulationspumpe zeitgesteuert<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || Zirkulationspumpe aktiv (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || 1 ||HK1 aktiv<br />
|-<br />
| || ||<br />
|-<br />
|Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || connected ||xxx<br />
|-<br />
|Kesseltemperatur || 53 ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| 53 ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 || ???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z || ???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || 0 || ???<br />
|-<br />
|Service_fällig || 0,1 || Service fällig?<br />
|-<br />
|''Service_fällig_brennerbasiert'' || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|Stromverbrauch/Jahr|| 35573,66052,0 || Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|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?)<br />
|-<br />
|Stromverbrauch/Tag|| 409,828,720,733,731,727,708,682 || Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|Stromverbrauch/Woche|| 4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,<br />
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 <br />
|| Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| 0,1 || WW Vorrat wird erhitzt (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| 54 || ?? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 || WW Ist-Temperatur<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 || WW Solltemperatur<br />
|-<br />
|WW-Temperatur_aktiv || connected || WW aktiv<br />
|-<br />
|WW-Zeitplan ||<br />
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,<br />
thu start:06:30 position:0 mode:on end:22:30,<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,<br />
|| WW Zeitplan<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || 0,1 || Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| on || Status Zirkulationspumpe(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan ||<br />
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,<br />
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,<br />
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,<br />
|| Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| off || (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 || WW aktiv<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 || einmaliges WW Aufladen aktiv<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 || WW zeitgesteuert<br />
|-<br />
| || ||<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<syntaxhighlight>attr vitoconnect DbLogInclude Gasverbrauch_gestern,Gasverbrauch_Heizung/Jahr,Gasverbrauch_aktuelle_Woche,Gasverbrauch_aktueller_Monat,Gasverbrauch_heute,WW-aktiv,<br />
HK1-Frostschutz_Status,HK1-WW_und_Heizen_aktiv,HK1-WW_aktiv,HK1-Betriebsart,HK1-Programmstatus,Aussentemperatur,HK1-Solltemperatur_normal,Brenner_aktiv,<br />
HK1-Vorlauftemperatur,Kesseltemperatur,WW-Isttemperatur,WW-Solltemperatur</syntaxhighlight><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<syntaxhighlight><br />
attr vitoconnect userReadings<br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },<br />
<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },<br />
<br />
Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },<br />
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },<br />
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },<br />
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },<br />
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },<br />
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },<br />
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },<br />
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }<br />
<br />
</syntaxhighlight><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
defmod vitoconnect_rg readingsGroup<br />
vitoconnect:Aussentemperatur<br />
<Brenner><br />
vitoconnect:Brenner_Beriebsstunden<br />
vitoconnect:Brenner_Fehlercode<br />
vitoconnect:Brenner_Modulation<br />
vitoconnect:Brenner_Starts<br />
vitoconnect:Brenner_Status<br />
vitoconnect:Brenner_aktiv<br />
<HK1><br />
vitoconnect:HK1-aktiv<br />
vitoconnect:HK1-Betriebsart<br />
<br />
vitoconnect:HK1-Frostschutz_Status<br />
<br />
vitoconnect:HK1-Heizkurve-Niveau<br />
vitoconnect:HK1-Heizkurve-Steigung<br />
<br />
vitoconnect:K1-Programmstatus<br />
vitoconnect:HK1-Raum_Status<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_aktiv<br />
vitoconnect:HK1-Solltemperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_normal<br />
vitoconnect:HK1-Solltemperatur_reduziert<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv<br />
vitoconnect:HK1-Standby_aktiv<br />
<br />
vitoconnect:HK1-Urlaub_Ende<br />
vitoconnect:HK1-Urlaub_Start<br />
vitoconnect:HK1-Urlaub_aktiv<br />
<br />
vitoconnect:HK1-Vorlauftemperatur<br />
<br />
vitoconnect:HK1-WW_aktiv<br />
vitoconnect:HK1-WW_und_Heizen_aktiv<br />
<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv<br />
<br />
vitoconnect:HK1-Zirkulationspumpe<br />
<Kessel><br />
vitoconnect:Kesseltemperatur<br />
vitoconnect:Kesseltemperatur_exact<br />
<WW><br />
vitoconnect:WW-Aufladung<br />
vitoconnect:WW-Haupttemperatur<br />
vitoconnect:WW-Isttemperatur<br />
vitoconnect:WW-Solltemperatur<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv<br />
vitoconnect:WW-Zirkulationspumpe_Status<br />
vitoconnect:WW-Zirkulationspumpe_primaer<br />
vitoconnect:WW-aktiv<br />
vitoconnect:WW-onTimeCharge_aktiv<br />
vitoconnect:WW-zeitgesteuert_aktiv<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
attr vitoconnect_rg alias Heizung<br />
attr vitoconnect_rg cellStyle { <br />
"c:0"=>'style="text-align:left"', <br />
"c:1"=>'style="text-align:right"', <br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'<br />
}<br />
attr vitoconnect_rg mapping {<br />
"Aussentemperatur" => "Aussentemperatur",<br />
<br />
"Brenner_Beriebsstunden" => "Beriebsstunden",<br />
"Brenner_Fehlercode" => "Fehlercode",<br />
"Brenner_Modulation" => "Modulation",<br />
"Brenner_Starts" => "Starts",<br />
"Brenner_Status" => "Status",<br />
"Brenner_aktiv" => "aktiv",<br />
<br />
"HK1-aktiv" => "aktiv",<br />
"HK1-Betriebsart" => "Betriebsart",<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",<br />
"HK1-Raum_Status" => "Raum Status",<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",<br />
"HK1-Standby_aktiv" => "Standby aktiv",<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",<br />
"HK1-Urlaub_Start" => "Urlaub Start",<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",<br />
"HK1-WW_aktiv" => "WW aktiv",<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",<br />
<br />
"Kesseltemperatur" => "Kesseltemperatur",<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",<br />
<br />
"WW-Aufladung" => "Aufladung",<br />
"WW-Haupttemperatur" => "Haupttemperatur",<br />
"WW-Isttemperatur" => "Isttemperatur",<br />
"WW-Solltemperatur" => "Solltemperatur",<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",<br />
"WW-aktiv" => "aktiv",<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"<br />
}<br />
<br />
attr vitoconnect_rg nostate 1<br />
attr vitoconnect_rg notime 1<br />
attr vitoconnect_rg room Heizung<br />
attr vitoconnect_rg sortby 1<br />
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', <br />
'Brenner_aktiv.1' => 'icoHEIZUNG',<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'<br />
}<br />
<br />
attr vitoconnect_rg valueSuffix {<br />
Aussentemperatur => "°C", <br />
<br />
Brenner_Beriebsstunden => "h",<br />
Brenner_Modulation => "%",<br />
<br />
'HK1-Solltemperatur_normal' => "°C",<br />
'HK1-Solltemperatur_reduziert' => "°C",<br />
'HK1-Vorlauftemperatur' => " °C",<br />
<br />
Kesseltemperatur => "°C",<br />
Kesseltemperatur_exact => "°C",<br />
<br />
'WW-Solltemperatur' => " °C",<br />
'WW-Isttemperatur' => " °C",<br />
<br />
'WW-Solltemperatur' => "°C"<br />
}<br />
</syntaxhighlight><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]<br />
<br />
=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===<br />
<br />
<syntaxhighlight style="width:50%;"><br />
defmod Heizung_Verbrauch readingsGroup <>,<Periode>,<Heizung>,<Wasser>,<Strom>\<br />
vitoconnect:,<heute>,Gasverbrauch_heute,Gasverbrauch_WW_heute,Stromverbrauch_heute\<br />
vitoconnect:,<gestern>,Gasverbrauch_gestern,Gasverbrauch_WW_gestern,Stromverbrauch_gestern\<br />
vitoconnect:,<Woche>,Gasverbrauch_aktuelle_Woche,Gasverbrauch_WW_aktuelle_Woche,Stromverbrauch_aktuelle_Woche\<br />
vitoconnect:,<letzte>,Gasverbrauch_letzte_Woche,Gasverbrauch_WW_letzte_Woche,Stromverbrauch_letzte_Woche\<br />
vitoconnect:,<Monat>,Gasverbrauch_aktueller_Monat,Gasverbrauch_WW_aktueller_Monat,Stromverbrauch_aktueller_Monat\<br />
vitoconnect:,<letzter>,Gasverbrauch_letzter_Monat,Gasverbrauch_WW_letzter_Monat,Stromverbrauch_letzter_Monat\<br />
vitoconnect:,<Jahr>,Gasverbrauch_aktuelles_Jahr,Gasverbrauch_WW_aktuelles_Jahr,Stromverbrauch_aktuelles_Jahr\<br />
vitoconnect:,<letztes>,Gasverbrauch_letztes_Jahr,Gasverbrauch_WW_letztes_Jahr,Stromverbrauch_letztes_Jahr\<br />
<br />
attr Heizung_Verbrauch cellStyle { \<br />
"r:1"=>'style="text-align:left;;;;font-weight:bold"',\<br />
"c:1"=>'style="text-align:right;;;;font-weight:bold"'\<br />
}<br />
attr Heizung_Verbrauch mapping &nbsp;;<br />
attr Heizung_Verbrauch nostate 1<br />
attr Heizung_Verbrauch room Heizung<br />
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"<br />
attr Heizung_Verbrauch valueFormat {\<br />
Gasverbrauch_heute => "%.0f kWh",\<br />
Gasverbrauch_WW_heute => "%.0f kWh",\<br />
Stromverbrauch_heute => "%.0f kWh",\<br />
Gasverbrauch_gestern => "%.0f kWh",\<br />
Gasverbrauch_WW_gestern => "%.0f kWh",\<br />
Stromverbrauch_gestern => "%.0f kWh",\<br />
Gasverbrauch_aktuelle_Woche => "%.0f kWh",\<br />
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",\<br />
Stromverbrauch_aktuelle_Woche => "%.0f kWh",\<br />
Gasverbrauch_letzte_Woche => "%.0f kWh",\<br />
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",\<br />
Stromverbrauch_letzte_Woche => "%.0f kWh",\<br />
Gasverbrauch_aktueller_Monat => "%.0f kWh",\<br />
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",\<br />
Stromverbrauch_aktueller_Monat => "%.0f kWh",\<br />
Gasverbrauch_letzter_Monat => "%.0f kWh",\<br />
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",\<br />
Stromverbrauch_letzter_Monat => "%.0f kWh",\<br />
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",\<br />
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",\<br />
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",\<br />
Gasverbrauch_letztes_Jahr => "%.0f kWh",\<br />
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",\<br />
Stromverbrauch_letztes_Jahr => "%.0f kWh"\<br />
}<br />
</syntaxhighlight><br />
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gas- und Stromverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
[[Datei:Verbräuche aus Vitoconnect.jpg|400px]]<br />
<br />
==== weitere Graphen ====<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Datei:Readuingsgroup_Verbr%C3%A4uche_aus_Vitoconnect_2.jpg&diff=29604
Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg
2019-02-20T08:28:30Z
<p>Andreas13: </p>
<hr />
<div>Readuingsgroup Verbräuche aus Vitoconnect 2</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29543
Vitoconnect
2019-02-17T16:26:13Z
<p>Andreas13: /* ReadingsGroup für eine kompakte Darstellung */</p>
<hr />
<div>{{SEITENTITEL:vitoconnect}} <br />
{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=d<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen. <br />
<br />
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.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann 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!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
=== Vorbereitung ===<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
===Readings ===<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Betriebsstunden|| 934.336944444444 || Brenner Betriebsstunden<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 || Brenner Modulation in %<br />
|-<br />
|Brenner_Starts|| 2717 || Brenner Starts<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||??? (noch nicht implementiert)<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||??? (noch nicht implementiert)<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || 235,705,0 || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || 27,208,213,193,215,84,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || 2,6,0,0,0,2,9,0 ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|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<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Raum_Temperatur || 20 ||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 || Solltemperatur aktiv<br />
|-<br />
|HK1-Solltemperatur_comfort || 22 || Comfort Solltemeratur<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 || Comfort aktiv<br />
|-<br />
|HK1-Solltemperatur_eco || 24 || Eco Solltemperatur<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 || Eco aktiv<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1 || Solltemperatur erzwungen<br />
|-<br />
|HK1-Solltemperatur_normal || 24 || Solltemperatur normal<br />
|-<br />
|HK1-Solltemperatur_reduziert || 16 || Solltemperatur reduziert<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 || Reduziert aktiv<br />
|-<br />
|HK1-Standby_aktiv || 0,1 || Standby aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || 2019-02-16T00:00:00.000Z ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || 2019-02-02T23:59:59.000Z ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 || Vorlauftemperatir<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected || Vorlauftemperatursensor verbunden<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||Modus WW (dhw) aktiv<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 || Modus WW und Heizen (dhwAndHeating) aktiv<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || <br />
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,<br />
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,<br />
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,<br />
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,<br />
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00, <br />
|| Zeitplan für Heizung<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 || Zeitplan Heizung aktiv<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation'' || 0,1 || Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation_aktiv'' || 0,1 || Zirkulationspumpe zeitgesteuert<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || Zirkulationspumpe aktiv (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || 1 ||HK1 aktiv<br />
|-<br />
| || ||<br />
|-<br />
|Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || connected ||xxx<br />
|-<br />
|Kesseltemperatur || 53 ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| 53 ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 || ???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z || ???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || 0 || ???<br />
|-<br />
|Service_fällig || 0,1 || Service fällig?<br />
|-<br />
|''Service_fällig_brennerbasiert'' || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|Stromverbrauch/Jahr|| 35573,66052,0 || Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|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?)<br />
|-<br />
|Stromverbrauch/Tag|| 409,828,720,733,731,727,708,682 || Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|Stromverbrauch/Woche|| 4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,<br />
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 <br />
|| Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| 0,1 || WW Vorrat wird erhitzt (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| 54 || ?? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 || WW Ist-Temperatur<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 || WW Solltemperatur<br />
|-<br />
|WW-Temperatur_aktiv || connected || WW aktiv<br />
|-<br />
|WW-Zeitplan ||<br />
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,<br />
thu start:06:30 position:0 mode:on end:22:30,<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,<br />
|| WW Zeitplan<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || 0,1 || Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| on || Status Zirkulationspumpe(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan ||<br />
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,<br />
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,<br />
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,<br />
|| Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| off || (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 || WW aktiv<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 || einmaliges WW Aufladen aktiv<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 || WW zeitgesteuert<br />
|-<br />
| || ||<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<syntaxhighlight>attr vitoconnect DbLogInclude Gasverbrauch_gestern,Gasverbrauch_Heizung/Jahr,Gasverbrauch_aktuelle_Woche,Gasverbrauch_aktueller_Monat,Gasverbrauch_heute,WW-aktiv,<br />
HK1-Frostschutz_Status,HK1-WW_und_Heizen_aktiv,HK1-WW_aktiv,HK1-Betriebsart,HK1-Programmstatus,Aussentemperatur,HK1-Solltemperatur_normal,Brenner_aktiv,<br />
HK1-Vorlauftemperatur,Kesseltemperatur,WW-Isttemperatur,WW-Solltemperatur</syntaxhighlight><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<syntaxhighlight><br />
attr vitoconnect userReadings<br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },<br />
<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },<br />
<br />
Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },<br />
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },<br />
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },<br />
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },<br />
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },<br />
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },<br />
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },<br />
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }<br />
<br />
</syntaxhighlight><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
defmod vitoconnect_rg readingsGroup<br />
vitoconnect:Aussentemperatur<br />
<Brenner><br />
vitoconnect:Brenner_Beriebsstunden<br />
vitoconnect:Brenner_Fehlercode<br />
vitoconnect:Brenner_Modulation<br />
vitoconnect:Brenner_Starts<br />
vitoconnect:Brenner_Status<br />
vitoconnect:Brenner_aktiv<br />
<HK1><br />
vitoconnect:HK1-aktiv<br />
vitoconnect:HK1-Betriebsart<br />
<br />
vitoconnect:HK1-Frostschutz_Status<br />
<br />
vitoconnect:HK1-Heizkurve-Niveau<br />
vitoconnect:HK1-Heizkurve-Steigung<br />
<br />
vitoconnect:K1-Programmstatus<br />
vitoconnect:HK1-Raum_Status<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_aktiv<br />
vitoconnect:HK1-Solltemperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_normal<br />
vitoconnect:HK1-Solltemperatur_reduziert<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv<br />
vitoconnect:HK1-Standby_aktiv<br />
<br />
vitoconnect:HK1-Urlaub_Ende<br />
vitoconnect:HK1-Urlaub_Start<br />
vitoconnect:HK1-Urlaub_aktiv<br />
<br />
vitoconnect:HK1-Vorlauftemperatur<br />
<br />
vitoconnect:HK1-WW_aktiv<br />
vitoconnect:HK1-WW_und_Heizen_aktiv<br />
<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv<br />
<br />
vitoconnect:HK1-Zirkulationspumpe<br />
<Kessel><br />
vitoconnect:Kesseltemperatur<br />
vitoconnect:Kesseltemperatur_exact<br />
<WW><br />
vitoconnect:WW-Aufladung<br />
vitoconnect:WW-Haupttemperatur<br />
vitoconnect:WW-Isttemperatur<br />
vitoconnect:WW-Solltemperatur<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv<br />
vitoconnect:WW-Zirkulationspumpe_Status<br />
vitoconnect:WW-Zirkulationspumpe_primaer<br />
vitoconnect:WW-aktiv<br />
vitoconnect:WW-onTimeCharge_aktiv<br />
vitoconnect:WW-zeitgesteuert_aktiv<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
attr vitoconnect_rg alias Heizung<br />
attr vitoconnect_rg cellStyle { <br />
"c:0"=>'style="text-align:left"', <br />
"c:1"=>'style="text-align:right"', <br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'<br />
}<br />
attr vitoconnect_rg mapping {<br />
"Aussentemperatur" => "Aussentemperatur",<br />
<br />
"Brenner_Beriebsstunden" => "Beriebsstunden",<br />
"Brenner_Fehlercode" => "Fehlercode",<br />
"Brenner_Modulation" => "Modulation",<br />
"Brenner_Starts" => "Starts",<br />
"Brenner_Status" => "Status",<br />
"Brenner_aktiv" => "aktiv",<br />
<br />
"HK1-aktiv" => "aktiv",<br />
"HK1-Betriebsart" => "Betriebsart",<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",<br />
"HK1-Raum_Status" => "Raum Status",<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",<br />
"HK1-Standby_aktiv" => "Standby aktiv",<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",<br />
"HK1-Urlaub_Start" => "Urlaub Start",<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",<br />
"HK1-WW_aktiv" => "WW aktiv",<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",<br />
<br />
"Kesseltemperatur" => "Kesseltemperatur",<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",<br />
<br />
"WW-Aufladung" => "Aufladung",<br />
"WW-Haupttemperatur" => "Haupttemperatur",<br />
"WW-Isttemperatur" => "Isttemperatur",<br />
"WW-Solltemperatur" => "Solltemperatur",<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",<br />
"WW-aktiv" => "aktiv",<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"<br />
}<br />
<br />
attr vitoconnect_rg nostate 1<br />
attr vitoconnect_rg notime 1<br />
attr vitoconnect_rg room Heizung<br />
attr vitoconnect_rg sortby 1<br />
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', <br />
'Brenner_aktiv.1' => 'icoHEIZUNG',<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'<br />
}<br />
<br />
attr vitoconnect_rg valueSuffix {<br />
Aussentemperatur => "°C", <br />
<br />
Brenner_Beriebsstunden => "h",<br />
Brenner_Modulation => "%",<br />
<br />
'HK1-Solltemperatur_normal' => "°C",<br />
'HK1-Solltemperatur_reduziert' => "°C",<br />
'HK1-Vorlauftemperatur' => " °C",<br />
<br />
Kesseltemperatur => "°C",<br />
Kesseltemperatur_exact => "°C",<br />
<br />
'WW-Solltemperatur' => " °C",<br />
'WW-Isttemperatur' => " °C",<br />
<br />
'WW-Solltemperatur' => "°C"<br />
}<br />
</syntaxhighlight><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]<br />
<br />
=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===<br />
<br />
<syntaxhighlight style="width:50%;">><br />
defmod Heizung_Verbrauch readingsGroup <Gasverbrauch Heizung>\<br />
vitoconnect:Gasverbrauch_heute, vitoconnect:Gasverbrauch_gestern\<br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_letzte_Woche\<br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_letzter_Monat\<br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_letztes_Jahr\<br />
<Gasverbrauch Warmwasser>\<br />
vitoconnect:Gasverbrauch_WW_heute, vitoconnect:Gasverbrauch_WW_gestern\<br />
vitoconnect:Gasverbrauch_WW_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_WW_letzte_Woche\<br />
vitoconnect:Gasverbrauch_WW_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_WW_letzter_Monat\<br />
vitoconnect:Gasverbrauch_WW_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_WW_letztes_Jahr\<br />
<Stromverbrauch>\<br />
vitoconnect:Stromverbrauch_heute\<br />
vitoconnect:Stromverbrauch_gestern\<br />
vitoconnect:Stromverbrauch_aktuelle_Woche\<br />
vitoconnect:Stromverbrauch_letzte_Woche\<br />
vitoconnect:Stromverbrauch_aktueller_Monat\<br />
vitoconnect:Stromverbrauch_letzter_Monat\<br />
vitoconnect:Stromverbrauch_aktuelles_Jahr\<br />
vitoconnect:Stromverbrauch_letztes_Jahr\<br />
\<br />
\<br />
<br />
attr Heizung_Verbrauch cellStyle { \<br />
"c:0"=>'style="text-align:left"', \<br />
"c:1"=>'style="text-align:left"', \<br />
"r:2"=>'style="text-align:left;;;;font-weight:bold"'\<br />
\<br />
}<br />
attr Heizung_Verbrauch mapping {\<br />
"Gasverbrauch_heute" => "heute",\<br />
"Gasverbrauch_gestern" => "gestern",\<br />
"Gasverbrauch_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_letztes_Jahr" => "letztes Jahr",\<br />
"Gasverbrauch_WW_heute" => "heute",\<br />
"Gasverbrauch_WW_gestern" => "gestern",\<br />
"Gasverbrauch_WW_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_WW_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_WW_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_WW_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_WW_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_WW_letztes_Jahr" => "letztes Jahr",\<br />
\<br />
\<br />
"Stromverbrauch_heute" => "heute",\<br />
"Stromverbrauch_gestern" => "gestern",\<br />
"Stromverbrauch_aktuelle_Woche" => "diese Woche",\<br />
"Stromverbrauch_letzte_Woche" => "letzte Woche",\<br />
"Stromverbrauch_aktueller_Monat" => "dieser Monat",\<br />
"Stromverbrauch_letzter_Monat" => "letzter Monat",\<br />
"Stromverbrauch_aktuelles_Jahr" => "dieses Jahr",\<br />
"Stromverbrauch_letztes_Jahr" => "letztes Jahr"\<br />
}<br />
attr Heizung_Verbrauch nostate 1<br />
attr Heizung_Verbrauch notime 1<br />
attr Heizung_Verbrauch room Heizung<br />
attr Heizung_Verbrauch sortby 1<br />
attr Heizung_Verbrauch valueSuffix {\<br />
Gasverbrauch_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_letztes_Jahr => "kWh",\<br />
Gasverbrauch_aktueller_Monat => "kWh",\<br />
Gasverbrauch_letzter_Monat => "kWh", \<br />
Gasverbrauch_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_letzte_Woche => "kWh",\<br />
Gasverbrauch_heute => "kWh", \<br />
Gasverbrauch_gestern => "kWh", \<br />
\<br />
Gasverbrauch_WW_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_WW_letztes_Jahr => "kWh",\<br />
Gasverbrauch_WW_aktueller_Monat => "kWh",\<br />
Gasverbrauch_WW_letzter_Monat => "kWh",\<br />
Gasverbrauch_WW_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_WW_letzte_Woche => "kWh",\<br />
Gasverbrauch_WW_heute => "kWh", \<br />
Gasverbrauch_WW_gestern => "kWh", \<br />
\<br />
"Stromverbrauch_heute" => "Wh",\<br />
"Stromverbrauch_gestern" => "Wh",\<br />
"Stromverbrauch_aktuelle_Woche" => "Wh",\<br />
"Stromverbrauch_letzte_Woche" => "Wh",\<br />
"Stromverbrauch_aktueller_Monat"=> "Wh",\<br />
"Stromverbrauch_letzter_Monat" => "Wh",\<br />
"Stromverbrauch_aktuelles_Jahr" => "Wh",\<br />
"Stromverbrauch_letztes_Jahr" => "Wh"\<br />
}<br />
</syntaxhighlight><br />
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect.jpg|200px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gas- und Stromverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
[[Datei:Verbräuche aus Vitoconnect.jpg|400px]]<br />
<br />
==== weitere Graphen ====<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Datei:Readuingsgroup_Verbr%C3%A4uche_aus_Vitoconnect.jpg&diff=29542
Datei:Readuingsgroup Verbräuche aus Vitoconnect.jpg
2019-02-17T16:23:57Z
<p>Andreas13: </p>
<hr />
<div>Readuingsgroup Verbräuche aus Vitoconnect</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29541
Vitoconnect
2019-02-17T16:20:15Z
<p>Andreas13: /* Gasverbrauch */</p>
<hr />
<div>{{SEITENTITEL:vitoconnect}} <br />
{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=d<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen. <br />
<br />
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.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann 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!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
=== Vorbereitung ===<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
===Readings ===<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Betriebsstunden|| 934.336944444444 || Brenner Betriebsstunden<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 || Brenner Modulation in %<br />
|-<br />
|Brenner_Starts|| 2717 || Brenner Starts<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||??? (noch nicht implementiert)<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||??? (noch nicht implementiert)<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || 235,705,0 || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || 27,208,213,193,215,84,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || 2,6,0,0,0,2,9,0 ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|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<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Raum_Temperatur || 20 ||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 || Solltemperatur aktiv<br />
|-<br />
|HK1-Solltemperatur_comfort || 22 || Comfort Solltemeratur<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 || Comfort aktiv<br />
|-<br />
|HK1-Solltemperatur_eco || 24 || Eco Solltemperatur<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 || Eco aktiv<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1 || Solltemperatur erzwungen<br />
|-<br />
|HK1-Solltemperatur_normal || 24 || Solltemperatur normal<br />
|-<br />
|HK1-Solltemperatur_reduziert || 16 || Solltemperatur reduziert<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 || Reduziert aktiv<br />
|-<br />
|HK1-Standby_aktiv || 0,1 || Standby aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || 2019-02-16T00:00:00.000Z ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || 2019-02-02T23:59:59.000Z ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 || Vorlauftemperatir<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected || Vorlauftemperatursensor verbunden<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||Modus WW (dhw) aktiv<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 || Modus WW und Heizen (dhwAndHeating) aktiv<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || <br />
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,<br />
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,<br />
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,<br />
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,<br />
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00, <br />
|| Zeitplan für Heizung<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 || Zeitplan Heizung aktiv<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation'' || 0,1 || Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation_aktiv'' || 0,1 || Zirkulationspumpe zeitgesteuert<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || Zirkulationspumpe aktiv (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || 1 ||HK1 aktiv<br />
|-<br />
| || ||<br />
|-<br />
|Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || connected ||xxx<br />
|-<br />
|Kesseltemperatur || 53 ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| 53 ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 || ???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z || ???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || 0 || ???<br />
|-<br />
|Service_fällig || 0,1 || Service fällig?<br />
|-<br />
|''Service_fällig_brennerbasiert'' || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|Stromverbrauch/Jahr|| 35573,66052,0 || Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|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?)<br />
|-<br />
|Stromverbrauch/Tag|| 409,828,720,733,731,727,708,682 || Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|Stromverbrauch/Woche|| 4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,<br />
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 <br />
|| Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| 0,1 || WW Vorrat wird erhitzt (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| 54 || ?? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 || WW Ist-Temperatur<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 || WW Solltemperatur<br />
|-<br />
|WW-Temperatur_aktiv || connected || WW aktiv<br />
|-<br />
|WW-Zeitplan ||<br />
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,<br />
thu start:06:30 position:0 mode:on end:22:30,<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,<br />
|| WW Zeitplan<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || 0,1 || Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| on || Status Zirkulationspumpe(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan ||<br />
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,<br />
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,<br />
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,<br />
|| Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| off || (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 || WW aktiv<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 || einmaliges WW Aufladen aktiv<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 || WW zeitgesteuert<br />
|-<br />
| || ||<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<syntaxhighlight>attr vitoconnect DbLogInclude Gasverbrauch_gestern,Gasverbrauch_Heizung/Jahr,Gasverbrauch_aktuelle_Woche,Gasverbrauch_aktueller_Monat,Gasverbrauch_heute,WW-aktiv,<br />
HK1-Frostschutz_Status,HK1-WW_und_Heizen_aktiv,HK1-WW_aktiv,HK1-Betriebsart,HK1-Programmstatus,Aussentemperatur,HK1-Solltemperatur_normal,Brenner_aktiv,<br />
HK1-Vorlauftemperatur,Kesseltemperatur,WW-Isttemperatur,WW-Solltemperatur</syntaxhighlight><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<syntaxhighlight><br />
attr vitoconnect userReadings<br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },<br />
<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },<br />
<br />
Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },<br />
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },<br />
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },<br />
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },<br />
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },<br />
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },<br />
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },<br />
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }<br />
<br />
</syntaxhighlight><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
defmod vitoconnect_rg readingsGroup<br />
vitoconnect:Aussentemperatur<br />
<Brenner><br />
vitoconnect:Brenner_Beriebsstunden<br />
vitoconnect:Brenner_Fehlercode<br />
vitoconnect:Brenner_Modulation<br />
vitoconnect:Brenner_Starts<br />
vitoconnect:Brenner_Status<br />
vitoconnect:Brenner_aktiv<br />
<HK1><br />
vitoconnect:HK1-aktiv<br />
vitoconnect:HK1-Betriebsart<br />
<br />
vitoconnect:HK1-Frostschutz_Status<br />
<br />
vitoconnect:HK1-Heizkurve-Niveau<br />
vitoconnect:HK1-Heizkurve-Steigung<br />
<br />
vitoconnect:K1-Programmstatus<br />
vitoconnect:HK1-Raum_Status<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_aktiv<br />
vitoconnect:HK1-Solltemperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_normal<br />
vitoconnect:HK1-Solltemperatur_reduziert<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv<br />
vitoconnect:HK1-Standby_aktiv<br />
<br />
vitoconnect:HK1-Urlaub_Ende<br />
vitoconnect:HK1-Urlaub_Start<br />
vitoconnect:HK1-Urlaub_aktiv<br />
<br />
vitoconnect:HK1-Vorlauftemperatur<br />
<br />
vitoconnect:HK1-WW_aktiv<br />
vitoconnect:HK1-WW_und_Heizen_aktiv<br />
<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv<br />
<br />
vitoconnect:HK1-Zirkulationspumpe<br />
<Kessel><br />
vitoconnect:Kesseltemperatur<br />
vitoconnect:Kesseltemperatur_exact<br />
<WW><br />
vitoconnect:WW-Aufladung<br />
vitoconnect:WW-Haupttemperatur<br />
vitoconnect:WW-Isttemperatur<br />
vitoconnect:WW-Solltemperatur<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv<br />
vitoconnect:WW-Zirkulationspumpe_Status<br />
vitoconnect:WW-Zirkulationspumpe_primaer<br />
vitoconnect:WW-aktiv<br />
vitoconnect:WW-onTimeCharge_aktiv<br />
vitoconnect:WW-zeitgesteuert_aktiv<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
attr vitoconnect_rg alias Heizung<br />
attr vitoconnect_rg cellStyle { <br />
"c:0"=>'style="text-align:left"', <br />
"c:1"=>'style="text-align:right"', <br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'<br />
}<br />
attr vitoconnect_rg mapping {<br />
"Aussentemperatur" => "Aussentemperatur",<br />
<br />
"Brenner_Beriebsstunden" => "Beriebsstunden",<br />
"Brenner_Fehlercode" => "Fehlercode",<br />
"Brenner_Modulation" => "Modulation",<br />
"Brenner_Starts" => "Starts",<br />
"Brenner_Status" => "Status",<br />
"Brenner_aktiv" => "aktiv",<br />
<br />
"HK1-aktiv" => "aktiv",<br />
"HK1-Betriebsart" => "Betriebsart",<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",<br />
"HK1-Raum_Status" => "Raum Status",<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",<br />
"HK1-Standby_aktiv" => "Standby aktiv",<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",<br />
"HK1-Urlaub_Start" => "Urlaub Start",<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",<br />
"HK1-WW_aktiv" => "WW aktiv",<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",<br />
<br />
"Kesseltemperatur" => "Kesseltemperatur",<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",<br />
<br />
"WW-Aufladung" => "Aufladung",<br />
"WW-Haupttemperatur" => "Haupttemperatur",<br />
"WW-Isttemperatur" => "Isttemperatur",<br />
"WW-Solltemperatur" => "Solltemperatur",<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",<br />
"WW-aktiv" => "aktiv",<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"<br />
}<br />
<br />
attr vitoconnect_rg nostate 1<br />
attr vitoconnect_rg notime 1<br />
attr vitoconnect_rg room Heizung<br />
attr vitoconnect_rg sortby 1<br />
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', <br />
'Brenner_aktiv.1' => 'icoHEIZUNG',<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'<br />
}<br />
<br />
attr vitoconnect_rg valueSuffix {<br />
Aussentemperatur => "°C", <br />
<br />
Brenner_Beriebsstunden => "h",<br />
Brenner_Modulation => "%",<br />
<br />
'HK1-Solltemperatur_normal' => "°C",<br />
'HK1-Solltemperatur_reduziert' => "°C",<br />
'HK1-Vorlauftemperatur' => " °C",<br />
<br />
Kesseltemperatur => "°C",<br />
Kesseltemperatur_exact => "°C",<br />
<br />
'WW-Solltemperatur' => " °C",<br />
'WW-Isttemperatur' => " °C",<br />
<br />
'WW-Solltemperatur' => "°C"<br />
}<br />
</syntaxhighlight><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gas- und Stromverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
[[Datei:Verbräuche aus Vitoconnect.jpg|400px]]<br />
<br />
==== weitere Graphen ====<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Datei:Verbr%C3%A4uche_aus_Vitoconnect.jpg&diff=29540
Datei:Verbräuche aus Vitoconnect.jpg
2019-02-17T16:19:47Z
<p>Andreas13: </p>
<hr />
<div>Verbräuche aus Vitoconnect</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29539
Vitoconnect
2019-02-17T16:11:46Z
<p>Andreas13: /* Attribut zum Speichern der wichtigsten Werte mittels DbLog */</p>
<hr />
<div>{{SEITENTITEL:vitoconnect}} <br />
{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=d<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen. <br />
<br />
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.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann 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!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
=== Vorbereitung ===<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
===Readings ===<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Betriebsstunden|| 934.336944444444 || Brenner Betriebsstunden<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 || Brenner Modulation in %<br />
|-<br />
|Brenner_Starts|| 2717 || Brenner Starts<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||??? (noch nicht implementiert)<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||??? (noch nicht implementiert)<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || 235,705,0 || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || 27,208,213,193,215,84,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || 2,6,0,0,0,2,9,0 ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|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<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Raum_Temperatur || 20 ||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 || Solltemperatur aktiv<br />
|-<br />
|HK1-Solltemperatur_comfort || 22 || Comfort Solltemeratur<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 || Comfort aktiv<br />
|-<br />
|HK1-Solltemperatur_eco || 24 || Eco Solltemperatur<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 || Eco aktiv<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1 || Solltemperatur erzwungen<br />
|-<br />
|HK1-Solltemperatur_normal || 24 || Solltemperatur normal<br />
|-<br />
|HK1-Solltemperatur_reduziert || 16 || Solltemperatur reduziert<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 || Reduziert aktiv<br />
|-<br />
|HK1-Standby_aktiv || 0,1 || Standby aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || 2019-02-16T00:00:00.000Z ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || 2019-02-02T23:59:59.000Z ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 || Vorlauftemperatir<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected || Vorlauftemperatursensor verbunden<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||Modus WW (dhw) aktiv<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 || Modus WW und Heizen (dhwAndHeating) aktiv<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || <br />
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,<br />
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,<br />
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,<br />
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,<br />
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00, <br />
|| Zeitplan für Heizung<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 || Zeitplan Heizung aktiv<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation'' || 0,1 || Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation_aktiv'' || 0,1 || Zirkulationspumpe zeitgesteuert<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || Zirkulationspumpe aktiv (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || 1 ||HK1 aktiv<br />
|-<br />
| || ||<br />
|-<br />
|Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || connected ||xxx<br />
|-<br />
|Kesseltemperatur || 53 ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| 53 ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 || ???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z || ???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || 0 || ???<br />
|-<br />
|Service_fällig || 0,1 || Service fällig?<br />
|-<br />
|''Service_fällig_brennerbasiert'' || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|Stromverbrauch/Jahr|| 35573,66052,0 || Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|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?)<br />
|-<br />
|Stromverbrauch/Tag|| 409,828,720,733,731,727,708,682 || Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|Stromverbrauch/Woche|| 4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,<br />
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 <br />
|| Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| 0,1 || WW Vorrat wird erhitzt (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| 54 || ?? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 || WW Ist-Temperatur<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 || WW Solltemperatur<br />
|-<br />
|WW-Temperatur_aktiv || connected || WW aktiv<br />
|-<br />
|WW-Zeitplan ||<br />
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,<br />
thu start:06:30 position:0 mode:on end:22:30,<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,<br />
|| WW Zeitplan<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || 0,1 || Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| on || Status Zirkulationspumpe(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan ||<br />
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,<br />
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,<br />
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,<br />
|| Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| off || (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 || WW aktiv<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 || einmaliges WW Aufladen aktiv<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 || WW zeitgesteuert<br />
|-<br />
| || ||<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<syntaxhighlight>attr vitoconnect DbLogInclude Gasverbrauch_gestern,Gasverbrauch_Heizung/Jahr,Gasverbrauch_aktuelle_Woche,Gasverbrauch_aktueller_Monat,Gasverbrauch_heute,WW-aktiv,<br />
HK1-Frostschutz_Status,HK1-WW_und_Heizen_aktiv,HK1-WW_aktiv,HK1-Betriebsart,HK1-Programmstatus,Aussentemperatur,HK1-Solltemperatur_normal,Brenner_aktiv,<br />
HK1-Vorlauftemperatur,Kesseltemperatur,WW-Isttemperatur,WW-Solltemperatur</syntaxhighlight><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<syntaxhighlight><br />
attr vitoconnect userReadings<br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },<br />
<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },<br />
<br />
Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },<br />
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },<br />
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },<br />
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },<br />
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },<br />
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },<br />
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },<br />
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }<br />
<br />
</syntaxhighlight><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
defmod vitoconnect_rg readingsGroup<br />
vitoconnect:Aussentemperatur<br />
<Brenner><br />
vitoconnect:Brenner_Beriebsstunden<br />
vitoconnect:Brenner_Fehlercode<br />
vitoconnect:Brenner_Modulation<br />
vitoconnect:Brenner_Starts<br />
vitoconnect:Brenner_Status<br />
vitoconnect:Brenner_aktiv<br />
<HK1><br />
vitoconnect:HK1-aktiv<br />
vitoconnect:HK1-Betriebsart<br />
<br />
vitoconnect:HK1-Frostschutz_Status<br />
<br />
vitoconnect:HK1-Heizkurve-Niveau<br />
vitoconnect:HK1-Heizkurve-Steigung<br />
<br />
vitoconnect:K1-Programmstatus<br />
vitoconnect:HK1-Raum_Status<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_aktiv<br />
vitoconnect:HK1-Solltemperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_normal<br />
vitoconnect:HK1-Solltemperatur_reduziert<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv<br />
vitoconnect:HK1-Standby_aktiv<br />
<br />
vitoconnect:HK1-Urlaub_Ende<br />
vitoconnect:HK1-Urlaub_Start<br />
vitoconnect:HK1-Urlaub_aktiv<br />
<br />
vitoconnect:HK1-Vorlauftemperatur<br />
<br />
vitoconnect:HK1-WW_aktiv<br />
vitoconnect:HK1-WW_und_Heizen_aktiv<br />
<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv<br />
<br />
vitoconnect:HK1-Zirkulationspumpe<br />
<Kessel><br />
vitoconnect:Kesseltemperatur<br />
vitoconnect:Kesseltemperatur_exact<br />
<WW><br />
vitoconnect:WW-Aufladung<br />
vitoconnect:WW-Haupttemperatur<br />
vitoconnect:WW-Isttemperatur<br />
vitoconnect:WW-Solltemperatur<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv<br />
vitoconnect:WW-Zirkulationspumpe_Status<br />
vitoconnect:WW-Zirkulationspumpe_primaer<br />
vitoconnect:WW-aktiv<br />
vitoconnect:WW-onTimeCharge_aktiv<br />
vitoconnect:WW-zeitgesteuert_aktiv<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
attr vitoconnect_rg alias Heizung<br />
attr vitoconnect_rg cellStyle { <br />
"c:0"=>'style="text-align:left"', <br />
"c:1"=>'style="text-align:right"', <br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'<br />
}<br />
attr vitoconnect_rg mapping {<br />
"Aussentemperatur" => "Aussentemperatur",<br />
<br />
"Brenner_Beriebsstunden" => "Beriebsstunden",<br />
"Brenner_Fehlercode" => "Fehlercode",<br />
"Brenner_Modulation" => "Modulation",<br />
"Brenner_Starts" => "Starts",<br />
"Brenner_Status" => "Status",<br />
"Brenner_aktiv" => "aktiv",<br />
<br />
"HK1-aktiv" => "aktiv",<br />
"HK1-Betriebsart" => "Betriebsart",<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",<br />
"HK1-Raum_Status" => "Raum Status",<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",<br />
"HK1-Standby_aktiv" => "Standby aktiv",<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",<br />
"HK1-Urlaub_Start" => "Urlaub Start",<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",<br />
"HK1-WW_aktiv" => "WW aktiv",<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",<br />
<br />
"Kesseltemperatur" => "Kesseltemperatur",<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",<br />
<br />
"WW-Aufladung" => "Aufladung",<br />
"WW-Haupttemperatur" => "Haupttemperatur",<br />
"WW-Isttemperatur" => "Isttemperatur",<br />
"WW-Solltemperatur" => "Solltemperatur",<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",<br />
"WW-aktiv" => "aktiv",<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"<br />
}<br />
<br />
attr vitoconnect_rg nostate 1<br />
attr vitoconnect_rg notime 1<br />
attr vitoconnect_rg room Heizung<br />
attr vitoconnect_rg sortby 1<br />
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', <br />
'Brenner_aktiv.1' => 'icoHEIZUNG',<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'<br />
}<br />
<br />
attr vitoconnect_rg valueSuffix {<br />
Aussentemperatur => "°C", <br />
<br />
Brenner_Beriebsstunden => "h",<br />
Brenner_Modulation => "%",<br />
<br />
'HK1-Solltemperatur_normal' => "°C",<br />
'HK1-Solltemperatur_reduziert' => "°C",<br />
'HK1-Vorlauftemperatur' => " °C",<br />
<br />
Kesseltemperatur => "°C",<br />
Kesseltemperatur_exact => "°C",<br />
<br />
'WW-Solltemperatur' => " °C",<br />
'WW-Isttemperatur' => " °C",<br />
<br />
'WW-Solltemperatur' => "°C"<br />
}<br />
</syntaxhighlight><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
[[Datei:Gasverbräuche aus vitoconnect.jpg|400px]]<br />
<br />
==== weitere Graphen ====<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29538
Vitoconnect
2019-02-17T16:11:11Z
<p>Andreas13: /* Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen */</p>
<hr />
<div>{{SEITENTITEL:vitoconnect}} <br />
{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=d<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen. <br />
<br />
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.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann 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!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
=== Vorbereitung ===<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
===Readings ===<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Betriebsstunden|| 934.336944444444 || Brenner Betriebsstunden<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 || Brenner Modulation in %<br />
|-<br />
|Brenner_Starts|| 2717 || Brenner Starts<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||??? (noch nicht implementiert)<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||??? (noch nicht implementiert)<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || 235,705,0 || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || 27,208,213,193,215,84,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || 2,6,0,0,0,2,9,0 ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|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<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Raum_Temperatur || 20 ||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 || Solltemperatur aktiv<br />
|-<br />
|HK1-Solltemperatur_comfort || 22 || Comfort Solltemeratur<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 || Comfort aktiv<br />
|-<br />
|HK1-Solltemperatur_eco || 24 || Eco Solltemperatur<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 || Eco aktiv<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1 || Solltemperatur erzwungen<br />
|-<br />
|HK1-Solltemperatur_normal || 24 || Solltemperatur normal<br />
|-<br />
|HK1-Solltemperatur_reduziert || 16 || Solltemperatur reduziert<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 || Reduziert aktiv<br />
|-<br />
|HK1-Standby_aktiv || 0,1 || Standby aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || 2019-02-16T00:00:00.000Z ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || 2019-02-02T23:59:59.000Z ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 || Vorlauftemperatir<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected || Vorlauftemperatursensor verbunden<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||Modus WW (dhw) aktiv<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 || Modus WW und Heizen (dhwAndHeating) aktiv<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || <br />
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,<br />
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,<br />
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,<br />
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,<br />
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00, <br />
|| Zeitplan für Heizung<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 || Zeitplan Heizung aktiv<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation'' || 0,1 || Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation_aktiv'' || 0,1 || Zirkulationspumpe zeitgesteuert<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || Zirkulationspumpe aktiv (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || 1 ||HK1 aktiv<br />
|-<br />
| || ||<br />
|-<br />
|Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || connected ||xxx<br />
|-<br />
|Kesseltemperatur || 53 ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| 53 ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 || ???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z || ???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || 0 || ???<br />
|-<br />
|Service_fällig || 0,1 || Service fällig?<br />
|-<br />
|''Service_fällig_brennerbasiert'' || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|Stromverbrauch/Jahr|| 35573,66052,0 || Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|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?)<br />
|-<br />
|Stromverbrauch/Tag|| 409,828,720,733,731,727,708,682 || Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|Stromverbrauch/Woche|| 4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,<br />
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 <br />
|| Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| 0,1 || WW Vorrat wird erhitzt (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| 54 || ?? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 || WW Ist-Temperatur<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 || WW Solltemperatur<br />
|-<br />
|WW-Temperatur_aktiv || connected || WW aktiv<br />
|-<br />
|WW-Zeitplan ||<br />
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,<br />
thu start:06:30 position:0 mode:on end:22:30,<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,<br />
|| WW Zeitplan<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || 0,1 || Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| on || Status Zirkulationspumpe(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan ||<br />
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,<br />
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,<br />
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,<br />
|| Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| off || (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 || WW aktiv<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 || einmaliges WW Aufladen aktiv<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 || WW zeitgesteuert<br />
|-<br />
| || ||<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<syntaxhighlight><br />
attr vitoconnect userReadings<br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },<br />
<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },<br />
<br />
Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },<br />
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },<br />
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },<br />
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },<br />
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },<br />
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },<br />
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },<br />
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }<br />
<br />
</syntaxhighlight><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
defmod vitoconnect_rg readingsGroup<br />
vitoconnect:Aussentemperatur<br />
<Brenner><br />
vitoconnect:Brenner_Beriebsstunden<br />
vitoconnect:Brenner_Fehlercode<br />
vitoconnect:Brenner_Modulation<br />
vitoconnect:Brenner_Starts<br />
vitoconnect:Brenner_Status<br />
vitoconnect:Brenner_aktiv<br />
<HK1><br />
vitoconnect:HK1-aktiv<br />
vitoconnect:HK1-Betriebsart<br />
<br />
vitoconnect:HK1-Frostschutz_Status<br />
<br />
vitoconnect:HK1-Heizkurve-Niveau<br />
vitoconnect:HK1-Heizkurve-Steigung<br />
<br />
vitoconnect:K1-Programmstatus<br />
vitoconnect:HK1-Raum_Status<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_aktiv<br />
vitoconnect:HK1-Solltemperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_normal<br />
vitoconnect:HK1-Solltemperatur_reduziert<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv<br />
vitoconnect:HK1-Standby_aktiv<br />
<br />
vitoconnect:HK1-Urlaub_Ende<br />
vitoconnect:HK1-Urlaub_Start<br />
vitoconnect:HK1-Urlaub_aktiv<br />
<br />
vitoconnect:HK1-Vorlauftemperatur<br />
<br />
vitoconnect:HK1-WW_aktiv<br />
vitoconnect:HK1-WW_und_Heizen_aktiv<br />
<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv<br />
<br />
vitoconnect:HK1-Zirkulationspumpe<br />
<Kessel><br />
vitoconnect:Kesseltemperatur<br />
vitoconnect:Kesseltemperatur_exact<br />
<WW><br />
vitoconnect:WW-Aufladung<br />
vitoconnect:WW-Haupttemperatur<br />
vitoconnect:WW-Isttemperatur<br />
vitoconnect:WW-Solltemperatur<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv<br />
vitoconnect:WW-Zirkulationspumpe_Status<br />
vitoconnect:WW-Zirkulationspumpe_primaer<br />
vitoconnect:WW-aktiv<br />
vitoconnect:WW-onTimeCharge_aktiv<br />
vitoconnect:WW-zeitgesteuert_aktiv<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
attr vitoconnect_rg alias Heizung<br />
attr vitoconnect_rg cellStyle { <br />
"c:0"=>'style="text-align:left"', <br />
"c:1"=>'style="text-align:right"', <br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'<br />
}<br />
attr vitoconnect_rg mapping {<br />
"Aussentemperatur" => "Aussentemperatur",<br />
<br />
"Brenner_Beriebsstunden" => "Beriebsstunden",<br />
"Brenner_Fehlercode" => "Fehlercode",<br />
"Brenner_Modulation" => "Modulation",<br />
"Brenner_Starts" => "Starts",<br />
"Brenner_Status" => "Status",<br />
"Brenner_aktiv" => "aktiv",<br />
<br />
"HK1-aktiv" => "aktiv",<br />
"HK1-Betriebsart" => "Betriebsart",<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",<br />
"HK1-Raum_Status" => "Raum Status",<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",<br />
"HK1-Standby_aktiv" => "Standby aktiv",<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",<br />
"HK1-Urlaub_Start" => "Urlaub Start",<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",<br />
"HK1-WW_aktiv" => "WW aktiv",<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",<br />
<br />
"Kesseltemperatur" => "Kesseltemperatur",<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",<br />
<br />
"WW-Aufladung" => "Aufladung",<br />
"WW-Haupttemperatur" => "Haupttemperatur",<br />
"WW-Isttemperatur" => "Isttemperatur",<br />
"WW-Solltemperatur" => "Solltemperatur",<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",<br />
"WW-aktiv" => "aktiv",<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"<br />
}<br />
<br />
attr vitoconnect_rg nostate 1<br />
attr vitoconnect_rg notime 1<br />
attr vitoconnect_rg room Heizung<br />
attr vitoconnect_rg sortby 1<br />
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', <br />
'Brenner_aktiv.1' => 'icoHEIZUNG',<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'<br />
}<br />
<br />
attr vitoconnect_rg valueSuffix {<br />
Aussentemperatur => "°C", <br />
<br />
Brenner_Beriebsstunden => "h",<br />
Brenner_Modulation => "%",<br />
<br />
'HK1-Solltemperatur_normal' => "°C",<br />
'HK1-Solltemperatur_reduziert' => "°C",<br />
'HK1-Vorlauftemperatur' => " °C",<br />
<br />
Kesseltemperatur => "°C",<br />
Kesseltemperatur_exact => "°C",<br />
<br />
'WW-Solltemperatur' => " °C",<br />
'WW-Isttemperatur' => " °C",<br />
<br />
'WW-Solltemperatur' => "°C"<br />
}<br />
</syntaxhighlight><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
[[Datei:Gasverbräuche aus vitoconnect.jpg|400px]]<br />
<br />
==== weitere Graphen ====<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29537
Vitoconnect
2019-02-17T16:08:34Z
<p>Andreas13: /* ReadingsGroup für eine kompakte Darstellung */</p>
<hr />
<div>{{SEITENTITEL:vitoconnect}} <br />
{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=d<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen. <br />
<br />
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.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann 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!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
=== Vorbereitung ===<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
===Readings ===<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Betriebsstunden|| 934.336944444444 || Brenner Betriebsstunden<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 || Brenner Modulation in %<br />
|-<br />
|Brenner_Starts|| 2717 || Brenner Starts<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||??? (noch nicht implementiert)<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||??? (noch nicht implementiert)<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || 235,705,0 || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || 27,208,213,193,215,84,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || 2,6,0,0,0,2,9,0 ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|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<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Raum_Temperatur || 20 ||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 || Solltemperatur aktiv<br />
|-<br />
|HK1-Solltemperatur_comfort || 22 || Comfort Solltemeratur<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 || Comfort aktiv<br />
|-<br />
|HK1-Solltemperatur_eco || 24 || Eco Solltemperatur<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 || Eco aktiv<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1 || Solltemperatur erzwungen<br />
|-<br />
|HK1-Solltemperatur_normal || 24 || Solltemperatur normal<br />
|-<br />
|HK1-Solltemperatur_reduziert || 16 || Solltemperatur reduziert<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 || Reduziert aktiv<br />
|-<br />
|HK1-Standby_aktiv || 0,1 || Standby aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || 2019-02-16T00:00:00.000Z ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || 2019-02-02T23:59:59.000Z ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 || Vorlauftemperatir<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected || Vorlauftemperatursensor verbunden<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||Modus WW (dhw) aktiv<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 || Modus WW und Heizen (dhwAndHeating) aktiv<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || <br />
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,<br />
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,<br />
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,<br />
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,<br />
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00, <br />
|| Zeitplan für Heizung<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 || Zeitplan Heizung aktiv<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation'' || 0,1 || Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation_aktiv'' || 0,1 || Zirkulationspumpe zeitgesteuert<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || Zirkulationspumpe aktiv (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || 1 ||HK1 aktiv<br />
|-<br />
| || ||<br />
|-<br />
|Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || connected ||xxx<br />
|-<br />
|Kesseltemperatur || 53 ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| 53 ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 || ???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z || ???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || 0 || ???<br />
|-<br />
|Service_fällig || 0,1 || Service fällig?<br />
|-<br />
|''Service_fällig_brennerbasiert'' || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|Stromverbrauch/Jahr|| 35573,66052,0 || Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|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?)<br />
|-<br />
|Stromverbrauch/Tag|| 409,828,720,733,731,727,708,682 || Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|Stromverbrauch/Woche|| 4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,<br />
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 <br />
|| Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| 0,1 || WW Vorrat wird erhitzt (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| 54 || ?? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 || WW Ist-Temperatur<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 || WW Solltemperatur<br />
|-<br />
|WW-Temperatur_aktiv || connected || WW aktiv<br />
|-<br />
|WW-Zeitplan ||<br />
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,<br />
thu start:06:30 position:0 mode:on end:22:30,<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,<br />
|| WW Zeitplan<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || 0,1 || Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| on || Status Zirkulationspumpe(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan ||<br />
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,<br />
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,<br />
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,<br />
|| Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| off || (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 || WW aktiv<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 || einmaliges WW Aufladen aktiv<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 || WW zeitgesteuert<br />
|-<br />
| || ||<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings <br />
<br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },<br />
<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },<br />
<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },<br />
<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },<br />
<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },<br />
<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },<br />
<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },<br />
<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },<br />
<br />
<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },<br />
<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },<br />
<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },<br />
<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },<br />
<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },<br />
<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },<br />
<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },<br />
<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },<br />
<br />
<br />
Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },<br />
<br />
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },<br />
<br />
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },<br />
<br />
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },<br />
<br />
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },<br />
<br />
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },<br />
<br />
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },<br />
<br />
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }<br />
<br />
</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
defmod vitoconnect_rg readingsGroup<br />
vitoconnect:Aussentemperatur<br />
<Brenner><br />
vitoconnect:Brenner_Beriebsstunden<br />
vitoconnect:Brenner_Fehlercode<br />
vitoconnect:Brenner_Modulation<br />
vitoconnect:Brenner_Starts<br />
vitoconnect:Brenner_Status<br />
vitoconnect:Brenner_aktiv<br />
<HK1><br />
vitoconnect:HK1-aktiv<br />
vitoconnect:HK1-Betriebsart<br />
<br />
vitoconnect:HK1-Frostschutz_Status<br />
<br />
vitoconnect:HK1-Heizkurve-Niveau<br />
vitoconnect:HK1-Heizkurve-Steigung<br />
<br />
vitoconnect:K1-Programmstatus<br />
vitoconnect:HK1-Raum_Status<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_aktiv<br />
vitoconnect:HK1-Solltemperatur_erzwungen<br />
vitoconnect:HK1-Solltemperatur_normal<br />
vitoconnect:HK1-Solltemperatur_reduziert<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv<br />
vitoconnect:HK1-Standby_aktiv<br />
<br />
vitoconnect:HK1-Urlaub_Ende<br />
vitoconnect:HK1-Urlaub_Start<br />
vitoconnect:HK1-Urlaub_aktiv<br />
<br />
vitoconnect:HK1-Vorlauftemperatur<br />
<br />
vitoconnect:HK1-WW_aktiv<br />
vitoconnect:HK1-WW_und_Heizen_aktiv<br />
<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv<br />
<br />
vitoconnect:HK1-Zirkulationspumpe<br />
<Kessel><br />
vitoconnect:Kesseltemperatur<br />
vitoconnect:Kesseltemperatur_exact<br />
<WW><br />
vitoconnect:WW-Aufladung<br />
vitoconnect:WW-Haupttemperatur<br />
vitoconnect:WW-Isttemperatur<br />
vitoconnect:WW-Solltemperatur<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv<br />
vitoconnect:WW-Zirkulationspumpe_Status<br />
vitoconnect:WW-Zirkulationspumpe_primaer<br />
vitoconnect:WW-aktiv<br />
vitoconnect:WW-onTimeCharge_aktiv<br />
vitoconnect:WW-zeitgesteuert_aktiv<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl" style="width:90%;"><br />
attr vitoconnect_rg alias Heizung<br />
attr vitoconnect_rg cellStyle { <br />
"c:0"=>'style="text-align:left"', <br />
"c:1"=>'style="text-align:right"', <br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'<br />
}<br />
attr vitoconnect_rg mapping {<br />
"Aussentemperatur" => "Aussentemperatur",<br />
<br />
"Brenner_Beriebsstunden" => "Beriebsstunden",<br />
"Brenner_Fehlercode" => "Fehlercode",<br />
"Brenner_Modulation" => "Modulation",<br />
"Brenner_Starts" => "Starts",<br />
"Brenner_Status" => "Status",<br />
"Brenner_aktiv" => "aktiv",<br />
<br />
"HK1-aktiv" => "aktiv",<br />
"HK1-Betriebsart" => "Betriebsart",<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",<br />
"HK1-Raum_Status" => "Raum Status",<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",<br />
"HK1-Standby_aktiv" => "Standby aktiv",<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",<br />
"HK1-Urlaub_Start" => "Urlaub Start",<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",<br />
"HK1-WW_aktiv" => "WW aktiv",<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",<br />
<br />
"Kesseltemperatur" => "Kesseltemperatur",<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",<br />
<br />
"WW-Aufladung" => "Aufladung",<br />
"WW-Haupttemperatur" => "Haupttemperatur",<br />
"WW-Isttemperatur" => "Isttemperatur",<br />
"WW-Solltemperatur" => "Solltemperatur",<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",<br />
"WW-aktiv" => "aktiv",<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"<br />
}<br />
<br />
attr vitoconnect_rg nostate 1<br />
attr vitoconnect_rg notime 1<br />
attr vitoconnect_rg room Heizung<br />
attr vitoconnect_rg sortby 1<br />
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', <br />
'Brenner_aktiv.1' => 'icoHEIZUNG',<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'<br />
}<br />
<br />
attr vitoconnect_rg valueSuffix {<br />
Aussentemperatur => "°C", <br />
<br />
Brenner_Beriebsstunden => "h",<br />
Brenner_Modulation => "%",<br />
<br />
'HK1-Solltemperatur_normal' => "°C",<br />
'HK1-Solltemperatur_reduziert' => "°C",<br />
'HK1-Vorlauftemperatur' => " °C",<br />
<br />
Kesseltemperatur => "°C",<br />
Kesseltemperatur_exact => "°C",<br />
<br />
'WW-Solltemperatur' => " °C",<br />
'WW-Isttemperatur' => " °C",<br />
<br />
'WW-Solltemperatur' => "°C"<br />
}<br />
</syntaxhighlight><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
[[Datei:Gasverbräuche aus vitoconnect.jpg|400px]]<br />
<br />
==== weitere Graphen ====<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Datei:ReadingsGroup_f%C3%BCr_Vitoconnect_Modul_3.jpg&diff=29536
Datei:ReadingsGroup für Vitoconnect Modul 3.jpg
2019-02-17T16:03:49Z
<p>Andreas13: </p>
<hr />
<div>ReadingsGroup für Vitoconnect Modul 3</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29532
Vitoconnect
2019-02-17T12:30:51Z
<p>Andreas13: /* Readings */</p>
<hr />
<div>{{SEITENTITEL:vitoconnect}} <br />
{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=d<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen. <br />
<br />
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.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann 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!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
=== Vorbereitung ===<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
===Readings ===<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Betriebsstunden|| 934.336944444444 || Brenner Betriebsstunden<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 || Brenner Modulation in %<br />
|-<br />
|Brenner_Starts|| 2717 || Brenner Starts<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||??? (noch nicht implementiert)<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||??? (noch nicht implementiert)<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || 235,705,0 || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || 27,208,213,193,215,84,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || 2,6,0,0,0,2,9,0 ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|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<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Raum_Temperatur || 20 ||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 || Solltemperatur aktiv<br />
|-<br />
|HK1-Solltemperatur_comfort || 22 || Comfort Solltemeratur<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 || Comfort aktiv<br />
|-<br />
|HK1-Solltemperatur_eco || 24 || Eco Solltemperatur<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 || Eco aktiv<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1 || Solltemperatur erzwungen<br />
|-<br />
|HK1-Solltemperatur_normal || 24 || Solltemperatur normal<br />
|-<br />
|HK1-Solltemperatur_reduziert || 16 || Solltemperatur reduziert<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 || Reduziert aktiv<br />
|-<br />
|HK1-Standby_aktiv || 0,1 || Standby aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || 2019-02-16T00:00:00.000Z ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || 2019-02-02T23:59:59.000Z ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 || Vorlauftemperatir<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected || Vorlauftemperatursensor verbunden<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||Modus WW (dhw) aktiv<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 || Modus WW und Heizen (dhwAndHeating) aktiv<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || <br />
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,<br />
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,<br />
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,<br />
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,<br />
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00, <br />
|| Zeitplan für Heizung<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 || Zeitplan Heizung aktiv<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation'' || 0,1 || Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?<br />
|-<br />
|''HK1-Zeitsteuerung_Zirkulation_aktiv'' || 0,1 || Zirkulationspumpe zeitgesteuert<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || Zirkulationspumpe aktiv (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || 1 ||HK1 aktiv<br />
|-<br />
| || ||<br />
|-<br />
|Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || connected ||xxx<br />
|-<br />
|Kesseltemperatur || 53 ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| 53 ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 || ???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z || ???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || 0 || ???<br />
|-<br />
|Service_fällig || 0,1 || Service fällig?<br />
|-<br />
|''Service_fällig_brennerbasiert'' || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|Stromverbrauch/Jahr|| 35573,66052,0 || Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|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?)<br />
|-<br />
|Stromverbrauch/Tag|| 409,828,720,733,731,727,708,682 || Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
|Stromverbrauch/Woche|| 4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,<br />
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 <br />
|| Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| 0,1 || WW Vorrat wird erhitzt (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| 54 || ?? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 || WW Ist-Temperatur<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 || WW Solltemperatur<br />
|-<br />
|WW-Temperatur_aktiv || connected || WW aktiv<br />
|-<br />
|WW-Zeitplan ||<br />
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,<br />
thu start:06:30 position:0 mode:on end:22:30,<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,<br />
|| WW Zeitplan<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || 0,1 || Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| on || Status Zirkulationspumpe(neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan ||<br />
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,<br />
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,<br />
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,<br />
|| Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| off || (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 || WW aktiv<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 || einmaliges WW Aufladen aktiv<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 || WW zeitgesteuert<br />
|-<br />
| || ||<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings <br />
<br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },<br />
<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },<br />
<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },<br />
<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },<br />
<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },<br />
<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },<br />
<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },<br />
<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },<br />
<br />
<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },<br />
<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },<br />
<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },<br />
<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },<br />
<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },<br />
<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },<br />
<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },<br />
<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },<br />
<br />
<br />
Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },<br />
<br />
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },<br />
<br />
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },<br />
<br />
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },<br />
<br />
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },<br />
<br />
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },<br />
<br />
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },<br />
<br />
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }<br />
<br />
</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br />
<Brenner>\<br />
vitoconnect:Brenner_Beriebsstunden\<br />
vitoconnect:Brenner_Fehlercode\<br />
vitoconnect:Brenner_Modulation\<br />
vitoconnect:Brenner_Starts\<br />
vitoconnect:Brenner_Status\<br />
vitoconnect:Brenner_aktiv\<br />
<Gasverbrauch Heizung>\<br />
vitoconnect:Gasverbrauch_heute, vitoconnect:Gasverbrauch_gestern\<br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_letzte_Woche\<br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_letzter_Monat\<br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_letztes_Jahr\<br />
<Gasverbrauch Warmwasser>\<br />
vitoconnect:Gasverbrauch_WW_heute, vitoconnect:Gasverbrauch_WW_gestern\<br />
vitoconnect:Gasverbrauch_WW_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_WW_letzte_Woche\<br />
vitoconnect:Gasverbrauch_WW_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_WW_letzter_Monat\<br />
vitoconnect:Gasverbrauch_WW_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_WW_letztes_Jahr\<br />
<HK1>\<br />
vitoconnect:HK1-aktiv\<br />
vitoconnect:HK1-Betriebsart\<br />
\<br />
vitoconnect:HK1-Frostschutz_Status\<br />
\<br />
vitoconnect:HK1-Heizkurve-Niveau\<br />
vitoconnect:HK1-Heizkurve-Steigung\<br />
\<br />
vitoconnect:K1-Programmstatus\<br />
vitoconnect:HK1-Raum_Status\<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_aktiv\<br />
vitoconnect:HK1-Solltemperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_normal\<br />
vitoconnect:HK1-Solltemperatur_reduziert\<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br />
vitoconnect:HK1-Standby_aktiv\<br />
\<br />
vitoconnect:HK1-Urlaub_Ende\<br />
vitoconnect:HK1-Urlaub_Start\<br />
vitoconnect:HK1-Urlaub_aktiv\<br />
\<br />
vitoconnect:HK1-Vorlauftemperatur\<br />
\<br />
vitoconnect:HK1-WW_aktiv\<br />
vitoconnect:HK1-WW_und_Heizen_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv\<br />
vitoconnect:HK1-Zirkulationspumpe\<br />
<Kessel>\<br />
vitoconnect:Kesseltemperatur\<br />
vitoconnect:Kesseltemperatur_exact\<br />
<WW>\<br />
vitoconnect:WW-Aufladung\<br />
vitoconnect:WW-Haupttemperatur\<br />
vitoconnect:WW-Isttemperatur\<br />
vitoconnect:WW-Solltemperatur\<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv\<br />
vitoconnect:WW-Zirkulationspumpe_Status\<br />
vitoconnect:WW-Zirkulationspumpe_primaer\<br />
vitoconnect:WW-aktiv\<br />
vitoconnect:WW-onTimeCharge_aktiv\<br />
vitoconnect:WW-zeitgesteuert_aktiv\<br />
<br />
<br><br><br />
attr vitoconnect_rg alias Heizung<br><br />
attr vitoconnect_rg cellStyle { \<br />
"c:0"=>'style="text-align:left"', \<br />
"c:1"=>'style="text-align:right"', \<br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'\<br />
\<br />
}<br><br />
attr vitoconnect_rg mapping {\<br />
"Aussentemperatur" => "Aussentemperatur",\<br />
\<br />
"Brenner_Beriebsstunden" => "Beriebsstunden",\<br />
"Brenner_Fehlercode" => "Fehlercode",\<br />
"Brenner_Modulation" => "Modulation",\<br />
"Brenner_Starts" => "Starts",\<br />
"Brenner_Status" => "Status",\<br />
"Brenner_aktiv" => "aktiv",\<br />
\<br />
"Gasverbrauch_heute" => "heute",\<br />
"Gasverbrauch_gestern" => "gestern",\<br />
"Gasverbrauch_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_letztes_Jahr" => "letztes Jahr",\<br />
"Gasverbrauch_WW_heute" => "heute",\<br />
"Gasverbrauch_WW_gestern" => "gestern",\<br />
"Gasverbrauch_WW_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_WW_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_WW_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_WW_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_WW_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_WW_letztes_Jahr" => "letztes Jahr",\<br />
\<br />
"HK1-aktiv" => "aktiv",\<br />
"HK1-Betriebsart" => "Betriebsart",\<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",\<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",\<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",\<br />
"HK1-Raum_Status" => "Raum Status",\<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",\<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",\<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",\<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",\<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",\<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",\<br />
"HK1-Standby_aktiv" => "Standby aktiv",\<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",\<br />
"HK1-Urlaub_Start" => "Urlaub Start",\<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",\<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",\<br />
"HK1-WW_aktiv" => "WW aktiv",\<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",\<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",\<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",\<br />
\<br />
"Kesseltemperatur" => "Kesseltemperatur",\<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",\<br />
\<br />
"WW-Aufladung" => "Aufladung",\<br />
"WW-Haupttemperatur" => "Haupttemperatur",\<br />
"WW-Isttemperatur" => "Isttemperatur",\<br />
"WW-Solltemperatur" => "Solltemperatur",\<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirklationspumpe Zeitsteuerung aktiv",\<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",\<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",\<br />
"WW-aktiv" => "aktiv",\<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",\<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"\<br />
\<br />
}<br><br />
attr vitoconnect_rg nostate 1<br><br />
attr vitoconnect_rg notime 1<br><br />
attr vitoconnect_rg room Heizung<br><br />
attr vitoconnect_rg sortby 1<br><br />
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }<br><br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br />
}\<br><br />
<br />
attr vitoconnect_rg valueSuffix {\<br />
Aussentemperatur => "°C", \<br />
\<br />
Brenner_Beriebsstunden => "h",\<br />
Brenner_Modulation => "%",\<br />
\<br />
Gasverbrauch_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_letztes_Jahr => "kWh",\<br />
Gasverbrauch_aktueller_Monat => "kWh",\<br />
Gasverbrauch_letzter_Monat => "kWh", \<br />
Gasverbrauch_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_letzte_Woche => "kWh",\<br />
Gasverbrauch_heute => "kWh", \<br />
Gasverbrauch_gestern => "kWh", \<br />
\<br />
Gasverbrauch_WW_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_WW_letztes_Jahr => "kWh",\<br />
Gasverbrauch_WW_aktueller_Monat => "kWh",\<br />
Gasverbrauch_WW_letzter_Monat => "kWh",\<br />
Gasverbrauch_WW_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_WW_letzte_Woche => "kWh",\<br />
Gasverbrauch_WW_heute => "kWh", \<br />
Gasverbrauch_WW_gestern => "kWh", \<br />
\<br />
'HK1-Solltemperatur_normal' => "°C",\<br />
'HK1-Solltemperatur_reduziert' => "°C",\<br />
'HK1-Vorlauftemperatur' => " °C",\<br />
\<br />
Kesseltemperatur => "°C",\<br />
Kesseltemperatur_exact => "°C",\<br />
\<br />
'WW-Solltemperatur' => " °C",\<br />
'WW-Isttemperatur' => " °C",\<br />
\<br />
'WW-Solltemperatur' => "°C"\<br />
}<br />
<br />
</code><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 2.jpg|400px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
[[Datei:Gasverbräuche aus vitoconnect.jpg|400px]]<br />
<br />
==== weitere Graphen ====<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29531
Vitoconnect
2019-02-17T11:45:54Z
<p>Andreas13: /* Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen */</p>
<hr />
<div>{{SEITENTITEL:vitoconnect}} <br />
{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=d<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen. <br />
<br />
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.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann 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!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
=== Vorbereitung ===<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
===Readings ===<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Betriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||<br />
|-<br />
|HK1-Solltemperatur_normal || ||<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||<br />
|-<br />
|Service_fällig || ||<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| || (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error || (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||<br />
|-<br />
|WW-Temperatur_aktiv || connected ||<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| || (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| || (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| || (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||<br />
|-<br />
| || ||<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings <br />
<br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },<br />
<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },<br />
<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },<br />
<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },<br />
<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },<br />
<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },<br />
<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },<br />
<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },<br />
<br />
<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },<br />
<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },<br />
<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },<br />
<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },<br />
<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },<br />
<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },<br />
<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },<br />
<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },<br />
<br />
<br />
Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },<br />
<br />
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },<br />
<br />
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },<br />
<br />
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },<br />
<br />
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },<br />
<br />
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },<br />
<br />
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },<br />
<br />
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }<br />
<br />
</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br />
<Brenner>\<br />
vitoconnect:Brenner_Beriebsstunden\<br />
vitoconnect:Brenner_Fehlercode\<br />
vitoconnect:Brenner_Modulation\<br />
vitoconnect:Brenner_Starts\<br />
vitoconnect:Brenner_Status\<br />
vitoconnect:Brenner_aktiv\<br />
<Gasverbrauch Heizung>\<br />
vitoconnect:Gasverbrauch_heute, vitoconnect:Gasverbrauch_gestern\<br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_letzte_Woche\<br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_letzter_Monat\<br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_letztes_Jahr\<br />
<Gasverbrauch Warmwasser>\<br />
vitoconnect:Gasverbrauch_WW_heute, vitoconnect:Gasverbrauch_WW_gestern\<br />
vitoconnect:Gasverbrauch_WW_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_WW_letzte_Woche\<br />
vitoconnect:Gasverbrauch_WW_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_WW_letzter_Monat\<br />
vitoconnect:Gasverbrauch_WW_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_WW_letztes_Jahr\<br />
<HK1>\<br />
vitoconnect:HK1-aktiv\<br />
vitoconnect:HK1-Betriebsart\<br />
\<br />
vitoconnect:HK1-Frostschutz_Status\<br />
\<br />
vitoconnect:HK1-Heizkurve-Niveau\<br />
vitoconnect:HK1-Heizkurve-Steigung\<br />
\<br />
vitoconnect:K1-Programmstatus\<br />
vitoconnect:HK1-Raum_Status\<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_aktiv\<br />
vitoconnect:HK1-Solltemperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_normal\<br />
vitoconnect:HK1-Solltemperatur_reduziert\<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br />
vitoconnect:HK1-Standby_aktiv\<br />
\<br />
vitoconnect:HK1-Urlaub_Ende\<br />
vitoconnect:HK1-Urlaub_Start\<br />
vitoconnect:HK1-Urlaub_aktiv\<br />
\<br />
vitoconnect:HK1-Vorlauftemperatur\<br />
\<br />
vitoconnect:HK1-WW_aktiv\<br />
vitoconnect:HK1-WW_und_Heizen_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv\<br />
vitoconnect:HK1-Zirkulationspumpe\<br />
<Kessel>\<br />
vitoconnect:Kesseltemperatur\<br />
vitoconnect:Kesseltemperatur_exact\<br />
<WW>\<br />
vitoconnect:WW-Aufladung\<br />
vitoconnect:WW-Haupttemperatur\<br />
vitoconnect:WW-Isttemperatur\<br />
vitoconnect:WW-Solltemperatur\<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv\<br />
vitoconnect:WW-Zirkulationspumpe_Status\<br />
vitoconnect:WW-Zirkulationspumpe_primaer\<br />
vitoconnect:WW-aktiv\<br />
vitoconnect:WW-onTimeCharge_aktiv\<br />
vitoconnect:WW-zeitgesteuert_aktiv\<br />
<br />
<br><br><br />
attr vitoconnect_rg alias Heizung<br><br />
attr vitoconnect_rg cellStyle { \<br />
"c:0"=>'style="text-align:left"', \<br />
"c:1"=>'style="text-align:right"', \<br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'\<br />
\<br />
}<br><br />
attr vitoconnect_rg mapping {\<br />
"Aussentemperatur" => "Aussentemperatur",\<br />
\<br />
"Brenner_Beriebsstunden" => "Beriebsstunden",\<br />
"Brenner_Fehlercode" => "Fehlercode",\<br />
"Brenner_Modulation" => "Modulation",\<br />
"Brenner_Starts" => "Starts",\<br />
"Brenner_Status" => "Status",\<br />
"Brenner_aktiv" => "aktiv",\<br />
\<br />
"Gasverbrauch_heute" => "heute",\<br />
"Gasverbrauch_gestern" => "gestern",\<br />
"Gasverbrauch_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_letztes_Jahr" => "letztes Jahr",\<br />
"Gasverbrauch_WW_heute" => "heute",\<br />
"Gasverbrauch_WW_gestern" => "gestern",\<br />
"Gasverbrauch_WW_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_WW_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_WW_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_WW_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_WW_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_WW_letztes_Jahr" => "letztes Jahr",\<br />
\<br />
"HK1-aktiv" => "aktiv",\<br />
"HK1-Betriebsart" => "Betriebsart",\<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",\<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",\<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",\<br />
"HK1-Raum_Status" => "Raum Status",\<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",\<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",\<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",\<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",\<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",\<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",\<br />
"HK1-Standby_aktiv" => "Standby aktiv",\<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",\<br />
"HK1-Urlaub_Start" => "Urlaub Start",\<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",\<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",\<br />
"HK1-WW_aktiv" => "WW aktiv",\<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",\<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",\<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",\<br />
\<br />
"Kesseltemperatur" => "Kesseltemperatur",\<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",\<br />
\<br />
"WW-Aufladung" => "Aufladung",\<br />
"WW-Haupttemperatur" => "Haupttemperatur",\<br />
"WW-Isttemperatur" => "Isttemperatur",\<br />
"WW-Solltemperatur" => "Solltemperatur",\<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirklationspumpe Zeitsteuerung aktiv",\<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",\<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",\<br />
"WW-aktiv" => "aktiv",\<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",\<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"\<br />
\<br />
}<br><br />
attr vitoconnect_rg nostate 1<br><br />
attr vitoconnect_rg notime 1<br><br />
attr vitoconnect_rg room Heizung<br><br />
attr vitoconnect_rg sortby 1<br><br />
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }<br><br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br />
}\<br><br />
<br />
attr vitoconnect_rg valueSuffix {\<br />
Aussentemperatur => "°C", \<br />
\<br />
Brenner_Beriebsstunden => "h",\<br />
Brenner_Modulation => "%",\<br />
\<br />
Gasverbrauch_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_letztes_Jahr => "kWh",\<br />
Gasverbrauch_aktueller_Monat => "kWh",\<br />
Gasverbrauch_letzter_Monat => "kWh", \<br />
Gasverbrauch_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_letzte_Woche => "kWh",\<br />
Gasverbrauch_heute => "kWh", \<br />
Gasverbrauch_gestern => "kWh", \<br />
\<br />
Gasverbrauch_WW_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_WW_letztes_Jahr => "kWh",\<br />
Gasverbrauch_WW_aktueller_Monat => "kWh",\<br />
Gasverbrauch_WW_letzter_Monat => "kWh",\<br />
Gasverbrauch_WW_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_WW_letzte_Woche => "kWh",\<br />
Gasverbrauch_WW_heute => "kWh", \<br />
Gasverbrauch_WW_gestern => "kWh", \<br />
\<br />
'HK1-Solltemperatur_normal' => "°C",\<br />
'HK1-Solltemperatur_reduziert' => "°C",\<br />
'HK1-Vorlauftemperatur' => " °C",\<br />
\<br />
Kesseltemperatur => "°C",\<br />
Kesseltemperatur_exact => "°C",\<br />
\<br />
'WW-Solltemperatur' => " °C",\<br />
'WW-Isttemperatur' => " °C",\<br />
\<br />
'WW-Solltemperatur' => "°C"\<br />
}<br />
<br />
</code><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 2.jpg|400px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
[[Datei:Gasverbräuche aus vitoconnect.jpg|400px]]<br />
<br />
==== weitere Graphen ====<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29530
Vitoconnect
2019-02-17T11:39:12Z
<p>Andreas13: </p>
<hr />
<div>{{SEITENTITEL:vitoconnect}} <br />
{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=d<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen. <br />
<br />
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.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann 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!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
=== Vorbereitung ===<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
===Readings ===<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Betriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||<br />
|-<br />
|HK1-Solltemperatur_normal || ||<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||<br />
|-<br />
|Service_fällig || ||<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| || (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error || (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||<br />
|-<br />
|WW-Temperatur_aktiv || connected ||<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| || (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| || (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| || (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||<br />
|-<br />
| || ||<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Woche",0))[1] },\<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Monat",0))[1] },\<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Jahr",0))[1] },\<br />
\<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br />
"Gasverbrauch_WW/Tag",0))[0] },\<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Tag",0))[1] },\<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Woche",0))[0] },\<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Woche",0))[1] },\<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Monat",0))[0] },\<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Monat",0))[1] },\<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Jahr",0))[0] },\<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Jahr",0))[1] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br />
<Brenner>\<br />
vitoconnect:Brenner_Beriebsstunden\<br />
vitoconnect:Brenner_Fehlercode\<br />
vitoconnect:Brenner_Modulation\<br />
vitoconnect:Brenner_Starts\<br />
vitoconnect:Brenner_Status\<br />
vitoconnect:Brenner_aktiv\<br />
<Gasverbrauch Heizung>\<br />
vitoconnect:Gasverbrauch_heute, vitoconnect:Gasverbrauch_gestern\<br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_letzte_Woche\<br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_letzter_Monat\<br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_letztes_Jahr\<br />
<Gasverbrauch Warmwasser>\<br />
vitoconnect:Gasverbrauch_WW_heute, vitoconnect:Gasverbrauch_WW_gestern\<br />
vitoconnect:Gasverbrauch_WW_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_WW_letzte_Woche\<br />
vitoconnect:Gasverbrauch_WW_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_WW_letzter_Monat\<br />
vitoconnect:Gasverbrauch_WW_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_WW_letztes_Jahr\<br />
<HK1>\<br />
vitoconnect:HK1-aktiv\<br />
vitoconnect:HK1-Betriebsart\<br />
\<br />
vitoconnect:HK1-Frostschutz_Status\<br />
\<br />
vitoconnect:HK1-Heizkurve-Niveau\<br />
vitoconnect:HK1-Heizkurve-Steigung\<br />
\<br />
vitoconnect:K1-Programmstatus\<br />
vitoconnect:HK1-Raum_Status\<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_aktiv\<br />
vitoconnect:HK1-Solltemperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_normal\<br />
vitoconnect:HK1-Solltemperatur_reduziert\<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br />
vitoconnect:HK1-Standby_aktiv\<br />
\<br />
vitoconnect:HK1-Urlaub_Ende\<br />
vitoconnect:HK1-Urlaub_Start\<br />
vitoconnect:HK1-Urlaub_aktiv\<br />
\<br />
vitoconnect:HK1-Vorlauftemperatur\<br />
\<br />
vitoconnect:HK1-WW_aktiv\<br />
vitoconnect:HK1-WW_und_Heizen_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv\<br />
vitoconnect:HK1-Zirkulationspumpe\<br />
<Kessel>\<br />
vitoconnect:Kesseltemperatur\<br />
vitoconnect:Kesseltemperatur_exact\<br />
<WW>\<br />
vitoconnect:WW-Aufladung\<br />
vitoconnect:WW-Haupttemperatur\<br />
vitoconnect:WW-Isttemperatur\<br />
vitoconnect:WW-Solltemperatur\<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv\<br />
vitoconnect:WW-Zirkulationspumpe_Status\<br />
vitoconnect:WW-Zirkulationspumpe_primaer\<br />
vitoconnect:WW-aktiv\<br />
vitoconnect:WW-onTimeCharge_aktiv\<br />
vitoconnect:WW-zeitgesteuert_aktiv\<br />
<br />
<br><br><br />
attr vitoconnect_rg alias Heizung<br><br />
attr vitoconnect_rg cellStyle { \<br />
"c:0"=>'style="text-align:left"', \<br />
"c:1"=>'style="text-align:right"', \<br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'\<br />
\<br />
}<br><br />
attr vitoconnect_rg mapping {\<br />
"Aussentemperatur" => "Aussentemperatur",\<br />
\<br />
"Brenner_Beriebsstunden" => "Beriebsstunden",\<br />
"Brenner_Fehlercode" => "Fehlercode",\<br />
"Brenner_Modulation" => "Modulation",\<br />
"Brenner_Starts" => "Starts",\<br />
"Brenner_Status" => "Status",\<br />
"Brenner_aktiv" => "aktiv",\<br />
\<br />
"Gasverbrauch_heute" => "heute",\<br />
"Gasverbrauch_gestern" => "gestern",\<br />
"Gasverbrauch_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_letztes_Jahr" => "letztes Jahr",\<br />
"Gasverbrauch_WW_heute" => "heute",\<br />
"Gasverbrauch_WW_gestern" => "gestern",\<br />
"Gasverbrauch_WW_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_WW_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_WW_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_WW_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_WW_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_WW_letztes_Jahr" => "letztes Jahr",\<br />
\<br />
"HK1-aktiv" => "aktiv",\<br />
"HK1-Betriebsart" => "Betriebsart",\<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",\<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",\<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",\<br />
"HK1-Raum_Status" => "Raum Status",\<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",\<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",\<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",\<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",\<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",\<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",\<br />
"HK1-Standby_aktiv" => "Standby aktiv",\<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",\<br />
"HK1-Urlaub_Start" => "Urlaub Start",\<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",\<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",\<br />
"HK1-WW_aktiv" => "WW aktiv",\<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",\<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",\<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",\<br />
\<br />
"Kesseltemperatur" => "Kesseltemperatur",\<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",\<br />
\<br />
"WW-Aufladung" => "Aufladung",\<br />
"WW-Haupttemperatur" => "Haupttemperatur",\<br />
"WW-Isttemperatur" => "Isttemperatur",\<br />
"WW-Solltemperatur" => "Solltemperatur",\<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirklationspumpe Zeitsteuerung aktiv",\<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",\<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",\<br />
"WW-aktiv" => "aktiv",\<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",\<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"\<br />
\<br />
}<br><br />
attr vitoconnect_rg nostate 1<br><br />
attr vitoconnect_rg notime 1<br><br />
attr vitoconnect_rg room Heizung<br><br />
attr vitoconnect_rg sortby 1<br><br />
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }<br><br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br />
}\<br><br />
<br />
attr vitoconnect_rg valueSuffix {\<br />
Aussentemperatur => "°C", \<br />
\<br />
Brenner_Beriebsstunden => "h",\<br />
Brenner_Modulation => "%",\<br />
\<br />
Gasverbrauch_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_letztes_Jahr => "kWh",\<br />
Gasverbrauch_aktueller_Monat => "kWh",\<br />
Gasverbrauch_letzter_Monat => "kWh", \<br />
Gasverbrauch_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_letzte_Woche => "kWh",\<br />
Gasverbrauch_heute => "kWh", \<br />
Gasverbrauch_gestern => "kWh", \<br />
\<br />
Gasverbrauch_WW_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_WW_letztes_Jahr => "kWh",\<br />
Gasverbrauch_WW_aktueller_Monat => "kWh",\<br />
Gasverbrauch_WW_letzter_Monat => "kWh",\<br />
Gasverbrauch_WW_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_WW_letzte_Woche => "kWh",\<br />
Gasverbrauch_WW_heute => "kWh", \<br />
Gasverbrauch_WW_gestern => "kWh", \<br />
\<br />
'HK1-Solltemperatur_normal' => "°C",\<br />
'HK1-Solltemperatur_reduziert' => "°C",\<br />
'HK1-Vorlauftemperatur' => " °C",\<br />
\<br />
Kesseltemperatur => "°C",\<br />
Kesseltemperatur_exact => "°C",\<br />
\<br />
'WW-Solltemperatur' => " °C",\<br />
'WW-Isttemperatur' => " °C",\<br />
\<br />
'WW-Solltemperatur' => "°C"\<br />
}<br />
<br />
</code><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 2.jpg|400px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
[[Datei:Gasverbräuche aus vitoconnect.jpg|400px]]<br />
<br />
==== weitere Graphen ====<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29239
Vitoconnect
2019-01-26T12:39:59Z
<p>Andreas13: /* Readings */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Betriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||<br />
|-<br />
|HK1-Solltemperatur_normal || ||<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||<br />
|-<br />
|Service_fällig || ||<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| || (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error || (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||<br />
|-<br />
|WW-Temperatur_aktiv || connected ||<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| || (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| || (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| || (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||<br />
|-<br />
| || ||<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Woche",0))[1] },\<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Monat",0))[1] },\<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Jahr",0))[1] },\<br />
\<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br />
"Gasverbrauch_WW/Tag",0))[0] },\<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Tag",0))[1] },\<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Woche",0))[0] },\<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Woche",0))[1] },\<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Monat",0))[0] },\<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Monat",0))[1] },\<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Jahr",0))[0] },\<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Jahr",0))[1] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br />
<Brenner>\<br />
vitoconnect:Brenner_Beriebsstunden\<br />
vitoconnect:Brenner_Fehlercode\<br />
vitoconnect:Brenner_Modulation\<br />
vitoconnect:Brenner_Starts\<br />
vitoconnect:Brenner_Status\<br />
vitoconnect:Brenner_aktiv\<br />
<Gasverbrauch Heizung>\<br />
vitoconnect:Gasverbrauch_heute, vitoconnect:Gasverbrauch_gestern\<br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_letzte_Woche\<br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_letzter_Monat\<br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_letztes_Jahr\<br />
<Gasverbrauch Warmwasser>\<br />
vitoconnect:Gasverbrauch_WW_heute, vitoconnect:Gasverbrauch_WW_gestern\<br />
vitoconnect:Gasverbrauch_WW_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_WW_letzte_Woche\<br />
vitoconnect:Gasverbrauch_WW_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_WW_letzter_Monat\<br />
vitoconnect:Gasverbrauch_WW_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_WW_letztes_Jahr\<br />
<HK1>\<br />
vitoconnect:HK1-aktiv\<br />
vitoconnect:HK1-Betriebsart\<br />
\<br />
vitoconnect:HK1-Frostschutz_Status\<br />
\<br />
vitoconnect:HK1-Heizkurve-Niveau\<br />
vitoconnect:HK1-Heizkurve-Steigung\<br />
\<br />
vitoconnect:K1-Programmstatus\<br />
vitoconnect:HK1-Raum_Status\<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_aktiv\<br />
vitoconnect:HK1-Solltemperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_normal\<br />
vitoconnect:HK1-Solltemperatur_reduziert\<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br />
vitoconnect:HK1-Standby_aktiv\<br />
\<br />
vitoconnect:HK1-Urlaub_Ende\<br />
vitoconnect:HK1-Urlaub_Start\<br />
vitoconnect:HK1-Urlaub_aktiv\<br />
\<br />
vitoconnect:HK1-Vorlauftemperatur\<br />
\<br />
vitoconnect:HK1-WW_aktiv\<br />
vitoconnect:HK1-WW_und_Heizen_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv\<br />
vitoconnect:HK1-Zirkulationspumpe\<br />
<Kessel>\<br />
vitoconnect:Kesseltemperatur\<br />
vitoconnect:Kesseltemperatur_exact\<br />
<WW>\<br />
vitoconnect:WW-Aufladung\<br />
vitoconnect:WW-Haupttemperatur\<br />
vitoconnect:WW-Isttemperatur\<br />
vitoconnect:WW-Solltemperatur\<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv\<br />
vitoconnect:WW-Zirkulationspumpe_Status\<br />
vitoconnect:WW-Zirkulationspumpe_primaer\<br />
vitoconnect:WW-aktiv\<br />
vitoconnect:WW-onTimeCharge_aktiv\<br />
vitoconnect:WW-zeitgesteuert_aktiv\<br />
<br />
<br><br><br />
attr vitoconnect_rg alias Heizung<br><br />
attr vitoconnect_rg cellStyle { \<br />
"c:0"=>'style="text-align:left"', \<br />
"c:1"=>'style="text-align:right"', \<br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'\<br />
\<br />
}<br><br />
attr vitoconnect_rg mapping {\<br />
"Aussentemperatur" => "Aussentemperatur",\<br />
\<br />
"Brenner_Beriebsstunden" => "Beriebsstunden",\<br />
"Brenner_Fehlercode" => "Fehlercode",\<br />
"Brenner_Modulation" => "Modulation",\<br />
"Brenner_Starts" => "Starts",\<br />
"Brenner_Status" => "Status",\<br />
"Brenner_aktiv" => "aktiv",\<br />
\<br />
"Gasverbrauch_heute" => "heute",\<br />
"Gasverbrauch_gestern" => "gestern",\<br />
"Gasverbrauch_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_letztes_Jahr" => "letztes Jahr",\<br />
"Gasverbrauch_WW_heute" => "heute",\<br />
"Gasverbrauch_WW_gestern" => "gestern",\<br />
"Gasverbrauch_WW_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_WW_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_WW_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_WW_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_WW_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_WW_letztes_Jahr" => "letztes Jahr",\<br />
\<br />
"HK1-aktiv" => "aktiv",\<br />
"HK1-Betriebsart" => "Betriebsart",\<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",\<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",\<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",\<br />
"HK1-Raum_Status" => "Raum Status",\<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",\<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",\<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",\<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",\<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",\<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",\<br />
"HK1-Standby_aktiv" => "Standby aktiv",\<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",\<br />
"HK1-Urlaub_Start" => "Urlaub Start",\<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",\<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",\<br />
"HK1-WW_aktiv" => "WW aktiv",\<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",\<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",\<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",\<br />
\<br />
"Kesseltemperatur" => "Kesseltemperatur",\<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",\<br />
\<br />
"WW-Aufladung" => "Aufladung",\<br />
"WW-Haupttemperatur" => "Haupttemperatur",\<br />
"WW-Isttemperatur" => "Isttemperatur",\<br />
"WW-Solltemperatur" => "Solltemperatur",\<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirklationspumpe Zeitsteuerung aktiv",\<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",\<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",\<br />
"WW-aktiv" => "aktiv",\<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",\<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"\<br />
\<br />
}<br><br />
attr vitoconnect_rg nostate 1<br><br />
attr vitoconnect_rg notime 1<br><br />
attr vitoconnect_rg room Heizung<br><br />
attr vitoconnect_rg sortby 1<br><br />
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }<br><br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br />
}\<br><br />
<br />
attr vitoconnect_rg valueSuffix {\<br />
Aussentemperatur => "°C", \<br />
\<br />
Brenner_Beriebsstunden => "h",\<br />
Brenner_Modulation => "%",\<br />
\<br />
Gasverbrauch_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_letztes_Jahr => "kWh",\<br />
Gasverbrauch_aktueller_Monat => "kWh",\<br />
Gasverbrauch_letzter_Monat => "kWh", \<br />
Gasverbrauch_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_letzte_Woche => "kWh",\<br />
Gasverbrauch_heute => "kWh", \<br />
Gasverbrauch_gestern => "kWh", \<br />
\<br />
Gasverbrauch_WW_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_WW_letztes_Jahr => "kWh",\<br />
Gasverbrauch_WW_aktueller_Monat => "kWh",\<br />
Gasverbrauch_WW_letzter_Monat => "kWh",\<br />
Gasverbrauch_WW_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_WW_letzte_Woche => "kWh",\<br />
Gasverbrauch_WW_heute => "kWh", \<br />
Gasverbrauch_WW_gestern => "kWh", \<br />
\<br />
'HK1-Solltemperatur_normal' => "°C",\<br />
'HK1-Solltemperatur_reduziert' => "°C",\<br />
'HK1-Vorlauftemperatur' => " °C",\<br />
\<br />
Kesseltemperatur => "°C",\<br />
Kesseltemperatur_exact => "°C",\<br />
\<br />
'WW-Solltemperatur' => " °C",\<br />
'WW-Isttemperatur' => " °C",\<br />
\<br />
'WW-Solltemperatur' => "°C"\<br />
}<br />
<br />
</code><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 2.jpg|400px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
[[Datei:Gasverbräuche aus vitoconnect.jpg|400px]]<br />
<br />
==== weitere Graphen ====<br />
<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29238
Vitoconnect
2019-01-26T12:36:00Z
<p>Andreas13: /* Readings */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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!'''<br />
Außerdem liefert Vissmann 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)!<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Woche",0))[1] },\<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Monat",0))[1] },\<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Jahr",0))[1] },\<br />
\<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br />
"Gasverbrauch_WW/Tag",0))[0] },\<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Tag",0))[1] },\<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Woche",0))[0] },\<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Woche",0))[1] },\<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Monat",0))[0] },\<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Monat",0))[1] },\<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Jahr",0))[0] },\<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Jahr",0))[1] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br />
<Brenner>\<br />
vitoconnect:Brenner_Beriebsstunden\<br />
vitoconnect:Brenner_Fehlercode\<br />
vitoconnect:Brenner_Modulation\<br />
vitoconnect:Brenner_Starts\<br />
vitoconnect:Brenner_Status\<br />
vitoconnect:Brenner_aktiv\<br />
<Gasverbrauch Heizung>\<br />
vitoconnect:Gasverbrauch_heute, vitoconnect:Gasverbrauch_gestern\<br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_letzte_Woche\<br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_letzter_Monat\<br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_letztes_Jahr\<br />
<Gasverbrauch Warmwasser>\<br />
vitoconnect:Gasverbrauch_WW_heute, vitoconnect:Gasverbrauch_WW_gestern\<br />
vitoconnect:Gasverbrauch_WW_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_WW_letzte_Woche\<br />
vitoconnect:Gasverbrauch_WW_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_WW_letzter_Monat\<br />
vitoconnect:Gasverbrauch_WW_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_WW_letztes_Jahr\<br />
<HK1>\<br />
vitoconnect:HK1-aktiv\<br />
vitoconnect:HK1-Betriebsart\<br />
\<br />
vitoconnect:HK1-Frostschutz_Status\<br />
\<br />
vitoconnect:HK1-Heizkurve-Niveau\<br />
vitoconnect:HK1-Heizkurve-Steigung\<br />
\<br />
vitoconnect:K1-Programmstatus\<br />
vitoconnect:HK1-Raum_Status\<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_aktiv\<br />
vitoconnect:HK1-Solltemperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_normal\<br />
vitoconnect:HK1-Solltemperatur_reduziert\<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br />
vitoconnect:HK1-Standby_aktiv\<br />
\<br />
vitoconnect:HK1-Urlaub_Ende\<br />
vitoconnect:HK1-Urlaub_Start\<br />
vitoconnect:HK1-Urlaub_aktiv\<br />
\<br />
vitoconnect:HK1-Vorlauftemperatur\<br />
\<br />
vitoconnect:HK1-WW_aktiv\<br />
vitoconnect:HK1-WW_und_Heizen_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv\<br />
vitoconnect:HK1-Zirkulationspumpe\<br />
<Kessel>\<br />
vitoconnect:Kesseltemperatur\<br />
vitoconnect:Kesseltemperatur_exact\<br />
<WW>\<br />
vitoconnect:WW-Aufladung\<br />
vitoconnect:WW-Haupttemperatur\<br />
vitoconnect:WW-Isttemperatur\<br />
vitoconnect:WW-Solltemperatur\<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv\<br />
vitoconnect:WW-Zirkulationspumpe_Status\<br />
vitoconnect:WW-Zirkulationspumpe_primaer\<br />
vitoconnect:WW-aktiv\<br />
vitoconnect:WW-onTimeCharge_aktiv\<br />
vitoconnect:WW-zeitgesteuert_aktiv\<br />
<br />
<br><br><br />
attr vitoconnect_rg alias Heizung<br><br />
attr vitoconnect_rg cellStyle { \<br />
"c:0"=>'style="text-align:left"', \<br />
"c:1"=>'style="text-align:right"', \<br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'\<br />
\<br />
}<br><br />
attr vitoconnect_rg mapping {\<br />
"Aussentemperatur" => "Aussentemperatur",\<br />
\<br />
"Brenner_Beriebsstunden" => "Beriebsstunden",\<br />
"Brenner_Fehlercode" => "Fehlercode",\<br />
"Brenner_Modulation" => "Modulation",\<br />
"Brenner_Starts" => "Starts",\<br />
"Brenner_Status" => "Status",\<br />
"Brenner_aktiv" => "aktiv",\<br />
\<br />
"Gasverbrauch_heute" => "heute",\<br />
"Gasverbrauch_gestern" => "gestern",\<br />
"Gasverbrauch_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_letztes_Jahr" => "letztes Jahr",\<br />
"Gasverbrauch_WW_heute" => "heute",\<br />
"Gasverbrauch_WW_gestern" => "gestern",\<br />
"Gasverbrauch_WW_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_WW_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_WW_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_WW_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_WW_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_WW_letztes_Jahr" => "letztes Jahr",\<br />
\<br />
"HK1-aktiv" => "aktiv",\<br />
"HK1-Betriebsart" => "Betriebsart",\<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",\<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",\<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",\<br />
"HK1-Raum_Status" => "Raum Status",\<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",\<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",\<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",\<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",\<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",\<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",\<br />
"HK1-Standby_aktiv" => "Standby aktiv",\<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",\<br />
"HK1-Urlaub_Start" => "Urlaub Start",\<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",\<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",\<br />
"HK1-WW_aktiv" => "WW aktiv",\<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",\<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",\<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",\<br />
\<br />
"Kesseltemperatur" => "Kesseltemperatur",\<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",\<br />
\<br />
"WW-Aufladung" => "Aufladung",\<br />
"WW-Haupttemperatur" => "Haupttemperatur",\<br />
"WW-Isttemperatur" => "Isttemperatur",\<br />
"WW-Solltemperatur" => "Solltemperatur",\<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirklationspumpe Zeitsteuerung aktiv",\<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",\<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",\<br />
"WW-aktiv" => "aktiv",\<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",\<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"\<br />
\<br />
}<br><br />
attr vitoconnect_rg nostate 1<br><br />
attr vitoconnect_rg notime 1<br><br />
attr vitoconnect_rg room Heizung<br><br />
attr vitoconnect_rg sortby 1<br><br />
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }<br><br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br />
}\<br><br />
<br />
attr vitoconnect_rg valueSuffix {\<br />
Aussentemperatur => "°C", \<br />
\<br />
Brenner_Beriebsstunden => "h",\<br />
Brenner_Modulation => "%",\<br />
\<br />
Gasverbrauch_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_letztes_Jahr => "kWh",\<br />
Gasverbrauch_aktueller_Monat => "kWh",\<br />
Gasverbrauch_letzter_Monat => "kWh", \<br />
Gasverbrauch_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_letzte_Woche => "kWh",\<br />
Gasverbrauch_heute => "kWh", \<br />
Gasverbrauch_gestern => "kWh", \<br />
\<br />
Gasverbrauch_WW_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_WW_letztes_Jahr => "kWh",\<br />
Gasverbrauch_WW_aktueller_Monat => "kWh",\<br />
Gasverbrauch_WW_letzter_Monat => "kWh",\<br />
Gasverbrauch_WW_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_WW_letzte_Woche => "kWh",\<br />
Gasverbrauch_WW_heute => "kWh", \<br />
Gasverbrauch_WW_gestern => "kWh", \<br />
\<br />
'HK1-Solltemperatur_normal' => "°C",\<br />
'HK1-Solltemperatur_reduziert' => "°C",\<br />
'HK1-Vorlauftemperatur' => " °C",\<br />
\<br />
Kesseltemperatur => "°C",\<br />
Kesseltemperatur_exact => "°C",\<br />
\<br />
'WW-Solltemperatur' => " °C",\<br />
'WW-Isttemperatur' => " °C",\<br />
\<br />
'WW-Solltemperatur' => "°C"\<br />
}<br />
<br />
</code><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 2.jpg|400px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
[[Datei:Gasverbräuche aus vitoconnect.jpg|400px]]<br />
<br />
==== weitere Graphen ====<br />
<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29214
Vitoconnect
2019-01-24T20:30:04Z
<p>Andreas13: /* ReadingsGroup für eine kompakte Darstellung */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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 waren die Werte für Heizung und WW bis Mitte Dezember noch nicht seperat!)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Woche",0))[1] },\<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Monat",0))[1] },\<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Jahr",0))[1] },\<br />
\<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br />
"Gasverbrauch_WW/Tag",0))[0] },\<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Tag",0))[1] },\<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Woche",0))[0] },\<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Woche",0))[1] },\<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Monat",0))[0] },\<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Monat",0))[1] },\<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Jahr",0))[0] },\<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Jahr",0))[1] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br />
<Brenner>\<br />
vitoconnect:Brenner_Beriebsstunden\<br />
vitoconnect:Brenner_Fehlercode\<br />
vitoconnect:Brenner_Modulation\<br />
vitoconnect:Brenner_Starts\<br />
vitoconnect:Brenner_Status\<br />
vitoconnect:Brenner_aktiv\<br />
<Gasverbrauch Heizung>\<br />
vitoconnect:Gasverbrauch_heute, vitoconnect:Gasverbrauch_gestern\<br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_letzte_Woche\<br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_letzter_Monat\<br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_letztes_Jahr\<br />
<Gasverbrauch Warmwasser>\<br />
vitoconnect:Gasverbrauch_WW_heute, vitoconnect:Gasverbrauch_WW_gestern\<br />
vitoconnect:Gasverbrauch_WW_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_WW_letzte_Woche\<br />
vitoconnect:Gasverbrauch_WW_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_WW_letzter_Monat\<br />
vitoconnect:Gasverbrauch_WW_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_WW_letztes_Jahr\<br />
<HK1>\<br />
vitoconnect:HK1-aktiv\<br />
vitoconnect:HK1-Betriebsart\<br />
\<br />
vitoconnect:HK1-Frostschutz_Status\<br />
\<br />
vitoconnect:HK1-Heizkurve-Niveau\<br />
vitoconnect:HK1-Heizkurve-Steigung\<br />
\<br />
vitoconnect:K1-Programmstatus\<br />
vitoconnect:HK1-Raum_Status\<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_aktiv\<br />
vitoconnect:HK1-Solltemperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_normal\<br />
vitoconnect:HK1-Solltemperatur_reduziert\<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br />
vitoconnect:HK1-Standby_aktiv\<br />
\<br />
vitoconnect:HK1-Urlaub_Ende\<br />
vitoconnect:HK1-Urlaub_Start\<br />
vitoconnect:HK1-Urlaub_aktiv\<br />
\<br />
vitoconnect:HK1-Vorlauftemperatur\<br />
\<br />
vitoconnect:HK1-WW_aktiv\<br />
vitoconnect:HK1-WW_und_Heizen_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv\<br />
vitoconnect:HK1-Zirkulationspumpe\<br />
<Kessel>\<br />
vitoconnect:Kesseltemperatur\<br />
vitoconnect:Kesseltemperatur_exact\<br />
<WW>\<br />
vitoconnect:WW-Aufladung\<br />
vitoconnect:WW-Haupttemperatur\<br />
vitoconnect:WW-Isttemperatur\<br />
vitoconnect:WW-Solltemperatur\<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv\<br />
vitoconnect:WW-Zirkulationspumpe_Status\<br />
vitoconnect:WW-Zirkulationspumpe_primaer\<br />
vitoconnect:WW-aktiv\<br />
vitoconnect:WW-onTimeCharge_aktiv\<br />
vitoconnect:WW-zeitgesteuert_aktiv\<br />
<br />
<br><br><br />
attr vitoconnect_rg alias Heizung<br><br />
attr vitoconnect_rg cellStyle { \<br />
"c:0"=>'style="text-align:left"', \<br />
"c:1"=>'style="text-align:right"', \<br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'\<br />
\<br />
}<br><br />
attr vitoconnect_rg mapping {\<br />
"Aussentemperatur" => "Aussentemperatur",\<br />
\<br />
"Brenner_Beriebsstunden" => "Beriebsstunden",\<br />
"Brenner_Fehlercode" => "Fehlercode",\<br />
"Brenner_Modulation" => "Modulation",\<br />
"Brenner_Starts" => "Starts",\<br />
"Brenner_Status" => "Status",\<br />
"Brenner_aktiv" => "aktiv",\<br />
\<br />
"Gasverbrauch_heute" => "heute",\<br />
"Gasverbrauch_gestern" => "gestern",\<br />
"Gasverbrauch_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_letztes_Jahr" => "letztes Jahr",\<br />
"Gasverbrauch_WW_heute" => "heute",\<br />
"Gasverbrauch_WW_gestern" => "gestern",\<br />
"Gasverbrauch_WW_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_WW_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_WW_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_WW_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_WW_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_WW_letztes_Jahr" => "letztes Jahr",\<br />
\<br />
"HK1-aktiv" => "aktiv",\<br />
"HK1-Betriebsart" => "Betriebsart",\<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",\<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",\<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",\<br />
"HK1-Raum_Status" => "Raum Status",\<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",\<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",\<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",\<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",\<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",\<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",\<br />
"HK1-Standby_aktiv" => "Standby aktiv",\<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",\<br />
"HK1-Urlaub_Start" => "Urlaub Start",\<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",\<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",\<br />
"HK1-WW_aktiv" => "WW aktiv",\<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",\<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",\<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",\<br />
\<br />
"Kesseltemperatur" => "Kesseltemperatur",\<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",\<br />
\<br />
"WW-Aufladung" => "Aufladung",\<br />
"WW-Haupttemperatur" => "Haupttemperatur",\<br />
"WW-Isttemperatur" => "Isttemperatur",\<br />
"WW-Solltemperatur" => "Solltemperatur",\<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirklationspumpe Zeitsteuerung aktiv",\<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",\<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",\<br />
"WW-aktiv" => "aktiv",\<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",\<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"\<br />
\<br />
}<br><br />
attr vitoconnect_rg nostate 1<br><br />
attr vitoconnect_rg notime 1<br><br />
attr vitoconnect_rg room Heizung<br><br />
attr vitoconnect_rg sortby 1<br><br />
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }<br><br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br />
}\<br><br />
<br />
attr vitoconnect_rg valueSuffix {\<br />
Aussentemperatur => "°C", \<br />
\<br />
Brenner_Beriebsstunden => "h",\<br />
Brenner_Modulation => "%",\<br />
\<br />
Gasverbrauch_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_letztes_Jahr => "kWh",\<br />
Gasverbrauch_aktueller_Monat => "kWh",\<br />
Gasverbrauch_letzter_Monat => "kWh", \<br />
Gasverbrauch_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_letzte_Woche => "kWh",\<br />
Gasverbrauch_heute => "kWh", \<br />
Gasverbrauch_gestern => "kWh", \<br />
\<br />
Gasverbrauch_WW_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_WW_letztes_Jahr => "kWh",\<br />
Gasverbrauch_WW_aktueller_Monat => "kWh",\<br />
Gasverbrauch_WW_letzter_Monat => "kWh",\<br />
Gasverbrauch_WW_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_WW_letzte_Woche => "kWh",\<br />
Gasverbrauch_WW_heute => "kWh", \<br />
Gasverbrauch_WW_gestern => "kWh", \<br />
\<br />
'HK1-Solltemperatur_normal' => "°C",\<br />
'HK1-Solltemperatur_reduziert' => "°C",\<br />
'HK1-Vorlauftemperatur' => " °C",\<br />
\<br />
Kesseltemperatur => "°C",\<br />
Kesseltemperatur_exact => "°C",\<br />
\<br />
'WW-Solltemperatur' => " °C",\<br />
'WW-Isttemperatur' => " °C",\<br />
\<br />
'WW-Solltemperatur' => "°C"\<br />
}<br />
<br />
</code><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul 2.jpg|400px]]<br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
[[Datei:Gasverbräuche aus vitoconnect.jpg|400px]]<br />
<br />
==== weitere Graphen ====<br />
<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Datei:ReadingsGroup_f%C3%BCr_Vitoconnect_Modul_2.jpg&diff=29213
Datei:ReadingsGroup für Vitoconnect Modul 2.jpg
2019-01-24T20:29:39Z
<p>Andreas13: </p>
<hr />
<div>ReadingsGroup für Vitoconnect Modul 2</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29212
Vitoconnect
2019-01-24T20:26:06Z
<p>Andreas13: /* SVG Graphen */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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 waren die Werte für Heizung und WW bis Mitte Dezember noch nicht seperat!)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Woche",0))[1] },\<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Monat",0))[1] },\<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Jahr",0))[1] },\<br />
\<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br />
"Gasverbrauch_WW/Tag",0))[0] },\<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Tag",0))[1] },\<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Woche",0))[0] },\<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Woche",0))[1] },\<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Monat",0))[0] },\<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Monat",0))[1] },\<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Jahr",0))[0] },\<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Jahr",0))[1] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br />
<Brenner>\<br />
vitoconnect:Brenner_Beriebsstunden\<br />
vitoconnect:Brenner_Fehlercode\<br />
vitoconnect:Brenner_Modulation\<br />
vitoconnect:Brenner_Starts\<br />
vitoconnect:Brenner_Status\<br />
vitoconnect:Brenner_aktiv\<br />
<Gasverbrauch Heizung>\<br />
vitoconnect:Gasverbrauch_heute, vitoconnect:Gasverbrauch_gestern\<br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_letzte_Woche\<br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_letzter_Monat\<br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_letztes_Jahr\<br />
<Gasverbrauch Warmwasser>\<br />
vitoconnect:Gasverbrauch_WW_heute, vitoconnect:Gasverbrauch_WW_gestern\<br />
vitoconnect:Gasverbrauch_WW_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_WW_letzte_Woche\<br />
vitoconnect:Gasverbrauch_WW_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_WW_letzter_Monat\<br />
vitoconnect:Gasverbrauch_WW_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_WW_letztes_Jahr\<br />
<HK1>\<br />
vitoconnect:HK1-aktiv\<br />
vitoconnect:HK1-Betriebsart\<br />
\<br />
vitoconnect:HK1-Frostschutz_Status\<br />
\<br />
vitoconnect:HK1-Heizkurve-Niveau\<br />
vitoconnect:HK1-Heizkurve-Steigung\<br />
\<br />
vitoconnect:K1-Programmstatus\<br />
vitoconnect:HK1-Raum_Status\<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_aktiv\<br />
vitoconnect:HK1-Solltemperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_normal\<br />
vitoconnect:HK1-Solltemperatur_reduziert\<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br />
vitoconnect:HK1-Standby_aktiv\<br />
\<br />
vitoconnect:HK1-Urlaub_Ende\<br />
vitoconnect:HK1-Urlaub_Start\<br />
vitoconnect:HK1-Urlaub_aktiv\<br />
\<br />
vitoconnect:HK1-Vorlauftemperatur\<br />
\<br />
vitoconnect:HK1-WW_aktiv\<br />
vitoconnect:HK1-WW_und_Heizen_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv\<br />
vitoconnect:HK1-Zirkulationspumpe\<br />
<Kessel>\<br />
vitoconnect:Kesseltemperatur\<br />
vitoconnect:Kesseltemperatur_exact\<br />
<WW>\<br />
vitoconnect:WW-Aufladung\<br />
vitoconnect:WW-Haupttemperatur\<br />
vitoconnect:WW-Isttemperatur\<br />
vitoconnect:WW-Solltemperatur\<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv\<br />
vitoconnect:WW-Zirkulationspumpe_Status\<br />
vitoconnect:WW-Zirkulationspumpe_primaer\<br />
vitoconnect:WW-aktiv\<br />
vitoconnect:WW-onTimeCharge_aktiv\<br />
vitoconnect:WW-zeitgesteuert_aktiv\<br />
\<br />
<br />
attr vitoconnect_rg alias Heizung<br />
attr vitoconnect_rg cellStyle { \<br />
"c:0"=>'style="text-align:left"', \<br />
"c:1"=>'style="text-align:right"', \<br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'\<br />
\<br />
}<br />
attr vitoconnect_rg mapping {\<br />
"Aussentemperatur" => "Aussentemperatur",\<br />
\<br />
"Brenner_Beriebsstunden" => "Beriebsstunden",\<br />
"Brenner_Fehlercode" => "Fehlercode",\<br />
"Brenner_Modulation" => "Modulation",\<br />
"Brenner_Starts" => "Starts",\<br />
"Brenner_Status" => "Status",\<br />
"Brenner_aktiv" => "aktiv",\<br />
\<br />
"Gasverbrauch_heute" => "heute",\<br />
"Gasverbrauch_gestern" => "gestern",\<br />
"Gasverbrauch_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_letztes_Jahr" => "letztes Jahr",\<br />
"Gasverbrauch_WW_heute" => "heute",\<br />
"Gasverbrauch_WW_gestern" => "gestern",\<br />
"Gasverbrauch_WW_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_WW_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_WW_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_WW_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_WW_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_WW_letztes_Jahr" => "letztes Jahr",\<br />
\<br />
"HK1-aktiv" => "aktiv",\<br />
"HK1-Betriebsart" => "Betriebsart",\<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",\<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",\<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",\<br />
"HK1-Raum_Status" => "Raum Status",\<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",\<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",\<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",\<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",\<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",\<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",\<br />
"HK1-Standby_aktiv" => "Standby aktiv",\<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",\<br />
"HK1-Urlaub_Start" => "Urlaub Start",\<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",\<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",\<br />
"HK1-WW_aktiv" => "WW aktiv",\<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",\<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",\<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",\<br />
\<br />
"Kesseltemperatur" => "Kesseltemperatur",\<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",\<br />
\<br />
"WW-Aufladung" => "Aufladung",\<br />
"WW-Haupttemperatur" => "Haupttemperatur",\<br />
"WW-Isttemperatur" => "Isttemperatur",\<br />
"WW-Solltemperatur" => "Solltemperatur",\<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirklationspumpe Zeitsteuerung aktiv",\<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",\<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",\<br />
"WW-aktiv" => "aktiv",\<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",\<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"\<br />
\<br />
}<br />
attr vitoconnect_rg nostate 1<br />
attr vitoconnect_rg notime 1<br />
attr vitoconnect_rg room Heizung<br />
attr vitoconnect_rg sortby 1<br />
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br />
}\<br />
<br />
attr vitoconnect_rg valueSuffix {\<br />
Aussentemperatur => "°C", \<br />
\<br />
Brenner_Beriebsstunden => "h",\<br />
Brenner_Modulation => "%",\<br />
\<br />
Gasverbrauch_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_letztes_Jahr => "kWh",\<br />
Gasverbrauch_aktueller_Monat => "kWh",\<br />
Gasverbrauch_letzter_Monat => "kWh", \<br />
Gasverbrauch_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_letzte_Woche => "kWh",\<br />
Gasverbrauch_heute => "kWh", \<br />
Gasverbrauch_gestern => "kWh", \<br />
\<br />
Gasverbrauch_WW_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_WW_letztes_Jahr => "kWh",\<br />
Gasverbrauch_WW_aktueller_Monat => "kWh",\<br />
Gasverbrauch_WW_letzter_Monat => "kWh",\<br />
Gasverbrauch_WW_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_WW_letzte_Woche => "kWh",\<br />
Gasverbrauch_WW_heute => "kWh", \<br />
Gasverbrauch_WW_gestern => "kWh", \<br />
\<br />
'HK1-Solltemperatur_normal' => "°C",\<br />
'HK1-Solltemperatur_reduziert' => "°C",\<br />
'HK1-Vorlauftemperatur' => " °C",\<br />
\<br />
Kesseltemperatur => "°C",\<br />
Kesseltemperatur_exact => "°C",\<br />
\<br />
'WW-Solltemperatur' => " °C",\<br />
'WW-Isttemperatur' => " °C",\<br />
\<br />
'WW-Solltemperatur' => "°C"\<br />
}<br />
<br />
</code><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
[[Datei:Gasverbräuche aus vitoconnect.jpg|400px]]<br />
<br />
==== weitere Graphen ====<br />
<br />
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Datei:Beispiel_f%C3%BCr_Grafiken_aus_vitoconnect_Daten.jpg&diff=29211
Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg
2019-01-24T20:25:20Z
<p>Andreas13: </p>
<hr />
<div>Beispiel für Grafiken aus vitoconnect Daten</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Datei:Gasverbr%C3%A4uche_aus_vitoconnect.jpg&diff=29210
Datei:Gasverbräuche aus vitoconnect.jpg
2019-01-24T20:24:40Z
<p>Andreas13: </p>
<hr />
<div>Gasverbräuche aus vitoconnect</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29209
Vitoconnect
2019-01-24T20:21:38Z
<p>Andreas13: /* ReadingsGroup für eine kompakte Darstellung */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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 waren die Werte für Heizung und WW bis Mitte Dezember noch nicht seperat!)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Woche",0))[1] },\<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Monat",0))[1] },\<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Jahr",0))[1] },\<br />
\<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br />
"Gasverbrauch_WW/Tag",0))[0] },\<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Tag",0))[1] },\<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Woche",0))[0] },\<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Woche",0))[1] },\<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Monat",0))[0] },\<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Monat",0))[1] },\<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Jahr",0))[0] },\<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Jahr",0))[1] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br />
<Brenner>\<br />
vitoconnect:Brenner_Beriebsstunden\<br />
vitoconnect:Brenner_Fehlercode\<br />
vitoconnect:Brenner_Modulation\<br />
vitoconnect:Brenner_Starts\<br />
vitoconnect:Brenner_Status\<br />
vitoconnect:Brenner_aktiv\<br />
<Gasverbrauch Heizung>\<br />
vitoconnect:Gasverbrauch_heute, vitoconnect:Gasverbrauch_gestern\<br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_letzte_Woche\<br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_letzter_Monat\<br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_letztes_Jahr\<br />
<Gasverbrauch Warmwasser>\<br />
vitoconnect:Gasverbrauch_WW_heute, vitoconnect:Gasverbrauch_WW_gestern\<br />
vitoconnect:Gasverbrauch_WW_aktuelle_Woche\<br />
vitoconnect:Gasverbrauch_WW_letzte_Woche\<br />
vitoconnect:Gasverbrauch_WW_aktueller_Monat\<br />
vitoconnect:Gasverbrauch_WW_letzter_Monat\<br />
vitoconnect:Gasverbrauch_WW_aktuelles_Jahr\<br />
vitoconnect:Gasverbrauch_WW_letztes_Jahr\<br />
<HK1>\<br />
vitoconnect:HK1-aktiv\<br />
vitoconnect:HK1-Betriebsart\<br />
\<br />
vitoconnect:HK1-Frostschutz_Status\<br />
\<br />
vitoconnect:HK1-Heizkurve-Niveau\<br />
vitoconnect:HK1-Heizkurve-Steigung\<br />
\<br />
vitoconnect:K1-Programmstatus\<br />
vitoconnect:HK1-Raum_Status\<br />
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_aktiv\<br />
vitoconnect:HK1-Solltemperatur_erzwungen\<br />
vitoconnect:HK1-Solltemperatur_normal\<br />
vitoconnect:HK1-Solltemperatur_reduziert\<br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br />
vitoconnect:HK1-Standby_aktiv\<br />
\<br />
vitoconnect:HK1-Urlaub_Ende\<br />
vitoconnect:HK1-Urlaub_Start\<br />
vitoconnect:HK1-Urlaub_aktiv\<br />
\<br />
vitoconnect:HK1-Vorlauftemperatur\<br />
\<br />
vitoconnect:HK1-WW_aktiv\<br />
vitoconnect:HK1-WW_und_Heizen_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv\<br />
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv\<br />
vitoconnect:HK1-Zirkulationspumpe\<br />
<Kessel>\<br />
vitoconnect:Kesseltemperatur\<br />
vitoconnect:Kesseltemperatur_exact\<br />
<WW>\<br />
vitoconnect:WW-Aufladung\<br />
vitoconnect:WW-Haupttemperatur\<br />
vitoconnect:WW-Isttemperatur\<br />
vitoconnect:WW-Solltemperatur\<br />
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv\<br />
vitoconnect:WW-Zirkulationspumpe_Status\<br />
vitoconnect:WW-Zirkulationspumpe_primaer\<br />
vitoconnect:WW-aktiv\<br />
vitoconnect:WW-onTimeCharge_aktiv\<br />
vitoconnect:WW-zeitgesteuert_aktiv\<br />
\<br />
<br />
attr vitoconnect_rg alias Heizung<br />
attr vitoconnect_rg cellStyle { \<br />
"c:0"=>'style="text-align:left"', \<br />
"c:1"=>'style="text-align:right"', \<br />
"r:2"=>'style="text-align:right;;;;font-weight:bold"'\<br />
\<br />
}<br />
attr vitoconnect_rg mapping {\<br />
"Aussentemperatur" => "Aussentemperatur",\<br />
\<br />
"Brenner_Beriebsstunden" => "Beriebsstunden",\<br />
"Brenner_Fehlercode" => "Fehlercode",\<br />
"Brenner_Modulation" => "Modulation",\<br />
"Brenner_Starts" => "Starts",\<br />
"Brenner_Status" => "Status",\<br />
"Brenner_aktiv" => "aktiv",\<br />
\<br />
"Gasverbrauch_heute" => "heute",\<br />
"Gasverbrauch_gestern" => "gestern",\<br />
"Gasverbrauch_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_letztes_Jahr" => "letztes Jahr",\<br />
"Gasverbrauch_WW_heute" => "heute",\<br />
"Gasverbrauch_WW_gestern" => "gestern",\<br />
"Gasverbrauch_WW_aktuelle_Woche" => "aktuelle Woche",\<br />
"Gasverbrauch_WW_letzte_Woche" => "letzte Woche",\<br />
"Gasverbrauch_WW_aktueller_Monat" => "aktueller Monat",\<br />
"Gasverbrauch_WW_letzter_Monat" => "letzter Monat",\<br />
"Gasverbrauch_WW_aktuelles_Jahr" => "aktuelles Jahr",\<br />
"Gasverbrauch_WW_letztes_Jahr" => "letztes Jahr",\<br />
\<br />
"HK1-aktiv" => "aktiv",\<br />
"HK1-Betriebsart" => "Betriebsart",\<br />
"HK1-Frostschutz_Status" => "Frostschutz_Status",\<br />
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",\<br />
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",\<br />
"HK1-Raum_Status" => "Raum Status",\<br />
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",\<br />
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",\<br />
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",\<br />
"HK1-Solltemperatur_normal" => "Solltemperatur normal",\<br />
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",\<br />
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",\<br />
"HK1-Standby_aktiv" => "Standby aktiv",\<br />
"HK1-Urlaub_Ende" => "Urlaub Ende",\<br />
"HK1-Urlaub_Start" => "Urlaub Start",\<br />
"HK1-Urlaub_aktiv" => "Urlaub aktiv",\<br />
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",\<br />
"HK1-WW_aktiv" => "WW aktiv",\<br />
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",\<br />
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",\<br />
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",\<br />
\<br />
"Kesseltemperatur" => "Kesseltemperatur",\<br />
"Kesseltemperatur_exact" => "Kesseltemperatur exact",\<br />
\<br />
"WW-Aufladung" => "Aufladung",\<br />
"WW-Haupttemperatur" => "Haupttemperatur",\<br />
"WW-Isttemperatur" => "Isttemperatur",\<br />
"WW-Solltemperatur" => "Solltemperatur",\<br />
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirklationspumpe Zeitsteuerung aktiv",\<br />
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",\<br />
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",\<br />
"WW-aktiv" => "aktiv",\<br />
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",\<br />
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"\<br />
\<br />
}<br />
attr vitoconnect_rg nostate 1<br />
attr vitoconnect_rg notime 1<br />
attr vitoconnect_rg room Heizung<br />
attr vitoconnect_rg sortby 1<br />
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br />
}\<br />
<br />
attr vitoconnect_rg valueSuffix {\<br />
Aussentemperatur => "°C", \<br />
\<br />
Brenner_Beriebsstunden => "h",\<br />
Brenner_Modulation => "%",\<br />
\<br />
Gasverbrauch_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_letztes_Jahr => "kWh",\<br />
Gasverbrauch_aktueller_Monat => "kWh",\<br />
Gasverbrauch_letzter_Monat => "kWh", \<br />
Gasverbrauch_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_letzte_Woche => "kWh",\<br />
Gasverbrauch_heute => "kWh", \<br />
Gasverbrauch_gestern => "kWh", \<br />
\<br />
Gasverbrauch_WW_aktuelles_Jahr => "kWh",\<br />
Gasverbrauch_WW_letztes_Jahr => "kWh",\<br />
Gasverbrauch_WW_aktueller_Monat => "kWh",\<br />
Gasverbrauch_WW_letzter_Monat => "kWh",\<br />
Gasverbrauch_WW_aktuelle_Woche => "kWh",\<br />
Gasverbrauch_WW_letzte_Woche => "kWh",\<br />
Gasverbrauch_WW_heute => "kWh", \<br />
Gasverbrauch_WW_gestern => "kWh", \<br />
\<br />
'HK1-Solltemperatur_normal' => "°C",\<br />
'HK1-Solltemperatur_reduziert' => "°C",\<br />
'HK1-Vorlauftemperatur' => " °C",\<br />
\<br />
Kesseltemperatur => "°C",\<br />
Kesseltemperatur_exact => "°C",\<br />
\<br />
'WW-Solltemperatur' => " °C",\<br />
'WW-Isttemperatur' => " °C",\<br />
\<br />
'WW-Solltemperatur' => "°C"\<br />
}<br />
<br />
</code><br />
<br><br />
<br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29208
Vitoconnect
2019-01-24T20:15:21Z
<p>Andreas13: /* Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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 waren die Werte für Heizung und WW bis Mitte Dezember noch nicht seperat!)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br />
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Woche",0))[1] },\<br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br />
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Monat",0))[1] },\<br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br />
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_Heizung/Jahr",0))[1] },\<br />
\<br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br />
"Gasverbrauch_WW/Tag",0))[0] },\<br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Tag",0))[1] },\<br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Woche",0))[0] },\<br />
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Woche",0))[1] },\<br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Monat",0))[0] },\<br />
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Monat",0))[1] },\<br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Jahr",0))[0] },\<br />
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br />
"Gasverbrauch_WW/Jahr",0))[1] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br><br />
vitoconnect:Brenner_aktiv\<br><br />
vitoconnect:Gasverbrauch_heute\<br><br />
vitoconnect:Gasverbrauch_gestern\<br><br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br><br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br><br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br><br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br><br />
vitoconnect:Kesseltemperatur\<br><br />
vitoconnect:WW-Isttemperatur\<br><br />
vitoconnect:WW-Solltemperatur<br />
<br />
attr vitoconnect_rg alias Heizung<br />
<br />
attr vitoconnect_rg mapping $READING<br />
<br />
attr vitoconnect_rg nostate 1<br />
<br />
attr vitoconnect_rg notime 1<br />
<br />
attr vitoconnect_rg sortby 1<br />
<br />
<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br><br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br><br />
}<br />
<br />
attr vitoconnect_rg valueStyle style="text-align:right"<br />
<br />
attr vitoconnect_rg valueSuffix {\<br><br />
Aussentemperatur => "°C", \<br><br />
Kesseltemperatur => " °C",\<br><br />
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\<br><br />
'WW-Solltemperatur' => " °C",\<br><br />
'WW-Isttemperatur' => " °C",\<br><br />
Gasverbrauch_aktuelles_Jahr => " kWh",\<br><br />
Gasverbrauch_aktueller_Monat => " kWh", \<br><br />
Gasverbrauch_aktuelle_Woche => " kWh",\<br><br />
Gasverbrauch_heute => " kWh", \<br><br />
Gasverbrauch_gestern => " kWh", \<br><br />
'WW-Solltemperatur' => "°C"\<br><br />
}<br />
</code><br />
<br><br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29207
Vitoconnect
2019-01-24T20:03:11Z
<p>Andreas13: /* Get */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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 waren die Werte für Heizung und WW bis Mitte Dezember noch nicht seperat!)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
Derzeit gibt es keine "get"-Kommandos.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br><br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br><br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br><br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br><br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br><br />
\<br><br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_WW/Tag",0))[0] },\<br><br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Tag",0))[1] },\<br><br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Woche",0))[0] },\<br><br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Monat",0))[0] },\<br><br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Jahr",0))[0] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br><br />
vitoconnect:Brenner_aktiv\<br><br />
vitoconnect:Gasverbrauch_heute\<br><br />
vitoconnect:Gasverbrauch_gestern\<br><br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br><br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br><br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br><br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br><br />
vitoconnect:Kesseltemperatur\<br><br />
vitoconnect:WW-Isttemperatur\<br><br />
vitoconnect:WW-Solltemperatur<br />
<br />
attr vitoconnect_rg alias Heizung<br />
<br />
attr vitoconnect_rg mapping $READING<br />
<br />
attr vitoconnect_rg nostate 1<br />
<br />
attr vitoconnect_rg notime 1<br />
<br />
attr vitoconnect_rg sortby 1<br />
<br />
<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br><br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br><br />
}<br />
<br />
attr vitoconnect_rg valueStyle style="text-align:right"<br />
<br />
attr vitoconnect_rg valueSuffix {\<br><br />
Aussentemperatur => "°C", \<br><br />
Kesseltemperatur => " °C",\<br><br />
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\<br><br />
'WW-Solltemperatur' => " °C",\<br><br />
'WW-Isttemperatur' => " °C",\<br><br />
Gasverbrauch_aktuelles_Jahr => " kWh",\<br><br />
Gasverbrauch_aktueller_Monat => " kWh", \<br><br />
Gasverbrauch_aktuelle_Woche => " kWh",\<br><br />
Gasverbrauch_heute => " kWh", \<br><br />
Gasverbrauch_gestern => " kWh", \<br><br />
'WW-Solltemperatur' => "°C"\<br><br />
}<br />
</code><br />
<br><br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29206
Vitoconnect
2019-01-24T20:02:35Z
<p>Andreas13: /* Set Befehle */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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 waren die Werte für Heizung und WW bis Mitte Dezember noch nicht seperat!)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
Befehle für HK1 sind auch für HK2 und HK3 verfügbar. <br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br><br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br><br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br><br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br><br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br><br />
\<br><br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_WW/Tag",0))[0] },\<br><br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Tag",0))[1] },\<br><br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Woche",0))[0] },\<br><br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Monat",0))[0] },\<br><br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Jahr",0))[0] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br><br />
vitoconnect:Brenner_aktiv\<br><br />
vitoconnect:Gasverbrauch_heute\<br><br />
vitoconnect:Gasverbrauch_gestern\<br><br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br><br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br><br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br><br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br><br />
vitoconnect:Kesseltemperatur\<br><br />
vitoconnect:WW-Isttemperatur\<br><br />
vitoconnect:WW-Solltemperatur<br />
<br />
attr vitoconnect_rg alias Heizung<br />
<br />
attr vitoconnect_rg mapping $READING<br />
<br />
attr vitoconnect_rg nostate 1<br />
<br />
attr vitoconnect_rg notime 1<br />
<br />
attr vitoconnect_rg sortby 1<br />
<br />
<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br><br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br><br />
}<br />
<br />
attr vitoconnect_rg valueStyle style="text-align:right"<br />
<br />
attr vitoconnect_rg valueSuffix {\<br><br />
Aussentemperatur => "°C", \<br><br />
Kesseltemperatur => " °C",\<br><br />
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\<br><br />
'WW-Solltemperatur' => " °C",\<br><br />
'WW-Isttemperatur' => " °C",\<br><br />
Gasverbrauch_aktuelles_Jahr => " kWh",\<br><br />
Gasverbrauch_aktueller_Monat => " kWh", \<br><br />
Gasverbrauch_aktuelle_Woche => " kWh",\<br><br />
Gasverbrauch_heute => " kWh", \<br><br />
Gasverbrauch_gestern => " kWh", \<br><br />
'WW-Solltemperatur' => "°C"\<br><br />
}<br />
</code><br />
<br><br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29205
Vitoconnect
2019-01-24T20:01:22Z
<p>Andreas13: /* Set Befehle */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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 waren die Werte für Heizung und WW bis Mitte Dezember noch nicht seperat!)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
'''Benutzung der Set-Befehle auf eigenes Risiko!'''<br />
<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br><br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br><br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br><br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br><br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br><br />
\<br><br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_WW/Tag",0))[0] },\<br><br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Tag",0))[1] },\<br><br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Woche",0))[0] },\<br><br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Monat",0))[0] },\<br><br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Jahr",0))[0] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br><br />
vitoconnect:Brenner_aktiv\<br><br />
vitoconnect:Gasverbrauch_heute\<br><br />
vitoconnect:Gasverbrauch_gestern\<br><br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br><br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br><br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br><br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br><br />
vitoconnect:Kesseltemperatur\<br><br />
vitoconnect:WW-Isttemperatur\<br><br />
vitoconnect:WW-Solltemperatur<br />
<br />
attr vitoconnect_rg alias Heizung<br />
<br />
attr vitoconnect_rg mapping $READING<br />
<br />
attr vitoconnect_rg nostate 1<br />
<br />
attr vitoconnect_rg notime 1<br />
<br />
attr vitoconnect_rg sortby 1<br />
<br />
<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br><br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br><br />
}<br />
<br />
attr vitoconnect_rg valueStyle style="text-align:right"<br />
<br />
attr vitoconnect_rg valueSuffix {\<br><br />
Aussentemperatur => "°C", \<br><br />
Kesseltemperatur => " °C",\<br><br />
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\<br><br />
'WW-Solltemperatur' => " °C",\<br><br />
'WW-Isttemperatur' => " °C",\<br><br />
Gasverbrauch_aktuelles_Jahr => " kWh",\<br><br />
Gasverbrauch_aktueller_Monat => " kWh", \<br><br />
Gasverbrauch_aktuelle_Woche => " kWh",\<br><br />
Gasverbrauch_heute => " kWh", \<br><br />
Gasverbrauch_gestern => " kWh", \<br><br />
'WW-Solltemperatur' => "°C"\<br><br />
}<br />
</code><br />
<br><br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29204
Vitoconnect
2019-01-24T19:58:25Z
<p>Andreas13: /* Readings */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
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.<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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 waren die Werte für Heizung und WW bis Mitte Dezember noch nicht seperat!)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br><br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br><br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br><br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br><br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br><br />
\<br><br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_WW/Tag",0))[0] },\<br><br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Tag",0))[1] },\<br><br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Woche",0))[0] },\<br><br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Monat",0))[0] },\<br><br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Jahr",0))[0] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br><br />
vitoconnect:Brenner_aktiv\<br><br />
vitoconnect:Gasverbrauch_heute\<br><br />
vitoconnect:Gasverbrauch_gestern\<br><br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br><br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br><br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br><br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br><br />
vitoconnect:Kesseltemperatur\<br><br />
vitoconnect:WW-Isttemperatur\<br><br />
vitoconnect:WW-Solltemperatur<br />
<br />
attr vitoconnect_rg alias Heizung<br />
<br />
attr vitoconnect_rg mapping $READING<br />
<br />
attr vitoconnect_rg nostate 1<br />
<br />
attr vitoconnect_rg notime 1<br />
<br />
attr vitoconnect_rg sortby 1<br />
<br />
<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br><br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br><br />
}<br />
<br />
attr vitoconnect_rg valueStyle style="text-align:right"<br />
<br />
attr vitoconnect_rg valueSuffix {\<br><br />
Aussentemperatur => "°C", \<br><br />
Kesseltemperatur => " °C",\<br><br />
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\<br><br />
'WW-Solltemperatur' => " °C",\<br><br />
'WW-Isttemperatur' => " °C",\<br><br />
Gasverbrauch_aktuelles_Jahr => " kWh",\<br><br />
Gasverbrauch_aktueller_Monat => " kWh", \<br><br />
Gasverbrauch_aktuelle_Woche => " kWh",\<br><br />
Gasverbrauch_heute => " kWh", \<br><br />
Gasverbrauch_gestern => " kWh", \<br><br />
'WW-Solltemperatur' => "°C"\<br><br />
}<br />
</code><br />
<br><br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29203
Vitoconnect
2019-01-24T19:57:03Z
<p>Andreas13: /* Attribute */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
Die Readings werden so ausgegeben, wie sie von der API geliefert werden!<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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 waren die Werte für Heizung und WW bis Mitte Dezember noch nicht seperat!)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|disable|| 0,1 || ||disable updates<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|-<br />
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an<br />
|-<br />
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br><br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br><br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br><br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br><br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br><br />
\<br><br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_WW/Tag",0))[0] },\<br><br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Tag",0))[1] },\<br><br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Woche",0))[0] },\<br><br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Monat",0))[0] },\<br><br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Jahr",0))[0] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br><br />
vitoconnect:Brenner_aktiv\<br><br />
vitoconnect:Gasverbrauch_heute\<br><br />
vitoconnect:Gasverbrauch_gestern\<br><br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br><br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br><br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br><br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br><br />
vitoconnect:Kesseltemperatur\<br><br />
vitoconnect:WW-Isttemperatur\<br><br />
vitoconnect:WW-Solltemperatur<br />
<br />
attr vitoconnect_rg alias Heizung<br />
<br />
attr vitoconnect_rg mapping $READING<br />
<br />
attr vitoconnect_rg nostate 1<br />
<br />
attr vitoconnect_rg notime 1<br />
<br />
attr vitoconnect_rg sortby 1<br />
<br />
<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br><br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br><br />
}<br />
<br />
attr vitoconnect_rg valueStyle style="text-align:right"<br />
<br />
attr vitoconnect_rg valueSuffix {\<br><br />
Aussentemperatur => "°C", \<br><br />
Kesseltemperatur => " °C",\<br><br />
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\<br><br />
'WW-Solltemperatur' => " °C",\<br><br />
'WW-Isttemperatur' => " °C",\<br><br />
Gasverbrauch_aktuelles_Jahr => " kWh",\<br><br />
Gasverbrauch_aktueller_Monat => " kWh", \<br><br />
Gasverbrauch_aktuelle_Woche => " kWh",\<br><br />
Gasverbrauch_heute => " kWh", \<br><br />
Gasverbrauch_gestern => " kWh", \<br><br />
'WW-Solltemperatur' => "°C"\<br><br />
}<br />
</code><br />
<br><br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29202
Vitoconnect
2019-01-24T19:54:02Z
<p>Andreas13: /* Set Befehle */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
Die Readings werden so ausgegeben, wie sie von der API geliefert werden!<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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 waren die Werte für Heizung und WW bis Mitte Dezember noch nicht seperat!)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|-<br />
|clearReadings|| || clear all readings immeadiatlely <br />
|-<br />
|password <passwd>||String|| store password in key store<br />
|-<br />
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory<br />
|-<br />
| || || <br />
|-<br />
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve<br />
|-<br />
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve <br />
|-<br />
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature<br />
|-<br />
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur <br />
|-<br />
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature<br />
|-<br />
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time <br />
|-<br />
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time <br />
|-<br />
|HK1-Urlaub_unschedule|| || remove holiday start and end time <br />
|-<br />
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature <br />
|-<br />
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature <br />
|-<br />
| || || <br />
|-<br />
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water <br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Zeitplan <schedule>|| || not implemented <br />
|-<br />
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature <br />
|-<br />
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature <br />
|}<br />
<br />
== Get ==<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br><br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br><br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br><br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br><br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br><br />
\<br><br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_WW/Tag",0))[0] },\<br><br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Tag",0))[1] },\<br><br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Woche",0))[0] },\<br><br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Monat",0))[0] },\<br><br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Jahr",0))[0] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br><br />
vitoconnect:Brenner_aktiv\<br><br />
vitoconnect:Gasverbrauch_heute\<br><br />
vitoconnect:Gasverbrauch_gestern\<br><br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br><br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br><br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br><br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br><br />
vitoconnect:Kesseltemperatur\<br><br />
vitoconnect:WW-Isttemperatur\<br><br />
vitoconnect:WW-Solltemperatur<br />
<br />
attr vitoconnect_rg alias Heizung<br />
<br />
attr vitoconnect_rg mapping $READING<br />
<br />
attr vitoconnect_rg nostate 1<br />
<br />
attr vitoconnect_rg notime 1<br />
<br />
attr vitoconnect_rg sortby 1<br />
<br />
<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br><br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br><br />
}<br />
<br />
attr vitoconnect_rg valueStyle style="text-align:right"<br />
<br />
attr vitoconnect_rg valueSuffix {\<br><br />
Aussentemperatur => "°C", \<br><br />
Kesseltemperatur => " °C",\<br><br />
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\<br><br />
'WW-Solltemperatur' => " °C",\<br><br />
'WW-Isttemperatur' => " °C",\<br><br />
Gasverbrauch_aktuelles_Jahr => " kWh",\<br><br />
Gasverbrauch_aktueller_Monat => " kWh", \<br><br />
Gasverbrauch_aktuelle_Woche => " kWh",\<br><br />
Gasverbrauch_heute => " kWh", \<br><br />
Gasverbrauch_gestern => " kWh", \<br><br />
'WW-Solltemperatur' => "°C"\<br><br />
}<br />
</code><br />
<br><br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29201
Vitoconnect
2019-01-24T19:28:39Z
<p>Andreas13: /* Define des Devices */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
Die Readings werden so ausgegeben, wie sie von der API geliefert werden!<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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 waren die Werte für Heizung und WW bis Mitte Dezember noch nicht seperat!)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|}<br />
<br />
== Get ==<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br><br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br><br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br><br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br><br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br><br />
\<br><br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_WW/Tag",0))[0] },\<br><br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Tag",0))[1] },\<br><br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Woche",0))[0] },\<br><br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Monat",0))[0] },\<br><br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Jahr",0))[0] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br><br />
vitoconnect:Brenner_aktiv\<br><br />
vitoconnect:Gasverbrauch_heute\<br><br />
vitoconnect:Gasverbrauch_gestern\<br><br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br><br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br><br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br><br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br><br />
vitoconnect:Kesseltemperatur\<br><br />
vitoconnect:WW-Isttemperatur\<br><br />
vitoconnect:WW-Solltemperatur<br />
<br />
attr vitoconnect_rg alias Heizung<br />
<br />
attr vitoconnect_rg mapping $READING<br />
<br />
attr vitoconnect_rg nostate 1<br />
<br />
attr vitoconnect_rg notime 1<br />
<br />
attr vitoconnect_rg sortby 1<br />
<br />
<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br><br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br><br />
}<br />
<br />
attr vitoconnect_rg valueStyle style="text-align:right"<br />
<br />
attr vitoconnect_rg valueSuffix {\<br><br />
Aussentemperatur => "°C", \<br><br />
Kesseltemperatur => " °C",\<br><br />
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\<br><br />
'WW-Solltemperatur' => " °C",\<br><br />
'WW-Isttemperatur' => " °C",\<br><br />
Gasverbrauch_aktuelles_Jahr => " kWh",\<br><br />
Gasverbrauch_aktueller_Monat => " kWh", \<br><br />
Gasverbrauch_aktuelle_Woche => " kWh",\<br><br />
Gasverbrauch_heute => " kWh", \<br><br />
Gasverbrauch_gestern => " kWh", \<br><br />
'WW-Solltemperatur' => "°C"\<br><br />
}<br />
</code><br />
<br><br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29200
Vitoconnect
2019-01-24T19:28:26Z
<p>Andreas13: /* Define des Devices */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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 Beipiel:<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
Die Readings werden so ausgegeben, wie sie von der API geliefert werden!<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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 waren die Werte für Heizung und WW bis Mitte Dezember noch nicht seperat!)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|}<br />
<br />
== Get ==<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br><br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br><br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br><br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br><br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br><br />
\<br><br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_WW/Tag",0))[0] },\<br><br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Tag",0))[1] },\<br><br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Woche",0))[0] },\<br><br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Monat",0))[0] },\<br><br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Jahr",0))[0] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br><br />
vitoconnect:Brenner_aktiv\<br><br />
vitoconnect:Gasverbrauch_heute\<br><br />
vitoconnect:Gasverbrauch_gestern\<br><br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br><br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br><br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br><br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br><br />
vitoconnect:Kesseltemperatur\<br><br />
vitoconnect:WW-Isttemperatur\<br><br />
vitoconnect:WW-Solltemperatur<br />
<br />
attr vitoconnect_rg alias Heizung<br />
<br />
attr vitoconnect_rg mapping $READING<br />
<br />
attr vitoconnect_rg nostate 1<br />
<br />
attr vitoconnect_rg notime 1<br />
<br />
attr vitoconnect_rg sortby 1<br />
<br />
<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br><br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br><br />
}<br />
<br />
attr vitoconnect_rg valueStyle style="text-align:right"<br />
<br />
attr vitoconnect_rg valueSuffix {\<br><br />
Aussentemperatur => "°C", \<br><br />
Kesseltemperatur => " °C",\<br><br />
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\<br><br />
'WW-Solltemperatur' => " °C",\<br><br />
'WW-Isttemperatur' => " °C",\<br><br />
Gasverbrauch_aktuelles_Jahr => " kWh",\<br><br />
Gasverbrauch_aktueller_Monat => " kWh", \<br><br />
Gasverbrauch_aktuelle_Woche => " kWh",\<br><br />
Gasverbrauch_heute => " kWh", \<br><br />
Gasverbrauch_gestern => " kWh", \<br><br />
'WW-Solltemperatur' => "°C"\<br><br />
}<br />
</code><br />
<br><br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29199
Vitoconnect
2019-01-24T19:28:09Z
<p>Andreas13: /* Define des Devices */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
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.<br />
<br />
<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br><br />
<code>set vitoconnect password correctPassword 60</code><br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
Die Readings werden so ausgegeben, wie sie von der API geliefert werden!<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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 waren die Werte für Heizung und WW bis Mitte Dezember noch nicht seperat!)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|}<br />
<br />
== Get ==<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br><br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br><br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br><br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br><br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br><br />
\<br><br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_WW/Tag",0))[0] },\<br><br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Tag",0))[1] },\<br><br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Woche",0))[0] },\<br><br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Monat",0))[0] },\<br><br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Jahr",0))[0] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br><br />
vitoconnect:Brenner_aktiv\<br><br />
vitoconnect:Gasverbrauch_heute\<br><br />
vitoconnect:Gasverbrauch_gestern\<br><br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br><br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br><br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br><br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br><br />
vitoconnect:Kesseltemperatur\<br><br />
vitoconnect:WW-Isttemperatur\<br><br />
vitoconnect:WW-Solltemperatur<br />
<br />
attr vitoconnect_rg alias Heizung<br />
<br />
attr vitoconnect_rg mapping $READING<br />
<br />
attr vitoconnect_rg nostate 1<br />
<br />
attr vitoconnect_rg notime 1<br />
<br />
attr vitoconnect_rg sortby 1<br />
<br />
<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br><br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br><br />
}<br />
<br />
attr vitoconnect_rg valueStyle style="text-align:right"<br />
<br />
attr vitoconnect_rg valueSuffix {\<br><br />
Aussentemperatur => "°C", \<br><br />
Kesseltemperatur => " °C",\<br><br />
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\<br><br />
'WW-Solltemperatur' => " °C",\<br><br />
'WW-Isttemperatur' => " °C",\<br><br />
Gasverbrauch_aktuelles_Jahr => " kWh",\<br><br />
Gasverbrauch_aktueller_Monat => " kWh", \<br><br />
Gasverbrauch_aktuelle_Woche => " kWh",\<br><br />
Gasverbrauch_heute => " kWh", \<br><br />
Gasverbrauch_gestern => " kWh", \<br><br />
'WW-Solltemperatur' => "°C"\<br><br />
}<br />
</code><br />
<br><br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=29198
Vitoconnect
2019-01-24T19:24:56Z
<p>Andreas13: /* Vorbereitung */</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Viessmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
Die Readings werden so ausgegeben, wie sie von der API geliefert werden!<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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 waren die Werte für Heizung und WW bis Mitte Dezember noch nicht seperat!)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilienhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|}<br />
<br />
== Get ==<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br><br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br><br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br><br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br><br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br><br />
\<br><br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_WW/Tag",0))[0] },\<br><br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Tag",0))[1] },\<br><br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Woche",0))[0] },\<br><br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Monat",0))[0] },\<br><br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Jahr",0))[0] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br><br />
vitoconnect:Brenner_aktiv\<br><br />
vitoconnect:Gasverbrauch_heute\<br><br />
vitoconnect:Gasverbrauch_gestern\<br><br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br><br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br><br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br><br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br><br />
vitoconnect:Kesseltemperatur\<br><br />
vitoconnect:WW-Isttemperatur\<br><br />
vitoconnect:WW-Solltemperatur<br />
<br />
attr vitoconnect_rg alias Heizung<br />
<br />
attr vitoconnect_rg mapping $READING<br />
<br />
attr vitoconnect_rg nostate 1<br />
<br />
attr vitoconnect_rg notime 1<br />
<br />
attr vitoconnect_rg sortby 1<br />
<br />
<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br><br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br><br />
}<br />
<br />
attr vitoconnect_rg valueStyle style="text-align:right"<br />
<br />
attr vitoconnect_rg valueSuffix {\<br><br />
Aussentemperatur => "°C", \<br><br />
Kesseltemperatur => " °C",\<br><br />
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\<br><br />
'WW-Solltemperatur' => " °C",\<br><br />
'WW-Isttemperatur' => " °C",\<br><br />
Gasverbrauch_aktuelles_Jahr => " kWh",\<br><br />
Gasverbrauch_aktueller_Monat => " kWh", \<br><br />
Gasverbrauch_aktuelle_Woche => " kWh",\<br><br />
Gasverbrauch_heute => " kWh", \<br><br />
Gasverbrauch_gestern => " kWh", \<br><br />
'WW-Solltemperatur' => "°C"\<br><br />
}<br />
</code><br />
<br><br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=28791
Vitoconnect
2018-12-23T17:10:00Z
<p>Andreas13: </p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Vissmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Vissmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wem stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. <br />
<br />
Da man mit diesem Modul (noch) keine Werte der Heizung verändern kann, sollte die Benutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!<br />
<br />
Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Vissmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Datei 98_vitoconnect.pm aus dem ersten Posting des Threads {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} muss in das Modulverzeichnis von FHEM (z.B. /opt/fhem/FHEM) kopiert werden. Auf die richtigen Rechte achte und das Modul ggf. mit "reload 98_vitoconnect" laden.<br />
<br />
<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
Die Readings werden so ausgegeben, wie sie von der API geliefert werden!<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensonor angeschlossen?<br />
|-<br />
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensonor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensonor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Beriebsstunden|| 934.336944444444 ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Modulation|| 11 ||<br />
|-<br />
|Brenner_Starts|| 2717 ||<br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|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 waren die Werte für Heizung und WW bis Mitte Dezember noch nicht seperat!)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?<br />
|-<br />
|HK1-External_aktiv || 0 ||Raumsensor aktiv?<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || on, off ||Frostschutz Status <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau <br />
|-<br />
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung <br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus <br />
|-<br />
|HK1-Raum_Status || error ||Raumsensor?<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || 0,1||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Standby_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||Urlaubsabsenkung Ende<br />
|-<br />
|HK1-Urlaub_Start || ||Urlaubsabsenkung Start<br />
|-<br />
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || 81 ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || connected ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || 0,1 ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || 0,1 ||xxx<br />
|-<br />
| HK1-Zirkulationspumpe || on,off || xxx (neu seit 16.12.18?)<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
| Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Kesseltemperatur_exact|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|Mehrfamilenhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Intervall_Monate || 0 ||???<br />
|-<br />
|Service_Letzter || 1970-01-01T00:00:00.000Z ||???<br />
|-<br />
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||(wird seit 16.12.18 nicht mehr geliefert?)<br />
|-<br />
| || ||<br />
|-<br />
|WW-Aufladung|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Haupttemperatur|| || ??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Isttemperatur || 56 ||xxx<br />
|-<br />
|WW-Sensoren_Auslauf_Status|| error ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Solltemperatur || 53 ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || connected ||xxx<br />
|-<br />
|WW-Zeitplan || fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0, <br />
<br />
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,<br />
<br />
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30, ||xxx<br />
|-<br />
|WW-Zirklationspumpe_Zeitsteuerung_aktiv || ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Status|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_Zeitplan|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-Zirkulationspumpe_primaer|| ||??? (neu seit 16.12.18?)<br />
|-<br />
|WW-aktiv || 0,1 ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || 0,1 ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || 0,1 ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || 6057 || Anzahl API Aufrufe<br />
|-<br />
|state || ok, Login failure|| Status<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|}<br />
<br />
== Get ==<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|verbose|| 0,1,2,3,4,5 || ||Loglevel<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_Heizung/Tag",0))[0] },\<br><br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Tag",0))[1] },\<br><br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Woche",0))[0] },\<br><br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Monat",0))[0] },\<br><br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_Heizung/Jahr",0))[0] },\<br><br />
\<br><br />
Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", \<br><br />
"Gasverbrauch_WW/Tag",0))[0] },\<br><br />
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Tag",0))[1] },\<br><br />
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW_Woche.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Woche",0))[0] },\<br><br />
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Monat",0))[0] },\<br><br />
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect",\<br><br />
"Gasverbrauch_WW/Jahr",0))[0] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br><br />
vitoconnect:Brenner_aktiv\<br><br />
vitoconnect:Gasverbrauch_heute\<br><br />
vitoconnect:Gasverbrauch_gestern\<br><br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br><br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br><br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br><br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br><br />
vitoconnect:Kesseltemperatur\<br><br />
vitoconnect:WW-Isttemperatur\<br><br />
vitoconnect:WW-Solltemperatur<br />
<br />
attr vitoconnect_rg alias Heizung<br />
<br />
attr vitoconnect_rg mapping $READING<br />
<br />
attr vitoconnect_rg nostate 1<br />
<br />
attr vitoconnect_rg notime 1<br />
<br />
attr vitoconnect_rg sortby 1<br />
<br />
<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br><br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br><br />
}<br />
<br />
attr vitoconnect_rg valueStyle style="text-align:right"<br />
<br />
attr vitoconnect_rg valueSuffix {\<br><br />
Aussentemperatur => "°C", \<br><br />
Kesseltemperatur => " °C",\<br><br />
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\<br><br />
'WW-Solltemperatur' => " °C",\<br><br />
'WW-Isttemperatur' => " °C",\<br><br />
Gasverbrauch_aktuelles_Jahr => " kWh",\<br><br />
Gasverbrauch_aktueller_Monat => " kWh", \<br><br />
Gasverbrauch_aktuelle_Woche => " kWh",\<br><br />
Gasverbrauch_heute => " kWh", \<br><br />
Gasverbrauch_gestern => " kWh", \<br><br />
'WW-Solltemperatur' => "°C"\<br><br />
}<br />
</code><br />
<br><br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=28789
Vitoconnect
2018-12-23T12:50:56Z
<p>Andreas13: </p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Vissmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Vissmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wem stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Vissmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Datei 98_vitoconnect.pm aus dem ersten Posting des Threads {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} muss in das Modulverzeichnis von FHEM (z.B. /opt/fhem/FHEM) kopiert werden. Auf die richtigen Rechte achte und das Modul ggf. mit "reload 98_vitoconnect" laden.<br />
<br />
<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
Die Readings werden so ausgegeben, wie sie von der API geliefert werden!<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1<br />
|-<br />
| || ||<br />
|-<br />
|Aussen_Status || connected/notConnected ||Ist ein Außensensonor angeschlossen?<br />
|-<br />
|Aussen_StatusWired || connected/notConnected ||Ist ein Außensensonor per Kabel angeschlossen?<br />
|-<br />
|Aussen_StatusWireless || connected/notConnected ||Ist ein kabelloser Außensensonor angeschlossen?<br />
|-<br />
|Aussentemperatur || 2.4 ||Außentemperatur in °C<br />
|-<br />
| || ||<br />
|-<br />
|Brenner_Fehlercode || 0 || Brenner Fehlercode <br />
|-<br />
|Brenner_Status || ok ||Brenner Status <br />
|-<br />
|Brenner_aktiv || 0,1|| Brenneraktiv <br />
|-<br />
| || ||<br />
|-<br />
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer <br />
|-<br />
|Device_Time_Offset || 61 || ???<br />
|-<br />
|Fehlereinträge_Historie ||ErrorListChanges||???<br />
|-<br />
|Fehlereinträge_aktive ||ErrorListChanges ||???<br />
|-<br />
| || ||<br />
|-<br />
|Gasverbrauch_Heizung/Jahr || 3293,0,0 ||Liste der jährlichen Gasverbräuche Heizung in kWH (aktuelles Jahr und die letzten beiden)<br />
|-<br />
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|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)<br />
|-<br />
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,<br />
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,<br />
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 <br />
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH<br />
|-<br />
|Gasverbrauch_WW/Jahr || || Liste der jährlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
|Gasverbrauch_WW/Woche || ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Betriebsart ||standby<br />
dwh<br />
<br />
dhwAndHeating<br />
<br />
forcedReduced<br />
<br />
forcedNormal<br />
||Aus<br />
<br />
Nur Warmwasser aktiv <br />
<br />
Heizung und Warmwasser aktiv <br />
<br />
Dauernd Reduziert<br />
<br />
Dauernd Tagbetrieb <br />
|-<br />
| || ||<br />
|-<br />
|HK1-External_Temperatur || ||xxx<br />
|-<br />
|HK1-External_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Frostschutz_Status || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Heizkurve-Niveau || ||xxx<br />
|-<br />
|HK1-Heizkurve-Steigung || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Programmstatus || ||xxx<br />
|-<br />
|HK1-Raum_Status || ||xxx<br />
|-<br />
|HK1-Reduzierte_Temperatur_erzwungen || ||xxx<br />
|-<br />
|HK1-Solltemperatur_aktiv || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort || ||xxx<br />
|-<br />
|HK1-Solltemperatur_comfort_aktiv || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco || ||xxx<br />
|-<br />
|HK1-Solltemperatur_eco_aktiv || ||xxx<br />
|-<br />
|HK1-Solltemperatur_erzwungen || ||xxx<br />
|-<br />
|HK1-Solltemperatur_normal || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert || ||xxx<br />
|-<br />
|HK1-Solltemperatur_reduziert_aktiv || ||xxx<br />
|-<br />
|HK1-Standby_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Urlaub_Ende || ||xxx<br />
|-<br />
|HK1-Urlaub_Start || ||xxx<br />
|-<br />
|HK1-Urlaub_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-Vorlauftemperatur || ||xxx<br />
|-<br />
|HK1-Vorlauftemperatur_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|HK1-WW_aktiv || ||xxx<br />
|-<br />
|HK1-WW_und_Heizen_aktiv || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Heizung_aktiv || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation || ||xxx<br />
|-<br />
|HK1-Zeitsteuerung_Zirkulation_aktiv || ||xxx<br />
|-<br />
|HK1-aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|Kessel_Status || ||xxx<br />
|-<br />
|Kesseltemperatur || ||xxx<br />
|-<br />
|Mehrfamilenhaus_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|Service_Betriebsstunden_seit_letzten || ||xxx<br />
|-<br />
|Service_Intervall_Betriebsstunden || ||xxx<br />
|-<br />
|Service_Intervall_Monate || ||xxx<br />
|-<br />
|Service_Letzter || ||xxx<br />
|-<br />
|Service_Letzter_brennerbasiert || ||xxx<br />
|-<br />
|Service_Monate_aktiv_seit_letzten_Service || ||xxx<br />
|-<br />
|Service_fällig || ||xxx<br />
|-<br />
|Service_fällig_brennerbasiert || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|WW-Isttemperatur || ||xxx<br />
|-<br />
|WW-Solltemperatur || ||xxx<br />
|-<br />
|WW-Temperatur_aktiv || ||xxx<br />
|-<br />
|WW-Zeitplan || ||xxx<br />
|-<br />
|WW-aktiv || ||xxx<br />
|-<br />
|WW-onTimeCharge_aktiv || ||xxx<br />
|-<br />
|WW-zeitgesteuert_aktiv || ||xxx<br />
|-<br />
| || ||<br />
|-<br />
|counter || ||xxx<br />
|-<br />
|state || ||xxx<br />
|-<br />
<br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|update|| ||löst ein Update der Reading zwischen manuell aus<br />
|}<br />
<br />
== Get ==<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| || <br />
|}<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|xxx|| || ||xxx<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings<br><br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", <br />
"Gasverbrauch_Heizung/Tag",0))[0] },<br><br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",<br />
"Gasverbrauch_Heizung/Tag",0))[1] },<br><br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung_Woche.* { (split /,/, ReadingsVal("vitoconnect",<br />
"Gasverbrauch_Heizung/Woche",0))[0] },<br><br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",<br />
"Gasverbrauch_Heizung/Monat",0))[0] },<br><br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",<br />
"Gasverbrauch_Heizung/Jahr",0))[0] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br><br />
vitoconnect:Brenner_aktiv\<br><br />
vitoconnect:Gasverbrauch_heute\<br><br />
vitoconnect:Gasverbrauch_gestern\<br><br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br><br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br><br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br><br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br><br />
vitoconnect:Kesseltemperatur\<br><br />
vitoconnect:WW-Isttemperatur\<br><br />
vitoconnect:WW-Solltemperatur<br />
<br />
attr vitoconnect_rg alias Heizung<br />
<br />
attr vitoconnect_rg mapping $READING<br />
<br />
attr vitoconnect_rg nostate 1<br />
<br />
attr vitoconnect_rg notime 1<br />
<br />
attr vitoconnect_rg sortby 1<br />
<br />
<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br><br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br><br />
}<br />
<br />
attr vitoconnect_rg valueStyle style="text-align:right"<br />
<br />
attr vitoconnect_rg valueSuffix {\<br><br />
Aussentemperatur => "°C", \<br><br />
Kesseltemperatur => " °C",\<br><br />
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\<br><br />
'WW-Solltemperatur' => " °C",\<br><br />
'WW-Isttemperatur' => " °C",\<br><br />
Gasverbrauch_aktuelles_Jahr => " kWh",\<br><br />
Gasverbrauch_aktueller_Monat => " kWh", \<br><br />
Gasverbrauch_aktuelle_Woche => " kWh",\<br><br />
Gasverbrauch_heute => " kWh", \<br><br />
Gasverbrauch_gestern => " kWh", \<br><br />
'WW-Solltemperatur' => "°C"\<br><br />
}<br />
</code><br />
<br><br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=28786
Vitoconnect
2018-12-23T12:01:31Z
<p>Andreas13: Verweis auf das Modul Vitotronic 200 (Viessmann Heizungssteuerung) ergänzt</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Vissmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Vissmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Wem stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Vissmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Datei 98_vitoconnect.pm aus dem ersten Posting des Threads {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} muss in das Modulverzeichnis von FHEM (z.B. /opt/fhem/FHEM) kopiert werden. Auf die richtigen Rechte achte und das Modul ggf. mit "reload 98_vitoconnect" laden.<br />
<br />
<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|xxx || ||xxx <br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|xxx||on, off ||xxxx<br />
|}<br />
<br />
== Get ==<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| xxx||xxx<br />
|}<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|xxx|| || ||xxx<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings<br><br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", <br />
"Gasverbrauch_Heizung/Tag",0))[0] },<br><br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",<br />
"Gasverbrauch_Heizung/Tag",0))[1] },<br><br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung_Woche.* { (split /,/, ReadingsVal("vitoconnect",<br />
"Gasverbrauch_Heizung/Woche",0))[0] },<br><br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",<br />
"Gasverbrauch_Heizung/Monat",0))[0] },<br><br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",<br />
"Gasverbrauch_Heizung/Jahr",0))[0] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br><br />
vitoconnect:Brenner_aktiv\<br><br />
vitoconnect:Gasverbrauch_heute\<br><br />
vitoconnect:Gasverbrauch_gestern\<br><br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br><br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br><br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br><br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br><br />
vitoconnect:Kesseltemperatur\<br><br />
vitoconnect:WW-Isttemperatur\<br><br />
vitoconnect:WW-Solltemperatur<br />
<br />
attr vitoconnect_rg alias Heizung<br />
<br />
attr vitoconnect_rg mapping $READING<br />
<br />
attr vitoconnect_rg nostate 1<br />
<br />
attr vitoconnect_rg notime 1<br />
<br />
attr vitoconnect_rg sortby 1<br />
<br />
<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br><br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br><br />
}<br />
<br />
attr vitoconnect_rg valueStyle style="text-align:right"<br />
<br />
attr vitoconnect_rg valueSuffix {\<br><br />
Aussentemperatur => "°C", \<br><br />
Kesseltemperatur => " °C",\<br><br />
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\<br><br />
'WW-Solltemperatur' => " °C",\<br><br />
'WW-Isttemperatur' => " °C",\<br><br />
Gasverbrauch_aktuelles_Jahr => " kWh",\<br><br />
Gasverbrauch_aktueller_Monat => " kWh", \<br><br />
Gasverbrauch_aktuelle_Woche => " kWh",\<br><br />
Gasverbrauch_heute => " kWh", \<br><br />
Gasverbrauch_gestern => " kWh", \<br><br />
'WW-Solltemperatur' => "°C"\<br><br />
}<br />
</code><br />
<br><br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Vitoconnect&diff=28785
Vitoconnect
2018-12-23T11:57:12Z
<p>Andreas13: Die Seite wurde neu angelegt: „{{Baustelle}} {{Infobox Modul |ModPurpose=Steuerung von Vissmann Heizungen |ModCategory=Heizungssteuerung/Raumklima |ModType=x <!-- |ModCmdRef= ---- noch nicht…“</p>
<hr />
<div>{{Baustelle}}<br />
{{Infobox Modul<br />
|ModPurpose=Steuerung von Vissmann Heizungen<br />
|ModCategory=Heizungssteuerung/Raumklima<br />
|ModType=x<br />
<!-- |ModCmdRef= ---- noch nicht Teil von FHEM --><br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=98_vitoconnect.pm<br />
|ModOwner=andreas13}}<br />
<br />
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Vissmann Heizungsanlage. <br />
<br />
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. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.<br />
<br />
Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].<br />
<br />
{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung. Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}<br />
<br />
== Einrichtung ==<br />
<br />
=== Vorbereitung ===<br />
<br />
Zur Nutzung des Moduls muss vorhanden sein:<br />
* Eine aktuelle FHEM Installation <br />
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)<br />
* Ein Vissmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.<br />
* Die Datei 98_vitoconnect.pm aus dem ersten Posting des Threads {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} muss in das Modulverzeichnis von FHEM (z.B. /opt/fhem/FHEM) kopiert werden. Auf die richtigen Rechte achte und das Modul ggf. mit "reload 98_vitoconnect" laden.<br />
<br />
<br />
<br />
=== Define des Devices ===<br />
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code><br />
<br />
Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code><br />
<br />
User und Passwort sind das gleiche wie in der ViCare App.<br />
<br />
== Readings ==<br />
<br />
===Readings ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung <br />
|-<br />
|xxx || ||xxx <br />
|}<br />
<br />
== Settings ==<br />
<br />
===Set Befehle ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung <br />
|-<br />
|xxx||on, off ||xxxx<br />
|}<br />
<br />
== Get ==<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Beschreibung<br />
|-<br />
| xxx||xxx<br />
|}<br />
== Attribute ==<br />
<br />
===Attribute ===<br />
<br />
{|class="wikitable"<br />
|-<br />
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung<br />
|-<br />
|xxx|| || ||xxx<br />
|}<br />
<br />
== Hilfsmittel ==<br />
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===<br />
<code>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</code><br />
<br />
=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===<br />
<code>attr vitoconnect userReadings<br><br />
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", <br />
"Gasverbrauch_Heizung/Tag",0))[0] },<br><br />
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",<br />
"Gasverbrauch_Heizung/Tag",0))[1] },<br><br />
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung_Woche.* { (split /,/, ReadingsVal("vitoconnect",<br />
"Gasverbrauch_Heizung/Woche",0))[0] },<br><br />
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",<br />
"Gasverbrauch_Heizung/Monat",0))[0] },<br><br />
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",<br />
"Gasverbrauch_Heizung/Jahr",0))[0] }</code><br />
<br />
=== ReadingsGroup für eine kompakte Darstellung ===<br />
<br />
<code> defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\<br><br />
vitoconnect:Brenner_aktiv\<br><br />
vitoconnect:Gasverbrauch_heute\<br><br />
vitoconnect:Gasverbrauch_gestern\<br><br />
vitoconnect:Gasverbrauch_aktuelle_Woche\<br><br />
vitoconnect:Gasverbrauch_aktueller_Monat\<br><br />
vitoconnect:Gasverbrauch_aktuelles_Jahr\<br><br />
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\<br><br />
vitoconnect:Kesseltemperatur\<br><br />
vitoconnect:WW-Isttemperatur\<br><br />
vitoconnect:WW-Solltemperatur<br />
<br />
attr vitoconnect_rg alias Heizung<br />
<br />
attr vitoconnect_rg mapping $READING<br />
<br />
attr vitoconnect_rg nostate 1<br />
<br />
attr vitoconnect_rg notime 1<br />
<br />
attr vitoconnect_rg sortby 1<br />
<br />
<br />
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer', \<br><br />
'Brenner_aktiv.1' => 'icoHEIZUNG',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',\<br><br />
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'\<br><br />
}<br />
<br />
attr vitoconnect_rg valueStyle style="text-align:right"<br />
<br />
attr vitoconnect_rg valueSuffix {\<br><br />
Aussentemperatur => "°C", \<br><br />
Kesseltemperatur => " °C",\<br><br />
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\<br><br />
'WW-Solltemperatur' => " °C",\<br><br />
'WW-Isttemperatur' => " °C",\<br><br />
Gasverbrauch_aktuelles_Jahr => " kWh",\<br><br />
Gasverbrauch_aktueller_Monat => " kWh", \<br><br />
Gasverbrauch_aktuelle_Woche => " kWh",\<br><br />
Gasverbrauch_heute => " kWh", \<br><br />
Gasverbrauch_gestern => " kWh", \<br><br />
'WW-Solltemperatur' => "°C"\<br><br />
}<br />
</code><br />
<br><br />
[[Datei:ReadingsGroup für Vitoconnect Modul.jpg|400px]]<br><br />
<br />
=== SVG Graphen ===<br />
==== Gasverbrauch ====<br />
<br />
[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|400px]]<br />
<br />
== Weblinks ==<br />
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}<br />
<br />
[[Kategorie:Gerätemodul]] <br />
[[Kategorie:Heizungssteuerung]]</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Datei:SVG_Gasverbrauch_f%C3%BCr_vitoconnect_Modul.jpg&diff=28784
Datei:SVG Gasverbrauch für vitoconnect Modul.jpg
2018-12-23T11:55:31Z
<p>Andreas13: </p>
<hr />
<div>SVG Gasverbrauch für vitoconnect Modul</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=Datei:ReadingsGroup_f%C3%BCr_Vitoconnect_Modul.jpg&diff=28783
Datei:ReadingsGroup für Vitoconnect Modul.jpg
2018-12-23T11:42:51Z
<p>Andreas13: </p>
<hr />
<div>ReadingsGroup für Vitoconnect Modul</div>
Andreas13
http://wiki.fhem.de/w/index.php?title=WINCONNECT&diff=28763
WINCONNECT
2018-12-22T12:10:38Z
<p>Andreas13: Link zur Windows GUI aktualisiert</p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=Dieses Modul dient zur Steuerung eines Windows PCs<br />
|ModType=d<br />
|ModCmdRef=WINCONNECT<br />
|ModForumArea=Sonstiges<br />
|ModTechName=70_WINCONNECT.pm<br />
|ModOwner=michael.winkler <br />([https://forum.fhem.de/index.php/topic,59251.0.html Forum] / [https://mwinkler.jimdo.com/eigene-anwendungen/winconnect Homepage])<br />
}}<br />
<br />
[[WINCONNECT]] ist ein Modul mit welchem ein Windows PC gesteuert und Informationen angezeigt werden können. <br />
<br />
== Allgemeines ==<br />
<br />
=== Funktionsumfang ===<br />
Aktuell ist folgenden Funktionsumfang vorhanden:<br />
<br />
* check file_dir<br />
* checkservice<br />
* checkprocess<br />
* checkperformance<br />
* command<br />
* commandhide<br />
* Core Temp API Abfragen<br />
* Erkennung drucken<br />
* Erkennung Sound<br />
* FHEM CSRFTOKEN<br />
* FHEM SSL/HTTPS<br />
* FHEM Support Netbisoname und FQDN<br />
* get batterystate<br />
* get drive information<br />
* get powerstate<br />
* GUI update/autoupdate<br />
* GUI start minimized<br />
* GUI start with windows<br />
* Hardwareausrüstung<br />
* make picture (camera)<br />
* messagebox<br />
* microphone detection<br />
* Monitor on/off (Windows 10 hat beim off noch Probleme)<br />
* motion detect (camera)<br />
* notifymsg<br />
* play sound (ttsmsg/messagebox/make picture)<br />
* set/get Bildschirm Helligkeit (Notebook & Tablets)<br />
* set camera on/off (camera)<br />
* set/get/mute mastervolume<br />
* set powermode (shutdown/reboot/standby/hibernate)<br />
* showfile<br />
* Sprachsteuerung<sup>1</sup><br />
* Support button / collect support information<br />
* ttsmsg<br />
* VolumeUp,VolumeDown<br />
* WMI Abfragen / WMI Wizard<br />
<sup>1</sup> Windows muss Spracherkennung unterstützen (Keine Server Betriebsysteme)<br />
<br />
=== Voraussetzungen ===<br />
Damit diese Modul verwendet werden kann, muss auf dem entsprechenden Windows PC eine zusätzliche GUI laufen. Diese kann [https://gitlab.com/michael.winkler/winconnect hier] heruntergeladen werden. Zusätzlich bestehen für die GUI noch folgende Systemvoraussetzungen:<br />
* Microsoft .Net Framework 4.5<br />
* Firewall Port 8183 muss vom FHEM Server aus erreichbar sein<br />
<br />
=== Betriebssystem ===<br />
Folgende Betriebssysteme wurden schon erfolgreich damit betrieben:<br />
* Windows Server 2012 R2<br />
* Windows 10 (Aldi Tablet)<br />
* Windows 10 Pro (Surface Pro 2017)<br />
* Windows 10 Home<br />
* Windows RT 8.1 (Im Testmodus)<br />
<br />
== Grundkonfiguration ==<br />
<br />
=== Definition in FHEM ===<br />
<br />
Zum Anlegen des Windows PCs können folgende Definitionen verwendet werden:<br />
:<code>define <name> WINCONNECT 192.168.0.10</code><br />
<br />
Standardmäßig prüft der FHEM Server alle 45 Sekunden ob der Windows PC noch erreichbar ist. Dieser Intervall kann wie folgt, z.B. auf 60 Sekunden, geändert werden:<br />
:<code>define <name> WINCONNECT 192.168.0.10 60</code><br />
<br />
=== Installation Windows GUI ===<br />
siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/grundinstallation/<br />
<br />
== GUI Beschreibung ==<br />
siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/grundinstallation/<br />
<br />
== Weitere Konfiguration ==<br />
siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/konfiguration/<br />
<br />
== FHEM Device ==<br />
siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/fhem-device/<br />
<br />
== Probleme ==<br />
siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/support/<br />
siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/bekannte-bugs/</div>
Andreas13