Plugin ‚viessmann‘ Konfiguration

plugin logo

Im folgenden sind etwaige Anforderungen und unterstützte Hardware beschrieben. Danach folgt die Beschreibung, wie das Plugin viessmann konfiguriert wird. Außerdem ist im folgenden beschrieben, wie das Plugin in den Item Definitionen genutzt werden kann. [1]

Es handelt sich bei diesem Plugin um ein gateway Plugin.

ACHTUNG: Dieses Plugin ist als develop gekennzeichnet. Es kann daher sein, dass es noch nicht sämtliche Funktionen unterstützt oder noch fehlerhaft ist.

Beschreibung

Lesen und Schreiben von Werten einer Viessmann Heizung

Anforderungen

  • Minimum SmartHomeNG Version: 1.9.5.1

  • Minimum Python Version: 3.6

Konfiguration

Im folgenden ist beschrieben, wie das Plugin viessmann konfiguriert wird. Außerdem ist im folgenden beschrieben, wie das Plugin in den Item Definitionen genutzt werden kann.

Parameter

Das Plugin verfügt über folgende Parameter, die in der Datei ../etc/plugin.yaml konfiguriert werden:

autoreconnect

Verbindung nach Verbindungsabbruch automatisch wiederherstellen

  • Datentyp: bool

  • Standardwert: True

clean_structs

  • Datentyp: bool

  • Standardwert: True

command_class

  • Datentyp: str

  • Standardwert: SDPCommandViessmann

cycle

  • Datentyp: num

  • Standardwert: 30

loop_guard_count

Anzahl identischer Schreibversuche im Zeitfenster, die den Loop-Guard auslösen (0 = deaktiviert)

  • Datentyp: num

  • Standardwert: 5

loop_guard_source

Wenn gesetzt, zählt der Loop-Guard nur Schreibversuche, deren „caller“-String mit diesem Präfix beginnt (z.B. „MQTT“). Schreibvorgänge anderer Aufrufer werden immer durchgelassen.

  • Datentyp: str

loop_guard_window

Zeitfenster in Sekunden für den Loop-Guard

  • Datentyp: num

  • Standardwert: 5.0

model

  • Datentyp: foo

  • Standardwert: None

serialport

  • Datentyp: str

suspend_item

Item-Pfad für das Suspend-Item

  • Datentyp: str

viess_proto

  • Datentyp: str

  • Standardwert: P300

  • Mögliche Werte:

    • P300

    • KW

Item Attribute

Das Plugin unterstützt folgende Item Attribute, die in den Dateien im Verzeichnis ../items verwendet werden:

viess_command

Legt das angegebene Kommando für das Item fest

  • Datentyp: str

viess_custom1

Der Inhalt dieses Items kann vom jeweiligen Gerät für spezielle Zwecke genutzt werden. Durch den Parameter „recursive_custom: 1“ in der Geräte-Konfiguration wird der Wert rekursiv für alle Unteritems gesetzt.

  • Datentyp: str

viess_custom2

Der Inhalt dieses Items kann vom jeweiligen Gerät für spezielle Zwecke genutzt werden. Durch den Parameter „recursive_custom: 2“ in der Geräte-Konfiguration wird der Wert rekursiv für alle Unteritems gesetzt.

  • Datentyp: str

viess_custom3

Der Inhalt dieses Items kann vom jeweiligen Gerät für spezielle Zwecke genutzt werden. Durch den Parameter „recursive_custom: 3“ in der Geräte-Konfiguration wird der Wert rekursiv für alle Unteritems gesetzt.

  • Datentyp: str

viess_lookup

Der Inhalt der Lookup-Tabelle mit dem angegebenen Namen wird beim Start einmalig als dict oder list in das Item geschrieben. Durch Anhängen von „#<mode>“ an den Namen der Tabelle kann die Art der Tabelle ausgewählt werden: - fwd liefert die Tabelle Gerät -> SmartHomeNG (Standard) - rev liefert die Tabelle SmartHomeNG -> Gerät - rci liefert die Tabelle SmarthomeNG -> Gerät in Kleinbuchstaben - list liefert die Liste der Namen für SmartHomeNG

  • Datentyp: str

viess_read

Liest/erhält Werte vom Gerät

  • Datentyp: bool

viess_read_cycle

Konfiguriert ein individuelles Intervall in Sekunden für regelmäßiges Lesen

  • Datentyp: num

viess_read_cyclic

Konfiguriert regelmäßiges Lesen mit dem plugin-weiten Intervall

  • Datentyp: bool

viess_read_group

Weist das Item der angegebenen Gruppe zum gesammelten Lesen zu. Gruppe kann int oder str sein, mehrere Gruppen können als Liste angegeben werden.

  • Datentyp: list(str)

viess_read_group_trigger

Wenn diesem Item ein beliebiger Wert zugewiesen wird, werden alle zum Lesen konfigurierten Items der angegebenen Gruppe neu vom Gerät gelesen, bei Gruppe 0 werden alle zum Lesen konfigurierten Items neu gelesen. Das Item kann nicht gleichzeitig mit viess_command belegt werden.

  • Datentyp: str

viess_read_initial

Legt fest, dass der Wert beim Start vom Gerät gelesen wird

  • Datentyp: bool

viess_readafterwrite

Nach dem Schreiben des Items den Wert nach der angegebenen Anzahl von Sekunden automatisch neu vom Gerät laden

  • Datentyp: num

viess_write

Änderung des Items werden an das Gerät gesendet

  • Datentyp: bool

Item-Structs

Das Plugin stellt die folgenden Item-Structs zur Verfügung. Diese Informationen sind aus der plugin.yaml entnommen und möglicherweise nicht vollständig.

ALL

  • ALL (foo, —)

    • anlagentyp (str, —)

V200HO1C

  • V200HO1C (foo, —)

    • anlagentyp (str, —)

    • allgemein (foo, —)

      • read (bool, —)

      • anlagenschema (num, —)

      • frostgefahr (num, —)

      • anlagenleistung (num, —)

      • temperatur (foo, —)

        • read (bool, —)

        • aussen_tp (num, —)

        • aussen_dp (num, —)

    • kessel (foo, —)

      • read (bool, —)

      • tp (num, —)

      • soll (num, —)

      • abgastemperatur (num, —)

    • fehler (foo, —)

      • read (bool, —)

      • sammelstoerung (num, —)

      • error0 (num, —)

      • error1 (num, —)

      • error2 (num, —)

      • error3 (num, —)

      • error4 (num, —)

      • error5 (num, —)

      • error6 (num, —)

      • error7 (num, —)

      • error8 (num, —)

      • error9 (num, —)

    • pumpen (foo, —)

      • read (bool, —)

      • speicherlade (bool, —)

      • zirkulation (bool, —)

      • intern (bool, —)

      • heizkreis_1 (bool, —)

      • heizkreis_2 (bool, —)

    • brenner (foo, —)

      • read (bool, —)

      • starts (num, —)

      • leistung (num, —)

      • betriebsstunden (num, —)

    • solar (foo, —)

      • read (bool, —)

      • pumpe (bool, —)

      • kollektortemperatur (num, —)

      • speichertemperatur (num, —)

      • betriebsstunden (num, —)

      • waermemenge (num, —)

      • ausbeute (num, —)

    • heizkreis (foo, —)

      • read (bool, —)

      • 1 (foo, —)

        • read (bool, —)

        • betriebsart (num, —)

        • heizart (num, —)

        • temperatur (foo, —)

          • read (bool, —)

          • vorlauf_soll (num, —)

          • vorlauf_ist (num, —)

      • 2 (foo, —)

        • read (bool, —)

        • betriebsart (num, —)

        • heizart (num, —)

        • temperatur (foo, —)

          • read (bool, —)

          • vorlauf_soll (num, —)

          • vorlauf_ist (num, —)

    • warmwasser (foo, —)

      • read (bool, —)

      • ist (num, —)

      • soll (num, —)

      • austritt (num, —)

V200KO1B

  • V200KO1B (foo, —)

    • anlagentyp (str, —)

    • allgemein (foo, —)

      • read (bool, —)

      • temperatur (foo, —)

        • read (bool, —)

        • aussen (num, —)

        • aussen_tp (num, —)

        • aussen_dp (num, —)

        • speicher_ladesensor (num, —)

        • auslauf (num, —)

        • abgas (num, —)

        • gem_vorlauf (num, —)

      • relais_k12 (bool, —)

      • eingang_0-10_v (bool, —)

      • ea1_kontakt_0 (bool, —)

      • ea1_kontakt_1 (bool, —)

      • ea1_kontakt_2 (bool, —)

      • ea1_externer_soll_0-10v (bool, —)

      • ea1_relais_0 (bool, —)

      • am1_ausgang_1 (bool, —)

      • am1_ausgang_2 (bool, —)

      • tempkoffset (num, —)

      • systemtime (bool, —)

      • anlagenschema (num, —)

      • inventory (str, —)

      • ctrlid (num, —)

    • kessel (foo, —)

      • read (bool, —)

      • ist (num, —)

      • tp (num, —)

      • soll (num, —)

    • fehler (foo, —)

      • read (bool, —)

      • sammelstoerung (num, —)

      • error0 (num, —)

      • error1 (num, —)

      • error2 (num, —)

      • error3 (num, —)

      • error4 (num, —)

      • error5 (num, —)

      • error6 (num, —)

      • error7 (num, —)

      • error8 (num, —)

      • error9 (num, —)

    • pumpen (foo, —)

      • read (bool, —)

      • speicherlade (bool, —)

      • zirkulation (bool, —)

      • intern (bool, —)

      • heizkreis_a1m1 (bool, —)

      • heizkreis_a1m1_rpm (bool, —)

      • heizkreis_m2 (bool, —)

      • heizkreis_m2_rpm (bool, —)

      • relais_status (bool, —)

    • brenner (foo, —)

      • read (bool, —)

      • starts (num, —)

      • betriebsstunden (num, —)

      • status_1 (bool, —)

      • status_2 (bool, —)

      • oeldurchsatz (num, —)

      • oelverbrauch (num, —)

    • solar (foo, —)

      • read (bool, —)

      • nachladeunterdrueckung (bool, —)

      • pumpe (bool, —)

      • kollektortemperatur (num, —)

      • speichertemperatur (num, —)

      • betriebsstunden (num, —)

      • steuerung (num, —)

    • heizkreis (foo, —)

      • read (bool, —)

      • a1m1 (foo, —)

        • read (bool, —)

        • temperatur (foo, —)

          • read (bool, —)

          • raum (foo, —)

            • read (bool, —)

            • ist (num, —)

            • soll_normalbetrieb (num, —)

            • soll_red_betrieb (num, —)

            • soll_party_betrieb (num, —)

          • vorlauf (foo, —)

            • read (bool, —)

            • ist (num, —)

            • soll (num, —)

            • min (num, —)

            • max (num, —)

            • erhoehung_soll (num, —)

            • erhoehung_zeit (num, —)

          • grenze_red_betrieb (num, —)

          • grenze_red_raumtemp (num, —)

        • status (foo, —)

          • read (bool, —)

          • aktuelle_betriebsart (num, —)

          • betriebsart (num, —)

          • sparbetrieb (num, —)

          • zustand_sparbetrieb (num, —)

          • partybetrieb (num, —)

          • zustand_partybetrieb (num, —)

          • statusfrost (num, —)

          • externe_raumsolltemperatur_normal (num, —)

          • externe_betriebsartenumschaltung (num, —)

          • speichervorrang (num, —)

          • frostschutzgrenze (num, —)

          • frostschutz (num, —)

          • heizkreispumpenlogik (num, —)

          • sparschaltung (num, —)

          • mischersparfunktion (num, —)

          • pumpenstillstandzeit (num, —)

        • heizkennlinie (foo, —)

          • read (bool, —)

          • neigung (num, —)

          • niveau (num, —)

        • partybetrieb_zeitbegrenzung (num, —)

      • m2 (foo, —)

        • read (bool, —)

        • temperatur (foo, —)

          • read (bool, —)

          • raum (foo, —)

            • read (bool, —)

            • ist (num, —)

            • soll_normalbetrieb (num, —)

            • soll_red_betrieb (num, —)

            • soll_party_betrieb (num, —)

          • vorlauf (foo, —)

            • read (bool, —)

            • ist (num, —)

            • soll (num, —)

            • min (num, —)

            • max (num, —)

            • erhoehung_soll (num, —)

            • erhoehung_zeit (num, —)

          • grenze_red_betrieb (num, —)

          • grenze_red_raumtemp (num, —)

        • status (foo, —)

          • read (bool, —)

          • aktuelle_betriebsart (num, —)

          • betriebsart (num, —)

          • sparbetrieb (num, —)

          • zustand_sparbetrieb (num, —)

          • partybetrieb (num, —)

          • zustand_partybetrieb (num, —)

          • statusfrost (num, —)

          • externe_raumsolltemperatur_normal (num, —)

          • externe_betriebsartenumschaltung (num, —)

          • speichervorrang (num, —)

          • frostschutzgrenze (num, —)

          • frostschutz (num, —)

          • heizkreispumpenlogik (num, —)

          • sparschaltung (num, —)

          • mischersparfunktion (num, —)

          • pumpenstillstandzeit (num, —)

        • heizkennlinie (foo, —)

          • read (bool, —)

          • neigung (num, —)

          • niveau (num, —)

        • partybetrieb_zeitbegrenzung (num, —)

    • warmwasser (foo, —)

      • read (bool, —)

      • ist (num, —)

      • soll (num, —)

      • status (bool, —)

      • pumpennachlauf (num, —)

    • ferienprogramm (foo, —)

      • read (bool, —)

      • a1m1 (foo, —)

        • read (bool, —)

        • status (num, —)

        • abreisetag (bool, —)

        • rückreisetag (bool, —)

      • m2 (foo, —)

        • read (bool, —)

        • status (num, —)

        • abreisetag (bool, —)

        • rückreisetag (bool, —)

    • timer (foo, —)

      • read (bool, —)

      • warmwasser (foo, —)

        • read (bool, —)

        • mo (list, —)

        • di (list, —)

        • mi (list, —)

        • do (list, —)

        • fr (list, —)

        • sa (list, —)

        • so (list, —)

      • a1m1 (foo, —)

        • read (bool, —)

        • mo (list, —)

        • di (list, —)

        • mi (list, —)

        • do (list, —)

        • fr (list, —)

        • sa (list, —)

        • so (list, —)

      • m2 (foo, —)

        • read (bool, —)

        • mo (list, —)

        • di (list, —)

        • mi (list, —)

        • do (list, —)

        • fr (list, —)

        • sa (list, —)

        • so (list, —)

      • zirkulation (foo, —)

        • read (bool, —)

        • mo (list, —)

        • di (list, —)

        • mi (list, —)

        • do (list, —)

        • fr (list, —)

        • sa (list, —)

        • so (list, —)

V200KW2

  • V200KW2 (foo, —)

    • anlagentyp (str, —)

    • allgemein (foo, —)

      • read (bool, —)

      • temperatur (foo, —)

        • read (bool, —)

        • aussen (num, —)

        • aussen_dp (num, —)

      • anlagenschema (num, —)

      • anlagensoftwareindex (num, —)

      • systemtime (bool, —)

    • kessel (foo, —)

      • read (bool, —)

      • tempkoffset (num, —)

      • ist (num, —)

      • soll (num, —)

    • fehler (foo, —)

      • read (bool, —)

      • sammelstoerung (num, —)

      • brennerstoerung (num, —)

      • error0 (num, —)

      • error1 (num, —)

      • error2 (num, —)

      • error3 (num, —)

      • error4 (num, —)

      • error5 (num, —)

      • error6 (num, —)

      • error7 (num, —)

      • error8 (num, —)

      • error9 (num, —)

    • pumpen (foo, —)

      • read (bool, —)

      • speicherlade (bool, —)

      • zirkulation (bool, —)

      • heizkreis_a1m1 (bool, —)

      • heizkreis_m2 (bool, —)

    • brenner (foo, —)

      • read (bool, —)

      • typ (num, —)

      • stufe (num, —)

      • starts (num, —)

      • status_1 (bool, —)

      • status_2 (bool, —)

      • betriebsstundenstufe1 (num, —)

      • betriebsstundenstufe2 (num, —)

    • heizkreis (foo, —)

      • read (bool, —)

      • a1m1 (foo, —)

        • read (bool, —)

        • temperatur (foo, —)

          • read (bool, —)

          • raum (foo, —)

            • read (bool, —)

            • soll_normal (num, —)

            • soll_reduziert (num, —)

            • soll_party (num, —)

          • vorlauf (foo, —)

            • read (bool, —)

            • ist (num, —)

            • soll (num, —)

        • betriebsart (num, —)

        • aktuelle_betriebsart (num, —)

        • sparbetrieb (num, —)

        • partybetrieb_zeit (num, —)

        • partybetrieb (num, —)

        • mischerm1 (num, —)

        • heizkreispumpenlogik (num, —)

        • sparschaltung (num, —)

        • heizkennlinie (foo, —)

          • read (bool, —)

          • neigung (num, —)

          • niveau (num, —)

      • m2 (foo, —)

        • read (bool, —)

        • temperatur (foo, —)

          • read (bool, —)

          • raum (foo, —)

            • read (bool, —)

            • soll_normal (num, —)

            • soll_reduziert (num, —)

            • soll_party (num, —)

          • vorlauf (foo, —)

            • read (bool, —)

            • soll (num, —)

            • ist (num, —)

            • min (num, —)

            • max (num, —)

        • betriebsart (num, —)

        • aktuelle_betriebsart (num, —)

        • sparbetrieb (num, —)

        • partybetrieb (num, —)

        • partybetrieb_zeit (num, —)

        • mischerm2 (num, —)

        • mischerm2auf (bool, —)

        • mischerm2zu (bool, —)

        • heizkreispumpenlogik (num, —)

        • sparschaltung (num, —)

        • statusklemme2 (bool, —)

        • statusklemme17 (bool, —)

        • heizkennlinie (foo, —)

          • read (bool, —)

          • neigung (num, —)

          • niveau (num, —)

    • warmwasser (foo, —)

      • read (bool, —)

      • status (bool, —)

      • kesseloffset (num, —)

      • beipartydnormal (num, —)

      • ist (num, —)

      • soll (num, —)

      • sollaktuell (num, —)

      • sollmax (num, —)

    • ferienprogramm (foo, —)

      • read (bool, —)

      • a1m1 (foo, —)

        • read (bool, —)

        • status (num, —)

        • abreisetag (bool, —)

        • rückreisetag (bool, —)

      • m2 (foo, —)

        • read (bool, —)

        • status (num, —)

        • abreisetag (bool, —)

        • rückreisetag (bool, —)

    • timer (foo, —)

      • read (bool, —)

      • warmwasser (foo, —)

        • read (bool, —)

        • mo (list, —)

        • di (list, —)

        • mi (list, —)

        • do (list, —)

        • fr (list, —)

        • sa (list, —)

        • so (list, —)

      • a1m1 (foo, —)

        • read (bool, —)

        • mo (list, —)

        • di (list, —)

        • mi (list, —)

        • do (list, —)

        • fr (list, —)

        • sa (list, —)

        • so (list, —)

      • m2 (foo, —)

        • read (bool, —)

        • mo (list, —)

        • di (list, —)

        • mi (list, —)

        • do (list, —)

        • fr (list, —)

        • sa (list, —)

        • so (list, —)

V200WO1C

  • V200WO1C (foo, —)

    • anlagentyp (str, —)

    • allgemein (foo, —)

      • read (bool, —)

      • temperatur (foo, —)

        • read (bool, —)

        • aussen (num, —)

      • betriebsart (str, —)

        • lookup (list, —)

      • manuell (num, —)

      • outdoor_fanspeed (num, —)

      • status_fanspeed (num, —)

      • kompressor_freq (num, —)

      • sollleistung_verdichter (num, —)

    • pumpen (foo, —)

      • read (bool, —)

      • sekundaer (bool, —)

      • heizkreis (bool, —)

      • zirkulation (bool, —)

    • heizkreis (foo, —)

      • read (bool, —)

      • temperatur (foo, —)

        • read (bool, —)

        • raum (foo, —)

          • read (bool, —)

          • soll (num, —)

          • soll_reduziert (num, —)

          • soll_party (num, —)

        • vorlauf (foo, —)

          • read (bool, —)

          • ist (num, —)

          • soll (num, —)

          • mittel (num, —)

        • ruecklauf (foo, —)

          • read (bool, —)

          • ist (num, —)

          • mittel (num, —)

      • heizkennlinie (foo, —)

        • read (bool, —)

        • niveau (num, —)

        • neigung (num, —)

    • warmwasser (foo, —)

      • read (bool, —)

      • ist (num, —)

      • soll (num, —)

      • ventil (bool, —)

    • statistik (foo, —)

      • read (bool, —)

      • einschaltungen (foo, —)

        • read (bool, —)

        • sekundaer (num, —)

        • heizstab1 (num, —)

        • heizstab2 (num, —)

        • heizkreis (num, —)

      • laufzeiten (foo, —)

        • read (bool, —)

        • sekundaer (num, —)

        • heizstab1 (num, —)

        • heizstab2 (num, —)

        • heizkreis (num, —)

        • ventil (num, —)

        • verdichterstufe1 (num, —)

        • verdichterstufe2 (num, —)

        • verdichterstufe3 (num, —)

        • verdichterstufe4 (num, —)

        • verdichterstufe5 (num, —)

        • verdichterwp (num, —)

      • oat_temperature (num, —)

      • ict_temperature (num, —)

      • cct_temperature (num, —)

      • hst_temperature (num, —)

      • omt_temperature (num, —)

      • waermeww12m (num, —)

      • elektroww12m (num, —)

Logik Parameter

Das Plugin verfügt über folgende Parameter, die in der Datei ../etc/logic.yaml konfiguriert werden:

Keine Logik Parameter in den Metadaten beschrieben - Bitte in der README nachsehen (siehe Fußnote)

Plugin Functions

Das Plugin verfügt über folgende öffentliche Funktionen, die z.B. in Logiken aufgerufen werden können.

Keine