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

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

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

La toute première fois que vous vous connectez sur WebREPL, vous verrez une invite vous demandant de saisir un nouveau mot de passe (''New Password'') pour protéger l'accès à l'ESP8266:

Une fois la connexion acceptée, vous verrez une invite vous demandant de saisir le mot de passe (''Password'') qui protège l'accès à l'ESP8266.

{{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é!}}

 

 

Si vous oubliez votre mot de passe (ou si vous avez besoin de le modifier) vous avez deux possibilités:

 

Une fois le mot de passe initialisé, la carte se déconnectera de WebREPL et se réinitialisera. Il est parfois nécessaire de redémarrer la carte en pressant sur le bouton "reset". '''Note: si vous utilisez un build journalier ou build de développement du Firmware alors vous aurez besoin de vous reconnecter en REPL série pour redémarrer à nouveau WebREPL!'''

 

 

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

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

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

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

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

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).

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