树莓派Pico|RP2040|官方文档|在MS Windows上构建“Hello World”及环境配置

9.2. 在MS Windows上构建

在Microsoft Windows 10或Windows 11上安装工具链与其他平台有些不同。然而安装后，RP2040的构建代码基本类似。
 警告
官方不支持在Windows 7或8上使用Raspberry Pi Pico，但在Windows 7或8上可以使其工作。

9.2.1. 安装工具链

如果您正在Microsoft Windows上为Raspberry Pi Pico进行开发，那么可以使用
Windows Pico Installer。
继续从Github (https://github.com/raspberrypi/pico-setupwindows)下载最新版本的安装程序，并运行它。安装向导(参见图15)将指导您安装工具链。
向导完成安装后，它将提示您是否应该显示教程，或者是否应该选择克隆并从Github构建pico-examples存储库。
包括软件:
• Arm GNU Toolchain
• CMake
• Ninja
• Python 3.9
• Git for Windows
• Visual Studio Code
• OpenOCD

9.2.1.1. 开始编写Visual Studio代码

在开始菜单中，在Raspberry Pi Pico SDK 文件夹中寻找Pico - Visual Studio Code快捷方式。的
快捷方式设置所需的环境变量，然后启动Visual Studio Code。
注意
如果您以前安装过Visual Studio Code，我们经常会看到由于插入的随机设置而导致的问题。其他扩展，或由用户，在现有的安装。如果是这种情况，请转到Pico安装程序获取已知问题和解决方案的清单。

9.2.1.2. 打开例子

第一次使用开始菜单快捷方式启动Visual Studio Code时，它将打开pico-examples存储库。
要稍后重新打开示例存储库，可以打开安装在C:\ProgramData\Raspberry Pi \Pico的SDK副本 \pico -examples。

9.2.1.3. 构建示例

当你第一次打开pico-examples项目时，Visual Studio Code会询问你是否要配置它;点击确定
提示继续。(如果你错过了提示，请查找右下角的“铃铛”图标。)然后系统会提示您
选择一个工具包-选择Pico ARM GCC - Pico SDK Toolchain，其中包含GCC ARM -none-eabi条目。如果Pico ARM GCC条目是
不存在，选择“未指定”以使SDK自动检测编译器。
要构建其中一个示例，请单击侧边栏上的“CMake”按钮的树形视图示例项目;展开要构建的项目，然后单击目标名称右侧的小构建图标构建特定的项目。
要构建所有内容，请单击CMake Project Outline视图顶部的“build All Projects”按钮。
注意
您可以在Windows的Pico设置教程中找到有关如何使用Visual Studio Code的更多信息。
重要
如果您在Windows下安装或使用工具链时遇到问题，在Pico安装Windows GitHub库中有可用的故障排除指南。

9.2.2. 可供选择的手动安装

警告
在MS Windows下手动安装工具链比较复杂，不建议使用。
要构建，您需要安装一些额外的工具。
• Arm GNU Toolchain (you need the filename ending with -arm-none-eabi.exe)
• CMake
• Build Tools for Visual Studio 2022
• Python 3.10
• Git
从上面的链接下载每个程序的可执行安装程序，然后仔细按照以下部分将这五个软件包安装到您的Windows计算机上。

9.2.2.1. 安装Arm GNU Toolchain

在安装过程中，您应该勾选该框，当提示这样做时可以将Arm编译器的路径加入系统path。

9.2.2.2. 安装CMake

在安装过程中，当安装程序提示时，将CMake添加到所有用户的系统路径中。

9.2.2.3. 安装Visual Studio 2022的构建工具

当由Visual Studio安装程序的构建工具提示时，您只需要安装c++构建工具。
注意
你必须安装完整的“Windows 10 SDK”包，因为SDK需要在本地构建pioasm和elf2uf2工具。
将它从已安装项目列表中删除将意味着您将无法构建Raspberry Pi Pico二进制文件

9.2.2.4. 安装Python 3.10

在安装过程中，确保它是“为所有用户”安装的，并在提示时将Python 3.10添加到系统PATH
安装程序。您还应该在Python末尾提示时禁用MAX_PATH长度限制
安装。

9.2.2.5. 安装Git

在安装Git时，您应该确保将默认编辑器从vim更改为缺省编辑器，如图21所示。
图21。安装Git
确保勾选复选框以允许从第三方软件使用Git，除非您有充分的理由
否则，在安装Git时，你也应该勾选“按原样签出，按原样提交”，选择“使用Windows”。
“默认控制台窗口”和“启用对伪控制台的实验支持”。

9.2.2.6. 获取SDK和示例

C:\Users\pico\Downloads> git clone https://github.com/raspberrypi/pico-sdk.git --branch master
C:\Users\pico\Downloads> cd pico-sdk
C:\Users\pico\Downloads\pico-sdk> git submodule update --init
C:\Users\pico\Downloads\pico-sdk> cd …
C:\Users\pico\Downloads> git clone https://github.com/raspberrypi/pico-examples.git --branch
master

9.2.2.7. 从命令行构建“Hello World”

通过选择Windows > Visual，从Windows菜单中打开开发人员命令提示符窗口
Studio 2022 > VS 2022的开发者命令提示符
然后设置SDK的路径，如下所示:
C:\Users\pico\Downloads> setx PICO_SDK_PATH “…\pico-sdk”
您现在需要关闭当前的命令提示符窗口并打开第二个开发人员命令提示符
窗口，在继续之前将在其中正确设置此环境变量。
导航到pico-examples文件夹，并按如下方式构建“Hello World”示例:
C:\Users\pico\Downloads> cd pico-examples
C:\Users\pico\Downloads\pico-examples> mkdir build
C:\Users\pico\Downloads\pico-examples> cd build
C:\Users\pico\Downloads\pico-examples\build> cmake -G “NMake Makefiles” …
C:\Users\pico\Downloads\pico-examples\build> nmake
来构建目标。这将产生elf、bin和uf2目标，您可以在hello_world/serial和中找到它们构建目录中的Hello_world /usb目录。UF2二进制文件可以直接拖放到
RP2040板连接到您的计算机使用USB。

9.2.2.8. 从Visual Studio Code构建“Hello World”

现在您已经安装了工具链，您可以安装Visual Studio Code并在该环境中构建您的项目而不是从命令行。
继续下载并安装Visual Studio Code for Windows。安装后打开Developer Command通过选择Windows > Visual Studio 2022 > Developer Command Prompt for VS2022，从Windows菜单中打开提示符窗口
菜单上的。然后输入,
C: >代码
听提示。这将打开Visual Studio Code，并设置所有正确的环境变量，以便工具链正确配置。
警告
如果您通过单击其桌面图标启动Visual Studio Code，或者直接从开始菜单启动构建环境配置不正确。虽然这可以在CMake工具设置中手动完成，
配置Visual Studio Code环境最简单的方法就是通过Developer Command打开它提示窗口，其中已经设置了这些环境变量。
现在我们需要安装CMake Tools扩展。单击左侧工具栏中的Extensions图标(或键入Ctrl +Shift + X)，然后搜索“CMake Tools”，点击列表中的条目，然后点击安装按钮。
然后单击界面左侧导航栏底部的齿轮并选择“设置”。然后在设置窗格中单击“扩展”，然后单击“CMake工具”。然后向下滚动到“Cmake”:配置环境”。点击“Add Item”，将PICO_SDK_PATH设置为…\…\pico-sdk，如图22所示。
此外，您需要向下滚动到“Cmake: Generator”，并在框中输入“NMake Makefiles”。
重要
如果你不更改“Cmake: Generator”，Visual Studio将默认为ninja，并且作为GCC构建可能会失败以ninja无法理解的稍微不正确的格式输出依赖信息。
现在关闭设置页面，转到文件菜单，单击“打开文件夹”，导航到pico-examples repo和点击“选择文件夹”。系统将提示您配置项目，参见图23。选择“GCC for arm-none-eabi”
编译器。
点击窗口底部蓝色栏中的“Build”按钮(带有齿轮)。这将创建
运行CMake并构建示例项目，包括“Hello World”。
这将产生elf、bin和uf2目标，您可以在hello_world/serial和hello_world/usb目录中找到它们
在新创建的构建目录中。UF2二进制文件可以直接拖放到RP2040板上
用USB连接到电脑上。

9.2.2.9. 闪烁并运行“Hello World”

使用micro-USB电缆将树莓派Pico连接到树莓派上，确保按住
BOOTSEL按钮强制进入USB大容量存储模式。该板应自动显示为外部驱动器。你现在可以将UF2二进制文件拖放到外部驱动器上。
Raspberry Pi Pico将重新启动，并卸载自己作为外部驱动器，并开始运行闪存代码。
正如我们在第4章中所做的那样，您可以构建Hello World示例，将工作室路由到USB CDC(串行)或UART0在GP0和GP1引脚上。如果您使用USB CDC作为目标输出构建，则不需要安装驱动程序，因为它是一个class-compliant设备。

9.2.2.9.1. UART输出

可选的，如果您想要连接到Raspberry Pi Pico标准UART来查看您需要的输出使用USB到UART串行转换器(例如SparkFun FTDI)将树莓派Pico连接到计算机
基本板，见图24。