跳至内容
本页目录

Raspberry Pi Pico 上手

适用范围： 标准版 Raspberry Pi Pico（第一代，RP2040，无无线）。Pico H（预焊排针）行为完全相同；Pico W 增加无线，不在本页范围。

身份核对

标准 Pico 是第一代板卡：RP2040、2 MB flash、micro-USB、半孔 DIP。如果你的板子写的是 Pico 2，请用 Pico 2 上手指南——BOOTSEL 机制相同，但盘符（RP2350）、固件文件（RPI_PICO2）与构建目标（PICO_BOARD=pico2）都不同。

先选语言

树莓派官方支持两条路径，选择决定你往板上拖什么文件：

路径你拖入的文件你得到什么
MicroPythonmicropython.org 的 MicroPython .uf2一个解释器；你经 USB 串口（REPL）写 Python
C/C++ SDK自己编译出的 .uf2裸机二进制；板上没有解释器

官方没有把哪条标为"新手路径"——MicroPython 不需要工具链，C/C++ 在写第一行代码前就要装好 CMake 与 Arm 交叉编译器。

MicroPython：拖入、放下、REPL

按官方拖拽指南：

  1. 按住 BOOTSEL，把 USB 连到电脑，板卡以名为 RPI-RP2 的大容量存储设备出现后松开 BOOTSEL。
  2. 把 Pico 版 MicroPython UF2 拖入该卷。Pico 随即重启——你已经在运行 MicroPython。
  3. 经 USB 串口访问 REPL（官方书同时讲了命令行与 Thonny IDE 两种方式）。

预期： 出现一个名字就叫 RPI-RP2 的盘，拖入后消失（这次重启就是成功，不是故障）。如果什么都没出现，见 USB 识别不到板卡。

C/C++ SDK：先工具链，后自产 UF2

官方快速开始刻意精简且基于 Linux；如实概括如下：

  1. 安装 CMake（≥ 3.13）与 Arm 交叉编译器（gcc-arm-none-eabi 及配套库）。
  2. git clone https://github.com/raspberrypi/pico-sdk.git，设置 PICO_SDK_PATH（环境变量，或之后给 CMake 传 -DPICO_SDK_PATH=）。
  3. 把 SDK 里的 external/pico_sdk_import.cmake 拷进项目；在 CMakeLists.txt 的 project() 之前 include() 它，再调用 pico_sdk_init()。
  4. 构建 hello_world（单个 .c、链接 pico_stdlib、pico_add_extra_outputs 产出 UF2），然后像 MicroPython 文件一样经 BOOTSEL 拖入。

预期： 构建在 ELF 旁边产出 .uf2；stdout 默认走 UART——setup_default_uart() 从 GPIO0/1 打印，不是 USB，除非用 USB 示例。Windows/macOS 的详细步骤以官方书为准，不在本页复制。

本页不能告诉你的

  • 我们没有在本环境真机跑过这些步骤。 流程转写自下方固定版本官方文档；MCUID 没有为此产出真机点亮回执。
  • 你拿到的是哪个 MicroPython 构建——下载链接跟随最新版本；本页不固定 MicroPython 版本号。
  • Pico W 无线配置——另有官方无线连接文档。

来源