1Einführung
Square Presence erkennt, ob sich Personen in einem Raum aufhalten, und meldet dies über LoRaWAN. Sein Infrarotsensor erfasst die Körperwärme einer Person in einem Erfassungsbereich von ±40° und bis zu 4 m Entfernung. Deshalb bemerkt er nicht nur jemanden, der den Raum betritt, sondern auch jemanden, der still am Schreibtisch oder in einer Besprechung sitzt. Außerdem misst er Temperatur, Luftfeuchte und Umgebungslicht. Der Sensor misst 58 × 58 × 15 mm, ist für trockene Innenräume ausgelegt (IP30) und hat in der Vorderseite zwei kleine Löcher: links den Infrarotsensor, rechts eine Luftöffnung.
Hat der Sensor kein Netzwerk, zeichnet ein eingebauter Speicher die Messwerte auf. Sobald die Verbindung wieder steht, überträgt der Sensor sie über LoRaWAN, sodass keine Daten verloren gehen. Per Wi-Fi-Ortung können Sie feststellen, wo sich jeder einzelne Sensor befindet. Die Batterie ist fest eingebaut (4.000 mAh) und hält weit über zehn Jahre.
Der Sensor arbeitet mit jedem LoRaWAN-Netzwerkserver (LoRaWAN 1.0.4, Klasse A, OTAA) und erreicht bei Sichtverbindung bis zu 10 km. Was er misst, wann er meldet und was er sendet, bestimmt eine Anwendung, die im Sensor auf Sensatives Virtual Sensing Machine (VSM) läuft. Dieses Handbuch beschreibt die Anwendung Presence November 2026. Sie lässt sich per Funk oder per NFC konfigurieren und durch eine neuere Version ersetzen. Sensative kann für denselben Sensor auch andere VSM-Anwendungen anbieten, die ihm eine andere Aufgabe geben (siehe Welche Anwendung läuft im Sensor?).
Lieferumfang
- Square Presence mit bereits aufgebrachter Klebefläche auf der Rückseite
Die Schlüssel (DevEUI und AppKey) erhalten Sie mit den Lieferinformationen. Das Square-Schraubmontage-Set ist separat erhältlich.
Aufbau des Sensors
2Vorbereitung
Ein LoRaWAN-Sensor braucht etwas mehr Vorbereitung als ein Sensor, den Sie einfach mit einem Hub koppeln. Legen Sie zuerst Folgendes bereit:
Das brauchen Sie
- Ein LoRaWAN-Gateway in Reichweite, eingeschaltet und online
- Ein Konto bei einem LoRaWAN-Netzwerkserver (etwa The Things Network, ChirpStack, Loriot oder Actility), in dem das Gateway angelegt ist
- Die Schlüssel des Sensors, also DevEUI und AppKey aus den Lieferinformationen. Die JoinEUI ist für alle Square-Sensoren gleich:
70B3D52C0001D4C3. - Ein Smartphone mit NFC, um den Sensor zu starten. Die meisten Smartphones beherrschen NFC; für ein iPhone brauchen Sie eine NFC-Lese-App (siehe NFC-Antennen finden).
- Einen Payload-Decoder für Sensative-VSM-Sensoren in Ihrem Netzwerkserver oder Ihrer Anwendung (siehe Nachrichten decodieren)
Montageort wählen
Wie gut Square Presence arbeitet, hängt vom Montageort ab. Prüfen Sie den Ort anhand der folgenden drei Regeln.
Halten Sie ihn von Wärme- und Kältequellen fern. Der Sensor erfasst Körperwärme, deshalb muss seine Umgebung thermisch stabil sein. Montieren Sie ihn nicht
- in der Sonne
- in der Nähe von Heizkörpern oder Heizgeräten
- im Luftstrom von Lüftung, Klimaanlage oder einer Luft-Luft-Wärmepumpe
- auf oder an Geräten mit schwankender Temperatur, etwa einem Lüftungsgerät
- in der Nähe einer Tür oder eines Fensters, deren Öffnen die Temperatur unmittelbar am Sensor verändert
Richten Sie ihn auf die Personen aus. Der Sensor erfasst Personen in einem Bereich von ±40° und bis zu 4 m Entfernung.
- Montieren Sie ihn an einer Wand, in der Regel in 1,5 bis 1,8 m Höhe, und zwar so, dass er den Personen zugewandt ist und diese sich im Erfassungsbereich befinden.
- Richten Sie ihn nicht auf Fenster, Fernseher, Heizkörper oder andere Wärmestrahler, weil diese Fehlerkennungen auslösen können.
Sorgen Sie für freie Sicht auf die Personen.
- Platzieren Sie ihn so, dass er die Personen im Raum möglichst gut erfasst.
- Zwischen Sensor und Personen dürfen keine Hindernisse wie Stuhllehnen, Bildschirme oder Trennwände stehen.
Außerdem:
- Nur für Innenräume: Der Sensor hat die Schutzart IP30 und ist für trockene Innenräume ausgelegt.
- Beide Löcher in der Vorderseite freihalten: Das linke (Infrarotsensor) braucht freie Sicht, das rechte (Luftöffnung) freien Luftzugang.
- Reichweite: bis zu 10 km bei freier Sichtverbindung, durch Wände und Decken deutlich weniger
- Metall ist kein Problem: Anders als Strips können Sie einen Square-Sensor auf Metall montieren, ohne dass die Funkverbindung nennenswert leidet. Vermeiden Sie nur geschlossene Metallgehäuse, etwa einen geschlossenen Stahlschrank.
NFC-Antennen finden
NFC reicht nur wenige Zentimeter weit. Legen Sie das Smartphone deshalb flach auf den Sensor, Antenne über Antenne. Dazu müssen Sie wissen, wo beide Antennen sitzen. Am einfachsten finden Sie die Stelle, indem Sie das Smartphone langsam über den betreffenden Bereich bewegen, bis es den Kontakt meldet:
- Am Sensor: unten links auf der Vorderseite, wenn das Logo an der Unterkante steht.
- Bei einem Android-Smartphone (empfohlen): Schalten Sie NFC ein und aktivieren Sie in den Einstellungen des Smartphones Vibration oder einen Ton für NFC, damit das Smartphone sofort meldet, wenn es den Sensor gefunden hat. Die Antenne sitzt meist auf der Rückseite nahe der Oberkante, oft in der Nähe der Kamera; das ist aber von Modell zu Modell verschieden. Wo sie liegt, steht im Handbuch des Smartphones oder auf der Website des Herstellers. Wenn Sie sie nicht finden, führen Sie die Rückseite des Smartphones langsam über die linke untere Ecke des Sensors, bis das Smartphone vibriert.
- Schutzhülle abnehmen: Eine Schutzhülle, vor allem eine dicke oder eine mit Metall oder Magnet, kann den NFC-Kontakt erschweren. Nehmen Sie sie ab, solange Sie mit dem Sensor arbeiten.
- Dann ruhig halten: Um einen Beitritt zu starten, halten Sie das Smartphone etwa 5 Sekunden lang ruhig über den Sensor. Die Vibration bedeutet nur, dass das Smartphone den Sensor gefunden hat. Lassen Sie das Smartphone, wo es ist, bis Sensor und App den Datenaustausch abgeschlossen haben. Mit der Hugin-App dauert das einige Sekunden, weil die App den Sensor zuerst über den Server von Sensative entsperrt. Nehmen Sie das Smartphone zu früh weg, bricht die Verbindung ab und Sie müssen von vorn beginnen.
- Bei einem iPhone: Verwenden Sie eine NFC-Lese-App, etwa NFC Reader & Scanner aus dem App Store. Öffnen Sie die App und tippen Sie auf die NFC-Schaltfläche, bis Ready to Scan erscheint, bevor Sie den Sensor berühren. Die Antenne des iPhones sitzt an der Oberkante der Rückseite. Halten Sie diese Kante ruhig an die linke untere Ecke des Sensors. Gelingt das Lesen, öffnet sich ein Weblink mit der Seriennummer des Sensors. Die iPhone-Anleitung zum NFC-Beitritt (PDF) zeigt jeden Schritt mit Bildern.
3Installation Schritt für Schritt
Die Installation umfasst 8 Schritte. Registrieren Sie den Sensor im Netzwerkserver, bevor Sie das Smartphone an ihn halten. Lassen Sie ihn dann dem Netzwerk beitreten, prüfen Sie die Einstellungen und montieren Sie ihn ganz zum Schluss.
Auspacken
Prüfen Sie den Sensor und legen Sie seine Schlüssel bereit. Der Sensor schläft, bis er in ein NFC-Feld kommt.
Sensor im Netzwerkserver registrieren
- Legen Sie in Ihrem Netzwerkserver ein neues Endgerät mit der Aktivierungsart OTAA an.
- Verwenden Sie diese LoRaWAN-Einstellungen: MAC-Version 1.0.4, Regionalparameter RP002-1.0.3, max. EIRP 14 dBm und den Frequenzplan Ihrer Region.
- Geben Sie DevEUI und AppKey aus den Lieferinformationen sowie die JoinEUI
70B3D52C0001D4C3ein. Prüfen Sie die Eingaben sorgfältig. Ist auch nur ein Zeichen falsch, schlägt der Beitritt fehl. - Richten Sie die Decodierung der Nachrichten ein (siehe Nachrichten decodieren).
Dem Netzwerk per NFC beitreten
Halten Sie das Smartphone über die linke untere Ecke der Vorderseite von Square Presence und halten Sie es etwa 5 Sekunden lang ruhig. Damit starten Sie den Beitritt (siehe NFC-Antennen finden, auch für das iPhone). Das Smartphone zeigt möglicherweise einen Weblink mit der Seriennummer des Sensors an; Sie müssen ihn nicht öffnen.
Signal am Montageort prüfen
Halten Sie den Sensor an die Stelle, an der er montiert werden soll, und sehen Sie sich im Netzwerkserver seine Nachrichten an, also den Beitritt und die ersten Meldungen.
Konfigurieren (optional)
Square Presence wird mit der Anwendung Presence ausgeliefert. Mit den Standardeinstellungen meldet er den Raum als belegt, sobald er eine Person erkennt, und als frei, wenn die Wärme wieder abgeklungen ist, spätestens aber nach einer Stunde ohne jede Bewegung. Er mittelt Temperatur und Luftfeuchte über 60 Minuten und meldet den Batteriestand einmal pro Woche. Lichtwerte meldet er erst, wenn Sie ein Average Lux Report Interval einstellen. Ändern Sie die Einstellungen, wenn Sie etwas anderes brauchen, etwa Lichtmesswerte oder eine kürzere Wartezeit, bis der Raum als frei gemeldet wird.
Wie Sie die Einstellungen ändern, lesen Sie unter Einstellungen ändern, in der Einstellungstabelle und in den Beispielen.
Montieren
Wie gut Square Presence arbeitet, hängt vom Montageort ab. Prüfen Sie den Ort vor dem Befestigen anhand der Regeln im Kapitel Vorbereitung:
- An einer Wand, in der Regel in 1,5 bis 1,8 m Höhe
- Die Vorderseite ist den Personen zugewandt und diese befinden sich im Erfassungsbereich (±40°, bis zu 4 m)
- Nichts dazwischen: keine Stuhllehnen, Bildschirme oder Trennwände
- Nicht auf Fenster, Fernseher, Heizkörper oder andere Wärmestrahler gerichtet
- Keine Sonne, kein Heizkörper und kein Heizgerät am Sensor und kein Luftstrom von Lüftung, Klimaanlage oder Wärmepumpe
- Nicht auf Geräten mit schwankender Temperatur und nicht neben einer Tür oder einem Fenster, die die Temperatur am Sensor verändern
Für die Befestigung gibt es zwei Möglichkeiten:
- Klebefläche: Die Oberfläche muss sauber und trocken sein. Ziehen Sie die Schutzfolie von der Klebefläche auf der Rückseite ab und drücken Sie den Sensor mit der Vorderseite zu den Personen fest an.
- Schrauben mit dem Square-Schraubmontage-Set (separat erhältlich): Es besteht aus zwei 2 mm dicken Klebeplatten auf einer Markierfolie. Markieren Sie mit der Folie die Bohrlöcher, entweder neben dem Sensor oder verdeckt dahinter (in diesem Fall Flachkopfschrauben mit extra flachem Kopf verwenden). Schrauben Sie die Platten so fest, dass die dicke Klebeseite nach außen zum Sensor zeigt (so haben die Schraubenköpfe Platz). Ziehen Sie dann die Schutzfolien von den Platten und vom Sensor ab, prüfen Sie die Ausrichtung und drücken Sie den Sensor fest auf die Platten.
Testen
Gehen Sie in das Sichtfeld des Sensors und bleiben Sie dort. Mit den Standardeinstellungen meldet der Sensor den Raum sofort als belegt. Bleiben Sie einige Minuten ruhig sitzen – der Raum bleibt belegt. Verlassen Sie dann den Raum.
Betriebsbereit
- Im Netzwerkserver mit der JoinEUI und der richtigen Region registriert
- Per NFC beigetreten, Nachrichten werden decodiert
- Signal am endgültigen Montageort geprüft: SF9 oder besser
- Einstellungen geprüft oder nach Bedarf angepasst
- Den Personen zugewandt montiert, geschützt vor Wärme, Kälte und Luftströmungen, beide Löcher in der Vorderseite frei
- Meldungen „belegt“ und „frei“ kommen an
4Betrieb
Die Anwendung Presence meldet, ob der Raum frei oder belegt ist, und liefert Werte zum Raumklima: mittlere Temperatur und Luftfeuchte sowie, wenn Sie es einschalten, das Licht. Die fett gesetzten Einstellungen finden Sie in der Einstellungstabelle.
So erkennt der Sensor Anwesenheit
Square Presence hat hinter dem linken Loch der Vorderseite (von vorn gesehen) einen Infrarotsensor. Dieser erfasst die Wärme von Personen in seinem Sichtfeld, einem Bereich von ±40° und bis zu 4 m Entfernung. Die Anwendung wertet ihn einmal pro Minute aus.
- Jemand betritt den Raum: Der Raum gilt als belegt, wenn der Infrarotmesswert zwischen zwei Messungen um mehr als den Entry Step springt und um mehr als den Occupied Level über dem Wert des leeren Raums liegt. Ist Fast Detection eingeschaltet (Standard), meldet der Sensor sofort „belegt“; andernfalls wartet er drei Minuten.
- Jemand sitzt still: Drei Minuten nach Beginn einer Belegung merkt sich der Sensor, wie warm der belegte Raum ist. Solange diese Wärme vorhanden ist, bleibt der Raum belegt, auch wenn sich niemand bewegt.
- Der Raum leert sich: Der Sensor meldet den Raum als frei, wenn ein ausreichender Teil der durch die Belegung entstandenen Wärme wieder verschwunden ist; wie viel, legt der Release Level fest. Ebenfalls als frei gemeldet wird der Raum, wenn während der Quiet Release Time (standardmäßig eine Stunde) keinerlei Bewegung erkannt wurde.
- Was gesendet wird: Wechselt der Raum zwischen frei und belegt, sendet der Sensor eine bestätigte Nachricht. Ist Decision Info eingeschaltet, sendet er zusätzlich den Zustand und die zugrunde liegenden Messwerte, damit Sie die Erkennung für einen Raum feinabstimmen können.
Sichtfeld und Hindernisse
Der Infrarotsensor blickt durch das linke Loch der Vorderseite (von vorn gesehen) und braucht freie Sicht auf die Personen, die er erkennen soll. Lassen Sie dieses Loch unbedeckt. Das rechte Loch ist die Luftöffnung; sie braucht freien Luftzugang, decken Sie sie deshalb ebenfalls nicht ab. Stuhllehnen, Bildschirme, Trennwände und Glas zwischen Sensor und Personen versperren die Sicht, denn Infrarotstrahlung dringt nicht durch Glas. Fenster, Fernseher, Heizkörper und andere Wärmestrahler im Sichtfeld können Fehlerkennungen auslösen, ebenso Sonne, Luftströmungen oder eine Tür in der Nähe des Sensors (siehe „Montageort wählen“ im Kapitel Vorbereitung).
Temperatur, Luftfeuchte und Licht
- Temperatur und Luftfeuchte: Der Sensor mittelt beide Werte über das Temperature and Humidity Interval (standardmäßig 60 Minuten). Danach sendet er die mittlere Temperatur und – falls sie sich geändert hat – die mittlere Luftfeuchte, beide als bestätigte Nachrichten. Mit dem Wert 0 schalten Sie Temperatur und Luftfeuchte ab; die Sensoren werden dann nicht ausgelesen und es wird nichts gesendet.
- Licht: Standardmäßig ausgeschaltet. Um die Lichtmessung einzuschalten, stellen Sie das Average Lux Report Interval ein. Der Sensor berechnet dann über dieses Intervall die mittlere Helligkeit in Lux und sendet sie als bestätigte Nachricht, wenn sie sich geändert hat. Der Lichtsensor sitzt etwa in der Mitte hinter der Vorderseite; decken Sie die Mitte der Vorderseite deshalb nicht ab und kleben Sie keine Etiketten darauf.
Batterie und Position
Einmal pro Woche schätzt der Sensor die verbleibende Batteriekapazität und sendet sie als bestätigte Nachricht in Prozent. Die Schätzung beruht auf der gemessenen Betriebszeit und dem Verbrauch von Prozessor, Funkmodul und Sensoren. Square Presence ortet sich ausschließlich per Wi-Fi. Solange er dem Netzwerk beigetreten und Daily Wifi Scan eingeschaltet ist (Standard), sucht er einmal täglich nach Wi-Fi-Access-Points und sendet das Ergebnis, wenn er mindestens zwei gefunden hat. Ein Geolokalisierungsdienst in der Cloud, etwa in Yggio oder Munin, berechnet daraus eine Position. Ein Scan verbraucht ein bis zwei Sekunden lang etwa 22 mA; schalten Sie ihn ab, wenn Sie die Position nicht brauchen.
Gespeicherte Messwerte
Messwerte, die der Sensor ohne Netzwerkverbindung erfasst, speichert er und sendet sie über LoRaWAN, sobald die Verbindung wieder steht, jeweils mit dem Zeitpunkt der Messung. Bei bestätigten Ausgaben bleibt der gesamte Verlauf erhalten, bis der Speicher voll ist, bei unbestätigten Ausgaben nur der letzte Wert. Mit der Hugin NFC-App lässt sich der Speicher nicht auslesen. Die Zeitstempel stammen von der Uhr des Sensors, die er über das Netzwerk stellt. Dazu fragt er die Uhrzeit innerhalb seines Device Time Max Age ab (standardmäßig 30 Tage; siehe Geräteregister). Ohne Uhrzeit speichert er nichts.
So funktioniert die Wi-Fi-Ortung
- Nur 2,4 GHz: Das Funkmodul durchsucht nur das 2,4-GHz-Band (2412–2484 MHz). Netzwerke, die ausschließlich im 5-GHz-Band senden, erkennt es nicht.
- Passiv: Der Sensor empfängt die Signale von Wi-Fi-Access-Points in der Nähe (802.11 b/g/n) und zeichnet deren MAC-Adressen und Signalstärke (RSSI) auf. Er verbindet sich mit keinem Netzwerk, braucht kein Passwort und sendet nichts über Wi-Fi. Die Adressen werden im LoRaWAN-Uplink übertragen.
- Anzahl: Für eine Position sind mindestens 2 Access Points nötig. Je mehr, desto genauer die Position.
- Positionsbestimmung: Für die Position brauchen Sie einen Cloud-Dienst mit Wi-Fi-Ortung, etwa Yggio (auch Munin und LoRa Cloud beherrschen das). Der Dienst sucht die Adressen in einer Datenbank erfasster Access Points und liefert die Position zurück.
- Genauigkeit: Sie hängt davon ab, wie viele bekannte Access Points in der Nähe sind, und liegt in Innenräumen typischerweise bei 5–20 m. Mit nur einem oder zwei Access Points lässt sich eher der Bereich als der Raum bestimmen. Zusätzliche, preisgünstige 2,4-GHz-Access-Points verbessern die Genauigkeit.
- Nur Wi-Fi: Square Presence hat keine Satellitenortung.
Netzwerk
- Bestätigte Nachrichten: Der Netzwerkserver bestätigt Belegungswechsel, Mittelwerte und Batteriestand. Trifft keine Bestätigung ein, sendet der Sensor die Nachricht erneut.
- Erneuter Beitritt: Ist der Sensor keinem Netzwerk beigetreten, versucht er alle 24 Stunden einen Beitritt. Eine NFC-Berührung wie in Schritt 3 startet sofort einen Beitrittsversuch.
- Verbindungsverlust: Hört der Sensor für die Dauer des Downlink Timeout nichts vom Netzwerk (in dieser Anwendung standardmäßig vier Tage; siehe Geräteregister), gibt er das Netzwerk auf.
Nachrichten decodieren
Die Nachrichten sind kompakte Binärdatensätze, deren Bedeutung von der Anwendungsversion abhängt. Decodieren Sie sie deshalb mit einem Decoder, der VSM unterstützt:
- Yggio decodiert sie mit dem integrierten VSM-Translator und verwaltet die Anwendungsversion jedes Sensors.
- Andere Plattformen: Verwenden Sie Munin, den Open-Source-MQTT-Client von Sensative. Munin decodiert die Nachrichten für jeden Netzwerkserver, hält den Gerätezustand, den der Decoder braucht, und die Gerätezeit aktuell und berechnet Wi-Fi-Positionen.
- Eigene Integration: Der Open-Source-VSM-Translator ist der Decoder, den Munin verwendet; er ist als Node-Paket verfügbar. Dafür müssen Sie zwei Voraussetzungen schaffen: Ihre Integration muss zwischen den Nachrichten mindestens die rulesCrc32 jedes Sensors speichern, und Sie müssen den Translator aktuell halten, weil neue Anwendungsversionen ohne Ankündigung erscheinen. Speichern Sie das vollständige Ergebnis der vorherigen Nachricht, erhalten auch die gespeicherten Messwerte den richtigen Zeitstempel.
Einstellungen ändern
Dafür gibt es zwei Wege: per Funk mit Downlinks von Ihrem Netzwerkserver oder vor Ort mit der Hugin NFC-App. In beiden Fällen beginnen Sie meist im VSM Configuration Tool, das die Downlinks für Sie erzeugt.
- Anwendung auswählen: nach Name und Version oder anhand der rulesCrc32 aus der Port-15-Nachricht des Sensors (siehe Welche Anwendung läuft im Sensor?).
- Konfiguration wählen: ein freigegebenes Profil aus der Profile Library (für diese Anwendung ist keines freigegeben, siehe Freigegebene Profile) oder Custom, um eigene Werte zu setzen. Zu jeder Einstellung werden Beschreibung, Einheit und Wertebereich angezeigt.
- Ergebnis übernehmen: Sie erhalten einen oder mehrere Downlinks für Port 2 oder eine einzelne Payload für Port 7, als Hex oder Base64, die Sie aus Ihrem Netzwerkserver senden. Alternativ erhalten Sie einen QR-Code, den Sie mit der Hugin NFC-App scannen; die App schreibt die Konfiguration dann vor Ort in den Sensor.
5Die Hugin NFC-App
Hugin ist eine optionale Android-App, mit der Sie vor Ort per NFC mit dem Sensor arbeiten. Sie benötigen dafür ein Android-Smartphone mit NFC und GPS sowie ein Yggio-Benutzerkonto. Außerdem muss der Sensor in Yggio registriert und Ihrer Organisation als Eigentümer zugeordnet sein. Das prüft Hugin bei Yggio, bevor die App Sie mit dem Sensor arbeiten lässt. Halten Sie das Smartphone an den Sensor, wie unter NFC-Antennen finden beschrieben. Die App zeigt dann Seriennummer, Anwendung und Version, den Zustand (etwa „beigetreten“), Angaben zu Batterie, Verbindung und Region sowie die DevEUI an. Je nach Ihren Rechten in Yggio kann sie Konfigurationsprofile lesen und anwenden, auch ein Profil, das Sie als QR-Code aus dem VSM Configuration Tool scannen. Außerdem kann sie Gerätezeit und Position aktualisieren.
Installation, Anmeldung, Flashen und Fehlersuche finden Sie im Handbuch zur Hugin NFC-App.
6Wartung und Demontage
Batterie
Die Batterie ist fest eingebaut (4.000 mAh). Mit den Standardeinstellungen hält sie in einem guten Netzwerk (SF7–SF9) weit über zehn Jahre. Häufige Meldungen und eine schwache Verbindung verkürzen die Laufzeit.
Square Presence demontieren
Führen Sie Zahnseide hinter den Sensor und durchtrennen Sie die Klebefläche mit vorsichtigen Sägebewegungen.
Netzwerkserver wechseln
Löschen Sie das Gerät im alten Netzwerkserver und legen Sie es im neuen an. Der Sensor gibt das alte Netzwerk auf, sobald er für die Dauer des Downlink Timeout (in dieser Anwendung standardmäßig vier Tage) nichts von ihm empfangen hat, und tritt dann von selbst dem neuen bei, weil er einmal täglich einen Beitritt versucht. Eine NFC-Berührung wie in Schritt 3 startet den Beitritt sofort. Alternativ können Sie den Sensor mit der Hugin-App sofort neu starten (ON / OFF); dabei werden allerdings auch alle eigenen Einstellungen zurückgesetzt.
Lagerung und Entsorgung
- Lagern Sie nicht verwendete Sensoren bei +10 bis +30 °C.
- Der Sensor enthält eine nicht austauschbare Lithium-Mangandioxid-Batterie (LiMnO₂), eine der stabilsten Lithium-Zellchemien. Öffnen Sie den Sensor nicht, durchstechen Sie ihn nicht und erhitzen Sie ihn nicht über +80 °C.
- Ist die Batterie leer, geben Sie den gesamten Sensor wie eine Batterie zum Recycling ab. Gegen Ende ihrer Lebensdauer bläht sich die Batterie normalerweise etwas auf; das ist normal.
7Fehlersuche
| Problem | Maßnahme |
|---|---|
| Meldet „belegt“, obwohl niemand im Raum ist | Nicht Personen, sondern etwas anderes verändert die Wärme, die der Sensor erfasst. Prüfen Sie, ob Sonne auf den Sensor oder in seine Nähe fällt, ob ein Heizkörper oder Heizgerät in der Nähe ist, ob Luft von Lüftung, Klimaanlage oder Wärmepumpe an ihm vorbeiströmt, ob sich in der Nähe eine Tür oder ein Fenster öffnet und ob Fenster, Fernseher oder andere warme Gegenstände im Sichtfeld liegen. Versetzen oder drehen Sie den Sensor (siehe „Montageort wählen“ im Kapitel Vorbereitung) oder erhöhen Sie den Occupied Level. Mit Decision Info sehen Sie die Messwerte, auf denen jede Entscheidung beruht. |
| Erkennt Personen nicht | Prüfen Sie, ob sich die Personen im Erfassungsbereich (±40°, bis zu 4 m) befinden und ob Hindernisse wie Stuhllehnen, Bildschirme oder Trennwände dazwischen stehen. Prüfen Sie, ob das linke Loch der Vorderseite (Infrarotsensor) frei ist. Ist alles in Ordnung, senken Sie den Entry Step oder den Occupied Level. |
| Bleibt „belegt“, nachdem alle gegangen sind | Der Sensor meldet den Raum als frei, wenn die Wärme abgeklungen ist, spätestens aber nach Ablauf der Quiet Release Time ohne jede Bewegung (standardmäßig eine Stunde). Ist Ihnen das zu lang, verkürzen Sie die Quiet Release Time. |
| „Belegt“ wird drei Minuten zu spät gemeldet | Fast Detection ist ausgeschaltet. Setzen Sie den Wert auf 1. |
| Keine Lichtmesswerte | Die Lichtmessung ist standardmäßig ausgeschaltet. Stellen Sie das Average Lux Report Interval ein. |
| Keine Temperatur oder Luftfeuchte | Stellen Sie sicher, dass das Temperature and Humidity Interval nicht auf 0 steht. Die ersten Mittelwerte kommen ein Intervall nach dem Beitritt an. |
| Keine oder ungenaue Position | Für eine Position brauchen Sie einen Cloud-Dienst, der Wi-Fi-Ortung unterstützt, etwa Yggio, und genügend 2,4-GHz-Access-Points, die der Dienst kennt. Netzwerke, die nur im 5-GHz-Band senden, erkennt der Sensor nicht. Siehe So funktioniert die Wi-Fi-Ortung. |
| Es passiert nichts, wenn ich das Smartphone an den Sensor halte | Prüfen Sie, ob NFC eingeschaltet und die Schutzhülle abgenommen ist. Legen Sie das Smartphone flach an die linke untere Ecke und bewegen Sie es langsam, bis es den Kontakt meldet. Halten Sie es dann ruhig (siehe NFC-Antennen finden). |
| Join-Request im Netzwerkserver, aber kein Join-Accept | Prüfen Sie die Schlüssel, die JoinEUI 70B3D52C0001D4C3, die LoRaWAN-Version (1.0.4), die Regionalparameter (RP002-1.0.3) und den Frequenzplan. In US915 und AU915 muss das Sub-Band zum Gateway passen. |
| Im Netzwerkserver kommt gar nichts an | Prüfen Sie, ob das Gateway eingeschaltet und online ist und ob sich der Sensor in Reichweite und nicht in einem geschlossenen Metallgehäuse befindet. Starten Sie dann wie in Schritt 3 einen neuen Beitritt per NFC. |
| „MIC mismatch“ | Die Schlüssel sind falsch. Prüfen Sie, ob sie zu diesem Sensor gehören und richtig eingegeben sind. |
| Nachrichten kommen an, aber der Decoder zeigt keine Messwerte | Meist fehlt dem Decoder die Anwendungsidentität. Senden Sie 00 auf Port 15 und prüfen Sie, ob der Decoder aktuell ist (siehe Welche Anwendung läuft im Sensor?). |
| Die Hugin-App verliert die Verbindung | Halten Sie das Smartphone ruhig, bis die App fertig ist (siehe NFC-Antennen finden). |
| Eine neue Einstellung wirkt nicht | Ein Downlink kommt erst nach der nächsten Nachricht des Sensors an, in einem stark ausgelasteten Netzwerk auch später (siehe Einstellungen ändern). Prüfen Sie, ob er noch in der Warteschlange steht und ob er für die rulesCrc32 erzeugt wurde, die Ihr Sensor meldet. |
| Nachrichten fehlen oder kommen unregelmäßig | Prüfen Sie RSSI und SNR. Möglicherweise ist der Sensor zu weit vom Gateway entfernt oder von Metall umschlossen. Einzelne Kanäle können auch durch Störungen im selben Frequenzband beeinträchtigt sein, etwa durch einen nahen Mobilfunksender oder ein RFID-Lesegerät. |
8Technische Referenz
Für Integratoren. Die folgenden Werte gelten für die Anwendung Presence November 2026. Andere Versionen können abweichen. Die Werte für Ihre Version finden Sie in der VSM-Anwendungsdokumentation oder im VSM Configuration Tool.
Welche Anwendung läuft im Sensor?
Direkt nach dem Beitritt sendet der Sensor auf Port 15 seine Anwendungsidentität, die rulesCrc32. Der Decoder wählt damit die passende Übersetzung, und Sie brauchen sie, um die richtigen Downlinks zu erzeugen. Für diese Anwendung lautet sie:
| Anwendung | Presence |
| Version | November 2026 |
| rulesCrc32 | 631566706 (hex 25A4F172) |
| Frühere Version | Presence 2026, rulesCrc32 4228601043: siehe Revision A dieses Handbuchs |
Haben Sie die Nachricht verpasst, senden Sie 00 auf Port 15; der Sensor sendet seine Identität dann erneut. Vor Ort zeigt auch die Hugin NFC-App die Anwendung und ihre Version an.
Alternative Anwendungen: Neben Presence kann Sensative weitere VSM-Anwendungen für dieselbe Hardware anbieten. Sie sind in der Hugin NFC-App (Android) verfügbar und können auch über LoRaWAN in den Sensor geladen werden. Fragen Sie bei Sensative nach, welche Anwendungen zu Ihrem Einsatz passen. Fragen Sie nach einem Wechsel die Identität mit 00 auf Port 15 ab und verwenden Sie die Dokumentation der neuen Anwendung.
LoRaWAN und Ports
| LoRaWAN | MAC 1.0.4, Regionalparameter RP002-1.0.3, Klasse A, OTAA, max. EIRP 14 dBm |
| JoinEUI | 70B3D52C0001D4C3 (alle Square- und Puck-Sensoren) |
| Port | Richtung | Inhalt |
|---|---|---|
| 1 | Uplink | Belegung, Temperatur, Luftfeuchte, Licht und Batterie sowie bei eingeschalteter Decision Info die Entscheidungsdaten (siehe Nachrichten) |
| 12 | Uplink | Gespeicherte Messwerte: eine Nachricht, die der Sensor ohne Netzwerkverbindung gespeichert hat und später mit dem Zeitpunkt der Messung sendet |
| 15 | Uplink | Anwendungsidentität (rulesCrc32), als erste Nachricht nach einem Beitritt |
| 15 | Downlink | 00 fordert den Sensor auf, seine Anwendungsidentität erneut zu senden |
| 23 | Uplink | Wi-Fi-Scan zur Ortung |
| 2 | Downlink | Einstellungen und Leseanfragen (siehe Einstellungen auf Port 2) |
| 2 | Uplink | Antwort des Sensors mit den nun gültigen Werten |
| 7 | Downlink | Eine vollständige Konfiguration in einer Payload (siehe Vollständige Konfiguration auf Port 7) |
| 7 | Uplink | Status dieser Konfiguration: None, Applied, Error oder Dirty |
Nachrichten
Jede Ausgabe hat eine ID und einen Skalierungsfaktor. „Bestätigte“ Ausgaben quittiert der Netzwerkserver.
| Ausgabe | ID | Größe und Skalierung | Einheit | Bestätigt | Sendezeitpunkt |
|---|---|---|---|---|---|
| presence | 80 | 1 Byte | 0 = frei, 1 = belegt | Ja | Wenn der Raum zwischen frei und belegt wechselt |
| averageTemp | 90 | 2 Byte, × 0,01 | °C | Ja | Nach jedem Temperature and Humidity Interval |
| averageHumidity | 91 | 2 Byte, × 0,01 | % rF | Ja | Nach jedem Temperature and Humidity Interval, wenn sich der Wert geändert hat |
| averageLux | 92 | 2 Byte | Lux | Ja | Nach jedem Average Lux Report Interval, wenn sich der Wert geändert hat (standardmäßig aus) |
| batteryPercent | 81 | 1 Byte | % (geschätzt) | Ja | Einmal pro Woche |
| dbgState | A0 | 1 Byte | 1 Free, 2 AimBusy, 3 Busy, 4 AimFree | Nein | Nur bei eingeschalteter Decision Info: bei jedem Zustandswechsel |
| dbgTObject, dbgBaseline, dbgBusyLevel, dbgTPresence, dbgTMotion, dbgMotionLevel | B9 BB BC BA B2 B3 | 2 oder 4 Byte | Infrarot-Rohwerte | Nein | Nur bei eingeschalteter Decision Info: die der Entscheidung zugrunde liegenden Messwerte, zusammen mit dem Zustand |
Einstellungen
Die Standardwerte sind die Werte, mit denen der Sensor startet. Die ID verwenden Sie in einem Port-2-Downlink. Alle Einstellungen dieser Anwendung sind ganze Zahlen und werden unverändert gesendet.
| Einstellung | Name in der Anwendung | ID | Funktion | Einheit | Wertebereich | Standard |
|---|---|---|---|---|---|---|
| Fast Detection | pirFastDetect | A4 | 1: Der Sensor meldet den Raum als belegt, sobald er eine Person erkennt. 0: Der Sensor wartet zuvor drei Minuten. | ein/aus | 0–1 | 1 |
| Entry Step | pirPromoteDelta | B4 | Wie stark der Infrarotmesswert zwischen zwei Messungen springen muss, damit der Sensor eine eintretende Person erkennt. Bei einem niedrigeren Wert reagiert er schon auf kleinere Änderungen. | Infrarot-Rohwerte | 1–32.767 | 200 |
| Occupied Level | pirLevelMin | B5 | Um wie viel wärmer als der leere Raum das Sichtfeld sein muss, damit der Raum als belegt gilt. Bei einem niedrigeren Wert reagiert der Sensor schon auf kleinere Änderungen. | Infrarot-Rohwerte | 1–32.767 | 150 |
| Release Level | pirReleaseQ | A3 | Welcher Anteil der durch die Belegung entstandenen Wärme verschwunden sein muss, bevor der Raum als frei gemeldet wird, in Prozent. | % | 1–100 | 25 |
| Quiet Release Time | pirQuietRelease | BE | Wie lange der Raum ohne erkannte Bewegung als belegt gilt, bevor er als frei gemeldet wird. 0 schaltet diese Funktion ab. | Sekunden | 0–65.535 | 3.600 |
| Decision Info | pirDecisionInfo | A5 | 1: Bei jedem Zustandswechsel zusätzlich den Zustand und die zugrunde liegenden Messwerte senden, auch bei Wechseln, die die Belegung nicht ändern. 0: Nur Belegungswechsel senden. Dient zur Feinabstimmung für einen Raum; jede zusätzliche Nachricht kostet Batterie. | ein/aus | 0–1 | 0 |
| Temperature and Humidity Interval | averageTempHumIntervalMinutes | B6 | Zeitraum, über den Temperatur und Luftfeuchte vor dem Senden gemittelt werden. 0 schaltet Temperatur und Luftfeuchte ab; die Sensoren werden dann nicht ausgelesen und es wird nichts gesendet. | Minuten | 0–32.000 | 60 |
| Average Lux Report Interval | averageLuxIntervalMinutes | B7 | Wie oft die mittlere Helligkeit berechnet und – wenn sie sich geändert hat – gesendet wird. 0 schaltet die Lichtmessung ab; der Lichtsensor wird dann nicht ausgelesen und es wird nichts gesendet. | Minuten | 0–32.000 | 0 |
| Daily Wifi Scan | wifiScanDaily | A6 | Mit 1 führt der Sensor einmal täglich einen Wi-Fi-Scan zur Ortung durch, solange er dem Netzwerk beigetreten ist. 0 schaltet den Scan ab. | ein/aus | 0–1 | 1 |
Geräteregister
Diese Register gehören zur Firmware des Sensors, nicht zur Anwendung. Die Anwendung nutzt sie aber, und Sie können sie auf dieselbe Weise ändern. Lassen Sie sie unverändert, solange Sie keinen Grund für eine Änderung haben.
| Register | Name | ID | Funktion | Einheit | Wertebereich | Standard |
|---|---|---|---|---|---|---|
| Downlink Timeout | LINKCHECK_TIME | D0 | Wie lange der Sensor nichts vom Netzwerk empfängt, bevor er das Netzwerk aufgibt und nicht mehr beigetreten ist. Jeder Downlink, auch eine Quittung, startet die Zeit neu. Ab der Hälfte dieser Zeit wird jeder Uplink bestätigt gesendet, ab 80 % sendet der Sensor zusätzlich eigene Link-Checks. Mit 0 wird die Prüfung abgeschaltet. | Sekunden | 300–2.592.000 | 345.600 (vier Tage) |
| Device Time Max Age | DEVICE_TIME_MAX_AGE | CD | Wie lange der Sensor seiner Uhr vertraut. Ab der Hälfte dieser Zeit fragt er das LoRaWAN-Netzwerk mit der Standardanfrage DeviceTime (DeviceTimeReq, ab LoRaWAN 1.0.3) nach der Uhrzeit, zuerst nach einer Minute, dann in sich jeweils verdoppelnden Abständen bis etwa 68 Stunden, bis er eine Antwort erhält. Der Netzwerkserver muss DeviceTime-Anfragen beantworten. Mit 0 wird diese Funktion abgeschaltet. Der Sensor hat dann keine Uhrzeit, und Messwerte, die ohne Netzwerkverbindung erfasst werden, werden nicht gespeichert. | Sekunden | 0–4.294.967.295 | 2.592.000 (30 Tage) |
Netzwerk verlassen
Damit Square Presence das Netzwerk sofort verlässt, schreiben Sie 1 (nicht beigetreten) in das Register DEVICE_STATE: Senden Sie C8 00 00 00 01 auf Port 2 (Base64 yAAAAAE=). Der Sensor tritt danach auf dieselbe Weise wieder bei wie nach einem Verbindungsverlust (siehe Netzwerk). Messwerte, die anfallen, während er nicht beigetreten ist, werden gespeichert und nach dem erneuten Beitritt gesendet.
Freigegebene Profile
Für diese Anwendung sind keine fertigen Profile freigegeben. Der Sensor startet mit den Standardwerten aus der Einstellungstabelle. Um sie zu ändern, verwenden Sie Custom im VSM Configuration Tool.
Einstellungen auf Port 2
Ein Port-2-Downlink ist eine Liste von Datensätzen mit je 5 Byte: ein Byte für die ID der Einstellung, danach der Wert als vorzeichenbehaftete 32-Bit-Ganzzahl, höchstwertiges Byte zuerst. Alle Werte dieser Anwendung sind ganze Zahlen: Eine Quiet Release Time von 30 Minuten wird als 1800 (Sekunden) gesendet. Negative Werte werden im Zweierkomplement geschrieben, aus −10 wird also FF FF FF F6. Der Sensor übernimmt die Werte und antwortet auf Port 2 mit den nun gültigen Werten.
Werte auslesen
Ein Port-2-Downlink mit einem bis vier Byte ist eine Leseanfrage. Der Sensor sendet dann für jede darin enthaltene ID den aktuellen Wert zurück.
| Port-2-Downlink | Antwort des Sensors |
|---|---|
04 | Aktuelle Lufttemperatur in Hundertstel Grad |
05 | Aktuelle Luftfeuchte in Hundertstel Prozent |
0B | Aktuelle Helligkeit in Lux |
BE | Die aktuell eingestellte Quiet Release Time (mit jeder anderen Einstellungs-ID funktioniert es genauso) |
Vollständige Konfiguration auf Port 7
Das VSM Configuration Tool kann eine Konfiguration auch in eine einzige Port-7-Payload packen. Sie beginnt mit der CRC der Anwendung und endet mit einer Prüfsumme der Konfiguration (configCrc32). Das Ergebnis meldet der Sensor auf Port 7: None, Applied, Error oder Dirty.
Beispiel 1: Lichtmessung und häufigere Klimawerte
Die Lichtmessung wird mit einem Mittelwert alle 15 Minuten eingeschaltet, und Temperatur und Luftfeuchte werden über 30 statt 60 Minuten gemittelt. Beide Beispiele folgen dem oben beschriebenen Datensatzformat und wurden mit dem Open-Source-VSM-Translator geprüft. Senden Sie jedes als Port-2-Downlink.
| Einstellung | Wert | Gesendet als | Datensatz |
|---|---|---|---|
| Average Lux Report Interval | 15 min | 15 | B7 00 00 00 0F |
| Temperature and Humidity Interval | 30 min | 30 | B6 00 00 00 1E |
| Port 2 (hex) | B7 00 00 00 0F B6 00 00 00 1E |
| Port 2 (base64) | twAAAA+2AAAAHg== |
Beispiel 2: Kürzere Wartezeit im Besprechungsraum
Der Raum wird schon nach 30 Minuten ohne Bewegung als frei gemeldet statt nach einer Stunde.
| Einstellung | Wert | Gesendet als | Datensatz |
|---|---|---|---|
| Quiet Release Time | 30 min | 1800 | BE 00 00 07 08 |
| Port 2 (hex) | BE 00 00 07 08 |
| Port 2 (base64) | vgAABwg= |
9Technische Daten
| Sensoren | Infrarot (Anwesenheit und Bewegung), Temperatur, Luftfeuchte, Umgebungslicht |
| Erkennung | Bis zu 4 m, Sichtfeld ±40° |
| Genauigkeit Temperatur | ±0,2 °C |
| Genauigkeit Luftfeuchte | ±1,8 % rF |
| Funk | LoRaWAN 1.0.4, Klasse A, OTAA; JoinEUI 70B3D52C0001D4C3 |
| Frequenzpläne | EU868 · US915 · AU915 · AS923-1 · AS923-2 · KR920 · IN865 |
| Reichweite | Bis zu 10 km bei Sichtverbindung |
| Konfiguration | NFC (Android) und per Funk |
| Anwendung | VSM-Anwendung Presence (November 2026), rulesCrc32 631566706 |
| Speicher | Integrierter Datenspeicher; Übertragung per LoRaWAN, sobald der Sensor wieder verbunden ist |
| Ortung | Wi-Fi-Ortung über einen Cloud-Dienst |
| Batterie | Fest eingebaut, LiMnO2, 4.000 mAh, weit über zehn Jahre |
| Schutzart | IP30, Innenbereich |
| Betriebstemperatur | −20 bis +60 °C |
| Abmessungen | 58 × 58 × 15 mm |
| Gewicht | 55 g |
| Montage | Klebefläche oder optionales Square-Schraubmontage-Set |
10Support
- VSM Configuration Tool: vsm-lora-config-app.service.sensative.net
- VSM-Anwendungsdokumentation für diese Version: github.com/Sensative/vsm-application-documentation
- Munin MQTT-Client und Decoder (Open Source): github.com/Sensative/vsm-mqtt-client-open-source
- VSM-Translator (Open Source): github.com/Sensative/vsm-translator-open-source
- Hugin NFC-App: Sensative Docs
- Support, FAQ und Downloads: sensative.com/support
- Produktseite und Produktblatt: sensative.com/sensors/square-presence
- LoRaMESH/LoRaPOS: optional als VSM-App erhältlich
Quellen: Quellcode und Dokumentation der Anwendung im Repository vsm-applications von Sensative (Presence, 10. November 2026) und die Produktdefinitionen in dots-builds; der Open-Source-VSM-Translator; das Produktblatt zu Square Presence (Rev A, April 2026); technische Daten aus den Produktdaten auf sensative.com; Wi-Fi-Ortung: Semtech, Wi-Fi geolocation with LoRa Edge.