DevelopmentGuidelinesReadings: Unterschied zwischen den Versionen
Sidey (Diskussion | Beiträge) K (Englische Übersetzung verbessert, konjunktive Form entfernt.) |
K (Neu Formulierung des "Important" Teils) |
||
Zeile 33: | Zeile 33: | ||
*batteryVoltage: \d+.\d+ | *batteryVoltage: \d+.\d+ | ||
Important: The | Important: The FHEM module will '''only''' report the values received from the device, i.e. not each module reports a batteryState reading. Additionally, if the device sent a batteryPercent value earlier but the last message from the device only contained a 'battery: low', the batteryPercent reading wont be changed. | ||
[[Kategorie:Development]] | [[Kategorie:Development]] |
Aktuelle Version vom 5. Juni 2018, 07:43 Uhr
Deutsch
Einleitung
Auf dieser Seite werden Richtlinien für Readings gesammelt, welche in mehreren Modulen auftauchen können um eine Vereinheitlichung zu erreichen. Dadurch soll es Hilfsmodulen und Anwendern leichter fallen, mit den Werten der Readings zu arbeiten.
Batterie-Readings
Basierend auf dieser Diskussion haben sich die Entwickler für Readings, welche in Zusammenhang mit Batterien stehen auf folgendes geeinigt: Es gibt nur diese drei Readings für den Batteriestatus:
- batteryState
- batteryPercent
- batteryVoltage
Wertebereich:
- batteryState: ok|low
- batteryPercent: \d{1,2}|100
- batteryVoltage: \d+.\d+
Wichtig: das jeweilige Modul setzt nur die Readings, die es aus den aktuellen Daten vom Gerät bestimmen kann. Konkret: niemand kann sich darauf verlassen, welche der drei battery Readings vorhanden sind (es gibt nicht überall ein batteryState). Wenn das Gerät früher ein Percent gemeldet hat, aber in der letzten Nachricht nur state, dann wird das Percent Reading nicht angefasst.
English
Start
On this page you will find guidlines how to name common readings. These guidlines are for readings which are used in more than one module and should have the same possible values. This makes it helper modules and users easier, to work with the values from common readings.
Battery Reading
Based on this discussion battery-readings should only be named like:
- batteryState
- batteryPercent
- batteryVoltage
The values should only be:
- batteryState: ok|low
- batteryPercent: \d{1,2}|100
- batteryVoltage: \d+.\d+
Important: The FHEM module will only report the values received from the device, i.e. not each module reports a batteryState reading. Additionally, if the device sent a batteryPercent value earlier but the last message from the device only contained a 'battery: low', the batteryPercent reading wont be changed.