Plugin ‚dlms‘ Konfiguration
![plugin logo](../../_images/plugin_logo13.png)
Im folgenden sind etwaige Anforderungen und unterstützte Hardware beschrieben. Danach folgt die Beschreibung, wie das Plugin dlms 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.
Beschreibung
Unterstützung für Smartmeter, die DLMS (Device Language Message Specification, IEC 62056-21) nutzen und OBIS Codes liefern
Anforderungen
Minimum SmartHomeNG Version: 1.8
Minimum Python Version: 3.6
Konfiguration
Im folgenden ist beschrieben, wie das Plugin dlms 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:
baudrate
Baudrate bei der die Kommunikation erfolgen soll
Datentyp: int
Standardwert: 300
Minimalwert: 50
baudrate_fix
Baudrate beibehalten trotz Änderungsanforderung
Datentyp: bool
Standardwert: False
device_address
Interne Unteradresse des Smartmeters
Datentyp: str
no_waiting
derzeit nicht genutzt
Datentyp: bool
Standardwert: False
only_listen
Manche Smartmeter können nicht abgefragt werden sondern senden von sich aus Informationen. Für diese Smartmeter auf True setzen und die Baudrate anpassen
Datentyp: bool
Standardwert: False
querycode
Abfragecode für den Smartmeter, default ist ?, einige Smartmeter akzeptieren z.B. 2
Datentyp: str
Standardwert: ?
reset_baudrate
derzeit nicht genutzt
Datentyp: bool
Standardwert: True
serialport
Serieller Port an dem der Smartmeter angeschlossen ist
Datentyp: str
timeout
Timeout in Sekunden nach dem der Lesevorgang automatisch beendet wird
Datentyp: int
Standardwert: 2
update_crontab
Abfragen des Smartmeters mit Festlegung via Crontab
Datentyp: str
update_cycle
Zeitlicher Abstand zwischen zwei Abfragen des Smartmeters in Sekunden, setzen auf 0 schaltet cycle aus
Datentyp: int
Standardwert: 60
Minimalwert: 0
update_cycle_start_offset
Zeit die beim Start des Plugins zusätzlich gewartet wird, damit sich verschiedene Instanzen die gleiche Schnittstellen abfragen nicht in die Quere kommen
Datentyp: int
Standardwert: 0
Minimalwert: 0
use_checksum
Wenn wahr, wird eine Prüfsumme über die ausgelesenen Daten gebildet
Datentyp: bool
Standardwert: True
Item Attribute
Das Plugin unterstützt folgende Item Attribute, die in den Dateien im Verzeichnis ../items
verwendet werden:
dlms_obis_code
Anweisung welcher Teil einer OBIS Zeile geparst und dem Item zugewiesen werden soll * obis Code 1-1:1.6.2*01
* Index * Entweder Wert also ‚Value‘ oder Einheit also ‚Unit‘ * Wert Konvertierungsart * Z6 (Zeit codiert mit hhmmss), * Z4 (Zeit codiert mit hhmm), * D6 (Datum codiert mit YYMMDD), * ZST10 (Datum und Zeit codiert mit YYMMDDhhmm), * ZST12 (Datum und Zeit codiert mit YYMMDDhhmmss), * str eine Zeichenkette * float eine Fliesskommazahl * int ein ganze Zahl * num Numerisch, entweder Ganzzahl oder Fliesskommazahl
Datentyp: list(4,str,int,str,str)
dlms_obis_readout
In Items mit diesem Attribut wird der komplette Auslesepuffer abgelegt für eigene Untersuchungen
Datentyp: str
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