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 Comfort pour LoRaWAN

Température et humidité dans un boîtier carré de 58 mm, de 7 mm d’épaisseur seulement, avec une batterie de 750 mAh. Ce manuel vous guide du carton à la mise en service du capteur et regroupe la référence technique à la fin.

Révision C · novembre 2026 · Sensative AB

Démarrage rapide Page produit Fiche produit (PDF)

1Introduction

Square Comfort mesure la température et l’humidité relative et les transmet par LoRaWAN. Il mesure 58 × 58 × 7 mm. Sa face avant est lisse, sans aucun trou visible, car l’air atteint le capteur par de petits évents protégés par une membrane. Ces évents sont logés dans un décrochement en retrait, à l’arrière des bords latéraux, à raison de trois trous à chacun des deux coins opposés en diagonale. Une fois le capteur fixé au mur, on ne les voit plus, mais l’air y parvient toujours par l’interstice. Square Comfort convient aux bureaux, aux logements, aux serres, aux véhicules et aux espaces extérieurs abrités.

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 (750 mAh) et dure bien plus de dix ans. Pour des transmissions très fréquentes, il existe Square Comfort L, d’une épaisseur de 15 mm, avec 4 000 mAh (voir le manuel de Square Comfort L).

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 Square-comfort 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 Comfort, 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

Face avant de Square avec la zone NFC en bas à gauche ; dos avec l’adhésif, l’étiquette et les évents logés à l’arrière des bords, à deux coins opposés
La zone NFC se trouve en bas à gauche de la face avant : c’est là que vous placez le téléphone. L’air atteint le capteur par des évents logés dans un décrochement en retrait, à l’arrière des bords latéraux, avec trois trous à chacun des deux coins opposés en diagonale. Ils sont cachés contre le mur, mais doivent rester dégagés. 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

  • Pour le climat d’une pièce : un mur intérieur, à hauteur des yeux, là où l’air circule librement autour du capteur
  • À l’écart du soleil direct, des radiateurs, des autres sources de chaleur et des courants d’air
  • En intérieur ou en extérieur abrité : le capteur est IP63
  • 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.
Square fixé sur un mur intérieur à hauteur des yeux, loin d’une fenêtre ensoleillée et d’un radiateur

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 Comfort 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 Comfort est livré avec une application de confort polyvalente. Avec les réglages par défaut, il transmet la température lorsqu’elle varie de 0,5 °C, la température moyenne toutes les 60 minutes et l’humidité lorsqu’elle varie de 2 %, et déclenche une alarme en dessous de 2 °C et au-dessus de 60 °C. Ne modifiez les réglages que si vous avez d’autres besoins, par exemple pour un suivi plus fin ou des seuils d’alarme adaptés à une chambre froide, ou bien choisissez l’un des profils publiés, Indoor ou Outdoor.

Pour savoir comment procéder, consultez Modifier les réglages, le tableau des réglages et les exemples.

6

Monter

Deux méthodes sont possibles :

  1. Adhésif : la surface doit être propre et sèche. Retirez le film protecteur de l’adhésif au dos, puis appuyez fermement le capteur contre la surface.
  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.
N’appliquez ni mastic, ni peinture, ni ruban adhésif sur les bords du capteur, car c’est là que se trouvent les évents, à l’arrière, à deux coins. Ne les recouvrez pas de ruban adhésif ni de peinture.
7

Tester

Soufflez sur le capteur ou gardez-le dans la main pendant une minute. La température et l’humidité montent alors au-delà des seuils.

Terminé quand : de nouvelles valeurs de température et d’humidité arrivent dans votre application.
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é à hauteur des yeux sur un mur intérieur, évents dégagés
  • Température et humidité reçues

4Utilisation du capteur

L’application relève la température et l’humidité à intervalles réguliers et envoie une mise à jour lorsqu’une valeur a varié de plus d’un seuil donné. Les réglages indiqués en gras figurent dans le tableau des réglages.

Température

  • Le capteur relève la température toutes les minutes.
  • Lorsqu’elle a varié de plus du Temperature Threshold depuis la dernière valeur envoyée, le capteur envoie la nouvelle mesure.
  • À chaque Average Temperature Interval, il envoie la température moyenne, qu’elle ait changé ou non.
  • Au-dessus du Temperature High Alarm Level, l’état d’alarme passe à « haut » ; en dessous du Temperature Low Alarm Level, il passe à « bas ». L’alarme est envoyée en message confirmé. Si le seuil bas n’est pas inférieur au seuil haut, l’alarme est désactivée.

Humidité

  • Le capteur mesure l’humidité toutes les minutes.
  • Lorsque l’humidité a varié de plus du Humidity Threshold, il envoie la nouvelle mesure.
  • À chaque Humidity Interval, il calcule l’humidité moyenne et l’envoie en message confirmé si elle a varié de plus de ce même seuil.
Si l’humidité dépasse 100 % (en cas de rosée, par exemple), les mesures suivantes peuvent être nettement faussées jusqu’à ce que le capteur ait séché.

Batterie et position

Une fois par semaine, le capteur estime la charge restante de sa batterie et l’envoie sous forme de pourcentage. Cette estimation repose sur la durée de fonctionnement mesurée et sur l’énergie consommée par le processeur, la radio, les capteurs et les balayages de positionnement. Square Comfort se localise uniquement par Wi-Fi. Une fois par jour, tant qu’il est connecté au réseau, il recherche les points d’accès Wi-Fi et envoie le résultat. Un service de géolocalisation dans le cloud, comme celui de Yggio ou de Munin, convertit ce balayage en position.

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 Comfort n’a pas de positionnement par satellite.

Réseau et itinérance

  • Messages confirmés : le serveur réseau acquitte les alarmes et l’humidité moyenne ; 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 (24 heures par défaut ; voir Registres de l’appareil).
  • Itinérance : le capteur peut être enregistré dans 15 réseaux LoRaWAN au maximum, par ordre de priorité. Enregistrez-le dans chacun avec le même DevEUI et le même JoinEUI, en incrémentant le dernier chiffre de l’AppKey : …00 pour le premier réseau, …01 pour le deuxième, et ainsi de suite. Réglez ensuite le Roaming Network Count. Si le capteur perd son réseau, il essaie le suivant, et ainsi de suite. Toutes les 24 heures, il recommence par le premier. Avec plusieurs réseaux, chaque connexion prend plus de temps et consomme plus d’énergie.
  • Débit adaptatif : le capteur suit le débit adaptatif (ADR) du serveur réseau, qui fixe son débit de données et sa puissance d’émission. S’il perd le contact avec le réseau, il réduit progressivement son débit jusqu’à atteindre de nouveau le réseau.

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 (pour cette application, Indoor et Outdoor ; 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 (750 mAh) et dure bien plus de dix ans avec les configurations prédéfinies de Sensative, sur un bon réseau (SF7–SF9). Des transmissions fréquentes et une liaison faible réduisent cette autonomie.

Retirer Square Comfort

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. La vérification de liaison du capteur échoue alors : il quitte l’ancien réseau et rejoint le nouveau. Cela prend généralement un à deux jours. 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
L’humidité mesurée est trop élevée après une condensationDe l’eau sur le capteur (rosée) fausse les mesures jusqu’à ce qu’il ait séché.
La température mesurée est trop élevée ou trop basseVérifiez l’emplacement : le soleil direct, un radiateur ou un courant d’air à proximité faussent les mesures.
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 Square-comfort 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 :

ApplicationSquare-comfort
Versionnovembre 2026
rulesCrc32701440494 (hex 29CF21EE)
Version précédenteSquare-comfort R31–R33, rulesCrc32 186643291 : voir la révision B 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 Square-comfort R31–R33, dont les ids et les valeurs par défaut diffèrent. Pour ces capteurs, utilisez la révision B de ce manuel jusqu’à leur mise à jour.

Autres applications : outre Square-comfort, 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
1UplinkMesures et alarmes (voir Messages)
11UplinkLes mêmes sorties, sous forme compressée
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
tempB02 octets, × 0,01°CNonLors d’une variation supérieure au Temperature Threshold
averageTempB12 octets, × 0,01°CNonÀ chaque Average Temperature Interval
tempAlarm811 octet0 = pas d’alarme, 1 = haut, −1 = basOuiLorsque l’état d’alarme change
humidityB32 octets, × 0,01% HRNonLors d’une variation supérieure au Humidity Threshold
averageHumidity902 octets, × 0,01% HROuiÀ chaque Humidity Interval, si la variation dépasse le Humidity Threshold
batteryPercent801 octet% (estimation)OuiUne fois par semaine

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. Les valeurs sont envoyées dans le pas indiqué : un réglage au pas de 0,01 est envoyé multiplié par cent.

RéglageNom dans l’applicationIdFonctionUnitéPlageValeur par défaut
Temperature ThresholdtempHysteresisB2Variation de température nécessaire pour qu’une nouvelle mesure soit envoyée. Les variations plus faibles ne sont pas transmises, ce qui économise la batterie et le temps d’antenne.°C, pas de 0,010,1–1270,5
Average Temperature IntervalaverageTempIntervalMinutesA1Fréquence d’envoi de la température moyenne. Elle est envoyée à chaque intervalle, qu’elle ait changé ou non.minutes2–12760
Temperature Low Alarm LeveltempAlarmLowLevelA2Seuil d’alarme bas. Il doit être inférieur au seuil haut, sinon l’alarme est désactivée.°C−50 à +702
Temperature High Alarm LeveltempAlarmHighLevelA3Seuil d’alarme haut, proche par défaut de la température ambiante maximale admise par le produit. Il doit être supérieur au seuil bas, sinon l’alarme est désactivée.°C−50 à +8060
Humidity ThresholdhumidityTresholdB4Variation d’humidité nécessaire pour que l’humidité ou l’humidité moyenne soit envoyée. Au-delà de 100, ce seuil est de fait désactivé.% HR, pas de 0,010,1–1002
Humidity IntervalaverageHumidityIntervalMinutesA4Fréquence de calcul de l’humidité moyenne.minutes1–12760
Roaming Network CountroamNetworkCountA0Nombre d’identités de réseau LoRaWAN à essayer tour à tour (voir Réseau et itinérance).nombre1–151

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 00086 400 (24 heures)
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 Comfort 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 et itinérance). Les mesures effectuées pendant qu’il n’est pas connecté sont conservées et envoyées une fois la connexion rétablie.

Square Comfort 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

Sensative a publié deux configurations prêtes à l’emploi pour cette application. Vous pouvez les choisir dans la Profile Library du VSM Configuration Tool ou envoyer les payloads ci-dessous. Les réglages non mentionnés conservent leur valeur par défaut.

RéglageValeur par défautIndoorOutdoor
Temperature Threshold0,5 °C0,2 °Cpar défaut
Average Temperature Interval60 min30 min30 min
Temperature Low Alarm Level2 °C15 °Cpar défaut
Temperature High Alarm Level60 °C26 °Cpar défaut
Humidity Threshold2 %1 %par défaut
Humidity Interval60 minpar défaut30 min

Indoor est destiné à un usage en intérieur, avec des transmissions plus fréquentes. Outdoor est destiné à un usage en extérieur, comme alerte de gel et de chaleur, et conserve les seuils d’alarme par défaut de 2 °C et 60 °C.

ProfilPort 2 (hex)Ou port 7 (hex)
IndoorA1 00 00 00 1E B4 00 00 00 64 A3 00 00 00 1A A2 00 00 00 0F
puis B2 00 00 00 14
29 CF 21 EE 02 14 A1 00 00 00 1E B4 00 00 00 64 A3 00 00 00 1A A2 00 00 00 0F 02 05 B2 00 00 00 14 00 EA 7B 7F 44
OutdoorA4 00 00 00 1E A1 00 00 00 1E29 CF 21 EE 02 0A A4 00 00 00 1E A1 00 00 00 1E 00 D2 AC 98 E4

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. La valeur est exprimée dans le pas propre au réglage ; ainsi, un seuil de température de 0,2 °C au pas de 0,01 est envoyé sous la forme 20. 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
B2Temperature Threshold 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 : suivi plus fin de la température dans un bureau

Objectif : transmettre chaque variation de 0,2 °C et envoyer la moyenne toutes les 30 minutes. Les exemples sont construits selon le format d’enregistrement décrit dans Réglages sur le port 2, pour le rulesCrc32 701440494, et vérifiés avec le VSM translator open source. Le payload pour le port 7 contient l’identité de l’application et la somme de contrôle, tel que le génère le VSM Configuration Tool. Envoyez l’un ou l’autre payload, port 2 ou port 7, mais pas les deux.

RéglageValeurValeur envoyéeEnregistrement
Temperature Threshold0,2 °C20B2 00 00 00 14
Average Temperature Interval30 min30A1 00 00 00 1E
Port 2 (hex)A1 00 00 00 1E B2 00 00 00 14
Port 2 (base64)oQAAAB6yAAAAFA==
Ou port 7 (hex)29 CF 21 EE 02 0A A1 00 00 00 1E B2 00 00 00 14 00 F3 10 57 EC

Exemple 2 : seuils d’alarme pour une chambre froide

Objectif : une alarme en dessous de −10 °C et au-dessus de +30 °C. La valeur négative s’écrit en complément à deux.

RéglageValeurValeur envoyéeEnregistrement
Temperature Low Alarm Level−10 °C−10A2 FF FF FF F6
Temperature High Alarm Level+30 °C30A3 00 00 00 1E
Port 2 (hex)A3 00 00 00 1E A2 FF FF FF F6
Port 2 (base64)owAAAB6i////9g==
Ou port 7 (hex)29 CF 21 EE 02 0A A3 00 00 00 1E A2 FF FF FF F6 00 2A B8 5C 69

9Caractéristiques techniques

CapteursTempérature, humidité
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 Square-comfort (November 2026)
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, 750 mAh, bien plus de dix ans
Indice de protectionIP63
Température de fonctionnement−20 à +60 °C
Dimensions58 × 58 × 7 mm
Poids23 g
MontageAdhésif, ou kit de fixation par vis Square en option

10Assistance

Sources : Sensative Docs, Square Comfort, FAQ Square & Puck et Hugin NFC application (consultés le 24 octobre 2026) ; sources et documentation des applications dans le dépôt vsm-applications de Sensative (Square-comfort, 10 novembre 2026) et définitions de produits dans dots-builds ; VSM Configuration Tool et documentation des applications VSM sur GitHub pour la version précédente ; VSM translator (open source) ; caractéristiques issues des données produit de sensative.com ; positionnement Wi-Fi : Semtech, Wi-Fi geolocation with LoRa Edge.