pico 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在 VS Code 中安装该文件或通过 GUI： Extensions > three dots > Install from VSIX 。