HMCCU Reading Namen: Unterschied zwischen den Versionen

Aus FHEMWiki
(HMCCU Readings)
 
(Beschreibung von Readings in HMCCU)
Zeile 1: Zeile 1:
Arten von Readings in HMCCUDEV und HMCCUCHN Devices
== Arten von Readings ==
Die Module HMCCUDEV und HMCCUCHN kennen 6 verschiedene Arten von Readings. Einige werden immer, andere nur nach dem Setzen von Flags im Attribut ccuflags angezeigt. Die folgende Tabelle fasst die Reading Arten zusammen:
{| class="wikitable"
{| class="wikitable"
|+
|+
Anzeige der Reading Arten
!Readings für
!Readings für
!Anzeige
!Default Anzeige
!Anzeige aktivieren mit
!Aktualisierung
|-
|-
|Datenpunkte
|Datenpunkte
|immer für Kanäle > 0, sofern kein Filter definiert
|ja (Kanäle > 0)
|ccuflags = showDeviceReadings (Kanal 0)
|automatisch
|-
|-
|Konfigurationsparameter
|Konfigurationsparameter
|nur wenn Attribut ccuflags = showMasterReadings
|nein
|ccuflags = showMasterReadings
|manuell
|-
|Verknüpfungen / Links
|nein
|ccuflags = showLinkReadings
|manuell
|-
|Services
|nein
|ccuflags = showServiceReadings
|manuell
|-
|-
|Gerätefunktionen
|Gerätefunktionen
|immer
|ja
|immer aktiv
|automatisch
|-
|-
|Gerätestati
|Gerätestati
|ja
|immer aktiv
|automatisch
|}
=== Readings für Datenpunkte ===
Readings für Datenpunkte, Gerätefunktionen und Gerätestati werden automatisch aktualisiert, sofern die RPC Server konfiguriert und gestartet sind.
Readings für Datenpunkte werden per Voreinstellung immer angezeigt. Eine Ausnahme sind die Datenpunkte für den Statuskanal 0, über den jedes Homematic Device verfügt. Diese werden nur angezeigt, wenn im Attribut '''ccuflags''' das Flag "showDeviceReadings" gesetzt ist. Dies ist normalerweise nicht notwendig, da die wichtigsten Datenpunkte in Kanal 0 in den Gerätefunktions-Readings und den Gerätestatus-Reading "devstate" und "hmstate" angezeigt werden.
{| class="wikitable"
|+Gerätefunktions-Readings
!Datenpunkt Kanal 0
!Reading
!Bedeutung
!Werte
!Wert in Reading devstate
|-
|AES_KEY
|sign
|Verschlüsselung
|yes, no
|
|
|-
|LOW_BAT
LOWBAT
|battery
|Batteriestatus
|low, ok
|
|-
|OPERATING_VOLTAGE
|voltage
|Batteriespannung
|Zahl
|
|-
|SABOTAGE
ERROR_SABOTAGE
|sabotage
|Manipulationsversuch
|yes, no
|"sabotage"
|-
|UNREACH
|activity
|Erreichbarkeit
|active, dead
|"unreach"
|-
|STICKY_UNREACH
|
|Gerät war nicht erreichbar
|
|"stickyUnreach"
|-
|RSSI_DEVICE
|rssidevice
|Signalstärke
|Zahl
|
|-
|RSSI_PEER
|rssipeer
|Signalstärke
|Zahl
|
|-
|CONFIG_PENDING
|
|Konfiguration steht zur Übertragung an
|
|"cfgPending"
|-
|UPDATE_PENDING
|
|Firmware-Update steht zur Übertragung an
|
|"updPending"
|-
|DEVICE_IN_BOOTLOADER
|
|Gerät startet neu
|
|"boot"
|}
Das Reading "devstate" enthält einen oder mehrere der angegebenen Werte (letzte Spalte), sofern der zugehörige Datenpunkt den Wert "true" annimmt. Mehrere Werte werden durch Komma getrennt. Beispiel: "stickyUnreach,cfgPending".
=== Readings für Konfigrationsparameter ===
Readings für Konfigurationsparameter, Verknüpfungen und Services werden nur angezeigt, sofern im Attribut '''ccuflags''' das entsprechende Flag "showXXXReadings" gesetzt ist (siehe Tabelle oben). Diese Readings müssen mit dem Befehl '''get config''' manuell abgefragt werden.
== Namen von Readings ==
Per Default entsprechen die Namen der Readings den Namen der Datenpunkte / Parameter. Bei HMCCUDEV Devices wird die Kanalnummer vorangestellt, um identische Datenpunkte in mehreren Kanälen unterscheiden zu können. Die Namen der Readings können mit den Attributen '''ccureadingformat''', '''ccureadingname''' und '''ccuReadingPrefix''' beeinflusst werden.
=== Das Attribut ccureadingformat ===
Die folgende Tabelle zeigt anhand des Datenpunktes "LEVEL" im Kanal 1 eines Gerätes "Thermostat-Bad", wie die Einstellung im Attribut '''ccureadingformat''' den Reading Namen beeinflusst:
{| class="wikitable"
|+Reading Name Formate
!ccureadingformat
!Zusammensetzung Reading Name
!Reading HMCCUDEV
!Reading HMCCUCHN
|-
|datapoint
|Datenpunkt
|1.LEVEL
|LEVEL
|-
|name
|Gerätename, Kanal, Datenpunkt
|Thermostat-Bad.1.LEVEL
|Thermostat-Bad.1.LEVEL
|-
|address
|Interface, Adresse, Kanal, Datenpunkt
|HmIP-RF.000393C99BFC08.1.LEVEL
|HmIP-RF.000393C99BFC08.1.LEVEL
|}
|}
* Readings für Datenpunkte (werden per Default angezeigt, Ausnahme: Datenpunkte von Kanal 0)
Wenn an das Reading-Format das Kürzel "lc" angehängt wird, wird der Reading Name in Kleinbuchstaben umgewandelt. Zusätzlich zu den 3 fest vorgegebenen Formaten kann auch ein Reading-Format mit Platzhaltern definiert werden. Folgende Platzhalter sind möglich:
* Readings für Konfigurationsparameter (
* %a, %A - Adresse
* Alternative Readings für Datenpunkte (werden
* %c - Kanal
* Status Readings
* %n, %N - Gerätename
Filterung von Readings
* %d, %D - Datenpunkt / Parameter
Beispiel: "Wert_von_%c_%D" ergibt beim Datenpunkt 1.LEVEL den Reading Namen "Wert_von_1_LEVEL".


== Filterung von Readings ==
Sofern keine Attribute zur Filterung von Readings definiert sind, werden in HMCCUDEV/HMCCUCHN Device
Sofern keine Attribute zur Filterung von Readings definiert sind, werden in HMCCUDEV/HMCCUCHN Device

Version vom 30. Dezember 2021, 17:30 Uhr

Arten von Readings

Die Module HMCCUDEV und HMCCUCHN kennen 6 verschiedene Arten von Readings. Einige werden immer, andere nur nach dem Setzen von Flags im Attribut ccuflags angezeigt. Die folgende Tabelle fasst die Reading Arten zusammen:

Anzeige der Reading Arten
Readings für Default Anzeige Anzeige aktivieren mit Aktualisierung
Datenpunkte ja (Kanäle > 0) ccuflags = showDeviceReadings (Kanal 0) automatisch
Konfigurationsparameter nein ccuflags = showMasterReadings manuell
Verknüpfungen / Links nein ccuflags = showLinkReadings manuell
Services nein ccuflags = showServiceReadings manuell
Gerätefunktionen ja immer aktiv automatisch
Gerätestati ja immer aktiv automatisch

Readings für Datenpunkte

Readings für Datenpunkte, Gerätefunktionen und Gerätestati werden automatisch aktualisiert, sofern die RPC Server konfiguriert und gestartet sind.

Readings für Datenpunkte werden per Voreinstellung immer angezeigt. Eine Ausnahme sind die Datenpunkte für den Statuskanal 0, über den jedes Homematic Device verfügt. Diese werden nur angezeigt, wenn im Attribut ccuflags das Flag "showDeviceReadings" gesetzt ist. Dies ist normalerweise nicht notwendig, da die wichtigsten Datenpunkte in Kanal 0 in den Gerätefunktions-Readings und den Gerätestatus-Reading "devstate" und "hmstate" angezeigt werden.

Gerätefunktions-Readings
Datenpunkt Kanal 0 Reading Bedeutung Werte Wert in Reading devstate
AES_KEY sign Verschlüsselung yes, no
LOW_BAT

LOWBAT

battery Batteriestatus low, ok
OPERATING_VOLTAGE voltage Batteriespannung Zahl
SABOTAGE

ERROR_SABOTAGE

sabotage Manipulationsversuch yes, no "sabotage"
UNREACH activity Erreichbarkeit active, dead "unreach"
STICKY_UNREACH Gerät war nicht erreichbar "stickyUnreach"
RSSI_DEVICE rssidevice Signalstärke Zahl
RSSI_PEER rssipeer Signalstärke Zahl
CONFIG_PENDING Konfiguration steht zur Übertragung an "cfgPending"
UPDATE_PENDING Firmware-Update steht zur Übertragung an "updPending"
DEVICE_IN_BOOTLOADER Gerät startet neu "boot"

Das Reading "devstate" enthält einen oder mehrere der angegebenen Werte (letzte Spalte), sofern der zugehörige Datenpunkt den Wert "true" annimmt. Mehrere Werte werden durch Komma getrennt. Beispiel: "stickyUnreach,cfgPending".

Readings für Konfigrationsparameter

Readings für Konfigurationsparameter, Verknüpfungen und Services werden nur angezeigt, sofern im Attribut ccuflags das entsprechende Flag "showXXXReadings" gesetzt ist (siehe Tabelle oben). Diese Readings müssen mit dem Befehl get config manuell abgefragt werden.

Namen von Readings

Per Default entsprechen die Namen der Readings den Namen der Datenpunkte / Parameter. Bei HMCCUDEV Devices wird die Kanalnummer vorangestellt, um identische Datenpunkte in mehreren Kanälen unterscheiden zu können. Die Namen der Readings können mit den Attributen ccureadingformat, ccureadingname und ccuReadingPrefix beeinflusst werden.

Das Attribut ccureadingformat

Die folgende Tabelle zeigt anhand des Datenpunktes "LEVEL" im Kanal 1 eines Gerätes "Thermostat-Bad", wie die Einstellung im Attribut ccureadingformat den Reading Namen beeinflusst:

Reading Name Formate
ccureadingformat Zusammensetzung Reading Name Reading HMCCUDEV Reading HMCCUCHN
datapoint Datenpunkt 1.LEVEL LEVEL
name Gerätename, Kanal, Datenpunkt Thermostat-Bad.1.LEVEL Thermostat-Bad.1.LEVEL
address Interface, Adresse, Kanal, Datenpunkt HmIP-RF.000393C99BFC08.1.LEVEL HmIP-RF.000393C99BFC08.1.LEVEL

Wenn an das Reading-Format das Kürzel "lc" angehängt wird, wird der Reading Name in Kleinbuchstaben umgewandelt. Zusätzlich zu den 3 fest vorgegebenen Formaten kann auch ein Reading-Format mit Platzhaltern definiert werden. Folgende Platzhalter sind möglich:

  • %a, %A - Adresse
  • %c - Kanal
  • %n, %N - Gerätename
  • %d, %D - Datenpunkt / Parameter

Beispiel: "Wert_von_%c_%D" ergibt beim Datenpunkt 1.LEVEL den Reading Namen "Wert_von_1_LEVEL".

Filterung von Readings

Sofern keine Attribute zur Filterung von Readings definiert sind, werden in HMCCUDEV/HMCCUCHN Device

Abgerufen von „http://wiki.fhem.de/w/index.php?title=HMCCU_Reading_Namen&oldid=36738“