Différences entre versions de « Hack-wipy-repl »

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche
 
(8 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
 
{{WIPY-NAV}}
 
{{WIPY-NAV}}
−
 
−
{{traduction}}
 
  
 
== Obtenir une ligne de commande REPL ==
 
== Obtenir une ligne de commande REPL ==
Ligne 20 : Ligne 18 :
  
 
En plaçant ce script directement dans {{fname|boot.py}} REPL sera automatiquement disponible sur UART0 même après une réinitialisation.
 
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>
 
<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 ==
+
=== 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].
 
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].
  
Ligne 35 : Ligne 35 :
 
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.
 
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 ==
+
=== Avec Mac OS X ===
 
Ouvrez un terminal et exécutez:
 
Ouvrez un terminal et exécutez:
  
Ligne 46 : Ligne 46 :
 
Lorsque vous voulez quitter le programme ''screen'' après avoir terminé, tapez CTRL-A CTRL-\.
 
Lorsque vous voulez quitter le programme ''screen'' après avoir terminé, tapez CTRL-A CTRL-\.
  
−
== Avec Linux ==
+
=== Avec Linux ===
−
Open a terminal and run:
+
Ouvrez un terminal et saisissez:
  
 
  <nowiki>$ telnet 192.168.1.1</nowiki>
 
  <nowiki>$ telnet 192.168.1.1</nowiki>
  
−
or:
+
ou
  
 
  <nowiki>$ screen /dev/ttyUSB0 115200</nowiki>
 
  <nowiki>$ screen /dev/ttyUSB0 115200</nowiki>
  
−
You can also try {{fname|picocom}} or {{fname|minicom}} instead of screen. You may have to use {{fname|/dev/ttyUSB01}} or a higher number for {{fname|ttyUSB}}. And, you may need to give yourself the correct permissions to access this devices (eg group {{fname|uucp}} or {{fname|dialout}}, or use sudo).
+
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 ==  
 
== Utiliser l'invite REPL ==  
−
Now let’s try running some MicroPython code directly on the WiPy.
+
Essayons maintenant d'exécuter des instructions MicroPython directement sur le WiPy.
  
−
With your serial program open (PuTTY, screen, picocom, etc) you may see a blank screen with a flashing cursor. Press Enter and you should be presented with a MicroPython prompt, i.e. {{fname|>>>}}. Let’s make sure it is working with the obligatory test:
+
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">
 
<syntaxhighlight lang="python">
−
>>> print("hello WiPy!")
+
>>> print("Salut WiPy!")
−
hello WiPy!
+
Salut WiPy!
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
In the above, you should not type in the {{fname|>>>}} characters. They are there to indicate that you should type the text after it at the prompt. In the end, once you have entered the text {{fname|print("hello WiPy!")}} and pressed Enter, the output on your screen should look like it does above.
+
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.
  
−
If you already know some Python you can now try some basic commands here.
+
Si vous connaissez déjà python, vous pourrez essayer quelques commandes élémentaires ici.
  
−
If any of this is not working you can try either a hard reset or a soft reset; see below.
+
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.
  
−
Go ahead and try typing in some other commands. For example:
+
Avançons et essayons quelques autres commandes. Par exemple:
  
 
<syntaxhighlight lang="python">
 
<syntaxhighlight lang="python">
 
>>> from machine import Pin
 
>>> from machine import Pin
 
>>> import wipy
 
>>> import wipy
−
>>> wipy.heartbeat(False)  # disable the heartbeat
+
>>> wipy.heartbeat(False)  # désactive le heartbeat
 
>>> led = Pin('GP25', mode=Pin.OUT)
 
>>> led = Pin('GP25', mode=Pin.OUT)
 
>>> led(1)
 
>>> led(1)
Ligne 91 : Ligne 92 :
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
== Réinitialiser la carte (Factory Reset) ==
+
== Réinitialiser la carte (Reset) ==
−
If something goes wrong, you can reset the board in two ways. The first is to press CTRL-D at the MicroPython prompt, which performs a soft reset. You will see a message something like:
+
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">
 
<syntaxhighlight lang="python">
Ligne 102 : Ligne 109 :
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
If that isn’t working you can perform a hard reset (turn-it-off-and-on-again) by pressing the RST switch (the small black button next to the heartbeat LED). During telnet, this will end your session, disconnecting whatever program that you used to connect to the WiPy.
+
=== 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}}

Version actuelle datée du 26 juin 2016 à 11:00


MCHobby investit du temps et de l'argent dans la réalisation de traduction et/ou documentation. C'est un travail long et fastidieux réalisé dans l'esprit Open-Source... donc gratuit et librement accessible.
SI vous aimez nos traductions et documentations ALORS aidez nous à en produire plus en achetant vos produits chez MCHobby.

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 main.py.

Pour utiliser REPL, vous devez cous connecter sur votre WiPy soit:

  • via telnet
  • via un câble USB équipé d'un 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 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: 

from machine import UART
import os
uart = UART(0, 115200)
os.dupterm(uart)

En plaçant ce script directement dans 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 cette partie de notre tutoriel WiPy

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.


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: putty.exe.

Pour obtenir l'invite REPL via telnet:

Sélectionnez 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 WLAN.AP)). Cliquz ensuite sur "Open".

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: 

$ telnet 192.168.1.1

ou: 

$ screen /dev/tty.usbmodem* 115200

Lorsque vous voulez quitter le programme screen après avoir terminé, tapez CTRL-A CTRL-\.

Avec Linux

Ouvrez un terminal et saisissez: 

$ telnet 192.168.1.1

ou 

$ screen /dev/ttyUSB0 115200

Vous pouvez également essayer le programme picocom ou minicom (déjà utilisé avec la PyBoard) à la place de screen. Vous aurez besoin d'utiliser /dev/ttyUSB01 ou numéro plus élevé de 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 uucp ou groupe 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: >>>. Assurons nous que tout fonctionne correctement en utilisant le test ci-dessous: 

>>> print("Salut WiPy!")
Salut WiPy!

Vous ne devez pas saisir les caractères >>> 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 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: 

>>> 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'

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: 

>>>
PYB: soft reboot
MicroPython v1.4.6-146-g1d8b5e5 on 2015-10-21; WiPy with CC3200
Type "help()" for more information.
>>>

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.

Tutoriel WiPy tutorials and examples & general information about WiPy sous copyright de Damien George et contributeurs en ce qui concerne MicroPython et/ou PyCom en ce qui concerne les informations relatives a WiPy et LoPy.

Tutoriel traduit par Meurisse D. pour MCHobby.be

Traduit avec l'autorisation de micropython.org - Translated with the authorisation of micropython.org également avec l'accord de Daniel Compara (créateur de WiPy).

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.

Récupérée de « https://wiki.mchobby.be/index.php?title=Hack-wipy-repl&oldid=19545 »