1Introduction
Square Presence détecte la présence de personnes dans une pièce et la transmet par LoRaWAN. Son capteur infrarouge perçoit la chaleur d’une personne dans un lobe de ±40°, jusqu’à 4 m. Il repère donc aussi bien quelqu’un qui entre que quelqu’un qui reste assis sans bouger à son bureau ou en réunion. Il mesure en outre la température, l’humidité et la luminosité ambiante. Le boîtier mesure 58 × 58 × 15 mm et convient aux locaux intérieurs secs (IP30). Sa face avant comporte deux petits trous : celui de gauche pour le capteur infrarouge, celui de droite pour l’entrée d’air.
Une mémoire intégrée enregistre les mesures lorsque le capteur n’a pas de réseau et les envoie par LoRaWAN dès que la connexion est rétablie, si bien qu’aucune donnée n’est perdue. Le positionnement Wi-Fi permet de savoir où se trouve chaque capteur. La batterie est intégrée (4 000 mAh) et dure bien plus de dix ans.
Le capteur fonctionne avec n’importe quel serveur réseau LoRaWAN (LoRaWAN 1.0.4, classe A, OTAA) et sa portée atteint 10 km en visibilité directe. Ce qu’il mesure, le moment où il transmet et le contenu de ses messages sont déterminés par une application exécutée dans le capteur, sur la Virtual Sensing Machine (VSM) de Sensative. Ce manuel décrit l’application Presence November 2026. Vous pouvez la configurer et la remplacer par une version plus récente, à distance ou par NFC. Sensative peut aussi proposer, pour le même capteur, d’autres applications VSM qui lui confient une autre tâche (voir Application installée dans le capteur).
Contenu de la boîte
- Square Presence, avec l’adhésif déjà posé au dos
Les clés (DevEUI et AppKey) sont fournies avec les informations de livraison. Le kit de fixation par vis Square est vendu séparément.
Éléments du capteur
2Avant de commencer
Un capteur LoRaWAN demande un peu plus de préparation qu’un capteur qui s’associe à une box domotique. Réunissez d’abord les éléments suivants :
Il vous faut
- Une passerelle LoRaWAN à portée, sous tension et connectée
- Un compte sur un serveur réseau LoRaWAN (par exemple The Things Network, ChirpStack, Loriot ou Actility), auquel la passerelle a été ajoutée
- Les clés du capteur, c’est-à-dire son DevEUI et son AppKey, qui figurent dans les informations de livraison. Le JoinEUI est le même pour tous les capteurs Square :
70B3D52C0001D4C3. - Un téléphone NFC pour démarrer le capteur. La plupart des smartphones en sont équipés ; sur iPhone, il faut une application de lecture NFC (voir Trouver les antennes NFC).
- Un décodeur de payload pour les capteurs VSM de Sensative, dans votre serveur réseau ou votre application (voir Décoder les messages)
Choisir l’emplacement
Le bon fonctionnement de Square Presence dépend de son emplacement. Vérifiez que l’endroit choisi respecte les trois règles suivantes.
Tenez-le à l’écart des sources de chaleur et de froid. Le capteur détecte la chaleur du corps, ce qui suppose un environnement stable. Ne le placez pas :
- au soleil
- près d’un radiateur ou d’un appareil de chauffage
- dans le flux d’air d’une ventilation, d’une climatisation ou d’une pompe à chaleur air-air
- sur un équipement dont la température varie, comme une centrale de ventilation
- près d’une porte ou d’une fenêtre dont l’ouverture modifie la température au niveau même du capteur
Orientez-le vers les personnes. Le capteur détecte les personnes dans un lobe de ±40°, jusqu’à 4 m.
- Fixez-le au mur, en général entre 1,5 et 1,8 m de hauteur, face aux personnes, de sorte que les occupants de la pièce se trouvent dans le lobe.
- Ne le dirigez pas vers une fenêtre, un téléviseur, un radiateur ou toute autre source de rayonnement thermique, qui peuvent provoquer de fausses détections.
Laissez-lui une vue dégagée sur les personnes.
- Placez-le de façon que le lobe couvre le mieux possible les personnes présentes dans la pièce.
- Ne laissez rien entre le capteur et les personnes : ni dossier de chaise, ni écran, ni cloison.
À respecter également :
- En intérieur uniquement : le capteur, classé IP30, est destiné aux locaux intérieurs secs.
- Les deux trous de la face avant dégagés : celui de gauche, le capteur infrarouge, doit avoir une vue dégagée ; celui de droite, l’entrée d’air, doit rester à l’air libre.
- Portée : jusqu’à 10 km en visibilité directe et dégagée, beaucoup moins à travers les murs et les planchers
- Le métal ne gêne pas : contrairement à Strips, un capteur Square peut être monté sur du métal sans grand effet sur la radio. Évitez seulement les enceintes métalliques fermées, comme une armoire en acier fermée.
Trouver les antennes NFC
Le NFC ne porte qu’à quelques centimètres. Posez donc le téléphone à plat contre le capteur, antenne contre antenne. Il faut savoir où se trouvent les deux antennes ; le plus simple est de déplacer lentement le téléphone au-dessus de la bonne zone jusqu’à ce qu’il signale le contact :
- Sur le capteur : en bas à gauche de la face avant, quand le logo se trouve le long du bord inférieur.
- Sur un téléphone Android (de préférence) : activez le NFC, ainsi que la vibration ou un son pour le NFC dans les paramètres du téléphone, pour être averti dès qu’il a trouvé le capteur. L’antenne se trouve généralement au dos, vers le haut, souvent près de l’appareil photo, mais son emplacement varie selon les modèles ; le manuel du téléphone ou le site du fabricant l’indique. Si vous ne la trouvez pas, déplacez lentement le dos du téléphone au-dessus du coin inférieur gauche du capteur jusqu’à ce qu’il vibre.
- Retirez la coque du téléphone : une coque de protection, surtout si elle est épaisse ou contient du métal ou un aimant, peut empêcher le contact NFC. Retirez-la le temps d’intervenir sur le capteur.
- Ensuite, ne bougez plus : pour lancer la connexion au réseau, maintenez le téléphone immobile au-dessus du capteur pendant environ 5 secondes. La vibration indique seulement que le téléphone a trouvé le capteur. Laissez le téléphone en place jusqu’à la fin de l’échange entre le capteur et l’application. Avec l’application Hugin, cela prend quelques secondes, car elle déverrouille d’abord le capteur via le serveur de Sensative. Si vous retirez le téléphone trop tôt, la liaison est coupée et il faut recommencer.
- Sur un iPhone : utilisez une application de lecture NFC, par exemple NFC Reader & Scanner sur l’App Store. Ouvrez-la et appuyez sur son bouton NFC pour qu’elle affiche Ready to Scan, avant d’approcher le capteur. L’antenne de l’iPhone se trouve sur le bord supérieur du dos. Tenez ce bord immobile contre le coin inférieur gauche du capteur. Une fois la lecture réussie, un lien web contenant le numéro de série du capteur s’ouvre. Le guide de connexion NFC pour iPhone (PDF) illustre chaque étape.
3Installation pas à pas
L’installation compte 8 étapes. Enregistrez le capteur dans le serveur réseau avant d’en approcher le téléphone. Connectez-le ensuite au réseau, vérifiez les réglages et montez-le en dernier.
Déballer
Contrôlez le capteur et repérez ses clés. Le capteur reste en veille tant qu’il n’a pas détecté de champ NFC.
Enregistrer le capteur dans le serveur réseau
- Dans votre serveur réseau, ajoutez un nouvel équipement terminal (end device) avec le mode d’activation OTAA.
- Utilisez les réglages LoRaWAN suivants : version MAC 1.0.4, paramètres régionaux RP002-1.0.3, PIRE max. 14 dBm et le plan de fréquences de votre région.
- Saisissez le DevEUI et l’AppKey indiqués dans les informations de livraison, ainsi que le JoinEUI
70B3D52C0001D4C3. Vérifiez-les soigneusement, car un seul caractère erroné suffit à faire échouer la connexion au réseau. - Configurez le décodage des messages (voir Décoder les messages).
Rejoindre le réseau par NFC
Tenez le téléphone au-dessus du coin inférieur gauche de la face avant de Square Presence et maintenez-le immobile pendant environ 5 secondes. Le capteur lance alors la connexion au réseau (voir Trouver les antennes NFC, y compris pour l’iPhone). Le téléphone peut afficher un lien web contenant le numéro de série du capteur ; inutile de l’ouvrir.
Vérifier le signal à l’emplacement de montage
Placez le capteur à l’endroit où il sera monté et observez ses messages dans le serveur réseau : la connexion, puis les premières transmissions.
Configurer (facultatif)
Square Presence est livré avec l’application Presence. Avec les réglages par défaut, il signale la pièce occupée dès qu’une personne est détectée, et libre lorsque la chaleur est retombée ou, au plus tard, après une heure sans aucun mouvement. Il calcule la moyenne de la température et de l’humidité sur 60 minutes et transmet le niveau de batterie une fois par semaine. La luminosité n’est pas transmise tant que vous n’avez pas réglé un Average Lux Report Interval. Ne modifiez les réglages que si vous avez d’autres besoins, par exemple des mesures de luminosité ou un délai plus court avant que la pièce soit signalée libre.
Pour savoir comment procéder, consultez Modifier les réglages, le tableau des réglages et les exemples.
Monter
Le bon fonctionnement de Square Presence dépend de son emplacement. Avant de le fixer, vérifiez que l’endroit respecte les règles indiquées dans Avant de commencer :
- Au mur, en général entre 1,5 et 1,8 m de hauteur
- Face avant tournée vers les personnes, qui se trouvent dans le lobe : ±40°, jusqu’à 4 m
- Rien entre le capteur et les personnes : ni dossier de chaise, ni écran, ni cloison
- Pas dirigé vers une fenêtre, un téléviseur, un radiateur ou toute autre source de rayonnement thermique
- Ni soleil, ni radiateur, ni appareil de chauffage au niveau du capteur, et pas dans le flux d’air d’une ventilation, d’une climatisation ou d’une pompe à chaleur
- Pas sur un équipement dont la température varie, ni à côté d’une porte ou d’une fenêtre qui modifie la température au niveau du capteur
Montez-le ensuite de l’une des deux façons suivantes :
- Adhésif : la surface doit être propre et sèche. Retirez le film protecteur de l’adhésif au dos et appuyez fermement le capteur contre la surface, face avant tournée vers les personnes.
- Vis, avec le kit de fixation par vis Square (vendu séparément), qui comprend deux plaques adhésives de 2 mm sur un gabarit de perçage. Servez-vous du gabarit pour marquer les trous, soit à côté du capteur, soit derrière lui pour qu’ils restent cachés (utilisez alors des vis à tête plate extra-basse). Vissez les plaques, face adhésive épaisse vers l’extérieur, côté capteur (pour laisser de la place aux têtes de vis), retirez les films protecteurs des plaques et du capteur, vérifiez l’alignement, puis appuyez fermement le capteur sur les plaques.
Tester
Entrez dans le champ de vision du capteur et restez-y. Avec les réglages par défaut, la pièce est aussitôt signalée occupée. Restez assis sans bouger quelques minutes : elle reste occupée. Quittez ensuite la pièce.
Mise en service
- Capteur enregistré dans le serveur réseau, avec le JoinEUI et la bonne région
- Capteur connecté au réseau par NFC, messages décodés
- Signal vérifié à l’emplacement définitif : SF9 ou mieux
- Réglages vérifiés, ou modifiés selon les besoins
- Capteur monté face aux personnes, à l’écart de la chaleur, du froid et des flux d’air, les deux trous de la face avant dégagés
- États « occupé » et « libre » reçus
4Utilisation du capteur
L’application Presence indique si la pièce est libre ou occupée et transmet le climat de la pièce : température et humidité moyennes, ainsi que la luminosité si vous l’activez. Les réglages indiqués en gras figurent dans le tableau des réglages.
Détection de la présence
Square Presence possède un capteur infrarouge derrière le trou de gauche de sa face avant (vu de face). Ce capteur perçoit la chaleur des personnes dans son champ de vision, un lobe de ±40° jusqu’à 4 m, et l’application l’interroge une fois par minute.
- Quelqu’un entre : la pièce est considérée comme occupée lorsque la mesure infrarouge augmente de plus de l’Entry Step entre deux mesures et dépasse de plus de l’Occupied Level le niveau de la pièce vide. Si Fast Detection est activé (réglage par défaut), le capteur signale aussitôt l’occupation ; sinon, il attend trois minutes.
- Quelqu’un reste immobile : trois minutes après le début d’une occupation, le capteur mémorise le niveau de chaleur de la pièce occupée. La pièce reste occupée tant que cette chaleur est présente, même si personne ne bouge.
- La pièce se vide : la pièce est signalée libre lorsqu’une part suffisante de la chaleur apportée par l’occupation a disparu, selon le Release Level. Elle est également signalée libre lorsqu’aucun mouvement n’a été détecté pendant le Quiet Release Time, soit une heure par défaut.
- Messages envoyés : un message en mode confirmé lorsque la pièce passe de libre à occupée ou inversement. Si Decision Info est activé, le capteur envoie aussi l’état et les mesures sur lesquelles il repose, ce qui sert à affiner les réglages pour une pièce.
Champ de vision et obstacles
Le capteur infrarouge voit à travers le trou de gauche de la face avant (vu de face) ; il lui faut une vue directe et dégagée sur les personnes à détecter. Ne recouvrez pas ce trou. Le trou de droite est l’entrée d’air ; il doit rester à l’air libre, ne le recouvrez donc pas non plus. Un dossier de chaise, un écran, une cloison ou une vitre entre le capteur et les personnes lui masque la vue, car l’infrarouge ne traverse pas le verre. Une fenêtre, un téléviseur, un radiateur ou toute autre source de rayonnement thermique dans le champ de vision peut provoquer de fausses détections, tout comme le soleil, un flux d’air ou une porte près du capteur (voir Choisir l’emplacement, dans Avant de commencer).
Température, humidité et luminosité
- Température et humidité : le capteur calcule la moyenne des deux sur le Temperature and Humidity Interval (60 minutes par défaut), puis envoie la température moyenne, ainsi que l’humidité moyenne si elle a changé. Les deux sont envoyées en mode confirmé. Réglez l’intervalle sur 0 pour désactiver la température et l’humidité ; les capteurs correspondants ne sont alors plus lus et rien n’est envoyé.
- Luminosité : désactivée par défaut. Réglez l’Average Lux Report Interval pour l’activer. Le capteur calcule alors la luminosité moyenne, en lux, sur cet intervalle et l’envoie en mode confirmé si elle a changé. Le capteur de luminosité se trouve derrière la face avant, à peu près au centre : ne recouvrez pas le centre de la face avant et n’y collez pas d’étiquette.
Batterie et position
Une fois par semaine, le capteur estime la charge restante de sa batterie et l’envoie en pourcentage, en mode confirmé. Cette estimation repose sur la durée de fonctionnement mesurée et sur l’énergie consommée par le processeur, la radio et les capteurs. Square Presence se localise uniquement par Wi-Fi. Une fois par jour, tant qu’il est connecté au réseau et que Daily Wifi Scan est activé (réglage par défaut), il recherche les points d’accès Wi-Fi et envoie le résultat s’il en a trouvé au moins deux. Un service de géolocalisation dans le cloud, comme celui de Yggio ou de Munin, convertit ce balayage en position. Un balayage consomme environ 22 mA pendant une à deux secondes ; désactivez-le là où la position ne sert à rien.
Données enregistrées
Les mesures prises lorsque le capteur n’a pas de réseau sont stockées dans sa mémoire, puis envoyées par LoRaWAN dès qu’il est de nouveau connecté, chacune avec son heure d’enregistrement. Pour les sorties confirmées, tout l’historique est conservé, jusqu’à saturation de la mémoire ; pour les sorties non confirmées, seule la dernière valeur l’est. L’application NFC Hugin ne peut pas lire ce journal. Les heures proviennent de l’horloge du capteur, qu’il règle d’après le réseau. Il demande l’heure dans le délai fixé par son Device Time Max Age (30 jours par défaut ; voir Registres de l’appareil). Sans heure, rien n’est enregistré.
Fonctionnement du positionnement Wi-Fi
- 2,4 GHz uniquement : la radio ne balaie que la bande des 2,4 GHz (2 412–2 484 MHz). Les réseaux qui émettent uniquement en 5 GHz ne sont pas détectés.
- Balayage passif : le capteur écoute les points d’accès Wi-Fi à proximité (802.11 b/g/n) et relève leur adresse MAC et la puissance de leur signal (RSSI). Il ne se connecte à aucun réseau, n’a besoin d’aucun mot de passe et n’envoie rien en Wi-Fi. Les adresses sont transmises dans le message LoRaWAN montant (uplink).
- Nombre de points d’accès : il en faut au moins 2 pour obtenir une position, et plus il y en a, meilleure elle est.
- Calcul de la position : il faut un service cloud qui prend en charge le positionnement Wi-Fi, par exemple Yggio (Munin et LoRa Cloud le permettent également). Ce service recherche les adresses dans une base de données de points d’accès cartographiés et renvoie la position.
- Précision : elle dépend du nombre de points d’accès connus à proximité et atteint en général 5 à 20 m en intérieur. Avec un ou deux seulement, attendez-vous à obtenir la zone plutôt que la pièce. L’ajout de points d’accès 2,4 GHz bon marché améliore la précision.
- Wi-Fi uniquement : Square Presence n’a pas de positionnement par satellite.
Réseau
- Messages confirmés : le serveur réseau acquitte les changements de présence, les moyennes et le niveau de batterie ; le capteur les renvoie si aucun acquittement n’arrive.
- Reconnexion : si le capteur n’est pas connecté au réseau, il tente de le rejoindre une fois toutes les 24 heures. Un contact NFC, comme à l’étape 3, déclenche immédiatement une tentative.
- Perte du réseau : le capteur abandonne le réseau s’il n’en reçoit rien pendant la durée du Downlink Timeout (quatre jours par défaut dans cette application ; voir Registres de l’appareil).
Décoder les messages
Les messages sont des enregistrements binaires compacts dont la signification dépend de la version de l’application. Décodez-les avec un décodeur compatible VSM :
- Yggio les décode avec son traducteur VSM intégré et mémorise la version d’application de chaque capteur.
- Autres plateformes : utilisez Munin, le client MQTT open source de Sensative. Il décode les messages quel que soit le serveur réseau, tient à jour l’état de l’appareil dont le décodeur a besoin ainsi que l’heure de l’appareil, et calcule les positions Wi-Fi.
- Votre propre intégration : le VSM translator open source est le décodeur qu’utilise Munin ; il est disponible sous forme de paquet Node. Il exige deux choses de votre part : pouvoir stocker au moins le rulesCrc32 de chaque capteur d’un message à l’autre, et être tenu à jour, car de nouvelles versions d’application sont publiées sans préavis. Si vous stockez le résultat complet du message précédent, les données enregistrées sont en outre correctement horodatées.
Modifier les réglages
Il existe deux méthodes : à distance, par des messages descendants (downlinks) envoyés depuis votre serveur réseau, ou sur place avec l’application NFC Hugin. Dans les deux cas, on commence généralement par le VSM Configuration Tool, qui génère les downlinks pour vous.
- Choisissez l’application : par son nom et sa version, ou par le rulesCrc32 du message que le capteur envoie sur le port 15 (voir Application installée dans le capteur).
- Choisissez une configuration : un profil publié de la Profile Library (aucun n’est publié pour cette application ; voir Profils publiés), ou Custom pour définir vos propres valeurs. Chaque réglage est présenté avec sa description, son unité et sa plage.
- Récupérez le résultat : un ou plusieurs downlinks pour le port 2, ou un payload unique pour le port 7, en hexadécimal ou en base64, à envoyer depuis votre serveur réseau. Vous pouvez aussi obtenir un QR code à scanner avec l’application NFC Hugin, qui écrit ensuite la configuration dans le capteur sur place.
5L’application NFC Hugin
Hugin est une application Android facultative qui permet d’intervenir sur le capteur sur place, par NFC. Elle nécessite un téléphone Android équipé du NFC et du GPS, ainsi qu’un compte utilisateur Yggio. Le capteur doit en outre être enregistré dans Yggio avec votre organisation comme propriétaire, car Hugin le vérifie auprès de Yggio avant de vous donner accès au capteur. Tenez le téléphone contre le capteur comme indiqué dans Trouver les antennes NFC. L’application affiche alors le numéro de série, l’application et sa version, l’état (par exemple connecté au réseau), la batterie, les informations de liaison et de région, et le DevEUI. Selon vos droits dans Yggio, elle peut lire et appliquer des profils de configuration, y compris un profil scanné sous forme de QR code depuis le VSM Configuration Tool, et mettre à jour l’heure et la position de l’appareil.
L’installation, la connexion au compte, le flashage et le dépannage sont décrits dans le manuel de l’application NFC Hugin.
6Entretien et retrait
Batterie
La batterie est intégrée (4 000 mAh) et dure bien plus de dix ans avec les réglages par défaut, sur un bon réseau (SF7–SF9). Des transmissions fréquentes et une liaison faible réduisent cette autonomie.
Retirer Square Presence
Glissez du fil dentaire derrière le capteur et sciez doucement l’adhésif.
Changer de serveur réseau
Supprimez l’appareil de l’ancien serveur réseau et ajoutez-le au nouveau. Le capteur abandonne l’ancien réseau lorsqu’il n’en a rien reçu pendant la durée du Downlink Timeout (quatre jours par défaut dans cette application), puis rejoint le nouveau de lui-même, puisqu’il tente une connexion une fois par jour. Un contact NFC, comme à l’étape 3, lance immédiatement la connexion. Avec l’application Hugin, vous pouvez aussi le redémarrer immédiatement (ON / OFF), mais les éventuels réglages personnalisés sont alors réinitialisés.
Stockage et mise au rebut
- Stockez les capteurs inutilisés entre +10 et +30 °C.
- Le capteur contient une batterie lithium-dioxyde de manganèse (LiMnO₂) non remplaçable, l’une des chimies au lithium les plus stables. N’ouvrez pas le capteur, ne le percez pas et ne le chauffez pas au-delà de +80 °C.
- Lorsque la batterie est vide, déposez le capteur entier dans un point de collecte des piles et batteries, pour recyclage. En fin de vie, il est normal que la batterie gonfle légèrement.
7Dépannage
| Problème | Solution |
|---|---|
| La pièce est signalée occupée alors qu’il n’y a personne | La chaleur que perçoit le capteur varie pour une autre raison que la présence de personnes. Recherchez du soleil sur le capteur ou à proximité, un radiateur ou un appareil de chauffage tout proche, un flux d’air provenant d’une ventilation, d’une climatisation ou d’une pompe à chaleur, une porte ou une fenêtre qui s’ouvre à proximité, ou encore une fenêtre, un téléviseur ou un autre objet chaud dans le champ de vision. Déplacez ou réorientez le capteur (voir Choisir l’emplacement, dans Avant de commencer), ou augmentez l’Occupied Level. Decision Info indique les mesures à l’origine de chaque décision. |
| Des personnes ne sont pas détectées | Vérifiez que les personnes se trouvent dans le lobe (±40°, jusqu’à 4 m) et que rien ne s’interpose : dossier de chaise, écran ou cloison. Vérifiez que le trou de gauche de la face avant, celui du capteur infrarouge, n’est pas recouvert. Si tout est en ordre, diminuez l’Entry Step ou l’Occupied Level. |
| La pièce reste occupée après le départ de tout le monde | La pièce est signalée libre lorsque la chaleur est retombée ou, au plus tard, au bout du Quiet Release Time sans aucun mouvement, soit une heure par défaut. Raccourcissez le Quiet Release Time si ce délai est trop long. |
| L’occupation est signalée avec trois minutes de retard | Fast Detection est désactivé. Réglez-le sur 1. |
| Aucune mesure de luminosité | La luminosité est désactivée par défaut. Réglez l’Average Lux Report Interval. |
| Aucune mesure de température ni d’humidité | Vérifiez que le Temperature and Humidity Interval n’est pas à 0. Les premières moyennes arrivent un intervalle après la connexion au réseau. |
| Pas de position, ou une position peu précise | Il faut un service cloud qui prend en charge le positionnement Wi-Fi, par exemple Yggio, et suffisamment de points d’accès 2,4 GHz connus de ce service ; les réseaux uniquement en 5 GHz ne sont pas détectés. Voir Fonctionnement du positionnement Wi-Fi. |
| Aucune réaction à l’approche du téléphone | Vérifiez que le NFC est activé et que la coque du téléphone est retirée. Posez le téléphone à plat contre le coin inférieur gauche et déplacez-le lentement jusqu’à ce qu’il signale le contact, puis maintenez-le immobile (voir Trouver les antennes NFC). |
| Join Request visible dans le serveur réseau, mais pas de Join Accept | Vérifiez les clés, le JoinEUI 70B3D52C0001D4C3, la version LoRaWAN (1.0.4), les paramètres régionaux (RP002-1.0.3) et le plan de fréquences. En US915 et AU915, la sous-bande doit correspondre à celle de la passerelle. |
| Rien du tout dans le serveur réseau | Vérifiez que la passerelle est sous tension et connectée, et que le capteur est à portée et ne se trouve pas dans une enceinte métallique fermée. Relancez ensuite la connexion par NFC, comme à l’étape 3. |
| « MIC mismatch » | Les clés sont erronées. Vérifiez qu’elles correspondent bien à ce capteur et qu’elles sont correctement saisies. |
| Les messages arrivent, mais le décodeur n’affiche aucune valeur | En général, le décodeur n’a pas reçu l’identité de l’application. Envoyez 00 sur le port 15 et vérifiez que le décodeur est à jour (voir Application installée dans le capteur). |
| L’application Hugin perd la connexion | Maintenez le téléphone immobile jusqu’à ce que l’application ait terminé (voir Trouver les antennes NFC). |
| Un nouveau réglage reste sans effet | Un downlink n’arrive qu’après le message suivant du capteur, voire plus tard sur un réseau chargé (voir Modifier les réglages). Vérifiez qu’il est toujours en file d’attente et qu’il a été généré pour le rulesCrc32 indiqué par votre capteur. |
| Messages manquants ou irréguliers | Vérifiez le RSSI et le SNR. Le capteur est peut-être trop loin de la passerelle, ou enfermé dans du métal. Certains canaux peuvent aussi être perturbés par des interférences sur la même bande de fréquences, provenant par exemple d’un émetteur de téléphonie mobile ou d’un lecteur RFID proche. |
8Référence technique
Cette partie s’adresse aux intégrateurs. Les valeurs ci-dessous concernent l’application Presence November 2026. D’autres versions peuvent différer ; pour la vôtre, consultez la documentation des applications VSM ou le VSM Configuration Tool.
Application installée dans le capteur
Juste après avoir rejoint le réseau, le capteur envoie l’identité de son application, le rulesCrc32, sur le port 15. Le décodeur s’en sert pour choisir la bonne traduction, et vous en avez besoin pour générer les bons downlinks. Pour cette application, les valeurs sont les suivantes :
| Application | Presence |
| Version | novembre 2026 |
| rulesCrc32 | 631566706 (hex 25A4F172) |
| Version précédente | Presence 2026, rulesCrc32 4228601043 : voir la révision A de ce manuel |
Si vous avez manqué ce message, envoyez 00 sur le port 15 et le capteur renverra son identité. L’application NFC Hugin affiche aussi l’application et sa version sur place.
Autres applications : outre Presence, Sensative peut proposer d’autres applications VSM pour le même matériel. Elles sont disponibles dans l’application NFC Hugin (Android) et peuvent aussi être chargées dans le capteur par LoRaWAN. Demandez à Sensative quelles applications conviennent à votre usage. Après un changement d’application, demandez l’identité en envoyant 00 sur le port 15 et reportez-vous à la documentation de la nouvelle application.
LoRaWAN et ports
| LoRaWAN | MAC 1.0.4, paramètres régionaux RP002-1.0.3, classe A, OTAA, PIRE max. 14 dBm |
| JoinEUI | 70B3D52C0001D4C3 (tous les capteurs Square et Puck) |
| Port | Sens | Contenu |
|---|---|---|
| 1 | Uplink | Présence, température, humidité, luminosité et batterie, ainsi que les informations de décision si elles sont activées (voir Messages) |
| 12 | Uplink | Données enregistrées : message stocké pendant que le capteur n’avait pas de réseau, envoyé plus tard avec son heure d’enregistrement |
| 15 | Uplink | Identité de l’application (rulesCrc32), premier message après la connexion au réseau |
| 15 | Downlink | 00 demande au capteur de renvoyer l’identité de son application |
| 23 | Uplink | Balayage Wi-Fi, pour le positionnement |
| 2 | Downlink | Réglages et demandes de lecture (voir Réglages sur le port 2) |
| 2 | Uplink | Réponse du capteur : les valeurs désormais en vigueur |
| 7 | Downlink | Configuration complète en un seul payload (voir Configuration complète sur le port 7) |
| 7 | Uplink | État de cette configuration : None, Applied, Error ou Dirty |
Messages
Chaque sortie possède un id et une échelle. Les sorties « confirmées » sont acquittées par le serveur réseau.
| Sortie | Id | Taille et échelle | Unité | Confirmée | Envoi |
|---|---|---|---|---|---|
| presence | 80 | 1 octet | 0 = libre, 1 = occupée | Oui | Lorsque la pièce passe de libre à occupée ou inversement |
| averageTemp | 90 | 2 octets, × 0,01 | °C | Oui | À chaque Temperature and Humidity Interval |
| averageHumidity | 91 | 2 octets, × 0,01 | % HR | Oui | À chaque Temperature and Humidity Interval, si la valeur a changé |
| averageLux | 92 | 2 octets | lux | Oui | À chaque Average Lux Report Interval, si la valeur a changé (désactivé par défaut) |
| batteryPercent | 81 | 1 octet | % (estimation) | Oui | Une fois par semaine |
| dbgState | A0 | 1 octet | 1 Free, 2 AimBusy, 3 Busy, 4 AimFree | Non | Uniquement si Decision Info est activé : à chaque changement d’état |
| dbgTObject, dbgBaseline, dbgBusyLevel, dbgTPresence, dbgTMotion, dbgMotionLevel | B9 BB BC BA B2 B3 | 2 ou 4 octets | unités infrarouges brutes | Non | Uniquement si Decision Info est activé : les mesures à l’origine de la décision, envoyées avec l’état |
Réglages
Les valeurs par défaut sont celles avec lesquelles le capteur démarre. L’id est celui qu’utilise un downlink sur le port 2. Tous les réglages de cette application sont des nombres entiers et sont envoyés tels quels.
| Réglage | Nom dans l’application | Id | Fonction | Unité | Plage | Valeur par défaut |
|---|---|---|---|---|---|---|
| Fast Detection | pirFastDetect | A4 | 1 : la pièce est signalée occupée dès qu’une personne est détectée. 0 : le capteur attend d’abord trois minutes. | marche/arrêt | 0–1 | 1 |
| Entry Step | pirPromoteDelta | B4 | Augmentation brusque de la mesure infrarouge, entre deux mesures, nécessaire pour que le capteur détecte l’entrée d’une personne. Plus la valeur est faible, plus le capteur réagit à de petites variations. | unités infrarouges brutes | 1–32 767 | 200 |
| Occupied Level | pirLevelMin | B5 | Écart de chaleur, par rapport à la pièce vide, nécessaire pour que la pièce soit considérée comme occupée. Plus la valeur est faible, plus le capteur réagit à de petites variations. | unités infrarouges brutes | 1–32 767 | 150 |
| Release Level | pirReleaseQ | A3 | Part de la chaleur apportée par l’occupation qui doit avoir disparu pour que la pièce soit signalée libre, en pourcentage. | % | 1–100 | 25 |
| Quiet Release Time | pirQuietRelease | BE | Durée pendant laquelle la pièce reste occupée sans qu’aucun mouvement soit détecté, avant d’être signalée libre. La valeur 0 désactive cette fonction. | secondes | 0–65 535 | 3 600 |
| Decision Info | pirDecisionInfo | A5 | 1 : à chaque changement d’état, envoyer aussi l’état et les mesures sur lesquelles il repose, y compris lors de changements qui ne modifient pas la présence. 0 : n’envoyer que les changements de présence. Sert à affiner les réglages pour une pièce ; chaque message supplémentaire consomme de la batterie. | marche/arrêt | 0–1 | 0 |
| Temperature and Humidity Interval | averageTempHumIntervalMinutes | B6 | Durée sur laquelle la température et l’humidité sont moyennées avant d’être envoyées. La valeur 0 désactive la température et l’humidité : les capteurs ne sont pas lus et rien n’est envoyé. | minutes | 0–32 000 | 60 |
| Average Lux Report Interval | averageLuxIntervalMinutes | B7 | Fréquence de calcul de la luminosité moyenne, qui est envoyée si elle a changé. La valeur 0 désactive la luminosité : le capteur n’est pas lu et rien n’est envoyé. | minutes | 0–32 000 | 0 |
| Daily Wifi Scan | wifiScanDaily | A6 | 1 : un balayage Wi-Fi est effectué une fois par jour tant que le capteur est connecté au réseau, pour le positionnement. 0 : le balayage est désactivé. | marche/arrêt | 0–1 | 1 |
Registres de l’appareil
Ces registres appartiennent au firmware du capteur et non à l’application, mais l’application les utilise et ils se modifient de la même manière. Ne les modifiez pas sans raison particulière.
| Registre | Nom | Id | Fonction | Unité | Plage | Valeur par défaut |
|---|---|---|---|---|---|---|
| Downlink Timeout | LINKCHECK_TIME | D0 | Durée pendant laquelle le capteur peut rester sans nouvelles du réseau avant de l’abandonner et de se retrouver déconnecté. Tout downlink, y compris un acquittement, relance le décompte. À partir de la moitié de cette durée, chaque uplink est envoyé en message confirmé ; à partir de 80 %, le capteur envoie aussi ses propres vérifications de liaison (link checks). La valeur 0 désactive la vérification. | secondes | 300–2 592 000 | 345 600 (quatre jours) |
| Device Time Max Age | DEVICE_TIME_MAX_AGE | CD | Durée pendant laquelle le capteur se fie à son horloge. À partir de la moitié de cette durée, il demande l’heure au réseau LoRaWAN au moyen de la requête standard DeviceTime (DeviceTimeReq, LoRaWAN 1.0.3 et versions ultérieures) : une première fois au bout d’une minute, puis à des intervalles qui doublent, jusqu’à environ 68 heures, tant qu’il n’a pas obtenu de réponse. Le serveur réseau doit répondre aux requêtes DeviceTime. La valeur 0 désactive cette fonction ; le capteur n’a alors pas d’heure, et les mesures prises sans réseau ne sont pas enregistrées. | secondes | 0–4 294 967 295 | 2 592 000 (30 jours) |
Quitter le réseau
Pour que Square Presence quitte immédiatement le réseau, écrivez 1 (non connecté) dans son registre DEVICE_STATE : envoyez C8 00 00 00 01 sur le port 2 (base64 yAAAAAE=). Il se reconnecte ensuite de la même façon qu’après une perte du réseau (voir Réseau). Les mesures effectuées pendant qu’il n’est pas connecté sont conservées et envoyées une fois la connexion rétablie.
Profils publiés
Aucun profil prêt à l’emploi n’a été publié pour cette application. Le capteur démarre avec les valeurs par défaut du tableau des réglages ; pour les modifier, choisissez Custom dans le VSM Configuration Tool.
Réglages sur le port 2
Un downlink sur le port 2 est une suite d’enregistrements de 5 octets chacun : un octet pour l’id du réglage, puis la valeur sous forme d’entier signé sur 32 bits, octet de poids fort en premier. Toutes les valeurs de cette application sont des nombres entiers ; ainsi, un Quiet Release Time de 30 minutes est envoyé sous la forme 1800 (secondes). Les valeurs négatives s’écrivent en complément à deux : −10 devient FF FF FF F6. Le capteur applique les valeurs et répond sur le port 2 en indiquant les valeurs désormais en vigueur.
Lire les valeurs
Un downlink d’un à quatre octets sur le port 2 constitue une demande de lecture : le capteur renvoie la valeur actuelle de chaque id qu’il contient.
| Downlink sur le port 2 | Réponse du capteur |
|---|---|
04 | Température actuelle de l’air, en centièmes de degré |
05 | Humidité actuelle de l’air, en centièmes de pour cent |
0B | Luminosité actuelle, en lux |
BE | Quiet Release Time actuellement réglé (le principe est le même pour tout id de réglage) |
Configuration complète sur le port 7
Le VSM Configuration Tool peut aussi regrouper une configuration dans un seul payload destiné au port 7. Celui-ci commence par le CRC de l’application et se termine par une somme de contrôle de la configuration (configCrc32). Le capteur indique le résultat sur le port 7 : None, Applied, Error ou Dirty.
Exemple 1 : mesure de la luminosité et relevés climatiques plus fréquents
Objectif : activer la luminosité, avec une moyenne toutes les 15 minutes, et calculer la moyenne de la température et de l’humidité sur 30 minutes au lieu de 60. Les deux exemples sont construits selon le format d’enregistrement décrit plus haut et vérifiés avec le VSM translator open source. Envoyez chacun d’eux sous forme de downlink sur le port 2.
| Réglage | Valeur | Valeur envoyée | Enregistrement |
|---|---|---|---|
| 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== |
Exemple 2 : délai plus court dans une salle de réunion
Objectif : signaler la pièce libre après 30 minutes sans mouvement, au lieu d’une heure.
| Réglage | Valeur | Valeur envoyée | Enregistrement |
|---|---|---|---|
| Quiet Release Time | 30 min | 1800 | BE 00 00 07 08 |
| Port 2 (hex) | BE 00 00 07 08 |
| Port 2 (base64) | vgAABwg= |
9Caractéristiques techniques
| Capteurs | Présence et mouvement par infrarouge, température, humidité, luminosité ambiante |
| Détection | Jusqu’à 4 m, champ de vision de ±40° |
| Précision de la température | ±0,2 °C |
| Précision de l’humidité | ±1,8 % HR |
| Radio | LoRaWAN 1.0.4, classe A, OTAA ; JoinEUI 70B3D52C0001D4C3 |
| Plans de fréquences | EU868 · US915 · AU915 · AS923-1 · AS923-2 · KR920 · IN865 |
| Portée | Jusqu’à 10 km en visibilité directe |
| Configuration | Par NFC (Android) et à distance |
| Application | Application VSM Presence (November 2026), rulesCrc32 631566706 |
| Mémoire | Journal de données intégré, transmis par LoRaWAN lorsque le capteur se connecte |
| Positionnement | Géolocalisation Wi-Fi via un service cloud |
| Batterie | LiMnO2 intégrée, 4 000 mAh, bien plus de dix ans |
| Indice de protection | IP30, usage intérieur |
| Température de fonctionnement | −20 à +60 °C |
| Dimensions | 58 × 58 × 15 mm |
| Poids | 55 g |
| Montage | Adhésif, ou kit de fixation par vis Square en option |
10Assistance
- VSM Configuration Tool : vsm-lora-config-app.service.sensative.net
- Documentation de l’application VSM pour cette version : github.com/Sensative/vsm-application-documentation
- Client MQTT et décodeur Munin (open source) : github.com/Sensative/vsm-mqtt-client-open-source
- VSM translator (open source) : github.com/Sensative/vsm-translator-open-source
- Application NFC Hugin : Sensative Docs
- Assistance, FAQ et téléchargements : sensative.com/support
- Page produit et fiche produit : sensative.com/sensors/square-presence
- LoRaMESH/LoRaPOS : disponible en option sous forme d’application VSM
Sources : sources et documentation des applications dans le dépôt vsm-applications de Sensative (Presence, 10 novembre 2026) et définitions de produits dans dots-builds ; VSM translator (open source) ; fiche produit de Square Presence (Rev A, avril 2026) ; caractéristiques issues des données produit de sensative.com ; positionnement Wi-Fi : Semtech, Wi-Fi geolocation with LoRa Edge.