Modifications

{{FEATHER-WEBREPL-NAV}}

{{FEATHER-WEBREPL-NAV}}

== Activer WebREPL ==

== Activer WebREPL ==

La première étape pour utiliser WebREPL est de vous assurer qu'il est activé sur votre carte ESP8266. La façon la plus simple  d'activer WebREPL est de charger le "Build Officiel di Firmware MicroPython ESP8266" sur votre carte. Le build officiel dispose de WebREPL activé par défaut. Les builds officiels sont [http://micropython.org/download/#esp8266 disponibles sur la page de téléchargement de MicroPython]. Sélectionnez une version stable disposant proposant un numéro comme '''1.8.3''' (laissez de côté les builds journaliers qui portent un numéro comme '''1.8.3-52-gb0e2106''').   

La première étape pour utiliser WebREPL est de vous assurer qu'il est activé sur votre carte ESP8266. La façon la plus simple  d'activer WebREPL est de charger le "Build Officiel de Firmware MicroPython ESP8266" sur votre carte. Le build officiel dispose de WebREPL activé par défaut. Les builds officiels sont [http://micropython.org/download/#esp8266 disponibles sur la page de téléchargement de MicroPython]. Sélectionnez une version stable disposant proposant un numéro comme '''1.8.3''' (laissez de côté les builds journaliers qui portent un numéro comme '''1.8.3-52-gb0e2106''').   

Voyez notre guide [[FEATHER-CHARGER-FICHIER-MICROPYTHON|décrivant comment flasher le Firmware MicroPython sur une carte]] si vous ne savez pas encore comment faire.

Voyez notre guide [[FEATHER-CHARGER-FICHIER-MICROPYTHON|décrivant comment flasher le Firmware MicroPython sur une carte]] si vous ne savez pas encore comment faire.

La procédure est décrite dans ce tuto.

La procédure est décrite dans ce tuto.

== Accéder à WebREPL ==

== Accéder à WebREPL ==

{{download-box|Télécharger le client WebREPL|https://github.com/micropython/webrepl/archive/master.zip}}

{{download-box|Télécharger le client WebREPL|https://github.com/micropython/webrepl/archive/master.zip}}

If you download the WebREPL client extract the files and open '''webrepl.html''' in your browser (Firefox and Chrome are the officially supported browsers at this time).

Si vous avez téléchargé le client WebREPL, vous disposerez d'un fichier '''webrepl.html''' que vous pourrez ouvrir dans votre navigateur (Firefox et Chrome sont officiellement supportés).

Note you can't access the WebREPL client page directly from the ESP8266 board. To save space in flash memory the ESP8266 only provides a websocket interface and not the actual client webpage.  You'll need to download the WebREPL client page ahead of time or access it from the internet.

{{underline|Note:}} Vous ne pouvez pas accéder à la page WebREPL client directement depuis la carte ESP8266. Cela permet d'économiser de la mémoire flash sur l'ESP8266. Seul l'interface websocket WebREPL est disponible sur L'ESP8266.  Vous aurez besoin de télécharger le client WebREPL séparément sur votre ordinateur ou de l'utiliser depuis Internet.

Once the WebREPL client page is loaded you should see something like the following (as of ~August 2016, be aware the WebREPL is under active development and might change how it looks over time!):

Une fois la page client de WebREPL chargée, vous devriez voir une interface similaire à celle ci-dessous (comme connu en Août 2016, notez que WebREPL reste activement en développement et pourrait changer d'apparence avec le temps!):

{{ADFImage|FEATHER-WEBREPL-ACCESS-12.png}}

{{ADFImage|FEATHER-WEBREPL-ACCESS-12.png}}

'''Now make sure your computer is connected to the ESP8266's WiFi network''', then click the '''Connect''' button (using the default address of '''ws://192.168.4.1:8266/''' next to the button).

'''Assurez-vous maintenant que votre ordinateur est bien connecté sur le réseau WiFi de l'ESP8266''', cliquez ensuite sur le bouton '''Connect''' (en utilisant l'adresse par défaut de l'ESP8266 '''ws://192.168.4.1:8266/''' juste à côté du bouton).

{{ADFImage|FEATHER-WEBREPL-ACCESS-13.png}}

{{ambox|text=Toutes les connexions WebRepl seront refusées si le mot de passe n'a pas été configuré!}}

Set a password and remember it as it will be required for future access to the WebREPL.  Should you ever forget the password or wish to change it you'll need to erase the flash memory and reload MicroPython firmware!

Saisissez le mot de passe et vous devriez être connecté à WebREPL!

Once the password is set the board will disconnect from the WebREPL and reset itself. ''' Note if you're using daily or development firmware you'll need to connect to the board's serial REPL and enable the WebREPL again after the restart!'''

{{ADFImage|FEATHER-WEBREPL-ACCESS-15.png}}

After the board restarts click the Connect button again to connect to the board. Now you should be prompted for the password that was set earlier:

Essayez ensuite de saisir du code sur l'invite de commande WebREPL et voyez les résultats retournées. WebREPL devrait fonctionner exactement comme une session REPL série (celle établie via la connexion USB-Série). Vous pourrez tester MicroPython, exécuter du code chargé sur la carte et plus:

{{ADFImage|FEATHER-WEBREPL-ACCESS-14.png}}

{{ADFImage|FEATHER-WEBREPL-ACCESS-16.png}}

Enter the password and you should be connected to the WebREPL!

C'est fini en ce qui concerne l'accès au WebRepl de l'ESP8266 via le réseau WiFi!

 

Accéder à WebREPL de l'ESP8266 via le réseau WiFi de l'ESP8266 est bien pratique pour un premier contact (ou phase de configuration)!

Try entering Python code at the REPL to see the output of it running.  The WebREPL should function just like the serial REPL so you can use it to experiment with MicroPython, run code you've loaded on the board, and more:

{{ADFImage|FEATHER-WEBREPL-ACCESS-16.png}}

Par contre, ce qui serait vraiment-vraiment cool, c'est de connecter l'ESP8266 sur le réseau WiFi domestique (celui de votre routeur/box Internet). Cette section se de la page se penche sur ce point.

That's all there is to accessing the WebREPL from the ESP8266's WiFi network!

Une fois connecté sur votre réseau WiFi domestique, vous pourrez accéder à WebREPL en utilisant l'adresse IP de votre ESP8266 (cette attribuée par votre routeur/box) sans pour autant perdre votre connexion Internet sur votre PC (en effet, votre PC reste également connecté sur votre routeur/box... cette fois, plus besoin de connecter le PC sur le réseau WiFi de l'ESP8266).

== Accéder WebREPL depuis d'autres réseaux WiFi ==

Pour pouvoir utiliser WebREPL sur un autre réseau WiFi (votre réseau WiFi domestique), il faudra indiquer à votre ESP8266 comment se connecter sur ce réseau.  La documentation officielle [https://docs.micropython.org/en/latest/esp8266/esp8266/quickref.html#networking MicroPython ESP8266] propose quelques commandes simples pour se connecter sur un réseau.   

Accessing the WebREPL over the ESP8266's own WiFi access point like above is handy if there's no router or other WiFi network available.  However if you do have access to a WiFi network you can instead connect the ESP8266 to this network and access the WebREPL from any other machine on the network.  This makes it easier to use the WebREPL without losing access to the internet or your own WiFi network on a laptop that can only be connected to one WiFi network at a time.

To use the WebREPL on another WiFi network you'll first need to connect the ESP8266 to the WiFi network.  The [https://docs.micropython.org/en/latest/esp8266/esp8266/quickref.html#networking MicroPython ESP8266 documentation shows] a few simple commands to connect to a network.  From the serial REPL (don't use the WebREPL since you'll lose access when the commands change to a different WiFi network!) run the following commands:

Saisissez les commandes suivantes depuis une connexion REPL série (n'utilisez pas WebREPL car vous perdrez la connexion durant le changement de réseau WiFi):

  <syntaxhighlight lang="python">

  <syntaxhighlight lang="python">

wlan = network.WLAN(network.STA_IF)

wlan = network.WLAN(network.STA_IF)

wlan.active(True)

wlan.active(True)

wlan.connect('ssid', 'password')

wlan.connect('ssid-du-WiFi', 'mot-de-passe')

  </syntaxhighlight>

  </syntaxhighlight>

{{ADFImage|FEATHER-WEBREPL-ACCESS-20.png}}

{{ADFImage|FEATHER-WEBREPL-ACCESS-20.png}}

Where '''ssid''' is the name of the WiFi access point SSID, and '''password''' is the password required to use the access point (try an empty string '' if no password is required).

Où '''ssid-du-WiFi''' est le nom SSID du point d'accès (celui de votre réseau domestique) et '''mot-de-passe''' le mot de passe requit pour accéder au point d'accès (essayez une chaine de caractère vide "" s'il n'y a pas de mot de passe).

After a moment the ESP8266 should connect to the WiFi network. You can run the ifconfig function to check that the board has been assigned an IP address and is on the network:

L'ESP8266 devrait se connecter sur le réseau WiFi après quelques instants. Vous pouvez utiliser la fonction {{fname|ifconfig}} pour vérifier si votre ESP reçu une adresse IP et s'il s'est connecté sur le réseau:

  <syntaxhighlight lang="python">

  <syntaxhighlight lang="python">

{{ADFImage|FEATHER-WEBREPL-ACCESS-21.png}}

{{ADFImage|FEATHER-WEBREPL-ACCESS-21.png}}

Notice the first result from the ifconfig call is the IP address assigned to the ESP8266 (192.168.1.207 in this example, but it will differ depending on your WiFi network). If you don't see an IP address then something is wrong with the WiFi configuration or connection to the network. Double check the SSID and password are correct and try the connect call again.

Le premier résultat retourné par l'appel {{fname|ifconfig}} est l'adresse IP assignée au module ESP8266 (192.168.1.207 dans cet exemple mais cela peut changer d'un réseau WiFi à l'autre). Si vous ne voyez pas d'adresse IP c'est que quelque-chose s'est mal passé avec la configuration ou la connexion sur le réseau WiFi. Vérifiez si votre SSID et mot de passe sont bien correct et réessayez encore.

'''One important thing to note is that the ESP8266 will always remember the last WiFi network it used and attempt to connect automatically on reboot'''. This is handy since it means when the ESP8266 boots up it will automatically connect to the last network without you having to run the commands above again. The board will only remember the last network though and not an entire history of older networks.

'''Une chose importante à noter l'ESP8266, c'est que lors d'un redémarrage/reboot, il se souviendra de la dernière connexion WiFi utilisée et réessayera de se connecter automatiquement sur ce réseau'''. C'est très pratique puisque lorsque un ESP8266 boot, il se reconnecte automatiquement sur le dernier réseau WiFi sans nécessiter la ressaisie des commandes de configuration. NB: la carte ne se souvient que du dernier réseau, elle ne maintient pas un historique des précédents réseaux connectés.

Once the board is connected to the WiFi network enable the WebREPL (as described in the previous section) and notice it prints two IP addresses that it's listening on:

Une fois la carte connectée sur le réseau WiFi vous pouvez réactiver WebREPL (comme décrit dans la section précédente) où vous pouvez noter les deux adresses IP sur lesquels WebREPL est à l'écoute:

{{ADFImage|FEATHER-WEBREPL-ACCESS-22.png}}

{{ADFImage|FEATHER-WEBREPL-ACCESS-22.png}}

In this case the WebREPL is listening on 192.168.4.1 which is the ESP8266's access point, and 192.168.1.207 which is the IP address of the ESP8266 on a WiFi network.

Dans le cas présent, WebREPL écoute sur l'adresse 192.168.4.1 (celle du point d'accès ESP8266) et 192.168.1.207 qui est l'adresse IP de l'ESP8266 sur le réseau WiFi domestique.

Now open the WebREPL and use the IP address of the board on your network instead of the 192.168.4.1 default:

Ouvrez maintenant WebREPL et '''utilisez l'adresse IP de votre réseau (192.168.1.207)''' au lieu de l'adresse IP 192.168.4.1 que vous pouvez utiliser lorsque vous vous connectez sur le réseau WiFi MicroPython-* créé par l'ESP8266:

{{ADFImage|FEATHER-WEBREPL-ACCESS-23.png}}

{{ADFImage|FEATHER-WEBREPL-ACCESS-23.png}}

Once connected you can use the WebREPL just as you were using it on the ESP8266's WiFi network!

Une fois connecté sur votre réseau WiFi domestique, vous pouvez utiliser WebREPL comme vous le faisiez avant!

 

Si vous connecter votre carte sur un réseau WiFi domestique, ce serait également une bonne idée de [[FEATHER-CHARGER-FICHIER-MICROPYTHON-DEBUG|désactiver la sortie de débogage]] puisque se connecter et se déconnecter d'un réseau WiFi peut générer de messages de débogage sur le REPL Série. Si la carte ne peut pas se connecter sur le réseau WiFi, comme lorsque vous déplacez votre ESP8266 à l'écart du réseau, vous verrez un flux constant d'information de débogage lorsque la carte fera ses différents essais de reconnexion/erreur sur le réseau WiFi.

 

Cette sortie de débogage peut causer des problèmes avec des outils comme ampy (qui essayent d'utiliser la connexion REPL série mais ne s'attendent pas à ce type de message de débogage).

 

En tout début de tutoriel, nous avons listé les réseau WiFi disponibles, dans lesquels nous avons retrouvé notre ESP8266 sous MicroPython.

 

 

 

Note if you're connecting the board to a WiFi network it is a very smart idea to [[FEATHER-CHARGER-FICHIER-MICROPYTHON-DEBUG|disable debug output]] since connecting and disconnecting WiFi network and can spew debug output to the serial REPL.  If the board can't connect to the WiFi network, like if you move it to a different location away from the network, you'll see a constant stream of debug output as the board tries and fails to reconnect to the network.  This debug output can cause problems with tools like ampy that try to use the board's serial REPL and don't expect the debug output.

Vous pourrez donc également utiliser l'URL {{fname|ws://ESP_1216CB:8266/}}, ce qui est bien pratique.

{{FEATHER-WEBREPL-TRAILER}}

{{FEATHER-WEBREPL-TRAILER}}