Modifications

Sauter à la navigation Sauter à la recherche
Page créée avec « This page is currently under translation == Pre-requisites == Note: cette page existe également en anglais Avant d'utiliser M… »
This page is currently under translation

== Pre-requisites ==
Note: [[FEATHER-CHARGER-MICROPYTHON-ESP8266-EN|cette page existe également en anglais]]

Avant d'utiliser MicroPython avec un ESP8266 il sera nécessaire de reflasher l'ESP8266 avec la dernière version de du firmware MicroPython.

Nous vous proposons ce tutoriel condensé (abordable) mais vous pouvez également [http://docs.micropython.org/en/latest/esp8266/esp8266/tutorial/intro.html#deploying-the-firmware suivre les instructions officielles] (''micropython.org, anglais'') pour charger MicroPython sur un ESP8266.

En tout premier lieu vous aurez également besoin [https://www.python.org/downloads/ d'installer Python 2.7] (n'oubliez pas de sélectionner l'option qui ajoute le programme python dans le PATH de recherche de windows).

Ensuite, il est nécessaire d'installer le logiciel {{fname|esptool.py}} qui permet de flasher un firmware sur ESP8266. La façon la plus simple d'installer ce logiciel est d'utiliser '''pip''' (l'installateur de paquet python).

Saisissez la commande suivante dans un terminal:

<nowiki>pip install esptool</nowiki>

{{underline|Note pour les utilisateurs de Mac OSX et Linux:}} vous pourriez avoir besoin d'exécuter cette commande en tant que root à l'aide d'un {{fname|sudo}} comme ceci:

<nowiki>sudo pip install esptool</nowiki>

{{ADFImage|FEATHER-CHARGER-MICROPYTHON-ESP8266-20.png}}

Si '''pip''' vous informe que {{fname|esptool.py}} ne fonctionne qu'avec Python 2.x alors essayer une nouvelle fois en utilisant '''pip2''' dans la commande à la place de pip (si votre système utilise Python 3 par défaut alors la commande pip pourrait conduire à une situation un peu confuse).

== Download MicroPython ==

Ensuite, [http://micropython.org/download/esp8266/ téléchargez la dernière version du binaire du Firmware MicroPython pour ESP8266]. Ces firmwares sont généralement compilés journellement depuis le code source sur Github. Si vous voulez réaliser votre propre compilation du firmware MicroPython ESP8266 (like if you're customizing it or including other modules & scripts) alors voyez le tutoriel "[https://learn.adafruit.com/building-and-running-micropython-on-the-esp8266/overview Building and Running MicroPython on the ESP8266] (''Adafruit, anglais''), un guide bien pratique qui explique comment compiler le firmware sur une machine virtuelle spéciale.

{{ADFImage|FEATHER-CHARGER-MICROPYTHON-ESP8266-21.png}}

== Wiring + activates Flash mode on ESP8266 ==
Maintenant nous allons placer notre ESP8266 en mode "Flashage Firmware". Cette opération est nécessaire aussi bien pour l'effacement de la mémoire Flash que pour le téléversement d'un nouveau FirmWare.

C'est un peu différent pour chaque carte ESP8266

=== Common use case ===
[[Fichier:ESP8266-HUZZA.png|400px]]

* '''Pour le module ESP8266 brute''' ou '''NodeMCU Lolin''' vous aurez besoin de brancher un bouton pour ramener le GPIO0 à la masse et un deuxième bouton pour ramener la broche RESET à la masse. Maintenez le bouton GPIO0 enfoncé (ou connectez le à la masse) ET pressez puis relachez le bouton RESET pendant que vous maintenez GPIO0 à la masse. Relâcher finalement la broche GPIO0.
* Pour le {{pl|733|breakout HUZZAH ESP8266}} les boutons GPIO0 et RESET sont déjà inclus sur la carte. Maintenez le bouton GPIO0 enfoncé (ou connectez le à la masse) ET pressez puis relâchez le bouton RESET pendant que vous maintenez GPIO0 à la masse. Relâcher finalement la broche GPIO0.

=== Feather HUZZAH ESP8266, Wemos D1 ===
Ces modules dispose de la possibilité d'activer automatiquement le Flash Mode au moment de la programmation. Cela évite des manipulation supplémentaires.

[[Fichier:FEATHER-ESP8266-02.jpg|240px]] [[Fichier:Wemos-D1-Mini-ESP8266.jpg|120px]]

Pour le {{pl|846|Feather HUZZAH ESP8266}}, {{pl|1221|Wemos D1 Mini}}, {{pl|1222|Wemos D1 Pro}} c'est encore plus simple. Vous n'avez pas besoin de faire quoi que ce soit pour activer le mode "flashage Firmware". Cette carte est conçue pour détecter lorsque le port série est ouvert en vue de flasher le module. Il passe donc automatiquement en mode flashage en configurant automatiquement le module ESP8266 pour recevoir le firmware.
* '''Sur Windows, vous devez préalablement [https://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx installer le pilote CP210x de SiLabs] on Windows pour rendre visible le port série de la carte.<br />Sur Windows, il vaudra installer le pilote VCP standard (''normal VCP driver'') et non celui prenant en charge l'énumération des ports séries (''with Serial Enumeration'')
* '''Sur MacOS X, vous devez préalablement [https://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx installer le pilote CP210x de SiLabs] on Windows pour rendre visible le port série de la carte.
{{ambox|text=Sur la gamme Wemos ESP8266, le convertisseur USB Série est basé sur un CH340D. Il est donc nécessaire d'installer le pilote approprié.}}

=== ESP8266-DEV (only) ===
Il est possible de programmer un module {{pl|667|ESP8266-DEV}} en utilisant un {{pl|144|câble console (USB-Série-TTL)}} exploitant des signaux en logique 3.3V .

Voici comment effectuer le raccordement.

[[Fichier:OLI-ESP8266-DEV-Wiring.jpg|453px]]

Pour activer le FlashMode sur un {{pl|667|ESP8266-DEV}} (version Olimex):
* Il faut presser le bouton GPIO 0 (le petit bouton bouton utilisateur présent sur l'ESP8266-DEV, qui est également branché sur le GPIO 0)
* Puis mettre le module sous tension
* Enfin relâcher le bouton GPIO 0.

=== ESP8266-EVB (ESP8266-DEV) ===
[[Fichier:OLI-ESP8266-EVB.jpg|180px]]

Pour activer le FlashMode sur un {{pl|668|ESP8266-EVB}} (évaluation board d'Olimex), {{pl|667|ESP8266-DEV}} (version Olimex):
* Il faut presser le bouton GPIO 0 (le bouton utilisateur de l'ESP8266-EVB est également branché sur le GPIO 0)
* Puis mettre le module sous tension
* Enfin relâcher le bouton GPIO 0.

A noter que l'{{pl|668|ESP8266-EVB}} et {{pl|667|ESP8266-DEV}} ne disposent pas de convertisseur USB-Série, il faut donc utiliser un {{pl|144|cable console (USB-Série-TTL)}} pour communiquer avec la carte ESP8266.

[[Fichier:UEXT-SERIAL-wiring2.jpg|240px]] [[Fichier:UEXT-SERIAL-wiring.jpg|240px]]

== Erase the Flash ==
Il est recommander d'effacer entièrement le contenu de la mémoire Flash d'une carte ESP8266 avant de téléverser un nouveau FirmWare. Exécutez le code suivant dans un terminal pour effectuer cette opération:

<nowiki>esptool.py --port /chemin/vers/ESP8266 erase_flash</nowiki>

Où {{fname|/chemin/vers/ESP8266}} est le chemin ou nom du port série connecté sur l'ESP8266. Le nom exacte du périhérique varie en fonction du type de convertisseur USB-vers-série. Lister vis port série avant de connecter le module ESP826 puis répétez l'opération avec le port série connecté. Le port qui vient d'apparaître est celui correspondant à votre ESP8266.

{{ADFImage|FEATHER-CHARGER-MICROPYTHON-ESP8266-22.png}}

== Flashing MicroPython on ESP8266 ==
=== ESP8266 from Adafruit Industries ===
Pour le {{pl|733|breakout HUZZAH ESP8266}} et le {{pl|846|Feather HUZZAH ESP8266}} + {{pl|77|FTDI Friend}}:

[[Fichier:FEATHER-ESP8266-02.jpg|240px]] [[Fichier:ESP8266-HUZZA.png|400px]]

Remettez votre ESP8266 en "mode Flashage" et exécutez la commande suivante pour charger le nouveau firmware (celui que vous avez déjà téléchargé sur votre ordinateur):

<nowiki>esptool.py --port /chemin/vers/ESP8266 --baud 115200 write_flash --flash_size=detect -fm dio 0 firmware.bin</nowiki>

{{ambox|text=Depuis la version 1.3 d'EspTool, il est possible d'utiliser Python 2.7 et Python 3.5.

Depuis la version du 2.x d'EspTool, il est possible d'utiliser l'option --flash_size=detect pour éviter les erreurs taille de flash.}}

Encore une fois, {{fname|/chemin/vers/ESP8266}} est le chemin ou nom du port série connecté sur l'ESP8266. Remplacez {{fname|firmware.bin}} avec le vrai nom (et chemin d'accès) du fichier firmware que vous voulez téléverser sur l'ESP8266.

{{ADFImage|FEATHER-CHARGER-MICROPYTHON-ESP8266-23.png}}

=== ESP8266 WEMOS D1 Mini ===
Pour le {{pl|1221|Wemos D1}} dispose de 4MB de Flash comme pour la plupart des ESP8266 disponible sur le marché.

[[Fichier:Wemos-D1-Mini-ESP8266.jpg|180px]]

Exécutez la commande suivante pour charger le nouveau firmware (celui que vous avez déjà téléchargé sur votre ordinateur):

<nowiki>esptool.py --port /chemin/vers/ESP8266 --baud 115200 write_flash --flash_size=detect -fm dio 0 firmware.bin</nowiki>

=== ESP8266 WEMOS D1 PRO ===
Pour le {{pl|1222|Wemos D1 '''Pro'''}} dispose de 16MB de Flash, la commande de Flash est donc différente:

[[Fichier:Wemos-D1-Pro-Mini-ESP8266.jpg|180px]]

Exécutez la commande suivante pour charger le nouveau firmware (celui que vous avez déjà téléchargé sur votre ordinateur):

<nowiki>esptool.py --port /chemin/vers/ESP8266 --baud 115200 write_flash --fm dio --fs=32m 0 firmware.bin</nowiki>

{{ambox|text=Bien que le module n'embarque que 16MB, il est nécessaire de mentionner une Flash Size de '''32m''' ! Flasher le module avec une Flash Size de 16m laisse celui dans un état instable après le redémarrage.}}

=== ESP8266-EVB & ESP8266-DEV ===
Pour le {{pl|668|ESP8266-EVB}} evaluation board et {{pl|667|ESP8266-DEV}} carte de développement placée sur la carte ESP8266-EVB:

[[Fichier:OLI-ESP8266-EVB.jpg|180px]] [[Fichier:OLI-ESP8266-DEV.jpg|110px]]

Exécutez la commande suivante pour charger le nouveau firmware (celui que vous avez déjà téléchargé sur votre ordinateur):

<nowiki>esptool.py --port /chemin/vers/ESP8266 --baud 115200 write_flash --flash_size=detect -fm dio 0 firmware.bin</nowiki>

Appliquer un cycle d'alimentation sur l'ESP8266-EVB pour réinitialiser la plateforme.

== After Flash operation ==
Pressez le bouton RESET de votre carte une fois que l'outil à terminé le flashage du Firmware (la LED bleue clignote durant le flashage). Si vous ne possédez pas de bouton RESET, vous pouvez également déconnecter et reconnecter l'ESP8266 sur votre ordinateur.

Voila, vous venez de flasher votre ESP8266 avec la dernière version du firmware MicroPython!

Vous pouvez sauter sur la section [[FEATHER-CHARGER-MICROPYTHON-SERIAL-REPL|REPL série]] de ce guide pour apprendre comment obtenir l'invite de commande de votre carte MicroPython.

== Ressources ==
=== Error message ===
'''J'ai le message d'erreur "read failed: device reports readiness to read but returned no data (device disconnected or multiple access on port?" !'''

Nous avons rencontré ce problème lorsque le câble console était branché sur un HUB USB externe. Essayez de brancher le câble console directement sur l'ESP8266.

=== EspTool Upgrade ===
Les firmwares récents nécessitent une version récente d'EspTool pour être flasher l'ESP8266.

Pour notre grand malheur, nous avons essayé de flasher un firmware 1.8.x avec un EspTool 1.0.1. Inutile de dire que nous n'avons plus grand chose de fonctionnel sur notre ESP8266 !

Un upgrade d'EspTool à la version la plus récente (2.0.1 en l’occurrence, voir [https://pypi.python.org/pypi/esptool ici sur pypi.python.org]) à résolu notre problème grâce à l'option --flash_size=detect

Pour forcer la mise-à-jour d'EspTool à une version donnée, il faut saisir:

sudo apt-get install esptool==2.0.1

=== More information ===
Voyez la page "[http://docs.micropython.org/en/latest/esp8266/esp8266/tutorial/intro.html#deploying-the-firmware MicroPython ESP8266 tutorial - deploying]".
29 917

modifications

Menu de navigation