Letztes Update 2021/04/11 14:46

Um gemessene Werte in einer wissenschaftlich korrekten Einheit auszudrücken, unterstützt das Framework Maßeinheiten. Durch die Verwendung quantifizierter Dezimalwerte in Statusaktualisierungen und Befehlen kann das Framework Werte automatisch in eine gewünschte Einheit konvertieren, die vom Systemgebietsschema oder pro Verwendung definiert werden kann.

(Mengenart)

Bindungen verwenden den QuantityType, um Aktualisierungen von Sensordaten mit einer Quantifizierungseinheit zu veröffentlichen. Auf diese Weise kann das Framework und / oder der Benutzer den quantifizierten Wert in andere übereinstimmende Einheiten konvertieren:

Eine Wetterbindung, die Temperaturwerte in °C liest, würde den QuantityType verwenden, um die Einheit als °C anzuzeigen. Das Framework kann dann die Werte je nach Konfiguration des Systems entweder in °F oder Kelvin konvertieren. Die vom Framework verwendete Standardkonvertierung basiert auf dem Gebietsschema: Das Framework versucht, einen QuantityType in die Standardeinheit des konfigurierten Gebietsschemas zu konvertieren. Dies ist das imperiale System für die Vereinigten Staaten (Gebietsschema USA) und Liberia (Sprachkennzeichnung „en-LR“). Das metrische System mit SI-Einheiten wird für den Rest der Welt verwendet. Diese Konvertierung konvertiert den angegebenen QuantityType in eine Standardeinheit für die spezifische Dimension des Typs. Das ist:

Zusätzlich zur automatisierten Konvertierung kann das NumberItem, das mit einem Kanal verknüpft ist welcher QuantityTypes liefert, so konfiguriert werden, dass Statusaktualisierungen immer in eine bestimmte Einheit konvertiert werden. Die in der Zustandsbeschreibung angegebene Einheit wird analysiert und dann, falls erforderlich, zur Konvertierung verwendet. Das Framework geht davon aus, dass die zu analysierende Einheit immer das letzte Token in der Statusbeschreibung ist. Wenn die Analyse fehlgeschlagen ist, findet die auf dem Gebietsschema basierende Standardkonvertierung statt.

Number:Temperatur temperature "Outside [%.2f °F]" { channel="...:current#temperature" }

In diesem Beispiel wird das NumberItem angegeben, um an Kanäle zu binden, die Werte aus der Dimension Temperatur anbieten. Ohne die Dimensionsinformationen erhält das NumberItem nur Aktualisierungen vom Typ DecimalType ohne Einheit und ohne Konvertierung. Die Zustandsbeschreibung definiert zwei Dezimalstellen für den Wert und die Fixeinheit °F. Falls in der Statusbeschreibung die Einheit angezeigt werden soll, die die Bindung liefert, oder das Framework durch Gebietsschema-basierte Konvertierung berechnet, sieht das Muster folgendermaßen aus:

„Aussen [%.2f %unit%]“

Der spezielle Platzhalter %unit% wird dann durch das tatsächliche Einheitensymbol ersetzt. Der Platzhalter %unit% kann an einer beliebigen Stelle in der Statusbeschreibung platziert werden.

<channel-type id="temperature">
    <item-type>Number:Temperature</item-type>
    <label>Temperature</label>
    <description>Current temperature</description>
    <state readOnly="true" pattern="%.1f %unit%" />
</channel-type>

Das Zustandsbeschreibungsmuster „%.1f %unit%“ beschreibt das Werteformat als Gleitkomma mit einer Dezimalstelle und auch als speziellen Platzhalter für die Einheit.

Beim Erstellen von QuantityType-Status bietet das Framework einige nützliche Pakete und Klassen. Das Paket org.openhab.core.library.unit enthält die Klassen SIUnits, ImperialUnits und Units, die Einheiten bereitstellen, welche für eines der in beiden Systemen verwendeten Messsysteme und gemeinsamen Einheiten eindeutig sind.

Die MetricPrefix Klasse stellt Präfixe wie MILLI, CENTI, HECTO usw. bereit, und die BinaryPrefix Klasse bietet Präfixe wie KIBI, MEBI usw., die beide Wrapper zum Erstellen abgeleiteter Einheiten sind.

Die Pakete org.openhab.core.library.dimension und javax.measure.quantity bieten Schnittstellen, mit denen der generische QuantityType und die Einheiten eingegeben werden.

Alle Einheiten, die derzeit standardmäßig unterstützt werden, sind in den folgenden Tabellen aufgeführt.

Imperial (Symbole der Basiseinheit):

SI (Symbole der Basiseinheit):

Metrische SI-Präfixe:

Binäre SI-Präfixe:

Um die Präfixe zu verwenden, fügen Sie einfach das Präfix zum Einheitensymbol hinzu - zum Beispiel:

• milliAmpere - mA
• centiMetre - cm
• kiloWatt - kW
• KibiByte - KiB