Translatoren für Zustand und Belegung
Ein Zustands-Translator macht aus einem Messwert das kanonische Zustandsfeld, das der Rest von Yggio
versteht. Es sind kleine Adapter: Ein Präsenzmelder meldet presence, aber Ansichten, Regeln und
Berichte sind um occupied herum gebaut, also muss etwas die beiden verbinden.
Sie sind verkettet und laufen auf dem Hardware-Translator des Geräts auf.
Warum es sie gibt
Ein Hardware-Decoder sollte melden, was das Gerät tatsächlich gesagt hat. Wo dieser Wert die richtige Messung in der falschen Form ist oder erst eine Referenz braucht, um etwas zu bedeuten, gehört die Umrechnung in einen eigenen Translator und nicht in den Decoder.
Das hält den Decoder ehrlich und die Umrechnung wiederverwendbar, und es sorgt dafür, dass der
installationsspezifische Teil dort bleibt, wo Sie ihn ändern können. set-level-from-distance ist
der klarste Fall: Ein Abstandsmesser meldet einen Abstand, und nur Sie wissen, wie weit entfernt der
Sensor den Boden eines leeren Behälters sieht. Tragen Sie diese Zahl in die Parameter des Translators
ein, und derselbe Decoder funktioniert für jeden Behälter, den Sie haben.
Das Ergebnis ist ein kanonisches Feld, sodass alles Nachgelagerte damit arbeitet, einschließlich eines Alarm-Translators.
Die Translatoren
| Translator | Was er ableitet | Erzeugte Felder |
|---|---|---|
set-occupied-from-presence | Den kanonischen 0/1-Wert occupied aus dem booleschen Feld presence eines Präsenzmelders | occupied |
set-door-to-openstate | Einen invertierten booleschen openState aus dem Feld door eines Sensors, sodass offen auch offen bedeutet | openState |
set-level-from-distance | Einen Füllstand aus einem nach unten gerichteten Abstandssensor, indem der Messwert von normalDistance abgezogen wird, dem Abstand, den der Sensor bei leerem Behälter sieht | level, occupied |
set-lnglat-from-gateway-location-chirpstack | Eine Position aus dem Standort des ChirpStack-Gateways, wenn das Gerät keine meldet. Für LoRaWAN-Sensoren ohne GPS sind die Koordinaten des nächsten Gateways grob, aber oft gut genug, um das Gerät zu verorten | lnglat |
set-enable-location-service-from-scan | Einen Auslöser für den Ortungsdienst von Yggio, gesetzt sobald ein Tracker einen frischen GNSS- oder WiFi-Scan liefert, damit die Position aus dem Scan bestimmt wird | enableLocationService, locationRequests |
set-road-blocked-if-traffic-anomaly | Einen Kandidaten für eine Straßensperrung aus einer Anomalie in den Verkehrszählwerten, mitgeführt zusammen mit Straßenname, Ort und einem Geofence, für den Straßenunterhalt | roadBlockedCandidate, countDetection, roadName, city |
Parameter
Bei den meisten gibt es nichts zu konfigurieren: Die Umrechnung ist durch die Bedeutung des Feldes festgelegt. Bei den dreien, bei denen es etwas gibt, prüfen Sie jeden Parameter unten - manche sind Pflicht und die Übersetzung schlägt zur Laufzeit fehl, wenn sie leer bleiben, andere sind optional und fallen auf automatische Erkennung zurück.
| Parameter | Verwendet von | Zweck |
|---|---|---|
normalDistance | set-level-from-distance | Der Abstand, den der Sensor bei leerem Behälter misst und von dem der Messwert abgezogen wird |
distanceField | set-level-from-distance | Den Abstand aus einem bestimmten Feld statt aus dem Standardfeld lesen |
doorField | set-door-to-openstate | Den Türzustand aus einem bestimmten Feld statt aus dem Standardfeld lesen |
Beachten Sie, dass set-lnglat-from-gateway-location-chirpstack Ihnen die Position des Gateways
liefert, nicht die des Geräts. Das ist ein nützlicher Standardwert für einen Sensor, der sonst
nirgends auf der Karte erschiene, und es darf nicht als gemessene Position gelesen werden.
Das vollständige A–Z-Verzeichnis aller Translatoren finden Sie in der Translator-Übersicht.