Vitoconnect: Unterschied zwischen den Versionen
K (Verweis auf das Modul Vitotronic 200 (Viessmann Heizungssteuerung) ergänzt) |
Keine Bearbeitungszusammenfassung |
||
Zeile 41: | Zeile 41: | ||
===Readings === | ===Readings === | ||
Die Readings werden so ausgegeben, wie sie von der API geliefert werden! | |||
{|class="wikitable" | {|class="wikitable" | ||
Zeile 46: | Zeile 48: | ||
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung | ! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung | ||
|- | |- | ||
|xxx || ||xxx | |Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1 | ||
|- | |||
| || || | |||
|- | |||
|Aussen_Status || connected/notConnected ||Ist ein Außensensonor angeschlossen? | |||
|- | |||
|Aussen_StatusWired || connected/notConnected ||Ist ein Außensensonor per Kabel angeschlossen? | |||
|- | |||
|Aussen_StatusWireless || connected/notConnected ||Ist ein kabelloser Außensensonor angeschlossen? | |||
|- | |||
|Aussentemperatur || 2.4 ||Außentemperatur in °C | |||
|- | |||
| || || | |||
|- | |||
|Brenner_Fehlercode || 0 || Brenner Fehlercode | |||
|- | |||
|Brenner_Status || ok ||Brenner Status | |||
|- | |||
|Brenner_aktiv || 0,1|| Brenneraktiv | |||
|- | |||
| || || | |||
|- | |||
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer | |||
|- | |||
|Device_Time_Offset || 61 || ??? | |||
|- | |||
|Fehlereinträge_Historie ||ErrorListChanges||??? | |||
|- | |||
|Fehlereinträge_aktive ||ErrorListChanges ||??? | |||
|- | |||
| || || | |||
|- | |||
|Gasverbrauch_Heizung/Jahr || 3293,0,0 ||Liste der jährlichen Gasverbräuche Heizung in kWH (aktuelles Jahr und die letzten beiden) | |||
|- | |||
|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 || || Liste der jährlichen Gasverbräuche Warmwasser in kWH | |||
|- | |||
|Gasverbrauch_WW/Monat || ||Liste der monatlichen Gasverbräuche Warmwasser in kWH | |||
|- | |||
|Gasverbrauch_WW/Tag || ||Liste der täglichen Gasverbräuche Warmwasser in kWH | |||
|- | |||
|Gasverbrauch_WW/Woche || ||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 || ||xxx | |||
|- | |||
|HK1-External_aktiv || ||xxx | |||
|- | |||
| || || | |||
|- | |||
|HK1-Frostschutz_Status || ||xxx | |||
|- | |||
| || || | |||
|- | |||
|HK1-Heizkurve-Niveau || ||xxx | |||
|- | |||
|HK1-Heizkurve-Steigung || ||xxx | |||
|- | |||
| || || | |||
|- | |||
|HK1-Programmstatus || ||xxx | |||
|- | |||
|HK1-Raum_Status || ||xxx | |||
|- | |||
|HK1-Reduzierte_Temperatur_erzwungen || ||xxx | |||
|- | |||
|HK1-Solltemperatur_aktiv || ||xxx | |||
|- | |||
|HK1-Solltemperatur_comfort || ||xxx | |||
|- | |||
|HK1-Solltemperatur_comfort_aktiv || ||xxx | |||
|- | |||
|HK1-Solltemperatur_eco || ||xxx | |||
|- | |||
|HK1-Solltemperatur_eco_aktiv || ||xxx | |||
|- | |||
|HK1-Solltemperatur_erzwungen || ||xxx | |||
|- | |||
|HK1-Solltemperatur_normal || ||xxx | |||
|- | |||
|HK1-Solltemperatur_reduziert || ||xxx | |||
|- | |||
|HK1-Solltemperatur_reduziert_aktiv || ||xxx | |||
|- | |||
|HK1-Standby_aktiv || ||xxx | |||
|- | |||
| || || | |||
|- | |||
|HK1-Urlaub_Ende || ||xxx | |||
|- | |||
|HK1-Urlaub_Start || ||xxx | |||
|- | |||
|HK1-Urlaub_aktiv || ||xxx | |||
|- | |||
| || || | |||
|- | |||
|HK1-Vorlauftemperatur || ||xxx | |||
|- | |||
|HK1-Vorlauftemperatur_aktiv || ||xxx | |||
|- | |||
| || || | |||
|- | |||
|HK1-WW_aktiv || ||xxx | |||
|- | |||
|HK1-WW_und_Heizen_aktiv || ||xxx | |||
|- | |||
|HK1-Zeitsteuerung_Heizung || ||xxx | |||
|- | |||
|HK1-Zeitsteuerung_Heizung_aktiv || ||xxx | |||
|- | |||
|HK1-Zeitsteuerung_Zirkulation || ||xxx | |||
|- | |||
|HK1-Zeitsteuerung_Zirkulation_aktiv || ||xxx | |||
|- | |||
|HK1-aktiv || ||xxx | |||
|- | |||
| || || | |||
|- | |||
|Kessel_Status || ||xxx | |||
|- | |||
|Kesseltemperatur || ||xxx | |||
|- | |||
|Mehrfamilenhaus_aktiv || ||xxx | |||
|- | |||
| || || | |||
|- | |||
|Service_Betriebsstunden_seit_letzten || ||xxx | |||
|- | |||
|Service_Intervall_Betriebsstunden || ||xxx | |||
|- | |||
|Service_Intervall_Monate || ||xxx | |||
|- | |||
|Service_Letzter || ||xxx | |||
|- | |||
|Service_Letzter_brennerbasiert || ||xxx | |||
|- | |||
|Service_Monate_aktiv_seit_letzten_Service || ||xxx | |||
|- | |||
|Service_fällig || ||xxx | |||
|- | |||
|Service_fällig_brennerbasiert || ||xxx | |||
|- | |||
| || || | |||
|- | |||
|WW-Isttemperatur || ||xxx | |||
|- | |||
|WW-Solltemperatur || ||xxx | |||
|- | |||
|WW-Temperatur_aktiv || ||xxx | |||
|- | |||
|WW-Zeitplan || ||xxx | |||
|- | |||
|WW-aktiv || ||xxx | |||
|- | |||
|WW-onTimeCharge_aktiv || ||xxx | |||
|- | |||
|WW-zeitgesteuert_aktiv || ||xxx | |||
|- | |||
| || || | |||
|- | |||
|counter || ||xxx | |||
|- | |||
|state || ||xxx | |||
|- | |||
|} | |} | ||
Zeile 57: | Zeile 252: | ||
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung | ! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung | ||
|- | |- | ||
| | |update|| ||löst ein Update der Reading zwischen manuell aus | ||
|} | |} | ||
Zeile 66: | Zeile 261: | ||
! Name !! Beschreibung | ! Name !! Beschreibung | ||
|- | |- | ||
| | | || | ||
|} | |} | ||
== Attribute == | == Attribute == |
Version vom 23. Dezember 2018, 13:50 Uhr
An dieser Seite wird momentan noch gearbeitet. |
Vitoconnect | |
---|---|
Zweck / Funktion | |
Steuerung von Vissmann Heizungen | |
Allgemein | |
Typ | Inoffiziell |
Details | |
Dokumentation | siehe Forum |
Support (Forum) | Heizungssteuerung/Raumklima |
Modulname | 98_vitoconnect.pm |
Ersteller | andreas13 |
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref! |
Vitoconnect ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Vissmann Heizungsanlage.
Mit dem FHEM Modul vitoconnect können die Daten, die über die Internetschnittstelle an den Herstellerserver gemeldet und von diesem über eine API zur Verfügung gestellt werden, in FHEM in Form von Readings angezeigt werden. Eine Steuerung der Heizung ist mit diesem Modul (noch) nicht möglich.
Wem stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul Vitotronic 200 (Viessmann Heizungssteuerung) empfohlen.
Die Idee zu dem Modul enstand aus dem Thread "Viessmann VitoConnect API". Es basiert auf dem PHP Modul von thetrueavatar.
Einrichtung
Vorbereitung
Zur Nutzung des Moduls muss vorhanden sein:
- Eine aktuelle FHEM Installation
- Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)
- Ein Vissmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.
- Die Datei 98_vitoconnect.pm aus dem ersten Posting des Threads "Neues Modul: vitoconnect" muss in das Modulverzeichnis von FHEM (z.B. /opt/fhem/FHEM) kopiert werden. Auf die richtigen Rechte achte und das Modul ggf. mit "reload 98_vitoconnect" laden.
Define des Devices
Dann kann das Gerät angelegt werden: define <name> vitoconnect <user> <password> <interval>
Z.B. : define vitoconnect vitoconnect user@mail.xx geheim 60
User und Passwort sind das gleiche wie in der ViCare App.
Readings
Readings
Die Readings werden so ausgegeben, wie sie von der API geliefert werden!
Name | Datentyp/ Wertebereich |
Bedeutung |
---|---|---|
Aktive_Heizkreise | 0,1,2 | Liste der aktiven Heizkreise. 0 entspricht HK1 |
Aussen_Status | connected/notConnected | Ist ein Außensensonor angeschlossen? |
Aussen_StatusWired | connected/notConnected | Ist ein Außensensonor per Kabel angeschlossen? |
Aussen_StatusWireless | connected/notConnected | Ist ein kabelloser Außensensonor angeschlossen? |
Aussentemperatur | 2.4 | Außentemperatur in °C |
Brenner_Fehlercode | 0 | Brenner Fehlercode |
Brenner_Status | ok | Brenner Status |
Brenner_aktiv | 0,1 | Brenneraktiv |
Controller_Seriennummer | 1234567890123456 | Controller Seriennummer |
Device_Time_Offset | 61 | ??? |
Fehlereinträge_Historie | ErrorListChanges | ??? |
Fehlereinträge_aktive | ErrorListChanges | ??? |
Gasverbrauch_Heizung/Jahr | 3293,0,0 | Liste der jährlichen Gasverbräuche Heizung in kWH (aktuelles Jahr und die letzten beiden) |
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 | Liste der jährlichen Gasverbräuche Warmwasser in kWH | |
Gasverbrauch_WW/Monat | Liste der monatlichen Gasverbräuche Warmwasser in kWH | |
Gasverbrauch_WW/Tag | Liste der täglichen Gasverbräuche Warmwasser in kWH | |
Gasverbrauch_WW/Woche | 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 | xxx | |
HK1-External_aktiv | xxx | |
HK1-Frostschutz_Status | xxx | |
HK1-Heizkurve-Niveau | xxx | |
HK1-Heizkurve-Steigung | xxx | |
HK1-Programmstatus | xxx | |
HK1-Raum_Status | xxx | |
HK1-Reduzierte_Temperatur_erzwungen | xxx | |
HK1-Solltemperatur_aktiv | xxx | |
HK1-Solltemperatur_comfort | xxx | |
HK1-Solltemperatur_comfort_aktiv | xxx | |
HK1-Solltemperatur_eco | xxx | |
HK1-Solltemperatur_eco_aktiv | xxx | |
HK1-Solltemperatur_erzwungen | xxx | |
HK1-Solltemperatur_normal | xxx | |
HK1-Solltemperatur_reduziert | xxx | |
HK1-Solltemperatur_reduziert_aktiv | xxx | |
HK1-Standby_aktiv | xxx | |
HK1-Urlaub_Ende | xxx | |
HK1-Urlaub_Start | xxx | |
HK1-Urlaub_aktiv | xxx | |
HK1-Vorlauftemperatur | xxx | |
HK1-Vorlauftemperatur_aktiv | xxx | |
HK1-WW_aktiv | xxx | |
HK1-WW_und_Heizen_aktiv | xxx | |
HK1-Zeitsteuerung_Heizung | xxx | |
HK1-Zeitsteuerung_Heizung_aktiv | xxx | |
HK1-Zeitsteuerung_Zirkulation | xxx | |
HK1-Zeitsteuerung_Zirkulation_aktiv | xxx | |
HK1-aktiv | xxx | |
Kessel_Status | xxx | |
Kesseltemperatur | xxx | |
Mehrfamilenhaus_aktiv | xxx | |
Service_Betriebsstunden_seit_letzten | xxx | |
Service_Intervall_Betriebsstunden | xxx | |
Service_Intervall_Monate | xxx | |
Service_Letzter | xxx | |
Service_Letzter_brennerbasiert | xxx | |
Service_Monate_aktiv_seit_letzten_Service | xxx | |
Service_fällig | xxx | |
Service_fällig_brennerbasiert | xxx | |
WW-Isttemperatur | xxx | |
WW-Solltemperatur | xxx | |
WW-Temperatur_aktiv | xxx | |
WW-Zeitplan | xxx | |
WW-aktiv | xxx | |
WW-onTimeCharge_aktiv | xxx | |
WW-zeitgesteuert_aktiv | xxx | |
counter | xxx | |
state | xxx |
Settings
Set Befehle
Name | Datentyp/ Wertebereich |
Beschreibung |
---|---|---|
update | löst ein Update der Reading zwischen manuell aus |
Get
Name | Beschreibung |
---|---|
Attribute
Attribute
Name | Datentyp/ Wertebereich |
Default-Wert | Beschreibung |
---|---|---|---|
xxx | xxx |
Hilfsmittel
Attribut zum Speichern der wichtigsten Werte mittels DbLog
attr vitoconnect DbLogInclude Gasverbrauch_gestern,Gasverbrauch_Heizung/Jahr,Gasverbrauch_aktuelle_Woche,Gasverbrauch_aktueller_Monat,Gasverbrauch_heute,WW-aktiv,HK1-Frostschutz_Status,HK1-WW_und_Heizen_aktiv,HK1-WW_aktiv,HK1-Betriebsart,HK1-Programmstatus,Aussentemperatur,HK1-Solltemperatur_normal,Brenner_aktiv,HK1-Vorlauftemperatur,Kesseltemperatur,WW-Isttemperatur,WW-Solltemperatur
Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen
attr vitoconnect userReadings
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",
"Gasverbrauch_Heizung/Tag",0))[0] },
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect",
"Gasverbrauch_Heizung/Tag",0))[1] },
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung_Woche.* { (split /,/, ReadingsVal("vitoconnect",
"Gasverbrauch_Heizung/Woche",0))[0] },
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect",
"Gasverbrauch_Heizung/Monat",0))[0] },
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect",
"Gasverbrauch_Heizung/Jahr",0))[0] }
ReadingsGroup für eine kompakte Darstellung
defmod vitoconnect_rg readingsGroup vitoconnect:Aussentemperatur\
vitoconnect:Brenner_aktiv\
vitoconnect:Gasverbrauch_heute\
vitoconnect:Gasverbrauch_gestern\
vitoconnect:Gasverbrauch_aktuelle_Woche\
vitoconnect:Gasverbrauch_aktueller_Monat\
vitoconnect:Gasverbrauch_aktuelles_Jahr\
vitoconnect:HK1-Solltemperatur_reduziert_aktiv\
vitoconnect:Kesseltemperatur\
vitoconnect:WW-Isttemperatur\
vitoconnect:WW-Solltemperatur
attr vitoconnect_rg alias Heizung
attr vitoconnect_rg mapping $READING
attr vitoconnect_rg nostate 1
attr vitoconnect_rg notime 1
attr vitoconnect_rg sortby 1
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 valueStyle style="text-align:right"
attr vitoconnect_rg valueSuffix {\
Aussentemperatur => "°C", \
Kesseltemperatur => " °C",\
'HK1-Vorlauftemperatur' => " °C", HK1_Solltemperatur_normal => " °C",\
'WW-Solltemperatur' => " °C",\
'WW-Isttemperatur' => " °C",\
Gasverbrauch_aktuelles_Jahr => " kWh",\
Gasverbrauch_aktueller_Monat => " kWh", \
Gasverbrauch_aktuelle_Woche => " kWh",\
Gasverbrauch_heute => " kWh", \
Gasverbrauch_gestern => " kWh", \
'WW-Solltemperatur' => "°C"\
}