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ändarmanual

Square Air för LoRaWAN

Square Air har utgått och ersatts av Square Air 2. Manualen finns kvar för de Square Air-sensorer som redan är i drift. Sensorn mäter inomhusluftens kvalitet med en gassensor av metalloxidtyp (IAQ, bVOC och CO₂-ekvivalent), plus temperatur, luftfuktighet, lufttryck och ljus, och har ett batteri på 6 000 mAh.

Revision B · november 2026 · Sensative AB

Snabbstart

1Inledning

Square Air mäter inomhusluftens kvalitet med en gassensor av metalloxidtyp (Bosch BME688). Sensorn ger ett luftkvalitetsindex (IAQ), breath-VOC och en CO₂-ekvivalent och mäter dessutom lufttryck, temperatur, relativ luftfuktighet och ljus. Värdena rapporteras via LoRaWAN. Måtten är 58 × 58 × 15 mm. Sensorn är avsedd för torra inomhusutrymmen (IP30) och har två små hål i framsidan.

Ett inbyggt minne loggar mätvärdena när sensorn saknar nätverk och skickar dem via LoRaWAN när den är ansluten igen, så att inga data går förlorade. Med Wi-Fi-positionering kan du se var varje sensor finns. Batteriet är inbyggt (6 000 mAh) och räcker ungefär 6–7 år med kontinuerlig mätning och ungefär 12 år om sensorn bara mäter under utökad kontorstid (06.00–20.00, måndag till fredag).

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 Square-air 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 Air, med tejpen redan på baksidan

Nycklarna (DevEUI och AppKey) finns i leveransinformationen. Skruvmonteringssatsen för Square säljs separat.

Sensorns delar

Square Air från sidan och framifrån, med två små hål på var sin sida om logotypen
Framsidan har två hål, ett på var sin sida om logotypen. Sett framifrån är det högra hålet luftintaget till gassensorn. Bakom det vänstra hålet finns ingenting. Håll båda hålen fria. 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 sänder via radio till en gateway, som skickar vidare till nätverksservern och därifrån 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)

Välja placering

  • För inomhusklimat och luftkvalitet: på en innervägg i ögonhöjd, där luften kan cirkulera fritt runt sensorn
  • Skyddad från direkt solljus, element, andra värmekällor och drag
  • Inte nära soptunnor, kemikalier, ventilationsintag, dörrar eller fönster, eftersom de kan påverka luftkvalitetsvärdena kraftigt
  • Bara inomhus: sensorn har kapslingsklass IP30 och är avsedd för torra inomhusutrymmen
  • Fria hål: håll de två hålen i framsidan fria
  • Räckvidd: upp till 10 km vid fri sikt, betydligt kortare genom väggar och bjälklag
  • Metall går bra: till skillnad från Strips kan en Square-sensor monteras på metall utan att radion påverkas nämnvärt. Undvik bara slutna metallhöljen, som ett stängt stålskåp.
Square på en innervägg i ögonhöjd, en bit från ett soligt fönster och ett element

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 Air 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 Air levereras med applikationen Square-air. Med standardinställningarna skickar sensorn luftkvalitetsvärdena var 30:e minut och medelljusnivån var 20:e minut om den har ändrats. Temperaturen rapporteras när den ändras med 0,5 °C, medeltemperaturen var 60:e minut och luftfuktigheten när den ändras med 2 %. Sensorn larmar för luftkvalitet när IAQ överstiger 200 och för temperatur under 2 °C och över 60 °C. Ändra inställningarna om du behöver något annat.

Om du begränsar mätningen till de timmar du behöver räcker batteriet längre, ungefär 12 år om sensorn bara mäter under utökad kontorstid (06.00–20.00, måndag till fredag), jämfört med ungefär 6–7 år med kontinuerlig mätning.

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

6

Montera

Det finns två sätt:

  1. Tejp: ytan måste vara ren och torr. Dra av skyddsfilmen från tejpen på baksidan och tryck fast sensorn ordentligt.
  2. Skruv med skruvmonteringssatsen för Square (säljs separat). Satsen består av två 2 mm tjocka tejpplattor på en märkfolie. Märk ut borrhålen med hjälp av folien, antingen bredvid sensorn eller dolt bakom den (använd i så fall skruvar med extra låg platt skalle). Skruva fast plattorna med den tjocka tejpsidan utåt, mot sensorn (så att skruvskallarna får plats), dra av filmerna från plattorna och sensorn, kontrollera att sensorn hamnar rakt och tryck fast den ordentligt på plattorna.
Täck inte över de två hålen i framsidan med tejp, färg eller etiketter. Det högra hålet är luftintaget till gassensorn.
7

Testa

Andas på sensorn eller håll den i handen en minut. Temperaturen och luftfuktigheten stiger då över tröskelvärdena.

Klart när: nya värden för temperatur och luftfuktighet kommer fram i din applikation. De första luftkvalitetsvärdena kommer när Air Interval har gått (som standard 30 minuter). Bortse från de allra första, eftersom de kan gälla en ofullständig period.
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
  • Inställningarna kontrollerade eller ändrade efter behov
  • Monterad inomhus på en innervägg, skyddad från sol, värme och drag, med fria hål i framsidan
  • Luftkvalitet, temperatur, luftfuktighet och ljus kommer fram

4Använda sensorn

Applikationen mäter luftkvalitet, lufttryck, temperatur, luftfuktighet och ljus med jämna mellanrum. Den skickar ett nytt värde när ett mätvärde har ändrats mer än ett inställt tröskelvärde eller när ett inställt intervall har gått. Inställningarna i fetstil finns i inställningstabellen.

Luftkvalitet

Square Air mäter luftkvaliteten med gassensorn, som också mäter lufttrycket. Gassensorn startar när sensorn har anslutit till nätverket. Den tar ett prov var 5:e minut, och efter varje Air Interval (som standard 30 minuter) skickar applikationen medelvärdet av varje storhet under perioden. De första värdena efter starten kan gälla en ofullständig period, så bortse från dem.

  • IAQ (index för inomhusluftens kvalitet): en skala från 0 (ren luft) till 500 (kraftigt förorenad luft), som beräknas utifrån de gaser som gassensorn känner av. Ungefär 50 motsvarar bra luft och ungefär 200 typisk förorenad luft. Sensorn kalibrerar indexet mot omgivningen utifrån sina senaste mätvärden. Därför bör rummet vädras ordentligt en gång i veckan, så att sensorn får frisk luft.
  • Statiskt IAQ: samma skala utan den automatiska omkalibreringen. Använd det där sensorn inte regelbundet får frisk luft.
  • bVOC (breath-VOC-ekvivalent): flyktiga organiska ämnen, angivna som breath-VOC-ekvivalenter i ppm.
  • CO₂-ekvivalent: en uppskattning i ppm, som bygger på det genomsnittliga förhållandet mellan VOC och CO₂ i människors utandningsluft. Square Air har ingen CO₂-sensor, så värdet är inte ett uppmätt CO₂-värde. För uppmätt CO₂ finns Square CO2.
  • Lufttryck: i hPa med två decimaler.
IAQ, bVOC och CO₂-ekvivalenten påverkas av matlagning, mat, rök, parfym och avgasning från färg eller möbler. Square Air kan reagera på rök, men är inget certifierat brandlarm. Sensorn är inte konstruerad för att upptäcka CO₂-läckor från gasflaskor eller annan utrustning.

Så fungerar gassensorn

Gassensorn är en metalloxidsensor. Gaser i luften tas upp av sensorns känsliga skikt och oxideras eller reduceras där. Ju mer kemiskt reaktiv gasen är, desto starkare blir signalen.

  • Vad sensorn reagerar på: de flesta flyktiga ämnen och många andra gaser som förorenar inomhusluften. Den reagerar inte på några få nästan inerta gaser, som kväve och CO₂. Därför är CO₂-värdet en ekvivalent som uppskattas utifrån VOC i utandningsluften och inte ett mätvärde.
  • En summa, inte en enskild gas: sensorn mäter summan av VOC och föroreningar i luften, inte en viss gas. Den fångar därför upp avgasning från färg, möbler och sopor och höga VOC-halter från matlagning, mat, utandningsluft och svett.
  • IAQ eller statiskt IAQ: IAQ kalibrerar sig mot omgivningen, och Bosch rekommenderar det för mobil användning. Statiskt IAQ omkalibreras inte, och Bosch rekommenderar det för stationära enheter. I praktiken använder du statiskt IAQ där sensorn inte regelbundet får frisk luft och IAQ där rummet vädras regelbundet.

Uppvärmning och noggrannhet

Gassensorn behöver upp till 28 dagars drift innan IAQ och de övriga gasvärdena är helt tillförlitliga. Tillsammans med luftkvalitetsvärdena skickar sensorn tre statusvärden som visar hur långt den har kommit:

  • Stabiliseringsstatus: visar hur långt den inledande kalibreringen och stabiliseringen har kommit.
  • IAQ-noggrannhet: ett värde från 0 till 3 som anger hur bra den aktuella kalibreringen är.
  • Inkörningsstatus: gassensorns egen startstatus.

Luftkvalitetslarm

  • När IAQ överstiger IAQ Alarm Level (som standard 200), eller när statiskt IAQ överstiger Static IAQ Alarm Level (som standard 200), skickar sensorn ett luftkvalitetslarm som bekräftat meddelande.
  • Larmet är ett enda värde: 0 = inget larm, 1 = larm för statiskt IAQ, 2 = IAQ-larm, 3 = båda.

Ljus

Sensorn mäter ljuset varje minut. Efter varje Average Lux Report Interval (som standard 20 minuter) beräknar den medelljusnivån i lux och skickar den som bekräftat meddelande, om den har ändrats mer än Lux Threshold (som standard 100 %).

Temperatur

  • Sensorn mäter temperaturen varje minut.
  • När temperaturen har ändrats mer än Temperature Threshold sedan det senast skickade värdet skickar sensorn det nya värdet.
  • Efter varje Average Temperature Interval skickar sensorn medeltemperaturen, förutsatt att den har ändrats mer än Average Temperature Threshold.
  • Över Temperature High Alarm Level går larmet till läget ”högt”, och under Temperature Low Alarm Level till läget ”lågt”. Larmet skickas som bekräftat meddelande. Om den nedre nivån inte ligger under den övre är larmet avstängt.

Luftfuktighet

  • Sensorn mäter luftfuktigheten varje minut.
  • När luftfuktigheten har ändrats mer än Humidity Threshold skickar sensorn det nya värdet.
  • Efter varje Humidity Interval beräknar sensorn medelvärdet för luftfuktigheten och skickar det som bekräftat meddelande om det har ändrats mer än samma tröskelvärde.
Om luftfuktigheten går över 100 % (till exempel vid dagg) kan de närmast följande mätvärdena bli tydligt felaktiga tills sensorn har torkat.

Batteri och position

En gång i veckan uppskattar sensorn hur mycket batteri som återstår och skickar värdet i procent. Uppskattningen bygger på uppmätt drifttid och den energi som processorn, radion, sensorerna och positionsskanningarna har förbrukat. Square Air bestämmer sin position enbart med Wi-Fi. En gång per dygn, när sensorn är ansluten, söker den efter Wi-Fi-accesspunkter och skickar resultatet. En molntjänst för geopositionering, som den i Yggio eller Munin, räknar sedan fram positionen ur skanningen.

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 30 dagar, se Enhetsregister). Har sensorn ingen 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ä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.
  • Positionen: räknas fram av en molntjänst med stöd för Wi-Fi-positionering, till exempel Yggio (Munin och LoRa Cloud klarar det också). Tjänsten slår upp adresserna i en databas över 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å accesspunkter får du snarare området än rummet. Fler billiga 2,4 GHz-accesspunkter ger bättre noggrannhet.
  • Bara Wi-Fi: Square Air har ingen satellitpositionering.

Nätverk och roaming

  • Bekräftade meddelanden: nätverksservern kvitterar larm, medelvärden för luftfuktighet och ljus samt batterinivån. Kommer ingen kvittens skickar sensorn meddelandet igen.
  • Ny anslutning: om sensorn inte är ansluten gör den ett anslutningsförsök var 24:e timme. 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 24 timmar, 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 själv datahastigheten, långsamt och stegvis, 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å 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.

Ä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 från Profile Library (det finns inga för den här applikationen, 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 (6 000 mAh). I ett bra nätverk (SF7–SF9) räcker det ungefär 6–7 år med kontinuerlig mätning och ungefär 12 år om sensorn bara mäter under utökad kontorstid (06.00–20.00, måndag till fredag). Täta rapporter och en svag länk förkortar batteritiden.

Demontera Square Air

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
Inga luftkvalitetsvärdenGassensorn startar när sensorn har anslutit, och värdena kommer efter varje Air Interval (som standard 30 minuter). Bortse från de första värdena efter starten.
Luftkvalitetsvärdena verkar instabilaGassensorn behöver upp till 28 dagars drift innan värdena är helt tillförlitliga. Stabiliseringsstatusen och IAQ-noggrannheten (0–3) som skickas med värdena visar hur långt sensorn har kommit.
IAQ-värdet driver eller verkar felVädra rummet ordentligt en gång i veckan, så att sensorn får frisk luft att kalibrera mot. Om sensorn aldrig får frisk luft använder du statiskt IAQ. Matlagning, mat, rök, parfym och nymålade ytor eller nya möbler höjer också värdena.
Luftfuktigheten visar för högt efter kondensVatten på sensorn (dagg) påverkar mätvärdena tills sensorn har torkat.
Temperaturen visar för högt eller för lågtKontrollera placeringen. Direkt solljus, ett element eller drag i närheten ger missvisande värden.
Ingen eller dålig positionFör att få en position krävs en molntjänst med stöd för 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 sänder på 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 Square-air November 2026. Andra versioner kan skilja sig, så kontrollera i dokumentationen för VSM-applikationer eller i VSM Configuration Tool vad som gäller för din version.

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:

ApplikationSquare-air
VersionNovember 2026
rulesCrc323007941823 (hex B3498CBF)
Tidigare versionSquare-air R33, rulesCrc32 114894312 – 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 gäller för en viss applikationsversion. Om sensorn 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. Sensorer som levererades före releasen i november 2026 kör Square-air 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.

Alternativa applikationer: utöver Square-air 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 användningsområde. 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änkMätvärden och larm (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
23UpplänkWi-Fi-skanning för positionering
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
air_iaqB84 byteIAQ-index, 0–500NejEfter varje Air Interval
air_static_iaqBC4 byteIAQ-index, 0–500NejEfter varje Air Interval
air_breath_voc_equivalentBB4 byte, × 0,01ppm (breath-VOC-ekvivalent)NejEfter varje Air Interval
air_co2B94 byteppm (CO₂-ekvivalent)NejEfter varje Air Interval
air_pressureBA4 byte, × 0,01hPaNejEfter varje Air Interval
air_run_in_status, air_stab_status, air_iaq_accuracyA7 A8 A91 byte varderastatus; IAQ-noggrannhet 0–3NejTillsammans med luftkvalitetsvärdena
air_iaq_alarm821 byte0 = inget, 1 = statiskt IAQ, 2 = IAQ, 3 = bådaJaNär IAQ eller statiskt IAQ överstiger sin larmnivå
luxB52 byteluxNejNär ljusnivån ändras mer än Lux Threshold
averageLux912 byteluxJaEfter varje Average Lux Report Interval, om värdet har ändrats mer än Lux Threshold
tempB02 byte, × 0,01°CNejVid en ändring större än Temperature Threshold
averageTempB12 byte, × 0,01°CNejEfter varje Average Temperature Interval, om värdet har ändrats mer än Average Temperature Threshold
tempAlarm811 byte0 = inget larm, 1 = högt, −1 = lågtJaNär larmläget ändras
humidityB32 byte, × 0,01% RFNejVid en ändring större än Humidity Threshold
averageHumidity902 byte, × 0,01% RFJaEfter varje Humidity Interval, om värdet har ändrats mer än Humidity Threshold
batteryPercent801 byte% (uppskattat)JaEn gång i veckan

Inställningar

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

InställningNamn i applikationenIdFunktionEnhetVärdeområdeStandard
Air Intervalair_interval_minutesAADen period som luftkvalitetsvärdena medelvärdesbildas över innan de skickas. Gassensorn tar ett prov var 5:e minut, så välj en multipel av 5.minuter5–12530
IAQ Alarm Levelair_iaq_alarm_levelBENär IAQ överstiger det här värdet skickas ett luftkvalitetslarm.IAQ-index0–1 000200
Static IAQ Alarm Levelair_static_iaq_alarm_levelBDNär statiskt IAQ överstiger det här värdet skickas ett luftkvalitetslarm.IAQ-index0–1 000200
Lux ThresholdluxTresholdPercentB6Den ändring i ljusnivå som krävs för att ljus eller medelljus ska skickas.%1–32 767100
Average Lux Report IntervalaverageLuxIntervalMinutesA6Hur ofta medelljusnivån beräknas och skickas, om den har ändrats.minuter2–12720
Temperature ThresholdtempHysteresisB2Den temperaturändring som krävs för att ett nytt värde ska skickas. Mindre ändringar rapporteras inte, vilket sparar batteri och sändtid.°C, steg om 0,010,1–1270,5
Average Temperature IntervalaverageTempIntervalMinutesA2Hur ofta medeltemperaturen skickas, om den har ändrats mer än Average Temperature Threshold.minuter2–12760
Average Temperature ThresholdaverageTempHysteresisA1Den ändring i medeltemperatur som krävs för att den ska skickas.°C, steg om 0,10–12,70,1
Temperature Low Alarm LeveltempAlarmLowLevelA3Nedre larmnivå. Måste ligga under den övre nivån, annars är larmet avstängt.°C−50 till +702
Temperature High Alarm LeveltempAlarmHighLevelA4Övre larmnivå, som standard nära produktens högsta omgivningstemperatur. Måste ligga över den nedre nivån, annars är larmet avstängt.°C−50 till +8060
Humidity ThresholdhumidityTresholdB4Den ändring i luftfuktighet som krävs för att luftfuktighet eller medelluftfuktighet ska skickas. Över 100 är funktionen i praktiken avstängd.% RF, steg om 0,010,1–1002
Humidity IntervalaverageHumidityIntervalMinutesA5Hur ofta medelvärdet för luftfuktigheten beräknas.minuter1–12760
Roaming Network CountroamNetworkCountA0Antal LoRaWAN-nätverksidentiteter som sensorn provar i tur och ordning (se Nätverk och roaming).antal1–151

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 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 sensorn också egna länkkontroller. 0 stänger av kontrollen.sekunder300–2 592 00086 400 (24 timmar)
Device Time Max AgeDEVICE_TIME_MAX_AGECDHur länge sensorn litar på sin klocka. 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, och mätvärden som tas utan nätverk loggas inte.sekunder0–4 294 967 2952 592 000 (30 dagar)

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 är en lista med poster om 5 byte vardera: en byte för inställningens id och därefter värdet som ett 32-bitars heltal med tecken, med den mest signifikanta byten först. Värdet anges i inställningens egna steg, så ett tröskelvärde för temperatur på 0,2 °C med steget 0,01 skickas som 20. Negativa värden skrivs i tvåkomplement, vilket gör att −10 blir FF FF FF F6. Sensorn tillämpar värdena och svarar på port 2 med de värden som nu 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 lufttemperatur i hundradels grader
05Aktuell luftfuktighet i hundradels procent
06Aktuellt lufttryck
0BAktuell ljusnivå
B2Inställt värde för Temperature Threshold (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: luftkvalitet var 15:e minut

Medelvärdesbilda och skicka luftkvalitetsvärdena var 15:e minut i stället för var 30:e. Exemplen är uppbyggda enligt postformatet i Inställningar på port 2 för rulesCrc32 3007941823 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 payloaden för port 2 eller den för port 7, inte båda.

InställningVärdeSkickas somPost
Air Interval15 min15AA 00 00 00 0F
Port 2 (hex)AA 00 00 00 0F
Port 2 (base64)qgAAAA8=
Eller port 7 (hex)B3 49 8C BF 02 05 AA 00 00 00 0F 00 2D 8C A8 68

Exempel 2: luftkvalitetslarm vid en lägre nivå

Låt sensorn larma för luftkvalitet när IAQ går över 150 i stället för 200.

InställningVärdeSkickas somPost
IAQ Alarm Level150150BE 00 00 00 96
Port 2 (hex)BE 00 00 00 96
Port 2 (base64)vgAAAJY=
Eller port 7 (hex)B3 49 8C BF 02 05 BE 00 00 00 96 00 31 3F B2 CA

9Specifikationer

SensorerLuftkvalitet (gassensor av metalloxidtyp, Bosch BME688: IAQ, statiskt IAQ, bVOC och CO₂-ekvivalent), lufttryck, temperatur, luftfuktighet, ljus
IAQ0–500; avvikelse mellan enskilda sensorer ±15 %
Noggrannhet, temperatur±0,2 °C
Noggrannhet, luftfuktighet±3 % RF (10–90 % RF)
Noggrannhet, lufttryck±0,6 hPa absolut (300–1100 hPa); ±0,12 hPa relativt (900–1100 hPa)
Mätområde, ljus1–65 000 lux
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 Square-air (November 2026)
PositioneringWi-Fi-geopositionering via en molntjänst
MinneInbyggd datalogg som laddas upp via LoRaWAN när sensorn ansluter
BatteriInbyggt LiMnO2, 6 000 mAh; ungefär 6–7 år med kontinuerlig mätning, ungefär 12 år med mätning bara 06.00–20.00, måndag till fredag
KapslingsklassIP30, inomhus
Drifttemperatur−20 till +60 °C
Luftfuktighet vid drift10–90 % RF
Förvaring+10 till +30 °C
Mått58 × 58 × 15 mm
Vikt65 g
MonteringTejp eller skruvmonteringssatsen för Square (tillval)

10Support

Källor: Sensative Docs, Square Air (dec 2024), inklusive beskrivningen av gassensorn, FAQ Square & Puck och Hugin NFC application; källkoden och dokumentationen för applikationen i Sensatives repository vsm-applications (Square-air, 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.