01 · Installation de PlatformIO / platformio

Tout ce qu'il faut installer sur un poste pour développer sur ESP32 : VSCode, l'extension platformio IDE, et la configuration du framework (support ESP32-C6, Zigbee).

← Ressources PlatformIO

1. PlatformIO ? platformio ?

PlatformIO est un environnement de développement pour l'embarqué, intégré à VSCode sous forme d'extension. platformio en est un dérivé communautaire dont le framework Arduino-ESP32 est plus récent : il prend en charge les cartes ESP32 récentes (comme l'ESP32-C6) et des fonctions comme le Zigbee.

Important : il faut installer les deux extensions, dans cet ordre : platformio IDE d'abord, puis PlatformIO IDE (officielle) ensuite. Avec platformio seul (ou dans le mauvais ordre), le projet peut s'ouvrir mais les tâches (Build, Upload, Monitor…) n'apparaissent pas : c'est l'extension PlatformIO officielle qui fournit cette barre d'outils, platformio ajoute le framework ESP32 à jour (support ESP32-C6, Zigbee).

2. Prérequis

Visual Studio Code — télécharger sur code.visualstudio.com, puis installer.
Git for Windows — télécharger sur git-scm.com/download/win et installer en conservant les options par défaut. C'est un programme, pas une extension VSCode : platformio l'utilise pour télécharger la plateforme depuis GitHub.
Vérifier Git : dans VSCode, menu Terminal > Nouveau terminal, taper git --version — une ligne de version doit s'afficher (ex. git version 2.47.0).

3. Installer les extensions

Le profil VSCode dédié (« OT-Rayssac ») est créé avant cette étape, dans le cadre de la séance — voir Séance 0 · Présentation OT & PlatformIO.

Ouvrir la barre Extensions (raccourci Ctrl+Maj+X).
Installer d'abord platformio IDE : chercher platformio ide (éditeur platformio, identifiant platformio.platformio-ide) , cliquer Install.
Installer ensuite PlatformIO IDE : chercher platformio ide (éditeur PlatformIO, identifiant platformio.platformio-ide) , cliquer Install. Respecter cet ordre : installer PlatformIO avant platformio ne fait pas apparaître la barre d'outils (Build, Upload, Monitor…).
Si VSCode propose d'installer l'extension C/C++ (Microsoft), accepter.
Installer Serial Monitor : chercher serial monitor (éditeur Microsoft, identifiant ms-vscode.vscode-serial-monitor) , cliquer Install. Cette extension offre une interface dédiée, plus confortable que le terminal, pour lire et envoyer des données série.

4. Configurer le framework (platformio.ini)

Dans chaque projet, la ligne platform de platformio.ini définit le framework installé. On pointe vers la version stable de platformio (reproductible d'un poste à l'autre) :

[env:esp32-c6]
platform = https://github.com/pioarduino/platform-espressif32/releases/download/stable/platform-espressif32.zip
board    = esp32-c6-devkitm-1
framework = arduino
monitor_speed = 115200

platformio sert pour toutes les cartes ESP32. On garde la même ligne platform (platformio stable) et on change seulement le board : esp32-c6-devkitm-1 pour un ESP32-C6, esp32dev pour un ESP32-WROOM, etc.

5. Mettre à jour

Dans VSCode : icône platformio → Update All (met à jour plateformes, frameworks et bibliothèques). En ligne de commande, dans le terminal platformio Core CLI (pas un terminal PowerShell classique — voir plus bas) : pio pkg update.

6. Vérifier que tout fonctionne

Compiler (bouton Build ✓ ou pio run) et lire le bloc PACKAGES en haut du log ; un build réussi se termine par [SUCCESS].

PACKAGES:
 - framework-arduinoespressif32 @ 3.3.11
 - framework-arduinoespressif32-libs @ 5.5.5+sha...
 - toolchain-riscv32-esp @ 14.2.0+...
========================= [SUCCESS] =========================

7. Si ça échoue

Symptôme	Cause probable	Solution
« This board doesn't support arduino framework »	Paquet Arduino corrompu ou trop ancien	Supprimer le dossier du paquet puis relancer `pio run`
Erreur SSL / téléchargement qui boucle	Pare-feu ou antivirus du réseau qui bloque le serveur	Réessayer sur un autre réseau, ou demander le déblocage au service informatique
Le build reste bloqué sur une ancienne version	Cache local non rafraîchi	`pio pkg update --force`
`pio : Le terme « pio » n'est pas reconnu…`	Le terminal ouvert est un terminal Windows/PowerShell classique, qui ne connaît pas la commande `pio`	Utiliser le terminal platformio Core CLI à la place (voir ci-dessous)

Sur ce PC : les paquets sont dans %USERPROFILE%\.platformio\packages\. Supprimer un dossier de paquet ne casse rien : il est retéléchargé au prochain pio run.

Pense-bête des commandes

Ces commandes ne se tapent pas dans un terminal PowerShell classique (pio y est inconnu), mais dans le terminal platformio Core CLI : icône platformio dans la barre latérale → section Miscellaneous → platformio Core CLI. Ce terminal s'ouvre déjà à la racine du projet (le dossier qui contient platformio.ini).

Commande	Effet
`pio pkg update`	met à jour plateforme + bibliothèques du projet
`pio run`	compile
`pio run -t upload`	compile et flashe la carte
`pio run -t clean`	supprime les fichiers de build