VCONTROL300 - Versionsgeschichte

Ph1959de: VitovalorC3TB Konfiguration in eigene Seite ausgelagert

2023-04-17T09:37:09Z

VitovalorC3TB Konfiguration in eigene Seite ausgelagert

Ph1959de: syntaxhighlight korrigiert, Formatierung teilweise überarbeitet

2023-04-13T07:41:49Z

syntaxhighlight korrigiert, Formatierung teilweise überarbeitet

← Nächstältere Version		Version vom 13. April 2023, 09:41 Uhr
Zeile 1:		Zeile 1:
	~~{{Baustelle}}~~
	{{Hinweis\|Das Modul 89_VCONTROL300 ist zur Zeit noch nicht im offiziellen FHEM Repository verfügbar. Die vorliegende Wiki-Seite befindet sich im Aufbau.}}		{{Hinweis\|Das Modul 89_VCONTROL300 ist zur Zeit noch nicht im offiziellen FHEM Repository verfügbar. Die vorliegende Wiki-Seite befindet sich im Aufbau.}}

	{{Infobox Modul		{{Infobox Modul
	\|ModPurpose=Modul für Viessman Vitotronic Steuerung		\|ModPurpose=Modul für Viessman Vitotronic Steuerung
Zeile 40:		Zeile 38:

	=== Parameter des Define===		=== 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)

	~~define <name> VCONTROL300 <serial-device/LAN-Device~~:~~port> <configfile> [<intervall>]~~		====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.
	~~;''<~~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~~.		;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>

	~~;''~~<~~protocol~~>''		OptoLink remote via serial2net on target host:
			:<code>define FCU VCONTROL300 <IP>:<Port> VCONTROL300_FCU.cfg 360 300</code>

	~~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:======~~
	~~serial device com4, Abruf (POLL/SET) alle 360 Sekunden (6 Minuten), Konfigurationdateiname ist "VCONTROL300_FCU.cfg", die Datei liegt im FHEM root Verezichnis, Protokoll 300.~~

	~~Windows: define FCU VCONTROL300 com4 VCONTROL300_FCU.cfg 360 300~~

	~~Linux: define FCU VCONTROL300 /dev/ttyUSB3 VCONTROL300_FCU.cfg 360 300~~

	~~Remote via serial2net on target host: define FCU VCONTROL300 <IP>:<Port> VCONTROL300_FCU.cfg 360 300~~
	==Konfiguration==		==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!}}		{{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!}}
Zeile 142:		Zeile 129:
	-->		-->
	\|}		\|}


	====Beispiel einer cfg-Datei für eine Brennstoffzelle (VITOVALOR 300-P Typ C3TB)====		====Beispiel einer cfg-Datei für eine Brennstoffzelle (VITOVALOR 300-P Typ C3TB)====
	Einige Adressen in dieser Konfigurationsdatei sind nicht zu 100% überprüft ob die Namensgebung richtig ist. Es sollte auch vermieden werden, zu viele der darin ~~deaktiven~~ (mit # am Zeilenanfang) POLL-Werte zu aktivieren. Als Ergebnis werden dann mit Steigerung der Anzahl automatisch Übertragungsfehler auftreten.		Einige Adressen in dieser Konfigurationsdatei sind nicht zu 100% überprüft, ob die Namensgebung richtig ist. Es sollte auch vermieden werden, zu viele der darin (mit # am Zeilenanfang) deaktivierten POLL-Werte zu aktivieren. Als Ergebnis werden dann mit Steigerung der Anzahl automatisch Übertragungsfehler auftreten.

	~~PS:~~		Einige dieser Adressen sind sicherlich für andere Geräte nutzbar
	Einige dieser Adressen sind sicherlich für andere Geräte nutzbar<syntaxhighlight ~~line~~="1">		<syntaxhighlight lang="text" line>
	###############################################################################		###############################################################################
	# Anlage Viessmann Vitovalor-300P Typ C3TB mit Vitotronic 200-HOE3		# Anlage Viessmann Vitovalor-300P Typ C3TB mit Vitotronic 200-HOE3
Zeile 631:		Zeile 617:
	# ENDE SET (speziell Vitovalor300P)		# ENDE SET (speziell Vitovalor300P)
	##############################################################################		##############################################################################
	</syntaxhighlight>		</syntaxhighlight></div>

	==Zusätzliche Materialien==		==Zusätzliche Materialien==

300P: define Beschreibung aktualisiert, Beispielkonfiguration VITOVALOR hinzugefügt, Kleinigkeiten angepasst

2023-04-12T20:41:11Z

define Beschreibung aktualisiert, Beispielkonfiguration VITOVALOR hinzugefügt, Kleinigkeiten angepasst

Änderungen zeigen

Ph1959de: Neue Modulversion verlinkt; weitere Konfigurationsbeispiele

2022-12-12T10:49:01Z

Neue Modulversion verlinkt; weitere Konfigurationsbeispiele

← Nächstältere Version		Version vom 12. Dezember 2022, 12:49 Uhr
Zeile 18:		Zeile 18:
	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!
	{{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 '''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 ==
Zeile 91:		Zeile 92:
	\| Benutzer {{Link2FU\|25957\|Andies}} in {{Link2Forum\|Topic=67744\|Message=692581\|LinkText=diesem Forenbeitrag}}		\| 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}}
	<!-- Schablone für neue Tabellenzeilen		<!-- Schablone für neue Tabellenzeilen
	\|-		\|-

Ph1959de: Aufsplittung der Seite "Vitotronic 200 (Viessmann Heizungssteuerung" - Zwischenstand

2021-03-15T18:24:14Z

Aufsplittung der Seite "Vitotronic 200 (Viessmann Heizungssteuerung" - Zwischenstand

@@ Zeile 1: / Zeile 1: @@
 {{Infobox Modul
-|ModPurpose=Module für Viessman Vitotronic 200
+|ModPurpose=Modul für Viessman Vitotronic Steuerung
 |ModType=x
 |ModForumArea=Heizungssteuerung/Raumklima
@@ Zeile 8: / Zeile 7: @@
 |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
 # 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!
 {{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!):
@@ Zeile 41: / Zeile 41: @@
 ;''<protocolparam>''
 :Zusätzliche Parameter für das Protokoll; diese Parameter sind nicht weiter erläutert
 == Muster-Konfigurationsdateien ==
@@ Zeile 48: / Zeile 81: @@
 ! Gerätename !! Kennung !! Link !! Erläuterungen
 |-
-| Vitodens 300 B3HB
+| ''Vitodens 300 B3HB''
-| ???
+| ''???''
 | {{Link2Forum|Topic=20280|Message=780323|LinkText=Forum}}
 | Benutzer {{Link2FU|3160|tmp88}}; Disclaimer im Link beachten!
 |-
 <!-- Schablone für neue Tabellenzeilen

Ph1959de: Neue Version (V09.07) des Moduls im Forum

2020-06-12T17:29:10Z

Neue Version (V09.07) des Moduls im Forum

← Nächstältere Version		Version vom 12. Juni 2020, 19:29 Uhr
Zeile 22:		Zeile 22:
	* 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}}

	== Unterschiede zum Modul VCONTROL ==		== Unterschiede zum Modul VCONTROL ==

Ph1959de am 3. Dezember 2019 um 11:04 Uhr

2019-12-03T11:04:32Z

← Nächstältere Version		Version vom 3. Dezember 2019, 13:04 Uhr
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).		{{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). <br>Danke, --[[Benutzer:Ph1959de\|Peter]] ([[Benutzer Diskussion:Ph1959de\|Diskussion]]) 12:00, 3. Dez. 2019 (CET)}}
	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=Module für Viessman Vitotronic 200

Ph1959de: Erste Version der Seite

2019-12-03T11:00:13Z

Erste Version der Seite

Neue Seite

{{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).
Danke, --[[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 12:00, 3. Dez. 2019 (CET)}}
{{Infobox Modul
|ModPurpose=Module für Viessman Vitotronic 200
|ModType=x
|ModForumArea=Heizungssteuerung/Raumklima
|ModFTopic=67744
|ModTechName=89_VCONTROL300.pm
|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:
# modifiziertes (Adress-)Format in der Konfigurationsdatei
# 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!

<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.}}
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!):
* 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 10.2.2018 mit Korrekturen durch {{Link2FU|34014|300P}} in {{Link2Forum|Topic=67744|Message=764325|LinkText=diesem Forenbeitrag}}

== Unterschiede zum Modul VCONTROL ==
=== Konfigurationsdatei ===
VCONTROL300 benutzt ein verkürztes Format für die Angabe der Speicheradressen in der Heizungssteuerung:
<pre>
VCONTROL VCONTROL300 Bedeutung / "Reading"
01F7080802 0808 Abgastemperatur
</pre>

=== Kommunikation mit der Heizungssteuerung ===
Durch eine veränderte Implementierung der Kommunikation mit der Heizungssteuerung werden die Befehle aus der Konfigurationsdatei erheblich schneller abgearbeitet.

=== Parameter des Define ===
VCONTROL300 unterstützt für die Definition zwei zusätzliche optionale Parameter (die in der Signatur des ''define'' fehlen):
;''<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 ==
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"
|-
! Gerätename !! Kennung !! Link !! Erläuterungen
|-
| Vitodens 300 B3HB
| ???
| {{Link2Forum|Topic=20280|Message=780323|LinkText=Forum}}
| Benutzer {{Link2FU|3160|tmp88}}; Disclaimer im Link beachten!
|-

|}

== 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 ==

[[Kategorie:Heizungssteuerung]]