Comment télécharger le code MicroPython sur XBee 3: 18 étapes (avec photos)

2024 Auteur: John Day | [email protected]. Dernière modifié: 2024-01-30 09:07

MicroPython est un langage de programmation inspiré de Python 3.0 qui fonctionne sur des microcontrôleurs, tels que le XBee 3. MicroPython peut aider à réduire la quantité de fournitures et l'encombrement global de votre projet, et rendre les choses beaucoup plus faciles. Cependant, j'ai constaté que lorsque j'utilisais MicroPython, le processus de téléchargement et de téléchargement du code sur l'appareil était déroutant. Donc, cette instructable vise à expliquer le processus "simple" de la façon de télécharger du code sur et hors de votre XBee.

Si vous ne l'avez pas encore fait, consultez le Guide de programmation Digi MicroPython. Il est utile pour acquérir une connaissance approfondie du fonctionnement de MicroPython sur les XBees, ainsi que pour le dépannage.

Ce didacticiel ne suppose pas que vous êtes familiarisé avec XCTU, mais si vous l'êtes, vous pouvez lire les en-têtes de chaque section pour des étapes plus basiques sur la façon d'installer et de désinstaller le code MicroPython. Cela suppose que vous avez déjà écrit votre code et que vous l'avez enregistré en tant que fichier.py ou.mpy.

Le XBee que j'utilise utilise le protocole 802.15.4, donc toutes les différences que vous rencontrez entre le didacticiel et votre propre version de XCTU peuvent être dues à cela.

Quelques règles générales à respecter lors de l'utilisation de MicroPython sur les XBees:

- Gardez le débit en bauds à 115200 ou plus. Cela permet d'éviter la perte de données.

- Faites en sorte que votre code parcoure rapidement les paquets entrants. Lors de l'utilisation de MicroPython, le XBee ne peut contenir qu'une file d'attente de 4 paquets de données - une fois la file d'attente pleine, il rejette les nouvelles données entrantes.

- Assurez-vous que votre XBee est un XBee3. MicroPython ne fonctionne sur aucun autre modèle de XBee.

Fournitures

• XBee3 (autant que vous en avez besoin)
• Un XBee Explorer ou un dongle similaire qui vous permet de brancher votre XBee sur votre ordinateur
• Un ordinateur sur lequel XCTU est installé
• Un fichier.py ou.mpy contenant le code que vous souhaitez installer sur le XBee

Étape 1: Connectez votre XBee

Branchez le XBee que vous souhaitez programmer et ouvrez XCTU. Cliquez sur Ajouter des périphériques (l'icône qui ressemble à un XBee avec un + dessus) dans le coin supérieur gauche et sélectionnez le bon port COM. Assurez-vous que le débit en bauds est correct (nous avons laissé le XBees réglé sur 9600), puis cliquez sur Terminer pour connecter le XBee.

XCTU prend beaucoup de temps pour charger beaucoup de choses. Lorsque vous voyez la barre de chargement verte, que vous verrez fréquemment, soyez patient.

Étape 2: Assurez-vous que PS est défini sur 0 et AP est défini sur 4

Cliquez sur l'icône XBee sur le côté gauche de l'écran pour afficher ses paramètres sur le côté droit. Sur le côté droit de l'écran, faites défiler jusqu'à la section intitulée Commandes MicroPython et assurez-vous que PS est défini sur Désactivé [0]. Si ce n'est pas le cas, modifiez le paramètre et appuyez sur l'icône en forme de crayon à côté du paramètre à l'extrême droite pour écrire la modification sur le XBee. Faites de même dans la section intitulée Interface UART pour le paramètre AP et assurez-vous qu'il est défini sur MicroPython REPL [4].

Le paramètre PS détermine si le code s'exécute automatiquement ou non lorsque le XBee est allumé, et le paramètre AP est essentiellement le "mode de fonctionnement" dans lequel se trouve le XBee. Pour que MicroPython fonctionne, il doit être dans son propre "mode MicroPython". " Si PS est défini sur Activé [1], cela peut poser des problèmes avec certaines de ces étapes, je pense donc qu'il est préférable de le désactiver jusqu'à ce que j'aie fini de mettre à jour le code sur le XBee.

Étape 3: Ouvrez le gestionnaire de système de fichiers

Accédez à la section « Outils » dans la barre en haut de l'écran et sélectionnez Gestionnaire de système de fichiers. Il ouvre une fenêtre qui ressemble à celle illustrée ci-dessus - les fichiers sur votre ordinateur sont affichés à gauche et une fenêtre vide est affichée à droite.

Étape 4: Configurez le bon port COM

Appuyez sur Configurer. Sélectionnez le bon port COM, assurez-vous que le débit en bauds est correct, puis cliquez sur OK. Vous devriez voir le nom du port COM sélectionné à l'endroit où il était indiqué précédemment « Configurez le port avant de travailler avec le système de fichiers ».

Étape 5: Ouvrir la connexion au XBee

Appuyez sur Ouvrir. Si vous obtenez une erreur, débrancher et rebrancher le XBee, puis appuyer sur Ouvrir fonctionne généralement. Vous devriez maintenant voir les fichiers chargés sur le XBee sur le côté droit de la fenêtre. Si votre XBee est tout neuf, vous ne verrez probablement que deux dossiers, mais si votre XBee a déjà été utilisé, vous pouvez voir d'autres fichiers dans le répertoire (sur le mien, il y en a un appelé "main.py").

Étape 6: Supprimez l'ancien code dans le gestionnaire de système de fichiers

Si votre XBee n'a pas d'ancien code, vous pouvez ignorer cette étape.

Si vous mettez à jour un ancien fichier de code sur le XBee, vous devez d'abord supprimer l'ancien. Le XBee ne supprime pas automatiquement les anciennes versions de code et son stockage est très limité, vous devez donc supprimer manuellement les anciens fichiers de code.

Le code MicroPython sur le XBee doit se trouver dans un fichier nommé "main.py" pour que le XBee exécute automatiquement le code. Vous pouvez avoir plusieurs fichiers chargés sur le XBee, mais le seul qu'il s'exécutera au démarrage est "main.py", vous pouvez donc utiliser plusieurs modules tant que vous les importez dans "main.py". Si vous utilisez plusieurs modules, il vous suffit de supprimer celui que vous rechargez sur le XBee.

Tout d'abord, faites un clic droit sur le fichier que vous souhaitez supprimer et sélectionnez Supprimer. Après quelques instants, il disparaîtra du gestionnaire de système de fichiers. Le fichier est maintenant supprimé du stockage principal du XBee. Cependant, le XBee a également une mémoire de travail, où il stocke le dernier code qu'il a été invité à exécuter, et celui-ci doit également être effacé. Appuyez sur Fermer dans le coin inférieur droit pour quitter le gestionnaire de système de fichiers.

Étape 7: Changez AP en 1

Dans les paramètres de XBee sur le côté droit de l'écran, faites défiler jusqu'à la section qui dit Interface UART. Modifiez le paramètre AP en Mode API sans échappement [1], puis cliquez sur l'icône en forme de crayon pour l'écrire dans le XBee. Cela nous permet d'envoyer des commandes AT au XBee, ce que nous devrons faire pour effacer la mémoire de travail du XBee. Si vous utilisez votre XBee depuis le début, vous n'avez probablement pas à effectuer cette étape la première fois que vous téléchargez du code dessus, mais cela ne peut pas faire de mal de confirmer que la mémoire de travail est effacée.

Étape 8: Basculez vers le mode de fonctionnement des consoles et ouvrez la connexion

Passez en mode de fonctionnement des consoles en appuyant sur Alt-C ou en appuyant sur le bouton en haut à droite qui ressemble à un moniteur de télévision, et appuyez sur Ouvrir pour ouvrir la ligne de communication avec votre XBee. Nous utilisons ce mode pour parler à nos XBees.

Étape 9: Ouvrez le générateur de trames

Vers le côté droit de l'écran, sous la mention Envoyer un seul paquet, cliquez sur l'icône +, puis sur Créer un cadre à l'aide de l'outil « Générateur de cadres » dans la fenêtre contextuelle. Cela ouvre le générateur de trames, qui est illustré ci-dessus. Nous l'utilisons pour générer le message que nous enverrons au XBee.

Étape 10: Configurez le générateur de trames pour générer une commande AT

Là où il est indiqué Type de trame, cliquez sur la case pour ouvrir un menu déroulant et sélectionnez 0x08 - AT Command. L'écran changera au format indiqué ci-dessus.

Étape 11: entrez la commande AT pour effacer la mémoire de travail

Dans la zone en surbrillance rouge intitulée Commande AT, tapez PY. Il s'agit de la première partie de la commande AT, indiquant essentiellement à XBee que nous voulons faire quelque chose avec MicroPython. Dans la zone intitulée Valeur du paramètre, tapez E. Il s'agit de la commande MicroPython spécifique que nous voulons que le XBee exécute, qui efface la mémoire de travail du XBee (j'essaie de me souvenir de « E pour Effacer »). Au fur et à mesure que vous tapez, des chiffres apparaîtront dans la case en bas de l'écran.

Étape 12: Ajoutez le cadre

Appuyez sur OK. Vous êtes maintenant de retour à la fenêtre dans laquelle vous étiez avant d'entrer dans le générateur de cadres. Le nom du cadre n'a pas particulièrement d'importance pour nos besoins, alors ignorez-le. Vous devriez voir les chiffres de la dernière fenêtre dans la case de cette fenêtre. Si c'est le cas, sélectionnez Ajouter un cadre.

Étape 13: envoyer la commande AT

Le nouveau cadre « frame_0 » apparaît dans la boîte intitulée Send frames. Nous pouvons maintenant envoyer la commande AT au XBee. Assurez-vous que le cadre que nous venons de créer est mis en surbrillance, puis cliquez sur le bouton avec la flèche verte indiquant Envoyer le cadre sélectionné. Le texte bleu et rouge apparaîtra dans le journal des cadres ci-dessus.

Étape 14: Interpréter la réponse

Le texte bleu est la commande que vous venez d'envoyer et le texte rouge est la réponse du XBee. Cliquez sur le texte en rouge pour le lire. Vous pouvez voir une ligne d'hexadécimal similaire à ce que nous avons envoyé au XBee dans la fenêtre de droite. Vous pouvez copier et coller ceci dans l'outil Frames Interpreter (accessible en cliquant sur la flèche à côté de l'icône de l'outil ci-dessus), mais si l'avant-dernière paire de chiffres est un double zéro, cela signifie qu'il a réussi à effacer la mémoire de travail.

Étape 15: Changez AP en 4

Cliquez sur Fermer dans le coin supérieur gauche pour quitter la communication avec le XBee.

Cliquez sur l'icône d'engrenage pour revenir dans les paramètres de XBee, et faites défiler jusqu'à l'interface UART et modifiez le paramètre AP en MicroPython REPL [4]. Écrivez le nouveau paramètre sur le XBee en cliquant sur l'icône en forme de crayon.

Étape 16: faites glisser votre code dans le gestionnaire de système de fichiers

Retournez dans Outils > Gestionnaire de système de fichiers, configurez sur le bon port et cliquez sur Ouvrir. Sur le côté gauche de la fenêtre (les fichiers de votre ordinateur), accédez au code que vous souhaitez télécharger sur le XBee, puis cliquez et faites-le glisser vers le côté droit (les fichiers du XBee). Vous devriez voir le fichier apparaître sur le côté droit. Le nouveau code est maintenant téléchargé sur le XBee.

Étape 17: ouvrez le terminal MicroPython

Appuyez sur Fermer. Il est temps de s'assurer que le code fonctionne. Accédez à Outils > Terminal MicroPython. Sélectionnez Configurer, choisissez le bon port COM, puis appuyez sur Ouvrir. Il devrait y avoir un curseur noir clignotant dans la fenêtre. Appuyez sur Entrée et vous verrez l'invite MicroPython: >>>

Étape 18: Testez votre code

Appuyez sur Ctrl-R et le code du fichier "main.py" s'exécutera. Si tout fonctionne correctement, vous avez terminé ! Si vous voulez que le code s'exécute automatiquement lorsque le XBee est allumé, fermez le terminal MicroPython, et dans les paramètres du XBee, faites défiler jusqu'à MicroPython Commands, et changez le paramètre PS en Enabled [1], et appuyez sur l'icône crayon pour écrire le XBee.