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

Puck Radar pour LoRaWAN

Distance, niveau et occupation avec un radar 60 GHz, dans un boîtier IP67 à pile remplaçable. Ce manuel vous guide du carton à la mise en service du capteur, décrit les méthodes radar et l’application VSM qu’il contient, 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

Puck Radar mesure la distance qui le sépare de ce qui se trouve devant lui, à l’aide d’un radar cohérent à impulsions de 60 GHz, de 0,2 à 7 m avec une résolution et une précision de 1 mm. Il la transmet par LoRaWAN sous forme de distance, de niveau ou d’état occupé/libre. Le radar n’a pas besoin de lumière et mesure donc de la même façon de jour comme de nuit. Il sert typiquement à surveiller des places de stationnement, le niveau d’eau dans les avaloirs et les puits, le niveau de remplissage des cuves, des silos et des conteneurs à déchets, ou la hauteur de neige.

Le boîtier est IP67 et fonctionne de −30 à +80 °C. La pile de 2 100 mAh est remplaçable. Le capteur est livré avec l’une des deux lentilles suivantes :

  • Lentille standard : faisceau large d’environ ±60°, hauteur 30 mm, 38 g. Elle convient pour couvrir une surface, par exemple une place de stationnement.
  • Lentille étroite : faisceau concentré d’environ ±10°, hauteur 45 mm, 43 g. Elle convient pour une mesure précise à distance, par exemple le niveau d’eau dans un puits ou les déchets dans un conteneur.
La lentille standard élargit le faisceau à environ ±60° ; la lentille étroite le concentre à environ ±10°

Deux cartes, deux logiciels

Puck contient deux cartes électroniques, chacune dotée de son propre processeur :

  • La carte radar exécute le firmware du radar et se charge des mesures : méthode radar utilisée, fréquence, plage et seuil. Elle n’a pas d’application VSM.
  • La carte LoRaWAN exécute le firmware et une application VSM. Elle gère le réseau et décide quoi envoyer et à quel moment. Elle mesure aussi la température et l’humidité à l’intérieur du boîtier, lit l’accéléromètre pour détecter les mouvements et l’inclinaison, et effectue les balayages Wi-Fi.

Les deux cartes se configurent par LoRaWAN. Sur place, l’application NFC Hugin dialogue avec la carte LoRaWAN, et l’application SweIoT Toolbox avec la carte radar, en Bluetooth (voir Modifier les réglages).

Le capteur fonctionne avec n’importe quel serveur réseau LoRaWAN (LoRaWAN 1.0.4, classe A, OTAA). Ce que la carte LoRaWAN envoie, et à quel moment, est déterminé par une application exécutée sur la Virtual Sensing Machine (VSM) de Sensative. Ce manuel décrit l’application Puck-radar November 2026. Vous pouvez la configurer et la remplacer par une version plus récente, à distance ou par NFC. Sensative peut aussi proposer d’autres applications VSM pour Puck (voir Application installée dans le capteur).

Contenu de la boîte

  • Puck Radar, pile en place
  • Un adhésif pour surfaces planes

Les clés (DevEUI et AppKey) sont fournies avec les informations de livraison. Les plaques de montage sont vendues séparément ; pour un montage dans un trou percé, aucune plaque n’est nécessaire (voir l’étape 6).

Éléments du capteur

Puck Radar avec la lentille standard, démonté et présenté radar vers le bas : le capot de lentille avec le radar en bas, l’embase avec l’étiquette en haut, et entre les deux les cartes, la pile et le joint torique
Puck est représenté ici radar vers le bas. Le boîtier se compose de deux parties : le capot de lentille, à travers lequel le radar mesure (en bas sur l’image), et l’embase, qui porte l’étiquette (en haut). L’étiquette indiquant le modèle, la région et le numéro de série se trouve toujours du côté opposé au radar. Les deux parties se vissent l’une sur l’autre et l’étanchéité est assurée par un joint torique. La pile est logée à l’intérieur, entre les cartes.

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 :

Puck émet par radio vers une passerelle, la passerelle transmet au serveur réseau, et le serveur réseau à votre application ; les réglages et les commandes radar 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 Puck et Square : 70B3D52C0001D4C3.
  • De préférence, un téléphone Android équipé du NFC. Il sert à démarrer le capteur et à utiliser sur place les deux applications : Hugin (NFC, pour la carte LoRaWAN ; il faut un compte utilisateur Yggio et que le capteur soit enregistré au nom de votre organisation) et SweIoT Toolbox for Puck & Prism radar sensor (Bluetooth ; gratuite sur Google Play). Ces deux applications n’existent que sous Android. Avec Puck, elles sont d’une grande aide pour bien régler le radar, en particulier pour un nouvel usage. Un iPhone peut démarrer le capteur avec une application de lecture NFC (voir Trouver les antennes NFC), mais ne permet pas d’utiliser ces applications.
  • Un décodeur de payload pour les capteurs VSM de Sensative, dans votre serveur réseau ou votre application (voir Décoder les messages)
  • Pour obtenir une position : un service cloud qui prend en charge le positionnement Wi-Fi, par exemple Yggio

Choisir l’emplacement

  • Champ dégagé : rien ne doit se trouver entre le radar et ce qu’il mesure. De la saleté, de la glace, de l’eau ou des objets sur la lentille ou devant elle affaiblissent l’écho ou produisent un faux écho.
  • Derrière une plaque de protection : Puck peut mesurer à travers une plaque plane en plastique, comme un couvercle, avec un effet minime. La plaque ne doit contenir ni verre, ni métal, ni carbone. Vérifiez les mesures avant de fixer définitivement la plaque.
  • Métal : vous pouvez monter Puck sur du métal, mais ne l’enfermez pas dans du métal, qui bloque à la fois la radio et le radar.
  • Portée : jusqu’à 10 km en visibilité directe et dégagée, beaucoup moins depuis l’intérieur d’un puits ou d’un ouvrage en béton. Vérifiez le signal à l’emplacement définitif (étape 4).

Ce que voit le radar

  • Ce qui réfléchit : le métal, l’eau et le verre réfléchissent fortement. Le papier, le plastique, le tissu et les personnes réfléchissent plus faiblement, mais sont tout de même détectés. La forme compte autant que le matériau. Une surface plane agit comme un miroir. Elle ne renvoie l’écho qu’à l’endroit où elle fait face au radar perpendiculairement ; si elle est inclinée, l’écho part ailleurs. C’est ainsi que les navires furtifs échappent aux radars. Une surface irrégulière disperse les échos dans de nombreuses directions, si bien qu’une partie revient toujours. Un coin rentrant renvoie l’écho exactement d’où il vient ; c’est le principe du réflecteur radar.
  • Faux échos : le radar peut aussi voir les parois latérales, le fond d’un puits, le support ou un couvercle au-dessus du capteur, ainsi que les échos qui rebondissent entre ces éléments. Orientez le radar droit vers la cible, tenez le faisceau à l’écart des parois et limitez la plage à la zone où peut se trouver la cible (voir Méthodes radar).
  • L’eau calme fait miroir : orientez le radar droit vers le bas au-dessus d’une surface calme, ou inclinez-le de quelques degrés seulement. Le faisceau ayant une largeur d’environ ±10°, une partie atteint encore la surface perpendiculairement si l’inclinaison est faible. Avec une inclinaison plus forte, le faisceau est renvoyé ailleurs, comme la lumière par un miroir, et l’écho est perdu.
  • Origine de la mesure : le point de référence du radar (point zéro) se situe à l’intérieur du boîtier, dans le plan de la puce radar : 11 mm (lentille standard) ou 26 mm (lentille étroite) en retrait de la face de la lentille.
Puck avec la lentille étroite vu de côté, lentille vers l’eau : le point zéro est marqué dans le plan de la puce radar, 26 mm au-dessus de la face de la lentille
Le point zéro : toutes les distances sont mesurées depuis le plan de la puce radar, 26 mm en retrait de la face de la lentille avec la lentille étroite (11 mm avec la lentille standard).
Quatre trajets radar dans un puits, avec Puck sur un support contre la paroi gauche, incliné de quelques degrés : le trajet direct jusqu’à la surface de l’eau, un trajet qui rebondit sur la paroi gauche, l’eau et la paroi droite, un double rebond entre la surface et le capteur, et un écho renvoyé par un rebord situé aux deux tiers de la descente
Seul le premier trajet (en vert) mesure le niveau d’eau. Les autres produisent de faux échos : rebond sur la paroi gauche, l’eau et la paroi droite, double rebond entre la surface et le capteur, et petit rebord dans le puits, dont le coin rentrant, à la jonction avec la paroi, renvoie l’écho directement avant que le radar n’atteigne l’eau.

Quelle lentille pour quel usage

UsageLentilleEmplacement de Puck
Place de stationnementStandard, ou étroite pour une place exiguëÀ 10–300 cm au-dessus du sol, au-dessus ou devant la place
Niveau d’eau dans un puits ou un avaloirÉtroiteAu-dessus de l’eau, à l’écart des parois, incliné de quelques degrés pour que la condensation s’écoule sur le côté
Niveau de remplissage d’une cuve ou d’un silo, hauteur de neigeÉtroiteAu-dessus de la surface, orienté droit vers le bas
Conteneur à déchetsÉtroiteAu-dessus du conteneur, orienté vers le bas, ou sur une paroi latérale, orienté pour viser à travers le haut du conteneur

Trouver les antennes NFC

Le NFC ne porte qu’à quelques centimètres. Posez donc le téléphone à plat sur Puck, antenne contre antenne :

L’antenne NFC se trouve au centre du dessus de Puck, devant le radar ; posez le téléphone à plat dessus
  • Sur Puck : au centre du dessus, juste devant le radar.
  • 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 de Puck 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.
  • Ensuite, ne bougez plus : pour lancer la connexion au réseau, maintenez le téléphone immobile sur Puck pendant environ 5 secondes. Avec l’application Hugin, laissez-le en place jusqu’à ce que l’application ait terminé. 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 touchez son bouton NFC pour qu’elle affiche Ready to Scan, puis tenez le bord supérieur du dos de l’iPhone immobile sur le dessus de Puck. 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. Faites-lui ensuite rejoindre le réseau, réglez le radar selon l’usage prévu, et montez-le en dernier.

1

Déballer

Contrôlez Puck et repérez ses clés. Vérifiez de quelle lentille il est équipé (voir Introduction). 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

Posez le téléphone à plat sur le dessus de Puck 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).

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, Puck fait une nouvelle tentative toutes les 5 heures (réglage Time between join retries). 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 pile 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

Choisir la méthode et la plage du radar

Le radar ne mesure que lorsque Puck est connecté au réseau. Vérifiez quelle méthode radar est active, et qu’elle convient, avec sa plage, à l’usage et à l’emplacement (voir Méthodes radar). Définissez ensuite quand Puck transmet : pas de distance, moyennes et seuils d’alarme (voir Données transmises).

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

Nouvel usage ? Commencez par vérifier ce que le radar voit réellement. Activez le Bluetooth du radar avec l’application Hugin et essayez les méthodes et les réglages sur place dans SweIoT Toolbox, ou lancez un balayage par LoRaWAN pour voir où se trouvent les échos et quelle est leur intensité (voir Nouvel usage et SweIoT Toolbox).
6

Monter

Choisissez l’un des modes de fixation suivants :

  1. Adhésif, sur une surface lisse, sèche et plane, en métal ou en plastique. Nettoyez la surface avec un mélange d’alcool isopropylique et d’eau (50–70 % d’alcool) et laissez sécher. N’utilisez pas l’adhésif sur une surface grasse ni en dessous de +5 °C.
  2. Plaque de montage (vendue séparément) : collez Puck sur la plaque avec l’anneau adhésif de celle-ci, bien centré sur l’ouverture. Vissez la plaque sur un mur ou une poutre, ou fixez-la sur un tuyau ou un poteau avec des colliers passés dans ses fentes.
  3. Dans un trou percé, affleurant au mur ou au plafond : percez un trou de 45 mm, nettoyez-le et déposez une épaisse couche de mastic au fond. Placez-y Puck, embase vers le fond et lentille vers l’extérieur, et maintenez-le droit pendant la prise du mastic. Ne mettez ni mastic ni colle sur le capot de lentille, car cela perturberait le radar et vous empêcherait d’ouvrir Puck pour changer la pile.
  4. Dans un puits ou un avaloir : sur un support ou des sangles en travers de l’ouverture, orienté droit vers le bas, vers l’eau.
La plaque de montage de Puck : une fine plaque en acier avec un anneau adhésif, quatre trous de vis et quatre fentes pour colliers
La plaque de montage, 52 × 43 mm, en acier de 0,8 mm.
Trois Puck en service : sur un poteau en béton, sur un support dans un avaloir de chaussée, et sanglé en travers d’un puits
De gauche à droite : sur un poteau en béton ; sur un support dans un avaloir ; sanglé en travers d’un puits.
Montez Puck de façon à pouvoir approcher un téléphone du dessus (NFC) et, sauf dans un trou percé, à pouvoir le décrocher pour changer la pile.
7

Tester

Placez un objet devant le radar à une distance connue, ou attendez les premières mesures de la cible réelle.

Terminé quand : la distance (et, pour le stationnement, l’état occupé) arrive dans votre application et correspond à la distance réelle, mesurée depuis le point de référence du radar.
Avec la commande radar test:10, le radar mesure toutes les 10 secondes pendant 10 minutes, ce qui permet de voir aussitôt l’effet du montage. Envoyez-la depuis le menu Commands and Logs de SweIoT Toolbox, où chaque mesure s’affiche, ou par LoRaWAN sur le port 48. Dans ce cas, elle arrive après le message suivant de Puck, et seules les variations supérieures à la Radar Distance Hysteresis sont transmises. Si la distance vaut 0, est fausse ou varie sans cesse, consultez Dépannage avant de fixer Puck définitivement.
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
  • Méthode et plage du radar réglées selon l’usage
  • Capteur monté face à la cible sans obstacle, accessible pour le NFC et le changement de pile
  • Distances reçues et conformes à la distance réelle

4Utilisation du capteur

La carte radar mesure, et l’application VSM de la carte LoRaWAN décide de ce qui est envoyé. Les réglages indiqués en gras figurent dans le tableau des réglages et dans la partie Commandes radar.

Méthodes radar

La carte radar mesure selon une seule méthode à la fois. Ce manuel décrit les méthodes 3 à 8 du firmware radar 2.24. Chaque méthode a ses propres réglages : fréquence des mesures, plage, et intensité minimale d’un écho pour qu’il soit pris en compte. Vous choisissez et réglez la méthode au moyen des commandes radar (voir Commandes radar) ou dans SweIoT Toolbox.

N°MéthodeDonnées transmisesUsage typiqueIntervalle et plage par défaut
3WellL’écho le plus éloigné au-dessus du seuil, c’est-à-dire la surface. Les échos plus proches sont ignorés.Puits, avaloirs, fosses septiques, niveau d’eau, hauteur de neigeToutes les 300 s, 0,5–3,5 m
4BinL’écho le plus proche au-dessus du seuil, et un indicateur d’occupation après 3 détections consécutivesConteneurs à déchets et bennesToutes les 120 s, 0,15–1,15 m
5ParkingL’écho le plus fort, et l’état occupé lorsque son intensité atteint au moins 350Places de stationnementToutes les 30 s, 0,2–1,7 m
6SeatingL’écho le plus fort, et l’état occupé ou libre lorsqu’un certain nombre de mesures consécutives concordentSiègesToutes les 60 s, 0,24–1,24 m
7Adv_SeatingOccupé ou libre, confirmé sur plusieurs mesures ; en option, distinction entre fauteuil roulant et autre objetSièges dans les trains, les bus et les salles d’attente, emplacements pour fauteuil roulantÀ définir pour chaque installation
8Distance2La distance et l’intensité d’un écho dans chacune des deux zones, chaque zone ayant son propre seuil et son propre choix d’échoMesure de distance en général, deux ciblesToutes les 300 s ; zone 1 : 0,20–0,47 m, zone 2 : 0,50–0,60 m
  • Intervalle de mesure : fréquence à laquelle le radar mesure. Des mesures moins fréquentes économisent la pile.
  • Plage : début et longueur de la fenêtre dans laquelle le radar cherche, jusqu’à 7 m du capteur. Limitez-la à la zone où peut se trouver la cible, car une fenêtre plus courte est plus fiable et consomme moins.
  • Seuil : intensité minimale d’un écho pour qu’il soit pris en compte. Un seuil plus bas capte des échos plus faibles, mais aussi davantage de faux échos.
  • Moyennage : plusieurs balayages par mesure, combinés par médiane ou par moyenne, stabilisent la mesure sous la pluie ou la neige et au-dessus d’une eau agitée. Chaque balayage supplémentaire réduit l’autonomie de la pile, tout comme un plus grand nombre d’échantillons matériels par balayage (HWAAS).

Puits, niveau d’eau et hauteur de neige (méthode 3)

  • Réglez la plage de sorte qu’elle s’arrête au moins 10 cm au-dessus du fond du puits et que le niveau d’eau le plus haut prévu se situe dans sa moitié la plus éloignée.
  • Orientez Puck droit vers le bas, vers l’eau, ou inclinez-le de quelques degrés. Placez-le de sorte que le faisceau ne touche pas les parois, et éloignez les gros objets réfléchissants, comme les pièces métalliques, de ses abords et de l’espace au-dessus de lui.
  • Dans un puits, une légère inclinaison présente un second avantage : la condensation qui se forme sur la lentille s’écoule sur le côté au lieu de rester devant le radar.
  • Puck mesure la distance jusqu’à la surface. Calculez le niveau dans votre application : pour un niveau d’eau, profondeur du puits moins distance mesurée ; pour la hauteur de neige, distance jusqu’au sol nu moins distance jusqu’à la neige.
  • Si la surface n’est pas détectée (distance 0), abaissez le seuil. Si les mesures sautent à cause des vaguelettes, augmentez le nombre de balayages ou allongez la pause entre eux.
  • La plage adaptative (désactivée par défaut) fait suivre la surface à la fenêtre, de sorte que le radar ne balaie qu’une bande étroite autour d’elle. Cela économise la pile. Si le niveau sort de cette bande, Puck mesure aussitôt de nouveau toute la plage.

Conteneurs à déchets (méthode 4)

  • Montez Puck au-dessus du conteneur, orienté vers le bas, ou sur une paroi latérale, orienté pour viser à travers le haut du conteneur. La plage doit atteindre le fond du conteneur vide.
  • Le seuil est le réglage déterminant. Les déchets mous, comme le papier, réfléchissent faiblement et peuvent demander un seuil plus bas, alors que le métal réfléchit fortement. Si les parois ou le couvercle du conteneur produisent eux-mêmes des échos, relevez le seuil ou faites commencer la plage au-delà.
  • Plus la distance est courte, plus le conteneur est plein.
  • Quelle que soit la taille du conteneur, de la corbeille au grand conteneur en passant par le bac roulant, la méthode Distance2 à deux zones peut aussi indiquer quand le fond est recouvert et quand le conteneur est plein (voir l’exemple ci-dessous).

Stationnement (méthode 5)

  • Une place de stationnement est considérée comme occupée lorsque l’écho le plus fort de la plage atteint au moins 350. Ce niveau étant fixe, le montage et la plage doivent faire en sorte qu’une voiture renvoie un écho fort et une place vide un écho faible.
  • Choisissez la lentille d’après la largeur de la zone à couvrir, et arrêtez la plage là où peut se trouver la carrosserie, avant le sol, la bordure ou le plafond situés au-delà.
  • Il n’y a aucun filtrage. Si l’écho oscille autour de 350, l’état peut basculer sans cesse ; ajustez alors le montage ou la plage.
  • Si send only changes est activé dans les réglages système, Puck ne transmet que les arrivées et les départs, ce qui économise la pile (voir Réglages radar par position).

Sièges (méthodes 6 et 7)

  • Seating (6) ne passe d’occupé à libre, ou l’inverse, que lorsqu’un certain nombre de mesures consécutives concordent (3 par défaut dans chaque sens). Si un dossier de chaise ou un bord de table provoque un faux état occupé, relevez le seuil ou réduisez la plage.
  • Adv_Seating (7) est une méthode étendue de détection des places assises, destinée aux usages exigeants en matière d’occupation. Elle filtre les événements brefs avant de changer d’état, ne transmet qu’en cas de changement d’état et, en mode fauteuil roulant, distingue un fauteuil roulant d’un autre objet, par exemple un bagage.

Deux distances (méthode 8)

  • Chaque zone transmet son propre écho, au choix le plus proche, le plus fort ou le plus éloigné. Une zone dont la fin vaut 0 est désactivée.

Exemple : conteneur à déchets avec deux zones

Avec deux zones, un seul Puck placé au-dessus d’une corbeille, d’un bac roulant ou d’un conteneur peut vous apprendre trois choses. Supposons que Puck se trouve à 1,2 m au-dessus du fond.

  • Zone 1, de 0,2 m jusqu’à un peu au-dessus du fond (ici 0,2–1,1 m), avec choix de l’écho le plus proche : elle donne la distance jusqu’au sommet des déchets, donc le niveau de remplissage.
  • Zone 2, une zone étroite autour du fond (ici 1,15–1,25 m) : tant qu’elle renvoie un écho, le fond est encore visible. Lorsque l’écho disparaît, le fond est recouvert de déchets.
  • Aucun écho dans les deux zones : le radar ne voit rien au-delà de 0,2 m. Les déchets sont très probablement arrivés à moins de 0,2 m de Puck, et le conteneur est plein. (Un objet qui recouvre la lentille produit le même résultat ; si cela se produit avec un conteneur vide, vérifiez donc Puck.)

Pour ce réglage, il faut trois commandes radar, chacune envoyée dans un downlink distinct sur le port 48. sys:8 sélectionne la méthode 8. 8:600,,,,,,0.2,1.1,,,0,1.15,1.25 règle une mesure toutes les 10 minutes et définit la zone 1 (positions 7 et 8), l’écho le plus proche (position 11) et la zone 2 (positions 12 et 13). 8:,,,,,,,,,,,,,,,,0,0 désactive la zone d’exclusion 1 (positions 17 et 18) pour qu’elle ne masque aucune partie de la zone 1. La zone 2 est transmise sous la forme distance2 et amplitude2 (voir Messages).

Nouvel usage : voir ce que voit le radar

Avant de mettre en place un usage encore jamais réalisé, testez-le sur place pour savoir ce que le radar voit réellement : d’où viennent les échos, quelle est leur intensité et comment le faisceau est réfléchi par les parois, les équipements et la cible elle-même. Deux outils vous y aident.

  • SweIoT Toolbox : sur place, essayez les différentes méthodes et les différents réglages et observez directement les résultats (voir SweIoT Toolbox).
  • Balayage par LoRaWAN : sélectionnez la méthode 7 ou 8 et envoyez meth_cmd:2,start,end,sections sur le port 48, en indiquant le début et la fin en mètres. Le radar répond sur le port 32 par une liste qui donne l’intensité des échos le long de la zone : pour chaque tronçon, l’écho le plus fort, divisé par 10 (avec 0 tronçon, chaque point de mesure). Par exemple, meth_cmd:2,0.5,2.5,40 renvoie 40 valeurs de 0,5 à 2,5 m, une tous les 5 cm. La liste provient de la dernière mesure. Les méthodes 3 à 6 ne disposent pas de cette commande.

Grâce aux balayages, une plateforme IoT comme Yggio peut aussi étalonner automatiquement des Puck déjà montés. Elle demande un balayage à chaque Puck, repère la cible et les éventuels réflecteurs fixes, calcule les zones et les seuils et les renvoie sous forme de commandes radar, en recommençant jusqu’à obtenir le bon résultat.

Données transmises

L’application VSM de la carte LoRaWAN reçoit chaque mesure radar et n’envoie que ce qui a changé.

  • Distance et intensité de l’écho : elles sont envoyées lorsque la distance a varié de plus de la Radar Distance Hysteresis (10 cm par défaut) ou l’intensité de l’écho de plus de la Radar Amplitude Hysteresis. Avec la méthode Distance2, l’écho de la zone 2 est envoyé lui aussi.
  • État d’occupation : 1 ou 0, fourni par les méthodes qui évaluent l’occupation, à savoir Bin, Parking, Seating et Adv_Seating.
  • Distance moyenne : la distance est échantillonnée toutes les minutes et moyennée sur l’Average Distance Interval (24 heures par défaut). La moyenne est envoyée lorsqu’elle a varié de plus de l’hystérésis de distance.
  • Alarmes de distance : définissez un Distance Alarm Low Level et un High Level, en mètres depuis le capteur. L’alarme suit la distance moyenne et ne réagit donc pas plus vite que l’Average Distance Interval ; si vous utilisez l’alarme, raccourcissez cet intervalle. La valeur 0 désactive l’alarme basse.
  • Aucun écho détecté : lorsqu’une mesure ne trouve aucun écho au-dessus du seuil, le réglage Report Failed Measurements détermine la suite. S’il est désactivé (par défaut), rien n’est envoyé et la dernière distance transmise reste valable. S’il est activé, Puck transmet une distance de 0, ce qui vous permet de savoir, par exemple, que la cible est sortie de la plage.
  • Taux de détection : une fois par jour, le pourcentage de mesures qui ont trouvé un écho. Une baisse peut indiquer, par exemple, de l’eau qui s’écoule ou une forte pluie ou chute de neige qui empêche le radar d’obtenir un écho stable.

Température, humidité et pile

Toutes les 8 heures par défaut (periodic reports interval), Puck envoie la tension de la pile, la température et l’humidité, avec un compteur qui augmente de un à chaque envoi.

  • À l’intérieur du boîtier : la température et l’humidité sont mesurées à l’intérieur du Puck étanche, et non dans l’air ambiant. La température est précise à environ ±2 °C entre 0 et 30 °C et peut être corrigée avec Temperature Calibration.
  • L’humidité, signal d’alerte : Puck contient du gel de silice qui absorbe l’humidité. Si l’humidité ne cesse d’augmenter, c’est que de l’humidité pénètre dans le boîtier ou que le gel de silice est saturé (voir Entretien). L’humidité est aussi comparée toutes les heures au Humidity Alarm Level (60 % HR par défaut). Lorsque ce niveau est atteint, Puck envoie une alarme d’humidité en message confirmé, pour que le gel de silice puisse être remplacé, et la lève lorsque l’humidité est redescendue 5 % HR sous ce niveau. La valeur 0 désactive l’alarme.
  • Pile : la tension est mesurée pendant une mesure radar. Une valeur basse isolée est normale, de même qu’une tension plus basse par temps froid. Si elle reste inférieure à 2,8 V à des températures supérieures à +10 °C, changez la pile.

Mouvement et inclinaison

Puck peut vous signaler qu’il a été heurté, déplacé ou tourné. Réglez le Position Check Interval (désactivé par défaut) : Puck lit alors son accéléromètre à cet intervalle, lorsqu’il est connecté au réseau et immobile, de façon à mesurer la pesanteur. Le premier contrôle établit la référence, qui est envoyée sous la forme X, Y et Z. Si un contrôle ultérieur constate que Puck s’est écarté de la référence de plus du Position Moved Threshold (1,71 m/s², soit environ 10°, par défaut), il refait un contrôle une minute plus tard. Si Puck est toujours déplacé, il envoie la nouvelle référence et comptabilise le déplacement. Rien n’est envoyé tant que Puck reste en place. Un contrôle détecte un changement d’orientation (inclinaison ou rotation), mais pas un déplacement qui conserve l’orientation. Un Puck déplacé puis remis en place entre deux contrôles n’est pas détecté, pas plus qu’un Puck perturbé moins d’une minute, par exemple par la circulation. La référence est perdue au redémarrage et une nouvelle référence est alors envoyée ; en revanche, désactiver puis réactiver la fonction la conserve. Chaque contrôle consiste en une lecture d’environ 0,1 s ; le reste du temps, l’accéléromètre est éteint.

Position

Une fois par jour, tant qu’il est connecté au réseau, Puck recherche les points d’accès Wi-Fi et envoie le résultat, à partir duquel un service cloud peut déterminer sa position (voir Fonctionnement du positionnement Wi-Fi).

Données enregistrées

Les mesures prises lorsque Puck 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 de Puck, 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 : Puck Radar n’a pas de positionnement par satellite.

Réseau

  • Messages confirmés : le serveur réseau acquitte la distance, l’intensité de l’écho, la moyenne, les alarmes, l’état d’occupation, le taux de détection ainsi que les messages de mouvement et d’inclinaison. Si aucun acquittement n’arrive, Puck les renvoie, en attendant au maximum le Max time between ReSend tries (4 heures par défaut) entre deux tentatives.
  • Connexion au réseau : si Puck n’est pas connecté, il tente de rejoindre le réseau toutes les 5 heures (Time between join retries), et au moins une fois par jour. Un contact NFC déclenche immédiatement une tentative. Le radar est éteint tant que Puck n’est pas connecté au réseau.
  • Perte du réseau : Puck abandonne le réseau et s’y reconnecte s’il n’en a rien reçu pendant la durée du Time from last RX before unjoin (15 jours par défaut) ou du Downlink Timeout (voir Registres de l’appareil).
  • Itinérance : si le Roaming Network Count est supérieur à 1, Puck essaie tour à tour plusieurs identités de réseau lors de la connexion, en changeant le dernier chiffre de son AppKey. Chaque identité supplémentaire allonge la connexion et réduit l’autonomie de la pile.
  • Débit adaptatif : Puck 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 lui-même son débit, progressivement, 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.

Modifier les réglages

Il existe deux types de réglages : ceux de l’application VSM sur la carte LoRaWAN (moment des transmissions, alarmes, réseau) et ceux du radar sur la carte radar (méthode, intervalle, plage, seuil). Les uns comme les autres se modifient à distance, ou sur place avec une application :

Par LoRaWANSur place
Réglages de l’application (carte LoRaWAN)Downlinks sur le port 2 ou le port 7L’application NFC Hugin (Android), par exemple avec un QR code généré par le VSM Configuration Tool
Réglages du radar (carte radar)Commandes radar sur le port 48L’application SweIoT Toolbox (Android), en Bluetooth
Mises à jour logiciellesNouvelles applications VSMHugin : firmware et application VSM de la carte LoRaWAN. SweIoT Toolbox : firmware du radar, qui ne peut être mis à jour que de cette façon

Le VSM Configuration Tool génère les downlinks pour les deux types de réglages.

  1. Choisissez l’application : par son nom et sa version, ou par le rulesCrc32 du message que Puck envoie sur le port 15 (voir Application installée dans le capteur).
  2. Choisissez Custom et saisissez les valeurs souhaitées. Chaque réglage est présenté avec sa description, son unité et sa plage. Saisissez les commandes radar dans le champ Radar Module Commands, séparées par ;, par exemple sys:3;3:600.
  3. Récupérez le résultat : des downlinks pour les ports 2 et 48, 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.
Puck est un équipement de classe A : il reçoit un downlink juste après chaque uplink. Un nouveau réglage prend donc effet au plus tôt après le message suivant de Puck, et sur un réseau chargé, cela peut prendre plus longtemps. Tout réglage qui fait mesurer ou émettre Puck plus souvent réduit l’autonomie de la pile.

5Les applications Hugin et SweIoT Toolbox

Application NFC Hugin (carte LoRaWAN)

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 pile, 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.

Hugin met aussi à jour le firmware et l’application VSM de la carte LoRaWAN.

SweIoT Toolbox for Puck & Prism radar sensor

SweIoT Toolbox est une application Android, disponible sur Google Play, qui communique avec la carte radar en Bluetooth. Il n’en existe pas de version pour iPhone. Elle sert sur place à lire et modifier les réglages du radar et à mettre à jour son firmware.

  • Activer le Bluetooth du radar avec Hugin : le Bluetooth de la carte radar est désactivé la plupart du temps, pour trois raisons : cela économise la pile, réduit le trafic radio et limite l’accès à la carte radar, conformément au règlement européen sur la cyberrésilience (Cyber Resilience Act). Seul le propriétaire enregistré du capteur, ou les utilisateurs auxquels il en a donné le droit, peuvent activer le Bluetooth. Pour l’activer en vue d’utiliser SweIoT Toolbox, tenez le téléphone contre Puck, application Hugin ouverte (voir Trouver les antennes NFC), et appuyez sur Activate Radar Bluetooth. La carte radar est alors visible en Bluetooth pendant environ 20 secondes ; connectez-vous depuis SweIoT Toolbox dans ce délai. Un contact NFC sans l’application Hugin n’active pas le Bluetooth et se contente de faire envoyer un message à Puck. Vous pouvez aussi activer le Bluetooth à distance, par un downlink LoRaWAN, par exemple depuis Yggio, en réglant Radar BT Advertise trigger sur 1 (voir Réglages). Dans Yggio, seuls les utilisateurs disposant de droits sur le capteur peuvent envoyer ce downlink. En dehors de ces cas, la carte radar n’est visible que quelques secondes après chaque mesure.
  • Dans l’application : SweIoT Toolbox vous guide pour choisir une méthode radar et ajuster ses principaux réglages. Son menu Commands and Logs accepte les mêmes commandes radar que LoRaWAN.
  • Mises à jour : le firmware du radar ne peut être mis à jour qu’en Bluetooth, avec SweIoT Toolbox.

6Entretien et retrait

Pile

La pile est un élément lithium-chlorure de thionyle (LiSOCl₂) remplaçable, de 3,6 V et 2 100 mAh, choisi parce qu’il fonctionne de −30 à +80 °C. Son autonomie dépend de la méthode radar, de la fréquence des mesures radar, du moyennage et de la fréquence des transmissions de Puck. À titre indicatif, la pile dure bien plus de dix ans sur une place de stationnement avec une mesure toutes les 30 secondes, ou dans un puits ou un conteneur à déchets avec une mesure toutes les 10 minutes. Un bon réseau (SF7–SF9) y contribue, alors qu’une liaison faible réduit l’autonomie. Changez la pile lorsque la tension reste inférieure à 2,8 V au-dessus de +10 °C (voir Température, humidité et pile).

Changer la pile

Utilisez le kit de remplacement de pile de Sensative, qui comprend une pile neuve, un joint torique et un coussinet en caoutchouc neufs, ainsi que deux outils Star. Changez la pile dans un endroit sec.

L’outil Star, qui sert à ouvrir et à fermer Puck
L’outil Star. Utilisez-en un de chaque côté de Puck.
  1. Décrochez Puck. Placez un outil Star de chaque côté et tournez le capot de lentille dans le sens inverse des aiguilles d’une montre pour ouvrir le boîtier. N’utilisez jamais d’autres outils, qui risquent de casser le boîtier ou de l’empêcher de bien se refermer.
  2. Débranchez l’ancienne pile au niveau du connecteur et branchez la nouvelle. Maintenez la carte électronique avec un doigt pendant que vous retirez le connecteur. Sinon, les cartes risquent de sortir du boîtier avec lui et sont alors difficiles à remettre en place. Ne coupez pas les fils de la pile.
  3. Posez le nouveau coussinet en caoutchouc et le nouveau joint torique, et vérifiez qu’ils sont bien en place et propres, car ce sont eux qui assurent l’étanchéité de Puck.
  4. Refermez le boîtier en le tournant dans le sens des aiguilles d’une montre, d’environ un quart de tour, puis serrez à fond avec les deux outils Star.
  5. Puck redémarre et, s’il était déjà connecté, rejoint de lui-même le réseau. Vérifiez que les mesures arrivent. S’il n’a jamais été connecté, faites-lui rejoindre le réseau par NFC, comme à l’étape 3.
Puck Radar ouvert, avec la pile branchée sur son connecteur et le joint torique bleu
Puck ouvert : la pile branchée sur son connecteur et le joint torique bleu.

Humidité

Puck est étanche, et le gel de silice qu’il contient absorbe l’humidité qui se condense. Si l’humidité mesurée à l’intérieur ne cesse d’augmenter, ou si l’alarme d’humidité se déclenche (à 60 % HR par défaut ; voir Température, humidité et pile), ouvrez Puck comme indiqué ci-dessus, vérifiez le joint torique et remplacez le gel de silice.

Retirer Puck Radar

S’il est collé, glissez du fil dentaire derrière Puck et sciez doucement l’adhésif. S’il est sur une plaque de montage, dévissez ou découpez la plaque pour la libérer. Il est possible de changer la pile sans retirer la plaque.

Changer de serveur réseau

Supprimez l’appareil de l’ancien serveur réseau et ajoutez-le au nouveau. Puck perd alors l’ancien réseau et rejoint le nouveau. 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, sécurité et mise au rebut

  • Stockez les capteurs et les piles inutilisés entre +10 et +30 °C.
  • Ne court-circuitez pas la pile, ne la percez pas et ne la chauffez pas au-delà de +80 °C. N’ouvrez Puck que pour changer la pile.
  • Déposez les piles usagées dans un point de collecte des piles pour recyclage, et Puck, sans sa pile, avec les déchets d’équipements électroniques.

7Dépannage

ProblèmeSolution
La distance vaut 0, ou rien n’est détectéUne distance de 0 signifie qu’une mesure n’a trouvé aucun écho au-dessus du seuil (elle n’est envoyée que si Report Failed Measurements est activé). La cible est hors de la plage, ou son écho est trop faible. Vérifiez Start et Length of range, puis abaissez le seuil (voir Méthodes radar).
Distance2 : aucun écho dans une zoneVérifiez que les plages des deux zones et des zones d’exclusion sont correctement réglées. Une zone d’exclusion qui recouvre une zone de détection masque tous les échos qui s’y trouvent.
La distance est fausseLe radar voit un autre trajet, qui passe par une paroi, le fond, le support ou un couvercle. Orientez Puck droit vers la cible, raccourcissez la plage, relevez le seuil ou utilisez la lentille étroite (voir Ce que voit le radar).
Les mesures varient sans cesse sous la pluie, sous la neige ou au-dessus d’une eau agitéeAugmentez le nombre de balayages par mesure, avec la médiane activée, ou allongez la pause entre les balayages (voir Réglages radar par position). Ces deux solutions réduisent l’autonomie de la pile. Le taux de détection quotidien indique la proportion de mesures où le radar obtient un écho stable.
Aucune mesure, alors que Puck a rejoint le réseauLe radar ne mesure que lorsque Puck est connecté au réseau. Lisez les réglages radar en envoyant sys? sur le port 48, puis vérifiez la méthode et que le radar est bien actif (position 6).
Une commande radar reçoit la réponse *La commande a été refusée. Vérifiez son format et ses valeurs (voir Commandes radar), et lisez les valeurs actuelles avec sys? ou, pour une méthode, par exemple avec 3?.
SweIoT Toolbox ne trouve pas le radarActivez le Bluetooth avec l’application Hugin, qui nécessite des droits d’accès au capteur dans Yggio, puis connectez-vous dans un délai d’environ 20 secondes. Vous pouvez aussi envoyer le Radar BT Advertise trigger. SweIoT Toolbox n’existe que sous Android.
L’humidité intérieure ne cesse d’augmenter, ou l’alarme d’humidité se déclencheDe l’humidité pénètre dans le boîtier, ou le gel de silice est saturé. Vérifiez le joint torique et remplacez le gel de silice (voir Entretien). L’alarme se lève d’elle-même dès que l’humidité est redescendue 5 % HR sous le Humidity Alarm Level.
Aucun message de mouvement ou d’inclinaisonLe Position Check Interval vaut 0 par défaut, ce qui désactive la fonction. Réglez-le (voir Mouvement et inclinaison). Un déplacement qui conserve l’orientation, ou un Puck déplacé puis remis en place entre deux contrôles, n’est pas détecté.
La tension de la pile est basseVérifiez d’abord la température, car la tension baisse par temps froid. Si elle reste inférieure à 2,8 V au-dessus de +10 °C, changez la pile.
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 sur le dessus de Puck 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 (EU868).
Rien du tout dans le serveur réseauVérifiez que la passerelle est sous tension et connectée, et que Puck est à portée et ne se trouve pas dans une enceinte métallique. 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).
Un nouveau réglage reste sans effetUn downlink n’arrive qu’après le message suivant de Puck, voire plus tard sur un réseau chargé. Vérifiez qu’il est toujours en file d’attente et qu’il a été généré pour le rulesCrc32 indiqué par votre Puck.
Messages manquants ou irréguliersVérifiez le RSSI et le SNR. Puck est peut-être trop loin de la passerelle, ou trop profondément enfoncé dans un puits ou un ouvrage en béton. 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.
Aucune positionIl 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 à portée. Voir Fonctionnement du positionnement Wi-Fi.

8Référence technique

Cette partie s’adresse aux intégrateurs. Les valeurs ci-dessous concernent l’application Puck-radar 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, Puck 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 :

ApplicationPuck-radar
Versionnovembre 2026
rulesCrc32961870689 (hex 3954FB61)
Version précédentePuck-radar R31–R33, rulesCrc32 1946060128 : voir la révision A de ce manuel

Si vous avez manqué ce message, envoyez 00 sur le port 15 et Puck 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 Puck 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 Puck livrés avant la version de novembre 2026 exécutent Puck-radar R31–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 Puck-radar, Sensative peut proposer d’autres applications VSM pour la carte LoRaWAN de Puck. 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.

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 Puck et Square)
PortSensContenu
1UplinkMesures et alarmes (voir Messages)
11UplinkLes mêmes sorties, sous forme compressée
12UplinkDonnées enregistrées : message stocké pendant que Puck 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 à Puck de renvoyer l’identité de son application
23UplinkBalayage Wi-Fi, pour le positionnement
2DownlinkRéglages de l’application et demandes de lecture (voir Réglages sur le port 2)
2UplinkRéponse de Puck : les valeurs désormais en vigueur
7DownlinkConfiguration complète en un seul payload, commandes radar comprises (voir Configuration complète sur le port 7)
7UplinkÉtat de cette configuration : None, Applied, Error ou Dirty
48DownlinkCommande radar, sous forme de texte (voir Commandes radar)
32UplinkRéponse de la carte radar, sous forme de texte

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
distance912 octets, × 0,001mOuiLors d’une variation supérieure à la Radar Distance Hysteresis
amplitude902 octetsintensité de l’échoOuiLors d’une variation supérieure à la Radar Amplitude Hysteresis
distance2, amplitude293 922 octets chacune ; distance × 0,001m, intensité de l’échoOuiZone 2 de la méthode Distance2, avec la zone 1
occupied801 octet1 = occupé, 0 = libreOuiEn cas de changement, pour les méthodes qui évaluent l’occupation
distanceAverage942 octets, × 0,001mOuiÀ chaque Average Distance Interval, en cas de variation
averageDistanceAlarm811 octet0 = aucune, 1 = basse, 2 = haute, 3 = les deuxOuiLorsque l’état d’alarme change
radarDetectionPercentageDay952 octets% des mesures avec échoOuiUne fois par jour
radarVoltage_VB42 octets, × 0,001VNonAvec les messages périodiques
tempB62 octets, × 0,01°C, à l’intérieur du boîtierNonAvec les messages périodiques
humidityB52 octets, × 0,01% HR, à l’intérieur du boîtierNonAvec les messages périodiques
humidityAlarm821 octet0 = pas d’alarme, 1 = alarmeOuiLorsque l’humidité intérieure atteint le Humidity Alarm Level, puis lorsqu’elle est redescendue 5 % HR en dessous
positionX, positionY, positionZ99 9A 9B4 octets chacune, × 0,001m/s² (pesanteur sur chaque axe)OuiSi le Position Check Interval est réglé : orientation de référence, au premier contrôle et après chaque déplacement
positionMoves9C4 octetsdéplacements depuis le démarrageOuiAvec la nouvelle référence, après chaque déplacement
periodicReportsCounterBB4 octetscompteurNonAvec chaque message périodique
nfcContactCount984 octetscompteurOuiAprès un contact NFC, pour que Puck réponde même lorsque le radar est éteint

Réglages

Les valeurs par défaut sont celles avec lesquelles Puck démarre. L’id est celui qu’utilise un downlink sur le port 2. Les valeurs sont envoyées en unités du pas indiqué : un réglage au pas de 0,01 est envoyé multiplié par cent.

RéglageNom dans l’applicationIdFonctionUnitéPlageValeur par défaut
Radar Distance HysteresisdistanceHysteresisA2Variation de distance nécessaire pour qu’une nouvelle distance, ou une nouvelle moyenne, soit envoyée.m, pas de 0,010–1,270,10
Radar Amplitude HysteresisamplitudeHysteresisB0Variation de l’intensité de l’écho nécessaire pour qu’une nouvelle valeur soit envoyée.intensité de l’écho0–32 767250
Average Distance IntervalaverageDistanceIntervalMinutesB1Période sur laquelle la distance moyenne est calculée. Les alarmes suivent la moyenne.minutes2–32 7671 440
Distance Alarm Low LevelaverageDistanceLowAlarmLevelB2Alarme lorsque la distance moyenne est inférieure à ce niveau. 0 = désactivé.m, pas de 0,010–327,670
Distance Alarm High LevelaverageDistanceHighAlarmLevelB3Alarme lorsque la distance moyenne est supérieure à ce niveau.m, pas de 0,010–327,670
Report Failed MeasurementsreportFailedDistanceMeasurementsA30 = une mesure sans écho au-dessus du seuil n’est pas envoyée. 1 = elle est envoyée sous la forme d’une distance de 0.marche/arrêt0–10
Interval between periodic reportsperiodicReportsIntervalA4Fréquence d’envoi de la tension de la pile, de la température et de l’humidité.heures0–2508
Humidity Alarm LevelhumidityAlarmLevelA5Humidité à l’intérieur du boîtier à partir de laquelle l’alarme d’humidité est envoyée ; elle est contrôlée toutes les heures. La valeur 0 désactive l’alarme.% HR0–10060
Position Check IntervalpositionCheckIntervalMinutesBDFréquence à laquelle Puck contrôle son orientation pour le message de mouvement et d’inclinaison. La valeur 0 désactive la fonction : l’accéléromètre n’est pas lu et rien n’est envoyé.minutes0–32 7670 (désactivé)
Position Moved ThresholdpositionMovedThreshold_m_s2BEÉcart minimal entre le vecteur pesanteur mesuré et la référence pour que Puck soit considéré comme déplacé, exprimé comme la norme de la différence. Une inclinaison d’un angle donné produit un écart de 2 g sin(angle/2) : 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
Temperature CalibrationtemperatureUserCalibrationBCCorrection ajoutée à la température.°C, pas de 0,01−10 à +100
Radar BT Advertise triggerradarBtAdvertiseTriggerA1La valeur 1 rend la carte radar visible en Bluetooth pour SweIoT Toolbox.marche/arrêt0–10
Time between join retriestimeBetweenJoinAttemtsB8Délai entre deux tentatives de connexion lorsque Puck n’est pas connecté au réseau.minutes0–32 767300
Time from last RX before unjointimeBeforeUnjoinB9Durée pendant laquelle Puck peut rester sans nouvelles du réseau avant de s’y reconnecter.heures0–32 767360
Max time between ReSend triesmaxResendWaitTimeBADélai maximal entre deux tentatives lorsqu’un message confirmé n’est pas acquitté.secondes0–5 184 000 (60 jours)14 400
Roaming Network CountroamNetworkCountA0Nombre d’identités de réseau LoRaWAN à essayer tour à tour (voir Réseau).nombre1–151

Registres de l’appareil

Ces registres appartiennent au firmware et non à l’application, mais ils se modifient de la même manière. Ne les changez que si vous avez une raison de le faire.

RegistreNomIdFonctionUnitéPlageValeur par défaut
Downlink TimeoutLINKCHECK_TIMED0Durée pendant laquelle Puck 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 %, Puck 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 Puck 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 ; Puck 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 Puck quitte immédiatement le réseau, écrivez 1 (non connecté) dans son registre DEVICE_STATE : envoyez C8 00 00 00 01 sur le port 2 (base64 yAAAAAE=). Il se reconnecte ensuite de la même façon qu’après une perte du réseau (voir Réseau). Les mesures effectuées pendant qu’il n’est pas connecté sont conservées et envoyées une fois la connexion rétablie.

Puck n’acquitte pas ce downlink, même envoyé en mode confirmé, si bien qu’il ne déclenche 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. Puck démarre avec les valeurs par défaut indiquées dans le 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 Radar Distance Hysteresis de 0,05 m au pas de 0,01 est envoyée sous la forme 5. Puck 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 Puck lui-même.

Lire les valeurs

Un downlink de un à quatre octets sur le port 2 constitue une demande de lecture : Puck renvoie la valeur actuelle de chaque id qu’il contient.

Downlink sur le port 2Réponse de Puck
04Température actuelle, en centièmes de degré
05Humidité actuelle, en centièmes de pour cent
A2Radar Distance Hysteresis actuellement réglée (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.

Commandes radar

La carte radar accepte de courtes commandes sous forme de texte. Envoyez chacune dans un downlink sur le port 48, en ASCII ; le VSM Configuration Tool les génère pour vous à partir du champ Radar Module Commands. La carte radar répond sur le port 32, également sous forme de texte. Une réponse qui commence par = signifie que la commande a été acceptée, et * signale une erreur. Environ une heure après une modification (60 minutes par défaut), la carte radar envoie aussi les réglages avec lesquels elle fonctionne désormais, ce qui vous permet de les vérifier.

CommandeFonction
sys?Lire les réglages système
sys:3Sélectionner la méthode 3 (Well). Le premier réglage système est la méthode
3?Lire les réglages de la méthode 3 (valable pour chaque méthode)
3:600Régler sur 600 s le premier réglage de la méthode 3, l’intervalle de mesure
4:600,,0.15,1.2Modifier en une fois plusieurs réglages de la méthode 4, par position. Une position vide conserve le réglage correspondant, et les réglages qui suivent le dernier indiqué restent inchangés
measureEffectuer une mesure immédiate
test:10Mode test : une mesure toutes les 10 s pendant 10 minutes, puis retour au fonctionnement normal. Pratique pendant l’installation
meth_cmd:2,0.5,2.5,40Méthodes 7 et 8 : balayage de 0,5 à 2,5 m en 40 tronçons (voir Nouvel usage)
versionLire la version du firmware radar
restartRedémarrer la carte radar
factoryRétablir les valeurs d’usine de tous les réglages radar, système et méthodes

Réglages radar par position

Les réglages de chaque méthode forment une seule chaîne de valeurs séparées par des virgules, dans un ordre fixe. Voici les réglages que l’on modifie habituellement, avec leur valeur par défaut :

MéthodePosition : réglage (valeur par défaut)
3 Well1 : intervalle, s (300) · 2 : HWAAS, 1–63 (20) · 3 : début de la plage, m (0,500) · 4 : longueur de la plage, m (3,000) · 5 : balayages par mesure (3) · 10 : plage adaptative, m, 0 = désactivée (0) · 11 : médiane, 1 = activée (1) · 12 : seuil (200) · 13 : pause entre les balayages, ms (1 000) · 14 : profil radar, 1–5 (2)
4 Bin1 : intervalle, s (120) · 2 : HWAAS (20) · 3 : début de la plage, m (0,150) · 4 : longueur de la plage, m (1,000) · 5 : seuil (290) · 6 : décalage ajouté à la distance, mm (0)
5 Parking1 : intervalle, s (30) · 2 : HWAAS (10) · 3 : début de la plage, m (0,200) · 4 : longueur de la plage, m (1,500)
6 Seating1 : intervalle, s (60) · 2 : HWAAS (30) · 3 : début de la plage, m (0,240) · 4 : longueur de la plage, m (1,000) · 5 : seuil (200) · 6 : décalage, mm (0) · 7 : mesures consécutives pour passer à occupé (3) · 8 : idem pour passer à libre (3)
8 Distance2Deux zones, chacune avec son propre seuil et son propre choix d’écho, et jusqu’à deux zones d’exclusion (positions 7–22 ; voir l’exemple plus haut)

Par exemple, 3:,,,,,,,,,,,150 abaisse à 150 le seuil de la méthode Well sans modifier le reste.

Les réglages système forment eux aussi une seule chaîne. La position 1 correspond à la méthode. La position 8, send only changes (0 = désactivé), fait que Puck n’envoie que les résultats qui ont changé, comme les arrivées et les départs sur une place de stationnement : sys:,,,,,,,1. Laissez les autres réglages système tels qu’à la livraison. En particulier, ne modifiez jamais le réglage de transport (position 7), car il peut couper la carte radar de LoRaWAN.

  • HWAAS : nombre d’échantillons moyennés par la puce radar pour chaque point. Plus il y a d’échantillons, moins il y a de bruit, mais la mesure prend plus de temps et l’autonomie de la pile diminue.
  • Profil radar : un profil plus élevé fournit davantage de signal pour les longues distances, comme dans les puits profonds, au détriment de la résolution en distance.

Exemple 1 : avaloir, niveau d’eau toutes les 10 minutes et alarme d’inondation

Objectif : sélectionner la méthode Well avec une mesure toutes les 10 minutes, calculer la moyenne sur 30 minutes au lieu de 24 heures, et déclencher l’alarme lorsque l’eau arrive à moins de 1 m de Puck. Les exemples sont construits selon le format d’enregistrement décrit dans Réglages sur le port 2 et avec les commandes radar, pour le rulesCrc32 961870689, 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 soit les downlinks dans l’ordre, soit le payload unique pour le port 7, mais pas les deux.

RéglageValeurValeur envoyéeEnregistrement
Radar Module Commandssys:3;3:600deux commandes radarsys:3 et 3:600 sur le port 48
Average Distance Interval30 min30B1 00 00 00 1E
Distance Alarm Low Level1,00 m100B2 00 00 00 64
PortDownlink (hex)Base64
2B1 00 00 00 1E B2 00 00 00 64sQAAAB6yAAAAZA==
4873 79 73 3A 33c3lzOjM=
4833 3A 36 30 30Mzo2MDA=
Ou 739 54 FB 61 02 0A B1 00 00 00 1E B2 00 00 00 64 30 05 73 79 73 3A 33 30 05 33 3A 36 30 30 00 4C 5F C1 59

Exemple 2 : conteneur à déchets de 1,2 m de profondeur, contrôlé toutes les 10 minutes

Objectif : sélectionner la méthode Bin, mesurer toutes les 10 minutes sur une plage de 0,15 m à 1,35 m, et envoyer une nouvelle distance à chaque variation de 5 cm.

RéglageValeurValeur envoyéeEnregistrement
Radar Module Commandssys:4;4:600,,0.15,1.2deux commandes radarsys:4 et 4:600,,0.15,1.2 sur le port 48
Radar Distance Hysteresis0,05 m5A2 00 00 00 05
PortDownlink (hex)Base64
2A2 00 00 00 05ogAAAAU=
4873 79 73 3A 34c3lzOjQ=
4834 3A 36 30 30 2C 2C 30 2E 31 35 2C 31 2E 32NDo2MDAsLDAuMTUsMS4y
Ou 739 54 FB 61 02 05 A2 00 00 00 05 30 05 73 79 73 3A 34 30 0F 34 3A 36 30 30 2C 2C 30 2E 31 35 2C 31 2E 32 00 87 9D 91 68

Exemple 3 : alerte plus précoce pour le gel de silice et contrôle de l’inclinaison toutes les heures

Objectif : envoyer l’alarme d’humidité dès 50 % HR à l’intérieur du boîtier, et vérifier une fois par heure si Puck a été déplacé ou tourné.

RéglageValeurValeur envoyéeEnregistrement
Humidity Alarm Level50 % HR50A5 00 00 00 32
Position Check Interval60 min60BD 00 00 00 3C
PortDownlink (hex)Base64
2A5 00 00 00 32 BD 00 00 00 3CpQAAADK9AAAAPA==
Ou 739 54 FB 61 02 0A A5 00 00 00 32 BD 00 00 00 3C 00 FE 13 F4 A2

9Caractéristiques techniques

RadarRadar cohérent à impulsions, 60 GHz (Acconeer A111)
Plage de mesure0,2–7 m, résolution et précision de 1 mm ; distance mesurée depuis le point de référence du radar, à l’intérieur du boîtier, 11 mm (lentille standard) ou 26 mm (lentille étroite) en retrait de la face de la lentille
FaisceauLentille standard : environ ±60° ; lentille étroite : environ ±10°
Méthodes radarWell, Bin, Parking, Seating, Adv_Seating, Distance2 (firmware radar 2.24)
Autres capteursTempérature (±2 °C typ. entre 0 et 30 °C) et humidité, à l’intérieur du boîtier, avec alarme d’humidité pour le gel de silice ; accéléromètre 3 axes pour les mouvements et l’inclinaison
PositionnementBalayage Wi-Fi une fois par jour ; nécessite un service cloud qui prend en charge le positionnement Wi-Fi
MémoireJournal de données intégré, transmis par LoRaWAN lorsque Puck se connecte
RadioLoRaWAN 1.0.4, classe A, OTAA ; JoinEUI 70B3D52C0001D4C3
Plan de fréquencesEU868
Portée radioJusqu’à 10 km en visibilité directe
ConfigurationLes deux cartes par LoRaWAN ; sur place, avec Hugin (NFC, Android) et SweIoT Toolbox (Bluetooth, Android)
Mises à jourCarte LoRaWAN : firmware et application VSM avec Hugin, applications VSM également par LoRaWAN. Carte radar : firmware uniquement en Bluetooth, avec SweIoT Toolbox
ApplicationApplication VSM Puck-radar (November 2026)
PileLiSOCl₂ remplaçable, 3,6 V, 2 100 mAh ; bien plus de dix ans selon la méthode et la fréquence des mesures
Indice de protectionIP67, étanchéité assurée par un joint torique
Température de fonctionnement−30 à +80 °C
Température de stockage+10 à +30 °C
DimensionsØ 45 × 30 mm (lentille standard) ou Ø 45 × 45 mm (lentille étroite)
Poids38 g (lentille standard) · 43 g (lentille étroite), pile comprise
MontageAdhésif fourni ; plaques de montage vendues séparément ; trou percé, support ou sangles

10Assistance

Sources : Sensative Docs, Puck Radar (consulté le 31 octobre 2026) ; PUCK Radar Sensor User Manual, firmware radar 2.24 ; fiche produit Puck Radar, Rev B ; sources et documentation des applications dans le dépôt vsm-applications de Sensative (Puck-radar, 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.