功能简介

特性	无特性，不解释
主控	RP2040
'	无特性，不解释
'	无特性，不解释
'	无特性，不解释
接口	UART	SWD	Micro USB

说明

产品简介

Raspberry Pi Debug Probe 是树莓派官方出品的一款专为 Pico 设计的 USB 硬件调试下载器，采用一体式设计，具有免焊接、即插即用的特性，可通过 SWD 接口连接目标板的调试接口进行调试。

产品特性

搭载 Raspberry Pi 官方自主设计的 RP2040 微控制器芯片
板载 Micro-USB 接口，用于连接 PC 主机或其他主板
板载 3PIN SWD 接口，用于连接被调试的目标板
板载 3PIN UART 接口，可用于实现 USB 串口转接器的功能
标准 CMSIS-DAP 接口，可用于调试大部分基于 ARM 的微控制器
适用 OpenOCD 和其他支持 CMSIS-DAP 的调试工具
采用树莓派同类型的 3PIN 调试接口规范
配备高质量透明塑料外壳以及相关连接线材
程序开源，升级固件更方便

资源介绍

产品尺寸

使用教程

安装OpenOCD

Linux (and Raspberry Pi)

下载依赖库

sudo apt install automake autoconf build-essential texinfo libtool libftdi-dev libusb-1.0-0-dev

获取并编译

git clone https://github.com/raspberrypi/openocd.git --branch rp2040 --depth=1 --no-single-branch
cd openocd
./bootstrap
./configure
make -j4
sudo make install

Windows

因为OpenOCD自编译在windows环境下比较复杂，推荐使用已经编译好的版本
- 点击进行下载
解压并存放在比较短的目录中，如直接存放在C盘中

添加环境变量

点击“开始”菜单，搜索“环境变量”。
点击“编辑系统环境变量”
双击“path”变量，进入编辑界面。
添加新的路径
- ①创建新变量地址
- ②输入OpenOCD的存放地址
- ③点击确定进行保存
点击“确定”保存更改。
重启电脑

安装GDB

Linux (and Raspberry Pi)

安装gdb-multiarch
```
sudo apt install gdb-multiarch
```

Windows

如果你已经正确安装了pico-sdk相关的环境，则跳过此步骤，因为GDB已经被Arm GNU Toolchain包含
如果你未安装pico-sdk相关的环境，建议使用官方提供pico安装程序进行安装
- 官方下载地址
- 离线包

使用Raspberry Pi Debug Probe烧录程序

Pico Debug Probe 可让您通过 SWD 端口和 OpenOCD 加载二进制文件
每次将新二进制文件推送到 Pico 时，您无需拔下然后按住 BOOTSEL 按钮

以对RP2040使用为例，烧录程序指令为

sudo openocd -f interface/cmsis-dap.cfg -f target/rp2040.cfg -c "adapter speed 5000" -c "program {你的elf文件名}.elf verify reset exit"

如你当前文件夹下有一个blink.elf的文件

sudo openocd -f interface/cmsis-dap.cfg -f target/rp2040.cfg -c "adapter speed 5000" -c "program blink.elf verify reset exit"

使用Raspberry Pi Debug Probe调试程序

打开OpenOCD服务器

你可以让openocd在服务器模式下使用，并连接 GDB，从而为您提供断点和“正确”调试。

这里也是以调试rp2040为例，输入以下指令

sudo openocd -f interface/cmsis-dap.cfg -f target/rp2040.cfg -c "adapter speed 5000"

以windows，使用powershell为例

- 此时开始监听本机的3333接口则表明OpenOCD服务器已经成功开启了

使用GDB命令行

本例程基于pico-sdk环境搭建完成，并且pico-example编译完成

打开powershell并进入对应的build文件夹，这里以blink例程为例
打开gbd，输入以下指令
- 如果为windows输入指令为
```
arm-none-eabi-gdb blink.elf
```
- 如果为linux输入指令为
```
gdb blink.elf
```
依次输入以下指令
```
target remote localhost:3333
load
monitor reset init
continue
```
- 就可以看到pico执行blink，led闪烁

使用VSCode调试（进阶）

请确保前文打开OpenOCD服务器与使用GDB命令行运行正常
请确保Pico编译环境搭建正常
请确保你的VSCode安装以下插件
1. Cortex-Debug
2. Cmake-tools
3. C/C++

首先打开OpenOCD服务器
使用VSC打开pico-examples文件夹并打开blink例程
使用快捷键F1并输入以下指令
```
open 'launch.json'
```

打开后将下文放入其中

若为Windows系统则输入

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Pico Debug",
            "type":"cortex-debug",
            "cwd": "${workspaceRoot}",
            "executable": "${command:cmake.launchTargetPath}",
            "request": "launch",
            "servertype": "external",
            // This may need to be arm-none-eabi-gdb depending on your system
            "gdbPath" : "gdb",
            // Connect to an already running OpenOCD instance
            "gdbTarget": "localhost:3333",
            "svdFile": "${env:PICO_SDK_PATH}/src/rp2040/hardware_regs/rp2040.svd",
            "runToMain": true,
            // Work around for stopping at main on restart
            "postRestartCommands": [
                "break main",
                "continue"
            ]
        }
    ]
}

若linux系统则输入

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Pico Debug",
            "type":"cortex-debug",
            "cwd": "${workspaceRoot}",
            "executable": "${command:cmake.launchTargetPath}",
            "request": "launch",
            "servertype": "external",
            // This may need to be arm-none-eabi-gdb depending on your system
            "gdbPath" : "arm-none-eabi-gdb",
            // Connect to an already running OpenOCD instance
            "gdbTarget": "localhost:3333",
            "svdFile": "${env:PICO_SDK_PATH}/src/rp2040/hardware_regs/rp2040.svd",
            "runToMain": true,
            // Work around for stopping at main on restart
            "postRestartCommands": [
                "break main",
                "continue"
            ]
        }
    ]
}

两者区别为调用的gdb不同

进入运行与调试界面快捷键 Ctrl+Shift+D
- ①将pico debug选为调试器
- ②将CMake选为 debug模式
- ③开始调试按键，快捷键F5
- ④选择调试对象选为blink
点击调试按键进入调试模式，快捷键F5
出现调试工具栏
- ①重启设备
- ②继续运行程序
- ③执行一步
- ④进入函数运行
- ⑤跳出函数运行
- ⑥停止调试
点击继续运行程序快捷键F5，即可看到pico运行blink例程