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

Un traceur Wi-Fi de 7 mm qui effectue un relevé Wi-Fi quand l’objet suivi commence ou cesse de bouger : vous savez où il se trouve, sans infrastructure de localisation. Ce manuel vous guide du carton à la mise en service du traceur 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 Tracker vous indique où se trouvent vos objets en intérieur. Il recherche les points d’accès Wi-Fi qui l’entourent lorsqu’il se met en mouvement ou s’arrête, ainsi qu’à intervalles réguliers, et un service cloud convertit ces balayages en positions. Son accéléromètre détecte les mouvements, ce qui lui permet aussi d’indiquer dans quelle mesure un objet est déplacé, et il donne une indication de la température. Il mesure 58 × 58 × 7 mm, est classé IP63 et sa face avant est lisse, sans aucun trou.

La batterie est intégrée (750 mAh) et dure 10 ans à raison de 12 positions par jour. Pour des positions plus fréquentes, il existe Square Tracker L, d’une épaisseur de 15 mm, avec 4 000 mAh (voir le manuel de Square Tracker 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 Tracker 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 Tracker, 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 Tracker, 7 mm d’épaisseur, face avant lisse
La face avant est lisse, sans aucun 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)
  • Un service cloud qui prend en charge le positionnement Wi-Fi, par exemple Yggio. Sans ce service, les balayages arrivent bien, mais ne donnent aucune position (voir Fonctionnement du positionnement Wi-Fi).

Choisir l’emplacement

  • Sur l’objet suivi : fixez le capteur à un endroit où il se déplace avec l’objet
  • Du Wi-Fi à proximité : la position est calculée à partir des points d’accès Wi-Fi que le capteur détecte. Le positionnement fonctionne donc là où il y a du Wi-Fi, en général en intérieur
  • 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 dont la porte est close, qui bloquent aussi le Wi-Fi.

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 Tracker 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 Tracker est livré avec l’application Tracker. Avec les réglages par défaut, il lance une série de balayages chaque fois qu’il se met en mouvement ou s’arrête, et une fois par jour lorsqu’il est immobile. Le comptage des mouvements et la durée de mouvement sont désactivés, de même que les fonctions facultatives (signalement d’inclinaison, pression atmosphérique pour l’étage et balayage uniquement après l’arrêt). Adaptez les réglages à la fréquence à laquelle vous avez besoin de positions, car chaque balayage consomme de la batterie.

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 : nettoyez la surface avec un mélange à parts égales d’alcool isopropylique et d’eau (50:50) pour éliminer saleté et graisse, puis laissez sécher. Retirez le film protecteur de l’adhésif au dos et 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.
Montez le capteur de façon que sa face avant, avec la zone NFC en bas à gauche, reste accessible avec un téléphone.
7

Tester

Déplacez l’objet suivi, ou le capteur, puis laissez-le immobile.

Terminé quand : environ une minute après le début du mouvement, puis de nouveau après l’arrêt, des balayages Wi-Fi arrivent et le service cloud (par exemple Yggio) les convertit en position (voir Fonctionnement du positionnement Wi-Fi).
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
  • Capteur relié à un service cloud qui prend en charge le positionnement Wi-Fi, par exemple Yggio
  • Réglages vérifiés, ou modifiés selon les besoins
  • Capteur monté sur l’objet suivi, coin NFC accessible
  • Positions reçues lorsque l’objet se déplace

4Utilisation du capteur

Les réglages indiqués en gras figurent dans le tableau des réglages.

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.
  • Service cloud indispensable : pour obtenir la moindre position, le tracker doit être relié à un service cloud qui prend en charge le positionnement Wi-Fi, par exemple Yggio. Ce service recherche les adresses dans une base de données de points d’accès cartographiés et renvoie la position. Munin et LoRa Cloud le font aussi.
  • 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 Tracker n’a pas de positionnement par satellite.

Déclenchement des balayages : la série de balayages

Chaque fois que le capteur se met en mouvement, et chaque fois qu’il s’arrête, il lance une série de balayages, qui prend fin dès que l’un d’eux trouve suffisamment de points d’accès (le Minimum Wifi Count, 3 par défaut).

  1. Au bout d’une minute, un balayage Wi-Fi limité aux canaux du Limited Wifi Scan Channel Mask (tous les canaux par défaut).
  2. À la minute fixée par le Still Wifi Scan Again At Minute (minute 2 par défaut), un deuxième balayage Wi-Fi limité.
  3. À la minute fixée par le Full Wifi Scan At Minute, un balayage Wi-Fi complet, sur les canaux du Full Wifi Scan Channel Mask (tous les canaux par défaut).
  • Balayages périodiques : la série de balayages est aussi relancée à chaque Stationary Scan Interval lorsque le capteur est immobile (1 440 minutes par défaut, soit une fois par jour) et à chaque Moving Scan Interval lorsqu’il se déplace (désactivé par défaut). Ne choisissez pas un intervalle plus court que la durée de la série de balayages.
  • Budget de balayages : chaque balayage consomme une unité d’un budget. Le 15 Minute Scan Budget (3 par défaut) est ajouté toutes les 15 minutes, jusqu’au Max Scan Budget (100 par défaut). Si le budget s’épuise pendant une série, les balayages restants attendent qu’il soit reconstitué.
  • Position à la demande, par NFC : approchez un téléphone d’un capteur déjà connecté au réseau, comme pour la connexion. Le capteur lance aussitôt une série de balayages, et le résultat arrive dans un nouveau message montant de balayage Wi-Fi, que votre service cloud convertit en position. C’est le moyen d’obtenir une position à la demande.

Fonctions facultatives : Tracker Options

Trois fonctions sont désactivées par défaut. Le réglage Tracker Options les active, à raison d’un bit chacune ; additionnez les valeurs pour les combiner.

  • 1, signalement d’inclinaison : chaque fois que le capteur revient au repos après un mouvement, il contrôle son orientation à partir de la mesure de l’accéléromètre au repos, c’est-à-dire de la pesanteur. Le premier contrôle fixe la référence, qui est envoyée sous forme de valeurs X, Y et Z. Si un contrôle ultérieur constate que le capteur a été incliné ou tourné de plus que le Position Moved Threshold (1,71 m/s² par défaut, soit environ 10°), le capteur envoie la nouvelle référence et compte un déplacement. Rien n’est envoyé tant que l’orientation ne change pas, et un déplacement sans changement d’orientation passe inaperçu. La référence est perdue lors d’un redémarrage, et une nouvelle référence est alors envoyée. Le contrôle s’appuie sur la mesure que l’accéléromètre effectue de toute façon lorsque le capteur revient au repos ; il ne demande donc aucune mesure supplémentaire.
  • 2, pression atmosphérique pour l’étage : la pression atmosphérique est mesurée au début de chaque série de balayages et envoyée si sa variation depuis la dernière valeur envoyée dépasse l’Air Pressure Hysteresis (10 Pa par défaut). Elle n’est pas envoyée entre deux séries, si bien que les lentes variations dues à la météo ne provoquent aucun message tant que l’objet reste en place. C’est à votre service de déterminer l’étage. Près du sol, la pression baisse d’environ 12 Pa par mètre, soit environ 35 Pa par étage, mais la météo la fait varier bien davantage au cours d’une journée, souvent de 100 Pa ou plus. Comparez donc avec une référence, comme un capteur fixe dans le bâtiment ou un service météo, ou avec des valeurs relevées auparavant par le même capteur à des étages connus.
  • 4, balayage uniquement après l’arrêt : la série de balayages ne démarre que lorsque le capteur s’est arrêté, et non lorsqu’il se met en mouvement. Vous obtenez ainsi une seule position, là où l’objet s’est immobilisé. Pendant le déplacement, aucun balayage n’a lieu, pas même au Moving Scan Interval.

Mouvement et durée de mouvement

  • Détection du mouvement : l’accéléromètre détecte les déplacements du capteur. Le Still Threshold fixe l’intensité minimale qu’un mouvement doit atteindre pour être pris en compte lorsque le capteur est immobile, et le Moving Threshold lorsqu’il est en mouvement. Si ces seuils sont trop bas, le capteur se croit toujours en mouvement et ne lance pas de série de balayages lorsqu’il s’arrête. Partez de valeurs élevées et abaissez-les si le capteur n’est pas assez sensible.
  • Comptage des mouvements : désactivé par défaut. S’il est activé, le capteur envoie le nombre de mouvements détectés depuis son démarrage, une fois par heure si ce nombre a changé.
  • Durée de mouvement : désactivée par défaut. Si elle est activée, le capteur envoie le nombre total de minutes pendant lesquelles il a détecté un mouvement depuis son démarrage, une fois par heure si ce nombre a changé.

Température

La température est mesurée à l’intérieur du capteur toutes les 15 minutes, avec une précision typique de ±2 °C. Elle donne une indication des conditions autour de l’objet suivi, et non une mesure précise de la température ambiante.

  • Lorsque la température a varié de plus de la Temperature Hysteresis (2 °C par défaut) depuis la dernière valeur envoyée, le capteur envoie la nouvelle mesure.
  • À chaque Average Temp Interval (2 heures par défaut), il envoie la température moyenne si elle a varié de plus de cette même hystérésis.
  • Au-dessus du Temperature Alarm High Level (60 °C), l’état d’alarme passe à « haut » ; en dessous du Temperature Alarm Low Level (2 °C), il passe à « bas ». L’alarme est envoyée en message confirmé, puis levée lorsque la température revient entre les deux seuils.

Batterie

Une fois par semaine, le capteur estime la charge restante de sa batterie et l’envoie sous forme de pourcentage, en message confirmé. 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.

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 (7 jours par défaut ; voir Registres de l’appareil). Sans heure, rien n’est enregistré.

Réseau et itinérance

  • Messages confirmés : le serveur réseau acquitte l’alarme de température, le signalement d’inclinaison 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. S’il était connecté et a perdu le réseau, il fait d’abord des tentatives rapides, toutes les heures et 15 minutes après s’être immobilisé, dans la limite du Quick Rejoin Budget (10 par défaut). 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 (8 heures par défaut dans cette application ; 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 rapidement son débit jusqu’à atteindre de nouveau le réseau, car un tracker qui a été déplacé peut avoir besoin immédiatement d’une plus grande portée.

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.

Les balayages Wi-Fi arrivent sur le port 23 ou 24 ; le décodeur gère les deux.

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 (750 mAh) et dure 10 ans à raison de 12 positions par jour, sur un bon réseau (SF7–SF9). Des transmissions fréquentes et une liaison faible réduisent cette autonomie.

Retirer Square Tracker

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
Pas de balayage lorsque l’objet s’arrêteLe Still Threshold ou le Moving Threshold est trop bas, si bien que le capteur se croit toujours en mouvement (voir Mouvement et durée de mouvement). Augmentez-les.
Les balayages s’interrompent lorsque l’objet bouge beaucoupLe budget de balayages est épuisé. Les balayages restants auront lieu une fois le budget reconstitué. N’augmentez le 15 Minute Scan Budget que si la batterie le permet.
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 Tracker 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 :

ApplicationTracker
Versionnovembre 2026
rulesCrc323464845265 (hex CE8557D1)
Version précédenteTracker R27–R33, rulesCrc32 3802553086 : 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 Tracker R27–R33, 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 Tracker, 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
1UplinkTempérature, nombre et durée des mouvements, inclinaison, pression atmosphérique et batterie (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
23, 24UplinkBalayages Wi-Fi, pour le positionnement. Ils arrivent sur le port 23 ou 24 ; le décodeur gère les deux.
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 à la Temperature Hysteresis (mesure toutes les 15 minutes)
averageTempB12 octets, × 0,01°CNonÀ chaque Average Temp Interval, si la variation dépasse la Temperature Hysteresis
tempAlarm801 octet0 = pas d’alarme, 1 = haut, −1 = basOuiLorsque l’état d’alarme change
motionCountBA4 octetsnombre de mouvements depuis le démarrageNonToutes les heures en cas de changement, si Enable Motion Count Report est activé
motionTimeMinutesBB4 octetsminutes de mouvement depuis le démarrageNonToutes les heures en cas de changement, si Motion Time Enabled est activé
positionX, positionY, positionZ98 99 9A4 octets chacune, × 0,001m/s² (pesanteur sur chaque axe)OuiSi le signalement d’inclinaison est activé : orientation de référence, au premier contrôle et après chaque déplacement
positionMoves9B4 octetsdéplacements depuis le démarrageOuiSi le signalement d’inclinaison est activé : avec la nouvelle référence, après chaque déplacement
airPressureBF4 octets, × 0,01hPaNonSi la pression atmosphérique est activée : au début d’une série de balayages, si la variation dépasse l’Air Pressure Hysteresis
batteryPercent811 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é : l’hystérésis de température, au pas de 0,01, est envoyée multipliée par cent, et le Position Moved Threshold, au pas de 0,001, multiplié par mille. Tous les autres réglages sont des nombres entiers.

RéglageNom dans l’applicationIdFonctionUnitéPlageValeur par défaut
Still ThresholdstillMotionThreshold_mm_s2B3Intensité minimale qu’un mouvement doit atteindre pour être pris en compte lorsque le capteur est immobile. Si elle est trop basse, le capteur se croit toujours en mouvement.mm/s²150–7 350920
Moving ThresholdmovingMotionThreshold_mm_s2B4Intensité minimale qu’un mouvement doit atteindre pour que le capteur se considère toujours en mouvement lorsqu’il se déplace.mm/s²150–7 350460
Minimum Wifi CountminimumWifiCountA6Nombre de points d’accès Wi-Fi qu’un balayage doit trouver pour que la série de balayages s’arrête.points d’accès1–153
Still Wifi Scan Again At MinutesingleWifiScanAgain_minutesA5Minute du deuxième balayage Wi-Fi limité après la mise en mouvement ou l’arrêt du capteur. La valeur −1 le désactive. Évitez 1, car le premier balayage a toujours lieu à la minute 1.minutes−1 à 1272
Full Wifi Scan At MinutefullWifiScan_minutesA7Minute du balayage Wi-Fi complet après la mise en mouvement ou l’arrêt du capteur. La valeur −1 le désactive. Évitez 1.minutes−1 à 12715
Limited Wifi Scan Channel MasklimitedScanChannelsB8Canaux Wi-Fi des balayages limités, sous forme de masque de bits : les canaux 1 et 3 donnent 101 en binaire, soit 5 en décimal. La valeur 0 correspond à tous les canaux. Moins il y a de canaux, moins la consommation est élevée.masque de bits0–65 5350
Full Wifi Scan Channel MaskfullScanChannelsB9Canaux Wi-Fi du balayage complet, sous forme de masque de bits, sur le même principe.masque de bits0–65 5350
Moving Scan IntervalmovingScanIntervalMinutesBCIntervalle auquel la série de balayages est relancée lorsque le capteur se déplace. La valeur −1 le désactive. Ne choisissez pas un intervalle plus court que la durée de la série de balayages.minutes−1 à 32 768−1 (désactivé)
Stationary Scan IntervalstationaryScanIntervalMinutesBDIntervalle auquel la série de balayages est relancée lorsque le capteur est immobile. La valeur −1 le désactive.minutes−1 à 32 7671 440
15 Minute Scan BudgetquarterlyScanBudgetA4Nombre de balayages ajoutés au budget toutes les 15 minutes.balayages1–153
Max Scan BudgetmaxBudgetB5Plafond du budget de balayages. Chaque balayage consomme une unité.balayages1–32 767100
Tracker OptionstrackerOptionsAAActive les fonctions facultatives, à raison d’un bit chacune ; additionnez les valeurs pour les combiner. 1 = signalement d’inclinaison, 2 = pression atmosphérique avec la série de balayages, 4 = balayage uniquement après l’arrêt (voir Fonctions facultatives).masque de bits0–70
Position Moved ThresholdpositionMovedThreshold_m_s2BESignalement d’inclinaison : écart minimal entre le vecteur pesanteur mesuré et la référence pour que le capteur soit considéré comme déplacé, exprimé comme la norme de la différence. Une inclinaison d’un angle donné le décale de 2 g sin(angle/2), soit 0,86 m/s² pour 5°, 1,71 pour 10°, 3,41 pour 20°, 5,08 pour 30° et 9,81 pour 60°.m/s², pas de 0,0010,3–19,61,71
Air Pressure HysteresisairPressureHysteresis_PaB7Pression atmosphérique : variation nécessaire depuis la dernière valeur envoyée pour qu’une nouvelle valeur soit envoyée. La pression baisse d’environ 12 Pa par mètre ; 10 Pa correspondent donc à un peu moins d’un mètre, et un étage à environ 35 Pa.Pa0–1 00010
Enable Motion Count ReportmotionCountEnabledA81 : le nombre de mouvements détectés est envoyé toutes les heures s’il a changé.marche/arrêt0–10
Motion Time EnabledmotionTimeEnabledA91 : le nombre de minutes de mouvement est envoyé toutes les heures s’il a changé.marche/arrêt0–10
Temperature HysteresistempHysteresisB2Variation de température nécessaire pour qu’une nouvelle mesure ou une nouvelle moyenne soit envoyée.°C, pas de 0,010,1–1272
Average Temp IntervalaverageTempIntervalHoursA0Fréquence d’envoi de la température moyenne, si elle a varié de plus de l’hystérésis.heures1–1272
Temperature Alarm Low LeveltempAlarmLowLevelA1Seuil d’alarme bas. Il doit être inférieur au seuil haut, sinon l’alarme est désactivée.°C−128 à +1262
Temperature Alarm High LeveltempAlarmHighLevelA2Seuil d’alarme haut. Il doit être supérieur au seuil bas, sinon l’alarme est désactivée.°C−127 à +12760
Roaming Network CountroamNetworkCountA3Nombre d’identités de réseau LoRaWAN à essayer tour à tour (voir Réseau et itinérance).nombre1–151
Quick Rejoin BudgetquickRejoinBudgetMaxB6Nombre de tentatives de connexion rapides que fait le capteur après avoir perdu un réseau (toutes les heures, et 15 minutes après s’être immobilisé), avant de revenir à une tentative par jour. Le budget est reconstitué à chaque connexion. Avec la valeur 0, seule la tentative quotidienne subsiste.nombre0–32 76710

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 00028 800 (8 heures) dans cette application
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 295604 800 (7 jours)

Quitter le réseau

Pour que Square Tracker 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 Tracker n’acquitte pas ce downlink, même s’il est envoyé en mode confirmé, et 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. La valeur est exprimée dans le pas propre au réglage ; ainsi, une hystérésis de température de 2 °C au pas de 0,01 est envoyée sous la forme 200, et un intervalle de balayage de 30 minutes sous la forme 30. 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, en centièmes de degré
16État de mouvement actuel
BDStationary Scan Interval 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 : positions pendant le déplacement de l’objet

Objectif : relancer la série de balayages toutes les 30 minutes pendant que le capteur se déplace. Chaque relance prélève des balayages sur le budget et consomme de la batterie. Les exemples sont construits selon le format d’enregistrement décrit dans Réglages sur le port 2, pour le rulesCrc32 3464845265, 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
Moving Scan Interval30 min30BC 00 00 00 1E
Port 2 (hex)BC 00 00 00 1E
Port 2 (base64)vAAAAB4=
Ou port 7 (hex)CE 85 57 D1 02 05 BC 00 00 00 1E 00 AC 9A 76 0E

Exemple 2 : nombre et durée des mouvements

Objectif : activer l’envoi horaire du nombre de mouvements et des minutes de mouvement, par exemple pour savoir dans quelle mesure un équipement est utilisé.

RéglageValeurValeur envoyéeEnregistrement
Enable Motion Count Reportactivé1A8 00 00 00 01
Motion Time Enabledactivé1A9 00 00 00 01
Port 2 (hex)A8 00 00 00 01 A9 00 00 00 01
Port 2 (base64)qAAAAAGpAAAAAQ==
Ou port 7 (hex)CE 85 57 D1 02 0A A8 00 00 00 01 A9 00 00 00 01 00 80 7D D0 94

Exemple 3 : étage et inclinaison

Objectif : activer la pression atmosphérique à chaque série de balayages, pour l’étage, ainsi que le signalement d’inclinaison. Tracker Options vaut alors 2 + 1 = 3.

RéglageValeurValeur envoyéeEnregistrement
Tracker Optionssignalement d’inclinaison et pression atmosphérique3AA 00 00 00 03
Port 2 (hex)AA 00 00 00 03
Port 2 (base64)qgAAAAM=
Ou port 7 (hex)CE 85 57 D1 02 05 AA 00 00 00 03 00 20 3C 78 F5

9Caractéristiques techniques

PositionnementBalayage des points d’accès Wi-Fi ; nécessite un service de géolocalisation dans le cloud ; pression atmosphérique pour la détection de l’étage (en option)
CapteursMouvement et inclinaison (accéléromètre 3D), pression atmosphérique, température (±2 °C typique)
MémoireJournal de données intégré, transmis par LoRaWAN lorsque le capteur se connecte
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 Tracker (version de novembre 2026)
BatterieLiMnO2 intégrée, 750 mAh ; 10 ans à raison de 12 positions par jour
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 Tracker, 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 (Tracker, 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.