Raspberry Pi Pico Visual Studio Code扩展：您的Pico开发助手

Raspberry Pi Pico Visual Studio Code扩展是专为Pico开发量身打造的官方工具，旨在通过Visual Studio Code和官方Pico SDK简化您的开发流程。无论您是初学者还是专业开发者，都能从中受益。

核心功能：

• 项目设置与管理：

  • 项目生成器：快速创建并配置新项目，支持I2C和PIO等高级Pico功能。
  • 快速项目设置：直接从资源管理器视图启动新项目，无需打开工作区。
  • MicroPython支持：通过MicroPico扩展，创建并开发基于MicroPython的Pico项目。

• 配置与工具管理：

  • 自动CMake配置：加载项目时自动配置CMake。
  • 版本切换：无缝切换不同版本的Pico SDK和工具。
  • 无需手动设置：自动处理环境变量、工具链、SDK和工具管理。
  • 包含卸载程序：轻松移除扩展及其自动安装的工具和SDK。

• 编译、调试与文档：

  • 一键编译与调试：自动配置OpenOCD、Ninja和CMake，一键完成编译和调试。
  • 离线文档：在编辑器内直接访问Pico SDK文档，即使离线也无忧。
  • 版本切换：无缝切换不同版本的Pico 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 OS和Windows： 无额外要求。
• macOS： 运行以下命令安装必要工具：

  xcode-select --install

  包括但不限于Git 2.28或更高版本和Tar（确保在PATH中）。

• Linux：
  • Python 3.9或更高版本（确保在PATH中或在设置中指定）。
  • Git 2.28或更高版本（确保在PATH中）。
  • Tar（确保在PATH中）。
  • [可选] gdb-multiarch用于调试（仅限x86_64）。
  • [可选] 安装udev规则以无需sudo使用OpenOCD和picotool进行调试和加载。
  • 对于[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：启用/禁用项目打开时的自动CMake配置。
• raspberry-pi-pico.useCmakeTools：启用/禁用CMake Tools扩展集成（见下文）。
• raspberry-pi-pico.githubToken：提供带有public_repo范围的GitHub个人访问令牌（经典）。此令牌用于检查Pico SDK和其他工具的可用版本。没有它，扩展将使用未经认证的GitHub API，其速率限制较低，如果超出限制，可能会导致功能受限。未经认证的速率限制是基于公共IP地址的，因此如果您的IP与许多用户共享，则更需要使用令牌。

CMake Tools扩展集成：

对于更复杂的项目，如包含多个可执行文件或项目名称定义为变量的项目，该扩展可以与CMake Tools扩展集成以增强CMake解析。您可以在项目生成时通过高级选项启用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 Code配置文件：

如果您使用多个微控制器工具链，请考虑将此扩展安装到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安装：扩展 > 三个点 > 从VSIX安装。