HMCCU Reading Namen
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:
| 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.
| 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:
| 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