FHEMWiki - Benutzerbeiträge [de]

Verbose

2019-11-14T20:07:02Z

Awe: Werte fett

{{SEITENTITEL:verbose}} 

{{Randnotiz|RNTyp=y|RNText=Modulentwickler finden relevante Informationen zur Umstellung von ''Log'' auf ''Log3'' in diesem {{Link2Forum|Topic=14341|LinkText=Forenthread}} zusammengestellt.}}

Das Attribut [[verbose]] ist ein [[Attribut#Globale_Attribute|globales Attribut]] und bestimmt den Umfang der ausgegebenen Meldungen. Es ersetzt das Attribut [[loglevel]], das nicht mehr verwendet werden sollte.

Das Attribut ''verbose'' existiert(e) auf Device-/Modul-Ebene und für die gesamte FHEM-Umgebung als Attribut des Objekts ''global''.

Mögliche Werte:

{|
|-
| '''0''' || || nur die wichtigsten Nachrichten (z.B. Server Start/Stop) werden ausgegeben
|-
| '''1''' || || zusätzlich werden Fehlermeldungen und unbekannte Pakete ausgegeben
|-
| '''2''' || || Meldungen über die wichtigsten Ereignisse oder Alarme
|-
| '''3''' || || gesendete Befehle werden protokolliert
|-
| '''4''' || || es wird protokolliert, was die einzelnen Geräte empfangen
|-
| '''5''' || || umfangreiche Meldungen, vor allem auch zur Fehlereingrenzung (und damit hauptsächlich für die jeweiligen Modulentwickler bestimmt)
|}

Ein größerer Wert führt also zu einer höheren Detailtiefe.

Für den '''Normalgebrauch''' wird Level 3 empfohlen.

Was im Endeffekt wirklich ausgegeben wird, liegt in der Hand des Entwicklers, der durch die Zuordnung einer Ausgabe zu einem Level bestimmt, ab welchem Level die Meldung erscheinen soll.

Sofern ein Modul das ''verbose'' Attribut auf Modulebene unterstützt, überschreibt ein eventuell angegebener Wert die Spezifikation auf globaler Ebene, d.h., nur das betreffende Modul schreibt mehr oder weniger Meldungen als durch den globalen Wert bestimmt ist.

== Links ==
* Beschreibung in der {{Link2CmdRef|Anker=verbose}} (EN) / {{Link2CmdRef|Lang=de|Anker=verbose}} (DE)

[[Kategorie:Attribut (allgemeingültig)]]
[[Kategorie:Logging]]

Verbose

2019-11-14T20:06:20Z

Awe: Wertetabelle für bessere Lesbarkeit

{{SEITENTITEL:verbose}} 

{{Randnotiz|RNTyp=y|RNText=Modulentwickler finden relevante Informationen zur Umstellung von ''Log'' auf ''Log3'' in diesem {{Link2Forum|Topic=14341|LinkText=Forenthread}} zusammengestellt.}}

Das Attribut [[verbose]] ist ein [[Attribut#Globale_Attribute|globales Attribut]] und bestimmt den Umfang der ausgegebenen Meldungen. Es ersetzt das Attribut [[loglevel]], das nicht mehr verwendet werden sollte.

Das Attribut ''verbose'' existiert(e) auf Device-/Modul-Ebene und für die gesamte FHEM-Umgebung als Attribut des Objekts ''global''.

Mögliche Werte:

{|
|-
| 0 || || nur die wichtigsten Nachrichten (z.B. Server Start/Stop) werden ausgegeben
|-
| 1 || || zusätzlich werden Fehlermeldungen und unbekannte Pakete ausgegeben
|-
| 2 || || Meldungen über die wichtigsten Ereignisse oder Alarme
|-
| 3 || || gesendete Befehle werden protokolliert
|-
| 4 || || es wird protokolliert, was die einzelnen Geräte empfangen
|-
| 5 || || umfangreiche Meldungen, vor allem auch zur Fehlereingrenzung (und damit hauptsächlich für die jeweiligen Modulentwickler bestimmt)
|}

Ein größerer Wert führt also zu einer höheren Detailtiefe.

Für den '''Normalgebrauch''' wird Level 3 empfohlen.

Was im Endeffekt wirklich ausgegeben wird, liegt in der Hand des Entwicklers, der durch die Zuordnung einer Ausgabe zu einem Level bestimmt, ab welchem Level die Meldung erscheinen soll.

Sofern ein Modul das ''verbose'' Attribut auf Modulebene unterstützt, überschreibt ein eventuell angegebener Wert die Spezifikation auf globaler Ebene, d.h., nur das betreffende Modul schreibt mehr oder weniger Meldungen als durch den globalen Wert bestimmt ist.

== Links ==
* Beschreibung in der {{Link2CmdRef|Anker=verbose}} (EN) / {{Link2CmdRef|Lang=de|Anker=verbose}} (DE)

[[Kategorie:Attribut (allgemeingültig)]]
[[Kategorie:Logging]]

Plots erzeugen

2019-11-10T12:36:29Z

Awe: Ergänzung: Link zu Vitoconnect

'''Plots erzeugen'''

== .gplot-Editor ==

FHEM verfügt über einen ".gplot-Editor" (auch als Ploteditor bezeichnet), um die .gplot-Datei zur Erstellung eines Plots menügeführt zu generieren. Ein manuelles Anlegen der .gplot-Datei ist für Spezialisten und normalerweise nicht notwendig. Der .gplot-Editor sollte für Standardfälle grundsätzlich verwendet werden.

Details zum .gplot-Editor können im Ankündigungshinweis im {{Link2Forum|Topic=11275|Message=75594|LinkText=FHEM-Forum}} nachgelesen werden.

Zur Einarbeitung in die Funktionsweise des .gplot-Editor existieren ausführliche, bebilderte Beispiele:

*Grundlegendes Beispiel zur Erzeugung von Plots:
:* [[Buderus_Web_Gateway#Mit_FileLog|Schrittweises Beispiel für Temperaturkurven]]

*Spezielle Erläuterungen/Hinweise zur Erzeugung von Plots mit Status:
:* [[EnOcean-STM-250-Fenster-Türkontakt#Türstatus in einem Plot darstellen|Schrittweises Beispiel bei Kontakten]],
:* [[EnOcean-D-452-FU-EBIM-Aktor-2fach#Aktorstatus_in_einem_Plot_darstellen|Schrittweises Beispiel zum Aktorstatus]]
:* {{Link2Forum|Topic=12945|Message=78887|LinkText=FHEM-Forum}}
:* {{Link2Forum|Topic=43563|Message=354955|LinkText=Plots mit mehr als 2 Status}}

Verhinderung von Perl-Warnungen bei LogFiles mit unterschiedlicher Spaltenanzahl in Log-Zeilen: {{Link2Forum|Topic=27835}}

<big>'''Achtung'''</big>:
{{Randnotiz|RNTyp=Info|RNText=Das in diesem Abschnitt "Achtung" beschriebene Problem ist seit dem FHEM-Update vom 06.04.2015 nicht mehr relevant. Der Befehl <code>copyGplotFile</code> ist seitdem nicht mehr notwendig, da FHEM ihn automatisch ausführt (Siehe {{Link2Forum|Topic=35764|Message=282728|LinkText=FHEM-Forum}}). }}
Verwenden Sie diesen Editor nicht, wenn das FHEM-Device bereits angelegt ist und Sie für dieses Device ein bestehendes, allgemeines gplot-File verwenden, das auch für andere Devices benutzt wird. Beim Abspeichern wird ein Filter im gplot-File gesetzt, das das gplot-File nur für genau dieses Device verwendbar macht.

Beispiel:

aus

#FileLog 4:::

wird

#FileLog 4:DS2423.energy_a\x3a::

in dem entsprechenden gplot-File.

Die anderen Devices, die evtl. dieses gplot-File verwenden, haben danach keine funktionierende Plot-Anzeige mehr. Bevor also etwas geändert wird, sollte mit

set weblink_irgendwas copyGplotFile

ein Duplikat angelegt werden, das ausschließlich für diesen Plot verwendet wird. Der Befehl kann unterhalb des ersten Kasten per Dropdown ausgewählt werden.

== Individuell / Manuell ==

'''Vorbemerkungen:'''

* FHEM bediente sich früher für die Erstellung der Plots des Programms ''Gnuplot'' [http://www.gnuplot.info/]. Hierbei reichen die "einfacheren" Funktionalitäten dieses Programms aus (''Gnuplot'' kann noch viel mehr).
* aktuelle FHEM-Versionen haben die Plot-Funktionen (angelehnt an die Plot-File-Syntax von Gnuplot) integriert.
* die Beispieldateien für die in FHEM integrierten Plots finden Sie in Ihrem FHEM-Programmordner unter ''www/gplot''.
* Angaben wie <SIZE>, <OUT>, <L1>, <IN> usw. im Plot-File sind Platzhalter bzw. Feldbezeichner für Fhem. Diese sind case-sensitive (Groß-/Kleinschreibung beachten).
* Weitere Möglichkeiten Plots anzupassen und zu ergänzen bietet das FHEM-Hilfsmodul [[LogProxy|logProxy]].

Ein Beispiel (''temp4hum4.gplot'') aus diesem Verzeichnis:
<syntaxhighlight lang="gnuplot" style="width:500px;">
# Attribute 'small' is useful for gnuplot/-scroll only,
# if plotsize is less than 800,400
#set terminal png transparent small size <SIZE> crop

set terminal png transparent size <SIZE> crop

set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set ytics nomirror
set y2tics
#set ytics
set title '<L1>'
set grid xtics y2tics

set y2label "Temperature in C"
set ylabel "Humidity (%)"

#FileLog 4:temperature:10:
#FileLog 4:humidity:50:

plot \
"< egrep 'temperature' <IN>"\
using 1:4 axes x1y2 title 'Measured temperature' with lines,\
"< egrep 'humidity' <IN>"\
using 1:4 axes x1y1 title 'Humidity (%)' with lines\
</syntaxhighlight>

Die Zeilen, die mit ''set'' beginnen, beeinflussen wesentlich das Erscheinungsbild und Aussehen Ihrer Plots (Achsenbeschriftungen, Skalen usw.). Dabei sollten Sie die Zeilen, die eine Angabe zwischen "<" und ">" enthalten, zunächst unverändert lassen. Weitere (ausführliche) Hinweise (zu Gnuplot!) finden Sie in einer [http://www.home.uni-osnabrueck.de/elsner/Skripte/gnuplot.pdf PDF-Datei]. Eingeschränktere, aber für die meisten Belange von FHEM ausreichende Infos finden Sie auf [http://www.aurbacher.net/gnuplot/gnuplot.html dieser Web-Seite].

=== Benutzung der Variablen ===
{| class="wikitable"
! Variable
! Nutzung in gplot-File
! Füllung mit inhalt in fhem.cfg
|-
| <TL>
| set title '<TL>'
| attr weblink title "Dies füllt den Platzhalter <TL>"
|-
| <L1>
| set xlabel '<L1>'
| attr weblink label "Dies füllt das Label <L1>"
|-
| <L2>
| set title '<L2>'
| attr weblink label "Dies füllt das Label <L1>"::"Dies füllt das Label <L2>"
|}

=== Welche Daten werden dargestellt ===

Die Zeilen

#FileLog 5::0:
#FileLog 14::0:

in einer gplot-Datei tragen zwar zu Beginn das Kommentarzeichen "#", jedoch handelt es sich durchaus nicht um solche. Vielmehr trifft man mit den Werten hinter ''FileLog'' Vorgaben, welche Werte wie von FHEM an ''gnuplot'' zwecks grafischer Darstellung übergeben werden.

Im o.a. Beispiel werden das 5. und das 14. Wertfeld (voneinander getrennt durch ein Leerzeichen (Blank)) an gnuplot weiter gegeben.

Eine dazu passende Log-Dateizeile könnte beispielsweise so aussehen

2013-11-14_17:32:00 2013-Nov-14 17:32:00 17.9 5.8 4.9 58 94 0.0 0.0 N 5.8 572.91 1015.200
----1. Feld-------- --2. Feld-- --3.---- -4.- -5. -6. 7. 8. -9. 10. 11 12 --13.- --14.---

^ ^
werden ausgewertet --| --|

Diese Parameter können auch als Attribut übergeben werden:

attr weblink plotfunction "FileLog 5::0:"

Anhand der Anmerkungen wird hoffentlich die Wirkungsweise deutlich. Zu den restlichen - optionalen - Parametern hinter ''FileLog'' wird zunächst auf die {{Link2CmdRef|Anker=FileLogget}} verwiesen.

=== Datum und Zeit ===

'''Anmerkungen / Hinweise:'''

FHEM erwartet das Datum '''und''' die Uhrzeit der Log-Dateieinträge '''zwingend''' an <ins>erster Stelle</ins> der Datenzeile und zwar im Format

<code>JJJJ-MM-TT_SS:mm:ss</code>

wobei

* JJJJ die 4-stellige Jahreszahl
* MM der 2-stellige Monat (ggfls. mit Vornull)
* TT der 2-stellige Tag (ggfls. mit Vornull)
* SS die 2-stellige Stunde (ggfls. mit Vornull)
* mm die 2-stellige Minute (ggfls. mit Vornull)
* ss die 2-stellige Sekunde (ggfls. mit Vornull)

bedeutet. Bitte beachten Sie auch die Stelle der Zeichen "-", "_" und ":". Stehen diese nicht an den angegebenen Stellen, wird die entsprechende Zeile beim Erzeugen des Plots nicht beachtet. Ggfls. wird gar kein Plot angezeigt.

Eine Änderung/Anpassung der *.gplot-Datei in der Zeile

set timefmt "..."

hat auf dieses Verhalten von FHEM '''keine''' Auswirkungen, sondern nur auf die Darstellung von Datum und Zeit durch ''Gnuplot'' .

Dazu ein Beispiel:

Mit

2013-11-14_17:32:00 2013-Nov-14 17:32:00 17.9 5.8 4.9 58 94 0.0 0.0 N 5.8 572.91 1015.200

kann FHEM etwas anfangen. Mit

20131114173200 2013-Nov-14 17:32:00 17.9 5.8 4.9 58 94 0.0 0.0 N 5.8 572.91 1015.200

oder

14.11.2013 17:32 2013-Nov-14 17:32:00 17.9 5.8 4.9 58 94 0.0 0.0 N 5.8 572.91 1015.200

dagegen nicht.

Im ersten Fehler-Beispiel fehlen die notwendigen Trennzeichen, im zweiten Fehler-Beispiel ist die Reihenfolge im Datum verkehrt, außerdem werden die falschen Trenner verwendet. Zudem fehlen die Sekunden.

=== Plot der letzten 24 Stunden statt des aktuellen Tages ===

Hierzu kann man in der ''Fhem.cfg'' für die Einträge

define WEB FHEMWEB 8083 global

das Attribut

attr WEB endPlotNow 1

setzen. Gleiches geht auch für ''WEBphone'' und ''WEBtablet''. Da muss es dann lauten

attr WEBphone endPlotNow 1

bzw.

attr WEBtablet endPlotNow 1

Das Attribut gilt dann aber für '''alle''' Plots der jeweiligen Ansichten. Wenn man wieder zurück zu den Plots ab jeweils 00:00 Uhr des aktuellen Tages möchte, löscht man dieses Attribut wieder bzw. setzt es auf den Wert "0".

=== Legende links platzieren ===

Gerade im Verbund mit dem Attribut ''endPlotNow'' macht das seit dem 11.01.2015 neue Attribut ''captionLeft'' Sinn, da dann die Legende nicht mehr rechts oben, sondern links oben im Plot erscheint. Dadurch wird die Sichtbarkeit der aktuellen Werte verbessert.

== Links / Beispiele ==
Hier finden sich weitere Beispiele zur Plot-Erstellung:
* [[Creating Plots]]
* [[Buderus Web Gateway#Beispiel für Plot]]
* [[Wetter und Wettervorhersagen#Erstellen passender gplot-Dateien]]
* [[Vitoconnect#SVG_Graphen_aus_FileLog_erstellen]]
* [http://lowrank.net/gnuplot/intro/style-e.html Erklärung für die Linetypes]

[[Kategorie:FAQ]]
[[Kategorie:HOWTOS]]

Vitoconnect

2019-11-05T16:54:57Z

Awe: define FileLog Parameter angepasst

{{SEITENTITEL:vitoconnect}}
{{Baustelle}}
{{Infobox Modul
|ModPurpose=Steuerung von Viessmann Heizungen
|ModCategory=Heizungssteuerung/Raumklima
|ModCmdRef=vitoconnect
|ModType=d
|ModForumArea=Heizungssteuerung/Raumklima
|ModTechName=98_vitoconnect.pm
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}

[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen.

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

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

Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].

{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung.

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!

Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}

== Einrichtung ==
=== Vorbereitung ===
Zur Nutzung des Moduls muss vorhanden sein:
* Eine aktuelle FHEM Installation
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.
* Das Modul benötigt mindestens folgende Perl Libraries: Path::Tiny, JSON und DateTime. Diese können mit sudo apt install libtypes-path-tiny-perl libjson-perl libdatetime-perl oder via cpan. Sollten Libraries fehlen erhält man folgende Fehlermeldung "cannot load module vitoconnect". Dann bitte ins Logfile schauen, welche Lib fehlt.

=== Define des Devices ===
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code>

Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code>

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

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

<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code> 
<code>set vitoconnect password correctPassword 60</code>
 
 
Nachträgliches Ändern des Intervalls: 
Man kann einfach das DEF aufrufen und dort die Parameter korrigieren (z.B. von 60 Sek. auf 180 Sek.) - dies gilt natürlich ebenso für nachträgliches Ändern des Usernamens oder Passwortes. 

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

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

|}

== Settings ==

===Set Befehle ===
'''Benutzung der Set-Befehle auf eigenes Risiko!'''

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

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

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

== Get ==

Derzeit gibt es keine "get"-Kommandos.

{|class="wikitable"
|-
! Name !! Beschreibung
|-
| ||
|}

== Attribute ==

===Attribute ===

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

== Hilfsmittel ==
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===
<syntaxhighlight lang="Perl">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</syntaxhighlight>

=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===
<syntaxhighlight lang="Perl">
attr vitoconnect userReadings
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },

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

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

</syntaxhighlight>

=== ReadingsGroup für eine kompakte Darstellung ===

<syntaxhighlight lang="perl" style="width:90%;">
defmod vitoconnect_rg readingsGroup
vitoconnect:Aussentemperatur
<Brenner>
vitoconnect:Brenner_Betriebsstunden
vitoconnect:Brenner_Fehlercode
vitoconnect:Brenner_Modulation
vitoconnect:Brenner_Starts
vitoconnect:Brenner_Status
vitoconnect:Brenner_aktiv
<HK1>
vitoconnect:HK1-aktiv
vitoconnect:HK1-Betriebsart

vitoconnect:HK1-Frostschutz_Status

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

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

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

vitoconnect:HK1-Vorlauftemperatur

vitoconnect:HK1-WW_aktiv
vitoconnect:HK1-WW_und_Heizen_aktiv

vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv

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

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

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

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

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

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

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

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

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

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

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

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

'WW-Solltemperatur' => "°C"
}
</syntaxhighlight>
 

[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]

=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===

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

attr Heizung_Verbrauch cellStyle {
"r:1"=>'style="text-align:left;;;;font-weight:bold"',
"c:1"=>'style="text-align:right;;;;font-weight:bold"'
}
attr Heizung_Verbrauch mapping  ;
attr Heizung_Verbrauch nostate 1
attr Heizung_Verbrauch room Heizung
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"
attr Heizung_Verbrauch valueFormat {
Gasverbrauch_heute => "%.0f kWh",
Gasverbrauch_WW_heute => "%.0f kWh",
Stromverbrauch_heute => "%.0f kWh",
Gasverbrauch_gestern => "%.0f kWh",
Gasverbrauch_WW_gestern => "%.0f kWh",
Stromverbrauch_gestern => "%.0f kWh",
Gasverbrauch_aktuelle_Woche => "%.0f kWh",
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",
Stromverbrauch_aktuelle_Woche => "%.0f kWh",
Gasverbrauch_letzte_Woche => "%.0f kWh",
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",
Stromverbrauch_letzte_Woche => "%.0f kWh",
Gasverbrauch_aktueller_Monat => "%.0f kWh",
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",
Stromverbrauch_aktueller_Monat => "%.0f kWh",
Gasverbrauch_letzter_Monat => "%.0f kWh",
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",
Stromverbrauch_letzter_Monat => "%.0f kWh",
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",
Gasverbrauch_letztes_Jahr => "%.0f kWh",
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",
Stromverbrauch_letztes_Jahr => "%.0f kWh"
}
</syntaxhighlight>
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]

=== SVG Graphen ===
==== Gas- und Stromverbrauch ====

[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]

[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]

 
==== weitere Graphen ====
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]
 
 

=== Speichern der wichtigsten Werte mittels FileLog und Erzeugung der entspr. SVG Plots ===
==== FileLog erstellen ====
Zunächst wird das FileLog mit ausgewählten Parametern erstellt. Dies ist die Voraussetzung für die SVG Plots.
<syntaxhighlight lang="Perl">
define FileLog_VitoConnect FileLog ./log/VitoConnect-%Y-%m.log vitoconnect:Aussentemperatur|vitoconnect:Brenner_Modulation|vitoconnect:Brenner_aktiv|vitoconnect:Gasverbrauch_Heizung/Jahr|vitoconnect:Gasverbrauch_aktuelle_Woche|vitoconnect:Gasverbrauch_aktueller_Monat|vitoconnect:Gasverbrauch_gestern|vitoconnect:Gasverbrauch_heute|vitoconnect:HK1-Betriebsart|vitoconnect:HK1-Frostschutz_Status|vitoconnect:HK1-Programmstatus|vitoconnect:HK1-Solltemperatur_aktiv|vitoconnect:HK1-Solltemperatur_normal|vitoconnect:HK1-Solltemperatur_reduziert|vitoconnect:HK1-Solltemperatur_reduziert_aktiv|vitoconnect:HK1-Vorlauftemperatur|vitoconnect:HK1-WW_aktiv|vitoconnect:HK1-WW_und_Heizen_aktiv|vitoconnect:HK1-Zirkulationspumpe|vitoconnect:Kessel_Common_Supply_Temperatur|vitoconnect:Kesseltemperatur_exact|vitoconnect:WW-Isttemperatur|vitoconnect:WW-Sensoren_Auslauf_Wert|vitoconnect:WW-Solltemperatur|vitoconnect:WW-Zirkulationspumpe_Status|vitoconnect:WW-zeitgesteuert_aktiv
attr FileLog_VitoConnect room Log
</syntaxhighlight>

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

===== SVG Plot für Heizkreis1 =====
Im folgenden Beispiel werden hier verschiedene Graphen für Heizkreis1 (HK1) genommen.
Einige der Logwerte speichern "on"- oder "off"-Werte, diese müssten beispielsweise mit der Formel <syntaxhighlight lang="Perl">$fld[3]=~"on"?1.5:0</syntaxhighlight> erst in Werte (on=1.5, off=0) gewandelt werden.
 
 
SVG Plot mit Plot Editor: 
[[Datei:SVG FileLog VitoConnect 1 HK1 Temps.png|800px]]
 
 
… mit dem entsprechenden Code: 
<syntaxhighlight lang="Perl">
defmod SVG_FileLog_VitoConnect_1 SVG FileLog_VitoConnect:SVG_FileLog_VitoConnect_1:CURRENT
attr SVG_FileLog_VitoConnect_1 room Heizung

setstate SVG_FileLog_VitoConnect_1 initialized
</syntaxhighlight>

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

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

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

===== SVG Plot für Warmwasser =====
Im folgenden Beispiel werden hier verschiedene Graphen für Warmwasser (WW) genommen.
Einige der Logwerte speichern "on"- oder "off"-Werte, diese müssten beispielsweise mit der Formel <syntaxhighlight lang="Perl">$fld[3]=~"on"?1.5:0</syntaxhighlight> erst in Werte (on=1.5, off=0) gewandelt werden.
 
 
SVG Plot mit Plot Editor: 
[[Datei:SVG FileLog VitoConnect 2 WW Temps.png|800px]]
 
 
… mit dem entsprechenden Code: 
<syntaxhighlight lang="Perl">
defmod SVG_FileLog_VitoConnect_2 SVG FileLog_VitoConnect:SVG_FileLog_VitoConnect_2:CURRENT
attr SVG_FileLog_VitoConnect_2 room Heizung

setstate SVG_FileLog_VitoConnect_2 initialized
</syntaxhighlight>

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

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

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

== Weblinks ==
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}

[[Kategorie:Heizungssteuerung]]

Vitoconnect

2019-11-05T16:50:54Z

Awe: Ergänzung: SVG Graphen aus FileLog am Beispiel Warmwasser (WW)

{{SEITENTITEL:vitoconnect}}
{{Baustelle}}
{{Infobox Modul
|ModPurpose=Steuerung von Viessmann Heizungen
|ModCategory=Heizungssteuerung/Raumklima
|ModCmdRef=vitoconnect
|ModType=d
|ModForumArea=Heizungssteuerung/Raumklima
|ModTechName=98_vitoconnect.pm
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}

[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen.

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

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

Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].

{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung.

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!

Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}

== Einrichtung ==
=== Vorbereitung ===
Zur Nutzung des Moduls muss vorhanden sein:
* Eine aktuelle FHEM Installation
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.
* Das Modul benötigt mindestens folgende Perl Libraries: Path::Tiny, JSON und DateTime. Diese können mit sudo apt install libtypes-path-tiny-perl libjson-perl libdatetime-perl oder via cpan. Sollten Libraries fehlen erhält man folgende Fehlermeldung "cannot load module vitoconnect". Dann bitte ins Logfile schauen, welche Lib fehlt.

=== Define des Devices ===
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code>

Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code>

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

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

<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code> 
<code>set vitoconnect password correctPassword 60</code>
 
 
Nachträgliches Ändern des Intervalls: 
Man kann einfach das DEF aufrufen und dort die Parameter korrigieren (z.B. von 60 Sek. auf 180 Sek.) - dies gilt natürlich ebenso für nachträgliches Ändern des Usernamens oder Passwortes. 

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

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

|}

== Settings ==

===Set Befehle ===
'''Benutzung der Set-Befehle auf eigenes Risiko!'''

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

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

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

== Get ==

Derzeit gibt es keine "get"-Kommandos.

{|class="wikitable"
|-
! Name !! Beschreibung
|-
| ||
|}

== Attribute ==

===Attribute ===

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

== Hilfsmittel ==
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===
<syntaxhighlight lang="Perl">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</syntaxhighlight>

=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===
<syntaxhighlight lang="Perl">
attr vitoconnect userReadings
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },

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

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

</syntaxhighlight>

=== ReadingsGroup für eine kompakte Darstellung ===

<syntaxhighlight lang="perl" style="width:90%;">
defmod vitoconnect_rg readingsGroup
vitoconnect:Aussentemperatur
<Brenner>
vitoconnect:Brenner_Betriebsstunden
vitoconnect:Brenner_Fehlercode
vitoconnect:Brenner_Modulation
vitoconnect:Brenner_Starts
vitoconnect:Brenner_Status
vitoconnect:Brenner_aktiv
<HK1>
vitoconnect:HK1-aktiv
vitoconnect:HK1-Betriebsart

vitoconnect:HK1-Frostschutz_Status

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

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

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

vitoconnect:HK1-Vorlauftemperatur

vitoconnect:HK1-WW_aktiv
vitoconnect:HK1-WW_und_Heizen_aktiv

vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv

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

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

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

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

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

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

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

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

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

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

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

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

'WW-Solltemperatur' => "°C"
}
</syntaxhighlight>
 

[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]

=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===

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

attr Heizung_Verbrauch cellStyle {
"r:1"=>'style="text-align:left;;;;font-weight:bold"',
"c:1"=>'style="text-align:right;;;;font-weight:bold"'
}
attr Heizung_Verbrauch mapping  ;
attr Heizung_Verbrauch nostate 1
attr Heizung_Verbrauch room Heizung
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"
attr Heizung_Verbrauch valueFormat {
Gasverbrauch_heute => "%.0f kWh",
Gasverbrauch_WW_heute => "%.0f kWh",
Stromverbrauch_heute => "%.0f kWh",
Gasverbrauch_gestern => "%.0f kWh",
Gasverbrauch_WW_gestern => "%.0f kWh",
Stromverbrauch_gestern => "%.0f kWh",
Gasverbrauch_aktuelle_Woche => "%.0f kWh",
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",
Stromverbrauch_aktuelle_Woche => "%.0f kWh",
Gasverbrauch_letzte_Woche => "%.0f kWh",
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",
Stromverbrauch_letzte_Woche => "%.0f kWh",
Gasverbrauch_aktueller_Monat => "%.0f kWh",
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",
Stromverbrauch_aktueller_Monat => "%.0f kWh",
Gasverbrauch_letzter_Monat => "%.0f kWh",
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",
Stromverbrauch_letzter_Monat => "%.0f kWh",
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",
Gasverbrauch_letztes_Jahr => "%.0f kWh",
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",
Stromverbrauch_letztes_Jahr => "%.0f kWh"
}
</syntaxhighlight>
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]

=== SVG Graphen ===
==== Gas- und Stromverbrauch ====

[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]

[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]

 
==== weitere Graphen ====
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]
 
 

=== Speichern der wichtigsten Werte mittels FileLog und Erzeugung der entspr. SVG Plots ===
==== FileLog erstellen ====
Zunächst wird das FileLog mit ausgewählten Parametern erstellt. Dies ist die Voraussetzung für die SVG Plots.
<syntaxhighlight lang="Perl">define FileLog_VitoConnect FileLog ./log/VitoConnect-%Y-%m.log vitoconnect:Brenner_Modulation|vitoconnect:Gasverbrauch_gestern|vitoconnect:Gasverbrauch_Heizung/Jahr|vitoconnect:Gasverbrauch_aktuelle_Woche|vitoconnect:Gasverbrauch_aktueller_Monat|vitoconnect:Gasverbrauch_heute|vitoconnect:WW-aktiv|vitoconnect:HK1-Frostschutz_Status|vitoconnect:HK1-WW_und_Heizen_aktiv|vitoconnect:HK1-WW_aktiv|vitoconnect:HK1-Betriebsart|vitoconnect:HK1-Programmstatus|vitoconnect:Aussentemperatur|vitoconnect:HK1-Solltemperatur_aktiv|vitoconnect:HK1-Solltemperatur_reduziert_aktiv|vitoconnect:HK1-Solltemperatur_normal|vitoconnect:HK1-Solltemperatur_reduziert|vitoconnect:Brenner_aktiv|vitoconnect:HK1-Vorlauftemperatur|vitoconnect:HK1-Zirkulationspumpe|vitoconnect:Kesseltemperatur_exact|vitoconnect:WW-Isttemperatur|vitoconnect:WW-Solltemperatur|vitoconnect:WW-Sensoren_Auslauf_Wert|vitoconnect:WW-Zirkulationspumpe_Status|vitoconnect:WW-Zirkulationspumpe_Zeitsteuerung_aktiv|vitoconnect:WW-Zirkulationspumpe_primaer</syntaxhighlight>

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

===== SVG Plot für Heizkreis1 =====
Im folgenden Beispiel werden hier verschiedene Graphen für Heizkreis1 (HK1) genommen.
Einige der Logwerte speichern "on"- oder "off"-Werte, diese müssten beispielsweise mit der Formel <syntaxhighlight lang="Perl">$fld[3]=~"on"?1.5:0</syntaxhighlight> erst in Werte (on=1.5, off=0) gewandelt werden.
 
 
SVG Plot mit Plot Editor: 
[[Datei:SVG FileLog VitoConnect 1 HK1 Temps.png|800px]]
 
 
… mit dem entsprechenden Code: 
<syntaxhighlight lang="Perl">
defmod SVG_FileLog_VitoConnect_1 SVG FileLog_VitoConnect:SVG_FileLog_VitoConnect_1:CURRENT
attr SVG_FileLog_VitoConnect_1 room Heizung

setstate SVG_FileLog_VitoConnect_1 initialized
</syntaxhighlight>

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

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

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

===== SVG Plot für Warmwasser =====
Im folgenden Beispiel werden hier verschiedene Graphen für Warmwasser (WW) genommen.
Einige der Logwerte speichern "on"- oder "off"-Werte, diese müssten beispielsweise mit der Formel <syntaxhighlight lang="Perl">$fld[3]=~"on"?1.5:0</syntaxhighlight> erst in Werte (on=1.5, off=0) gewandelt werden.
 
 
SVG Plot mit Plot Editor: 
[[Datei:SVG FileLog VitoConnect 2 WW Temps.png|800px]]
 
 
… mit dem entsprechenden Code: 
<syntaxhighlight lang="Perl">
defmod SVG_FileLog_VitoConnect_2 SVG FileLog_VitoConnect:SVG_FileLog_VitoConnect_2:CURRENT
attr SVG_FileLog_VitoConnect_2 room Heizung

setstate SVG_FileLog_VitoConnect_2 initialized
</syntaxhighlight>

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

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

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

== Weblinks ==
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}

[[Kategorie:Heizungssteuerung]]

Datei:SVG FileLog VitoConnect 2 WW Temps.png

2019-11-05T16:49:42Z

Awe:

VitoConnect mit Warmwasser Temperaturen

Vitoconnect

2019-11-04T20:58:12Z

Awe: Ergänzung: Nachträgliches Ändern des Intervalls

{{SEITENTITEL:vitoconnect}}
{{Baustelle}}
{{Infobox Modul
|ModPurpose=Steuerung von Viessmann Heizungen
|ModCategory=Heizungssteuerung/Raumklima
|ModCmdRef=vitoconnect
|ModType=d
|ModForumArea=Heizungssteuerung/Raumklima
|ModTechName=98_vitoconnect.pm
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}

[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen.

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

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

Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].

{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung.

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!

Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}

== Einrichtung ==
=== Vorbereitung ===
Zur Nutzung des Moduls muss vorhanden sein:
* Eine aktuelle FHEM Installation
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.
* Das Modul benötigt mindestens folgende Perl Libraries: Path::Tiny, JSON und DateTime. Diese können mit sudo apt install libtypes-path-tiny-perl libjson-perl libdatetime-perl oder via cpan. Sollten Libraries fehlen erhält man folgende Fehlermeldung "cannot load module vitoconnect". Dann bitte ins Logfile schauen, welche Lib fehlt.

=== Define des Devices ===
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code>

Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code>

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

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

<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code> 
<code>set vitoconnect password correctPassword 60</code>
 
 
Nachträgliches Ändern des Intervalls: 
Man kann einfach das DEF aufrufen und dort die Parameter korrigieren (z.B. von 60 Sek. auf 180 Sek.) - dies gilt natürlich ebenso für nachträgliches Ändern des Usernamens oder Passwortes. 

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

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

|}

== Settings ==

===Set Befehle ===
'''Benutzung der Set-Befehle auf eigenes Risiko!'''

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

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

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

== Get ==

Derzeit gibt es keine "get"-Kommandos.

{|class="wikitable"
|-
! Name !! Beschreibung
|-
| ||
|}

== Attribute ==

===Attribute ===

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

== Hilfsmittel ==
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===
<syntaxhighlight lang="Perl">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</syntaxhighlight>

=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===
<syntaxhighlight lang="Perl">
attr vitoconnect userReadings
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },

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

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

</syntaxhighlight>

=== ReadingsGroup für eine kompakte Darstellung ===

<syntaxhighlight lang="perl" style="width:90%;">
defmod vitoconnect_rg readingsGroup
vitoconnect:Aussentemperatur
<Brenner>
vitoconnect:Brenner_Betriebsstunden
vitoconnect:Brenner_Fehlercode
vitoconnect:Brenner_Modulation
vitoconnect:Brenner_Starts
vitoconnect:Brenner_Status
vitoconnect:Brenner_aktiv
<HK1>
vitoconnect:HK1-aktiv
vitoconnect:HK1-Betriebsart

vitoconnect:HK1-Frostschutz_Status

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

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

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

vitoconnect:HK1-Vorlauftemperatur

vitoconnect:HK1-WW_aktiv
vitoconnect:HK1-WW_und_Heizen_aktiv

vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv

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

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

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

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

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

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

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

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

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

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

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

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

'WW-Solltemperatur' => "°C"
}
</syntaxhighlight>
 

[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]

=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===

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

attr Heizung_Verbrauch cellStyle {
"r:1"=>'style="text-align:left;;;;font-weight:bold"',
"c:1"=>'style="text-align:right;;;;font-weight:bold"'
}
attr Heizung_Verbrauch mapping  ;
attr Heizung_Verbrauch nostate 1
attr Heizung_Verbrauch room Heizung
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"
attr Heizung_Verbrauch valueFormat {
Gasverbrauch_heute => "%.0f kWh",
Gasverbrauch_WW_heute => "%.0f kWh",
Stromverbrauch_heute => "%.0f kWh",
Gasverbrauch_gestern => "%.0f kWh",
Gasverbrauch_WW_gestern => "%.0f kWh",
Stromverbrauch_gestern => "%.0f kWh",
Gasverbrauch_aktuelle_Woche => "%.0f kWh",
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",
Stromverbrauch_aktuelle_Woche => "%.0f kWh",
Gasverbrauch_letzte_Woche => "%.0f kWh",
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",
Stromverbrauch_letzte_Woche => "%.0f kWh",
Gasverbrauch_aktueller_Monat => "%.0f kWh",
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",
Stromverbrauch_aktueller_Monat => "%.0f kWh",
Gasverbrauch_letzter_Monat => "%.0f kWh",
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",
Stromverbrauch_letzter_Monat => "%.0f kWh",
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",
Gasverbrauch_letztes_Jahr => "%.0f kWh",
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",
Stromverbrauch_letztes_Jahr => "%.0f kWh"
}
</syntaxhighlight>
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]

=== SVG Graphen ===
==== Gas- und Stromverbrauch ====

[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]

[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]

 
==== weitere Graphen ====
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]
 
 

=== Speichern der wichtigsten Werte mittels FileLog und Erzeugung der entspr. SVG Plots ===
==== FileLog erstellen ====
Zunächst wird das FileLog mit ausgewählten Parametern erstellt. Dies ist die Voraussetzung für die SVG Plots.
<syntaxhighlight lang="Perl">define FileLog_VitoConnect FileLog ./log/VitoConnect-%Y-%m.log vitoconnect:Brenner_Modulation|vitoconnect:Gasverbrauch_gestern|vitoconnect:Gasverbrauch_Heizung/Jahr|vitoconnect:Gasverbrauch_aktuelle_Woche|vitoconnect:Gasverbrauch_aktueller_Monat|vitoconnect:Gasverbrauch_heute|vitoconnect:WW-aktiv|vitoconnect:HK1-Frostschutz_Status|vitoconnect:HK1-WW_und_Heizen_aktiv|vitoconnect:HK1-WW_aktiv|vitoconnect:HK1-Betriebsart|vitoconnect:HK1-Programmstatus|vitoconnect:Aussentemperatur|vitoconnect:HK1-Solltemperatur_aktiv|vitoconnect:HK1-Solltemperatur_reduziert_aktiv|vitoconnect:HK1-Solltemperatur_normal|vitoconnect:HK1-Solltemperatur_reduziert|vitoconnect:Brenner_aktiv|vitoconnect:HK1-Vorlauftemperatur|vitoconnect:HK1-Zirkulationspumpe|vitoconnect:Kesseltemperatur_exact|vitoconnect:WW-Isttemperatur|vitoconnect:WW-Solltemperatur|vitoconnect:WW-Sensoren_Auslauf_Wert|vitoconnect:WW-Zirkulationspumpe_Status|vitoconnect:WW-Zirkulationspumpe_Zeitsteuerung_aktiv|vitoconnect:WW-Zirkulationspumpe_primaer</syntaxhighlight>

==== SVG Graphen aus FileLog erstellen ====
Nachdem das FileLog erstellt wurde, kann aus dem Log nun der Plot von ausgewählten Werten erstellt werden. 
Im Beispiel werden hier verschiedene Graphen für Heizkreis1 (HK1) genommen.
Einige der Logwerte speichern "on"- oder "off"-Werte, diese müssten beispielsweise mit der Formel <syntaxhighlight lang="Perl">$fld[3]=~"on"?1.5:0</syntaxhighlight> erst in Werte (on=1.5, off=0) gewandelt werden.
 
 
SVG Plot mit Plot Editor: 
[[Datei:SVG FileLog VitoConnect 1 HK1 Temps.png|800px]]
 
 
… mit dem entsprechenden Code: 
<syntaxhighlight lang="Perl">
defmod SVG_FileLog_VitoConnect_1 SVG FileLog_VitoConnect:SVG_FileLog_VitoConnect_1:CURRENT
attr SVG_FileLog_VitoConnect_1 room Heizung

setstate SVG_FileLog_VitoConnect_1 initialized
</syntaxhighlight>

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

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

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

== Weblinks ==
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}

[[Kategorie:Heizungssteuerung]]

Vitoconnect

2019-11-04T20:43:22Z

Awe: Ergänzung: SVG Graphen aus FileLog am Beispiel Heizkreis1

{{SEITENTITEL:vitoconnect}}
{{Baustelle}}
{{Infobox Modul
|ModPurpose=Steuerung von Viessmann Heizungen
|ModCategory=Heizungssteuerung/Raumklima
|ModCmdRef=vitoconnect
|ModType=d
|ModForumArea=Heizungssteuerung/Raumklima
|ModTechName=98_vitoconnect.pm
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}

[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen.

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

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

Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].

{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung.

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!

Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}

== Einrichtung ==
=== Vorbereitung ===
Zur Nutzung des Moduls muss vorhanden sein:
* Eine aktuelle FHEM Installation
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.
* Das Modul benötigt mindestens folgende Perl Libraries: Path::Tiny, JSON und DateTime. Diese können mit sudo apt install libtypes-path-tiny-perl libjson-perl libdatetime-perl oder via cpan. Sollten Libraries fehlen erhält man folgende Fehlermeldung "cannot load module vitoconnect". Dann bitte ins Logfile schauen, welche Lib fehlt.

=== Define des Devices ===
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code>

Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code>

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

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

<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code> 
<code>set vitoconnect password correctPassword 60</code>

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

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

|}

== Settings ==

===Set Befehle ===
'''Benutzung der Set-Befehle auf eigenes Risiko!'''

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

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

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

== Get ==

Derzeit gibt es keine "get"-Kommandos.

{|class="wikitable"
|-
! Name !! Beschreibung
|-
| ||
|}

== Attribute ==

===Attribute ===

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

== Hilfsmittel ==
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===
<syntaxhighlight lang="Perl">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</syntaxhighlight>

=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===
<syntaxhighlight lang="Perl">
attr vitoconnect userReadings
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },

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

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

</syntaxhighlight>

=== ReadingsGroup für eine kompakte Darstellung ===

<syntaxhighlight lang="perl" style="width:90%;">
defmod vitoconnect_rg readingsGroup
vitoconnect:Aussentemperatur
<Brenner>
vitoconnect:Brenner_Betriebsstunden
vitoconnect:Brenner_Fehlercode
vitoconnect:Brenner_Modulation
vitoconnect:Brenner_Starts
vitoconnect:Brenner_Status
vitoconnect:Brenner_aktiv
<HK1>
vitoconnect:HK1-aktiv
vitoconnect:HK1-Betriebsart

vitoconnect:HK1-Frostschutz_Status

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

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

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

vitoconnect:HK1-Vorlauftemperatur

vitoconnect:HK1-WW_aktiv
vitoconnect:HK1-WW_und_Heizen_aktiv

vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv

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

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

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

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

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

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

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

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

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

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

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

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

'WW-Solltemperatur' => "°C"
}
</syntaxhighlight>
 

[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]

=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===

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

attr Heizung_Verbrauch cellStyle {
"r:1"=>'style="text-align:left;;;;font-weight:bold"',
"c:1"=>'style="text-align:right;;;;font-weight:bold"'
}
attr Heizung_Verbrauch mapping  ;
attr Heizung_Verbrauch nostate 1
attr Heizung_Verbrauch room Heizung
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"
attr Heizung_Verbrauch valueFormat {
Gasverbrauch_heute => "%.0f kWh",
Gasverbrauch_WW_heute => "%.0f kWh",
Stromverbrauch_heute => "%.0f kWh",
Gasverbrauch_gestern => "%.0f kWh",
Gasverbrauch_WW_gestern => "%.0f kWh",
Stromverbrauch_gestern => "%.0f kWh",
Gasverbrauch_aktuelle_Woche => "%.0f kWh",
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",
Stromverbrauch_aktuelle_Woche => "%.0f kWh",
Gasverbrauch_letzte_Woche => "%.0f kWh",
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",
Stromverbrauch_letzte_Woche => "%.0f kWh",
Gasverbrauch_aktueller_Monat => "%.0f kWh",
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",
Stromverbrauch_aktueller_Monat => "%.0f kWh",
Gasverbrauch_letzter_Monat => "%.0f kWh",
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",
Stromverbrauch_letzter_Monat => "%.0f kWh",
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",
Gasverbrauch_letztes_Jahr => "%.0f kWh",
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",
Stromverbrauch_letztes_Jahr => "%.0f kWh"
}
</syntaxhighlight>
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]

=== SVG Graphen ===
==== Gas- und Stromverbrauch ====

[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]

[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]

 
==== weitere Graphen ====
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]
 
 

=== Speichern der wichtigsten Werte mittels FileLog und Erzeugung der entspr. SVG Plots ===
==== FileLog erstellen ====
Zunächst wird das FileLog mit ausgewählten Parametern erstellt. Dies ist die Voraussetzung für die SVG Plots.
<syntaxhighlight lang="Perl">define FileLog_VitoConnect FileLog ./log/VitoConnect-%Y-%m.log vitoconnect:Brenner_Modulation|vitoconnect:Gasverbrauch_gestern|vitoconnect:Gasverbrauch_Heizung/Jahr|vitoconnect:Gasverbrauch_aktuelle_Woche|vitoconnect:Gasverbrauch_aktueller_Monat|vitoconnect:Gasverbrauch_heute|vitoconnect:WW-aktiv|vitoconnect:HK1-Frostschutz_Status|vitoconnect:HK1-WW_und_Heizen_aktiv|vitoconnect:HK1-WW_aktiv|vitoconnect:HK1-Betriebsart|vitoconnect:HK1-Programmstatus|vitoconnect:Aussentemperatur|vitoconnect:HK1-Solltemperatur_aktiv|vitoconnect:HK1-Solltemperatur_reduziert_aktiv|vitoconnect:HK1-Solltemperatur_normal|vitoconnect:HK1-Solltemperatur_reduziert|vitoconnect:Brenner_aktiv|vitoconnect:HK1-Vorlauftemperatur|vitoconnect:HK1-Zirkulationspumpe|vitoconnect:Kesseltemperatur_exact|vitoconnect:WW-Isttemperatur|vitoconnect:WW-Solltemperatur|vitoconnect:WW-Sensoren_Auslauf_Wert|vitoconnect:WW-Zirkulationspumpe_Status|vitoconnect:WW-Zirkulationspumpe_Zeitsteuerung_aktiv|vitoconnect:WW-Zirkulationspumpe_primaer</syntaxhighlight>

==== SVG Graphen aus FileLog erstellen ====
Nachdem das FileLog erstellt wurde, kann aus dem Log nun der Plot von ausgewählten Werten erstellt werden. 
Im Beispiel werden hier verschiedene Graphen für Heizkreis1 (HK1) genommen.
Einige der Logwerte speichern "on"- oder "off"-Werte, diese müssten beispielsweise mit der Formel <syntaxhighlight lang="Perl">$fld[3]=~"on"?1.5:0</syntaxhighlight> erst in Werte (on=1.5, off=0) gewandelt werden.
 
 
SVG Plot mit Plot Editor: 
[[Datei:SVG FileLog VitoConnect 1 HK1 Temps.png|800px]]
 
 
… mit dem entsprechenden Code: 
<syntaxhighlight lang="Perl">
defmod SVG_FileLog_VitoConnect_1 SVG FileLog_VitoConnect:SVG_FileLog_VitoConnect_1:CURRENT
attr SVG_FileLog_VitoConnect_1 room Heizung

setstate SVG_FileLog_VitoConnect_1 initialized
</syntaxhighlight>

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

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

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

== Weblinks ==
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}

[[Kategorie:Heizungssteuerung]]

Datei:SVG FileLog VitoConnect 1 HK1 Temps.png

2019-11-04T20:27:53Z

Awe:

SVG Plot Generator mit Beispieldaten, konfiguriert für HK1 Darstellung

Datei:SVG FileLog VitoConnect 1.png

2019-11-04T20:21:54Z

Awe:

SVG Plot vom FileLog Heizkreis1, Beispieldaten, VitoConnect

Vitoconnect

2019-11-04T20:15:14Z

Awe: Ergänzung: Speichern mittels FileLog

{{SEITENTITEL:vitoconnect}}
{{Baustelle}}
{{Infobox Modul
|ModPurpose=Steuerung von Viessmann Heizungen
|ModCategory=Heizungssteuerung/Raumklima
|ModCmdRef=vitoconnect
|ModType=d
|ModForumArea=Heizungssteuerung/Raumklima
|ModTechName=98_vitoconnect.pm
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}

[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen.

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

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

Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].

{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung.

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!

Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}

== Einrichtung ==
=== Vorbereitung ===
Zur Nutzung des Moduls muss vorhanden sein:
* Eine aktuelle FHEM Installation
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.
* Das Modul benötigt mindestens folgende Perl Libraries: Path::Tiny, JSON und DateTime. Diese können mit sudo apt install libtypes-path-tiny-perl libjson-perl libdatetime-perl oder via cpan. Sollten Libraries fehlen erhält man folgende Fehlermeldung "cannot load module vitoconnect". Dann bitte ins Logfile schauen, welche Lib fehlt.

=== Define des Devices ===
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code>

Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code>

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

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

<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code> 
<code>set vitoconnect password correctPassword 60</code>

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

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

|}

== Settings ==

===Set Befehle ===
'''Benutzung der Set-Befehle auf eigenes Risiko!'''

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

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

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

== Get ==

Derzeit gibt es keine "get"-Kommandos.

{|class="wikitable"
|-
! Name !! Beschreibung
|-
| ||
|}

== Attribute ==

===Attribute ===

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

== Hilfsmittel ==
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===
<syntaxhighlight lang="Perl">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</syntaxhighlight>

=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===
<syntaxhighlight lang="Perl">
attr vitoconnect userReadings
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },

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

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

</syntaxhighlight>

=== ReadingsGroup für eine kompakte Darstellung ===

<syntaxhighlight lang="perl" style="width:90%;">
defmod vitoconnect_rg readingsGroup
vitoconnect:Aussentemperatur
<Brenner>
vitoconnect:Brenner_Betriebsstunden
vitoconnect:Brenner_Fehlercode
vitoconnect:Brenner_Modulation
vitoconnect:Brenner_Starts
vitoconnect:Brenner_Status
vitoconnect:Brenner_aktiv
<HK1>
vitoconnect:HK1-aktiv
vitoconnect:HK1-Betriebsart

vitoconnect:HK1-Frostschutz_Status

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

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

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

vitoconnect:HK1-Vorlauftemperatur

vitoconnect:HK1-WW_aktiv
vitoconnect:HK1-WW_und_Heizen_aktiv

vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv

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

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

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

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

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

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

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

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

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

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

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

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

'WW-Solltemperatur' => "°C"
}
</syntaxhighlight>
 

[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]

=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===

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

attr Heizung_Verbrauch cellStyle {
"r:1"=>'style="text-align:left;;;;font-weight:bold"',
"c:1"=>'style="text-align:right;;;;font-weight:bold"'
}
attr Heizung_Verbrauch mapping  ;
attr Heizung_Verbrauch nostate 1
attr Heizung_Verbrauch room Heizung
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"
attr Heizung_Verbrauch valueFormat {
Gasverbrauch_heute => "%.0f kWh",
Gasverbrauch_WW_heute => "%.0f kWh",
Stromverbrauch_heute => "%.0f kWh",
Gasverbrauch_gestern => "%.0f kWh",
Gasverbrauch_WW_gestern => "%.0f kWh",
Stromverbrauch_gestern => "%.0f kWh",
Gasverbrauch_aktuelle_Woche => "%.0f kWh",
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",
Stromverbrauch_aktuelle_Woche => "%.0f kWh",
Gasverbrauch_letzte_Woche => "%.0f kWh",
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",
Stromverbrauch_letzte_Woche => "%.0f kWh",
Gasverbrauch_aktueller_Monat => "%.0f kWh",
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",
Stromverbrauch_aktueller_Monat => "%.0f kWh",
Gasverbrauch_letzter_Monat => "%.0f kWh",
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",
Stromverbrauch_letzter_Monat => "%.0f kWh",
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",
Gasverbrauch_letztes_Jahr => "%.0f kWh",
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",
Stromverbrauch_letztes_Jahr => "%.0f kWh"
}
</syntaxhighlight>
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]

=== Speichern der wichtigsten Werte mittels FileLog ===
<syntaxhighlight lang="Perl">define FileLog_VitoConnect FileLog ./log/VitoConnect-%Y-%m.log vitoconnect:Brenner_Modulation|vitoconnect:Gasverbrauch_gestern|vitoconnect:Gasverbrauch_Heizung/Jahr|vitoconnect:Gasverbrauch_aktuelle_Woche|vitoconnect:Gasverbrauch_aktueller_Monat|vitoconnect:Gasverbrauch_heute|vitoconnect:WW-aktiv|vitoconnect:HK1-Frostschutz_Status|vitoconnect:HK1-WW_und_Heizen_aktiv|vitoconnect:HK1-WW_aktiv|vitoconnect:HK1-Betriebsart|vitoconnect:HK1-Programmstatus|vitoconnect:Aussentemperatur|vitoconnect:HK1-Solltemperatur_aktiv|vitoconnect:HK1-Solltemperatur_reduziert_aktiv|vitoconnect:HK1-Solltemperatur_normal|vitoconnect:HK1-Solltemperatur_reduziert|vitoconnect:Brenner_aktiv|vitoconnect:HK1-Vorlauftemperatur|vitoconnect:HK1-Zirkulationspumpe|vitoconnect:Kesseltemperatur_exact|vitoconnect:WW-Isttemperatur|vitoconnect:WW-Solltemperatur|vitoconnect:WW-Sensoren_Auslauf_Wert|vitoconnect:WW-Zirkulationspumpe_Status|vitoconnect:WW-Zirkulationspumpe_Zeitsteuerung_aktiv|vitoconnect:WW-Zirkulationspumpe_primaer</syntaxhighlight>

=== SVG Graphen ===
==== Gas- und Stromverbrauch ====

[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]
[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]

==== weitere Graphen ====
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]

== Weblinks ==
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}

[[Kategorie:Heizungssteuerung]]

Vitoconnect

2019-11-02T22:24:03Z

Awe: diverse '\'-Zeichen am Zeilenende vom Code entfernt ==> vereinfacht Copy&Paste für den user

{{SEITENTITEL:vitoconnect}}
{{Baustelle}}
{{Infobox Modul
|ModPurpose=Steuerung von Viessmann Heizungen
|ModCategory=Heizungssteuerung/Raumklima
|ModCmdRef=vitoconnect
|ModType=d
|ModForumArea=Heizungssteuerung/Raumklima
|ModTechName=98_vitoconnect.pm
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}

[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen.

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

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

Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].

{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung.

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!

Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}

== Einrichtung ==
=== Vorbereitung ===
Zur Nutzung des Moduls muss vorhanden sein:
* Eine aktuelle FHEM Installation
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.
* Das Modul benötigt mindestens folgende Perl Libraries: Path::Tiny, JSON und DateTime. Diese können mit sudo apt install libtypes-path-tiny-perl libjson-perl libdatetime-perl oder via cpan. Sollten Libraries fehlen erhält man folgende Fehlermeldung "cannot load module vitoconnect". Dann bitte ins Logfile schauen, welche Lib fehlt.

=== Define des Devices ===
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code>

Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code>

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

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

<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code> 
<code>set vitoconnect password correctPassword 60</code>

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

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

|}

== Settings ==

===Set Befehle ===
'''Benutzung der Set-Befehle auf eigenes Risiko!'''

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

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

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

== Get ==

Derzeit gibt es keine "get"-Kommandos.

{|class="wikitable"
|-
! Name !! Beschreibung
|-
| ||
|}

== Attribute ==

===Attribute ===

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

== Hilfsmittel ==
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===
<syntaxhighlight lang="Perl">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</syntaxhighlight>

=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===
<syntaxhighlight lang="Perl">
attr vitoconnect userReadings
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },

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

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

</syntaxhighlight>

=== ReadingsGroup für eine kompakte Darstellung ===

<syntaxhighlight lang="perl" style="width:90%;">
defmod vitoconnect_rg readingsGroup
vitoconnect:Aussentemperatur
<Brenner>
vitoconnect:Brenner_Betriebsstunden
vitoconnect:Brenner_Fehlercode
vitoconnect:Brenner_Modulation
vitoconnect:Brenner_Starts
vitoconnect:Brenner_Status
vitoconnect:Brenner_aktiv
<HK1>
vitoconnect:HK1-aktiv
vitoconnect:HK1-Betriebsart

vitoconnect:HK1-Frostschutz_Status

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

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

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

vitoconnect:HK1-Vorlauftemperatur

vitoconnect:HK1-WW_aktiv
vitoconnect:HK1-WW_und_Heizen_aktiv

vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv

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

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

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

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

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

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

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

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

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

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

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

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

'WW-Solltemperatur' => "°C"
}
</syntaxhighlight>
 

[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]

=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===

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

attr Heizung_Verbrauch cellStyle {
"r:1"=>'style="text-align:left;;;;font-weight:bold"',
"c:1"=>'style="text-align:right;;;;font-weight:bold"'
}
attr Heizung_Verbrauch mapping  ;
attr Heizung_Verbrauch nostate 1
attr Heizung_Verbrauch room Heizung
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"
attr Heizung_Verbrauch valueFormat {
Gasverbrauch_heute => "%.0f kWh",
Gasverbrauch_WW_heute => "%.0f kWh",
Stromverbrauch_heute => "%.0f kWh",
Gasverbrauch_gestern => "%.0f kWh",
Gasverbrauch_WW_gestern => "%.0f kWh",
Stromverbrauch_gestern => "%.0f kWh",
Gasverbrauch_aktuelle_Woche => "%.0f kWh",
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",
Stromverbrauch_aktuelle_Woche => "%.0f kWh",
Gasverbrauch_letzte_Woche => "%.0f kWh",
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",
Stromverbrauch_letzte_Woche => "%.0f kWh",
Gasverbrauch_aktueller_Monat => "%.0f kWh",
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",
Stromverbrauch_aktueller_Monat => "%.0f kWh",
Gasverbrauch_letzter_Monat => "%.0f kWh",
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",
Stromverbrauch_letzter_Monat => "%.0f kWh",
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",
Gasverbrauch_letztes_Jahr => "%.0f kWh",
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",
Stromverbrauch_letztes_Jahr => "%.0f kWh"
}
</syntaxhighlight>
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]

=== SVG Graphen ===
==== Gas- und Stromverbrauch ====

[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]
[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]

==== weitere Graphen ====
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]

== Weblinks ==
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}

[[Kategorie:Heizungssteuerung]]

Vitoconnect

2019-11-02T22:20:07Z

Awe: text align korrigiert (entspricht jetzt der Darstellung wie im Screenshot gezeigt)

{{SEITENTITEL:vitoconnect}}
{{Baustelle}}
{{Infobox Modul
|ModPurpose=Steuerung von Viessmann Heizungen
|ModCategory=Heizungssteuerung/Raumklima
|ModCmdRef=vitoconnect
|ModType=d
|ModForumArea=Heizungssteuerung/Raumklima
|ModTechName=98_vitoconnect.pm
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}

[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen.

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

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

Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].

{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung.

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!

Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}

== Einrichtung ==
=== Vorbereitung ===
Zur Nutzung des Moduls muss vorhanden sein:
* Eine aktuelle FHEM Installation
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.
* Das Modul benötigt mindestens folgende Perl Libraries: Path::Tiny, JSON und DateTime. Diese können mit sudo apt install libtypes-path-tiny-perl libjson-perl libdatetime-perl oder via cpan. Sollten Libraries fehlen erhält man folgende Fehlermeldung "cannot load module vitoconnect". Dann bitte ins Logfile schauen, welche Lib fehlt.

=== Define des Devices ===
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code>

Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code>

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

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

<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code> 
<code>set vitoconnect password correctPassword 60</code>

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

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

|}

== Settings ==

===Set Befehle ===
'''Benutzung der Set-Befehle auf eigenes Risiko!'''

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

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

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

== Get ==

Derzeit gibt es keine "get"-Kommandos.

{|class="wikitable"
|-
! Name !! Beschreibung
|-
| ||
|}

== Attribute ==

===Attribute ===

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

== Hilfsmittel ==
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===
<syntaxhighlight lang="Perl">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</syntaxhighlight>

=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===
<syntaxhighlight lang="Perl">
attr vitoconnect userReadings
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },

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

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

</syntaxhighlight>

=== ReadingsGroup für eine kompakte Darstellung ===

<syntaxhighlight lang="perl" style="width:90%;">
defmod vitoconnect_rg readingsGroup
vitoconnect:Aussentemperatur
<Brenner>
vitoconnect:Brenner_Betriebsstunden
vitoconnect:Brenner_Fehlercode
vitoconnect:Brenner_Modulation
vitoconnect:Brenner_Starts
vitoconnect:Brenner_Status
vitoconnect:Brenner_aktiv
<HK1>
vitoconnect:HK1-aktiv
vitoconnect:HK1-Betriebsart

vitoconnect:HK1-Frostschutz_Status

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

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

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

vitoconnect:HK1-Vorlauftemperatur

vitoconnect:HK1-WW_aktiv
vitoconnect:HK1-WW_und_Heizen_aktiv

vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv

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

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

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

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

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

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

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

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

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

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

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

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

'WW-Solltemperatur' => "°C"
}
</syntaxhighlight>
 

[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]

=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===

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

attr Heizung_Verbrauch cellStyle { \
"r:1"=>'style="text-align:left;;;;font-weight:bold"',\
"c:1"=>'style="text-align:right;;;;font-weight:bold"'\
}
attr Heizung_Verbrauch mapping  ;
attr Heizung_Verbrauch nostate 1
attr Heizung_Verbrauch room Heizung
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"
attr Heizung_Verbrauch valueFormat {\
Gasverbrauch_heute => "%.0f kWh",\
Gasverbrauch_WW_heute => "%.0f kWh",\
Stromverbrauch_heute => "%.0f kWh",\
Gasverbrauch_gestern => "%.0f kWh",\
Gasverbrauch_WW_gestern => "%.0f kWh",\
Stromverbrauch_gestern => "%.0f kWh",\
Gasverbrauch_aktuelle_Woche => "%.0f kWh",\
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",\
Stromverbrauch_aktuelle_Woche => "%.0f kWh",\
Gasverbrauch_letzte_Woche => "%.0f kWh",\
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",\
Stromverbrauch_letzte_Woche => "%.0f kWh",\
Gasverbrauch_aktueller_Monat => "%.0f kWh",\
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",\
Stromverbrauch_aktueller_Monat => "%.0f kWh",\
Gasverbrauch_letzter_Monat => "%.0f kWh",\
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",\
Stromverbrauch_letzter_Monat => "%.0f kWh",\
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",\
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",\
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",\
Gasverbrauch_letztes_Jahr => "%.0f kWh",\
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",\
Stromverbrauch_letztes_Jahr => "%.0f kWh"\
}
</syntaxhighlight>
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]

=== SVG Graphen ===
==== Gas- und Stromverbrauch ====

[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]
[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]

==== weitere Graphen ====
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]

== Weblinks ==
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}

[[Kategorie:Heizungssteuerung]]

HM-LC-Bl1PBU-FM Funk-Rollladenaktor für Markenschalter

2018-02-23T21:36:58Z

Awe: Zwei Attribute für Homebridge-/Homekit-Anbindung ergänzt

{{Infobox Hardware
|Bild=HM-LC-Bl1PBU-FM.jpg
|Bildbeschreibung=HM-LC-Bl1PBU-FM montiert, ohne Adapter
|HWProtocol=BidCoS ([[HomeMatic]])
|HWType=[[HomeMatic Type Blind|Blind]]
|HWCategory=[[:Kategorie:Rollladensteuerung|Rollladensteuerung]]
|HWComm=868,3 MHz
|HWChannels=1
|HWVoltage=230 V
|HWPowerConsumption=0,5 W (Stand-by)
|HWPoweredBy=Netz
|HWSize=71x71x37 mm
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
}}
== Features ==

Schalten eines angeschlossenen Jalousiemotors mittels CUL/CUN/HMLAN Konfigurator und über lokalen, in bestehendes Schalterprogramm integrierte Schaltwippe.

'''Technische Daten:'''
* Gerätebezeichnung: HM-LC-Bl1PBU-FM
* Versorgungsspannung: 230 V / 50 Hz
* Maximale Schaltleistung: 230 VA (Motorlast)
* Standby-Verbrauch: 0,5 W
* Schaltvermögen: 1 A (Motorlast)
* Funkfrequenz: 868,3 MHz
* Empfängerklasse: SRD Class 2
* Maximale Sendeleistung: 10 mW
* Schutzart: IP20
* Schutzklasse: II
* Umgebungstemperatur: +5°C bis +35°C
* Abmessungen (B x H x T): 71 x 71 x 37 mm
* Gewicht: 43 g

== Hinweise zur Hardware-Installation ==

Der Schaltaktor ersetzt den Unterputzschalter der bestehenden Elektroinstallation. Arbeiten am 230 V Netz dürfen nur von einer Elektrofachkraft durchgeführt werden! Sicherheitsregeln anwenden:

* Freischalten (Sicherung abschalten),
* gegen Wiedereinschalten sichern,
* Spannungsfreiheit feststellen, (Messgerät vor und '''nach''' Messung auf Funktion überprüfen)
* Erden und Kurzschließen,
* benachbarte, unter Spannung stehende Teile abdecken.

Zur Integration in ein bestehendes Schalterprogramm bitte den entsprechenden Adapter mit bestellen.

<gallery>
Datei:HM-LC-BL1PBU schritt 01.jpg|Ausgangssituation
Datei:HM-LC-BL1PBU schritt 02.jpg|Schalter abbauen, Rahmen entfernen, Unterputzschalter lösen
Datei:HM-LC-BL1PBU schritt 03.jpg|Bestehender Anschluss
Datei:HM-LC-BL1PBU schritt 04.jpg|Neuer Anschluss. Achtung: zusätzlicher Nullleiteranschluss!
Datei:HM-LC-BL1PBU schritt 05.jpg|Einbau ohne Adapter
Datei:HM-LC-BL1PBU schritt 06.jpg|Adapter aufsetzen
Datei:HM-LC-BL1PBU schritt 07.jpg|Fertig eingebauter HM-LC-BL1PBU-FM
</gallery>

== Hinweise zum Betrieb mit FHEM ==

Der Schalter wird seit FHEM 5.3 unterstützt. Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Dazu wird der Config-Taster kurz gedrückt.
Zur Darstellung im Webfrontend siehe [[Slider für HM-Rolladensteuerung anzeigen]].

=== FHEM Config-Auszug ===
Ein exemplarischer Auszug aus der fhem.cfg:

define WZ_Rollo_Links CUL_HM ABCDEF
attr WZ_Rollo_Links devInfo 010100
attr WZ_Rollo_Links eventMap on:hoch off:runter stop:stop
attr WZ_Rollo_Links firmware 2.1
attr WZ_Rollo_Links hmClass receiver
attr WZ_Rollo_Links model HM-LC-Bl1PBU-FM
attr WZ_Rollo_Links room Wohnzimmer
attr WZ_Rollo_Links serialNr JEQxxxxxxx
attr WZ_Rollo_Links subType blindActuator
attr WZ_Rollo_Links webCmd pct

=== Variablen===
==== Attribute====
Dem Device können neben den Allgemeinen auch spezielle Attribute gesetzt werden.
* '''param levelInverse''': HM Blind Aktoren stehen auf 100% wenn sie offen sind und auf 0% wenn sie geschlossen sind. Das ist oftmals nicht intuitiv. In FHEM kann man dies "drehen" durch dieses Attribut. Damit dreht sich auch die Bedeutung von On und Off.
Zur optimalen Anbindung an Homebridge-/HomeKit empfiehlt es sich, die beiden folgenden Attribute zu setzen:
: '''genericDeviceType''': blind
: '''subType''': blindActuator

Desweiteren empfehlen sich die üblichen Homematic Attribute (wie autoReadReg, event-on-change-reading, expert) zu setzten. Weitere Informationen dazu unter [[HomeMatic#Attribute]]

==== Readings====
*'''level''' numerischer Wert der den Stand des Rollo wiedergibt. Achtung: Der Aktor kennt nicht den Stand des Rollos sondern errechnet diesen aus den Fahrzeiten. Nach einem powerUp wird ein Stand von 50% angenommen.
*'''motor''': zeigt den Zustand des Motors an, ob er steht oder in welche Richtung er fährt
*'''pct''': analog "level"

== Konfiguration==
Die Konfiguration des Devices betrifft Register und Peerings. Dies sind Werte, die zwar über FHEM gesetzt werden, aber im Device im Flash gespeichert werden.
Man kann die Devices mit Sensoren und Tastern [[Peering (HomeMatic)|peeren]]

===Fahrzeiten kalibrieren===
Um die Jalousie mit Prozentangaben auf eine bestimmte Position fahren zu lassen, muss der Aktor die Fahrtzeiten kennen um daraus die relativen Positionen erechnen zu können. Dazu müssen 3 Werte manuell mit einer Stoppuhr gemessen werden.

* Fahrtzeit nach oben
* Fahrtzeit nach unten (ist meistens identisch mit der Fahrzeit nach oben bei herkömlichen Jalousiemotoren)
* Wechsel der Fahrtrichtung

Diese 3 Zeiten werden in Sekunden gemessen und anschließend einmalig mit den folgenden Befehlen eingestellt:
set <name> regSet driveUp 27.0 # Fahrtzeit nach oben in Sekunden
set <name> regSet driveDown 27.0 # Fahrtzeit nach unten in Sekunden
set <name> regSet driveTurn 0.5 # Die Zeit die gebraucht wird um die Fahrtrichtung zu wechseln in Sekunden

=== Tasterverhalten ===
Um den fahrenden Rollladen bei jedem Tastendruck anzuhalten und nicht nur bei Druck auf die entgegengesetzte Richtung:

* Die internen Taster sichtbar schalten und die config abfragen
set <device> regSet intKeyVisib visib
set <device> getConfig

* Die Taster konfigurieren (alte Variante via Register)
set <device> regBulk RegL_03:self01 0B:94 0D:63 8B:94
set <device> regBulk RegL_03:self02 0B:18 0D:63 8B:18

* Die Taster konfigurieren (neue Variante via Template, dazu muss ein [[HomeMatic_HMInfo]] Device anglegt sein)
set <HMinfo> templateSet <device> BlStopUpSh self02:short
set <HMinfo> templateSet <device> BlStopDnSh self01:short
set <device> getConfig

* Die internen Taster unsichtbar schalten und die config überprüfen
set <device> regSet intKeyVisib invisib
set <device> getConfig

Wichtig: bei der alten Variante nach jedem Schritt jeweils die Anlern-Taste drücken und in den Internals schauen ob die kommandos ohne Fehler abgearbeitet wurden.

== Mögliche Schaltoperationen ==

Der Aktor versteht folgende Befehle:
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den logischen Zustand des Aktors.
set <name> <Prozentangabe[0 bis 100]> -> Öffnet die Jalousie auf absolut prozentuale Öffnungsposition, berechnet aus definierter Laufzeit.
set <name> up/down <Prozentangabe[0 bis 100]> -> Öffnet oder schließt die Jalousie um den prozentualen Wert, berechnet aus definierter Laufzeit. Keine Angabe => 10%

== Log-Auszug ==
In FHEM ist nach dem Schalten des HM-LC-BL1-FM folgendes Log zu sehen:
2013.02.26 07:00:12 2: CUL_HM set WZ_Rollo_Rechts on rxt:1

== Mögliche Hardwaredefekte ==

Wenn der Rolladenaktor nur noch lokal reagiert oder den Rolladen nur für ein kurzes Stück fährt und aus FHEM nur mit fortgesetzten Schwierigkeiten zu erreichen ist, dann kann ein Kondensator defekt sein, der nach dem internen Schaltnetzteil für eine erste Glättung verantwortlich ist, hier C26. (Einen vergleichbarer Defekt tritt auch häufig beim Schaltaktor [[HM-LC-Sw1PBU-FM_Unterputz-Schaltaktor_1-fach|HM-LC-Sw1PBU-FM]] und dem Dimmer [[HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP|HM-LC-Dim1TPBU-FM]] auf.)

Es handelt sich um einen kleinen Elektrolytkondensator herkömmlicher Bauart, RM 2,5 radial, 10µ/25V (Ersatz mit höherer Spannung unproblematisch). Er sitzt auf der Leistungsplatine gegenüber den Anschlussklemmen an einer Ecke neben einer Spule (L21) und der Diode D20. Die Platine hat Bestückungsdruck, C26 ist also problemlos zu identifizieren. Die Schwierigkeit des Austausches liegt auf dem üblichen Bausatzniveau.

== Links ==
* [http://www.elv-downloads.de/Assets/Produkte/10/1030/103038/Downloads/103038_FunkRollladenaktor_um.pdf Bedienungsanleitung (PDF)]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Rollladensteuerung]]

HM-SEC-SD Rauchmelder

2018-02-23T21:24:33Z

Awe: Attribut ergänzt für Homebridge/Homekit-Erkennung ('''genericDeviceType''' security)

{{Infobox Hardware
|Bild=HM-SEC-SD o.jpeg 
|Bildbeschreibung=HomeMatic HM-SEC-SD Rauchmelder Oberseite
|HWProtocol=HomeMatic
|HWType=Aktor
|HWCategory=HomeMatic
|HWComm=868MHz
|HWChannels=
|HWVoltage=9V
|HWPowerConsumption= W im Standby
|HWPoweredBy=3 x 1,5 V LR6/AA
|HWSize=120x44mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

== Features ==
Der [[HM-SEC-SD Rauchmelder|HM-SEC-SD]] ist ein VdS-zertifizierter Rauchmelder. Mehrere Rauchmelder können unabhängig von einer Zentrale zu einer Gruppe zusammengefasst werden. Auch ohne FHEM-Zentrale meldet ein Rauchmelder seinen Alarm immer an die anderen vernetzten Rauchmelder weiter. Der [[HM-SEC-SD Rauchmelder|HM-SEC-SD-2]] ist die neue Version seit 2016. Auch dieser Melder wird in FHEM unterstützt.

[[Datei: HM-SEC-SD-2.jpg|300px|thumb|right|HM-SEC-SD-2]]

== Hinweise zum Betrieb mit FHEM ==
Der HM-SEC-SD Rauchmelder beherrscht kein AES. Der Betrieb ist mit [[HMLAN Konfigurator]] oder mit [[CUL]] möglich. Das Pairing sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden.

Der HM-SEC-SD-2 Rauchmelder arbeitet mit aesCBC, er benötigt dafür zwingend das Modul libcrypt-rijndael-perl unabhängig vom IO Device, auch für den HM-CFG-LAN!

=== Teams ===
Rauchmelder können mittels [[Peering (HomeMatic)|Peering]] in Teams gruppiert werden. Jeder SD kann einem Team angehören - und das sollte man auch einrichten. Nutzt man nur einen SD sollte man diesen mit sich selbst peeren.

Beispiele:
nutzt man einen SD und will diesen nicht mit anderen in einem Team haben peert man ihn mit sich selbst. Damit ist der SD sein eigener TeamLead.
:<code>set Rauchmelder_Flur peerChan 0 Rauchmelder_Flur single set actor</code>

Hat man mehrere SDs, die in einem Team zusammengefasst werden sollen, wird der TeamLead festgelegt und alle SDs werden mit ihm gepeert. Das Team kann jederzeit erweitert werden.
<pre>set Rauchmelder_Flur peerChan 0 Rauchmelder_Flur single set actor
set Rauchmelder_Flur peerChan 0 Rauchmelder_WZ single set actor
set Rauchmelder_Flur peerChan 0 Rauchmelder_SZ single set actor
set Rauchmelder_Flur peerChan 0 Rauchmelder_KZ single set actor </pre>

Nutzt man einen virtuellen TeamLead - (siehe [[#virtueller TeamLead|virtueller TeamLead]]) - werden alle realen SDs mit diesem gepeert
<pre>set Rauchmelder_Team peerChan 0 Rauchmelder_Flur single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_WZ single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_SZ single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_KZ single set actor
</pre>

Ein SD kann aus einem Team mittels unset entfernt werden.
:<code>set Rauchmelder_Flur peerChan 0 Rauchmelder_Flur single unset actor </code>

Um einen SD von einem Team in ein anderes zu transferieren, muss man ihn erst mit ''unset'' aus dem Team entfernen, dann mit ''set'' in das neue Team eintragen. Einen physkalischen TeamLead kann man nur aus dem Team nehmen, indem man ihn aus allen Teammitgliedern entfernt.

Die korrekte Gruppierung sollte nach der Konfiguration durch einen Teamcall geprüft werden.

Der Betrieb mehrer Teams ist möglich, ein SD kann aber nur einem Team angehören. Will man einen SD von einem Team in ein anderes umhängen, muss man ihn erst aus dem ersten Team entfernen und dann in das Neue aufnehmen.

=== TeamLead ===
Für ein Team muss immer ein TeamLead festgelegt werden. Anders als der Name suggeriert, gibt es hier keinen Master. Sinn und Zweck ist einzig, eine Team-Adresse (HMId) festzulegen, unter der man alle SDs eines Teams ansprechen kann. Diese muss, wie alle HMIds, einzig im System sein. Um dies zu erreichen, verwendet HM beim Teamen ohne Zentrale die HMId eines der SDs. Verwendet man eine Zentrale (FHEM) kann man dies auch entzerren und einen virtuellen SD als TeamLead nutzen. Siehe hierzu [[#virtueller TeamLead|virtueller TeamLead]].

Nutzt man nur einen einzelnen SD, sollte man diesen mit sich selbst peeren.

=== Kommandos ===
Es gibt Team-Nachrichten, die jeder SD senden kann und auf die jeder SD im Team reagiert. Jeder SD kann somit einen Teamcall auslösen oder einen Alarm ausgeben. Die Kommandos werden '''nicht''' von einem SD zum anderen weitergereicht. Auch der TeamLead hat '''keine''' Sonderfunktion. Der einzelne SD sendet seine Nachricht an das Team und jeder im Team reagiert darauf.

Es ist somit darauf zu achten, dass auch die entferntesten SDs sich gegenseitig erreichen können.

Die Kommandos können von der Zentrale getriggert werden. Da sie unter der Team-ID gesendet werden, stehen sie nur bei der Komponente des TeamLeads zu Verfügung.

Dazu gehören teamCall, teamCallBat, alarmOn und alarmOff.

Sie stehen nur für die Entity des TeamLeads zu Verfügung.
<pre>set EurerTeamLeader alarmOn
set EurerTeamLeader alarmOff
set EurerTeamLeader teamCall
set EurerTeamLeader teamCallBat ## nur für alte SDs
</pre>

'''teamCall''' testet die Zugehörigkeit und Erreichbarkeit aller SDs im Team. Alle SDs sollten 10 mal leise piepen. '''teamCallBat''' erzeugt einen kürzeren Teamcall mit anderer Signalfolge, wie er bei schwacher Batterie eines Melders automatisch ausgelöst wird.

Einzelne SDs kann man mit "statusRequest" abfragen.

== virtueller TeamLead ==
Nutzt man nur einen einzelnen SD, kann/sollte man diesen mit sich selbst teamen (peerChan). In allen andere Fällen braucht man einen TeamLead um eine Team-ID zu erhalten. Man kann hierzu einen der SDs nutzen. Wird dieser einmal ausgewechselt, hat man allerdings seine Team-ID verloren.

Wenn man mit Zentrale (FHEM) arbeitet, gibt es eigentlich keinen vernünftigen Grund (ausser 1-SD-Teams), einen der SDs als Lead zu nutzen. Man kann genauso gut einen virtuellen Aktor bauen und diesen zum Lead machen. Das ergibt eine sauberere Struktur.

Erzeugen eines virtuellen TeamLeads könnte so aussehen:
<pre>define TeamDev CUL_HM 111111
set TeamDev virtual 1
rename TeamDev_Btn1 Rauchmelder_Team</pre>

Bitte beachten: '''die HMID muss für die gesamte Installation einmalig sein'''.

Anschließend muss man noch einen Homematic-Kanal für das Peering definieren.

Jeder Rauchmelder muss jetzt in das Team aufgenommen werden:
<pre>set Rauchmelder_Team peerChan 0 Rauchmelder_Flur single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_WZ single set actor
...
save</pre>

Hierbei ist "Rauchmelder_Team" der Name des virtuellen TeamLeaders und "Rauchmelder_Flur" der Name des jeweiligen Rauchmelders.

Das "save" ist notwendig, um auch die Einstellungen des virtuellen SDs in der [[Konfiguration]] zu sichern.

Bei jedem Rauchmelder sollte der Name des virtuellen TeamLeaders in der peerList stehen und beim virtuellen TeamLeader jeder Rauchmelder.

Mit teamCall sollte man die korrekte Funktion des Teams prüfen, wer will auch mit alarmOn.

== Variablen ==
=== Internals ===
Keine Spezifischen.

=== Readings ===
Für '''jeden''' SD sind folgende Readings relevant:

teamCall from <name>:<count>
state:[off|smoke-Alarm_<count>]
smoke_detect:<von_name>
battery:[ok|low]
level:<0..200>

*'''count''' ist ein Zähler, den das Gerät liefert um neue Alarme unterscheiden zu können
*'''level''' ist ein Wert zwischen 0 und 200. 200 ist Alarm, 199 bedeutet Alarm, aber die Sirene ist abgeschaltet.

Beim '''TeamLead''' laufen alle Alarme auf

teamCall: from <name>:<count>
recentAlarm:<von_name>
level:<0..200>
eventNo:<count>
state:[off|smoke-Alarm_<count>]
smoke_detect:<von_name>
SDteam:[add_<name>|remove_<name>]

*'''von_name''' ist der Name des SD, der gemeldet hat.
*'''smoke_detect''' ist der aktuelle Alarm, während '''recentAlarm''' die letzte Alarmquelle anzeigt, auch wenn der Alarm schon behoben ist.
*'''SDteam''' kommt gelegentlich bei Konfigurationsereignissen zum Tragen.

=== Attribute ===
Besondere Attribute
* '''msgRepeat''' sollte auf 1 stehen. SD ist ein burst device, wiederholen von Nachrichten belastet das HMLAN besonders. Die Team-Kommandos sind hiervon nicht beeinflusst, also auch nicht das Auslösen eines Alarms.
* '''actCycle''' wird auf 99 Stunden gesetzt. Ein SD meldet sich alle 3 Tage bei der Zentrale, was der ActionDetector prüft.
* '''msgRepeat''' 1
Allgemein vorgeschlagen
:'''IODev''' [HMLAN/HMUSB/CUL]
:'''autoReadReg''' 5_readMissing
:'''event-on-change-reading''' .*
Optional, nur als Anregung zu verstehen
:'''devStateIcon''' off:general_ok .*:secur_alarm
:'''group''' smokeDetect
:'''icon''' secur_smoke_detector
Ebenfalls optional, jedoch nützlich für Homebridge-/Homekit-Anbindung:
:'''genericDeviceType''' security

== Alarme ==
Meldet ein SD einen Alarm, wird dieser in dem SD und im TeamLead angezeigt.

Nutzt man [[HomeMatic HMInfo|HMinfo]], wird ein Rauchalarm auch hier als "Error" gemeldet. In HMinfo wird dies für alle SD-Teams im System gemacht.

== Nützliche Notifies ==
Codefragmente, die man einsetzen kann. Ggf. muss man etwas anpassen, zumindest können sie als Anregung nützlich sein.
* Bei Alarm E-Mail schicken und Licht im Flur anschalten
<pre>
define sd.nf.report notify sdTeam:.*smoke-Alarm.* {\
<Mail versenden>;;
fhem("set LichtTreppenhaus on");;
}\
</pre>

* Bei Alarm alle SDs des Teams stumm schalten durch Stummschalten eines einzelnen
:<code>define sd.nf.quiet notify sdTeam:.*level:.199 set sdTeam alarmOff</code>

== Links ==
* [http://www.eq-3.de/Downloads/eq3/downloads_produktkatalog/homematic/bda/HM-Sec-SD_GE_UM_V1.5_150407.pdf Anleitung (PDF)]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Rauchmelder]]

HM-SEC-SD Rauchmelder

2018-02-23T21:21:37Z

Awe: Fehlender Punkt beim state ('''devStateIcon''' off:general_ok .*:secur_alarm)

{{Infobox Hardware
|Bild=HM-SEC-SD o.jpeg 
|Bildbeschreibung=HomeMatic HM-SEC-SD Rauchmelder Oberseite
|HWProtocol=HomeMatic
|HWType=Aktor
|HWCategory=HomeMatic
|HWComm=868MHz
|HWChannels=
|HWVoltage=9V
|HWPowerConsumption= W im Standby
|HWPoweredBy=3 x 1,5 V LR6/AA
|HWSize=120x44mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

== Features ==
Der [[HM-SEC-SD Rauchmelder|HM-SEC-SD]] ist ein VdS-zertifizierter Rauchmelder. Mehrere Rauchmelder können unabhängig von einer Zentrale zu einer Gruppe zusammengefasst werden. Auch ohne FHEM-Zentrale meldet ein Rauchmelder seinen Alarm immer an die anderen vernetzten Rauchmelder weiter. Der [[HM-SEC-SD Rauchmelder|HM-SEC-SD-2]] ist die neue Version seit 2016. Auch dieser Melder wird in FHEM unterstützt.

[[Datei: HM-SEC-SD-2.jpg|300px|thumb|right|HM-SEC-SD-2]]

== Hinweise zum Betrieb mit FHEM ==
Der HM-SEC-SD Rauchmelder beherrscht kein AES. Der Betrieb ist mit [[HMLAN Konfigurator]] oder mit [[CUL]] möglich. Das Pairing sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden.

Der HM-SEC-SD-2 Rauchmelder arbeitet mit aesCBC, er benötigt dafür zwingend das Modul libcrypt-rijndael-perl unabhängig vom IO Device, auch für den HM-CFG-LAN!

=== Teams ===
Rauchmelder können mittels [[Peering (HomeMatic)|Peering]] in Teams gruppiert werden. Jeder SD kann einem Team angehören - und das sollte man auch einrichten. Nutzt man nur einen SD sollte man diesen mit sich selbst peeren.

Beispiele:
nutzt man einen SD und will diesen nicht mit anderen in einem Team haben peert man ihn mit sich selbst. Damit ist der SD sein eigener TeamLead.
:<code>set Rauchmelder_Flur peerChan 0 Rauchmelder_Flur single set actor</code>

Hat man mehrere SDs, die in einem Team zusammengefasst werden sollen, wird der TeamLead festgelegt und alle SDs werden mit ihm gepeert. Das Team kann jederzeit erweitert werden.
<pre>set Rauchmelder_Flur peerChan 0 Rauchmelder_Flur single set actor
set Rauchmelder_Flur peerChan 0 Rauchmelder_WZ single set actor
set Rauchmelder_Flur peerChan 0 Rauchmelder_SZ single set actor
set Rauchmelder_Flur peerChan 0 Rauchmelder_KZ single set actor </pre>

Nutzt man einen virtuellen TeamLead - (siehe [[#virtueller TeamLead|virtueller TeamLead]]) - werden alle realen SDs mit diesem gepeert
<pre>set Rauchmelder_Team peerChan 0 Rauchmelder_Flur single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_WZ single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_SZ single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_KZ single set actor
</pre>

Ein SD kann aus einem Team mittels unset entfernt werden.
:<code>set Rauchmelder_Flur peerChan 0 Rauchmelder_Flur single unset actor </code>

Um einen SD von einem Team in ein anderes zu transferieren, muss man ihn erst mit ''unset'' aus dem Team entfernen, dann mit ''set'' in das neue Team eintragen. Einen physkalischen TeamLead kann man nur aus dem Team nehmen, indem man ihn aus allen Teammitgliedern entfernt.

Die korrekte Gruppierung sollte nach der Konfiguration durch einen Teamcall geprüft werden.

Der Betrieb mehrer Teams ist möglich, ein SD kann aber nur einem Team angehören. Will man einen SD von einem Team in ein anderes umhängen, muss man ihn erst aus dem ersten Team entfernen und dann in das Neue aufnehmen.

=== TeamLead ===
Für ein Team muss immer ein TeamLead festgelegt werden. Anders als der Name suggeriert, gibt es hier keinen Master. Sinn und Zweck ist einzig, eine Team-Adresse (HMId) festzulegen, unter der man alle SDs eines Teams ansprechen kann. Diese muss, wie alle HMIds, einzig im System sein. Um dies zu erreichen, verwendet HM beim Teamen ohne Zentrale die HMId eines der SDs. Verwendet man eine Zentrale (FHEM) kann man dies auch entzerren und einen virtuellen SD als TeamLead nutzen. Siehe hierzu [[#virtueller TeamLead|virtueller TeamLead]].

Nutzt man nur einen einzelnen SD, sollte man diesen mit sich selbst peeren.

=== Kommandos ===
Es gibt Team-Nachrichten, die jeder SD senden kann und auf die jeder SD im Team reagiert. Jeder SD kann somit einen Teamcall auslösen oder einen Alarm ausgeben. Die Kommandos werden '''nicht''' von einem SD zum anderen weitergereicht. Auch der TeamLead hat '''keine''' Sonderfunktion. Der einzelne SD sendet seine Nachricht an das Team und jeder im Team reagiert darauf.

Es ist somit darauf zu achten, dass auch die entferntesten SDs sich gegenseitig erreichen können.

Die Kommandos können von der Zentrale getriggert werden. Da sie unter der Team-ID gesendet werden, stehen sie nur bei der Komponente des TeamLeads zu Verfügung.

Dazu gehören teamCall, teamCallBat, alarmOn und alarmOff.

Sie stehen nur für die Entity des TeamLeads zu Verfügung.
<pre>set EurerTeamLeader alarmOn
set EurerTeamLeader alarmOff
set EurerTeamLeader teamCall
set EurerTeamLeader teamCallBat ## nur für alte SDs
</pre>

'''teamCall''' testet die Zugehörigkeit und Erreichbarkeit aller SDs im Team. Alle SDs sollten 10 mal leise piepen. '''teamCallBat''' erzeugt einen kürzeren Teamcall mit anderer Signalfolge, wie er bei schwacher Batterie eines Melders automatisch ausgelöst wird.

Einzelne SDs kann man mit "statusRequest" abfragen.

== virtueller TeamLead ==
Nutzt man nur einen einzelnen SD, kann/sollte man diesen mit sich selbst teamen (peerChan). In allen andere Fällen braucht man einen TeamLead um eine Team-ID zu erhalten. Man kann hierzu einen der SDs nutzen. Wird dieser einmal ausgewechselt, hat man allerdings seine Team-ID verloren.

Wenn man mit Zentrale (FHEM) arbeitet, gibt es eigentlich keinen vernünftigen Grund (ausser 1-SD-Teams), einen der SDs als Lead zu nutzen. Man kann genauso gut einen virtuellen Aktor bauen und diesen zum Lead machen. Das ergibt eine sauberere Struktur.

Erzeugen eines virtuellen TeamLeads könnte so aussehen:
<pre>define TeamDev CUL_HM 111111
set TeamDev virtual 1
rename TeamDev_Btn1 Rauchmelder_Team</pre>

Bitte beachten: '''die HMID muss für die gesamte Installation einmalig sein'''.

Anschließend muss man noch einen Homematic-Kanal für das Peering definieren.

Jeder Rauchmelder muss jetzt in das Team aufgenommen werden:
<pre>set Rauchmelder_Team peerChan 0 Rauchmelder_Flur single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_WZ single set actor
...
save</pre>

Hierbei ist "Rauchmelder_Team" der Name des virtuellen TeamLeaders und "Rauchmelder_Flur" der Name des jeweiligen Rauchmelders.

Das "save" ist notwendig, um auch die Einstellungen des virtuellen SDs in der [[Konfiguration]] zu sichern.

Bei jedem Rauchmelder sollte der Name des virtuellen TeamLeaders in der peerList stehen und beim virtuellen TeamLeader jeder Rauchmelder.

Mit teamCall sollte man die korrekte Funktion des Teams prüfen, wer will auch mit alarmOn.

== Variablen ==
=== Internals ===
Keine Spezifischen.

=== Readings ===
Für '''jeden''' SD sind folgende Readings relevant:

teamCall from <name>:<count>
state:[off|smoke-Alarm_<count>]
smoke_detect:<von_name>
battery:[ok|low]
level:<0..200>

*'''count''' ist ein Zähler, den das Gerät liefert um neue Alarme unterscheiden zu können
*'''level''' ist ein Wert zwischen 0 und 200. 200 ist Alarm, 199 bedeutet Alarm, aber die Sirene ist abgeschaltet.

Beim '''TeamLead''' laufen alle Alarme auf

teamCall: from <name>:<count>
recentAlarm:<von_name>
level:<0..200>
eventNo:<count>
state:[off|smoke-Alarm_<count>]
smoke_detect:<von_name>
SDteam:[add_<name>|remove_<name>]

*'''von_name''' ist der Name des SD, der gemeldet hat.
*'''smoke_detect''' ist der aktuelle Alarm, während '''recentAlarm''' die letzte Alarmquelle anzeigt, auch wenn der Alarm schon behoben ist.
*'''SDteam''' kommt gelegentlich bei Konfigurationsereignissen zum Tragen.

=== Attribute ===
Besondere Attribute
* '''msgRepeat''' sollte auf 1 stehen. SD ist ein burst device, wiederholen von Nachrichten belastet das HMLAN besonders. Die Team-Kommandos sind hiervon nicht beeinflusst, also auch nicht das Auslösen eines Alarms.
* '''actCycle''' wird auf 99 Stunden gesetzt. Ein SD meldet sich alle 3 Tage bei der Zentrale, was der ActionDetector prüft.
* '''msgRepeat''' 1
Allgemein vorgeschlagen
:'''IODev''' [HMLAN/HMUSB/CUL]
:'''autoReadReg''' 5_readMissing
:'''event-on-change-reading''' .*
Optional, nur als Anregung zu verstehen
:'''devStateIcon''' off:general_ok .*:secur_alarm
:'''group''' smokeDetect
:'''icon''' secur_smoke_detector

== Alarme ==
Meldet ein SD einen Alarm, wird dieser in dem SD und im TeamLead angezeigt.

Nutzt man [[HomeMatic HMInfo|HMinfo]], wird ein Rauchalarm auch hier als "Error" gemeldet. In HMinfo wird dies für alle SD-Teams im System gemacht.

== Nützliche Notifies ==
Codefragmente, die man einsetzen kann. Ggf. muss man etwas anpassen, zumindest können sie als Anregung nützlich sein.
* Bei Alarm E-Mail schicken und Licht im Flur anschalten
<pre>
define sd.nf.report notify sdTeam:.*smoke-Alarm.* {\
<Mail versenden>;;
fhem("set LichtTreppenhaus on");;
}\
</pre>

* Bei Alarm alle SDs des Teams stumm schalten durch Stummschalten eines einzelnen
:<code>define sd.nf.quiet notify sdTeam:.*level:.199 set sdTeam alarmOff</code>

== Links ==
* [http://www.eq-3.de/Downloads/eq3/downloads_produktkatalog/homematic/bda/HM-Sec-SD_GE_UM_V1.5_150407.pdf Anleitung (PDF)]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Rauchmelder]]

HM-LC-DIM1T-FM 1-Kanal-Dimmer UP

2015-11-27T21:18:53Z

Awe: OSRAM IVIOS LED III zugefügt

Homematic Funk 1-Kanal-Dimmer, Phasenabschnitt (Unterputz)

= Features =

Schalten eines angeschlossenen Verbrauchers mittels [[CUL]]/[[CUN]]/[[HMLAN Konfigurator]] und über einen mechanischen spannungsfesten Taster.

Schaltdoseneinsatz zusätzlich zu vorhandenem Taster (erfordert evtl. tiefere Schaltdose).

'''Technische Daten:'''
* Schaltvermögen: 180VA 230V/50Hz
* Art: Phasenabschnittdimmer
* Standby Verbrauch: 1W
* Maße(BxHxT): 53x53x30mm

= Hinweise zur Hardware-Installation =

Will man die Funk-Schaltaktoren auch manuell betreiben, d.h. man upgradet eine vorhandene Elektroinstallation, so sind Taster notwendig. Schalter können notfalls mittels einer zusätzlichen Feder zu Taster umgebaut werden, Tastschalter sind leider nicht geeignet. Schalter und Tastschalter führen dazu, dass der Aktor nach Betätigung des Schalters in den Anlernmodus versetzt wird und auch in diesem verbleibt.

Je nach vorhandenen Schalterdosen empfiehlt es sich bestehende Schalterdosen nach hinten auszuweiten, d.h. die Abdeckung nach hinten heraus zu brechen, da die Aktoren und Kabel nicht gerade sparsam mit dem Platz umgehen. Alternativ könnte man den Aktor auch in eine zusätzliche Schalterdosen unterbringen und diese mit einem Federdeckel abschließen. Dies hat den Vorteil, dass man auch durch relativ dicke Tapete die LED und somit den Zustand des Aktors ablesen kann.

= Kompatible Leuchtmittel =

Hier eine Übersicht über die Kompatibilität des HM-LC-DIM1T-FM mit diversen Leuchtmitteln:

{| cellspacing="0" border="1"
| '''Art'''
| '''Bezeichnung'''
| '''Sockel'''
| '''Verbrauch'''
| '''Farbtemperatur'''
| '''Laut Hersteller geeignet für'''
| '''Funktion'''
| '''Einschränkungen'''
| '''Kompatibilitätsliste'''
| '''Hersteller Link'''
|-
| Glühlampe
| Glühlampe
|
|
|
| An-/Abschnitt
| ja
| nein
|
|
|-
| Energiesparlampe
| Osram Dulux Intelligent Dim Globe
|
|
|
| Anschnitt
| vermutlich nein
| ?
|
| [http://www.osram.de/osram_de/produkte/lampen/kompaktleuchtstofflampen/osram-dulux-intelligent/osram-dulux-intelligent-dim-globe/index.jsp]
|-
| Energiesparlampe
| Osram Dulux Intelligent Dim Stick
|
|
|
| Anschnitt
| vermutlich nein
| ?
|
| [http://www.osram.de/osram_de/produkte/lampen/kompaktleuchtstofflampen/osram-dulux-intelligent/osram-dulux-intelligent-dim-stick/index.jsp]
|-
| Energiesparlampe
| Phlilips Softone Dimmable
|
|
|
| An-/Abschnitt
| ?
| ?
|
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/energiesparlampen/energiesparlampen-gluehlampenform/softone-dimmable/20165/cat/]
|-
| Energiesparlampe
| Phlilips MASTER PL-Electronic Dimmable
|
|
|
| An-/Abschnitt
| ?
| ?
|
| [http://www.ecat.lighting.philips.at/l/professionelle-lampen/energiesparlampen/energiesparlampen-roehrenform/master-pl-electronic-dimmable/18109/cat/]
|-
| Energiesparlampe
| Phlilips TORNADO ESaver Dimmable
|
|
|
| Anschnitt
| vermutlich nein
| ?
|
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/energiesparlampen/energiesparlampen-spezialform/tornado-esaver-dimmable/19666/cat/]
|-
| LED
| Delock Lighting
| GU10
| 6W
| 3000K
| Anschnitt/Universal (RL/RLC)
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1075/107524/Downloads/107524_delock.pdf}}
| [http://www.delock-lighting.de/produkte/G_46327/merkmale.html]
|-
| LED
| Ledon LED-Spot MR16
| GU10
| 5W
| 2700K
| k.A.
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1026/102699/Downloads/102699_ledon.pdf}}
| [http://www.ledon-lamp.com/de/ledon_led-lampe_MR16_5W_GU10_DIM.htm]
|-
| LED
| Ledon Tropfenform
| E14
| 5W
| 2700K
| k.A.
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/9/995/99557/Downloads/099557_Ledon.pdf}}
| [http://www.ledon-lamp.com/de/ledon_led-lampe_P45_5W_E14_DIM.htm]
|-
| LED
| Ledon Kerzenform klar B35/C
| E14
| 5W
| 2700K
| k.A.
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/9/995/99554/Downloads/099554_Ledon.pdf}}
| [http://www.ledon-lamp.com/de/ledon_led-lampe_B35_C_5W_E14%20DIM.htm]
|-
| LED
| Ledon Globe G80
| E27
| 6W
| 2800K
| k.A.
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/9/995/99586/Downloads/099586_Ledon.pdf}}
| [http://www.ledon-lamp.com/de/ledon_led-lampe_G80_6W_E27_DIM.htm]
|-
| LED
| Ledon A65
| E27
| 10W
| 2700K
| k.A.
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1000/100026/Downloads/100026_Ledon.pdf}}
| [http://www.ledon-lamp.com/de/ledon_led-lampe_A65_10W_E27_DIM.htm]
|-
| LED
| Ledon G95
| E27
| 10W
| 2700K
| k.A.
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1022/102273/Downloads/102273_ledon.pdf}}
| [http://www.ledon-lamp.com/de/ledon_led-lampe_G95_10W_E27_DIM.htm]
|-
| LED
| LG LED-Glühbirne A19
| E27
| 12,8W
| 2700K
| k.A.
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1020/102043/Downloads/102043_LG.pdf}}
| [http://www.lg.com/de/innenbeleuchtung/lg-A1912GD0GE1.C0AASAA-gluehbirne]
|-
| LED
| Osram IVIOS LED III
| k.A.
| 2x 5,5W
| 3000K
| Abschnitt
| ja
|
|
| [http://www.osram.de/osram_de/produkte/led-technologie/innenraum-led-leuchten/downlights/ivios-led-iii/index.jsp]
|-
| LED
| Osram SUPERSTAR PAR 16
| GU10
| 5,5W
| 3000K
| k.A.
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1025/102569/Downloads/102569_osram.pdf}}
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/consumer-led-reflektorlampen/led-superstar-par-16/index.jsp]
|-
| LED
| Osram PARATHOM PRO PAR 16 advanced 50
| GU10
| 9W
| 4000K
| k.A.
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1083/108338/Downloads/108338_osram.pdf}}
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-reflektorlampen/parathom-pro-par-16-advanced/index.jsp]
|-
| LED
| Osram PARATHOM PRO PAR 16 advanced 35
| GU10
| 5,2W
| 4000K
| k.A.
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1083/108337/Downloads/108337_osram.pdf}}
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-reflektorlampen/parathom-pro-par-16-advanced/index.jsp]
|-
| LED
| Osram LED Superstar Classic A50
| E27
| 12W
| 3000K
| k.A.
|
|
|
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/consumer-led-lampen-mit-klassischen-kolbenformen/led-superstar-classic-a-advanced/index.jsp]
|-
| LED
| Osram LED Superstar Classic A40
| E27
| 8,5W
| 2700K
| k.A.
| nein
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1082/108212/Downloads/108212_osram.pdf}}
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/consumer-led-lampen-mit-klassischen-kolbenformen/led-superstar-classic-a-advanced/index.jsp]
|-
| LED
| Osram LED Superstar Classic A60
| E27
| 12W
| 2700K
| k.A.
| nein
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1077/107748/Downloads/107748_osram.pdf}}
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/consumer-led-lampen-mit-klassischen-kolbenformen/led-superstar-classic-a-advanced/index.jsp]
|-
| LED
| Osram LED Superstar Classic A75
| E27
| 14,5W
| 2700K
| k.A.
| nein
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1077/107749/Downloads/107749_osram.pdf}}
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/consumer-led-lampen-mit-klassischen-kolbenformen/led-superstar-classic-a-advanced/index.jsp]
|-
| LED
| Osram PARATHOM CLASSIC A advanced 50
| E27
| 12W
| 3000K
| k.A.
|
|
|
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-lampen-mit-klassischen-kolbenformen/parathom-classic-a-advanced/index.jsp]
|-
| LED
| Osram PARATHOM CLASSIC A advanced 60
| E27
| 12W
| 2700K
| k.A.
|
|
|
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-lampen-mit-klassischen-kolbenformen/parathom-classic-a-advanced/index.jsp]
|-
| LED
| Osram PARATHOM CLASSIC A advanced 60
| E27
| 13W
| 2700K
| k.A.
|
|
|
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-lampen-mit-klassischen-kolbenformen/parathom-classic-a-advanced/index.jsp]
|-
| LED
| Osram PARATHOM CLASSIC A advanced 75
| E27
| 14,5W
| 2700K
| k.A.
|
|
|
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-lampen-mit-klassischen-kolbenformen/parathom-classic-a-advanced/index.jsp]
|-
| LED
| Osram PARATHOM CLASSIC P advanced 25
| E14
| 4,5W
| 2700K
| k.A.
|
|
|
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-lampen-mit-klassischen-kolbenformen/parathom-classic-p-advanced/index.jsp]
|-
| LED
| Osram PARATHOM CLASSIC P advanced 25
| E25
| 4,5W
| 2700K
| k.A.
|
|
|
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-lampen-mit-klassischen-kolbenformen/parathom-classic-p-advanced/index.jsp]
|-
| LED
| Philips MASTER LEDspot HV
| GU10
| 4W
| 2700K
| Anschnitt/Universal (RL/RLC)
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1065/106561/Downloads/106561_philips.pdf}}
| [http://www.ecat.lighting.philips.de/l/oem/led-systems/led-retrofit-lampen/master-ledspot-hv/929000212702_eu/]
|-
| LED
| Philips MASTER LEDspot BBL
| GU10
| 7W
| 2700K
| Anschnitt/Universal (RL/RLC)
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1018/101863/Downloads/101863_Philips.pdf}}
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/led-lampen-und-komponenten/led-lampen/master-led-dimtone/61144/cat/]
|-
| LED
| Philips MASTER LEDbulb Designer
| E27
| 7W
| 2700k
| Anschnitt/Universal (RL/RLC)
|
|
|
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/led-lampen-und-komponenten/led-lampen/master-ledbulb-designer/61143/cat/]
|-
| LED
| Philips MASTER LEDlamps DimTone
| E27
| 8W
| 2200-2700K
| Anschnitt/Universal (RL/RLC)
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1027/102789/Downloads/102789_philips.pdf}}
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/led-lampen-komponenten/led-lampen/master-ledlamps-dimtone/929000215102_eu/]
|-
| LED
| Philips MASTER LEDbulb D
| E27
| 8W
| 2700K
| Anschnitt/Universal (RL/RLC)
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1022/102239/Downloads/102239_Philips.pdf}}
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/led-lampen-und-komponenten/led-lampen/master-ledbulb/19890/cat/]
|-
| LED
| Philips MASTER LEDbulb D
| E27
| 12W
| 2700K
| Anschnitt/Universal (RL/RLC)
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1006/100657/Downloads/100657_Philips.pdf}}
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/led-lampen-und-komponenten/led-lampen/master-ledbulb/19890/cat/]
|-
| LED
| Philips MASTER LEDbulb D
| E27
| 17W
| 2700K
| Anschnitt/Universal (RL/RLC)
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1060/106098/Downloads/106098_philips.pdf}}
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/led-lampen-und-komponenten/led-lampen/master-ledbulb/19890/cat/]
|}

== Wichtiger Hinweis zum Betrieb eines Phasenabschnittdimmers ==

Der Dimmer ist nur mit folgenden Lampen zu betreiben:
* Hochvolt-Halogenlampen
* Niedervolt- Halogenlampen mit elektronischem Trafo
* Glühlampen
* dimmbare Energiesparlampen

Im Zweifel vorher beim Hersteller nachhaken, bevor es zu Flackern oder Brummen kommt.

= Hinweise zum Betrieb mit FHEM =

Das Pairing sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür wird ein am Aktor temporär angeschlossener spannungsfester Taster zwingend benötigt. Im Gegensatz zu den Schaltaktoren, muss der Phasenabschnittdimmer innerhalb der ersten 5 Minuten nach Zuschalten der Netzspannung erfolgen. Nach dieser Zeitspanne ist ein Anlernen nicht mehr möglich. Darum sollte zum Anlernen des HM-LC-DIM1T-FM zuerst die Netzspannung ab- und zugeschaltet werden, d.h. praktischerweise Sicherung kurz raus und nach einer Minute wieder rein. Bitte auch zuvor alle angeschlossenen Geräte von der Sicherung trennen oder ausschalten.

== FHEM Config-Auszug ==

Ein exemplarischer Auszug aus der fhem.cfg:

<pre>
define LichtWohnzimmerDimmer CUL_HM 184436
attr LichtWohnzimmerDimmer devInfo 110100
attr LichtWohnzimmerDimmer firmware 1.2
attr LichtWohnzimmerDimmer hmClass receiver
attr LichtWohnzimmerDimmer model HM-LC-DIM1T-FM
attr LichtWohnzimmerDimmer room Wohnzimmer
attr LichtWohnzimmerDimmer serialNr IEQ0xxxxxx
attr LichtWohnzimmerDimmer subType dimmer
</pre>

== Mögliche Schaltoperationen ==

Der Aktor versteht folgende Aktionen:
<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> up -> Helligkeitswert erhöhen
set <name> down -> Helligkeitswert verringern
set <name> toggle -> Ein eingeschalteter Dimmer wird ausgeschaltet und ein ausgeschalteter Dimmer wird auf den letztgenutzten Wert hochgedimmt.
set <name> <Helligkeit> [<Einschaltdauer>] [<Rampenzeit>] -> Schaltet den Aktor ein und dimmt dabei auf <Helligkeit>%,
100% entspricht dabei einem "on". Optional kann als Einschaltdauer die Zeit in Sekunden angegeben werden,
bis der Dimmer wieder automatisch abschalten soll (Bereich 0.00-111600 Sekunden). Optional kann weiterhin angegeben werden,
dass der Dimmer über eine angegebene Zeit in Sekunden (Rampenzeit) auf die angegebene Helligkeit hochdimmt
(Bereich 0.00 Sekunden - 111600 Sekunden) abgeschaltet wird.
</pre>

== Log-Auszug ==
In FHEM ist nach dem Schalten des HM-LC-DIM1T-FM folgendes Log zu sehen:
<pre>
2012.02.05 23:09:19 2: CUL_HM set LichtWohnzimmerDimmer on
2012.02.05 23:09:21 2: CUL_HM set LichtWohnzimmerDimmer off
2012.02.06 22:40:15 2: CUL_HM set LichtWohnzimmerDimmer toggle
2012.02.06 22:41:15 2: CUL_HM set LichtWohnzimmerDimmer 32
</pre>

= Links =
* Ein Integrationsbeispiel ist in [[Jalousie und Beleuchtung in mehreren Räumen]] zu finden.
* Anleitung [http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-LC-Dim1T-FM_UM_GE_eQ-3_100422.pdf] PDF

[[Kategorie:HomeMatic Components]]
[[Kategorie:Dimmer]]