pic de vscode

Extension de code Raspberry Pi Pico Visual Studio

Remarque : L'extension est actuellement en cours de développement.

Il s'agit de l'extension officielle de Visual Studio Code pour le développement de Raspberry Pi Pico. Cette extension vous équipe d'une suite d'outils conçus pour rationaliser vos projets Pico à l'aide de Visual Studio Code et du SDK officiel Pico.

Pour des instructions de configuration complètes, reportez-vous au guide de démarrage PDF.

Télécharger la dernière version bêta ?

Caractéristiques

Configuration et gestion de projet

• Générateur de projets : créez et configurez facilement de nouveaux projets avec la prise en charge des fonctionnalités avancées de Pico telles que I2C et PIO. Le générateur cible le système de build Ninja et permet la personnalisation lors de la création du projet.
• Configuration rapide du projet : lancez de nouveaux projets Pico directement à partir de la vue Explorateur, lorsqu'aucun espace de travail n'est ouvert.
• Prise en charge de MicroPython : créez et développez des projets Pico basés sur MicroPython avec le support fourni via l'extension MicroPico.

Gestion de la configuration et des outils

• Configuration automatique de CMake : configure automatiquement CMake lors du chargement d'un projet.
• Changement de version : basculez en toute transparence entre les différentes versions du SDK et des outils Pico.
• Aucune configuration manuelle requise : gère automatiquement les variables d'environnement, la chaîne d'outils, le SDK et la gestion des outils.
• Comprend un programme de désinstallation : supprimez facilement l'extension ainsi que tous les outils et SDK installés automatiquement.

Construction, débogage et documentation

• Compilation et débogage en un clic : configurez automatiquement OpenOCD, Ninja et CMake, vous permettant de compiler et de déboguer en un seul clic.

• Documentation hors ligne : accédez facilement à la documentation du SDK Pico directement dans l'éditeur, même hors ligne.

• Changement de version : basculez en toute transparence entre les différentes versions du SDK et des outils Pico.

• Aucune configuration manuelle requise : l'extension gère les variables d'environnement, la chaîne d'outils, le SDK et la gestion des outils pour vous.

• Compilation en un clic : compilez des projets directement à partir de la barre d'état avec le SDK et les outils sélectionnés.

• Documentation hors ligne : accédez à la documentation du SDK Pico hors ligne.

• Configuration rapide du projet : créez rapidement de nouveaux projets Pico à partir de la vue Explorateur lorsqu'aucun espace de travail n'est ouvert.

• Prise en charge de MicroPython : créez des projets Pico basés sur MicroPython avec la prise en charge fournie via l'extension MicroPico.

Exigences par système d'exploitation

Plateformes prises en charge : Raspberry Pi OS (64 bits), Windows 10/11 (x86_64), macOS Sonoma (14.0) et versions ultérieures, Linux x64 et arm64

• Visual Studio Code v1.92.1 ou version ultérieure

Système d'exploitation Raspberry Pi et Windows

Aucune exigence supplémentaire n’est nécessaire.

macOS

Pour répondre aux exigences de macOS, exécutez la commande suivante dans Terminal pour installer les outils nécessaires :

xcode-select --install

Cette commande installe tous les outils nécessaires, y compris, mais sans s'y limiter :

• Git 2.28 ou version ultérieure (assurez-vous qu'il se trouve dans votre PATH)
• Tar (assurez-vous qu'il est dans votre PATH)

Linux

• Python 3.9 ou version ultérieure (assurez-vous qu'il se trouve dans votre PATH ou défini dans les paramètres)
• Git 2.28 ou version ultérieure (assurez-vous qu'il se trouve dans votre PATH)
• Tar (assurez-vous qu'il est dans votre PATH)
• [Facultatif] gdb-multiarch pour le débogage (x86_64 uniquement)
• Pour [Ubuntu 22.04] , installez les packages libftdi1-2 et libhidapi-hidraw0 pour utiliser OpenOCD

Paramètres d'extension

Cette extension fournit les paramètres suivants :

• raspberry-pi-pico.cmakePath : Spécifiez un chemin personnalisé pour CMake.
• raspberry-pi-pico.python3Path : spécifiez un chemin personnalisé pour Python 3 (à l'échelle de la machine) .
• raspberry-pi-pico.ninjaPath : Spécifiez un chemin personnalisé pour Ninja.
• raspberry-pi-pico.gitPath : Spécifiez un chemin personnalisé pour Git.
• raspberry-pi-pico.cmakeAutoConfigure : Fournissez un jeton d'accès personnel GitHub (classique) avec la portée public_repo . Ce jeton est utilisé pour vérifier les versions disponibles du SDK Pico et d'autres outils. Sans cela, l'extension utilise l'API GitHub non authentifiée, qui a une limite de débit inférieure et peut conduire à une fonctionnalité restreinte si la limite est dépassée. La limite de débit non authentifié est par adresse IP publique, un jeton est donc plus nécessaire si votre IP est partagée avec de nombreux utilisateurs.

Intégration des extensions des outils CMake

Pour les projets plus complexes, tels que ceux comportant plusieurs exécutables ou lorsque le nom du projet est défini comme une variable, cette extension peut s'intégrer à l'extension CMake Tools pour améliorer l'analyse CMake. Vous pouvez activer l'intégration de CMake Tools lors de la génération du projet sous les Options avancées . De plus, pour l'activer manuellement, ajustez les paramètres suivants dans votre settings.json :

• raspberry-pi-pico.cmakeAutoConfigure : défini de true à false .
• raspberry-pi-pico.useCmakeTools : défini de false à true .

Pour une fonctionnalité optimale, pensez à activer :

• cmake.configureOnEdit : vrai
• cmake.automaticReconfigure : vrai
• cmake.configureOnOpen : vrai

Lorsque vous y êtes invité, sélectionnez le kit Pico dans CMake Tools et définissez vos cibles de construction et de lancement en conséquence. Utilisez CMake Tools pour la compilation, mais continuez à utiliser cette extension pour le débogage, car le débogage de CMake Tools n'est pas compatible avec Pico.

Profils de code VS

Si vous travaillez avec plusieurs chaînes d'outils de microcontrôleurs, envisagez d'installer cette extension dans un profil VS Code pour éviter les conflits avec d'autres chaînes d'outils. Suivez ces étapes :

1. Téléchargez l’exemple de profil à partir d’ici.
2. Ouvrez la palette de commandes avec Ctrl+Shift+P (ou Cmd+Shift+P sur macOS) et sélectionnez Profiles: Import Profile .
3. Importez le fichier téléchargé pour installer l'extension dans un profil Pico dédié.
4. Cette configuration permet d'isoler l'extension Pico des autres extensions, réduisant ainsi le risque de conflits.

Problèmes connus

• Chemins personnalisés : les chemins personnalisés pour Ninja, Python3 et Git ne sont pas stockés dans CMakeLists.txt comme les chemins du SDK et de la chaîne d'outils. Vous devez créer et configurer des projets via l'extension pour utiliser ces chemins personnalisés.

Limite de débit de l'API GitHub (« Erreur lors de la récupération des versions du SDK et de la chaîne d'outils »)

Si vous rencontrez des problèmes pour récupérer les versions disponibles du SDK Pico, cela peut être dû aux limites de débit de l'API GitHub. Pour résoudre ce problème, créez un jeton d'accès personnel (PAT classique) avec la portée public_repo et définissez-le dans les paramètres d'extension globaux (utilisateur) pour augmenter votre limite de débit.

Instructions de construction

Pour les utilisateurs avancés qui souhaitent créer le fichier d’extension .vsix , procédez comme suit :

1. Installer nodejs (Instructions Windows)
2. Installer Yarn globalement : npm install -g yarn
3. Installez VSCE globalement : npm install -g @vscode/vsce
4. Exécutez yarn dans le répertoire du projet pour installer les dépendances.
5. Construisez l'extension avec : vsce package .

Cela générera un fichier .vsix , que vous pourrez installer dans VS Code en utilisant code --install-extension path-to.vsix ou via l'interface graphique : Extensions > three dots > Install from VSIX .