Vitoconnect

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.

Das Modul befindet sich derzeit noch in der Entwicklung. Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread "Neues Modul: vitoconnect" statt.

Einrichtung

Vorbereitung

Zur Nutzung des Moduls muss vorhanden sein:

• Eine aktuelle FHEM Installation
• Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)
• Ein 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"\
}

SVG Graphen

Gasverbrauch

Weblinks

• "Thread zum Modul im Forum"