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

Square Tracker Xtreme för LoRaWAN

Den robusta trackern för inomhus- och utomhusbruk. Den positionerar med Wi-Fi och GNSS och sitter i ett hölje med IP68, IK06 och skruvram. Manualen beskriver allt från uppackning till driftsättning och avslutas med en teknisk referens.

Revision B · november 2026 · Sensative AB

Snabbstart Produktsida Produktblad (PDF)

1Inledning

Square Tracker Xtreme håller reda på var utrustning och andra föremål befinner sig, både inomhus och utomhus. Utomhus använder sensorn GNSS (GPS och BeiDou), och inomhus skannar den efter Wi-Fi-accesspunkter i närheten. Skanningen sker när föremålet börjar eller slutar röra sig och med inställda intervall, och en molntjänst räknar sedan fram positioner ur skanningarna. Accelerometern känner av rörelse, och sensorn ger dessutom en fingervisning om temperaturen. Det täta, grå höljet har kapslingsklass IP68 och slagtålighetsklass IK06 och mäter 67,2 × 60,4 × 13 mm. Kretskortet är skyddslackat, så sensorn klarar väta, damm och hårda tag.

Batteriet är inbyggt (4 000 mAh) och räcker i tio år vid 72 positioner per dygn.

Sensorn fungerar med alla LoRaWAN-nätverksservrar (LoRaWAN 1.0.4, klass A, OTAA) och har en räckvidd på upp till 10 km vid fri sikt. Vad den mäter, när den rapporterar och vad den skickar styrs av en applikation som körs i sensorn, på Sensatives Virtual Sensing Machine (VSM). Den här manualen beskriver applikationen Tracker-GNSS November 2026. Applikationen kan konfigureras och bytas mot en nyare version, både trådlöst och via NFC. Sensative kan också erbjuda andra VSM-applikationer som ger samma sensor en annan uppgift. Se Vilken applikation sensorn kör.

Förpackningens innehåll

  • Square Tracker Xtreme, med tejpen redan på baksidan
  • Monteringsramen för skruvmontering

Nycklarna (DevEUI och AppKey) finns i leveransinformationen. Skruvar och buntband ingår inte.

Sensorns delar

Square Tracker Xtreme, en tät sensor med grått, fyrkantigt hölje
Ett tätt, grått hölje utan hål, med öglor upptill och nedtill för buntband. NFC-fältet sitter nere till vänster på framsidan. Där håller du telefonen. På baksidan sitter tejpen och etiketten med modell, region och serienummer.

2Innan du börjar

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

Sensorn skickar via radio till en gateway, gatewayen vidare till nätverksservern och nätverksservern till din applikation. Inställningar går tillbaka som nedlänk.

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, alltså dess DevEUI och AppKey från leveransinformationen. JoinEUI är densamma för alla Square-sensorer: 70B3D52C0001D4C3.
  • En telefon med NFC för att starta sensorn. De flesta mobiltelefoner har NFC. En iPhone behöver en app för NFC-läsning (se Hitta NFC-antennerna).
  • En payload-avkodare för Sensatives VSM-sensorer i nätverksservern eller applikationen (se Avkoda meddelandena)
  • En molntjänst med stöd för GNSS- och Wi-Fi-positionering, till exempel Yggio. Utan en sådan tjänst kommer skanningarna fram men ger ingen position (se GNSS-positionering och Så fungerar Wi-Fi-positionering).

Välja placering

  • På föremålet: fäst sensorn så att den följer med när föremålet flyttas
  • Fri sikt för GNSS: utomhus behöver GNSS fri sikt mot himlen. Montera sensorn med framsidan, ovansidan eller högra sidan mot himlen och utan något som skymmer ovanför, eftersom ett tak, ett skydd eller själva föremålet blockerar signalen. GNSS fungerar inte inomhus eller under skyddande tak
  • Wi-Fi inomhus: inomhus beräknas positionen utifrån de Wi-Fi-accesspunkter på 2,4 GHz som finns runt sensorn (se Så fungerar Wi-Fi-positionering)
  • Utomhus och i fordon: höljet har kapslingsklass IP68 och slagtålighetsklass IK06 och tål regn, damm och stötar
  • Räckvidd: upp till 10 km vid fri sikt, betydligt kortare genom väggar och bjälklag

Hitta NFC-antennerna

NFC har bara ett par centimeters räckvidd, så lägg telefonen plant mot sensorn med antennerna mot varandra. Du behöver veta var båda antennerna sitter. Enklast hittar du rätt läge genom att långsamt föra telefonen över området där antennen sitter tills telefonen signalerar kontakt:

NFC-antennen sitter nere till vänster på sensorns framsida. I telefonen sitter den ofta upptill på baksidan
  • På sensorn: nere till vänster på framsidan, med logotypen längs nederkanten.
  • På en Android-telefon (förstahandsvalet): slå på NFC och aktivera vibration eller ljud för NFC i telefonens inställningar, så att telefonen säger till så fort 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. Hittar du den inte kan du föra telefonens baksida långsamt över sensorns nedre vänstra hörn tills telefonen vibrerar.
  • Ta av telefonskalet: ett skyddsskal kan försvåra NFC-kontakten, särskilt om det är tjockt eller innehåller metall eller en magnet. Ta av skalet medan du arbetar med sensorn.
  • Håll sedan telefonen stilla: för att starta en anslutning håller du telefonen stilla över sensorn i ungefär 5 sekunder. Vibrationen betyder bara att telefonen har hittat sensorn. Låt telefonen ligga kvar tills sensorn och appen har kommunicerat klart. Med appen Hugin tar det några sekunder, eftersom appen först låser upp sensorn via Sensatives server. Flyttar du 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å dess NFC-knapp så att den visar Ready to Scan innan du håller telefonen mot sensorn. iPhonens antenn sitter vid överkanten på baksidan. Lägg den kanten mot sensorns nedre vänstra hörn och håll telefonen stilla. När läsningen lyckas öppnas en webblänk med sensorns serienummer. Guiden för NFC-anslutning med iPhone (PDF) visar varje steg med bilder.

3Installation steg för steg

Installationen har 8 steg. Registrera sensorn i nätverksservern innan du håller telefonen mot den. Anslut den sedan till nätverket, kontrollera inställningarna och montera den sist.

1

Packa upp

Kontrollera sensorn och ta fram nycklarna. Sensorn är vilande 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

Håll telefonen över nedre vänstra hörnet på framsidan av Square Tracker Xtreme och håll den stilla i ungefär 5 sekunder. Då startar anslutningen (se Hitta NFC-antennerna, som också beskriver iPhone). Telefonen kan visa en webblänk med sensorns serienummer, men den behöver du inte öppna.

Registrera sensorn och håll en telefon med NFC över nedre vänstra hörnet. Sensorn ansluter inom ungefär två minuter
Klart när: anslutningen syns i nätverksservern, oftast inom två minuter.
Om nätverket ännu inte går att nå gör sensorn ett nytt försök en gång per dygn. Det kan alltså dröja upp till 24 timmar från att nätverket har blivit tillgängligt tills sensorn ansluter. Håller du telefonen mot sensorn igen gör den ett nytt försök direkt.
4

Kontrollera signalen på monteringsplatsen

Placera sensorn där den ska monteras och följ meddelandena från den 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. Då finns det marginal till gränsen för SF9 (ungefär −12,5 dB SNR).
Med en svagare länk tvingar nätverksserverns adaptiva datahastighet (ADR) ned sensorn till SF10–SF12. Varje meddelande tar då 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 du förbättra länken genom att flytta gatewayen eller sensorn, eller sätta upp ytterligare en gateway.
5

Konfigurera (valfritt)

Square Tracker Xtreme levereras med applikationen Tracker-GNSS. Med standardinställningarna kör sensorn en skanningsserie varje gång den börjar eller slutar röra sig, och en gång per dygn när den står stilla. Serien börjar med Wi-Fi, och om Wi-Fi hittar för få accesspunkter görs en GNSS-skanning som sista steg. GNSS Mode, rörelseräkning och rörelsetid är avstängda, liksom de valfria funktionerna (lutningsrapport och skanning först efter stopp). Anpassa inställningarna efter hur ofta och var du behöver positioner, eftersom varje skanning kostar batteri.

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

6

Montera

Välj ett av sätten nedan eller kombinera dem:

  1. Skruvar med den medföljande monteringsramen: fäst ramen med M4-skruvar (ingår inte).
  2. Tejp: tejpen sitter redan på baksidan. Rengör ytan med en blandning av isopropylalkohol och vatten (50:50) så att den är fri från smuts och fett, och låt den torka. Dra av skyddsfilmen från tejpen och tryck fast sensorn ordentligt.
  3. Buntband genom öglorna. Du kan kombinera buntband med tejp för extra fäste.
Square Tracker Xtreme i monteringsramen, fastskruvad med två skruvar
Fastsatt med monteringsramen och två M4-skruvar.
Se till att framsidan går att nå med en telefon (NFC) och att sikten mot himlen är fri utomhus.
7

Testa

Flytta föremålet, eller bara sensorn, och låt det sedan stå stilla. För GNSS gör du testet utomhus under bar himmel.

Klart när: skanningar kommer in efter att rörelsen har börjat och igen efter att den har upphört, och molntjänsten (till exempel Yggio) räknar fram en position ur dem (se GNSS-positionering).
8

Driftklar

  • Registrerad i nätverksservern med JoinEUI och rätt region
  • Ansluten med NFC, och meddelandena avkodas
  • Signalen kontrollerad på den slutliga platsen: SF9 eller bättre
  • Kopplad till en molntjänst med stöd för GNSS- och Wi-Fi-positionering, till exempel Yggio
  • Inställningarna kontrollerade eller ändrade efter behov
  • Monterad på föremålet så att framsidan går att nå och, utomhus, med fri sikt mot himlen
  • Positioner kommer in när föremålet flyttas

4Använda sensorn

Inställningar som står i fetstil hittar du i inställningstabellen.

Så fungerar Wi-Fi-positionering

  • Bara 2,4 GHz: radion söker bara i 2,4 GHz-bandet (2412–2484 MHz). Nätverk som enbart sänder på 5 GHz syns inte.
  • Passiv: 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ätverk, behöver inget lösenord och sänder ingenting via Wi-Fi. Adresserna skickas med LoRaWAN-upplänken.
  • Antal: det krävs minst 2 accesspunkter för en position, och fler ger bättre noggrannhet.
  • Molntjänst krävs: för att du ska få någon position alls måste sensorn vara kopplad till en molntjänst med stöd för GNSS- och Wi-Fi-positionering, till exempel Yggio. Tjänsten slår upp adresserna i en databas över kartlagda accesspunkter och skickar tillbaka positionen. Munin och LoRa Cloud klarar också detta.
  • Noggrannhet: beror på hur många kända accesspunkter som finns i närheten, normalt 5–20 m inomhus. Med bara en eller två accesspunkter får du snarare området än rummet. Fler billiga 2,4 GHz-accesspunkter ger bättre noggrannhet.

När sensorn skannar: skanningsserien

Varje gång sensorn börjar röra sig, och varje gång den stannar, startar den en skanningsserie. Det är en följd av skanningar som avbryts så snart en av dem hittar tillräckligt många accesspunkter (Minimum Wifi Count, som standard 3).

  1. Efter 1 minut görs en begränsad Wi-Fi-skanning på kanalerna i Limited Wifi Scan Channel Mask (som standard alla kanaler).
  2. Vid Still Wifi Scan Again At Minute (som standard minut 2) görs en andra begränsad Wi-Fi-skanning.
  3. Vid Full Wifi Scan At Minute görs en fullständig Wi-Fi-skanning på kanalerna i Full Wifi Scan Channel Mask (som standard alla kanaler).
  4. Vid GNSS Scan At Minute (som standard minut 60) görs en GNSS-skanning. Därefter avslutas skanningsserien.
  • Periodiska skanningar: skanningsserien startar också om med intervallet Stationary Scan Interval när sensorn står stilla (som standard 1 440 minuter, alltså en gång per dygn) och med Moving Scan Interval när den rör sig (som standard avstängt). Ställ inte in ett intervall som är kortare än själva skanningsserien.
  • Skanningsbudget: varje skanning förbrukar en enhet ur en budget. Var 15:e minut fylls budgeten på med 15 Minute Scan Budget (som standard 3), upp till Max Scan Budget (som standard 100). Tar budgeten slut under en skanningsserie väntar de återstående skanningarna tills den har fyllts på.
  • Position på begäran med NFC: håll en telefon mot en sensor som redan är ansluten, på samma sätt som vid anslutningen. Sensorn startar då genast en skanningsserie, och resultatet kommer som en ny upplänk med skanningen, som molntjänsten räknar om till en position. På så sätt får du en position när du behöver den.

Valfria funktioner: Tracker Options

Två funktioner är avstängda som standard. Du slår på dem med inställningen Tracker Options, där varje funktion har en egen bit. Lägg ihop värdena för att kombinera dem.

  • 1, lutningsrapport: varje gång sensorn har stannat efter en rörelse kontrollerar den sin orientering utifrån accelerometerns värde i vila, det vill säga tyngdkraften. Den första kontrollen fastställer referensen, som skickas som X, Y och Z. Om en senare kontroll visar att sensorn har lutats eller vridits mer än Position Moved Threshold (som standard 1,71 m/s², ungefär 10°) skickar sensorn den nya referensen och räknar upp antalet förflyttningar. Så länge orienteringen är oförändrad skickas ingenting, och en förflyttning som inte ändrar orienteringen märks inte. Vid en omstart går referensen förlorad och en ny skickas. Kontrollen använder det värde som accelerometern ändå läser av när sensorn stannar, så den kräver ingen extra mätning.
  • 4, skanning först efter stopp: skanningsserien startar bara när sensorn har slutat röra sig, inte när den börjar. Du får alltså en position där föremålet blev stående. Medan sensorn rör sig görs inga skanningar, inte ens med Moving Scan Interval.

Square Tracker Xtreme har ingen barometer och kan därför inte skicka lufttrycket, så låt bit 2 vara avstängd. Lufttryck för våningsbestämning finns bara i Square Tracker och Tracker L.

GNSS-positionering

  • Standard, Wi-Fi först: med standardinställningarna (GNSS Mode 0) bestämmer sensorn sin position med Wi-Fi och använder GNSS (GPS och BeiDou) bara som sista steg i skanningsserien, när Wi-Fi-skanningarna har hittat för få accesspunkter. Wi-Fi drar mindre ström och fungerar både inomhus och i bebyggda områden.
  • GNSS Mode: när GNSS Mode är påslaget börjar skanningsserien med en GNSS-skanning efter 1 minut. Hittar den minst så många satelliter som anges i Minimum Satellite Count (som standard 3) skickas resultatet och serien avslutas. Annars följer en Wi-Fi-skanning som reserv vid Fallback WIFI Scan At Minute (som standard avstängd), och därefter avslutas serien.
  • Vilket läge du ska välja: för föremål som för det mesta befinner sig utomhus slår du på GNSS Mode (GNSS först, med Wi-Fi som reserv). För föremål som för det mesta är inomhus behåller du standardinställningen med Wi-Fi-skanningsserien. Exempel 1 visar hur du ställer om.
  • Fri sikt mot himlen: GNSS behöver fri sikt mot himlen och fungerar inte inomhus eller under skyddande tak (se Välja placering).
  • Assisterade skanningar: sensorn registrerar satellitsignalerna och skickar dem vidare, och molntjänsten räknar fram positionen. Därför tar en skanning 3–4 sekunder i stället för ungefär 30. För att de assisterade skanningarna ska bli bra behöver sensorn rätt tid, med högst ungefär 30 sekunders avvikelse, och en aktuell almanacka (satelliternas bandata).
  • Tid och almanacka: sensorn frågar nätverket efter tiden innan tiden i Device Time Max Age har gått ut (se Enhetsregister). Får den ingen ny tid före dess blir GNSS-skanningarna autonoma. Applikationsdokumentationen rekommenderar att du kör Munin i backend för att hålla klockan synkroniserad och almanackan aktuell (se Avkoda meddelandena).

Rörelse och rörelsetid

  • Rörelsedetektering: accelerometern känner av när sensorn rör sig. Still Threshold anger hur kraftig en rörelse måste vara för att räknas som rörelse när sensorn står stilla, och Moving Threshold gör detsamma när den rör sig. Är värdena för lågt satta tror sensorn att den hela tiden rör sig, och då startar den ingen skanningsserie när den stannar. Börja med höga värden och sänk dem om sensorn inte är tillräckligt känslig.
  • Rörelseräkning: avstängd som standard. När funktionen är påslagen skickar sensorn antalet rörelser som den har upptäckt sedan start, en gång i timmen om antalet har ändrats.
  • Rörelsetid: avstängd som standard. När funktionen är påslagen skickar sensorn det sammanlagda antalet minuter med rörelse sedan start, en gång i timmen om värdet har ändrats.

Temperatur

Temperaturen mäts inuti sensorn var 15:e minut med en typisk noggrannhet på ±2 °C. Värdet ger en fingervisning om förhållandena kring föremålet, men är ingen exakt rumstemperatur.

  • När temperaturen har ändrats mer än Temperature Hysteresis (som standard 2 °C) sedan det senast skickade värdet skickar sensorn det nya värdet.
  • Med intervallet Average Temp Interval (som standard 2 timmar) skickar sensorn medeltemperaturen, om den har ändrats mer än samma hysteres.
  • Över Temperature Alarm High Level (60 °C) blir larmläget ”högt”, och under Temperature Alarm Low Level (2 °C) blir det ”lågt”. Larmet skickas som bekräftat meddelande och återställs när temperaturen åter ligger mellan nivåerna.

Batteri

En gång i veckan uppskattar sensorn hur mycket batteri som återstår och skickar värdet i procent som bekräftat meddelande. Uppskattningen bygger på den uppmätta drifttiden och den energi som processorn, radion, givarna och positionsskanningarna har förbrukat.

Loggade data

Mätvärden som sensorn tar när den saknar nätverk sparas i minnet och skickas via LoRaWAN när den är ansluten igen, vart och ett med tidpunkten då det registrerades. För bekräftade utdata sparas hela historiken tills minnet är fullt, för obekräftade bara det senaste värdet. NFC-appen Hugin kan inte läsa ut loggen. Tiderna kommer från sensorns klocka, som ställs efter nätverket. Sensorn frågar efter tiden innan Device Time Max Age har löpt ut (som standard 7 dagar, se Enhetsregister). Har sensorn ingen tid loggas ingenting.

Nätverk och roaming

  • Bekräftade meddelanden: nätverksservern kvitterar temperaturlarmet, lutningsrapporten och batterinivån. Kommer ingen kvittens skickar sensorn meddelandet igen.
  • Återanslutning: om sensorn inte är ansluten försöker den ansluta en gång var 24:e timme. Om den har varit ansluten men tappat nätverket gör den först snabba anslutningsförsök, en gång i timmen och 15 minuter efter att den har slutat röra sig, högst så många som anges i Quick Rejoin Budget (som standard 10). Håller du telefonen mot sensorn som i steg 3 gör den ett nytt försök direkt.
  • Förlorat nätverk: sensorn lämnar nätverket om den inte har hört något från det under den tid som anges i Downlink Timeout (som standard 8 timmar i den här applikationen, se Enhetsregister).
  • Roaming: sensorn kan registreras i upp till 15 LoRaWAN-nätverk i prioritetsordning. Registrera den i varje nätverk med samma DevEUI och JoinEUI, men räkna upp sista siffran i AppKey: …00 för det första nätverket, …01 för det andra och så vidare. Ställ sedan in Roaming Network Count. Om sensorn tappar sitt nätverk provar den nästa i tur och ordning. Var 24:e timme börjar den om med det första. Med fler än ett nätverk tar varje anslutning längre tid och drar mer energi.
  • Adaptiv datahastighet: sensorn följer nätverksserverns adaptiva datahastighet (ADR), som bestämmer sensorns datahastighet och sändeffekt. Om sensorn tappar kontakten med nätverket sänker den snabbt själv sin datahastighet tills den når nätverket igen, eftersom en sensor som har flyttats kan behöva den längre räckvidden direkt.

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å vilken applikationsversion varje sensor har.
  • 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 den finns som Node-paket. Den kräver två saker av dig: att den kan spara åtminstone rulesCrc32 för varje sensor mellan meddelandena, och att du håller den uppdaterad, eftersom nya applikationsversioner släpps utan förvarning. Om du också sparar hela resultatet av föregående meddelande får loggade data rätt tidpunkt.

Wi-Fi-skanningar kommer på port 23 eller 24 och GNSS-skanningar på port 21 (med metadata på port 22). Avkodaren hanterar alla dessa portar.

Ändra inställningarna

Det finns två sätt: trådlöst med nedlänkar från nätverksservern, eller på plats med NFC-appen Hugin. I båda fallen börjar du oftast i VSM Configuration Tool, som skapar nedlänkarna åt dig.

  1. Välj applikation: efter namn och version, eller efter den rulesCrc32 som sensorn skickar på port 15 (se Vilken applikation sensorn kör).
  2. Välj konfiguration: en publicerad profil ur Profile Library (för den här applikationen finns inga, se Publicerade profiler), eller Custom om du vill ange egna värden. För varje inställning visas beskrivning, enhet och värdeområde.
  3. Hämta resultatet: en eller flera nedlänkar för port 2, eller en enda payload för port 7, i hex eller base64, som du skickar från nätverksservern. Du kan också få en QR-kod som du skannar med NFC-appen Hugin, som sedan skriver konfigurationen till sensorn på plats.
Sensorn är en klass A-enhet och tar emot en nedlänk direkt efter sin nästa upplänk. En ny inställning börjar alltså gälla tidigast efter sensorns nästa meddelande, och i ett hårt belastat nätverk kan det dröja längre innan nedlänken kommer fram. Alla inställningar som får sensorn att sända oftare kostar batteri.

5NFC-appen Hugin

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, eftersom 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, tillståndet (till exempel ansluten), information om batteri, länk och region samt DevEUI. Beroende på dina behörigheter i Yggio kan appen läsa och tillämpa konfigurationsprofiler, även en profil som du har skannat 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.

6Underhåll och demontering

Batteri

Batteriet är inbyggt (4 000 mAh) och räcker i tio år vid 72 positioner per dygn i ett bra nätverk (SF7–SF9). Täta rapporter och en svag länk förkortar batteritiden.

Demontera Square Tracker Xtreme

Dra tandtråd bakom sensorn och såga försiktigt igenom tejpen.

Byta nätverksserver

Ta bort enheten från den gamla nätverksservern och lägg till den i den nya. Sensorns länkkontroll misslyckas då, och sensorn lämnar det gamla nätverket och ansluter till det nya. Det tar oftast ett till två dygn. Med appen Hugin kan du i stället starta om sensorn direkt (ON / OFF), men då återställs också alla egna inställningar.

Förvaring och kassering

  • Förvara oanvända sensorer vid +10 till +30 °C.
  • Sensorn innehåller ett litium-mangandioxidbatteri (LiMnO₂) som inte går att byta. Det är en av de stabilaste litiumkemierna. Öppna inte sensorn, stick inte hål på den och värm den inte över +80 °C.
  • När batteriet är slut lämnar du hela sensorn till batteriåtervinning. Mot slutet av livslängden brukar batteriet svälla något. Det är normalt.

7Felsökning

ProblemÅtgärd
Ingen GNSS-position utomhusGNSS kräver fri sikt mot himlen. Kontrollera att ingenting täcker sensorn och att framsidan, ovansidan eller högra sidan är vänd mot himlen. Håll tiden och almanackan aktuella (se GNSS-positionering).
Ingen skanning när föremålet stannarStill Threshold eller Moving Threshold är för lågt inställd, så sensorn tror att den fortfarande rör sig (se Rörelse och rörelsetid). Höj värdena.
Skanningarna upphör när föremålet flyttas mycketSkanningsbudgeten har tagit slut. De återstående skanningarna görs när budgeten har fyllts på. Höj 15 Minute Scan Budget bara om batteriet tål det.
Ingen eller dålig positionFör att få en position krävs en molntjänst med stöd för GNSS- och Wi-Fi-positionering, till exempel Yggio, och tillräckligt många 2,4 GHz-accesspunkter som tjänsten känner till. Nätverk som bara använder 5 GHz syns inte. Se Så fungerar Wi-Fi-positionering.
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 mot nedre vänstra hörnet och för den långsamt tills den signalerar kontakt. Håll den sedan stilla (se Hitta NFC-antennerna).
Join-förfrågan (Join Request) i nätverksservern, men ingen Join AcceptKontrollera nycklarna, JoinEUI 70B3D52C0001D4C3, LoRaWAN-versionen (1.0.4), de regionala parametrarna (RP002-1.0.3) och frekvensplanen. I US915 och AU915 måste underbandet stämma med gatewayens.
Ingenting alls syns i nätverksservernKontrollera att gatewayen är påslagen och uppkopplad, att sensorn är inom räckhåll och att den inte sitter i ett slutet metallhölje. Starta sedan en ny anslutning med NFC som i steg 3.
”MIC mismatch”Nycklarna är fel. Kontrollera att de hör till just den här sensorn och att de är korrekt inmatade.
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).
Appen Hugin tappar förbindelsenHåll telefonen stilla tills appen är klar (se Hitta NFC-antennerna).
En ny inställning får ingen effektEn nedlänk når sensorn först efter dess nästa meddelande, och i ett hårt belastat nätverk ännu senare (se Ändra inställningarna). Kontrollera att nedlänken fortfarande ligger i kö och att den är skapad för den rulesCrc32 som sensorn rapporterar.
Meddelanden saknas eller kommer oregelbundetKontrollera RSSI och SNR. Sensorn kan sitta för långt från gatewayen eller vara instängd i metall. Vissa kanaler kan också störas av andra sändare i samma frekvensband, till exempel en mobilmast eller en RFID-läsare i närheten.

8Teknisk referens

Det här kapitlet vänder sig till integratörer. Värdena nedan gäller applikationen Tracker-GNSS November 2026. Andra versioner kan skilja sig, så kontrollera din version i dokumentationen för VSM-applikationerna eller i VSM Configuration Tool.

Vilken applikation sensorn kör

Direkt efter anslutningen skickar sensorn 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:

ApplikationTracker-GNSS
VersionNovember 2026
rulesCrc321583824533 (hex 5E673E95)
Tidigare versionTracker R27–R33, rulesCrc32 3802553086, se revision A av den här manualen

Om du har missat meddelandet kan du skicka 00 på port 15, så skickar sensorn sin identitet igen. Du kan också se applikationen och dess version i NFC-appen Hugin, direkt vid sensorn.

Inställningar, id:n och standardvärden hör till en viss applikationsversion. Om sensorn rapporterar en annan rulesCrc32 ska du slå upp det värdet i dokumentationen för VSM-applikationerna eller i VSM Configuration Tool i stället för att använda tabellerna här. Sensorer som levererades före releasen i november 2026 kör Tracker R27–R33, som har andra id:n och standardvärden. Använd revision A av den här manualen för dem tills de har uppdaterats.

Andra applikationer: förutom Tracker-GNSS kan Sensative erbjuda andra VSM-applikationer för samma hårdvara. De finns i NFC-appen Hugin (Android) och kan också laddas in i sensorn via LoRaWAN. Fråga Sensative vilka applikationer som passar för ditt ändamål. Efter ett byte begär du identiteten med 00 på port 15 och använder dokumentationen för den nya applikationen.

LoRaWAN och portar

LoRaWANMAC 1.0.4, regionala parametrar RP002-1.0.3, klass A, OTAA, max EIRP 14 dBm
JoinEUI70B3D52C0001D4C3 (alla Square- och Puck-sensorer)
PortRiktningInnehåll
1UpplänkTemperatur, antal rörelser och rörelsetid, lutning och batteri (se Meddelanden)
11UpplänkSamma utdata i komprimerad form
12UpplänkLoggade data: ett meddelande som sparades när sensorn saknade nätverk och skickas senare med tidpunkten då det registrerades
15UpplänkApplikationsidentitet (rulesCrc32), skickas först av allt efter en anslutning
15Nedlänk00 ber sensorn skicka sin applikationsidentitet igen
21UpplänkGNSS-skanningar för positionering
22UpplänkMetadata för GNSS-skanningarna
23, 24UpplänkWi-Fi-skanningar för positionering. De kommer på port 23 eller 24, och avkodaren hanterar båda.
2NedlänkInställningar och läsbegäranden (se Inställningar på port 2)
2UpplänkSensorns svar med de värden som nu gäller
7NedlänkEn hel konfiguration i en enda payload (se Hel konfiguration på port 7)
7UpplänkStatus för konfigurationen: None, Applied, Error eller Dirty

Meddelanden

Varje utdata har ett id och en skala. Bekräftade utdata kvitteras av nätverksservern.

UtdataIdStorlek och skalaEnhetBekräftadSkickas
tempB02 byte, × 0,01°CNejVid en ändring större än Temperature Hysteresis (mäts var 15:e minut)
averageTempB12 byte, × 0,01°CNejMed intervallet Average Temp Interval, om värdet har ändrats mer än Temperature Hysteresis
tempAlarm801 byte0 = inget larm, 1 = högt, −1 = lågtJaNär larmläget ändras
motionCountBA4 byteantal rörelser sedan startNejVarje timme om värdet har ändrats, när Enable Motion Count Report är på
motionTimeMinutesBB4 byteminuter med rörelse sedan startNejVarje timme om värdet har ändrats, när Motion Time Enabled är på
positionX, positionY, positionZ98 99 9A4 byte vardera, × 0,001m/s² (tyngdkraften längs varje axel)JaMed lutningsrapporten påslagen: referensorienteringen, vid första kontrollen och efter varje förflyttning
positionMoves9B4 byteförflyttningar sedan startJaMed lutningsrapporten påslagen: tillsammans med den nya referensen efter varje förflyttning
batteryPercent811 byte% (uppskattat)JaEn gång i veckan

Inställningar

Standardvärdena är de värden som sensorn startar med. Id är det värde som anges i en nedlänk på port 2. Värdena skickas i de steg som står i tabellen. Temperaturhysteresen har steg om 0,01 och skickas som hundra gånger värdet, och Position Moved Threshold har steg om 0,001 och skickas som tusen gånger värdet. Alla övriga värden är heltal.

InställningNamn i applikationenIdFunktionEnhetVärdeområdeStandard
Still ThresholdstillMotionThreshold_mm_s2B3Hur kraftig en rörelse måste vara för att räknas som rörelse när sensorn står stilla. Är värdet för lågt tror sensorn att den alltid rör sig.mm/s²150–7 350920
Moving ThresholdmovingMotionThreshold_mm_s2B4Hur kraftig en rörelse måste vara för att räknas som fortsatt rörelse när sensorn rör sig.mm/s²150–7 350460
Minimum Wifi CountminimumWifiCountA6Hur många Wi-Fi-accesspunkter en skanning måste hitta för att skanningsserien ska avslutas.accesspunkter1–153
Still Wifi Scan Again At MinutesingleWifiScanAgain_minutesA5Den minut då den andra begränsade Wi-Fi-skanningen görs efter att sensorn har börjat eller slutat röra sig. −1 stänger av den. Undvik 1, eftersom den första skanningen alltid görs vid minut 1.minuter−1 till 1272
Full Wifi Scan At MinutefullWifiScan_minutesA8Den minut då den fullständiga Wi-Fi-skanningen görs efter att sensorn har börjat eller slutat röra sig. −1 stänger av den. Undvik 1.minuter−1 till 12715
Limited Wifi Scan Channel MasklimitedScanChannelsB8Wi-Fi-kanalerna för de begränsade skanningarna, angivna som bitmask: kanal 1 och 3 blir binärt 101, decimalt 5. 0 betyder alla kanaler. Färre kanaler sparar ström.bitmask0–65 5350
Full Wifi Scan Channel MaskfullScanChannelsB9Wi-Fi-kanalerna för den fullständiga skanningen, angivna som bitmask på samma sätt.bitmask0–65 5350
GNSS ModegnssModeAC1 = varje skanningsserie börjar med en GNSS-skanning, med en valfri Wi-Fi-skanning som reserv. 0 = Wi-Fi först, med GNSS som sista steg.på/av0–10
GNSS Scan At MinutegpsScan_minutesA9Den minut då GNSS-skanningen görs. Den är sista steget i skanningsserien när GNSS Mode är avstängt. −1 stänger av den. Undvik 1, och undvik samma minut som för den fullständiga Wi-Fi-skanningen.minuter−1 till 12760
Minimum Satellite CountminimumGnssCountA7I GNSS Mode: hur många satelliter en GNSS-skanning måste hitta för att skanningsserien ska avslutas. Hittar den färre följer Wi-Fi-skanningen som reserv. Det minsta antal satelliter som ett GNSS-resultat behöver för att skickas över huvud taget går inte att ändra. Det är 3 i GNSS Mode och 5 för skanningen vid GNSS Scan At Minute.satelliter1–153
Fallback WIFI Scan At MinutebackUpWifiGnssScanMinutesADI GNSS Mode: den minut då reservskanningen med Wi-Fi görs, om GNSS-skanningen inte har hittat tillräckligt många satelliter. −1 stänger av den. Ställ inte in den före minut 1.minuter−1 till 127−1 (av)
Moving Scan IntervalmovingScanIntervalMinutesBCStartar om skanningsserien med detta intervall när sensorn rör sig. −1 stänger av funktionen. Ställ inte in ett kortare intervall än skanningsserien.minuter−1 till 32 768−1 (av)
Stationary Scan IntervalstationaryScanIntervalMinutesBDStartar om skanningsserien med detta intervall när sensorn står stilla. −1 stänger av funktionen.minuter−1 till 32 7671 440
15 Minute Scan BudgetquarterlyScanBudgetA4Hur många skanningar som läggs till skanningsbudgeten var 15:e minut.skanningar1–153
Max Scan BudgetmaxBudgetB5Det största antal skanningar som budgeten kan rymma. Varje skanning förbrukar en enhet.skanningar1–32 767100
Tracker OptionstrackerOptionsAESlår på de valfria funktionerna, med en bit för varje. Lägg ihop värdena för att kombinera dem. 1 = lutningsrapport, 4 = skanning först efter stopp (se Valfria funktioner). Bit 2, lufttrycket, kräver en barometer, som Square Tracker Xtreme saknar. Låt den biten vara avstängd.bitmask0–70
Position Moved ThresholdpositionMovedThreshold_m_s2BELutningsrapport: hur mycket den uppmätta tyngdkraftsvektorn måste avvika från referensen, räknat som längden av skillnadsvektorn, för att sensorn 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
Enable Motion Count ReportmotionCountEnabledAA1 = sensorn skickar antalet upptäckta rörelser, varje timme om värdet har ändrats.på/av0–10
Motion Time EnabledmotionTimeEnabledAB1 = sensorn skickar antalet minuter med rörelse, varje timme om värdet har ändrats.på/av0–10
Temperature HysteresistempHysteresisB2Hur mycket temperaturen måste ändras innan ett nytt värde eller medelvärde skickas.°C, steg om 0,010,1–1272
Average Temp IntervalaverageTempIntervalHoursA0Hur ofta medeltemperaturen skickas, om den har ändrats mer än hysteresen.timmar1–1272
Temperature Alarm Low LeveltempAlarmLowLevelA1Nedre larmnivå. Måste ligga under den övre nivån, annars är larmet avstängt.°C−128 till +1262
Temperature Alarm High LeveltempAlarmHighLevelA2Övre larmnivå. Måste ligga över den nedre nivån, annars är larmet avstängt.°C−127 till +12760
Roaming Network CountroamNetworkCountA3Antal LoRaWAN-nätverksidentiteter som sensorn provar i tur och ordning (se Nätverk och roaming).antal1–151
Quick Rejoin BudgetquickRejoinBudgetMaxB6Hur många snabba anslutningsförsök sensorn gör efter att ha tappat ett nätverk (en gång i timmen och 15 minuter efter att den har slutat röra sig) innan den går tillbaka till ett försök per dygn. Budgeten fylls på vid varje anslutning. Med 0 återstår bara det dagliga försöket.antal0–32 76710

Enhetsregister

Registren hör till sensorns firmware och inte till applikationen, men applikationen använder dem och de ändras på samma sätt. Låt dem vara som de är om du inte har särskilda skäl att ändra dem.

RegisterNamnIdFunktionEnhetVärdeområdeStandard
Downlink TimeoutLINKCHECK_TIMED0Hur länge sensorn kan vara utan kontakt med nätverket innan den lämnar nätverket och inte längre är ansluten. Varje nedlänk, även en kvittens, nollställer tiden. Efter halva tiden skickas alla upplänkar som bekräftade meddelanden, och efter 80 % skickar sensorn dessutom 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 sensorn litar på sin klocka. När den tiden har gått blir GNSS-skanningarna autonoma (inte längre assisterade), och när halva tiden har gått frågar sensorn LoRaWAN-nätverket efter tiden med standardbegäran DeviceTime (DeviceTimeReq, LoRaWAN 1.0.3 och senare): först efter en minut, 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. 0 stänger av funktionen. Sensorn har då ingen tid, GNSS-skanningarna är autonoma och mätvärden som tas utan nätverk loggas inte. Klockan går normalt fel med några sekunder per dygn, mer utomhus.sekunder0–4 294 967 295604 800 (7 dagar)

Lämna nätverket

Om du vill att Square Tracker Xtreme 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 och roaming). Värden som mäts medan den inte är ansluten sparas och skickas när den har anslutit igen.

Square Tracker Xtreme kvitterar inte den här nedlänken, inte ens om den skickas som bekräftad, så den kan inte ge upphov till upprepade omsändningar. Skicka den ändå obekräftad.

Publicerade profiler

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

Inställningar på port 2

En nedlänk på port 2 består av en lista med poster på 5 byte vardera: en byte med inställningens id följd av värdet som ett 32-bitars heltal med tecken, mest signifikanta byten först. Värdet anges i inställningens egna steg. En temperaturhysteres på 2 °C med steg om 0,01 skickas alltså som 200, och ett skanningsintervall på 30 minuter som 30. Negativa värden skrivs i tvåkomplement, så −10 blir FF FF FF F6. Sensorn tillämpar värdena och svarar på port 2 med de värden som då gäller.

Id:na gäller för 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å ändra fel inställning i en annan. Skapa alltid nedlänken för den rulesCrc32 som sensorn själv rapporterar.

Läsa av värden

En nedlänk på port 2 med en till fyra byte är en läsbegäran. Sensorn svarar med det aktuella värdet för varje id i begäran.

Nedlänk på port 2Sensorn svarar med
04Aktuell temperatur i hundradels grader
16Aktuellt rörelsetillstånd
BDInställt värde för Stationary Scan Interval (alla inställnings-id:n fungerar på samma sätt)

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.

Exempel 1: GNSS först, för föremål som för det mesta är utomhus

Slå på GNSS Mode, med en Wi-Fi-skanning som reserv vid minut 5 om GNSS-skanningen hittar för få satelliter. Exemplen är uppbyggda enligt postformatet i Inställningar på port 2 för rulesCrc32 1583824533 och har kontrollerats med VSM-översättaren (öppen källkod). Payloaden för port 7 innehåller applikationsidentiteten och kontrollsumman, precis som när VSM Configuration Tool tar fram den. Skicka antingen payloaden för port 2 eller den för port 7, inte båda.

InställningVärdeSkickas somPost
GNSS Modepå1AC 00 00 00 01
Fallback WIFI Scan At Minute55AD 00 00 00 05
Port 2 (hex)AD 00 00 00 05 AC 00 00 00 01
Port 2 (base64)rQAAAAWsAAAAAQ==
Eller port 7 (hex)5E 67 3E 95 02 0A AD 00 00 00 05 AC 00 00 00 01 00 74 7F 8A 41

Exempel 2: positioner medan föremålet rör sig

Starta om skanningsserien var 30:e minut medan sensorn rör sig. Varje omstart förbrukar skanningar ur budgeten och batteri.

InställningVärdeSkickas somPost
Moving Scan Interval30 min30BC 00 00 00 1E
Port 2 (hex)BC 00 00 00 1E
Port 2 (base64)vAAAAB4=
Eller port 7 (hex)5E 67 3E 95 02 05 BC 00 00 00 1E 00 1B 8D A1 FE

Exempel 3: lutningsrapport

Slå på lutningsrapporten, så att sensorn rapporterar när föremålet har lutats eller vridits, det vill säga Tracker Options 1.

InställningVärdeSkickas somPost
Tracker Optionslutningsrapport1AE 00 00 00 01
Port 2 (hex)AE 00 00 00 01
Port 2 (base64)rgAAAAE=
Eller port 7 (hex)5E 67 3E 95 02 05 AE 00 00 00 01 00 8C A5 68 E9

9Specifikationer

PositioneringGNSS (GPS och BeiDou) utomhus, Wi-Fi-skanning på 2,4 GHz inomhus; kräver en molntjänst med stöd för båda
GivareRörelse och lutning (3D-accelerometer), temperatur (typiskt ±2 °C)
MinneInbyggd datalogg som laddas upp via LoRaWAN när sensorn ansluter
RadioLoRaWAN 1.0.4, klass A, OTAA; JoinEUI 70B3D52C0001D4C3
FrekvensplanerEU868 · US915 · AU915 · AS923-1 · AS923-2 · KR920 · IN865
RäckviddUpp till 10 km vid fri sikt
KonfigurationVia NFC (Android) och trådlöst
ApplikationVSM-applikationen Tracker-GNSS (November 2026)
BatteriInbyggt LiMnO₂, 4 000 mAh; 10 år vid 72 positioner per dygn
KapslingsklassIP68
SlagtålighetIK06
Drifttemperatur−20 till +60 °C
Mått67,2 × 60,4 × 13 mm
Vikt61 g
MonteringMonteringsram för skruvar ingår; tejp eller buntband genom öglorna går också

10Support

Källor: Sensative Docs, Square Tracker Xtreme (december 2024, inklusive GNSS-skanningstiderna), FAQ Square & Puck och Hugin NFC application; källkoden och dokumentationen för applikationen i Sensatives repository vsm-applications (Tracker-GNSS, 10 november 2026) och produktdefinitionerna i dots-builds; VSM-översättaren (öppen källkod); specifikationer från produktdata på sensative.com; Wi-Fi-positionering: Semtech, Wi-Fi geolocation with LoRa Edge.