TA CMI UVR16x2 UVR1611
| TA CMI UVR16x2 UVR1611 | |
|---|---|
| Zweck / Funktion | |
| Auslesen von Ein- und Ausgabestati der UVR16x2 über die CMI | |
| Allgemein | |
| Typ | Inoffiziell |
| Details | |
| Dokumentation | Thema |
| Modulname | 72_TA_CMI_JSON.pm |
| Ersteller | DelMar |
| Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref! | |
Die UVR16x2 ist ein "frei programmierbarer Universalregler". Einfach ausgedrückt, kann sie zur Steuerung von Heizungen, Solar-Anlagen und dergleichen eingesetzt werden. Über das C.M.I. Zusatzmodul kann die UVR16x2 auch ans LAN (Ethernet) angebunden werden. Das C.M.I. bietet außerdem eine JSON-Schnittstelle an, über die Input, Output und DL-Bus Werte abgefragt werden können.
Dokumentation vom Hersteller zur UVR16x2 gibts hier, die Dokumentation zur hier verwendeten JSON-API des C.M.I. finden Sie hier, im Tab "Anleitungen".
Hinweise zum Betrieb mit FHEM
Die JSON-API erlaubt maximal eine Abfrage pro Minute. Darüberhinausgehende Versuche werden mit einer entsprechenden Meldung beantwortet.
Einbindung in FHEM
defmod <name> TA_CMI_JSON <ip> <nodeId> <queryParams>Konkretes Beispiel:
defmod cmi TA_CMI_JSON 192.168.4.250 1 I,O,DDie nodeId verweißt auf die UVR16x2. Im CMI Web-Interface im Punkt CAN Bus wird ein Bild der UVR gezeigt. Daneben findet sich auch die Information, welcher Node das ist. Bei mir ist es die 1.
queryParams kann entweder I, O oder D für Input, Output oder DL-Bus sein.
Damit wird angegeben, welche Informationen vom CMI abgefragt werden sollen.
Diese Abfrage kann, durch Komma getrennt, auch kombiniert erfolgen: I,O,D. Achtung: keine Leerzeichen verwenden.
Die Gerätedefinition ist komplett, die Konfiguration aber noch nicht vollständig.
Um Werte tatsächlich als Readings in FHEM zu speichern, müssen noch Namen für eben jene Readings vergeben werden.
Dies erfolgt mit Hilfe der Attribute readingNamesInputs, readingNamesOutputs und readingNamesDL-Bus.
So wird mittels Index ein Name für jeden Wert definiert.
Beispiel:
attr cmi readingNamesDL-Bus 1:Durchfluss_Solar 2:T.Solar_RL
Die Reihenfolge der Werte ist im UI der UVR16x2 sichtbar. Bitte beachten: bei dem hier verlangten Index handelt es sich nicht um die Absolute Nummer des Wertes, sondern nur um seine Reihenfolge:
Im hier gezeigten Beispiel muss Ladepumpe-Warmwasser als Index 3 angegeben werden, da es der dritte Wert ist - nicht als 6, was der Nummer des Ausgangs entsprechen würde.
Das konkrete Beispiel für die Outputs sieht so aus:
attr cmi readingNamesOutputs 1:UWP_FBH 2:UWP_Sonde 3:UWP_WW 4:UWP_Solar
Mit richtig konfigurierten Attributen werden die Readings wie rechts dargestellt angezeigt.
Installation des Moduls
Das Modul ist (noch) nicht Teil der FHEM Distribution.
Die aktuellste Version kann von GitHub heruntergeladen werden und wird dann ins Modul-Verzeichnis (zB nach /opt/fhem/FHEM) kopiert.
Bitte auch sicherstellen, dass die Rechte richtig konfiguriert sind.
Danach empfehle ich einen FHEM Neustart und die Einrichtung wie Eingangs beschrieben.
Unterstützte Geräte
Obwohl das CMI mehrere Geräte am CAN-Bus unterstützt, wurde nur das UVR 16x2 explizit getestet, weil ich auch nur dieses zur Verfügung habe. Bei Interesse weiterer Integrationen ist eine Anfrage im Forum oder auch ein Pull-Request auf GitHub herzlich willkommen.