跳到主要内容

C/C++ SDK

SDK安装​

要开始使用 C/C++ SDK，请阅读我们的入门文档，其中介绍了如何使用 Raspberry Pi Pico 扩展设置 VS Code 并创建简单项目。支持的操作系统请查看扩展的 README。

但是，如果您打算在 32 位 Raspberry Pi OS 或 Raspberry Pi OS Lite 上开发 Pico，我们的 VS Code 扩展不支持这些操作系统。您可以改为从命令行运行设置脚本来快速设置 C/C++ 工具链。

  1. 在运行设置脚本之前，请确保 Raspberry Pi 上的 Raspberry Pi OS 已更新到最新版本。
  2. 通过运行以下命令下载并运行设置脚本： 
    wget https://raw.githubusercontent.com/raspberrypi/pico-setup/master/pico_setup.sh
    chmod +x pico_setup.sh
    ./pico_setup.sh
  3. 有关更多信息和测试设置的说明，请参阅 pico-setup 的 README。

树莓派Pico C/C++ SDK​

我们的官方 C SDK 可在命令行中使用，也可在 Visual Studio Code 和 CLion 等流行的集成开发环境中使用。要开始使用，请下载我们的 C/C++ SDK 和示例，并查看我们的 Raspberry Pi Pico 系列入门 文档。如需快速设置，请参阅下一节。

您可以在以下网址找到有关 C/C++ SDK 的文档：

Raspberry Pi Pico 系列入门
  使用 Raspberry Pi Pico、Pico 2 和其他基于 Raspberry Pi 微控制器的电路板进行 C/C++ 开发

Pico W 系列设备的 Wi-Fi 和蓝牙连接
  在 Pico W 系列设备上使用 C/C++ 或 MicroPython 进行无线连接

Raspberry Pi Pico 系列 C/C++ SDK
  用于在 Raspberry Pi 微控制器上进行 C/C++ 开发的库和工具

API文档
  树莓派 Pico C/C++ SDK API 文档

Pico示例代码库
  示例项目

SDK 源代码是开放源代码，可通过 pico-sdk Github 代码库 获取。

注意

要使用 C/C++ SDK 为除 Raspberry Pi Pico 之外的电路板构建应用程序，请向 CMake 传递 -DPICO_BOARD=boardname，其中 boardname 是您的电路板名称。例如

  • 要为 Adafruit Feather RP2040 构建应用程序，请传递 -DPICO_BOARD=adafruit_feather_rp2040 。
  • 要为 Pico W 构建应用程序，请传递 -DPICO_BOARD=pico_w（如果希望连接到无线网络，还需传递 -DWIFI_SSID="Your Network" -DWIFI_PASSWORD="Your Password"）。

更多信息，请参阅 Raspberry Pi Pico SDK 中的 boards/ 目录 和 论坛。

你的第一个二进制文件​

LED闪烁​

任何人在使用新微控制器时编写的第一个程序都是打开或关闭 LED。Raspberry Pi Pico 板载了一个 LED。LED 连接至主板微控制器的 GP25（适用于 Pico 和 Pico 2），以及 Infineon 43439 无线芯片的 WL_GPIO0（适用于 Pico W 和 Pico 2 W）。

您可以通过以下方式打开或关闭闪烁：

  1. 下载 Blink UF2。此文件支持所有 Pico 变体。
  2. 按住 BOOTSEL 按钮，将 Pico 插入树莓派或其他电脑的 USB 端口。
  3. 它将挂载为名为 RPI-RP2（Pico）或 RP2350（Pico 2）的大容量存储设备。
  4. 将 Blink UF2 二进制文件拖放到已挂载的存储卷上。Pico 将重新启动。

如果成功，板载 LED 将闪烁。

您可以在 Github 上查看编写自己的闪烁程序的代码。

说 "Hello World"​

任何人编写的下一个程序都是通过 USB 串行连接说 "Hello World"。

  1. 下载 "Hello World" UF2。
  2. 按住 BOOTSEL 按钮，将 Pico 插入树莓派或其他计算机的 USB 端口。
  3. 它将挂载为名为 RPI-RP2（Pico）或 RP2350（Pico 2）的大容量存储设备。
  4. 将 "Hello World" UF2 二进制文件拖放到已挂载的存储卷上。Pico 将重新启动。
  5. 打开终端窗口并键入
sudo apt install minicom
minicom -b 115200 -o -D /dev/ttyACM0

你应该会看到 "Hello, world!"打印到终端。

您可以在 Github 上查看编写自己的 hello_world 程序的代码

快速启动自己的项目​

注意

以下说明较为简短，且仅基于 Linux。有关其他平台的详细步骤和一般说明，我们建议您参阅《Raspberry Pi Pico 系列入门》和《树莓派Pico C/C++ SDK》两本书。

安装 CMake（至少 3.13 版）和 GCC 交叉编译器

sudo apt install cmake gcc-arm-none-eabi libnewlib-arm-none-eabi libstdc++-arm-none-eabi-newlib

在本地克隆树莓派Pico SDK，将项目设置为使用树莓派Pico SDK：

git clone https://github.com/raspberrypi/pico-sdk.git

将 SDK 中的 external/pico_sdk_import.cmake 复制到项目目录中

将 PICO_SDK_PATH 设置为环境中的 SDK 位置，或稍后将其传递给 cmake (-DPICO_SDK_PATH=)。

设置 CMakeLists.txt，如

cmake_minimum_required(VERSION 3.13)

# 根据 PICO_SDK_PATH 初始化 SDK
# 注意：这必须在 project() 之前进行
include(pico_sdk_import.cmake)

project(my_project)

# 初始化 树莓派Pico SDK
pico_sdk_init()

# 项目的其余部分

继续编写代码，有关如何编写代码的更多信息，请参阅 pico-examples 或 树莓派Pico C/C++ SDK 一书。

最简单的方法是编写一个源文件（例如 hello_world.c）

#include <stdio.h>
#include "pico/stdio.h"
#include "pico/stdlib.h"

int main() {
    setup_default_uart();
    printf("Hello, world!\n");
    return 0;
}

并在 CMakeLists.txt 中添加以下内容：

add_executable(hello_world
    hello_world.c
)

# 添加聚合常用功能的 pico_stdlib 库
target_link_libraries(hello_world pico_stdlib)

# 除 ELF 文件外，创建 map/bin/hex/uf2 文件。
pico_add_extra_outputs(hello_world)
注意

本示例使用默认 UART 作为 stdout；如果要使用默认 USB，请参阅 hello-usb 示例。

设置 CMake 生成目录。例如，如果不使用集成开发环境：

mkdir build
cd build
cmake .

为树莓派Pico之外的其他板构建时，应在上述 cmake 命令中传递 -DPICO_BOARD=board_name ，例如 cmake -DPICO_BOARD=pico_w ..，以便为该特定板配置相应的 SDK 和构建选项。

这样做可以设置各种编译器定义（例如 UART 和其他硬件的默认引脚编号），在某些情况下还可以使用额外的库（例如为 PICO_BOARD=pico_w 构建时的无线支持），如果没有提供必要功能的板，就无法构建这些库。

有关 SDK 本身定义的板卡的列表，请查看此目录，其中包含每个指定板卡的头文件。

从创建的联编目录中制作目标程序。

make hello_world

现在，您可以通过调试器加载 hello_world.elf，也可以通过拖放方式在 树莓派Pico 上安装和运行 hello_world.uf2。

中文翻译版以英文版相同知识授权方式共享：CC-BY-SA 4.0。交流 Q群：498908352

最后于 更新