Capteurs sans fil et Yggio, la couche de données opérationnelle ouverte pour les villes, les propriétaires immobiliers et les opérateurs de transport. Vos données, vos opérations, votre souveraineté.

LoRaWAN Manuel d’utilisation et d’installation

Square Presence pour LoRaWAN

Détection de présence par capteur infrarouge, avec température, humidité et luminosité, dans un boîtier carré de 58 mm fixé au mur. Ce manuel vous guide du carton à la mise en service du capteur, donne les règles de placement qui rendent la détection fiable et regroupe la référence technique à la fin.

Révision B · novembre 2026 · Sensative AB

Démarrage rapide Page produit Fiche produit (PDF)

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

Square Presence vu de côté et de face, avec deux petits trous de part et d’autre du logo
La face avant comporte deux trous, de part et d’autre du logo. Vu de face, le trou de gauche correspond au capteur de présence infrarouge, qui doit avoir une vue dégagée sur la pièce ; le trou de droite est l’entrée d’air, qui doit rester à l’air libre. Ne les recouvrez ni l’un ni l’autre. Le capteur de luminosité se trouve derrière la face avant, à peu près au centre, et non derrière un trou. La zone NFC se trouve en bas à gauche de la face avant : c’est là que vous placez le téléphone. Le dos porte l’adhésif et l’étiquette indiquant le modèle, la région et le numéro de série.

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 :

Le capteur émet par radio vers une passerelle, la passerelle transmet au serveur réseau, et le serveur réseau à votre application ; les réglages repartent en sens inverse par liaison descendante (downlink)

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.
Une pièce vue de dessus : Square Presence au mur, son lobe de ±40° et jusqu’à 4 m couvrant les bureaux ; le soleil, un radiateur, le flux d’air de la ventilation, une porte et un téléviseur sont barrés
Vue de dessus. Fixez Square Presence au mur, en général entre 1,5 et 1,8 m de hauteur, face aux personnes, le lobe tourné vers elles, à l’écart de la chaleur, du froid et des flux d’air.

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 :

L’antenne NFC du capteur se trouve en bas à gauche de la face avant ; celle du téléphone est souvent en haut du dos
  • 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.

1

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.

2

Enregistrer le capteur dans le serveur réseau

  1. Dans votre serveur réseau, ajoutez un nouvel équipement terminal (end device) avec le mode d’activation OTAA.
  2. 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.
  3. 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.
  4. Configurez le décodage des messages (voir Décoder les messages).
Terminé quand : l’appareil figure dans la liste du serveur réseau, en attente de sa première connexion.
3

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.

Enregistrez le capteur, tenez un téléphone NFC au-dessus du coin inférieur gauche, et le capteur rejoint le réseau en deux minutes environ
Terminé quand : le serveur réseau affiche la connexion, en général en moins de deux minutes.
Si le réseau n’est pas encore joignable, le capteur fait une nouvelle tentative une fois par jour. Une fois le réseau disponible, la connexion peut donc prendre jusqu’à 24 heures. Un nouveau contact NFC déclenche immédiatement une tentative.
4

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.

Valeurs de référence : la liaison doit fonctionner au moins en SF9. En règle générale, visez un SNR supérieur à −5 dB et un RSSI supérieur à −115 dBm, ce qui laisse une marge par rapport à la limite de SF9 (SNR d’environ −12,5 dB).
Si la liaison est plus faible, le débit adaptatif (ADR) du serveur réseau fait passer le capteur en SF10–SF12. Chaque message met alors beaucoup plus de temps à être émis, ce qui consomme de la batterie et de la capacité réseau. Si le capteur est encore en SF10–SF12 un jour après l’installation, améliorez la liaison : déplacez la passerelle ou le capteur, ou ajoutez une passerelle.
5

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.

6

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 :

  1. 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.
  2. 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.
Ne recouvrez aucun des deux trous de la face avant de ruban adhésif, de peinture ou d’étiquette. Le trou de gauche, celui du capteur infrarouge, doit avoir une vue dégagée sur la pièce : ne placez rien devant. Le trou de droite, l’entrée d’air, doit rester à l’air libre.
7

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.

Terminé quand : votre application reçoit l’état « occupé » lorsque vous entrez, puis « libre » après votre départ, au plus tard au bout du Quiet Release Time (une heure par défaut). Les premières moyennes de température et d’humidité arrivent au bout du Temperature and Humidity Interval.
8

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.

  1. 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).
  2. 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.
  3. 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.
Le capteur est un équipement de classe A : il reçoit un downlink juste après son uplink suivant. Un nouveau réglage prend donc effet au plus tôt après le message suivant du capteur, et sur un réseau chargé, le downlink peut mettre plus longtemps à passer. Tout réglage qui fait émettre le capteur plus souvent consomme de la batterie.

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èmeSolution
La pièce est signalée occupée alors qu’il n’y a personneLa 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éesVé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 mondeLa 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 retardFast 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éciseIl 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éphoneVé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 AcceptVé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éseauVé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 valeurEn 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 connexionMaintenez le téléphone immobile jusqu’à ce que l’application ait terminé (voir Trouver les antennes NFC).
Un nouveau réglage reste sans effetUn 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éguliersVé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 :

ApplicationPresence
Versionnovembre 2026
rulesCrc32631566706 (hex 25A4F172)
Version précédentePresence 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.

Les réglages, les ids et les valeurs par défaut sont propres à une version d’application. Si votre capteur indique un autre rulesCrc32, recherchez ce numéro dans la documentation des applications VSM ou dans le VSM Configuration Tool au lieu d’utiliser les tableaux de ce manuel. Les capteurs livrés avant la version de novembre 2026 exécutent Presence 2026, dont les ids et les valeurs par défaut diffèrent. Pour ces capteurs, utilisez la révision A de ce manuel jusqu’à leur mise à jour.

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

LoRaWANMAC 1.0.4, paramètres régionaux RP002-1.0.3, classe A, OTAA, PIRE max. 14 dBm
JoinEUI70B3D52C0001D4C3 (tous les capteurs Square et Puck)
PortSensContenu
1UplinkPrésence, température, humidité, luminosité et batterie, ainsi que les informations de décision si elles sont activées (voir Messages)
12UplinkDonnées enregistrées : message stocké pendant que le capteur n’avait pas de réseau, envoyé plus tard avec son heure d’enregistrement
15UplinkIdentité de l’application (rulesCrc32), premier message après la connexion au réseau
15Downlink00 demande au capteur de renvoyer l’identité de son application
23UplinkBalayage Wi-Fi, pour le positionnement
2DownlinkRéglages et demandes de lecture (voir Réglages sur le port 2)
2UplinkRéponse du capteur : les valeurs désormais en vigueur
7DownlinkConfiguration complète en un seul payload (voir Configuration complète sur le port 7)
7UplinkÉ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.

SortieIdTaille et échelleUnitéConfirméeEnvoi
presence801 octet0 = libre, 1 = occupéeOuiLorsque la pièce passe de libre à occupée ou inversement
averageTemp902 octets, × 0,01°COuiÀ chaque Temperature and Humidity Interval
averageHumidity912 octets, × 0,01% HROuiÀ chaque Temperature and Humidity Interval, si la valeur a changé
averageLux922 octetsluxOuiÀ chaque Average Lux Report Interval, si la valeur a changé (désactivé par défaut)
batteryPercent811 octet% (estimation)OuiUne fois par semaine
dbgStateA01 octet1 Free, 2 AimBusy, 3 Busy, 4 AimFreeNonUniquement si Decision Info est activé : à chaque changement d’état
dbgTObject, dbgBaseline, dbgBusyLevel, dbgTPresence, dbgTMotion, dbgMotionLevelB9 BB BC BA B2 B32 ou 4 octetsunités infrarouges brutesNonUniquement 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églageNom dans l’applicationIdFonctionUnitéPlageValeur par défaut
Fast DetectionpirFastDetectA41 : 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êt0–11
Entry SteppirPromoteDeltaB4Augmentation 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 brutes1–32 767200
Occupied LevelpirLevelMinB5É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 brutes1–32 767150
Release LevelpirReleaseQA3Part de la chaleur apportée par l’occupation qui doit avoir disparu pour que la pièce soit signalée libre, en pourcentage.%1–10025
Quiet Release TimepirQuietReleaseBEDuré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.secondes0–65 5353 600
Decision InfopirDecisionInfoA51 : à 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êt0–10
Temperature and Humidity IntervalaverageTempHumIntervalMinutesB6Duré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é.minutes0–32 00060
Average Lux Report IntervalaverageLuxIntervalMinutesB7Fré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é.minutes0–32 0000
Daily Wifi ScanwifiScanDailyA61 : 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êt0–11

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.

RegistreNomIdFonctionUnitéPlageValeur par défaut
Downlink TimeoutLINKCHECK_TIMED0Duré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.secondes300–2 592 000345 600 (quatre jours)
Device Time Max AgeDEVICE_TIME_MAX_AGECDDuré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.secondes0–4 294 967 2952 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.

Square Presence n’acquitte pas ce downlink, même envoyé en mode confirmé : il ne déclenche donc pas de boucle de renvois. Envoyez-le tout de même en mode non confirmé.

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.

Les ids sont propres à une version d’application. Une autre version peut attribuer le même id à un autre réglage, si bien qu’un downlink généré pour une version risque de modifier le mauvais réglage dans une autre. Générez toujours le downlink pour le rulesCrc32 indiqué par le capteur lui-même.

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 2Réponse du capteur
04Température actuelle de l’air, en centièmes de degré
05Humidité actuelle de l’air, en centièmes de pour cent
0BLuminosité actuelle, en lux
BEQuiet 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églageValeurValeur envoyéeEnregistrement
Average Lux Report Interval15 min15B7 00 00 00 0F
Temperature and Humidity Interval30 min30B6 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églageValeurValeur envoyéeEnregistrement
Quiet Release Time30 min1800BE 00 00 07 08
Port 2 (hex)BE 00 00 07 08
Port 2 (base64)vgAABwg=

9Caractéristiques techniques

CapteursPrésence et mouvement par infrarouge, température, humidité, luminosité ambiante
DétectionJusqu’à 4 m, champ de vision de ±40°
Précision de la température±0,2 °C
Précision de l’humidité±1,8 % HR
RadioLoRaWAN 1.0.4, classe A, OTAA ; JoinEUI 70B3D52C0001D4C3
Plans de fréquencesEU868 · US915 · AU915 · AS923-1 · AS923-2 · KR920 · IN865
PortéeJusqu’à 10 km en visibilité directe
ConfigurationPar NFC (Android) et à distance
ApplicationApplication VSM Presence (November 2026), rulesCrc32 631566706
MémoireJournal de données intégré, transmis par LoRaWAN lorsque le capteur se connecte
PositionnementGéolocalisation Wi-Fi via un service cloud
BatterieLiMnO2 intégrée, 4 000 mAh, bien plus de dix ans
Indice de protectionIP30, usage intérieur
Température de fonctionnement−20 à +60 °C
Dimensions58 × 58 × 15 mm
Poids55 g
MontageAdhésif, ou kit de fixation par vis Square en option

10Assistance

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.