FEATHER-CHARGER-FICHIER-MICROPYTHON-RUNCODE

Introduction

En utilisant ampy, vous pouvez prendre du code python écrit sur votre odrinateur et l'exécuter sur sur un carte MicroPython connectée en USB-Série. Cela permet d'explorer MicroPython en utilisant un flux de traitement assez simple. Vous pouvez écrire vitre code sur votre ordinateur, dans votre éditeur de texte favoris, puis utiliser ampy pour l'exécuter sur la carte!

Exécuter (run)

Utilisez la commande run (exécuter) et spécifiez simplement le chemin du fichier Python présent sur votre ordinateur, attendez la fin de son exécution, voyez les sorties (instruction print')) affichés par le programme.

Créez le fichier d'exemple test.py sur votre ordinateur et copiez/collez y le code Pyhton suivant:

print('Hello world! I can count to 10:')
for i in range(1,11):
    print(i)

Ouvrez un terminal et placez vous dans le même répertoire que votre fichier test.py. Exécutez ensuite la commande ampy suivante pour exécuter le script sur votre carte MicroPython connectée en USB-Séerie:

ampy --port /port/serie run test.py

Où /port/serie est le chemin (ou nom) du port série correspondant à votre carte MicroPython connectée sur le port USB de votre ordinateur. Sur une machine Lunix (ex: Linux Mint, dérivé d'Ubuntu) cela se présente sous la forme /dev/ttyUSB0

Après exécution de la commande, vous devriez voir les sortie du scripts sur votre moniteur:

Crédit: AdaFruit Industries www.adafruit.com

Si vous recevez une erreur stipulant que ampy n'a pas reçu la réponse attendue (failed to receive the expected response) c'est probablement parce que la sortie des message de débogage n'a pas été désactivé sur carte. Voyez le lien mentionné en haut de page! Vérifiez également que votre carte est bien connéectée sur votre ordinateur et que vous avez spécifié correctement le port série de la carte. Finalement, assurez vous également que le fichier test.py se trouve bien dans le répertoire où vous vous trouvez (celui où vous allez exécuter ampy).

Attention: la commande run n'est pas un shell ou un outil qui permet d'envoyer des entrées (données) depuis l'ordinateur vers la carte! Si vous avez besoin d'envoyer des entrées/données vers la carte alors vous aurez besoin de connecter la carte et d'utiliser le REPL Série.

Par défaut la commande run attendra la fin d'exécution du script sur la carte avant d'afficher la sortie. Parfois, il arrive que vous n'ayez pas besoin de cette fonctionnalité --par exemple, lorsque votre script principal est une boucle infinie qui ne se termine jamais, auquel cas ampy attend indéfiniment la fin du script! Dans ce cas, ajoutez l'option --no-output à la commande run. Ce flag/drapeau informe ampy qu'il ne doit pas attendre de sortie de la part du script et n'attend donc pas la fin d'exécution de celui-ci. Ampy exécute le script et rend la main immédiatement au terminal.

Par exemple: modifiez le script test.py de façon à ce qu'il fasse un comptage à l'intérieur d'une boucle infinie:

import time
print('Hello world! I can count:')
i = 1
while True:
    print(i)
    i += 1
    time.sleep(1.0)  # attendre une seconde.

Exécutez ensuite le script sur votre carte avec l'option --no-output. Comme vous pourrez le constater, ampy rend immédiatement la main au système d'exploitation:

ampy --port /serial/port run --no-output test.py

Vous pouvez néanmoins ouvrir une session REPL Série et voir le compte augmenter chaque seconde!

Crédit: AdaFruit Industries www.adafruit.com

Gardez à l'esprit que le programme est toujours en cours d'exécution, ampy n'attend simplement pas qu'il se termine!

Comparaison avec Arduino

L'option --no-output est particulièrement approprié lorsque vous exécutez des scripts qui ressemblent au fonctionnement des croquis/sketch Arduino. Dans le monde Arduino, vous avez les fonctions setup et loop explicites qu'il faut remplir avec du code qui est exécuté une fois pour (dans setup) et duc code exécuté en boucle (dans loop).

MicroPython ne dispose pas de ce concept mais vous pouvez facilement le re-créer dans vos propres scripts Python!

Si vous jetez un coup d'oeil au script test.py ci-dessus, vous noterez que:

• tout le code situé avant l'instruction while True fonctionne comme la fonction setup() d'Arduino (exécuté une seule fois au démarrage du programme/script).
• tout le code situé à l'intérieur de l'instruction while True fonctionne comme la fonction loop() d'Arduino (le contenu est exécuté encore et encore et encore... à l'infini)

Pour rendre cela un peu plus clair, voici le fichier test.py avec des commentaire qui indique où se trouve la code correspondant à setup() et le code correspondant à loop():

###########################################################################
# Code setup() début ci-dessous, il est appelé au démarrage du programme  #
###########################################################################
import time
print('Hello world! I can count:')
i = 1

while True:
    ###################################################################
    # Code loop() inclus dans la boucle infinie.                      #
    # Cette section de code est appelé répétitivement                 #
    ###################################################################
    print(i)
    i += 1
    time.sleep(1.0)  # Delay for 1 second.

Si vous découvrez MicroPython alors que vous possédez déjà un savoir faire Arduino alors vous trouverez cette approche pratique pour garder la même façon de travailler qu'avec vos Arduino.

Placez votre code d'initialisation (setup) en premier puis écrivez votre code répétitif dans une boucle infinie while True.

Ajoutez simplement l'option --no-output à l'instruction ampy pour que ampy n'attende pas la fin de l'exécution de votre script!

---

Source: MicroPython Basics: Load Files & Run Code
Créé par Tony DiCola pour AdaFruit Industries.

Traduit par Meurisse D. pour MCHobby

Toute référence, mention ou extrait de cette traduction doit être explicitement accompagné du texte suivant : «  Traduction par MCHobby (www.MCHobby.be) - Vente de kit et composants » avec un lien vers la source (donc cette page) et ce quelque soit le média utilisé.

L'utilisation commercial de la traduction (texte) et/ou réalisation, même partielle, pourrait être soumis à redevance. Dans tous les cas de figures, vous devez également obtenir l'accord du(des) détenteur initial des droits. Celui de MC Hobby s'arrêtant au travail de traduction proprement dit.

Traduit avec l'autorisation d'AdaFruit Industries - Translated with the permission from Adafruit Industries - www.adafruit.com