03 · Ouvrir un projet PlatformIO existant

La plupart des TP fournissent un dossier de projet PlatformIO tout prêt (fichier platformio.ini + dossier src) : voici comment l'ouvrir dans VSCode.

← Ressources PlatformIO

Récupérer le dossier du projet (fourni avec le TP, dans Progs) et le copier sur le poste (Bureau ou Documents).
Dans la barre d'activité, à gauche de VSCode, cliquer sur l'icône platformio pour ouvrir son panneau.
Dans le panneau PLATFORMIO, section Quick Access, cliquer sur Open (sous PIO Home) : l'onglet PIO Home s'ouvre dans la zone principale.
Sur cet onglet PIO Home, dans la colonne Quick Access, cliquer sur le bouton Open Project.
Dans la fenêtre qui s'ouvre, sélectionner le dossier qui contient directement le fichier platformio.ini — pas un dossier parent qui le contiendrait plus bas.
Si une fenêtre « Do you trust the authors of the files in this folder? » apparaît, cliquer Yes, I trust the authors.
Patienter : le projet s'indexe (barre de progression en bas de la fenêtre) puis apparaît dans l'Explorateur.

Raccourci : si le panneau PLATFORMIO affiche directement « You have not yet opened a platformio project », le bouton Pick a folder fait la même chose en une étape.

Vocabulaire

Explorateur : le panneau de gauche qui liste les fichiers et dossiers du projet ouvert (src/main.cpp, platformio.ini…).
platformio.ini : le fichier de configuration du projet ; il indique la carte utilisée, la vitesse de communication et les bibliothèques.
Indexation : l'analyse du projet par l'extension pour proposer la coloration syntaxique, l'autocomplétion, etc.

Vérifier que le projet est bien reconnu

Dans la barre latérale, l'icône platformio doit être présente. En cliquant dessus, la liste des tâches du projet s'affiche : Build, Upload, Monitor, Clean…

Si l'icône platformio n'apparaît pas : vérifier que le dossier ouvert contient bien platformio.ini à sa racine (et non dans un sous-dossier), et que les extensions PlatformIO IDE et platformio IDE sont bien toutes les deux installées (voir la ressource 01 · Installation PlatformIO / platformio).

Les tâches (Build / Upload / Monitor) n'apparaissent pas

Le panneau platformio peut rester vide (ou afficher « You have not yet opened a platformio project ») même quand le bon dossier est ouvert. Dans l'ordre, essayer :

Solution	Détail
Installer aussi l'extension PlatformIO officielle	Cause la plus fréquente : avec platformio seul, les tâches n'apparaissent pas. Il faut installer les deux extensions, platformio d'abord puis PlatformIO — voir la ressource 01 · Installation PlatformIO / platformio.
Patienter	La première ouverture d'un projet peut prendre 1 à 2 minutes (indexation, téléchargement d'outils manquants) : attendre la fin de la barre de progression en bas de la fenêtre.
Recharger la fenêtre	`Ctrl`+`Maj`+`P` puis taper Developer: Reload Window et valider.
Un seul dossier racine	Vérifier qu'un seul dossier est ouvert dans VSCode (pas un espace de travail avec plusieurs dossiers) : platformio ne détecte le projet que dans le premier dossier racine.
Nettoyer la configuration	Fermer VSCode, supprimer le sous-dossier `.vscode` à l'intérieur du projet (config générée automatiquement), puis rouvrir le projet.