Translatorer för tillstånd och beläggning

En tillståndstranslator gör om en avläsning till det kanoniska tillståndsfält som resten av Yggio förstår. De är små adaptrar: en närvarosensor rapporterar presence, men vyer, regler och rapporter är byggda kring occupied, så något måste överbrygga de två.

De är kedjade och körs ovanpå enhetens hårdvarutranslator.

Varför de finns

En hårdvaruavkodare bör rapportera vad enheten faktiskt sa. Där det värdet är rätt mätning i fel form, eller behöver en referens innan det betyder något, hör omvandlingen hemma i en egen translator snarare än inbakad i avkodaren.

Det håller avkodaren ärlig och omvandlingen återanvändbar, och det gör att den installationsspecifika delen stannar där du kan ändra den. set-level-from-distance är det tydligaste fallet: en avståndsmätare rapporterar ett avstånd, och bara du vet hur långt bort sensorn ser botten av en tom behållare. Lägg det talet i translatorns parametrar så fungerar samma avkodare för varje behållare du äger.

Resultatet är ett kanoniskt fält, så allt nedströms fungerar på det, inklusive en larmtranslator.

Translatorerna

Translator	Vad den härleder	Fält som skapas
set-occupied-from-presence	Det kanoniska 0/1-värdet occupied ur en närvarosensors booleska fält presence	occupied
set-door-to-openstate	En inverterad boolesk openState ur en sensors fält door, så att öppen betyder öppen	openState
set-level-from-distance	En fyllnadsnivå ur en nedåtriktad avståndssensor, genom att dra av avläsningen från normalDistance, det avstånd sensorn ser när behållaren är tom	level, occupied
set-lnglat-from-gateway-location-chirpstack	En position ur ChirpStack-gatewayens position när enheten inte rapporterar någon. För LoRaWAN-sensorer utan GPS är närmaste gateways koordinater grova men ofta tillräckligt bra för att placera enheten	lnglat
set-enable-location-service-from-scan	En trigger för Yggios positionstjänst, som höjs när en tracker levererar en färsk GNSS- eller WiFi-positioneringsskanning, så att positionen löses ur skanningen	enableLocationService, locationRequests
set-road-blocked-if-traffic-anomaly	En kandidat till vägavstängning ur en avvikelse i trafikräkningar, buren tillsammans med vägnamn, ort och en geofence, för vägunderhåll	roadBlockedCandidate, countDetection, roadName, city

Parametrar

De flesta av dessa har ingenting att konfigurera: omvandlingen är låst av vad fältet betyder. De tre som har det: kontrollera varje parameter nedan - vissa är obligatoriska och översättningen misslyckas i körning om de lämnas tomma, medan andra är valfria och faller tillbaka på automatisk detektering.

Parameter	Används av	Syfte
normalDistance	set-level-from-distance	Avståndet sensorn läser av när behållaren är tom, som mätningen dras av från
distanceField	set-level-from-distance	Läs avståndet från ett specifikt fält i stället för standardfältet
doorField	set-door-to-openstate	Läs dörrtillståndet från ett specifikt fält i stället för standardfältet

Observera att set-lnglat-from-gateway-location-chirpstack ger dig gatewayens position, inte enhetens. Det är ett användbart standardvärde för en sensor som annars inte skulle synas någonstans på kartan, och det ska inte läsas som en uppmätt position.

För det fullständiga A–Ö-registret över alla translatorer, se översikten över translatorer.