Bienvenue dans notre série sur l'outil XCTU. Comme décrit dans un précédent billet,(Top 12 Digi XBee Management Tools in Free XCTU), Digi XCTU® offre une multitude de fonctionnalités utiles pour créer, déployer, gérer et tester les réseaux radio Digi XBee®. Même les fonctions de base contiennent quelques joyaux cachés, nous commencerons donc par une visite rapide du mode de configuration de XCTU pour mettre en évidence le support contextuel qui vous permet d'être entièrement responsable de vos XBee.
Étape 1
Commencez par télécharger et installer XCTU. Si vous avez besoin d'instructions détaillées, consultez le guide de l'utilisateur XCTU. Ensuite, montez un Digi XBee sur une carte d'évaluation XBIB, une carte de développement Grove ou similaire. Connectez cette carte à votre ordinateur à l'aide d'un câble USB. (Des détails supplémentaires sont disponibles dans la documentation du kit ZigbeeDigi XBee 3 et du kit LTE-MDigi XBee 3).

Étape 2
Ouvrez XCTU et cliquez sur l'icône Add Devices (Ajouter des dispositifs), puis sélectionnez le port USB et le débit en bauds corrects (9600 est la valeur par défaut de XBee). Cliquez sur Terminer pour ajouter le module à votre liste de périphériques.

Étape 3
En cliquant sur un module dans la liste des appareils à gauche, sa configuration s'affiche à droite. Il y a beaucoup de paramètres ! Certains modules ont 70 options de configuration différentes ou plus, mais XCTU vous protège. Cliquez sur l'icône "i" pour information
affichera une aide contextuelle comprenant une brève explication de la fonction, la façon de la configurer et la valeur par défaut. Par exemple, disons que nous voulons configurer un module Zigbee XBee 3 pour qu'il se mette en veille pendant vingt secondes, puis se réveille pendant une seconde pour vérifier les données, en répétant ce cycle indéfiniment.

Faites défiler la page jusqu'à la Modes de sommeil section. Vous pouvez utiliser les boutons + et -
en haut de la section de droite pour réduire et développer les catégories de paramètres de configuration. Vous pouvez également rechercher le code du paramètre, par exemple SM pour Sleep Mode, qui est ce que nous regardons en premier.
Étape 4
Lorsque vous avez localisé le paramètre Sleep Mode (SM), cliquez sur l'icône d'information pour afficher la description de ce paramètre. Pour le XBee 3 Zigbee, le texte est le suivant :
"Configurer/ lire le mode de sommeil : La broche Hibernate correspond à la puissance la plus faible, le sommeil cyclique réveille à l'expiration du minuteur, le sommeil cyclique réveille à l'expiration du minuteur ou lorsque Sleep_Rq (broche 9 du module) passe d'un état haut à un état bas. Si SM est réglé sur 0, le XBee est un routeur, sinon c'est un appareil terminal."
Nous savons que nous voulons que le module XBee se mette en veille et se réveille de manière répétée en fonction d'une minuterie. Le mode Sleep cyclique ressemble exactement à ce que nous voulons. Allez-y et réglez SM sur "Cyclic Sleep [4]". Pour masquer la description textuelle, il suffit de cliquer à nouveau sur l'icône d'information. Enfin, cliquez sur le crayon pour écrire votre changement dans le firmware.

Étape 5
Ensuite, nous voulons définir deux minuteries de sommeil différentes. L'une indiquera au XBee combien de temps il doit dormir, et l'autre lui dira combien de temps il doit rester éveillé entre les siestes. Commençons par regarder le réglage de la période de sommeil (SP).
Il existe trois types d'aide différents, uniquement pour ce paramètre.
- Le premier est la description de l'information. Cliquez sur l'icône d'information pour voir une brève description de ce paramètre, y compris quelques notes d'implémentation.
- Ensuite, le passage de la souris sur la zone de saisie de texte fait apparaître une fenêtre d'aide qui affiche la plage hexadécimale complète de ce paramètre ainsi qu'une traduction du code hexadécimal actuel avec le multiplicateur x10 en millisecondes lisibles par l'homme. Nous savons que nous voulons que notre XBee se mette en veille pendant 20 secondes. Cela représente 20 000 en millisecondes, mais qu'est-ce que cela représente en hexadécimal ?
- Cela nous amène au troisième type d'aide. Sur la droite, vous verrez une icône de calculatrice. Cliquez dessus pour afficher une fenêtre dans laquelle vous pouvez entrer des valeurs en millisecondes qui sont automatiquement traduites en codes hexagonaux avec le multiplicateur approprié. Entrez 20000 millisecondes ici et le code hexadécimal correct pour ce paramètre, 7D0, est automatiquement généré.

Pour définir la durée pendant laquelle le module doit rester éveillé, utilisez le paramètre Time before Sleep (ST). Nous voulons que le module dorme pendant une seconde ou 1000 millisecondes. La calculatrice utilisera le multiplicateur x1 de ST pour générer le code hexadécimal correct. En utilisant la calculatrice pour ST, entrez 1000 ms. Le code hexadécimal résultant devrait être 3E8.

Étape 6
Il existe un autre type de calculatrice qui est extrêmement utile pour travailler avec les paramètres des champs de bits. Les champs de bits sont essentiellement des commutateurs de caractéristiques binaires qui sont définis à l'aide d'un hexadécimal. Ils sont souvent utilisés pour activer et désactiver différentes options, ou pour configurer les canaux radio à utiliser.
Vous pouvez voir un exemple de champ de bits directement dans cette section Sleep, le paramètre Sleep Options (SO). Ouvrez la fenêtre pour obtenir une description du paramètre. Dans ce cas, la plupart des options sont réservées pour une utilisation ultérieure, de sorte que le seul bit que vous pouvez définir est le bit 2, si vous voulez un mode de sommeil étendu. Bien que nous n'ayons pas besoin de l'activer, si vous le souhaitiez, il vous suffirait de cliquer sur l'icône de la calculatrice, puis sur le bit sous "02" pour l'activer. (Le paramètre hexadécimal résultant serait 4).

Il peut être utile de voir les champs de bits utilisés dans un autre contexte. Le Zigbee Digi XBee 3 peut fonctionner sur un maximum de 16 canaux différents. Son paramètre Scan Channels (SC) stocke un champ de bits qui définit les canaux sur lesquels il peut fonctionner. Cliquez sur la calculatrice de ce paramètre pour voir que presque tous les canaux sont utilisés par défaut. Chaque bit définit un des canaux, donc pour désactiver le canal lié au bit 7 par exemple, il suffit de cliquer dessus et de le désélectionner.

N'oubliez pas que vos sélections ne sont enregistrées dans le microprogramme que lorsqu'elles sont écrites avec l'une des icônes de crayon. Pour rétablir les valeurs par défaut d'un module, cliquez sur Défaut en haut de la section de droite, puis enregistrez ces modifications à l'aide du crayon Écriture situé à côté.
Tout le monde sait que les Digi XBee sont faciles à installer et qu'ils offrent également de puissantes options de configuration. XCTU fournit toute l'assistance nécessaire, avec une aide contextuelle pour chaque option sur chaque XBee. Des calculateurs sont également disponibles pour aider à la saisie des données. Les modes de veille vous déconcertent ? Cliquez simplement sur l'icône d'information pour en savoir plus. Vous avez besoin de déterminer le champ de bits pour le balayage des canaux ? Sélectionnez les canaux souhaités à l'aide de la calculatrice en ligne et le reste est fait pour vous. XCTU vous permet d'être entièrement responsable de vos XBees et facilite l'utilisation de leurs puissantes fonctionnalités.