用途：在开发 Raspberry Pi Pico 2（RP2350）板卡或使用 Raspberry Pi Debug Probe 时提供参考，覆盖硬件规格、SDK 安装、构建配置、调试工作流与常见坑。
内容组织为参考文件，按任务只读相关文件：references/pico2-hardware.md 涵盖 RP2350 规格、RP2040 与 RP2350 对比、引脚布局、无线版本、安全特性与芯片变体；references/debug-probe.md 涵盖调试探针硬件、接线、OpenOCD 设置、GDB 工作流、UART 串口、RTT、VS Code 集成、恢复模式与排错；references/sdk-toolchain.md 涵盖 pico-sdk 设置、CMake 配置、ARM 与 RISC-V 构建、picotool 命令、MicroPython/CircuitPython 与项目结构。
构建板卡选择（CMake）：Pico 1 用 -DPICO_BOARD=pico（默认，rp2040），Pico 1 W 用 -DPICO_BOARD=pico_w，Pico 2 用 -DPICO_BOARD=pico2（rp2350-arm-s），Pico 2 W 用 -DPICO_BOARD=pico2_w，Pico 2 RISC-V 用 -DPICO_BOARD=pico2 -DPICO_PLATFORM=rp2350-riscv。
必要用法：SDK 默认面向 Pico 1，必须显式传 -DPICO_BOARD=pico2 才针对 RP2350，否则生成的二进制无法在 Pico 2 上运行；调试需用 -DCMAKE_BUILD_TYPE=Debug。使用 Raspberry Pi 分支的 OpenOCD（上游 0.12.0 对 RP2350 支持不完整，从 https://github.com/raspberrypi/openocd.git 的 rpi-common 分支克隆）。目标配置须匹配芯片：RP2040 用 target/rp2040.cfg，RP2350 用 target/rp2350.cfg，RISC-V 加 -c "set USE_CORE { rv0 rv1 }"，恢复模式加 -c "set RESCUE 1"。典型调试：先运行 openocd -f interface/cmsis-dap.cfg -f target/rp2350.cfg -c "adapter speed 5000"，再用 arm-none-eabi-gdb 连接 localhost:3333 执行 reset init、load、break、continue。SWD 烧录用 .elf：openocd -f interface/cmsis-dap.cfg -f target/rp2350.cfg -c "adapter speed 5000" -c "program my_app.elf verify reset exit"；BOOTSEL 用 .uf2，两者不可混用。
限制与注意：RISC-V 模式无 FPU（仅 Cortex-M33 有硬件浮点），切换 ARM 与 RISC-V 需清空 build 目录重新 cmake；RISC-V 调试需先用 picotool reboot -u -c riscv 预选核。Debug Probe 不为目标供电，Pico 2 须自行通过 USB 或 VSYS 供电，且先接 GND 再接信号线。无线版板载 LED 由 WL_GPIO0 经 CYW43439 控制，代码需按型号条件处理；SPI 事务期间会阻塞 VSYS ADC 读取与 CYW43439 IRQ 检测。pico-sdk 需执行 git submodule update --init 拉取依赖。OTP 写入不可逆，误配安全启动可能永久损坏设备。macOS 上需 brew install hidapi libusb；多探针时用 adapter serial 指定序列号。