Plugin ‚viessmann‘ Konfiguration
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 interface Plugin.
Beschreibung
Lesen und Schreiben von Werten einer Viessmann Heizung
Anforderungen
Minimum SmartHomeNG Version: 1.6.0
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:
heating_type
Gerätetype der Heizung
Datentyp: str
protocol
Protokoll der Heizung
Datentyp: str
Standardwert: P300
serialport
Serieller Port, an dem der Lesekopf angeschlossen ist
Datentyp: str
timeout
Zeitbegrenzung für das Lesen vom seriellen Port in Sekunden
Datentyp: num
Standardwert: 1.5
Item Attribute
Das Plugin unterstützt folgende Item Attribute, die in den Dateien im Verzeichnis ../items verwendet werden:
viess_ba_list
Gibt nach der Initialisierung eine Liste aller für die konfigurierte Heizung gültigen Betriebsarten zurück
Datentyp: bool
viess_init
Konfiguriert, ob der Wert aus der Heizung initialisiert werden soll
Datentyp: bool
viess_read
Liest Wert mit konfiguriertem Kommando aus der Heizung aus
Datentyp: str
viess_read_afterwrite
Konfiguriert eine Verzögerung in Sekunden nachdem ein Lesekommando nach einem Schreibkommando an die Heizung geschickt wird
Datentyp: num
viess_read_cycle
Konfiguriert ein Intervall in Sekunden für das Lesekommando
Datentyp: num
viess_send
Änderung des Items wird mit konfiguriertem Kommando an die Heizung geschickt
Datentyp: str
viess_timer
Liest alle Timer zur übergebenen Anwendung (z.B. Heizkreis_A1M1) und stellt diese für die Nutzung mit UZSU zur Verfügung
Datentyp: str
viess_trigger
Konfiguriert Lesekommandos, die nach einem Schreibvorgang auf das Item aufgerufen werden
Datentyp: list(str)
viess_trigger_afterwrite
Konfiguriert eine Verzögerung in Sekunden, bis ein Trigger ausgeführt werden soll, nachdem ein Wert gesetzt wurde
Datentyp: num
viess_update
Liest alle konfigurierten Items neu, wenn es auf True gesetzt wird
Datentyp: bool
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.
read_addr(addr)
Stößt das Lesen des angegebenen Datenpunkts an, der nicht an ein Item gebunden sein muss. Es erfolgt keine Zuweisung an ein Item. Rückgabewert ist der gelesene Wert, oder NONE bei Fehler
Ergebnistyp der Funktion: foo
addr
Vierstellige Hex-Adresse des Datenpunktes
Datentyp: str
read_temp_addr(addr, length, unit)
Stößt das Lesen eines beliebigen Datenpunkts an, der nicht konfiguriert oder bekannt sein muss. Es erfolgt keine Zuweisung an ein Item. Rückgabewert ist der gelesene Wert, oder NONE bei Fehler
Ergebnistyp der Funktion: foo
addr
Vierstellige Hex-Adresse des Datenpunktes
Datentyp: str
length
Länge der Geräteantwort in Bytes (1-8)
Datentyp: int
Minimalwert: 1
Maximalwert: 8
unit
Einheitencode für die Konvertierung der Antwort. Muss in der Protokollkonfiguration unitset in commands.py definiert sein
Datentyp: str
update_all_read_items()
Stößt das Lesen aller konfigurierten Items an
Ergebnistyp der Funktion: none
write_addr(addr, value)
Stößt das Schreiben des angegebenen Datenpunkts an, der nicht an ein Item gebunden sein muss. Der übergebene Wert muss zum konfigurierten Datentyp passen
Ergebnistyp der Funktion: foo
addr
Vierstellige Hex-Adresse des Datenpunktes
Datentyp: str
value
Zu schreibender Wert
Datentyp: