29 917
modifications
Modifications
Sauter à la navigation
Sauter à la recherche
Ligne 1 :
Ligne 1 : − + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + − + − REPL stands for Read Evaluate Print Loop, and is the name given to the interactive MicroPython prompt that you can access on the WiPy. Using the REPL is by far the easiest way to test out your code and run commands. You can use the REPL in addition to writing scripts in {{fname|main.py}}.+ + + + + + + + + + + + + + + + + + + − To use the REPL, you must connect to the WiPy either via [[|telnet], or with a USB to serial converter wired to one of the two UARTs on the WiPy. To enable REPL duplication on UART0 (the one accessible via the expansion board) do:+ + + + + + + + + + + + + + + − <nowiki>>>> from machine import UART+ − >>> import os+ − >>> uart = UART(0, 115200) − >>> os.dupterm(uart)</nowiki> − Place this piece of code inside your boot.py so that it’s done automatically after reset.+ + − == Avec Windows == − First you need to install the FTDI drivers for the expansion board’s USB to serial converter. Then you need a terminal software. The best option is to download the free program PuTTY: [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html putty.exe]. − {{underline|'''In order to get to the telnet REPL:'''}}+ − Using putty, select {{fname|Telnet}} as connection type, leave the default port (23) and enter the IP address of your WiPy (192.168.1.1 when in {{fname|WLAN.AP}} mode), then click open.+ + + + + + + − {{underline|'''In order to get to the REPL UART:'''}}+ + − Using your serial program you must connect to the COM port that you found in the previous step. With PuTTY, click on “Session” in the left-hand panel, then click the “Serial” radio button on the right, then enter you COM port (eg COM4) in the “Serial Line” box. Finally, click the “Open” button.+
→Obtenir une ligne de commande REPL
{{WIPY-NAV}}
{{WIPY-NAV}}
{{traduction}}
== Obtenir une ligne de commande REPL ==
REPL signifie 'Read Evaluate Print Loop', ce que nous traduirons par 'boucle de Lecture Evaluation Affichage'. Comme l'indique son nom, REPL vous offre un accès à une ligne de commande MicroPython en mode interactif. Avec REPL, vous pourrez accéder à votre WiPy en ligne de commande et REPL est de loin la manière la plus simple de test votre code et d'exécuter des commandes. Vous pouvez utiliser REPL en plus d'écrire un script dans {{fname|main.py}}.
Pour utiliser REPL, vous devez cous connecter sur votre WiPy soit:
* via [[Hack-wipy-generalite#REPL_Telnet|telnet]]
* via un câble USB équipé d'un {{pl|144|convertisseur USB-Série}}, convertisseur que vous raccorderez sur l'un des deux ports série (UART) du WiPy.
Vous aurez besoin d'un petit bout de code supplémentaire dans {{fname|boot.py}} si désirez utiliser REPL via le port série UART0 (celui ci est accessible via la carte d'extension). Si c'est la cas, saisissez le script suivant:
<syntaxhighlight lang="python">
from machine import UART
import os
uart = UART(0, 115200)
os.dupterm(uart)
</syntaxhighlight>
En plaçant ce script directement dans {{fname|boot.py}} REPL sera automatiquement disponible sur UART0 même après une réinitialisation.
Vous pouvez identifier les broches du UART0 (et UART1) utilisées par la carte d'extension dans [[Hack-wipy-pinout#Port_s.C3.A9ries.2FUART|cette partie de notre tutoriel WiPy]]
<small>{{underline|Note de MCHobby:}} Vous pourrez fort bien saisir le script ci-dessus en REPL pour tester REPL sur UART0. Vous n'êtes pas obligé de saisir le code dans boot.py sauf si vous désirez cette fonctionnalité de façon permanente.</small>
=== Avec Windows ===
Pour commencer, il sera nécessaire d'installer un pilote FTDI (pour le convertisseur USB série présent sur la carte d'extension). Vous aurez ensuite besoin d'un logiciel "terminal". La meilleure option est de télécharger le programme libre PuTTY: [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html putty.exe].
{{underline|'''Pour obtenir l'invite REPL via telnet:'''}}
Sélectionnez {{fname|Telnet}} comme type de connexion si vous utilisez Putty, laisser le port par défaut (23) et saisissez l'adresse IP de votre WiPy (192.168.1.1 lorsqu'il est en mode point d'accès {{fname|WLAN.AP}})). Cliquz ensuite sur "Open".
{{underline|'''Pour obtenir le REPL sur l port série (UART):'''}}
En utilisant un programme ''terminal série'', vous devez vous connecter sur le port COM créé sur UART0 à l'étape précédente. Avec Putty, vous devez cliquer sur le "Session" dans le panneau de gauchhe, puis cliquer sur le bouton "Serial" (port série) disponible sur la droite. Saisissez alors le port COM (ex: COM4) dans la zone de saisie "Serial Line". Pour finir, cliquez sur le bouton "Open" pour ouvrir la connexion.
=== Avec Mac OS X ===
Ouvrez un terminal et exécutez:
<nowiki>$ telnet 192.168.1.1</nowiki>
ou:
<nowiki>$ screen /dev/tty.usbmodem* 115200</nowiki>
Lorsque vous voulez quitter le programme ''screen'' après avoir terminé, tapez CTRL-A CTRL-\.
=== Avec Linux ===
Ouvrez un terminal et saisissez:
<nowiki>$ telnet 192.168.1.1</nowiki>
ou
<nowiki>$ screen /dev/ttyUSB0 115200</nowiki>
== Obtenir une ligne de commande REPL ==
Vous pouvez également essayer le programme {{fname|picocom}} ou {{fname|minicom}} (déjà utilisé avec la PyBoard) à la place de ''screen''. Vous aurez besoin d'utiliser {{fname|/dev/ttyUSB01}} ou numéro plus élevé de {{fname|ttyUSB}}. Suivant les distributions, vous pourriez avoir besoin d'octroyer les permissions correcte à votre utilisateur pour qu'il puisse accéder au périphérique série (ex: groupe {{fname|uucp}} ou groupe {{fname|dialout}}, ou utiliser un ''sudo'').
== Utiliser l'invite REPL ==
Essayons maintenant d'exécuter des instructions MicroPython directement sur le WiPy.
Sur votre programme ''terminal série'' (PuTTY, screen, picocom, etc), vous devriez voir un écran vide avec un curseur qui clignote. Pressez la touche "Enter/Entrée/Retour clavier" et vous devriez voir apparaître l'invite de commande de MicroPython, ex: {{fname|>>>}}. Assurons nous que tout fonctionne correctement en utilisant le test ci-dessous:
<syntaxhighlight lang="python">
>>> print("Salut WiPy!")
Salut WiPy!
</syntaxhighlight>
Vous ne devez pas saisir les caractères {{fname|>>>}} visible dans l'exemple ci-dessus. Ils sont affichés par WiPy et indique que vous pouvez saisir du texte directement après cette invite de commande.
A la fin, après avoir saisit le texte {{fname|print("Salut WiPy!")}} et pressez la touche Enter/Entrée/Retour clavier, la sortie d'écran devrait être mise-à-jour et ressembler à l'exemple ci-dessus.
Si vous connaissez déjà python, vous pourrez essayer quelques commandes élémentaires ici.
Si rien n'a l'air de fonctionner comme attendu, vous pouvez essayer de réaliser une réinitialisation matérielle (''hard reset'') ou une réinitialisation logicielle ; voyez plus loin.
Avançons et essayons quelques autres commandes. Par exemple:
<syntaxhighlight lang="python">
>>> from machine import Pin
>>> import wipy
>>> wipy.heartbeat(False) # désactive le heartbeat
>>> led = Pin('GP25', mode=Pin.OUT)
>>> led(1)
>>> led(0)
>>> led.toggle()
>>> 1 + 2
3
>>> 4 // 2
2
>>> 20 * 'py'
'pypypypypypypypypypypypypypypypypypypypy'
</syntaxhighlight>
== Réinitialiser la carte (Reset) ==
Si quelque-chose ne se passe pas bien, il est possible de réinitialiser la carte (Reset) de deux façons différentes.
=== Soft Reset: Réinitialisation logiciel ===
La première option est de presser CTRL-D sur l'invite de commande MicroPython. Cela effectue une réinitialisation logicielle (''soft reset''). C'est une façon très pratique de réinitialiser l'interpréteur Python de votre carte. Chez MCHobby
You will see a message something like:
<syntaxhighlight lang="python">
>>>
PYB: soft reboot
MicroPython v1.4.6-146-g1d8b5e5 on 2015-10-21; WiPy with CC3200
Type "help()" for more information.
>>>
</syntaxhighlight>
=== Hard Reset: Réinitialisation matérielle ===
Si le réinitialisation logicielle ne fonctionne pas, il est possible d'opter pour une réinitialisation matérielle (''Hard Reset'', comme débrancher et rebrancher l'alimentation de la carte) en pressant le bouton RST (le petit bouton noir à côté de la LED heartbeat).
La réinitialisation matérielle clôture également toutes les sessions telnet qui pourraient être ouverte sur le WiPy.
{{WIPY-TRAILER}}
{{WIPY-TRAILER}}