vscode-Spitze

Raspberry Pi Pico Visual Studio Code-Erweiterung

Hinweis: Die Erweiterung befindet sich derzeit in der Entwicklung.

Dies ist die offizielle Visual Studio Code-Erweiterung für die Raspberry Pi Pico-Entwicklung. Diese Erweiterung stattet Sie mit einer Reihe von Tools aus, mit denen Sie Ihre Pico-Projekte mithilfe von Visual Studio Code und dem offiziellen Pico SDK optimieren können.

Ausführliche Einrichtungsanweisungen finden Sie im PDF-Dokument „Erste Schritte“.

Neueste Beta herunterladen?

Merkmale

Projektaufbau und -management

• Projektgenerator : Erstellen und konfigurieren Sie ganz einfach neue Projekte mit Unterstützung für erweiterte Pico-Funktionen wie I2C und PIO. Der Generator zielt auf das Ninja-Build-System ab und ermöglicht eine Anpassung während der Projekterstellung.
• Schnelle Projekteinrichtung : Starten Sie neue Pico-Projekte direkt aus der Explorer-Ansicht, wenn kein Arbeitsbereich geöffnet ist.
• MicroPython-Unterstützung : Erstellen und entwickeln Sie MicroPython-basierte Pico-Projekte mit Unterstützung durch die MicroPico-Erweiterung.

Konfigurations- und Toolmanagement

• Automatische CMake-Konfiguration : Konfiguriert CMake automatisch beim Laden eines Projekts.
• Versionswechsel : Wechseln Sie nahtlos zwischen verschiedenen Versionen des Pico SDK und der Tools.
• Keine manuelle Einrichtung erforderlich : Verwaltet Umgebungsvariablen, Toolchain, SDK und Toolverwaltung automatisch.
• Enthält ein Deinstallationsprogramm : Entfernen Sie ganz einfach die Erweiterung zusammen mit allen automatisch installierten Tools und SDKs.

Erstellen, Debuggen und Dokumentation

• Kompilieren und Debuggen mit einem Klick : Konfigurieren Sie OpenOCD, Ninja und CMake automatisch, sodass Sie mit einem einzigen Klick kompilieren und debuggen können.

• Offline-Dokumentation : Greifen Sie bequem direkt im Editor auf die Pico SDK-Dokumentation zu, auch wenn Sie offline sind.

• Versionswechsel : Wechseln Sie nahtlos zwischen verschiedenen Versionen des Pico SDK und der Tools.

• Keine manuelle Einrichtung erforderlich : Die Erweiterung verwaltet Umgebungsvariablen, Toolchain, SDK und Tool-Management für Sie.

• Kompilierung mit einem Klick : Kompilieren Sie Projekte direkt aus der Statusleiste mit dem von Ihnen ausgewählten SDK und den Tools.

• Offline-Dokumentation : Greifen Sie offline auf die Pico SDK-Dokumentation zu.

• Schnelle Projekteinrichtung : Erstellen Sie schnell neue Pico-Projekte aus der Explorer-Ansicht, wenn kein Arbeitsbereich geöffnet ist.

• MicroPython-Unterstützung : Erstellen Sie MicroPython-basierte Pico-Projekte mit Unterstützung durch die MicroPico-Erweiterung.

Anforderungen nach Betriebssystem

Unterstützte Plattformen: Raspberry Pi OS (64-Bit), Windows 10/11 (x86_64), macOS Sonoma (14.0) und neuer, Linux x64 und arm64

• Visual Studio Code v1.92.1 oder höher

Raspberry Pi OS und Windows

Es sind keine zusätzlichen Anforderungen erforderlich.

macOS

Um die Anforderungen für macOS zu erfüllen, führen Sie den folgenden Befehl im Terminal aus, um die erforderlichen Tools zu installieren:

xcode-select --install

Dieser Befehl installiert alle erforderlichen Tools, einschließlich, aber nicht beschränkt auf:

• Git 2.28 oder höher (stellen Sie sicher, dass es sich in Ihrem PATH befindet)
• Tar (stellen Sie sicher, dass es sich in Ihrem PATH befindet)

Linux

• Python 3.9 oder höher (stellen Sie sicher, dass es sich in Ihrem PATH befindet oder in den Einstellungen festgelegt ist)
• Git 2.28 oder höher (stellen Sie sicher, dass es sich in Ihrem PATH befindet)
• Tar (stellen Sie sicher, dass es sich in Ihrem PATH befindet)
• [Optional] gdb-multiarch zum Debuggen (nur x86_64)
• Installieren Sie für [Ubuntu 22.04] die Pakete libftdi1-2 und libhidapi-hidraw0 um OpenOCD zu verwenden

Erweiterungseinstellungen

Diese Erweiterung bietet die folgenden Einstellungen:

• raspberry-pi-pico.cmakePath : Geben Sie einen benutzerdefinierten Pfad für CMake an.
• raspberry-pi-pico.python3Path : Geben Sie einen benutzerdefinierten Pfad für Python 3 (maschinenbezogen) an.
• raspberry-pi-pico.ninjaPath : Geben Sie einen benutzerdefinierten Pfad für Ninja an.
• raspberry-pi-pico.gitPath : Geben Sie einen benutzerdefinierten Pfad für Git an.
• raspberry-pi-pico.cmakeAutoConfigure : Stellen Sie ein persönliches GitHub-Zugriffstoken (klassisch) mit dem public_repo Bereich bereit. Dieses Token wird verwendet, um nach verfügbaren Versionen des Pico SDK und anderer Tools zu suchen. Ohne sie verwendet die Erweiterung die nicht authentifizierte GitHub-API, die ein niedrigeres Ratenlimit hat und bei Überschreitung des Limits zu eingeschränkter Funktionalität führen kann. Die Ratenbegrenzung für nicht authentifizierte Daten gilt pro öffentlicher IP-Adresse. Daher ist ein Token erforderlicher, wenn Ihre IP-Adresse mit vielen Benutzern geteilt wird.

Integration der CMake Tools-Erweiterung

Bei komplexeren Projekten, beispielsweise solchen mit mehreren ausführbaren Dateien oder wenn der Projektname als Variable definiert ist, kann diese Erweiterung in die CMake Tools-Erweiterung integriert werden, um die CMake-Analyse zu verbessern. Sie können die CMake Tools-Integration während der Projektgenerierung unter den erweiterten Optionen aktivieren. Um es manuell zu aktivieren, passen Sie außerdem die folgenden Einstellungen in Ihrer settings.json an:

• raspberry-pi-pico.cmakeAutoConfigure : Von true auf false setzen.
• raspberry-pi-pico.useCmakeTools : Von false auf true setzen.

Für eine optimale Funktionalität sollten Sie Folgendes aktivieren:

• cmake.configureOnEdit : wahr
• cmake.automaticReconfigure : wahr
• cmake.configureOnOpen : wahr

Wenn Sie dazu aufgefordert werden, wählen Sie das Pico Kit in CMake Tools aus und legen Sie Ihre Build- und Startziele entsprechend fest. Verwenden Sie CMake Tools zum Kompilieren, verwenden Sie diese Erweiterung jedoch weiterhin zum Debuggen, da das Debuggen von CMake Tools nicht mit Pico kompatibel ist.

VS-Code-Profile

Wenn Sie mit mehreren Mikrocontroller-Toolchains arbeiten, sollten Sie die Installation dieser Erweiterung in einem VS-Codeprofil in Betracht ziehen, um Konflikte mit anderen Toolchains zu vermeiden. Befolgen Sie diese Schritte:

1. Laden Sie hier das Beispielprofil herunter.
2. Öffnen Sie die Befehlspalette mit Ctrl+Shift+P (oder Cmd+Shift+P unter macOS) und wählen Sie Profiles: Import Profile .
3. Importieren Sie die heruntergeladene Datei, um die Erweiterung in einem dedizierten Pico-Profil zu installieren.
4. Dieses Setup hilft dabei, die Pico-Erweiterung von anderen Erweiterungen zu isolieren und so das Risiko von Konflikten zu verringern.

Bekannte Probleme

• Benutzerdefinierte Pfade: Benutzerdefinierte Pfade für Ninja, Python3 und Git werden nicht wie SDK- und Toolchain-Pfade in CMakeLists.txt gespeichert. Sie müssen Projekte über die Erweiterung erstellen und konfigurieren, um diese benutzerdefinierten Pfade verwenden zu können.

GitHub-API-Ratenbegrenzung („Fehler beim Abrufen von SDK- und Toolchain-Versionen“)

Wenn beim Abrufen verfügbarer Pico SDK-Versionen Probleme auftreten, kann dies an den Ratenbeschränkungen der GitHub-API liegen. Um dieses Problem zu beheben, erstellen Sie ein persönliches Zugriffstoken (klassisches PAT) mit dem Bereich public_repo und legen Sie es in den globalen (Benutzer-)Erweiterungseinstellungen fest, um Ihr Ratenlimit zu erhöhen.

Bauanleitung

Für fortgeschrittene Benutzer, die die Erweiterungsdatei .vsix erstellen möchten, führen Sie die folgenden Schritte aus:

1. Nodejs installieren (Anleitung Windows)
2. Installieren Sie Yarn global: npm install -g yarn
3. Installieren Sie VSCE global: npm install -g @vscode/vsce
4. Führen Sie yarn im Projektverzeichnis aus, um Abhängigkeiten zu installieren.
5. Erstellen Sie die Erweiterung mit: vsce package .

Dadurch wird eine .vsix Datei generiert, die Sie in VS Code mit code --install-extension path-to.vsix oder über die GUI installieren können: Extensions > three dots > Install from VSIX .