VCONTROL300: Unterschied zwischen den Versionen

Aus FHEMWiki
(Erste Version der Seite)
 
K (VitovalorC3TB Konfiguration in eigene Seite ausgelagert)
 
(6 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Todo|Es müssen noch die -300 spezifischen Informationen von der Seite [[Vitotronic 200 (Viessmann Heizungssteuerung)]] hierher übernommen (und dann auf der Vitotronic Seite entfernt) 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).
{{Hinweis|Das Modul 89_VCONTROL300 ist zur Zeit noch nicht im offiziellen FHEM Repository verfügbar. Die vorliegende Wiki-Seite befindet sich im Aufbau.}}
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=x
|ModType=x
|ModForumArea=Heizungssteuerung/Raumklima
|ModForumArea=Heizungssteuerung/Raumklima
Zeile 9: Zeile 8:
|ModOwner=Stephan ({{Link2FU|16142|srxp}})
|ModOwner=Stephan ({{Link2FU|16142|srxp}})
}}
}}
[[VCONTROL300]] ist ein Modul zur Abfrage und Steuerung einer Viessmann Vitotronic 200 Heizung über einen Optolink Adapter. Es basiert auf dem Modul [[VCONTROL]], unterscheidet sich von diesem aber in folgenden Punkten:
[[VCONTROL300]] ist ein Modul zur Abfrage und Steuerung einer Viessmann Vitotronic Heizungssteuerung über einen Optolink Adapter.  
# modifiziertes (Adress-)Format in der Konfigurationsdatei
 
# deutlich schnellere Kommunikation mit der Heizungssteuerung
==Entwicklungsstatus des Moduls==
# zusätzliche (optionale) Parameter für das ''define''
Es basiert auf dem Modul [[VCONTROL]], unterscheidet sich von diesem aber in folgenden Punkten:
# nicht im offiziellen FHEM Repository
#modifiziertes (Adress-)Format in der Konfigurationsdatei
#teilweise geänderte Parameterreihenfolge
#deutlich schnellere Kommunikation mit der Heizungssteuerung
#zusätzliche (optionale) Parameter für das ''define''  
#nicht im offiziellen FHEM Repository
Die grundsätzliche Beschreibung der Funktionsweise, Voraussetzungen und Abhängigkeiten findet sich auf der Seite VCONTROL, hier sollen lediglich die Unterschiede und Abweichungen dokumentiert werden!
Die grundsätzliche Beschreibung der Funktionsweise, Voraussetzungen und Abhängigkeiten findet sich auf der Seite VCONTROL, hier sollen lediglich die Unterschiede und Abweichungen dokumentiert werden!
<br clear=all>
== Entwicklungsstatus des Moduls ==
{{Randnotiz|RNTyp=r|RNText=Die nebenstehende Liste mit unterschiedlichen Versionen zeigt, dass hier ein Wildwuchs entstanden ist und dringend eine verlässliche Konsolidierung, am besten mit Aufnahme als offizielles Modul, erforderlich ist.}}
{{Randnotiz|RNTyp=r|RNText=Die nebenstehende Liste mit unterschiedlichen Versionen zeigt, dass hier ein Wildwuchs entstanden ist und dringend eine verlässliche Konsolidierung, am besten mit Aufnahme als offizielles Modul, erforderlich ist.}}
Da VCONTROL300 bisher (Stand 12/2019) kein offizielles FHEM Modul ist, existieren diverse Varianten, die hauptsächlich über das Forum zu beziehen sind (und sich '''nicht''' zuverlässig über die Versionsinformation unterscheiden lassen!):
Da VCONTROL300 bisher (Stand 12/2022) kein offizielles FHEM Modul ist, existieren diverse Varianten, die hauptsächlich über das Forum zu beziehen sind (und sich '''nicht''' zuverlässig über die Versionsinformation unterscheiden lassen!):  
* Version mit [[configdb]]-Unterstützung (von {{Link2FU|19608|crispyduck}} in {{Link2Forum|Topic=67744|Message=740396|LinkText=diesem Forenbeitrag}})
*Version mit [[configdb]]-Unterstützung (von {{Link2FU|19608|crispyduck}} in {{Link2Forum|Topic=67744|Message=740396|LinkText=diesem Forenbeitrag}})
* Version vom 18.1.2018 mit Korrekturen durch {{Link2FU|11806|Patrick.S}} in {{Link2Forum|Topic=67744|Message=715724|LinkText=diesem Forenbeitrag}}
*Version vom 18.1.2018 mit Korrekturen durch {{Link2FU|11806|Patrick.S}} in {{Link2Forum|Topic=67744|Message=715724|LinkText=diesem Forenbeitrag}}
* Version vom 10.2.2018 mit Korrekturen durch {{Link2FU|34014|300P}} in {{Link2Forum|Topic=67744|Message=764325|LinkText=diesem Forenbeitrag}}
*Version vom 10.2.2018 mit Korrekturen durch {{Link2FU|34014|300P}} in {{Link2Forum|Topic=67744|Message=764325|LinkText=diesem Forenbeitrag}}
*Version '''V09.07''' vom 11.6.2020 mit diversen Korrekturen und Einführung des Attributs '''''FCUSummeroptimization''''' (nur für VITOVALOR 300P!) durch {{Link2FU|34014|300P}} in {{Link2Forum|Topic=67744|Message=1063468|LinkText=diesem Forenbeitrag}}
*Version '''V13.1''' vom 9.9.2021 mit speziellen Anpassungen zu VITOVALOR durch {{Link2FU|34014|300P}} in {{Link2Forum|Topic=67744|Message=1173952|LinkText=diesem Forenbeitrag}}


== Unterschiede zum Modul VCONTROL ==
==Unterschiede zum Modul VCONTROL ==
=== Konfigurationsdatei ===
===Konfigurationsdatei ===
VCONTROL300 benutzt ein verkürztes Format für die Angabe der Speicheradressen in der Heizungssteuerung:
VCONTROL300 benutzt ein verkürztes Format für die Angabe der Speicheradressen in der Heizungssteuerung:
<pre>
<pre>
Zeile 32: Zeile 34:
</pre>
</pre>


=== Kommunikation mit der Heizungssteuerung ===
===Kommunikation mit der Heizungssteuerung===
Durch eine veränderte Implementierung der Kommunikation mit der Heizungssteuerung werden die Befehle aus der Konfigurationsdatei erheblich schneller abgearbeitet.  
Durch eine veränderte Implementierung der Kommunikation mit der Heizungssteuerung werden die Befehle aus der Konfigurationsdatei erheblich schneller als im Modul VCONTROL abgearbeitet.  
 
=== Parameter des Define===
<code>define <name> VCONTROL300 <serial-device/LAN-Device:port> <configfile> [<intervall>] </code>
:;''<serial-device/LAN-Device:port>''
::USB Port (e.g. com4, /dev/ttyUSB3) or TCPIP:portnumber (USB-Port wird bevorzugt empfohlen)
:;''<configfile>''
::Pfad zur Konfigurationdatei mit den dort zu hinterlegenden VIESSMANN DATAPIONT-Adressen (memory-Addresses)
::Der Pfad-Standardwert -ohne jegliche Angabe- ist direkt im Stammverzeichnis von FHEM.
:;''<intervall>''
::Poll Interval in Sekunden. Empfohlen wird 300 (Sekunden) und keine dauerhaften kurze zyklische Write's.
:;''<protocol>''
::Definiert welches Protokoll verwendet werden soll. Mögliche Werte sind KW und 300 (keine Angabe = Standard = 300).
:; ''<protocolparam>''
::Definiert zusätzliche Paramter für das Protokoll. Standardwert ist "" LEER. (Bislang keine Anwendung bekannt / keine Bedeutung)


=== Parameter des Define ===
====Beispiel:====
VCONTROL300 unterstützt für die Definition zwei zusätzliche optionale Parameter (die in der Signatur des ''define'' fehlen):
Der OptoLink Adapter liegt als serial device auf com4, Abruf (POLL/SET) alle 360 Sekunden (6 Minuten), Konfigurationdateiname ist "VCONTROL300_FCU.cfg", die Datei liegt im FHEM root Verzeichnis, Protokoll 300.
;''<protocol>''
:das zu verwendende Protokoll; mögliche Werte sind '''kw''' und '''300''', wobei '''kw''' der Standardwert ist
;''<protocolparam>''
:Zusätzliche Parameter für das Protokoll; diese Parameter sind nicht weiter erläutert


== Muster-Konfigurationsdateien ==
;Windows:                                                               
:<code>define FCU VCONTROL300 com4 VCONTROL300_FCU.cfg 360 300</code>
;Linux:
:<code>define FCU VCONTROL300 /dev/ttyUSB3 VCONTROL300_FCU.cfg 360 300</code>
 
OptoLink remote via serial2net on target host:
:<code>define FCU VCONTROL300 <IP>:<Port> VCONTROL300_FCU.cfg 360 300</code>
 
==Konfiguration==
{{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!}}
Zur Konfiguration wird eine Textdatei verwendet, die drei Typen von Einträgen enthalten kann.
 
===Syntax ===
Ein Eintrag nimmt immer eine komplette einzelne Zeile ein und hat eines der folgenden Formate:
# Kommentar...
POLL, <adresse>, <parse-methode>, <divisor>, <reading>, <kumulationsmethode>
SET, <adresse>, <adresstyp>, <multiplikator>, <setname>, <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, interne Adresse einer Variablen in der Steuerung (z.B.  x'00F8' 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
;<adresstyp>:entspricht der <parse-methode> eines POLL Befehls
;<multiplikator>:Gegenstück zum <divisor> bei einem POLL Befehl
;<setname>:Name des FHEM readings, dessen Wert in die Anlage geschrieben
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, 2306, 1ByteU, 1, Temperatur_Haus  , -</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, 2306, 1ByteU, 1, Temperatur_Haus, -</code>
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 verschiedene Konstellationen finden sich an unterschiedlichen Stellen (leider zumindest bisher keine zentrale Ablagestelle) fertig ausgefüllte Konfigurationsdateien. Hier eine Liste bekannter Konfigurationsdateien im ''VCONTOL300''-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 verschiedene Konstellationen finden sich an unterschiedlichen Stellen (leider zumindest bisher keine zentrale Ablagestelle) fertig ausgefüllte Konfigurationsdateien. Hier eine Liste bekannter Konfigurationsdateien im ''VCONTOL300''-Format:
{| class="wikitable"
{| class="wikitable"
|-
|-
! Gerätename !! Kennung !! Link !! Erläuterungen
!Gerätename
!Kennung!!Link!!Erläuterungen
|-
|''Vitodens 300 B3HB''
|''???''
|{{Link2Forum|Topic=20280|Message=780323|LinkText=Forum}}
|Benutzer {{Link2FU|3160|tmp88}}; Disclaimer im Link beachten!
|-
|-
| Vitodens 300 B3HB
|Vitodens 222-F
| ???
|HO1A
| {{Link2Forum|Topic=20280|Message=780323|LinkText=Forum}}
|{{Link2Forum|Topic=20280|Message=780323|LinkText=Forum}}
| Benutzer {{Link2FU|3160|tmp88}}; Disclaimer im Link beachten!
|Benutzer {{Link2FU|25957|Andies}} in {{Link2Forum|Topic=67744|Message=692581|LinkText=diesem Forenbeitrag}}
|-
|Vitotronic 200
|KW6B
|{{Link2Forum|Topic=67744|Message=1249908|LinkText=Forum}}
|Benutzer {{Link2FU|43845|GunterB}} in {{Link2Forum|Topic=67744|Message=1249908|LinkText=diesem Forenbeitrag}}
|-  
|-  
|Solarthermie
|VScotH01
|{{Link2Forum|Topic=67744|Message=1232414|LinkText=Copy/Paste}}
|Adressen für Daten aus Solarthermie; Benutzer {{Link2FU|20404|guhu}} in {{Link2Forum|Topic=67744|Message=1232414|LinkText=diesem Forenbeitrag}}
|-
| VITOVALOR
| C3TB
| [[VCONTROL300-VitovalorC3TB]]
| [[Benutzer:300P]]; Viessmann Vitovalor-300P Typ C3TB mit Vitotronic 200-HOE3 mit 3 Heizkreisen plus Warmwasser
<!-- Schablone für neue Tabellenzeilen
<!-- Schablone für neue Tabellenzeilen
|-  
|-  
Zeile 62: Zeile 135:
|}
|}


== Zusätzliche Materialien ==
==Zusätzliche Materialien==
Bisher sind keine ''VCONTROL300''-spezifischen Materialien bekannt, daher bitte wenn möglich die entsprechenden [[VCONTROL]] Materialien verwenden (oder ggf. anpassen und dann hier dokumentieren).
Bisher sind keine ''VCONTROL300''-spezifischen Materialien bekannt, daher bitte wenn möglich die entsprechenden [[VCONTROL]] Materialien verwenden (oder ggf. anpassen und dann hier dokumentieren).


== Links ==
==Links==
 


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

Aktuelle Version vom 17. April 2023, 10:37 Uhr

Info blue.png
Das Modul 89_VCONTROL300 ist zur Zeit noch nicht im offiziellen FHEM Repository verfügbar. Die vorliegende Wiki-Seite befindet sich im Aufbau.


VCONTROL300
Zweck / Funktion
Modul für Viessman Vitotronic Steuerung
Allgemein
Typ Inoffiziell
Details
Dokumentation Thema
Support (Forum) Heizungssteuerung/Raumklima
Modulname 89_VCONTROL300.pm
Ersteller Stephan (srxp )
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

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

Entwicklungsstatus des Moduls

Es basiert auf dem Modul VCONTROL, unterscheidet sich von diesem aber in folgenden Punkten:

  1. modifiziertes (Adress-)Format in der Konfigurationsdatei
  2. teilweise geänderte Parameterreihenfolge
  3. deutlich schnellere Kommunikation mit der Heizungssteuerung
  4. zusätzliche (optionale) Parameter für das define
  5. nicht im offiziellen FHEM Repository

Die grundsätzliche Beschreibung der Funktionsweise, Voraussetzungen und Abhängigkeiten findet sich auf der Seite VCONTROL, hier sollen lediglich die Unterschiede und Abweichungen dokumentiert werden!

X mark.svgDie nebenstehende Liste mit unterschiedlichen Versionen zeigt, dass hier ein Wildwuchs entstanden ist und dringend eine verlässliche Konsolidierung, am besten mit Aufnahme als offizielles Modul, erforderlich ist.

Da VCONTROL300 bisher (Stand 12/2022) kein offizielles FHEM Modul ist, existieren diverse Varianten, die hauptsächlich über das Forum zu beziehen sind (und sich nicht zuverlässig über die Versionsinformation unterscheiden lassen!):

Unterschiede zum Modul VCONTROL

Konfigurationsdatei

VCONTROL300 benutzt ein verkürztes Format für die Angabe der Speicheradressen in der Heizungssteuerung:

 VCONTROL        VCONTROL300   Bedeutung / "Reading"    
 01F7080802      0808          Abgastemperatur

Kommunikation mit der Heizungssteuerung

Durch eine veränderte Implementierung der Kommunikation mit der Heizungssteuerung werden die Befehle aus der Konfigurationsdatei erheblich schneller als im Modul VCONTROL abgearbeitet.

Parameter des Define

define <name> VCONTROL300 <serial-device/LAN-Device:port> <configfile> [<intervall>]

<serial-device/LAN-Device:port>
USB Port (e.g. com4, /dev/ttyUSB3) or TCPIP:portnumber (USB-Port wird bevorzugt empfohlen)
<configfile>
Pfad zur Konfigurationdatei mit den dort zu hinterlegenden VIESSMANN DATAPIONT-Adressen (memory-Addresses)
Der Pfad-Standardwert -ohne jegliche Angabe- ist direkt im Stammverzeichnis von FHEM.
<intervall>
Poll Interval in Sekunden. Empfohlen wird 300 (Sekunden) und keine dauerhaften kurze zyklische Write's.
<protocol>
Definiert welches Protokoll verwendet werden soll. Mögliche Werte sind KW und 300 (keine Angabe = Standard = 300).
<protocolparam>
Definiert zusätzliche Paramter für das Protokoll. Standardwert ist "" LEER. (Bislang keine Anwendung bekannt / keine Bedeutung)

Beispiel:

Der OptoLink Adapter liegt als serial device auf com4, Abruf (POLL/SET) alle 360 Sekunden (6 Minuten), Konfigurationdateiname ist "VCONTROL300_FCU.cfg", die Datei liegt im FHEM root Verzeichnis, Protokoll 300.

Windows
define FCU VCONTROL300 com4 VCONTROL300_FCU.cfg 360 300
Linux
define FCU VCONTROL300 /dev/ttyUSB3 VCONTROL300_FCU.cfg 360 300

OptoLink remote via serial2net on target host:

define FCU VCONTROL300 <IP>:<Port> VCONTROL300_FCU.cfg 360 300

Konfiguration

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!

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

Syntax

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

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

mit den folgenden Bedeutungen und möglichen Werten:

#
Kommentarzeile
POLL
Befehl zum Holen / Lesen von Daten aus der Steuerung
<adresse>
hexadezimal, interne Adresse einer Variablen in der Steuerung (z.B. x'00F8' 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
<adresstyp>
entspricht der <parse-methode> eines POLL Befehls
<multiplikator>
Gegenstück zum <divisor> bei einem POLL Befehl
<setname>
Name des FHEM readings, dessen Wert in die Anlage geschrieben

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, 2306, 1ByteU, 1, Temperatur_Haus , -

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, 2306, 1ByteU, 1, Temperatur_Haus, -

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 verschiedene Konstellationen finden sich an unterschiedlichen Stellen (leider zumindest bisher keine zentrale Ablagestelle) fertig ausgefüllte Konfigurationsdateien. Hier eine Liste bekannter Konfigurationsdateien im VCONTOL300-Format:

Gerätename Kennung Link Erläuterungen
Vitodens 300 B3HB ??? Forum Benutzer tmp88  ; Disclaimer im Link beachten!
Vitodens 222-F HO1A Forum Benutzer Andies in diesem Forenbeitrag
Vitotronic 200 KW6B Forum Benutzer GunterB in diesem Forenbeitrag
Solarthermie VScotH01 Copy/Paste Adressen für Daten aus Solarthermie; Benutzer guhu in diesem Forenbeitrag
VITOVALOR C3TB VCONTROL300-VitovalorC3TB Benutzer:300P; Viessmann Vitovalor-300P Typ C3TB mit Vitotronic 200-HOE3 mit 3 Heizkreisen plus Warmwasser

Zusätzliche Materialien

Bisher sind keine VCONTROL300-spezifischen Materialien bekannt, daher bitte wenn möglich die entsprechenden VCONTROL Materialien verwenden (oder ggf. anpassen und dann hier dokumentieren).

Links