1Introduction
Square Air mesure la qualité de l’air intérieur au moyen d’un capteur de gaz à oxyde métallique (Bosch BME688) : indice de qualité de l’air (IAQ), breath-VOC et équivalent CO₂, ainsi que la pression atmosphérique, la température, l’humidité relative et la luminosité. Il transmet ces données par LoRaWAN. Il mesure 58 × 58 × 15 mm, est destiné aux pièces intérieures sèches (IP30) et comporte deux petits trous en face avant.
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 (6 000 mAh) et dure environ 6–7 ans en mesure continue, et environ 12 ans si le capteur ne mesure que pendant des heures de bureau élargies (06:00–20:00, du lundi au vendredi).
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-air 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 Air, 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
- Pour le climat d’une pièce et la qualité de l’air : 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
- Loin des poubelles, des produits chimiques, des entrées d’air de ventilation, des portes et des fenêtres, qui peuvent avoir un effet important sur les mesures de qualité de l’air
- En intérieur uniquement : le capteur, classé IP30, est destiné aux pièces intérieures sèches
- Trous dégagés : laissez dégagés les deux trous de la face avant
- 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 Air 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 Air est livré avec l’application Square-air. Avec les réglages par défaut, il envoie les valeurs de qualité de l’air toutes les 30 minutes, la luminosité moyenne toutes les 20 minutes si elle a changé, 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 %. Il déclenche une alarme de qualité de l’air au-delà d’un IAQ de 200, et une alarme de température en dessous de 2 °C et au-dessus de 60 °C. Modifiez les réglages si vous avez d’autres besoins.
En limitant les mesures aux plages horaires utiles, vous prolongez l’autonomie de la batterie : environ 12 ans si le capteur ne mesure que pendant des heures de bureau élargies (06:00–20:00, du lundi au vendredi), contre environ 6–7 ans en mesure continue.
Pour savoir comment procéder, consultez Modifier les réglages, le tableau des réglages et les exemples.
Monter
Deux méthodes sont possibles :
- 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.
- 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
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.
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é en intérieur, sur un mur intérieur, à l’écart du soleil, de la chaleur et des courants d’air, trous de la face avant dégagés
- Qualité de l’air, température, humidité et luminosité reçues
4Utilisation du capteur
L’application mesure la qualité de l’air, la pression atmosphérique, la température, l’humidité et la luminosité à intervalles réguliers, et envoie une mise à jour lorsqu’une valeur a varié de plus d’un seuil donné ou qu’un intervalle donné s’est écoulé. Les réglages indiqués en gras figurent dans le tableau des réglages.
Qualité de l’air
Square Air mesure la qualité de l’air avec le capteur de gaz, qui mesure aussi la pression atmosphérique. Le capteur de gaz démarre dès que Square Air a rejoint le réseau. Il prélève un échantillon toutes les 5 minutes et, à chaque Air Interval (30 minutes par défaut), l’application envoie la moyenne de chaque valeur sur cette période. Les premières valeurs après le démarrage peuvent porter sur une période incomplète ; n’en tenez pas compte.
- IAQ (indice de qualité de l’air intérieur) : échelle de 0 (air pur) à 500 (air très pollué), calculée à partir des gaz détectés par le capteur de gaz. Une valeur d’environ 50 correspond à un air de bonne qualité, et une valeur d’environ 200 à un air pollué typique. Le capteur étalonne l’indice sur son environnement à partir de ses mesures récentes ; la pièce doit donc être bien aérée (exposée à l’air frais) une fois par semaine.
- IAQ statique : la même échelle, sans ce réétalonnage automatique. Utilisez-le là où le capteur n’est pas régulièrement exposé à l’air frais.
- bVOC (équivalent breath-VOC) : composés organiques volatils (COV), exprimés en équivalents breath-VOC, en ppm.
- Équivalent CO₂ : estimation en ppm, déduite du rapport moyen entre les COV et le CO₂ dans l’air expiré. Square Air n’a pas de capteur de CO₂ ; il ne s’agit donc pas d’une valeur de CO₂ mesurée. Pour mesurer le CO₂, il existe Square CO2.
- Pression atmosphérique : en hPa, avec deux décimales.
Fonctionnement du capteur de gaz
Le capteur de gaz est un capteur à oxyde métallique. Les gaz présents dans l’air sont absorbés par sa couche sensible, où ils sont oxydés ou réduits ; le signal est d’autant plus fort que le gaz est chimiquement réactif.
- Gaz détectés : la plupart des composés volatils, et de nombreux autres gaz qui polluent l’air intérieur. Il ne réagit pas à quelques gaz quasi inertes, comme l’azote et le CO₂. C’est pourquoi la valeur de CO₂ est un équivalent estimé à partir des COV de l’air expiré, et non une mesure.
- Une somme, pas un gaz unique : il mesure la somme des COV et des contaminants présents dans l’air plutôt qu’un gaz précis. Il détecte donc les émanations de peinture, de mobilier et de déchets, ainsi que les fortes concentrations de COV dues à la cuisine, aux aliments, à l’air expiré et à la transpiration.
- IAQ ou IAQ statique : l’IAQ s’étalonne lui-même sur son environnement, et Bosch le recommande pour les usages mobiles. L’IAQ statique ne se réétalonne pas, et Bosch le recommande pour les appareils fixes. En pratique, utilisez l’IAQ statique là où le capteur n’est pas régulièrement exposé à l’air frais, et l’IAQ là où la pièce est aérée régulièrement.
Temps de chauffe et précision
Il faut au capteur de gaz jusqu’à 28 jours de fonctionnement pour que l’IAQ et les autres valeurs de gaz soient pleinement fiables. Avec les valeurs de qualité de l’air, le capteur envoie trois valeurs d’état qui indiquent où il en est :
- État de stabilisation : avancement de cet étalonnage initial et de la stabilisation.
- Précision de l’IAQ : de 0 à 3, qualité de l’étalonnage actuel.
- État de rodage (run-in) : état de démarrage propre au capteur de gaz.
Alarme de qualité de l’air
- Lorsque l’IAQ dépasse l’IAQ Alarm Level (200 par défaut), ou que l’IAQ statique dépasse le Static IAQ Alarm Level (200 par défaut), le capteur envoie une alarme de qualité de l’air, en message confirmé.
- L’alarme est une valeur unique : 0 = pas d’alarme, 1 = alarme IAQ statique, 2 = alarme IAQ, 3 = les deux.
Luminosité
Le capteur mesure la luminosité toutes les minutes. À chaque Average Lux Report Interval (20 minutes par défaut), il calcule la luminosité moyenne, en lux, et l’envoie en message confirmé si elle a varié de plus du Lux Threshold (100 % par défaut).
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, à condition qu’elle ait varié de plus de l’Average Temperature Threshold.
- 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.
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 Air 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 Air n’a pas de positionnement par satellite.
Réseau et itinérance
- Messages confirmés : le serveur réseau acquitte les alarmes, l’humidité moyenne, la luminosité moyenne 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 (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 :
…00pour le premier réseau,…01pour 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.
- 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 (6 000 mAh). Sur un bon réseau (SF7–SF9), elle dure environ 6–7 ans en mesure continue, et environ 12 ans si le capteur ne mesure que pendant des heures de bureau élargies (06:00–20:00, du lundi au vendredi). Des transmissions fréquentes et une liaison faible réduisent cette autonomie.
Retirer Square Air
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ème | Solution |
|---|---|
| Aucune valeur de qualité de l’air | Le capteur de gaz démarre dès que Square Air a rejoint le réseau, et les valeurs arrivent à chaque Air Interval (30 minutes par défaut). Ne tenez pas compte des premières valeurs après le démarrage. |
| Les valeurs de qualité de l’air semblent instables | Il faut au capteur de gaz jusqu’à 28 jours de fonctionnement pour que les valeurs soient pleinement fiables. L’état de stabilisation et la précision de l’IAQ (0–3), envoyés avec les valeurs, indiquent où il en est. |
| L’indice IAQ dérive ou semble erroné | Aérez bien la pièce une fois par semaine, pour que le capteur puisse s’étalonner sur de l’air frais. S’il n’est jamais exposé à l’air frais, utilisez l’IAQ statique. La cuisine, les aliments, la fumée, les parfums, ainsi qu’une peinture fraîche ou des meubles neufs font aussi monter les valeurs. |
| L’humidité mesurée est trop élevée après une condensation | De 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 basse | Vé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é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 Square-air 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 | Square-air |
| Version | novembre 2026 |
| rulesCrc32 | 3007941823 (hex B3498CBF) |
| Version précédente | Square-air R33, rulesCrc32 114894312 : 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 Square-air, 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 | Mesures et alarmes (voir Messages) |
| 11 | Uplink | Les mêmes sorties, sous forme compressée |
| 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 |
|---|---|---|---|---|---|
| air_iaq | B8 | 4 octets | Indice IAQ, 0–500 | Non | À chaque Air Interval |
| air_static_iaq | BC | 4 octets | Indice IAQ, 0–500 | Non | À chaque Air Interval |
| air_breath_voc_equivalent | BB | 4 octets, × 0,01 | ppm (équivalent breath-VOC) | Non | À chaque Air Interval |
| air_co2 | B9 | 4 octets | ppm (équivalent CO₂) | Non | À chaque Air Interval |
| air_pressure | BA | 4 octets, × 0,01 | hPa | Non | À chaque Air Interval |
| air_run_in_status, air_stab_status, air_iaq_accuracy | A7 A8 A9 | 1 octet chacun | état ; précision de l’IAQ 0–3 | Non | Avec les valeurs de qualité de l’air |
| air_iaq_alarm | 82 | 1 octet | 0 = aucune, 1 = IAQ statique, 2 = IAQ, 3 = les deux | Oui | Lorsque l’IAQ ou l’IAQ statique dépasse son seuil d’alarme |
| lux | B5 | 2 octets | lux | Non | Lorsque la luminosité varie de plus du Lux Threshold |
| averageLux | 91 | 2 octets | lux | Oui | À chaque Average Lux Report Interval, si la variation dépasse le Lux Threshold |
| temp | B0 | 2 octets, × 0,01 | °C | Non | Lors d’une variation supérieure au Temperature Threshold |
| averageTemp | B1 | 2 octets, × 0,01 | °C | Non | À chaque Average Temperature Interval, si la variation dépasse l’Average Temperature Threshold |
| tempAlarm | 81 | 1 octet | 0 = pas d’alarme, 1 = haut, −1 = bas | Oui | Lorsque l’état d’alarme change |
| humidity | B3 | 2 octets, × 0,01 | % HR | Non | Lors d’une variation supérieure au Humidity Threshold |
| averageHumidity | 90 | 2 octets, × 0,01 | % HR | Oui | À chaque Humidity Interval, si la variation dépasse le Humidity Threshold |
| batteryPercent | 80 | 1 octet | % (estimation) | Oui | Une 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églage | Nom dans l’application | Id | Fonction | Unité | Plage | Valeur par défaut |
|---|---|---|---|---|---|---|
| Air Interval | air_interval_minutes | AA | Période sur laquelle les valeurs de qualité de l’air sont moyennées avant d’être envoyées. Le capteur de gaz prélève un échantillon toutes les 5 minutes ; choisissez donc un multiple de 5. | minutes | 5–125 | 30 |
| IAQ Alarm Level | air_iaq_alarm_level | BE | Lorsque l’IAQ dépasse cette valeur, une alarme de qualité de l’air est envoyée. | indice IAQ | 0–1 000 | 200 |
| Static IAQ Alarm Level | air_static_iaq_alarm_level | BD | Lorsque l’IAQ statique dépasse cette valeur, une alarme de qualité de l’air est envoyée. | indice IAQ | 0–1 000 | 200 |
| Lux Threshold | luxTresholdPercent | B6 | Variation de luminosité nécessaire pour que la luminosité ou la luminosité moyenne soit envoyée. | % | 1–32 767 | 100 |
| Average Lux Report Interval | averageLuxIntervalMinutes | A6 | Fréquence de calcul de la luminosité moyenne, envoyée si elle a changé. | minutes | 2–127 | 20 |
| Temperature Threshold | tempHysteresis | B2 | Variation 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,01 | 0,1–127 | 0,5 |
| Average Temperature Interval | averageTempIntervalMinutes | A2 | Fréquence d’envoi de la température moyenne, si elle a varié de plus de l’Average Temperature Threshold. | minutes | 2–127 | 60 |
| Average Temperature Threshold | averageTempHysteresis | A1 | Variation de la température moyenne nécessaire pour qu’elle soit envoyée. | °C, pas de 0,1 | 0–12,7 | 0,1 |
| Temperature Low Alarm Level | tempAlarmLowLevel | A3 | Seuil d’alarme bas. Il doit être inférieur au seuil haut, sinon l’alarme est désactivée. | °C | −50 à +70 | 2 |
| Temperature High Alarm Level | tempAlarmHighLevel | A4 | Seuil 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 à +80 | 60 |
| Humidity Threshold | humidityTreshold | B4 | Variation 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,01 | 0,1–100 | 2 |
| Humidity Interval | averageHumidityIntervalMinutes | A5 | Fréquence de calcul de l’humidité moyenne. | minutes | 1–127 | 60 |
| Roaming Network Count | roamNetworkCount | A0 | Nombre d’identités de réseau LoRaWAN à essayer tour à tour (voir Réseau et itinérance). | nombre | 1–15 | 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 | 86 400 (24 heures) |
| 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) |
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. 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.
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 |
06 | Pression atmosphérique actuelle |
0B | Luminosité actuelle |
B2 | Temperature 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 : qualité de l’air toutes les 15 minutes
Objectif : calculer la moyenne des valeurs de qualité de l’air et les envoyer toutes les 15 minutes au lieu de 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 3007941823, 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églage | Valeur | Valeur envoyée | Enregistrement |
|---|---|---|---|
| Air Interval | 15 min | 15 | AA 00 00 00 0F |
| Port 2 (hex) | AA 00 00 00 0F |
| Port 2 (base64) | qgAAAA8= |
| Ou port 7 (hex) | B3 49 8C BF 02 05 AA 00 00 00 0F 00 2D 8C A8 68 |
Exemple 2 : alarme de qualité de l’air à un seuil plus bas
Objectif : déclencher l’alarme de qualité de l’air lorsque l’IAQ dépasse 150 au lieu de 200.
| Réglage | Valeur | Valeur envoyée | Enregistrement |
|---|---|---|---|
| IAQ Alarm Level | 150 | 150 | BE 00 00 00 96 |
| Port 2 (hex) | BE 00 00 00 96 |
| Port 2 (base64) | vgAAAJY= |
| Ou port 7 (hex) | B3 49 8C BF 02 05 BE 00 00 00 96 00 31 3F B2 CA |
9Caractéristiques techniques
| Capteurs | Qualité de l’air (capteur de gaz à oxyde métallique Bosch BME688 : IAQ, IAQ statique, bVOC et équivalent CO₂), pression atmosphérique, température, humidité, luminosité |
| IAQ | 0–500 ; écart d’un capteur à l’autre ±15 % |
| Précision de la température | ±0,2 °C |
| Précision de l’humidité | ±3 % HR (10–90 % HR) |
| Précision de la pression atmosphérique | ±0,6 hPa en absolu (300–1 100 hPa) ; ±0,12 hPa en relatif (900–1 100 hPa) |
| Plage de mesure de la luminosité | 1–65 000 lux |
| 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 Square-air (November 2026) |
| Positionnement | Géolocalisation Wi-Fi via un service cloud |
| Mémoire | Journal de données intégré, transmis par LoRaWAN lorsque le capteur se connecte |
| Batterie | LiMnO2 intégrée, 6 000 mAh ; environ 6–7 ans en mesure continue, environ 12 ans avec des mesures uniquement de 06:00 à 20:00, du lundi au vendredi |
| Indice de protection | IP30, usage intérieur |
| Température de fonctionnement | −20 à +60 °C |
| Humidité de fonctionnement | 10–90 % HR |
| Stockage | +10 à +30 °C |
| Dimensions | 58 × 58 × 15 mm |
| Poids | 65 g |
| Montage | Adhésif, ou kit de fixation par vis Square en option |
10Assistance
- VSM Configuration Tool, ouvert sur cette application : 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-air
Sources : Sensative Docs, Square Air (décembre 2024), y compris sa description du capteur de gaz, FAQ Square & Puck et Hugin NFC application ; sources et documentation des applications dans le dépôt vsm-applications de Sensative (Square-air, 10 novembre 2026) et définitions de produits dans dots-builds ; VSM translator (open source) ; caractéristiques issues des données produit de sensative.com ; positionnement Wi-Fi : Semtech, Wi-Fi geolocation with LoRa Edge.