Configurez votre environnement de développement pour microcontrôleurs
Installation de VSCode et PlatformIO
Ce tutoriel explique comment installer Visual Studio Code et PlatformIO pour programmer des microcontrôleurs Arduino, ESP32, STM32 et bien d'autres.
Pré-requis :
Visual Studio Code (VSCode) est un éditeur de code léger et puissant développé par Microsoft. 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.
Rendez-vous sur le site officiel de VSCode à l’adresse https://code.visualstudio.com/. Cliquez sur le bouton de téléchargement pour Windows. Le fichier d’installation (VSCodeUserSetup-x64.exe) sera téléchargé.
Double-cliquez sur le fichier téléchargé pour lancer l’installation. Acceptez les conditions d’utilisation.
Cochez les options suivantes (recommandées) :
Cliquez sur Suivant puis Installer.
Une fois l’installation terminée, cochez Lancer Visual Studio Code et cliquez sur Terminer. VSCode se lance pour la première fois.
Rendez-vous sur https://code.visualstudio.com/. Téléchargez la version correspondant à votre processeur :
Si macOS affiche un message de sécurité, allez dans Préférences Système > Confidentialité et sécurité, puis autorisez l’exécution de Visual Studio Code.
Pour utiliser VSCode depuis le terminal (utile pour PlatformIO) :
Téléchargez et installez le paquet .deb depuis le site officiel :
sudo apt install ./code_*.debOu via le dépôt officiel :
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/
sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
sudo apt update
sudo apt install code
Installez le paquet RPM :
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo sh -c 'echo -e "[code]\\nname=Visual Studio Code\\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\\nenabled=1\\ngpgcheck=1\\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/vscode.repo'
Puis :
sudo dnf check-update
sudo dnf install code
VSCode est disponible dans AUR :
yay -S visual-studio-code-bin
Ou utilisez Snap :
sudo snap install code --classic
Sur Linux, vous devrez configurer les permissions USB pour programmer les microcontrôleurs. Cela sera expliqué plus loin dans la section dédiée.
Lancez Visual Studio Code. Vous devriez voir :
Si vous voyez cette interface, VSCode est correctement installé !
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.
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.
Voici quelques réglages utiles pour améliorer votre expérience de développement.
Installez ces extensions pour améliorer votre productivité :
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.
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.
Explorez d'autres tutoriels pour maîtriser la programmation de microcontrôleurs
