Trådlösa sensorer och Yggio, det öppna operativa datalagret för städer, fastighetsägare och trafikföretag. Dina data, din drift, din suveränitet.

LoRaWAN Användar- och installationsmanual

Puck Radar för LoRaWAN

Avstånd, nivå och beläggning med 60 GHz-radar, i ett hölje med IP67 och utbytbart batteri. Manualen beskriver allt från uppackning till driftsättning, förklarar radarmetoderna och VSM-applikationen i sensorn och avslutas med en teknisk referens.

Revision B · november 2026 · Sensative AB

Snabbstart Produktsida Produktblad (PDF)

1Inledning

Puck Radar mäter avståndet till det som finns framför sensorn med en pulsad koherent 60 GHz-radar, från 0,2 till 7 m med 1 mm upplösning och noggrannhet. Resultatet rapporteras via LoRaWAN som ett avstånd, en nivå eller en status (upptagen/ledig). Radarn behöver inget ljus och mäter därför lika bra dag som natt. Typiska användningsområden är parkeringsplatser, vattennivå i dagvattenbrunnar och brunnar, fyllnadsnivå i tankar, silor och avfallskärl samt snödjup.

Höljet har kapslingsklass IP67 och klarar −30 till +80 °C. Batteriet på 2 100 mAh går att byta. Puck Radar levereras med en av två linser:

  • Standardlins: bred stråle på ungefär ±60°, 30 mm hög, 38 g. Passar när en yta ska täckas, till exempel en parkeringsplats.
  • Smal lins: fokuserad stråle på ungefär ±10°, 45 mm hög, 43 g. Passar för exakt mätning på avstånd, till exempel vattennivån i en brunn eller avfallet i ett kärl.
Standardlinsen sprider strålen till ungefär ±60° och den smala linsen fokuserar den till ungefär ±10°

Två kretskort med var sin programvara

Inuti Puck finns två kretskort med var sin processor:

  • Radarkortet kör radarns firmware och sköter mätningen, det vill säga vilken radarmetod som används, hur ofta radarn mäter, inom vilket mätområde och med vilket tröskelvärde. Det har ingen VSM-applikation.
  • LoRaWAN-kortet kör firmware och en VSM-applikation. Det sköter kommunikationen med nätverket och avgör vad som ska skickas och när. Det mäter också temperatur och luftfuktighet inuti höljet, läser av accelerometern för rörelse och lutning och söker efter Wi-Fi-nät.

Båda korten kan konfigureras via LoRaWAN. På plats använder du NFC-appen Hugin för LoRaWAN-kortet och appen SweIoT Toolbox, som kommunicerar via Bluetooth, för radarkortet. Se Ändra inställningar.

Puck Radar fungerar med alla LoRaWAN-nätverksservrar (LoRaWAN 1.0.4, klass A, OTAA). Vad LoRaWAN-kortet skickar, och när, styrs av en applikation som körs i Sensatives Virtual Sensing Machine (VSM). Den här manualen beskriver applikationen Puck-radar November 2026. Applikationen kan konfigureras och ersättas av en nyare version, antingen trådlöst eller med NFC. Sensative kan också erbjuda andra VSM-applikationer för Puck, se Vilken applikation sensorn kör.

Förpackningens innehåll

  • Puck Radar med batteriet isatt
  • Tejp för plana ytor

Nycklarna (DevEUI och AppKey) finns i leveransinformationen. Monteringsplattor säljs separat. Vid montering i ett borrat hål behövs ingen platta (se steg 6).

Sensorns delar

Puck Radar med standardlins, isärtagen och visad med radarn nedåt: linslocket med radarn längst ned, basen med etiketten överst och korten, batteriet och O-ringen däremellan
Här visas Puck med radarn nedåt. Höljet består av två delar: linslocket, som radarn ser ut genom (längst ned på bilden), och basen med etiketten (överst). Etiketten med modell, region och serienummer sitter alltid på motsatt sida mot radarn. Delarna skruvas ihop och tätas med en O-ring. Batteriet sitter inuti, mellan korten.

2Innan du börjar

En LoRaWAN-sensor kräver lite mer förberedelse än en sensor som paras ihop med en hubb. Det här behöver vara klart innan du börjar:

Puck sänder via radio till en gateway, som skickar vidare till nätverksservern och därifrån till din applikation. Inställningar och radarkommandon går tillbaka som nedlänkar

Det här behöver du

  • En LoRaWAN-gateway inom räckhåll, påslagen och uppkopplad
  • Ett konto på en LoRaWAN-nätverksserver (till exempel The Things Network, ChirpStack, Loriot eller Actility) där gatewayen är tillagd
  • Nycklarna till sensorn, det vill säga DevEUI och AppKey, som finns i leveransinformationen. JoinEUI är densamma för alla sensorer av typerna Puck och Square: 70B3D52C0001D4C3.
  • En Android-telefon med NFC rekommenderas. Med den startar du sensorn, och den kör de två appar som du använder på plats: Hugin (NFC, för LoRaWAN-kortet; kräver ett användarkonto i Yggio och att sensorn är registrerad på din organisation) och SweIoT Toolbox for Puck & Prism radar sensor (Bluetooth, gratis på Google Play). Båda finns bara för Android. För Puck är de till stor hjälp när radarn ska ställas in rätt, särskilt för en ny tillämpning. Med en iPhone kan du starta sensorn med en app för NFC-läsning (se Hitta NFC-antennerna), men du kan inte köra apparna.
  • En payload-avkodare för Sensatives VSM-sensorer i nätverksservern eller applikationen (se Avkoda meddelandena)
  • För positionering: en molntjänst som stöder Wi-Fi-positionering, till exempel Yggio

Välja placering

  • Fri sikt: det får inte finnas något mellan radarn och det som ska mätas. Smuts, is, vatten eller föremål på eller framför linsen försvagar ekot eller ger falska ekon.
  • Bakom ett skydd: Puck kan mäta genom en plan plastskiva, till exempel ett lock, och påverkas då bara lite. Skivan får inte innehålla glas, metall eller kol. Kontrollera mätvärdena innan du monterar skyddet permanent.
  • Metall: det går bra att montera Puck på metall, men kapsla inte in den i metall, eftersom metall stoppar både radiosignalen och radarn.
  • Räckvidd: upp till 10 km vid fri sikt, men betydligt kortare inifrån en brunn eller en betongkonstruktion. Kontrollera signalen på den slutliga platsen (steg 4).

Så ser radarn

  • Vad som reflekterar: metall, vatten och glas reflekterar starkt. Papper, plast, tyg och människor reflekterar svagare men syns ändå. Formen spelar lika stor roll som materialet. En plan yta fungerar som en spegel. Den skickar bara tillbaka ekot från den punkt där den står vinkelrätt mot radarn, och om ytan lutar studsar ekot i stället bort – det är så smygfartyg gömmer sig. En ojämn yta sprider ekon åt många håll, så att en del alltid kommer tillbaka. Ett inåtgående hörn skickar ekot rakt tillbaka samma väg som det kom, och det är så en radarreflektor fungerar.
  • Falska ekon: radarn kan också se sidoväggar, brunnens botten, fästet eller ett lock ovanför sensorn, och ekon som studsar mellan dem. Rikta radarn rakt mot målet, håll strålen fri från väggar och begränsa mätområdet till där målet kan finnas (se Radarmetoder).
  • Stilla vatten är en spegel: rikta radarn rakt ned mot en stilla yta, eller luta den bara några grader. Strålen är ungefär ±10° bred, så vid en liten lutning träffar en del av den ändå ytan vinkelrätt. Vid en större lutning reflekteras strålen bort, som ljus i en spegel, och ekot går förlorat.
  • Varifrån avståndet mäts: radarns referenspunkt (nollpunkt) ligger inne i höljet, i radarchipets plan: 11 mm (standardlins) eller 26 mm (smal lins) innanför linsytan.
Puck med smal lins från sidan, linsen nedåt mot vattnet: nollpunkten är markerad i radarchipets plan, 26 mm ovanför linsytan
Nollpunkten: alla avstånd mäts från radarchipets plan, 26 mm innanför linsytan med smal lins (11 mm med standardlins).
Fyra radarvägar i en brunn, med Puck på en konsol vid vänster vägg, lutad några grader: den raka vägen ned till vattenytan, en väg via vänster vägg, vattnet och höger vägg, en dubbelstuds mellan ytan och sensorn och ett eko från en avsats två tredjedelar ned
Bara den första vägen (grön) mäter vattennivån. De andra ger falska ekon: via vänster vägg, vattnet och höger vägg, genom en dubbelstuds mellan ytan och sensorn och från en liten avsats i brunnen. Avsatsens inre hörn, där den möter väggen, skickar ekot rakt tillbaka innan radarn når vattnet.

Välja lins

UppgiftLinsPlacering
ParkeringsplatsStandard, eller smal för en trång plats10–300 cm över marken, ovanför eller framför platsen
Vattennivå i en brunn eller dagvattenbrunnSmalOvanför vattnet, fri från sidoväggarna och lutad några grader så att kondens rinner av åt sidan
Fyllnadsnivå i en tank eller silo, snödjupSmalOvanför ytan, riktad rakt ned
AvfallskärlSmalOvanför kärlet, riktad nedåt, eller på en sidovägg, riktad tvärs över öppningen

Hitta NFC-antennerna

NFC når bara ett par centimeter, så lägg telefonen plant på Puck med antennerna mitt för varandra:

NFC-antennen sitter mitt på ovansidan av Puck, framför radarn. Lägg telefonen plant över den
  • På Puck: mitt på ovansidan, precis framför radarn.
  • På en Android-telefon (rekommenderas): slå på NFC och aktivera vibration eller ljud för NFC i telefonens inställningar, så att telefonen säger till direkt när den har hittat sensorn. Antennen sitter oftast upptill på baksidan, ofta nära kameran, men placeringen varierar mellan modeller. I telefonens manual eller på tillverkarens webbplats ser du var den sitter. Om du inte hittar den kan du föra telefonens baksida långsamt över ovansidan av Puck tills telefonen vibrerar.
  • Ta av telefonskalet: ett skyddsskal, särskilt ett tjockt skal eller ett med metall eller magnet, kan göra det svårt att få NFC-kontakt.
  • Håll sedan telefonen stilla: för att starta en anslutning håller du telefonen stilla mot Puck i ungefär 5 sekunder. Om du använder appen Hugin låter du telefonen ligga kvar tills appen är klar. Om du tar bort telefonen för tidigt bryts förbindelsen och du måste börja om.
  • På en iPhone: använd en app för NFC-läsning, till exempel NFC Reader & Scanner från App Store. Öppna appen och tryck på NFC-knappen så att den visar Ready to Scan. Håll sedan överkanten av iPhonens baksida stilla ovanpå Puck. Guiden för NFC-anslutning med iPhone (PDF) visar varje steg med bilder.

3Installation steg för steg

Installationen görs i åtta steg. Registrera sensorn i nätverksservern innan du håller telefonen mot den. Anslut den sedan till nätverket, ställ in radarn för uppgiften och montera sensorn sist.

1

Packa upp

Kontrollera Puck och ta fram nycklarna. Kontrollera vilken lins sensorn har (se Inledning). Sensorn är i viloläge tills den kommer i kontakt med ett NFC-fält.

2

Registrera sensorn i nätverksservern

  1. Lägg till en ny slutenhet i nätverksservern och välj aktiveringssättet OTAA.
  2. Använd följande LoRaWAN-inställningar: MAC-version 1.0.4, regionala parametrar RP002-1.0.3, max EIRP 14 dBm och frekvensplanen för din region.
  3. Ange DevEUI och AppKey från leveransinformationen samt JoinEUI 70B3D52C0001D4C3. Kontrollera dem noga. Om ett enda tecken är fel misslyckas anslutningen.
  4. Ställ in avkodningen av meddelandena (se Avkoda meddelandena).
Klart när: enheten syns i nätverksserverns lista och väntar på sin första anslutning.
3

Anslut till nätverket med NFC

Lägg telefonen plant ovanpå Puck och håll den stilla i ungefär 5 sekunder. Då startar anslutningen (se Hitta NFC-antennerna, där det också finns anvisningar för iPhone).

Klart när: nätverksservern visar att sensorn har anslutit, oftast inom två minuter.
Om nätverket inte går att nå ännu gör Puck ett nytt försök var 5:e timme (inställningen Time between join retries). Om du håller telefonen mot sensorn igen startar ett nytt försök direkt.
4

Kontrollera signalen på monteringsplatsen

Placera sensorn där den ska monteras och titta på dess meddelanden i nätverksservern, det vill säga anslutningen och de första rapporterna.

Riktvärden: länken ska klara minst SF9. En tumregel är ett SNR över −5 dB och ett RSSI över −115 dBm. Det ger marginal till gränsen för SF9 (ungefär −12,5 dB SNR).
Med en svagare länk tvingas nätverksserverns adaptiva datahastighet (ADR) ned till SF10–SF12. Då tar varje meddelande mycket längre tid att sända, vilket kostar både batteri och kapacitet. Om sensorn fortfarande ligger på SF10–SF12 ett dygn efter installationen behöver länken förbättras. Flytta gatewayen eller sensorn, eller lägg till en gateway.
5

Välj radarmetod och mätområde

Radarn mäter bara när Puck är ansluten. Kontrollera vilken radarmetod som är aktiv och att metoden och dess mätområde passar uppgiften och platsen (se Radarmetoder). Ställ sedan in när Puck ska rapportera, det vill säga avståndssteg, medelvärden och larmnivåer (se Vad sensorn rapporterar).

Hur du ändrar inställningarna beskrivs i Ändra inställningar och i exemplen.

Ny tillämpning? Ta först reda på vad radarn faktiskt ser. Starta radarns Bluetooth med appen Hugin och prova metoder och inställningar på plats i SweIoT Toolbox, eller gör en skanning via LoRaWAN för att se var ekona finns och hur starka de är (se Ny tillämpning och SweIoT Toolbox).
6

Montera

Välj ett av följande sätt:

  1. Med tejp på en slät, torr och plan yta av metall eller plast. Rengör ytan med en blandning av isopropylalkohol och vatten (50–70 % alkohol) och låt den torka. Använd inte tejpen på oljiga ytor eller under +5 °C.
  2. Med monteringsplatta (säljs separat): fäst Puck centrerad över plattans öppning med plattans tejpring. Skruva fast plattan på en vägg eller balk, eller spänn fast den på ett rör eller en stolpe med buntband genom slitsarna.
  3. I ett borrat hål i nivå med en vägg eller ett tak: borra ett hål på 45 mm, rengör det och lägg ett tjockt lager fogmassa i botten. Sätt Puck i hålet med basen inåt och linsen utåt och håll den rak medan fogmassan härdar. Se till att det inte kommer fogmassa eller lim på linslocket, eftersom det stör radarn och gör att du inte kan öppna Puck för att byta batteri.
  4. I en brunn eller dagvattenbrunn: på en konsol eller med band tvärs över öppningen, riktad rakt ned mot vattnet.
Monteringsplattan för Puck: en tunn stålplatta med en tejpring, fyra skruvhål och fyra slitsar för buntband
Monteringsplattan: 52 × 43 mm, 0,8 mm stål.
Tre Puck i bruk: på en betongpelare, på en konsol i en dagvattenbrunn i gatan och fastspänd tvärs över en brunn
Från vänster: på en betongpelare, på en konsol i en dagvattenbrunn och fastspänd tvärs över en brunn.
Montera Puck så att du kommer åt ovansidan med en telefon (NFC) och – om den inte sitter i ett borrat hål – så att du kan ta ned den för att byta batteri.
7

Testa

Placera ett föremål framför radarn på ett känt avstånd, eller vänta på de första mätningarna av det verkliga målet.

Klart när: avståndet (och för parkering även beläggningsstatusen) kommer fram i din applikation och stämmer med det verkliga avståndet, räknat från radarns referenspunkt.
Radarkommandot test:10 får radarn att mäta var 10:e sekund i 10 minuter, så att du direkt ser hur monteringen påverkar mätningen. Skicka kommandot från menyn Commands and Logs i SweIoT Toolbox, där du ser varje mätning, eller via LoRaWAN på port 48. Via LoRaWAN når kommandot sensorn först efter Pucks nästa meddelande, och bara ändringar som är större än Radar Distance Hysteresis skickas. Om avståndet är 0, fel eller hoppar bör du läsa Felsökning innan du monterar Puck permanent.
8

Driftklar

  • Registrerad i nätverksservern med JoinEUI och rätt region
  • Ansluten med NFC och meddelandena avkodade
  • Signalen kontrollerad på den slutliga platsen: SF9 eller bättre
  • Radarmetod och mätområde inställda för uppgiften
  • Monterad med fri sikt mot målet och åtkomlig för NFC och batteribyte
  • Avstånden kommer fram och stämmer med det verkliga avståndet

4Använda sensorn

Radarkortet mäter och VSM-applikationen på LoRaWAN-kortet avgör vad som ska skickas. Inställningarna i fetstil finns i inställningstabellen och under Radarkommandon.

Radarmetoder

Radarkortet mäter med en metod i taget. Den här manualen beskriver metod 3–8 i radarfirmware 2.24. Varje metod har egna inställningar för hur ofta den mäter, mätområdet och hur starkt ett eko måste vara för att räknas. Du väljer och ställer in metoden med radarkommandon (se Radarkommandon) eller i SweIoT Toolbox.

NrMetodVad den rapporterarTypisk användningStandardintervall och mätområde
3WellDet mest avlägsna ekot över tröskelvärdet, det vill säga ytan. Närmare ekon ignorerasBrunnar, dagvattenbrunnar, slambrunnar, vattennivå, snödjupVar 300:e s, 0,5–3,5 m
4BinDet närmaste ekot över tröskelvärdet och en flagga för upptagen efter 3 detekteringar i radAvfallskärl och containrarVar 120:e s, 0,15–1,15 m
5ParkingDet starkaste ekot, och upptagen när ekots styrka är 350 eller merParkeringsplatserVar 30:e s, 0,2–1,7 m
6SeatingDet starkaste ekot, och upptagen eller ledig när ett antal mätningar i rad stämmer överensSittplatserVar 60:e s, 0,24–1,24 m
7Adv_SeatingUpptagen eller ledig, bekräftat över flera mätningar, och som tillval rullstol eller annat föremålSittplatser i tåg, bussar och väntrum samt rullstolsplatserStälls in för varje installation
8Distance2Avstånd och styrka för ett eko i var och en av två zoner, med eget tröskelvärde och eget val av eko för varje zonAllmän avståndsmätning, två målVar 300:e s; zon 1 0,20–0,47 m, zon 2 0,50–0,60 m
  • Mätintervall: hur ofta radarn mäter. Glesare mätningar sparar batteri.
  • Mätområde: start och längd för det fönster som radarn mäter i, upp till 7 m från sensorn. Begränsa det till där målet kan finnas. Ett kortare fönster ger säkrare mätning och drar mindre batteri.
  • Tröskelvärde: hur starkt ett eko måste vara för att räknas. Ett lägre tröskelvärde fångar svagare ekon, men också fler falska.
  • Medelvärdesbildning: med flera svep per mätning, sammanvägda som median eller medelvärde, blir mätvärdet stabilare i regn eller snö och på vatten i rörelse. Varje extra svep kostar batteri, och det gör även fler hårdvarusampel per svep (HWAAS).

Brunnar, vattennivå och snödjup (metod 3)

  • Ställ in mätområdet så att det slutar minst 10 cm ovanför brunnens botten och så att den högsta förväntade vattennivån ligger i områdets bortre halva.
  • Rikta Puck rakt ned mot vattnet, eller luta den några grader. Placera den så att strålen går fri från sidoväggarna, och håll stora reflekterande föremål, till exempel av metall, borta från området runt och ovanför sensorn.
  • I en brunn har en lätt lutning ytterligare en fördel: kondens som bildas på linsen rinner av åt sidan i stället för att bli kvar framför radarn.
  • Puck mäter avståndet ned till ytan. Själva nivån räknar du ut i din applikation. Vattennivån är brunnens djup minus avståndet, och snödjupet är avståndet till barmark minus avståndet till snön.
  • Om ytan inte hittas (avstånd 0) sänker du tröskelvärdet. Om mätvärdena hoppar på grund av krusningar på ytan kan du använda fler svep eller en längre paus mellan dem.
  • Adaptivt mätområde (avstängt som standard) gör att fönstret följer ytan, så att radarn bara sveper över ett smalt band runt den. Det sparar batteri. Om nivån hamnar utanför bandet mäter Puck direkt hela mätområdet igen.

Avfallskärl (metod 4)

  • Montera Puck ovanför kärlet, riktad nedåt, eller på en sidovägg, riktad tvärs över öppningen. Mätområdet ska nå ned till botten av det tomma kärlet.
  • Tröskelvärdet är den viktigaste inställningen. Mjukt avfall, som papper, reflekterar svagt och kan kräva ett lägre tröskelvärde, medan metall reflekterar starkt. Om kärlets egna väggar eller lock ger ekon höjer du tröskelvärdet eller låter mätområdet börja bortom dem.
  • Ju kortare avstånd, desto fullare kärl.
  • För kärl i alla storlekar, från papperskorgar och sopkärl till stora containrar, kan metoden Distance2 med två zoner också visa när botten är täckt och när kärlet är fullt (se exemplet nedan).

Parkering (metod 5)

  • En parkeringsplats räknas som upptagen när det starkaste ekot inom mätområdet är 350 eller mer. Gränsen är fast, så monteringen och mätområdet måste väljas så att en bil ger ett starkt eko och en tom plats ett svagt.
  • Välj lins efter hur bred yta som ska täckas, och låt mätområdet sluta där bilens kaross kan finnas, före golvet, trottoarkanten eller taket bakom.
  • Mätvärdet filtreras inte. Om ekot pendlar kring 350 kan statusen slå om fram och tillbaka. Justera i så fall monteringen eller mätområdet.
  • Om send only changes är påslaget i systeminställningarna rapporterar Puck bara när en bil kommer eller åker, vilket sparar batteri (se Radarinställningar per position).

Sittplatser (metod 6 och 7)

  • Seating (6) växlar mellan upptagen och ledig först när ett antal mätningar i rad stämmer överens, som standard 3 i varje riktning. Om ett ryggstöd eller en bordskant gör att platsen felaktigt visas som upptagen kan du höja tröskelvärdet eller korta mätområdet.
  • Adv_Seating (7) är en utökad sittplatsmetod för krävande beläggningstillämpningar. Den filtrerar bort korta händelser innan statusen ändras, rapporterar bara när statusen ändras och skiljer i rullstolsläge mellan en rullstol och andra föremål, som bagage.

Två avstånd (metod 8)

  • Varje zon rapporterar sitt eget eko – det närmaste, det starkaste eller det mest avlägsna, beroende på vad du väljer. En zon vars slut är satt till 0 är avstängd.

Exempel: avfallskärl eller container med två zoner

Med två zoner kan en Puck ovanför en papperskorg, ett sopkärl eller en container ge tre olika besked. Anta att Puck sitter 1,2 m ovanför botten:

  • Zon 1, från 0,2 m till strax ovanför botten (här 0,2–1,1 m), med det närmaste ekot valt, ger avståndet till avfallets överkant och därmed fyllnadsnivån.
  • Zon 2, en smal zon runt botten (här 1,15–1,25 m): så länge zonen har ett eko syns botten fortfarande. När ekot försvinner är botten täckt av avfall.
  • Inget eko i någon av zonerna: radarn ser ingenting bortom 0,2 m. Avfallet har troligen kommit närmare Puck än 0,2 m, och kärlet är fullt. (Om något täcker linsen blir resultatet detsamma, så kontrollera Puck om det händer när kärlet är tomt.)

Ställ in detta med tre radarkommandon, som skickas som var sin nedlänk på port 48. sys:8 väljer metod 8. 8:600,,,,,,0.2,1.1,,,0,1.15,1.25 ger mätning var 10:e minut och ställer in zon 1 (position 7 och 8), det närmaste ekot (position 11) och zon 2 (position 12 och 13). 8:,,,,,,,,,,,,,,,,0,0 stänger av uteslutningszon 1 (position 17 och 18), så att den inte döljer någon del av zon 1. Zon 2 rapporteras som distance2 och amplitude2 (se Meddelanden).

Ny tillämpning: se vad radarn ser

Innan du sätter upp en tillämpning som inte har prövats tidigare bör du testa den på plats och ta reda på vad radarn faktiskt ser – var ekona kommer ifrån, hur starka de är och hur strålen reflekteras av väggar, inredning och själva målet. Det finns två sätt att göra det:

  • SweIoT Toolbox: prova olika metoder och inställningar på plats och se resultatet direkt (se SweIoT Toolbox).
  • Skanning via LoRaWAN: välj metod 7 eller 8 och skicka meth_cmd:2,start,end,sections på port 48, med start och slut i meter. Radarn svarar på port 32 med ekostyrkan längs zonen i form av en lista med det starkaste ekot i varje avsnitt, dividerat med 10. Med 0 avsnitt får du varje mätpunkt. Till exempel ger meth_cmd:2,0.5,2.5,40 40 värden från 0,5 till 2,5 m, ett var 5:e cm. Listan gäller den senaste mätningen. Metod 3–6 har inte det här kommandot.

Skanningar gör det också möjligt för en IoT-plattform som Yggio att kalibrera monterade Puck automatiskt. Plattformen ber varje Puck om en skanning, hittar målet och eventuella fasta reflektorer, räknar fram zoner och tröskelvärden och skickar tillbaka dem som radarkommandon. Det upprepas tills resultatet blir rätt.

Vad sensorn rapporterar

VSM-applikationen på LoRaWAN-kortet tar emot varje radarmätning och skickar bara det som har ändrats:

  • Avstånd och ekostyrka: skickas när avståndet har ändrats mer än Radar Distance Hysteresis (10 cm som standard) eller ekostyrkan mer än Radar Amplitude Hysteresis. Med metoden Distance2 skickas även ekot i zon 2.
  • Upptagen: 1 eller 0, från de metoder som bedömer beläggning: Bin, Parking, Seating och Adv_Seating.
  • Medelavstånd: avståndet mäts av varje minut och medelvärdet beräknas över Average Distance Interval (24 timmar som standard). Medelvärdet skickas när det har ändrats mer än avståndshysteresen.
  • Avståndslarm: ställ in Distance Alarm Low Level och High Level i meter från sensorn. Larmet följer medelavståndet och reagerar därför inte snabbare än Average Distance Interval. Korta intervallet om du använder larmet. 0 stänger av det nedre larmet.
  • Inget eko: om en mätning inte hittar något eko över tröskelvärdet styr inställningen Report Failed Measurements vad som händer. Om den är avstängd (standard) skickas ingenting och det senast rapporterade avståndet gäller. Om den är påslagen rapporterar Puck avståndet 0, så att du till exempel kan se att målet har hamnat utanför mätområdet.
  • Detekteringsgrad: en gång per dygn skickas andelen mätningar som hittade ett eko, i procent. En minskning kan till exempel bero på strömmande vatten eller kraftigt regn eller snöfall som hindrar radarn från att få ett stabilt eko.

Temperatur, luftfuktighet och batteri

Som standard skickar Puck batterispänning, temperatur och luftfuktighet var 8:e timme (periodic reports interval), tillsammans med en räknare som ökar med ett varje gång.

  • Inuti höljet: temperatur och luftfuktighet mäts inuti den tätade Puck, inte i luften runt omkring. Temperaturen har en noggrannhet på ungefär ±2 °C mellan 0 och 30 °C och kan justeras med Temperature Calibration.
  • Luftfuktigheten som varning: inuti Puck finns silikagel som tar upp fukt. Om luftfuktigheten stiger hela tiden tränger fukt in, eller så är silikagelen mättad (se Underhåll). Luftfuktigheten jämförs också varje timme med Humidity Alarm Level (60 % RF som standard). När nivån nås skickar Puck ett bekräftat fuktlarm, så att silikagelen kan bytas, och återställer larmet när luftfuktigheten åter är 5 % RF under nivån. 0 stänger av larmet.
  • Batteri: spänningen mäts under en radarmätning. Ett enstaka lågt värde är normalt, liksom lägre spänning i kyla. Byt batteri om spänningen ligger kvar under 2,8 V vid temperaturer över +10 °C.

Rörelse och lutning

Puck kan tala om när den har fått en stöt, flyttats eller vridits. Ställ in Position Check Interval (avstängt som standard), så läser Puck av accelerometern med det intervallet när den är ansluten och står stilla, så att det är tyngdkraften som mäts. Den första kontrollen blir referens och skickas som X, Y och Z. Om en senare kontroll visar att Puck avviker mer än Position Moved Threshold (som standard 1,71 m/s², ungefär 10°) från referensen gör sensorn en ny kontroll en minut senare. Om Puck fortfarande är flyttad skickas den nya referensen och flytten räknas. Så länge Puck ligger still skickas ingenting. Kontrollen upptäcker en ändrad orientering (lutning eller vridning), men inte en förflyttning där orienteringen är densamma. En Puck som flyttas och sätts tillbaka mellan två kontroller upptäcks inte, och inte heller en som störs kortare tid än en minut, till exempel av trafik. Referensen försvinner vid en omstart, och då skickas en ny. Om du stänger av och slår på funktionen behålls referensen. Varje kontroll är en avläsning på ungefär 0,1 s, och i övrigt är accelerometern avstängd.

Position

En gång per dygn, när Puck är ansluten, söker den efter Wi-Fi-accesspunkter och skickar resultatet, så att en molntjänst kan räkna fram positionen (se Så fungerar Wi-Fi-positionering).

Loggade data

Mätvärden som tas medan Puck saknar nätverk sparas i minnet och skickas via LoRaWAN när sensorn har kontakt igen, vart och ett med tidpunkten för mätningen. För bekräftade utdata sparas hela historiken tills minnet är fullt, för obekräftade utdata bara det senaste värdet. NFC-appen Hugin kan inte läsa ut loggen. Tidpunkterna kommer från Pucks klocka, som ställs via nätverket. Puck frågar efter tiden inom den tid som anges i Device Time Max Age (30 dagar som standard, se Enhetsregister). Utan tid loggas ingenting.

Så fungerar Wi-Fi-positionering

  • Bara 2,4 GHz: radion söker bara i 2,4 GHz-bandet (2412–2484 MHz). Nät som bara sänder på 5 GHz syns inte.
  • Passiv avsökning: sensorn lyssnar efter Wi-Fi-accesspunkter i närheten (802.11 b/g/n) och registrerar deras MAC-adresser och signalstyrka (RSSI). Den ansluter inte till något nät, behöver inget lösenord och skickar ingenting via Wi-Fi. Adresserna skickas med LoRaWAN-upplänken.
  • Antal: det behövs minst 2 accesspunkter för en position, och fler ger ett bättre resultat.
  • Positionen: för att få en position behövs en molntjänst som stöder Wi-Fi-positionering, till exempel Yggio (Munin och LoRa Cloud klarar det också). Tjänsten slår upp adresserna i en databas med kartlagda accesspunkter och returnerar positionen.
  • Noggrannhet: beror på hur många kända accesspunkter som finns i närheten, normalt 5–20 m inomhus. Med bara en eller två får du snarare området än rummet. Noggrannheten blir bättre om du sätter upp billiga 2,4 GHz-accesspunkter.
  • Bara Wi-Fi: Puck Radar har ingen satellitpositionering.

Nätverk

  • Bekräftade meddelanden: avstånd, ekostyrka, medelvärde, larm, beläggningsstatus, detekteringsgrad och rapporter om rörelse och lutning kvitteras av nätverksservern. Om ingen kvittens kommer skickar Puck dem igen och väntar då högst Max time between ReSend tries (4 timmar som standard) mellan försöken.
  • Anslutning: om Puck inte är ansluten försöker den ansluta var 5:e timme (Time between join retries) och minst en gång per dygn. Med NFC-kontakt startar du ett anslutningsförsök direkt. Radarn är avstängd så länge Puck inte är ansluten.
  • Tappat nätverk: Puck släpper nätverket och ansluter på nytt om den inte har hört något från nätverket under den tid som anges i Time from last RX before unjoin (15 dagar som standard) eller i Downlink Timeout (se Enhetsregister).
  • Roaming: om Roaming Network Count är större än 1 provar Puck flera nätverksidentiteter i tur och ordning vid anslutningen, genom att ändra sista siffran i sin AppKey. Varje extra identitet kostar tid och batteri vid anslutningen.
  • Adaptiv datahastighet: Puck följer nätverksserverns adaptiva datahastighet (ADR), som bestämmer datahastighet och sändeffekt. Om Puck tappar kontakten med nätverket sänker den själv datahastigheten gradvis tills den når nätverket igen.

Avkoda meddelandena

Meddelandena är kompakta binära poster, och hur de ska tolkas beror på applikationsversionen. Avkoda dem med en avkodare som hanterar VSM:

  • Yggio avkodar dem med sin inbyggda VSM-översättare och håller reda på applikationsversionen i varje sensor.
  • Andra plattformar: använd Munin, Sensatives MQTT-klient med öppen källkod. Munin avkodar meddelandena oavsett nätverksserver, håller både det enhetstillstånd som avkodaren behöver och enhetens tid uppdaterade och beräknar Wi-Fi-positioner.
  • Egen integration: VSM-översättaren med öppen källkod är den avkodare som Munin använder och finns som Node-paket. Du behöver se till två saker: att den kan spara åtminstone rulesCrc32 för varje sensor mellan meddelandena, och att den hålls uppdaterad, eftersom nya applikationsversioner släpps utan förvarning.

Ändra inställningar

Det finns två sorters inställningar: VSM-applikationens inställningar på LoRaWAN-kortet (när sensorn ska rapportera, larm och nätverk) och radarinställningarna på radarkortet (metod, intervall, mätområde och tröskelvärde). Båda kan ändras trådlöst eller på plats med en app:

Via LoRaWANPå plats
Applikationsinställningar (LoRaWAN-kortet)Nedlänkar på port 2 eller port 7NFC-appen Hugin (Android), till exempel med en QR-kod från VSM Configuration Tool
Radarinställningar (radarkortet)Radarkommandon på port 48Appen SweIoT Toolbox (Android), via Bluetooth
ProgramuppdateringarNya VSM-applikationerHugin: LoRaWAN-kortets firmware och VSM-applikation. SweIoT Toolbox: radarns firmware, som bara kan uppdateras den vägen

Nedlänkar för båda sorterna skapar du i VSM Configuration Tool.

  1. Välj applikation efter namn och version, eller efter den rulesCrc32 som Puck skickar på port 15 (se Vilken applikation sensorn kör).
  2. Välj Custom och ange de värden du vill ha. För varje inställning visas beskrivning, enhet och tillåtet intervall. Skriv radarkommandon i fältet Radar Module Commands, åtskilda med ;, till exempel sys:3;3:600.
  3. Hämta resultatet som nedlänkar för port 2 och port 48 eller som en enda payload för port 7, i hex eller base64, och skicka dem från nätverksservern. Du kan också hämta en QR-kod och skanna den med NFC-appen Hugin.
Puck är en klass A-enhet, vilket innebär att den tar emot en nedlänk direkt efter varje upplänk. Inställningar börjar gälla tidigast efter Pucks nästa meddelande, och i ett hårt belastat nätverk kan det dröja längre. Alla inställningar som får Puck att mäta eller sända oftare kostar batteri.

5Apparna Hugin och SweIoT Toolbox

NFC-appen Hugin (LoRaWAN-kortet)

Hugin är en valfri Android-app för att arbeta med sensorn på plats via NFC. Appen kräver en Android-telefon med NFC och GPS samt ett användarkonto i Yggio. Sensorn måste dessutom vara registrerad i Yggio med din organisation som ägare. Hugin kontrollerar det mot Yggio innan du får arbeta med sensorn. Håll telefonen mot sensorn enligt Hitta NFC-antennerna. Appen visar då serienumret, applikationen och dess version, status (till exempel ansluten), information om batteri, länk och region samt DevEUI. Beroende på dina behörigheter i Yggio kan du läsa och tillämpa konfigurationsprofiler, även profiler som skannats som QR-kod från VSM Configuration Tool, och uppdatera enhetens tid och position.

Installation, inloggning, flashning och felsökning beskrivs i manualen för NFC-appen Hugin.

Hugin uppdaterar också LoRaWAN-kortets firmware och VSM-applikation.

SweIoT Toolbox for Puck & Prism radar sensor

SweIoT Toolbox är en Android-app (finns på Google Play) som kommunicerar med radarkortet via Bluetooth. Någon iPhone-version finns inte. Använd appen på plats för att läsa och ändra radarinställningarna och för att uppdatera radarns firmware.

  • Starta radarns Bluetooth med Hugin: Bluetooth på radarkortet är avstängt nästan hela tiden, av tre skäl: det sparar batteri, det håller nere radiotrafiken och det begränsar vem som kan nå radarkortet, i enlighet med EU:s Cyber Resilience Act. Bara sensorns registrerade ägare, eller användare som ägaren har gett behörighet, kan slå på Bluetooth. Starta det för SweIoT Toolbox genom att hålla telefonen mot Puck med appen Hugin öppen (se Hitta NFC-antennerna) och trycka på Activate Radar Bluetooth. Radarkortet annonserar sig då i ungefär 20 sekunder, så anslut från SweIoT Toolbox inom den tiden. NFC-kontakt utan appen Hugin startar inte Bluetooth, utan får bara Puck att skicka ett meddelande. Du kan också slå på Bluetooth på distans med en LoRaWAN-nedlänk, till exempel från Yggio, genom att sätta Radar BT Advertise trigger till 1 (se Inställningar). I Yggio kan bara användare med behörighet till sensorn skicka den nedlänken. I övrigt annonserar radarkortet bara några sekunder efter varje mätning.
  • I appen: SweIoT Toolbox guidar dig när du väljer radarmetod och justerar de viktigaste inställningarna. Menyn Commands and Logs tar emot samma radarkommandon som LoRaWAN.
  • Uppdateringar: radarns firmware kan bara uppdateras via Bluetooth, med SweIoT Toolbox.

6Underhåll och demontering

Batteri

Batteriet är ett utbytbart litium-tionylkloridbatteri (LiSOCl₂) på 3,6 V och 2 100 mAh, som valts eftersom det fungerar från −30 till +80 °C. Hur länge det räcker beror på radarmetoden, hur ofta radarn mäter, medelvärdesbildningen och hur ofta Puck rapporterar. Som riktmärke räcker batteriet väl över tio år på en parkeringsplats med mätning var 30:e sekund, och i en brunn eller ett avfallskärl med mätning var 10:e minut. Ett bra nätverk (SF7–SF9) förlänger batteritiden och en svag länk förkortar den. Byt batteri när spänningen ligger kvar under 2,8 V vid över +10 °C (se Temperatur, luftfuktighet och batteri).

Byta batteri

Använd Sensatives batterisats, som innehåller ett nytt batteri, en ny O-ring, en ny gummidyna och två Star-verktyg. Byt batteri på en torr plats.

Star-verktyget för att öppna och stänga Puck
Star-verktyget. Använd ett i varje ände av Puck.
  1. Ta ned Puck. Sätt ett Star-verktyg i varje ände och vrid linslocket moturs så att höljet öppnas. Använd aldrig andra verktyg, eftersom de kan knäcka höljet eller göra att det inte blir ordentligt stängt.
  2. Lossa det gamla batteriets kontakt och anslut det nya batteriet. Håll ned kretskortet med ett finger medan du drar ut kontakten. Annars kan korten följa med upp ur höljet, och de är svåra att få tillbaka på plats. Klipp inte av batteriets ledningar.
  3. Sätt i den nya gummidynan och den nya O-ringen och kontrollera att de sitter rätt och är rena. Det är de som håller Puck vattentät.
  4. Stäng höljet genom att vrida medurs ungefär ett kvarts varv och dra sedan åt helt med de två Star-verktygen.
  5. Puck startar om och ansluter själv till nätverket igen om den var ansluten tidigare. Kontrollera att mätningarna kommer fram. Om Puck aldrig har varit ansluten ansluter du den med NFC enligt steg 3.
Puck Radar öppnad, med batteriet på sin kontakt och den blå O-ringen
Puck öppnad, med batteriet på sin kontakt och den blå O-ringen.

Fukt

Puck är tät, och silikagel inuti tar upp fukt som kondenserar. Om luftfuktigheten som rapporteras inifrån fortsätter att stiga, eller om fuktlarmet utlöses (som standard vid 60 % RF, se Temperatur, luftfuktighet och batteri), öppnar du Puck enligt ovan, kontrollerar O-ringen och byter silikagelen.

Demontera Puck Radar

Om sensorn sitter med tejp drar du in tandtråd bakom Puck och sågar försiktigt igenom tejpen. Om den sitter på en monteringsplatta skruvar du loss eller kapar loss plattan. Batteriet kan bytas med plattan kvar.

Byta nätverksserver

Ta bort enheten från den gamla nätverksservern och lägg till den i den nya. Puck tappar då kontakten med det gamla nätverket och ansluter till det nya. Du kan i stället starta om sensorn direkt med appen Hugin (ON / OFF), men då återställs också alla egna inställningar.

Förvaring, säkerhet och kassering

  • Förvara oanvända sensorer och batterier vid +10 till +30 °C.
  • Kortslut inte batteriet, punktera det inte och värm det inte över +80 °C. Öppna bara Puck för att byta batteri.
  • Lämna använda batterier till batteriåtervinning och Puck, utan batteri, som elektronikavfall.

7Felsökning

ProblemÅtgärd
Avståndet är 0, eller inget mål hittasAvståndet 0 betyder att mätningen inte hittade något eko över tröskelvärdet (det skickas bara om Report Failed Measurements är påslaget). Målet ligger utanför mätområdet eller ger för svagt eko. Kontrollera Start och Length of range och sänk sedan tröskelvärdet (se Radarmetoder).
Distance2: inget eko från en zonKontrollera att mätområdena för de två zonerna och för uteslutningszonerna är rätt inställda. En uteslutningszon som täcker en detekteringszon döljer alla ekon i den.
Avståndet är felRadarn ser en annan väg, till exempel via en sidovägg, botten, fästet eller ett lock. Rikta Puck rakt mot målet, korta mätområdet, höj tröskelvärdet eller använd den smala linsen (se Så ser radarn).
Mätvärdena hoppar i regn eller snö eller på vatten i rörelseAnvänd fler svep per mätning, med median påslaget, eller en längre paus mellan svepen (se Radarinställningar per position). Båda alternativen kostar batteri. Den dagliga detekteringsgraden visar hur ofta radarn hittar ett stabilt eko.
Inga mätningar, trots att Puck har anslutitRadarn mäter bara när Puck är ansluten. Läs av radarinställningarna med sys? på port 48 och kontrollera metoden och att radarn är aktiv (position 6).
Ett radarkommando besvaras med *Kommandot godtogs inte. Kontrollera format och värden (se Radarkommandon) och läs av de aktuella värdena med sys? eller, för en metod, till exempel 3?.
SweIoT Toolbox hittar inte radarnStarta Bluetooth med appen Hugin (det kräver behörighet till sensorn i Yggio) och anslut sedan inom ungefär 20 sekunder. Du kan också skicka Radar BT Advertise trigger. SweIoT Toolbox finns bara för Android.
Luftfuktigheten inuti stiger hela tiden, eller fuktlarmet utlösesFukt tränger in, eller silikagelen är mättad. Kontrollera O-ringen och byt silikagelen (se Underhåll). Larmet återställs av sig självt när luftfuktigheten åter är 5 % RF under Humidity Alarm Level.
Inga rapporter om rörelse eller lutningPosition Check Interval är 0 som standard, vilket betyder att funktionen är avstängd. Ställ in ett intervall (se Rörelse och lutning). En förflyttning där orienteringen är densamma, eller en Puck som flyttas och sätts tillbaka mellan två kontroller, upptäcks inte.
Batterispänningen är lågKontrollera först temperaturen, eftersom spänningen sjunker i kyla. Byt batteri om spänningen ligger kvar under 2,8 V vid över +10 °C.
Ingenting händer när jag håller telefonen mot sensornKontrollera att NFC är påslaget och att telefonskalet är borttaget. Lägg telefonen plant ovanpå Puck och flytta den långsamt tills den signalerar kontakt. Håll den sedan stilla (se Hitta NFC-antennerna).
Join-förfrågan (Join Request) syns i nätverksservern, men ingen Join AcceptKontrollera nycklarna, JoinEUI 70B3D52C0001D4C3, LoRaWAN-versionen (1.0.4), de regionala parametrarna (RP002-1.0.3) och frekvensplanen (EU868).
Ingenting alls syns i nätverksservernKontrollera att gatewayen är påslagen och uppkopplad och att Puck är inom räckhåll och inte sitter inuti ett metallhölje. Starta sedan en ny anslutning med NFC enligt steg 3.
”MIC mismatch”Nycklarna är fel. Kontrollera att de hör till just den här sensorn och att de är rätt inskrivna.
Meddelanden kommer fram, men avkodaren visar inga mätvärdenOftast har avkodaren missat applikationsidentiteten. Skicka 00 på port 15 och kontrollera att avkodaren är uppdaterad (se Vilken applikation sensorn kör).
En ny inställning får ingen effektEn nedlänk når Puck först efter dess nästa meddelande, och ännu senare i ett hårt belastat nätverk. Kontrollera att nedlänken fortfarande ligger i kö och att den skapades för den rulesCrc32 som din Puck rapporterar.
Meddelanden saknas eller kommer oregelbundetKontrollera RSSI och SNR. Puck kan sitta för långt från gatewayen, eller djupt nere i en brunn eller betongkonstruktion. Vissa kanaler kan också störas av andra sändare i samma frekvensband, till exempel en mobilmast i närheten eller en RFID-läsare.
Ingen positionFör att få en position behövs en molntjänst som stöder Wi-Fi-positionering, till exempel Yggio, och tillräckligt många kända 2,4 GHz-accesspunkter inom räckhåll. Se Så fungerar Wi-Fi-positionering.

8Teknisk referens

För integratörer. Värdena nedan gäller applikationen Puck-radar November 2026. Andra versioner kan skilja sig. Kontrollera vad som gäller för din version i dokumentationen för VSM-applikationer eller i VSM Configuration Tool.

Vilken applikation sensorn kör

Direkt efter anslutningen skickar Puck sin applikationsidentitet, rulesCrc32, på port 15. Avkodaren använder den för att välja rätt översättning, och du behöver den för att skapa rätt nedlänkar. För den här applikationen gäller:

ApplikationPuck-radar
VersionNovember 2026
rulesCrc32961870689 (hex 3954FB61)
Tidigare versionPuck-radar R31–R33, rulesCrc32 1946060128 – se revision A av den här manualen

Om du har missat meddelandet skickar du 00 på port 15, så skickar Puck sin identitet igen. NFC-appen Hugin visar också applikationen och dess version på plats.

Inställningar, id:n och standardvärden hör till en viss applikationsversion. Om din Puck rapporterar en annan rulesCrc32 ska du slå upp det numret i dokumentationen för VSM-applikationer eller i VSM Configuration Tool i stället för att använda tabellerna här. Puck-sensorer som levererades före novemberversionen 2026 kör Puck-radar R31–R33. Den versionen har andra id:n och standardvärden, så använd revision A av den här manualen för de sensorerna tills de har uppdaterats.

Alternativa applikationer: utöver Puck-radar kan Sensative erbjuda andra VSM-applikationer för LoRaWAN-kortet i Puck. De finns i NFC-appen Hugin (Android) och kan också laddas via LoRaWAN. Fråga Sensative vilka applikationer som passar för ditt användningsområde.

LoRaWAN och portar

LoRaWANMAC 1.0.4, regionala parametrar RP002-1.0.3, klass A, OTAA, max EIRP 14 dBm
JoinEUI70B3D52C0001D4C3 (alla sensorer av typerna Puck och Square)
PortRiktningInnehåll
1UpplänkMätvärden och larm (se Meddelanden)
11UpplänkSamma utdata i komprimerad form
12UpplänkLoggade data, det vill säga meddelanden som lagrats medan Puck saknade nätverk och skickas senare med tidpunkten för mätningen
15UpplänkApplikationsidentitet (rulesCrc32), det första som skickas efter en anslutning
15Nedlänk00 ber Puck skicka sin applikationsidentitet igen
23UpplänkWi-Fi-skanning för positionering
2NedlänkApplikationsinställningar och läsbegäranden (se Inställningar på port 2)
2UpplänkPucks svar med de värden den nu har
7NedlänkEn hel konfiguration i en enda payload, även radarkommandon (se En hel konfiguration på port 7)
7UpplänkStatus för konfigurationen: None, Applied, Error eller Dirty
48NedlänkEtt radarkommando i textform (se Radarkommandon)
32UpplänkRadarkortets svar i textform

Meddelanden

Varje utdata har ett id och en skala. Utdata som är markerade som bekräftade kvitteras av nätverksservern.

UtdataIdStorlek och skalaEnhetBekräftadSkickas
distance912 byte, × 0,001mJaVid en ändring större än Radar Distance Hysteresis
amplitude902 byteekostyrkaJaVid en ändring större än Radar Amplitude Hysteresis
distance2, amplitude293 922 byte vardera; avstånd × 0,001m, ekostyrkaJaZon 2 i metoden Distance2, tillsammans med zon 1
occupied801 byte1 = upptagen, 0 = ledigJaFrån de metoder som bedömer beläggning, när värdet ändras
distanceAverage942 byte, × 0,001mJaEfter varje Average Distance Interval, om värdet har ändrats
averageDistanceAlarm811 byte0 = inget, 1 = lågt, 2 = högt, 3 = bådaJaNär larmstatusen ändras
radarDetectionPercentageDay952 byte% av mätningarna med ekoJaEn gång per dygn
radarVoltage_VB42 byte, × 0,001VNejMed de periodiska rapporterna
tempB62 byte, × 0,01°C, inuti höljetNejMed de periodiska rapporterna
humidityB52 byte, × 0,01% RF, inuti höljetNejMed de periodiska rapporterna
humidityAlarm821 byte0 = inget larm, 1 = larmJaNär luftfuktigheten inuti når Humidity Alarm Level och när den åter är 5 % RF under nivån
positionX, positionY, positionZ99 9A 9B4 byte vardera, × 0,001m/s² (tyngdkraften längs varje axel)JaNär Position Check Interval är inställt: referensorienteringen, vid första kontrollen och efter varje flytt
positionMoves9C4 byteantal flyttar sedan startJaMed den nya referensen efter varje flytt
periodicReportsCounterBB4 byteantalNejMed varje periodisk rapport
nfcContactCount984 byteantalJaEfter NFC-kontakt, så att Puck svarar även när radarn är avstängd

Inställningar

Standardvärdena är de värden som Puck startar med. Id:t är det som anges i en nedlänk på port 2. Värdena skickas i de steg som anges. En inställning med steget 0,01 skickas alltså som hundra gånger sitt värde.

InställningNamn i applikationenIdFunktionEnhetIntervallStandard
Radar Distance HysteresisdistanceHysteresisA2Hur mycket avståndet måste ändras innan ett nytt avstånd eller medelvärde skickas.m, steg om 0,010–1,270,10
Radar Amplitude HysteresisamplitudeHysteresisB0Hur mycket ekostyrkan måste ändras innan ett nytt värde skickas.ekostyrka0–32 767250
Average Distance IntervalaverageDistanceIntervalMinutesB1Den period som medelavståndet beräknas över. Larmen följer medelvärdet.minuter2–32 7671 440
Distance Alarm Low LevelaverageDistanceLowAlarmLevelB2Larm när medelavståndet är under den här nivån. 0 = avstängt.m, steg om 0,010–327,670
Distance Alarm High LevelaverageDistanceHighAlarmLevelB3Larm när medelavståndet är över den här nivån.m, steg om 0,010–327,670
Report Failed MeasurementsreportFailedDistanceMeasurementsA30 = en mätning utan eko över tröskelvärdet skickas inte. 1 = mätningen skickas som avstånd 0.på/av0–10
Interval between periodic reportsperiodicReportsIntervalA4Hur ofta batterispänning, temperatur och luftfuktighet skickas.timmar0–2508
Humidity Alarm LevelhumidityAlarmLevelA5Den luftfuktighet inuti höljet som utlöser fuktlarmet. Kontrolleras varje timme. 0 stänger av larmet.% RF0–10060
Position Check IntervalpositionCheckIntervalMinutesBDHur ofta Puck kontrollerar sin orientering för rapporten om rörelse och lutning. 0 stänger av funktionen, och då läses accelerometern inte av och ingenting skickas.minuter0–32 7670 (av)
Position Moved ThresholdpositionMovedThreshold_m_s2BEHur mycket den uppmätta tyngdkraftsvektorn måste avvika från referensen, räknat som längden av skillnaden, för att Puck ska räknas som flyttad. En lutning med en viss vinkel ger avvikelsen 2 g sin(vinkel/2): 0,86 m/s² för 5°, 1,71 för 10°, 3,41 för 20°, 5,08 för 30° och 9,81 för 60°.m/s², steg om 0,0010,3–19,61,71
Temperature CalibrationtemperatureUserCalibrationBCKorrektion som läggs till temperaturen.°C, steg om 0,01−10 till +100
Radar BT Advertise triggerradarBtAdvertiseTriggerA11 får radarkortet att annonsera via Bluetooth, för SweIoT Toolbox.på/av0–10
Time between join retriestimeBetweenJoinAttemtsB8Hur länge Puck väntar mellan anslutningsförsöken när den inte är ansluten.minuter0–32 767300
Time from last RX before unjointimeBeforeUnjoinB9Hur länge Puck kan vara utan kontakt med nätverket innan den ansluter på nytt.timmar0–32 767360
Max time between ReSend triesmaxResendWaitTimeBALängsta väntetid mellan försöken när ett bekräftat meddelande inte kvitteras.sekunder0–5 184 000 (60 dagar)14 400
Roaming Network CountroamNetworkCountA0Antal LoRaWAN-nätverksidentiteter som provas i tur och ordning (se Nätverk).antal1–151

Enhetsregister

De här registren hör till firmware och inte till applikationen, men kan ändras på samma sätt. Låt dem vara som de är om du inte har ett särskilt skäl att ändra dem.

RegisterNamnIdFunktionEnhetIntervallStandard
Downlink TimeoutLINKCHECK_TIMED0Hur länge Puck kan vara utan att höra något från nätverket innan den släpper nätverket och blir oansluten. Varje nedlänk, även en kvittens, startar om tiden. Efter halva tiden skickas alla upplänkar som bekräftade, och efter 80 % skickar Puck också egna länkkontroller. 0 stänger av kontrollen.sekunder300–2 592 00028 800 (8 timmar) i den här applikationen
Device Time Max AgeDEVICE_TIME_MAX_AGECDHur länge Puck litar på sin klocka. När halva tiden har gått frågar Puck LoRaWAN-nätverket efter tiden med standardbegäran DeviceTime (DeviceTimeReq, LoRaWAN 1.0.3 och senare) – först efter en minut och sedan med fördubblade intervall upp till ungefär 68 timmar, tills den får svar. Nätverksservern måste svara på DeviceTime-begäranden. Med 0 stängs funktionen av. Puck har då ingen tid, och mätvärden som tas utan nätverk loggas inte.sekunder0–4 294 967 2952 592 000 (30 dagar)

Lämna nätverket

Om du vill att Puck ska lämna nätverket direkt skriver du 1 (inte ansluten) till registret DEVICE_STATE: skicka C8 00 00 00 01 på port 2 (base64 yAAAAAE=). Sensorn ansluter sedan igen på samma sätt som när den har tappat nätverket (se Nätverk). Värden som mäts medan den inte är ansluten sparas och skickas när den har anslutit igen.

Puck kvitterar inte den här nedlänken, inte ens om den skickas som bekräftad, så den startar ingen loop av omsändningar. Skicka den ändå obekräftad.

Publicerade profiler

Det finns inga publicerade profiler för den här applikationen. Puck startar med standardvärdena i inställningstabellen. Om du vill ändra dem använder du Custom i VSM Configuration Tool.

Inställningar på port 2

En nedlänk på port 2 är en lista med poster på 5 byte vardera: en byte för inställningens id och sedan värdet som ett 32-bitars heltal med tecken, mest signifikanta byte först. Värdet anges i inställningens egna steg. En Radar Distance Hysteresis på 0,05 m med steget 0,01 skickas alltså som 5. Puck tillämpar värdena och svarar på port 2 med de värden den nu har.

Id:na hör till en viss applikationsversion. En annan version kan använda samma id för en annan inställning, och en nedlänk som är skapad för en version kan därför ändra fel inställning i en annan. Skapa alltid nedlänken för den rulesCrc32 som Puck själv rapporterar.

Läsa av värden

En nedlänk på port 2 med en till fyra byte är en läsbegäran. Puck skickar då tillbaka det aktuella värdet för varje id i nedlänken.

Nedlänk på port 2Puck svarar med
04Aktuell temperatur i hundradels grader
05Aktuell luftfuktighet i hundradels procent
A2Det inställda värdet för Radar Distance Hysteresis (alla inställnings-id:n fungerar på samma sätt)

En hel konfiguration på port 7

VSM Configuration Tool kan också packa en hel konfiguration i en enda payload för port 7. Den börjar med applikationens CRC och slutar med en kontrollsumma för konfigurationen (configCrc32). Sensorn rapporterar resultatet på port 7: None, Applied, Error eller Dirty.

Radarkommandon

Radarkortet tar emot korta textkommandon. Skicka varje kommando som en nedlänk på port 48 i ASCII. VSM Configuration Tool skapar dem åt dig utifrån fältet Radar Module Commands. Radarkortet svarar på port 32 i textform. Ett svar som börjar med = betyder att kommandot godtogs, och * betyder att något gick fel. Ungefär en timme efter en ändring (60 minuter som standard) skickar radarkortet också de inställningar som det nu använder, så att du kan kontrollera dem.

KommandoFunktion
sys?Läser systeminställningarna
sys:3Väljer metod 3 (Well). Den första systeminställningen är metoden
3?Läser inställningarna för metod 3 (fungerar för alla metoder)
3:600Sätter den första inställningen för metod 3, mätintervallet, till 600 s
4:600,,0.15,1.2Ställer in flera inställningar för metod 4 samtidigt, efter position. En tom position behåller den inställningen, och inställningarna efter den sista angivna lämnas oförändrade
measureMäter en gång, direkt
test:10Testläge: mäter var 10:e sekund i 10 minuter och återgår sedan till normal drift. Praktiskt vid installation
meth_cmd:2,0.5,2.5,40Metod 7 och 8: skanning från 0,5 till 2,5 m i 40 avsnitt (se Ny tillämpning)
versionLäser radarns firmwareversion
restartStartar om radarkortet
factoryÅterställer alla radarinställningar, både system och metoder, till fabriksinställningarna

Radarinställningar per position

Inställningarna för varje metod är en sträng med kommaseparerade värden i en fast ordning. Här är de inställningar som användare normalt ändrar, med standardvärden:

MetodPosition: inställning (standard)
3 Well1: intervall, s (300) · 2: HWAAS, 1–63 (20) · 3: mätområdets start, m (0,500) · 4: mätområdets längd, m (3,000) · 5: svep per mätning (3) · 10: adaptivt mätområde, m, 0 = av (0) · 11: median, 1 = på (1) · 12: tröskelvärde (200) · 13: paus mellan svep, ms (1 000) · 14: radarprofil, 1–5 (2)
4 Bin1: intervall, s (120) · 2: HWAAS (20) · 3: mätområdets start, m (0,150) · 4: mätområdets längd, m (1,000) · 5: tröskelvärde (290) · 6: korrektion som läggs till avståndet, mm (0)
5 Parking1: intervall, s (30) · 2: HWAAS (10) · 3: mätområdets start, m (0,200) · 4: mätområdets längd, m (1,500)
6 Seating1: intervall, s (60) · 2: HWAAS (30) · 3: mätområdets start, m (0,240) · 4: mätområdets längd, m (1,000) · 5: tröskelvärde (200) · 6: korrektion, mm (0) · 7: antal mätningar i rad för byte till upptagen (3) · 8: och till ledig (3)
8 Distance2Två zoner med eget tröskelvärde och eget val av eko, och upp till två uteslutningszoner (position 7–22, se exemplet ovan)

Kommandot 3:,,,,,,,,,,,150 sänker till exempel tröskelvärdet för metoden Well till 150 och lämnar resten oförändrat.

Systeminställningarna är också en sträng. Position 1 är metoden. Position 8, send only changes (0 = av), gör att Puck bara skickar resultat som har ändrats, till exempel när en bil kommer till eller lämnar en parkeringsplats: sys:,,,,,,,1. Låt övriga systeminställningar vara som vid leverans. Ändra framför allt aldrig transportinställningen (position 7), eftersom den kan koppla bort radarkortet från LoRaWAN.

  • HWAAS: antal sampel som radarchippet tar medelvärdet av för varje punkt. Fler sampel minskar bruset men kostar tid och batteri.
  • Radarprofil: en högre profil ger starkare signal på långa avstånd, till exempel i djupa brunnar, men sämre avståndsupplösning.

Exempel 1: dagvattenbrunn med vattennivå var 10:e minut och översvämningslarm

Välj metoden Well och mät var 10:e minut. Beräkna medelvärdet över 30 minuter i stället för 24 timmar, och ge larm när vattnet kommer närmare Puck än 1 m. Exemplen är uppbyggda enligt postformatet i Inställningar på port 2 och radarkommandona för rulesCrc32 961870689 och kontrollerade med VSM-översättaren (öppen källkod). Payloaden för port 7 innehåller applikationsidentiteten och kontrollsumman, precis som när VSM Configuration Tool skapar den. Skicka antingen nedlänkarna i tur och ordning eller den enda payloaden för port 7, men inte båda.

InställningVärdeSkickas somPost
Radar Module Commandssys:3;3:600två radarkommandonsys:3 och 3:600 på port 48
Average Distance Interval30 min30B1 00 00 00 1E
Distance Alarm Low Level1,00 m100B2 00 00 00 64
PortNedlänk (hex)Base64
2B1 00 00 00 1E B2 00 00 00 64sQAAAB6yAAAAZA==
4873 79 73 3A 33c3lzOjM=
4833 3A 36 30 30Mzo2MDA=
Eller 739 54 FB 61 02 0A B1 00 00 00 1E B2 00 00 00 64 30 05 73 79 73 3A 33 30 05 33 3A 36 30 30 00 4C 5F C1 59

Exempel 2: avfallskärl, 1,2 m djupt, kontroll var 10:e minut

Välj metoden Bin och mät var 10:e minut inom ett mätområde från 0,15 m till 1,35 m. Skicka ett nytt avstånd varje gång avståndet har ändrats 5 cm.

InställningVärdeSkickas somPost
Radar Module Commandssys:4;4:600,,0.15,1.2två radarkommandonsys:4 och 4:600,,0.15,1.2 på port 48
Radar Distance Hysteresis0,05 m5A2 00 00 00 05
PortNedlänk (hex)Base64
2A2 00 00 00 05ogAAAAU=
4873 79 73 3A 34c3lzOjQ=
4834 3A 36 30 30 2C 2C 30 2E 31 35 2C 31 2E 32NDo2MDAsLDAuMTUsMS4y
Eller 739 54 FB 61 02 05 A2 00 00 00 05 30 05 73 79 73 3A 34 30 0F 34 3A 36 30 30 2C 2C 30 2E 31 35 2C 31 2E 32 00 87 9D 91 68

Exempel 3: tidigare varning för silikagelen och lutningskontroll varje timme

Skicka fuktlarmet redan vid 50 % RF inuti höljet och kontrollera en gång i timmen om Puck har flyttats eller vridits.

InställningVärdeSkickas somPost
Humidity Alarm Level50 % RF50A5 00 00 00 32
Position Check Interval60 min60BD 00 00 00 3C
PortNedlänk (hex)Base64
2A5 00 00 00 32 BD 00 00 00 3CpQAAADK9AAAAPA==
Eller 739 54 FB 61 02 0A A5 00 00 00 32 BD 00 00 00 3C 00 FE 13 F4 A2

9Specifikationer

RadarPulsad koherent 60 GHz-radar (Acconeer A111)
Mätområde0,2–7 m, 1 mm upplösning och noggrannhet. Avståndet mäts från radarns referenspunkt inne i höljet, 11 mm (standardlins) eller 26 mm (smal lins) innanför linsytan
StråleStandardlins ungefär ±60°, smal lins ungefär ±10°
RadarmetoderWell, Bin, Parking, Seating, Adv_Seating, Distance2 (radarfirmware 2.24)
Övriga sensorerTemperatur (typiskt ±2 °C vid 0–30 °C) och luftfuktighet inuti höljet, med fuktlarm för silikagelen; 3D-accelerometer för rörelse och lutning
PositioneringWi-Fi-skanning en gång per dygn; kräver en molntjänst som stöder Wi-Fi-positionering
MinneInbyggd datalogg som laddas upp via LoRaWAN när Puck ansluter
RadioLoRaWAN 1.0.4, klass A, OTAA; JoinEUI 70B3D52C0001D4C3
FrekvensplanEU868
Räckvidd (radio)Upp till 10 km vid fri sikt
KonfigurationBåda korten via LoRaWAN; på plats med Hugin (NFC, Android) och SweIoT Toolbox (Bluetooth, Android)
UppdateringarLoRaWAN-kortet: firmware och VSM-applikation med Hugin, VSM-applikationer även via LoRaWAN. Radarkortet: firmware bara via Bluetooth, med SweIoT Toolbox
ApplikationVSM-applikationen Puck-radar (November 2026)
BatteriUtbytbart LiSOCl₂-batteri, 3,6 V, 2 100 mAh; väl över tio år beroende på metod och mätintervall
KapslingsklassIP67, tätad med O-ring
Drifttemperatur−30 till +80 °C
Förvaringstemperatur+10 till +30 °C
MåttØ 45 × 30 mm (standardlins) eller Ø 45 × 45 mm (smal lins)
Vikt38 g (standardlins) · 43 g (smal lins), inklusive batteri
MonteringTejp medföljer; monteringsplattor säljs separat; borrat hål, konsol eller band

10Support

Källor: Sensative Docs, Puck Radar (läst 31 oktober 2026); PUCK Radar Sensor User Manual, radarfirmware 2.24; produktbladet för Puck Radar, Rev B; applikationens källkod och dokumentation i Sensatives repository vsm-applications (Puck-radar, 10 november 2026) och produktdefinitionerna i dots-builds; VSM Configuration Tool och dokumentationen för VSM-applikationer på GitHub för den tidigare versionen; VSM-översättaren (öppen källkod); specifikationer från produktdata på sensative.com; Wi-Fi-positionering: Semtech, Wi-Fi geolocation with LoRa Edge.