Configurez votre environnement de développement pour microcontrôleurs
Installation de PlatformIO
Ce tutoriel explique comment installer PlatformIO pour programmer des microcontrôleurs Arduino, ESP32, STM32 et bien d'autres.
Pré-requis :
PlatformIO est une plateforme de développement professionnelle pour microcontrôleurs qui s’intègre à VSCode via une extension.
Ensemble, VSCode + PlatformIO offrent :
Ce tutoriel vous guidera à travers l’installation complète sur Windows, macOS et Linux.
PlatformIO offre une gestion avancée des projets, des builds plus rapides, une meilleure gestion des bibliothèques, le support de multiples plateformes dans un même projet, et des outils de débogage professionnels. C’est l’outil de référence pour les projets sérieux.
Maintenant que VSCode est installé, nous allons ajouter l’extension PlatformIO qui transforme VSCode en IDE complet pour microcontrôleurs.
Dans VSCode, cliquez sur l’icône Extensions dans la barre d’activité de gauche (icône de carrés empilés) ou utilisez le raccourci :
Dans la barre de recherche des extensions, tapez platformio. Vous devriez voir l’extension PlatformIO IDE par PlatformIO.
Cliquez sur le bouton Install (Installer). L’installation prend quelques minutes car PlatformIO télécharge automatiquement :
Soyez patient, ne fermez pas VSCode pendant l’installation !
Une fois l’installation terminée, vous verrez :
Si on vous le demande, cliquez sur Reload Now (Recharger maintenant).
La première installation de PlatformIO peut prendre 5-10 minutes selon votre connexion internet. PlatformIO télécharge tous les outils nécessaires (compilateurs, outils de flash, etc.). C’est normal, soyez patient !
Cliquez sur l’icône PlatformIO (tête d’alien) dans la barre d’activité de gauche. Un panneau s’ouvre avec plusieurs options. Cliquez sur PIO Home puis Open.
La page d’accueil de PlatformIO s’ouvre avec plusieurs sections :
Si vous voyez cette page, félicitations ! PlatformIO est correctement installé.
Sur Linux, vous devez configurer les permissions pour accéder aux ports USB sans sudo.
Ouvrez un terminal et exécutez :
sudo usermod -a -G dialout $USER
sudo usermod -a -G plugdev $USER
Déconnectez-vous puis reconnectez-vous (ou redémarrez l’ordinateur) pour que les changements prennent effet.
Pour un meilleur support de certaines cartes (ESP32, STM32…), installez les règles udev de PlatformIO :
curl -fsSL https://raw.githubusercontent.com/platformio/platformio-core/master/scripts/99-platformio-udev.rules | sudo tee /etc/udev/rules.d/99-platformio-udev.rules
Puis rechargez les règles :
sudo udevadm control --reload-rules
sudo udevadm trigger
Après avoir ajouté votre utilisateur aux groupes dialout et plugdev, vous DEVEZ vous déconnecter et reconnecter (ou redémarrer) pour que les permissions soient effectives. Sinon PlatformIO ne pourra pas accéder aux ports USB.
Mémorisez ces raccourcis essentiels :
Windows/Linux :
macOS :
~/.platformio (Linux/macOS) ou C:\\Users\\VotreNom\\.platformio (Windows)PlatformIO nécessite Python. Vérifiez que Python est bien installé :
python --version ou python3 --version
Si Python n’est pas installé, téléchargez-le depuis python.org et réinstallez PlatformIO.
Assurez-vous d’avoir suivi les étapes de configuration USB (section précédente) :
sudo usermod -a -G dialout $USER
sudo usermod -a -G plugdev $USER
Puis déconnectez-vous et reconnectez-vous.
Testons l’installation en créant un projet simple de type “Blink”.
Remplissez les champs suivants :
test_blinkArduino Uno, ESP32 Dev Module, NodeMCU 1.0…)Arduino par défautCliquez sur Finish. PlatformIO crée le projet et télécharge les outils nécessaires pour votre carte.
PlatformIO crée automatiquement la structure du projet. Ouvrez le fichier src/main.cpp. Remplacez le contenu par ce code de test Blink :
#include <Arduino.h>
void setup() {
pinMode(LED_BUILTIN, OUTPUT);
}
void loop() {
digitalWrite(LED_BUILTIN, HIGH);
delay(1000);
digitalWrite(LED_BUILTIN, LOW);
delay(1000);
}
Pour compiler le projet :
PlatformIO compile le code. Si tout va bien, vous verrez SUCCESS dans le terminal.
La première compilation d’un projet pour une nouvelle plateforme peut prendre plusieurs minutes car PlatformIO télécharge le compilateur, les bibliothèques et frameworks nécessaires. Les compilations suivantes seront beaucoup plus rapides !
Si vous avez une carte connectée, vous pouvez uploader le programme :
PlatformIO compile et upload automatiquement. La LED de votre carte devrait clignoter !
Si la compilation réussit, votre installation de VSCode + PlatformIO est complète et fonctionnelle. Vous êtes prêt à développer vos projets embarqués !
Les bibliothèques se déclarent directement dans le fichier platformio.ini via la clé lib_deps. C’est la méthode recommandée : les dépendances sont versionnées avec le projet et installées automatiquement à la compilation.
Rendez-vous sur le registre officiel registry.platformio.org et recherchez la bibliothèque souhaitée. Notez son identifiant au format auteur/NomLib (ex : waspinator/AccelStepper).
Ouvrez le fichier platformio.ini à la racine de votre projet et ajoutez la clé lib_deps :
[env:esp32dev]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
lib_deps =
waspinator/AccelStepper@^1.64
Pour ajouter plusieurs bibliothèques, listez-les les unes sous les autres :
lib_deps =
waspinator/AccelStepper@^1.64
bblanchon/ArduinoJson@^7.0.0
Lancez une compilation avec Ctrl+Alt+B (Windows/Linux) ou Cmd+Alt+B (macOS). PlatformIO télécharge et installe automatiquement toutes les bibliothèques listées dans lib_deps avant de compiler.
Le symbole ^ signifie « version compatible » (ex : ^1.64 accepte 1.64, 1.65… mais pas 2.0). Utilisez @* pour toujours prendre la dernière version, ou un numéro exact comme @1.64.0 pour figer la version.
Si vous préférez utiliser PlatformIO en ligne de commande :
# Créer un nouveau projet
pio project init --board <nom_carte>
# Compiler
pio run
# Upload
pio run --target upload
# Ouvrir le moniteur série
pio device monitor
# Lister les cartes disponibles
pio boards
# Rechercher une bibliothèque
pio lib search <nom_lib>
# Installer une bibliothèque
pio lib install <nom_lib>
mon_projet/
├── .pio/ # Fichiers de build (généré automatiquement)
├── include/ # Fichiers d'en-tête (.h)
├── lib/ # Bibliothèques privées
├── src/ # Code source (.cpp, .c)
│ └── main.cpp # Fichier principal
├── test/ # Tests unitaires
├── platformio.ini # Configuration du projet
└── .gitignore # Fichiers à ignorer par Git
Le fichier platformio.ini configure le projet :
[env:myboard]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
lib_deps =
adafruit/Adafruit Sensor@^1.1.4
bblanchon/ArduinoJson@^6.21.0
Maintenant que VSCode et PlatformIO sont installés, vous êtes prêt à développer vos projets embarqués ! Explorez les exemples inclus, testez différentes cartes, et n’hésitez pas à consulter la documentation.