<markdown>

Premiers pas avec MicroPython sur l'ESP32

[Reference Micropython](https://docs.micropython.org/en/latest/esp32/quickref.html)

L'utilisation de MicroPython est un excellent moyen de tirer le meilleur parti de votre carte ESP32. vice versa, la puce ESP32 est une excellente plate-forme pour utiliser MicroPython. Le didacticiel vous guidera dans la configuration de MicroPython, l'obtention d'une invite et l'utilisation WebREPL, connexion au réseau et communication avec Internet, en utilisant les périphériques matériels et le contrôle de certains composants externes.

C'est parti !

Exigences

La première chose dont vous avez besoin est une carte avec une puce ESP32. Le MicroPython Le logiciel prend en charge la puce ESP32 elle-même et n'importe quelle carte devrait fonctionner. la caractéristique d'une carte est la façon dont les broches GPIO sont connectées à l'extérieur monde, et s'il comprend un convertisseur USB-série intégré pour rendre le UART disponible sur votre PC.

Les noms des broches seront donnés dans ce tutoriel en utilisant les noms des puces (par exemple GPIO2) et il devrait être simple de trouver à quelle broche cela correspond sur votre conseil particulier.

Alimentation de la carte

Si votre carte est équipée d'un connecteur USB, il est fort probable qu'elle soit alimentée par ceci lorsqu'il est connecté à votre PC. Sinon, vous devrez l'alimenter directement. Veuillez vous référer à la documentation de votre carte pour plus de détails.

Obtenir le firmware

La première chose à faire est de télécharger le firmware MicroPython le plus récent .bin à charger sur votre appareil ESP32. Vous pouvez le télécharger à partir du [Page de téléchargement de MicroPython](https://micropython.org/download/ESP32_GENERIC/) À partir de là, vous avez 3 choix principaux :

* Versions de firmware stables * Versions quotidiennes du firmware * Versions quotidiennes du firmware avec prise en charge de SPIRAM

Si vous débutez avec MicroPython, le mieux est d'opter pour la version Stable versions de firmware. Si vous êtes un utilisateur avancé et expérimenté de MicroPython ESP32 qui aimerait suivre de près le développement et aider à tester de nouveaux fonctionnalités, il y a des builds quotidiennes. Si votre carte prend en charge SPIRAM, vous pouvez utilisez soit le firmware standard, soit le firmware avec support SPIRAM, et dans dans ce dernier cas, vous aurez accès à plus de RAM pour les objets Python.

Déploiement du firmware

Une fois que vous avez le firmware MicroPython, vous devez le charger sur votre appareil ESP32. Il y a deux étapes principales pour ce faire : vous devez d'abord mettre votre appareil en mode bootloader, et deuxièmement, vous devez copier le firmware. Le mode exact la procédure pour ces étapes dépend fortement de la carte en question et vous il faut se référer à sa documentation pour plus de détails.

Heureusement, la plupart des cartes disposent d'un connecteur USB, d'un convertisseur USB-série et du DTR et les broches RTS câblées d'une manière spéciale, le déploiement du firmware devrait être aussi simple que toutes les étapes peuvent être effectuées automatiquement. Les cartes qui ont de telles fonctionnalités incluent les Adafruit Feather HUZZAH32, M5Stack, Wemos LOLIN32 et TinyPICO cartes, ainsi que les kits de développement Espressif DevKitC, PICO-KIT, WROVER-KIT.

Pour de meilleurs résultats, il est recommandé d'effacer d'abord l'intégralité du flash de votre appareil avant d'installer le nouveau firmware MicroPython.

Actuellement, nous ne prenons en charge que la copie d'esptool.py dans le firmware. Vous pouvez trouver cet outil [ici](https://github.com/espressif/esptool/)

en utilisant pip::

  pip installe esptool

Les versions commençant par 1.3 prennent en charge Python 2.7 et Python 3.4 (ou plus récent). Une version plus ancienne (au moins 1.2.1 est nécessaire) fonctionne bien mais nécessitera Python 2.7.

En utilisant esptool.py, vous pouvez effacer le flash avec la commande :

  esptool.py --port /dev/ttyUSB0 effacer_flash

Et puis déployez le nouveau firmware en utilisant ::

  esptool.py --chip esp32 --port /dev/ttyUSB0 write_flash -z 0x1000 esp32-20180511-v1.9.4.bin

Remarques :

* Vous devrez peut-être modifier le paramètre « port » en quelque chose d'autre adapté à votre

PC

* Vous devrez peut-être réduire le débit en bauds si vous obtenez des erreurs lors du flashage

(par exemple jusqu'à 115200 en ajoutant « --baud 115200 » dans la commande)

* Pour certaines cartes avec une configuration FlashROM particulière, vous devrez peut-être

changer le mode flash (par exemple en ajoutant ``-fm dio`` dans la commande)

* Le nom de fichier du firmware doit correspondre au fichier que vous avez

Si les commandes ci-dessus s'exécutent sans erreur, MicroPython doit être installé sur votre planche !

Invite série

Une fois que vous avez le firmware sur l'appareil, vous pouvez accéder au REPL (invite Python) via UART0 (GPIO1=TX, GPIO3=RX), qui peut être connecté à un port USB-série convertisseur, selon votre carte. Le débit en bauds est de 115200.

À partir de là, vous pouvez maintenant suivre le tutoriel ESP8266, car ces deux puces Espressif sont très similaires lorsqu'il s'agit d'utiliser MicroPython sur eux. Le tutoriel ESP8266 se trouve dans :ref:`esp8266_tutorial` (mais ignorez la section Introduction).

Dépannage des problèmes d'installation

Si vous rencontrez des problèmes lors du flashage ou de l'exécution immédiate du firmware après cela, voici des recommandations de dépannage :

* Soyez attentif et essayez d'exclure les problèmes matériels. Il existe 2 problèmes courants

Problèmes : mauvaise qualité de la source d'alimentation et FlashROM usée/défectueuse.
En parlant de source d'alimentation, non seulement l'ampérage brut est important, mais aussi son faible
ondulation et bruit/EMI en général. L'alimentation la plus fiable et la plus pratique
la source est un port USB.

* Les instructions de clignotement ci-dessus utilisent une vitesse de clignotement de 460800 bauds, ce qui est

bon compromis entre vitesse et stabilité. Cependant, selon votre
module/carte, convertisseur USB-UART, câbles, système d'exploitation hôte, etc., le débit ci-dessus
Le débit peut être trop élevé et entraîner des erreurs. Essayez un débit plus courant de 115 200 bauds.
Dans de tels cas, il est préférable d'utiliser un tarif plus élevé.

* Pour détecter un contenu flash incorrect (par exemple provenant d'un secteur défectueux sur une puce),

ajoutez le commutateur « --verify » aux commandes ci-dessus.

* Si vous rencontrez toujours des problèmes lors du flashage du firmware, veuillez

se référer à [la page du projet esptool.py](https://github.com/espressif/esptool)
pour une documentation supplémentaire et un outil de suivi des bogues où vous pouvez signaler les problèmes.

* Si vous parvenez à flasher le firmware mais que l'option ``–verify`` renvoie

des erreurs même après plusieurs tentatives peuvent survenir, vous avez peut-être une puce FlashROM défectueuse.

</markdow n>