NOTE D APPLICATION Configuration hardware d'un module XBee par commande AT

Transcription

1 NOTE D APPLICATION Configuration hardware d'un module XBee par commande AT Cette note d application s adresse aux utilisateurs d un module XBee série 2 du constructeur Digi dont on peut voir une représentation ci-dessous. SOMMAIRE PRESENATION DU MODULE Xbee SERIE 2... p1 RENTRER EN MODE COMMANDE AT... p2 COMMANDE AT..... p2 SORTIR DU MODE COMMANDE AT... p5 EXEMPLE DE PARAMETRAGE D UN MODULE X XBee SERIE 2. p6 PRESENTATION DU MODULE Xbee SERIE 2 Figure 2 : Module XBee série 2 Figure 1 : Assignement des broches Le module XBee utilise une liaison asynchrone pour communiquer avec un microcontrôleur. La configuration des paramètres de la liaison RS232 (Vitesse, parité, start et stop, ) s effectue à l aide des commandes AT. Celles-ci peuvent être envoyées soit par un HyperTerminal soit via un microcontrôleur si l on ne possède pas de port série. C est cette deuxième méthode qui est présenté. Cela nécessite d utiliser au minimum les broches Vcc, GND, OUT et IN du module Xbee. Les broches OUT et IN doivent être connectées respectivement aux broches Rx et Tx d un microcontrôleur. Le module Xbee peut être alimenté entre 2,7 et 3,3 volts. 1/6

2 Vcc Vcc Vcc Tx Tx Microcontrôleur Module XBee série 2 Rx Rx Gnd Gnd Figure 3 : Montage simplifié d'un module XBee et d'un microcontrôleur Note : Les commandes AT ne permettent pas la mise à jour du firmware. RENTRER EN MODE COMMANDE AT Pour modifier ou lire les paramètres du module, on va dialoguer par des commandes "AT" à 9600 Baud (il s agit de la valeur par défaut du module).il faut tout d'abord passer dans le mode "commande" en envoyant 3 fois le caractère "+" soit 2B en hexadécimal en moins de 1 seconde. On doit respecter un temps de garde (de 1 seconde) avant et après l'envoi de ces 3 caractères. Le module répond par "OK" + "CR" ( ). Le caractère "+" et le temps de garde sont modifiables par une commande AT. Temps de garde 1 secondes Aucun caractère envoyé «+» «+» «+» Temps de garde 1 secondes Aucun caractère envoyé Commande AT possible Passage en mode AT Note : Le plus souvent, l échec pour rentrer en mode commande est dû à une erreur de vitesse de transmission. Il faut s assurer que l UART du microcontrôleur est bien régler à 9600bps. COMMANDE AT: Il existe un grand nombre de commande AT. Cette note d application en présente les principales dans le tableau 1. L ensemble des commandes AT existant peut se trouver à la page 29 du lien suivant : ftp://ftp1.digi.com/support/documentation/ _a.pdf Commande de lecture : Elle est constituée des 2 caractères ASCII: «A» et «T» suivis de 2 caractères spécifiques à la commande suivi d'un "CR" ( ). Le module renvoi alors la valeur de son paramètre. 2/6

3 Syntaxe d envoi d une commande AT de lecture: "AT" + "ASCII commande" + «CR» Exemple: ATDH Le module renvoi la valeur contenu dans le registre DH suivi de «CR». En cas d envoi d une commande AT non reconnu par le module Xbee, celui-ci retourne le message «ERROR». Commande d écriture : Elle est constituée des 2 caractères ASCII: "A" et "T" suivis de 2 caractères spécifiques à la commande, puis suit ou pas le caractère "Espace" et enfin suit le paramètre à écrire en hexadécimal. On termine la commande par un "CR" ( ). Le module répond par "OK" suivi d'un "CR" ( ). Les modifications des valeurs contenues dans les registres ne s appliquent qu une fois que l on est sorti du mode commande AT. Syntaxe d envoi d une commande AT : "AT" + "ASCII commande" + "Espace" (optionnel) + Paramètre (hexa) + «CR» Exemple: ATDH A3 Cette commande fixe la valeur du registre DH à 0xA3. Le module répond par «OK» suivi de «CR». ATWR le module sauve les paramètres modifiés dans sa mémoire non volatile et répond par «OK» suivi de «CR». En cas d envoi d une commande AT non reconnu par le module Xbee, celui-ci retourne le message «ERROR». Il est aussi possible d envoyer plusieurs commandes à la suite: Exemple: ATID 56, DL 6F1,WR Cette commande fixe la valeur du registre ID à 0x56. Puis fixe la valeur du registre DL à 0x6F1 et sauve les paramètres dans la mémoire EEPROM. Le module répond par «OK», «OK», «OK» suivi de «CR». Note : Si la vitesse de transmission est modifiée il faut penser à re-paramétrer l UART avec la nouvelle valeur dès que l on quitte le mode commande AT de façon à pouvoir communiquer avec le module Xbee par la suite. Tableau 1 : Commande AT Commande AT WR description Sauve les paramètres dans la mémoire non volatile. Il faut impérativement attendre la réponse "OK" du module avant de lui envoyer une nouvelle commande. Format du Valeur par paramètre défaut /6

4 RE Restaure les paramètres par défaut du module. Cette commande ne réinitialise pas le champ ID NR Réinitialise les paramètres de la couche réseau sur un ou plusieurs modules au sein du réseau. Toutes les informations de routages sont perdues. NR = 0 : réinitialise le module qui a reçu la commande NR = 1 : réinitialise tous les modules contenus dans le PAN DH Modifie ou lit les 32 bits MSB de l'adressage 0 0xFFFFFFFF 0 destinataire. DL Modifie ou lit les 32 bits LSB de l'adressage 0 0xFFFFFFFF 0xFFFF destinataire. MY Lit les 16 bit de l'adressage réseau du module. 0 0xFFFE 0xFFFE MP Lit les 16 bit de l'adressage parent du module. 0 0xFFFE 0xFFFE SH Lit les 32 bits MSB du n de série du module 0 0xFFFFFFFF Défini en usine SL Lit les 32 bits LSB du n de série du module. 0 0xFFFFFFFF Défini en usine CH Modifie ou lit le canal utilisé dans la bande 2,4 GHz. 0-0x1A 0 (0x0B) 1 (0x0C) 2 (0x0D) 3 (0x0E) 4 (0x0F) 5 (0x10) 6 (0x11) 7 (0x12) 8 (0x13) 9 (0x14) 10 (0x15) 11 (0x16) 12 (0x17) 13 (0x18) 14 (0x19) 0 ID NT Modifie ou lit l'adresse du Pan ID. Le changement de PAN est effectué lorsque le module est réinitialisé sur une commande FR, NR ou réalimenter. Défini ou lit le temps qu acceptera le module pour découvrir d autre nœud du réseau lorsque ND est activé 15 (0x1A) 0-0xFFFF 0x xFC [x 100 msec] 0x3C ND Cherche et donne les modules trouvés. Pour chacun on obtient: MY + SH + SL + DB + NI. La commande se termine au bout de 2,5 secondes et le module renvoie un "CR"(retour chariot). On peut faire suivre la commande d'un paramètre constitué des 20 caractères du NI d'un module. Dans ce cas on obtient en réponse uniquement les paramètres de ce module. optional 20- Byte NI or MY value PL Modifie ou lit la puissance de sortie du module = -10 / 10 dbm 1 = -6 / 12 dbm 2 = -4 / 14 dbm /6

5 3 = -2 / 16 dbm 4 = 0 / 18 dbm BD Vitesse de transmission = 1200 bps 1 = 2400 bps 2 = 4800 bps 3 = 9600 bps 4 = bps 5 = bps 6 = bps 7 = bps D7 Configuration contrôle de flux = CTS non permit 1 = RTS permit D6 Configuration contrôle de flux = RTS non permit D5 Configure la LED d association. La LED clignote 1*/sec quand le module est alimenté. La LED clignote 2*/sec quand le module rejoint un réseau 1 = RTS permit = Fonction non enclenchée 1 = Fonction enclenchée VR Lit la version firmware du module 0 0xFFFF Défini en usine CT Modifie ou lit le Time Out qui fait repasser le module en mode IDLE»repos» si aucune commande AT ne parvient. 2-0x028F [x 100 ms] 0x CN GT CC Dit explicitement au module de quitter le mode commande AT. Modifie ou lit le temps de garde entre l envoie de deux caractères. Cette période est utilisé pour éviter d entrer par inadvertance dans le mode commande AT. Modifie ou lit le caractère ASCII utilisé pour passer en mode commande x0CE4 0x3E8 [x 1 ms] (max of 3.3 sec décimale) 0-0xFF 0x2B ( + ) SORTIR DU MODE COMMANDE AT: Il existe deux méthodes pour sortir du mode commande AT : Si aucune commande AT n'est parvenue au module après son passage en mode commande pendant un temps de TIME OUT de 10 secondes (valeur par défaut et paramétrable par une commande AT), le module retourne en mode «repos». Pour quitter le mode commande avant la fin du Time OUT, il faut envoyer la commande AT suivante: ATCN et le module répond alors par "OK" 5/6

6 EXEMPLE DE PARAMETRAGE D UN MODULE XBee SERIE 2: Commande AT envoyé par le microcontrôleur via l UART +++ ATID 56 <entrer> ATMY <entrer> ATCH 2 <entrer> ATBD 7 <entrer> ATDH 0x2614AF <entrer> ATDL 0x65AFC5D <entrer> ATWR <entrer> ATCN <entrer> Réponse du module OK <CR> (Entre dans le mode commande AT) OK <CR> (positionne le PAN à 56) {valeur actuel} <CR> (lit l adresse réseau du module Xbee) OK <CR> (choix du canal 3) OK <CR> (vitesse de transmission bps) OK <CR> (modifie l adresse de destination haute) OK <CR> (modifie l adresse de destination basse) OK <CR> (sauve les paramètres dans mémoire non volatile) OK <CR> (quitte le mode commande AT) 6/6