vscode 峰值

Raspberry Pi Pico Visual Studio 程式碼擴充

注意：該擴充功能目前正在開發中。

這是用於 Raspberry Pi Pico 開發的官方 Visual Studio Code 擴充功能。此擴充功能為您提供了一套工具，旨在使用 Visual Studio Code 和官方 Pico SDK 簡化您的 Pico 專案。

有關全面的設定說明，請參閱入門指南 PDF。

下載最新的測試版？

特徵

專案設定和管理

• 專案產生器：透過支援 I2C 和 PIO 等進階 Pico 功能，輕鬆建立和配置新專案。此生成器以 Ninja 建置系統為目標，並允許在專案建立期間進行自訂。
• 快速專案設定：當沒有開啟工作區時，直接從資源管理器檢視啟動新的 Pico 專案。
• MicroPython 支援：透過 MicroPico 擴充功能提供的支援來建立和開發基於 MicroPython 的 Pico 專案。

設定和工具管理

• 自動 CMake 配置：載入專案時自動配置 CMake。
• 版本切換：不同版本的Pico SDK和工具之間無縫切換。
• 無需手動設定：自動處理環境變數、工具鏈、SDK 和工具管理。
• 包括解除安裝程式：輕鬆刪除擴充功能以及所有自動安裝的工具和 SDK。

建置、調試和文檔

• 一鍵編譯偵錯：自動設定OpenOCD、Ninja、CMake，一鍵編譯偵錯。

• 離線文件：即使在離線狀態下，也可以直接在編輯器中方便地存取 Pico SDK 文件。

• 版本切換：不同版本的Pico SDK和工具之間無縫切換。

• 無需手動設定：此擴充功能可以為您處理環境變數、工具鏈、SDK 和工具管理。

• 一鍵編譯：使用您選擇的 SDK 和工具直接從狀態列編譯專案。

• 離線文件：離線存取 Pico SDK 文件。

• 快速專案設定：在沒有開啟工作空間時，從資源管理器檢視快速建立新的 Pico 專案。

• MicroPython 支援：透過 MicroPico 擴充功能提供的支援來建立基於 MicroPython 的 Pico 專案。

作業系統的要求

支援的平台：Raspberry Pi OS（64 位元）、Windows 10/11 (x86_64)、macOS Sonoma (14.0) 及更高版本、Linux x64 和 arm64

• Visual Studio Code v1.92.1 或更高版本

Raspberry Pi 作業系統與 Windows

不需要額外的要求。

macOS

為了滿足 macOS 的要求，請在終端機中執行以下命令來安裝必要的工具：

xcode-select --install

此命令將安裝所有必要的工具，包括但不限於：

• Git 2.28 或更高版本（確保它在您的路徑中）
• Tar （確保它在您的路徑中）

Linux

• Python 3.9 或更高版本（確保它在您的 PATH 中或在設定中設定）
• Git 2.28 或更高版本（確保它在您的路徑中）
• Tar （確保它在您的路徑中）
• [可選]用於調試的 gdb-multiarch（僅限 x86_64）
• 對於[Ubuntu 22.04] ，安裝libftdi1-2和libhidapi-hidraw0軟體包以使用 OpenOCD

擴充設定

此擴充功能提供以下設定：

• raspberry-pi-pico.cmakePath ：指定 CMake 的自訂路徑。
• raspberry-pi-pico.python3Path ：指定 Python 3 （機器範圍）的自訂路徑。
• raspberry-pi-pico.ninjaPath ：指定 Ninja 的自訂路徑。
• raspberry-pi-pico.gitPath ：指定 Git 的自訂路徑。
• raspberry-pi-pico.cmakeAutoConfigure ：提供具有public_repo範圍的 GitHub 個人存取權杖（經典）。此令牌用於檢查 Pico SDK 和其他工具的可用版本。如果沒有它，擴充功能將使用未經身份驗證的 GitHub API，該 API 的速率限制較低，如果超出限制，可能會導致功能受限。未經身份驗證的速率限制是針對每個公用 IP 位址的，因此如果您的 IP 與許多使用者共用，則更需要令牌。

CMake 工具擴充集成

對於更複雜的項目，例如具有多個可執行檔或項目名稱定義為變數時，此擴充功能可以與 CMake 工具擴充整合以增強 CMake 解析。您可以在專案產生期間在Advanced Options下啟用 CMake Tools 整合。此外，要手動啟用它，請在settings.json中調整以下設定：

• raspberry-pi-pico.cmakeAutoConfigure ：從true設定為false 。
• raspberry-pi-pico.useCmakeTools ：從false設定為true 。

為了獲得最佳功能，請考慮啟用：

• cmake.configureOnEdit : true
• cmake.automaticReconfigure : true
• cmake.configureOnOpen : true

出現提示時，在 CMake Tools 中選擇Pico套件，並相應地設定建置和啟動目標。使用 CMake Tools 進行編譯，但繼續使用此擴充功能進行偵錯，因為 CMake Tools 偵錯與 Pico 不相容。

VS 程式碼設定檔

如果您使用多個微控制器工具鏈，請考慮將此擴充功能安裝到 VS Code 設定檔中，以避免與其他工具鏈發生衝突。請依照下列步驟操作：

1. 從此處下載範例設定檔。
2. 使用Ctrl+Shift+P （或 macOS 上的Cmd+Shift+P ）開啟命令面板，然後選擇Profiles: Import Profile 。
3. 匯入下載的檔案以在專用 Pico 設定檔中安裝擴充功能。
4. 此設定有助於將 Pico 分機與其他分機隔離，從而降低衝突風險。

已知問題

• 自訂路徑：Ninja、Python3 和 Git 的自訂路徑不像 SDK 和工具鏈路徑那樣儲存在CMakeLists.txt中。您需要透過擴充功能來建置和配置專案才能使用這些自訂路徑。

GitHub API 速率限制（「檢索 SDK 和工具鏈版本時發生錯誤」）

如果您在檢索可用的 Pico SDK 版本時遇到問題，可能是 GitHub API 速率限制所致。要解決此問題，請建立具有public_repo範圍的個人存取權杖（經典 PAT），並在全域（使用者）擴展設定中設定它以提高速率限制。

建構說明

對於想要建立擴充功能.vsix檔案的高級用戶，請按照以下步驟操作：

1. 安裝nodejs（Windows說明）
2. 全域安裝 Yarn： npm install -g yarn
3. 全域安裝 VSCE： npm install -g @vscode/vsce
4. 在專案目錄中執行yarn以安裝相依性。
5. 使用以下命令建立擴充功能： vsce package 。

這將產生一個.vsix文件，您可以使用code --install-extension path-to.vsix或透過 GUI 在 VS Code 中安裝該文件： Extensions > three dots > Install from VSIX 。