VCONTROL: Unterschied zwischen den Versionen

Aus FHEMWiki
(Erste Version der Seite)
 
(Aufsplittung der Seite "Vitotronic 200 (Viessmann Heizungssteuerung" - Zwischenstand)
 
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 1: Zeile 1:
{{Todo|Es müssen noch die allgemeingültigen Informationen von der Seite [[Vitotronic 200 (Viessmann Heizungssteuerung)]] hierher übernommen (und dann auf der Vitotronic Seite entfernt) werden, sowie die Beschreibung und Verlinkung der Hardware eingefügt und überarbeitet werden. Das werde ich in den nächsten Tagen machen, bitte also vorerst keine Änderungen an dieser Seite durch andere Benutzer; bei dringendem Kommentarbedürfnis bitte auf die Diskussionsseite dieser Seite ausweichen).
Danke, --[[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 12:00, 3. Dez. 2019 (CET)}}
{{Infobox Modul
{{Infobox Modul
|ModPurpose=Module für Viessman Vitotronic 200
|ModPurpose=Modul für Viessman Vitotronic Steuerung
|ModType=d
|ModType=d
|ModForumArea=Heizungssteuerung/Raumklima
|ModForumArea=Heizungssteuerung/Raumklima
Zeile 9: Zeile 7:
|ModOwner=Adam ({{Link2FU|448|Forum}}/[[Benutzer Diskussion:Adam|Wiki]])
|ModOwner=Adam ({{Link2FU|448|Forum}}/[[Benutzer Diskussion:Adam|Wiki]])
}}
}}
[[VCONTROL]] ist ein Modul zur Abfrage und Steuerung einer Viessmann Vitotronic 200 Heizung über einen Optolink Adapter.
[[VCONTROL]] ist ein Modul zur Abfrage und Steuerung einer Viessmann Vitotronic Heizungssteuerung über einen Optolink Adapter.


== Entwicklungsstatus des Moduls ==
== Entwicklungsstatus des Moduls ==
Das "offizielle" Modul wurde am 10.7.2016 letztmalig aktualisiert. Es gibt mindestens die folgende inoffizielle Versionen:
Das "offizielle" Modul wurde am 10.7.2016 letztmalig aktualisiert. Es gibt mindestens die folgende inoffizielle Versionen:
* Version mit [[configdb]]-Unterstützung (von {{Link2FU|19608|crispyduck}} vom 26.4.2017 in {{Link2Forum|Topic=20280|Message=626439|LinkText=diesem Forenbeitrag}})
* Version mit [[configdb]]-Unterstützung (von {{Link2FU|19608|crispyduck}} vom 26.4.2017 in {{Link2Forum|Topic=20280|Message=626439|LinkText=diesem Forenbeitrag}})
== Konfiguration ==
Zur Konfiguration wird eine Textdatei verwendet, die drei Typen von Einträgen enthalten kann.
=== Syntax ===
{{Randnotiz|RNTyp=Warn|RNText=Achtung! Die Syntax für VCONTROL und VCONTROL300 unterscheidet sich voneinander in der Abfolge der Parameter und in der Kodierung der Adresse. Konfigurationsdateien können daher nicht eins zu eins übernommen werden, sondern müssen ggf. manuell umformatiert werden!}}
Ein Eintrag nimmt immer eine komplette einzelne Zeile ein und hat eines der folgenden Formate:
# Kommentar...
POLL, <adresse>, <parse-methode>, <divisor>, <reading>, <kumulationsmethode>
SET, <setname>, <adresse>, <adresstyp>, <multiplikator>, <nextset|day>
mit den folgenden Bedeutungen und möglichen Werten:
;<nowiki>#</nowiki>:Kommentarzeile
;POLL:Befehl zum Holen / Lesen von Daten aus der Steuerung
;<adresse>:hexadezimal, Präfix+interne Adresse+Länge einer Variablen in der Steuerung (z.B.  x'01F7'''00F8'''02' für die Gerätekennung)
;<parse-methode>:Typ der Variablen an der spezifizierten Adresse; mögliche Werte sind z.B. '''''1ByteS''''' (1 Byte mit Vorzeichen), '''''2ByteU''''' (2 Byte ohne Vorzeichen), '''''1ByteH''''' (1 Byte, hexadezimal), '''''mode''''' ('''on''' oder '''off'''), '''''date''''' (8 Byte Datumswert), '''''timer''''' (8 Byte Timerwert)
;<divisor>:Wert, durch den der geholte Variablenwert geteilt werden soll
;<reading>:Name des Readings, unter dem der geholte Wert im FHEM Device abgelegt werden soll
;<kumulationsmethode>:gibt an, ob die gelesenen Werte über den Tag kumuliert werden sollen ('''day''') oder nicht ('''-'''); sofern kumuliert wird, werden mehrere readings erzeugt und an den Readingnamen '''DayStart''', '''Today''' und '''LastDay''' angehängt
;SET:Befehl zum Setzen von Daten in der Steuerung
;<setname>:Name des FHEM readings, dessen Wert in die Anlage geschrieben
;<adresstyp>:entspricht der <parse-methode> eines POLL Befehls
;<multiplikator>:Gegenstück zum <divisor> bei einem POLL Befehl
werden soll
;<nextset|day|->:spezifiziert entweder einen Folge-SET Befehl, einen (Wochen-)Tag (MO|DI|MI|DO|FR|SA|SO) oder "keine weitere Aktion" (-)
=== Beispiele ===
==== Holen der Solltemperatur ====
:<code>POLL, Temperatur_Haus, 01F7230601, 1ByteU, 1, -</code>
Die ''ein Byte'' lange Solltemperatur von Adresse ''2306'' soll ''ohne Division'' geholt werden und in das reading ''Temperatur_Haus'' gesetzt werden.
==== Setzen der Solltemperatur ====
:<code>SET, Temperatur_Haus, 01F4230601, 1ByteU, -</code>
Solltemperatur von Adresse ''2306'' soll mit dem Wert des readings ''Temperatur_Haus'' gefüllt werden.


== Muster-Konfigurationsdateien ==
== Muster-Konfigurationsdateien ==
Die Inhalte der Konfigurationsdatei sind nicht nur abhängig davon, ob VCONTROL oder VCONTROL300 verwendet wird, sondern auch von der spezifischen installierten Heizungssteuerung / -regelung. Für einige verschiedene Konstellationen finden sich an unterschiedlichen Stellen (leider zumindest bisher keine zentrale Ablagestelle) fertig ausgefüllte Konfigurationsdateien. Hier eine Liste bekannter Konfigurationsdateien im ''VCONTOL''-Format:
Die Inhalte der Konfigurationsdatei sind nicht nur abhängig davon, ob VCONTROL oder VCONTROL300 verwendet wird, sondern auch von der spezifischen installierten Heizungssteuerung/-regelung. Für einige Konstellationen finden sich an unterschiedlichen Stellen (leider zumindest bisher keine zentrale Ablagestelle) fertig ausgefüllte Konfigurationsdateien. Hier eine Liste bekannter Konfigurationsdateien im '''VCONTROL'''-Format:
{| class="wikitable"
{| class="wikitable"
|-
|-
! Gerätename !! Kennung !! Link !! Erläuterungen
! Gerätename !! Kennung !! Link !! Erläuterungen
|-
| ''unbekannt''
| ''unbekannt''
| [https://forum.fhem.de/index.php?action=dlattach;topic=20280.0;attach=15073 99_VCONTROL.cfg]
| Benutzer {{Link2FU|448|Adam}} in {{Link2Forum|Topic=20280|Message=138200|LinkText=diesem Forenbeitrag}}
|-
|-
| Vitodens 222-W B2LB
| Vitodens 222-W B2LB
| 20CB  
| 20CB  
| {{Link2Forum|Topic=20280|Message=528752|LinkText=Forum}}
| [https://forum.fhem.de/index.php?action=dlattach;topic=20280.0;attach=62669 vcontrol.cfg]
| Benutzer {{Link2FU|22388|mmi}}; siehe Info im Link!
| Benutzer {{Link2FU|22388|mmi}}- siehe Info im {{Link2Forum|Topic=20280|Message=528752|LinkText=Forum}}!
|-
| ''V200KW1''
| ?
| [http://forum.fhem.de/index.php?action=dlattach;topic=20280.0;attach=20811 V200KW1.cfg]
| Benutzer {{Link2FU|448|Adam}} in {{Link2Forum|Topic=20280|Message=138200|LinkText=diesem Forenbeitrag}}
|-  
|-  
| ''VPlusHO1''
| ?
| [https://forum.fhem.de/index.php?action=dlattach;topic=20280.0;attach=21727 VPlusHO1.cfg]
| Benutzer {{Link2FU|448|Adam}} in {{Link2Forum|Topic=20280|Message=138200|LinkText=diesem Forenbeitrag}}
|-
| ''VScotHO1''
| ''20CB''
| [https://forum.fhem.de/index.php?action=dlattach;topic=20280.0;attach=21728 VScotHO1.cfg]
| Benutzer {{Link2FU|448|Adam}} in {{Link2Forum|Topic=20280|Message=138200|LinkText=diesem Forenbeitrag}}
|-
| ''V200WO1B''
| ''WO1B''
| [https://forum.fhem.de/index.php?action=dlattach;topic=20280.0;attach=22863 V200WO1B.cfg]
| Benutzer {{Link2FU|448|Adam}} in {{Link2Forum|Topic=20280|Message=138200|LinkText=diesem Forenbeitrag}}
|-
| ''V300KW3''
| ''???''
| [https://forum.fhem.de/index.php?action=dlattach;topic=20280.0;attach=23767 V300KW3_V0002.cfg]
| Drei Heizkreise; von Benutzer {{Link2FU|336|Gunther}} in {{Link2Forum|Topic=20280|Message=234515|LinkText=diesem Forenbeitrag}} beschrieben
<!-- Schablone für neue Tabellenzeilen
<!-- Schablone für neue Tabellenzeilen
|-  
|-  
Zeile 33: Zeile 93:
| Quelle / Erläuterungen
| Quelle / Erläuterungen
-->
-->
|-
|colspan="4"|Bitte beachten: ''kursiv gesetzte Werte'' sind '''nicht verifiziert'''!
|}
|}


Zeile 45: Zeile 107:


== Links ==
== Links ==
* {{Link2Forum|Topic=20280|LinkText=Forenthema zu diesem Modul}}
* Dokumentation der [http://openv.wikispaces.com/Protokolle Heizungsprotokolle]] ("300", "KW", "GWG")
* {{Link2Forum|Topic=20280|Message=611057|LinkText=Forenbeitrag zu Adressen, Gerätetypen, Herstellerinfos}}


[[Kategorie:Heizungssteuerung]]
[[Kategorie:Heizungssteuerung]]

Aktuelle Version vom 15. März 2021, 19:24 Uhr

VCONTROL
Zweck / Funktion
Modul für Viessman Vitotronic Steuerung
Allgemein
Typ Gerätemodul
Details
Dokumentation EN / DE
Thema
Support (Forum) Heizungssteuerung/Raumklima
Modulname 89_VCONTROL.pm
Ersteller Adam (Forum /Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

VCONTROL ist ein Modul zur Abfrage und Steuerung einer Viessmann Vitotronic Heizungssteuerung über einen Optolink Adapter.

Entwicklungsstatus des Moduls

Das "offizielle" Modul wurde am 10.7.2016 letztmalig aktualisiert. Es gibt mindestens die folgende inoffizielle Versionen:

Konfiguration

Zur Konfiguration wird eine Textdatei verwendet, die drei Typen von Einträgen enthalten kann.

Syntax

Emblem-question-yellow.svgAchtung! Die Syntax für VCONTROL und VCONTROL300 unterscheidet sich voneinander in der Abfolge der Parameter und in der Kodierung der Adresse. Konfigurationsdateien können daher nicht eins zu eins übernommen werden, sondern müssen ggf. manuell umformatiert werden!

Ein Eintrag nimmt immer eine komplette einzelne Zeile ein und hat eines der folgenden Formate: 

# Kommentar...
POLL, <adresse>, <parse-methode>, <divisor>, <reading>, <kumulationsmethode>
SET, <setname>, <adresse>, <adresstyp>, <multiplikator>, <nextset|day>

mit den folgenden Bedeutungen und möglichen Werten:

#
Kommentarzeile
POLL
Befehl zum Holen / Lesen von Daten aus der Steuerung
<adresse>
hexadezimal, Präfix+interne Adresse+Länge einer Variablen in der Steuerung (z.B. x'01F700F802' für die Gerätekennung)
<parse-methode>
Typ der Variablen an der spezifizierten Adresse; mögliche Werte sind z.B. 1ByteS (1 Byte mit Vorzeichen), 2ByteU (2 Byte ohne Vorzeichen), 1ByteH (1 Byte, hexadezimal), mode (on oder off), date (8 Byte Datumswert), timer (8 Byte Timerwert)
<divisor>
Wert, durch den der geholte Variablenwert geteilt werden soll
<reading>
Name des Readings, unter dem der geholte Wert im FHEM Device abgelegt werden soll
<kumulationsmethode>
gibt an, ob die gelesenen Werte über den Tag kumuliert werden sollen (day) oder nicht (-); sofern kumuliert wird, werden mehrere readings erzeugt und an den Readingnamen DayStart, Today und LastDay angehängt
SET
Befehl zum Setzen von Daten in der Steuerung
<setname>
Name des FHEM readings, dessen Wert in die Anlage geschrieben
<adresstyp>
entspricht der <parse-methode> eines POLL Befehls
<multiplikator>
Gegenstück zum <divisor> bei einem POLL Befehl

werden soll

<nextset|day|->
spezifiziert entweder einen Folge-SET Befehl, einen (Wochen-)Tag (MO|DI|MI|DO|FR|SA|SO) oder "keine weitere Aktion" (-)

Beispiele

Holen der Solltemperatur

POLL, Temperatur_Haus, 01F7230601, 1ByteU, 1, -

Die ein Byte lange Solltemperatur von Adresse 2306 soll ohne Division geholt werden und in das reading Temperatur_Haus gesetzt werden.

Setzen der Solltemperatur

SET, Temperatur_Haus, 01F4230601, 1ByteU, -

Solltemperatur von Adresse 2306 soll mit dem Wert des readings Temperatur_Haus gefüllt werden.

Muster-Konfigurationsdateien

Die Inhalte der Konfigurationsdatei sind nicht nur abhängig davon, ob VCONTROL oder VCONTROL300 verwendet wird, sondern auch von der spezifischen installierten Heizungssteuerung/-regelung. Für einige Konstellationen finden sich an unterschiedlichen Stellen (leider zumindest bisher keine zentrale Ablagestelle) fertig ausgefüllte Konfigurationsdateien. Hier eine Liste bekannter Konfigurationsdateien im VCONTROL-Format:

Gerätename Kennung Link Erläuterungen
unbekannt unbekannt 99_VCONTROL.cfg Benutzer Adam in diesem Forenbeitrag
Vitodens 222-W B2LB 20CB vcontrol.cfg Benutzer mmi - siehe Info im Forum!
V200KW1 ? V200KW1.cfg Benutzer Adam in diesem Forenbeitrag
VPlusHO1 ? VPlusHO1.cfg Benutzer Adam in diesem Forenbeitrag
VScotHO1 20CB VScotHO1.cfg Benutzer Adam in diesem Forenbeitrag
V200WO1B WO1B V200WO1B.cfg Benutzer Adam in diesem Forenbeitrag
V300KW3 ??? V300KW3_V0002.cfg Drei Heizkreise; von Benutzer Gunther in diesem Forenbeitrag beschrieben
Bitte beachten: kursiv gesetzte Werte sind nicht verifiziert!

Zusätzliche Materialien

Plot-Definitionen

Beispiele für Plot-Definitionen finden sich an folgenden Stellen:

readingsGroup Definitionen

Beispiele für readingsGroup-Definitionen zur Darstellung der Informationen aus der Heizungssteuerung finden sich an folgenden Stellen:

  • in diesem Forenbeitrag; mit Screenshots; auch Beispiel zur Bedienung der Heizung über eine readingsGroup

Links

Abgerufen von „http://wiki.fhem.de/w/index.php?title=VCONTROL&oldid=35234“