轻松玩转树莓派Pico之四、Ubuntu下在线debug环境搭建

已于 2023-12-17 10:41:20 修改
阅读量2.3k 收藏 16
点赞数 3
分类专栏： 轻松玩转树莓派PICO 文章标签： RP2040 树莓派pico vscode ubuntu
于 2022-11-24 00:16:44 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/flyingcys/article/details/128010178
版权

目录

1、openocd编译安装

1）安装依赖

2）下载

3）编译

4）安装GDB

2、Picoprobe编译与连接

1）下载、编译

 2）开发板连接

 3）Picoprobe连接至Linux

3、手工运行openocd和gdb

4、VSCode在线调试

1）插件安装

2）插件配置

3）Debug

按照前文轻松玩转树莓派Pico之一、新手上路一文中的Pico固件更新方式（uf2文件格式），在正式开发过程中需要不断修改代码/更新固件，这种固件更新方式会感觉开发效率有些低。Pico开发板芯片为RP2040，ARM-Cortex-M0架构，官方开发板上留有SWD接口，那是不是可以在线debug呢？答案是肯定的。

官方文档：https://datasheets.raspberrypi.com/pico/getting-started-with-pico.pdf 中有详细相关流程介绍。

官方文档中提供了2种在线debug方式：

方式1：树莓派作为主机，同时也作为openocd的仿真器，对Pico开发板进行固定烧录、在线debug。

方式2：使用1个专门的Pico开发板，作为Picoprobe，对另外一个目标Pico板进行debug

本文使用的是方式2，相关操作主机是在Ubuntu下进行。

另外，JLink也支持Pico在线调试，但对应的要求会相对更高。要求如下：

  1. J-Link software V7.64e or later
  2. J-Link HW revision 11 or later (J-Link EDU Mini and J-Trace PRO V1 or later also supported)
  3. SEGGER Embedded Studio for ARM V6.30 or later

对比后，JLink对应的硬件成本也比官方文档提供的方案高很多。

JLink操作Pico相关文档，可在Raspberry Pi Pico - SEGGER Wiki 页面查看。

本文所有操作流程均来源于getting-started-with-pico.pdf一文，只是将对应流程进行针对性的梳理。涉及到的章节有：

  1. Chapter 5. Flash Programming with SWD
  2. Chapter 6. Debugging with SWD
  3. Chapter 7. Using Visual Studio Code
  4. Appendix A: Using Picoprobe

1、openocd编译安装

1）安装依赖

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

2）下载

git clone https://github.com/raspberrypi/openocd.git --recursive --branch rp2040 --depth=1

3）编译

在命令行下，依次执行：

cd openocd
./bootstrap
./configure --enable-picoprobe --prefix=/usr/local/openocd
make -j4
sudo make install

在运行./configure --enable-picoprobe过程中可能会出现如下错误，该问题是由于pkg-config未安装

./configure: line 4520: syntax error near unexpected token `0.23'
./configure: line 4520: `PKG_PROG_PKG_CONFIG(0.23)'

使用如下命令安装：

sudo apt install -y pkg-config

安装完成后，在命令行下输入：

openocd -v

确定安装是否完成。安装成功则会显示如下：

​Open On-Chip Debugger 0.11.0-g4f2ae61-dirty (2022-11-09-22:06)
Licensed under GNU GPL v2
For bug reports, read
        OpenOCD: Bug Reporting

由于我们将openocd安装到了/usr/local/openocd目录，执行以上指令会报错，

command not found: openocd

则需要手工修改一下环境变量。如在zsh下修改~/.zshrc加入：

export PATH=$PATH:/usr/local/openocd/bin

并使用source命令让环境变量生效，可执行：

source ~/.zshrc

4）安装GDB

在命令行下输入：

sudo apt install gdb-multiarch

安装完成后，确认是否安装成功；在命令行中输入：

gdb-multiarch

正常安装会显示如下日志：

GNU gdb (Ubuntu 9.2-0ubuntu1~20.04.1) 9.2
Copyright (C) 2020 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
Type "show copying" and "show warranty" for details.
This GDB was configured as "x86_64-linux-gnu".
Type "show configuration" for configuration details.
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Find the GDB manual and other documentation resources online at:
    <http://www.gnu.org/software/gdb/documentation/>.


For help, type "help".
Type "apropos word" to search for commands related to "word".
(gdb)

2、Picoprobe编译与连接

Picoprobe支持swd和uart，可以实现在线debug的同时实现串口日志输出、串口通讯等功能。Picoprobe也是通过Pico（RP2040）实现，相关内容可查看Appendix A: Using Picoprobe 一章。

1）下载、编译

​git clone --recursive https://github.com/raspberrypi/picoprobe.git
​cd picoprobe
mkdir build && cd build
cmake ..
make -j4

该仓库下有freertos和CMSID_5子模块，子模块未下载会编译出错。

编译完成后，会在build目录下生成picoprobe.uf2

按照前文轻松玩转树莓派Pico之一、新手上路一文中更新固件的方式，将picoprobe.uf2更新至作为Picoprobe的开发板中。

 2）开发板连接

按照如下方式连接：

PicoA作为Picoprobe，PicoB作为真实debug开发板

Pico A GND -> Pico B GND
Pico A GP2 -> Pico B SWCLK
Pico A GP3 -> Pico B SWDIO
Pico A GP4/UART1 TX -> Pico B GP1/UART0 RX
Pico A GP5/UART1 RX -> Pico B GP0/UART0 TX 

Pico A VSYS -> Pico B VSYS 

这样就可以直接用1个usb接口，同时使用swd和uart功能

 3）Picoprobe连接至Linux

由于我是通过vmware虚拟机+ubuntu的开发方式，USB设备默认连接到了Windows主机，需要手工按照“虚拟机”->“可移动设备”->“Picoprobe”->“连接”，将Picoprobe连接到Ubuntu下。

在ubuntu下可通过通过dmesg | grep usb命令查看是否加载成功。 

 注：每次加载成功后，需要设置一下usb权限；在命令行下输入：

sudo chmod -R 777 /dev/bus/usb/

否则在运行中会出现如下错误：

Error: libusb_open() failed with LIBUSB_ERROR_ACCESS
Error: Failed to open or find the device
Error: Can't find a picoprobe device! Please check device connections and permissions.

3、手工运行openocd和gdb

openocd不仅可以用来在线debug，同时也可以用来烧录固件。

1）烧录固件

在命令行下输入：

cd pico-examples/build/hello_world/serial
openocd -f interface/picoprobe.cfg -f target/rp2040.cfg -c "program hello_serial.elf verify reset exit"

即可进行固件烧录

2）在线debug

在命令行下输入：

openocd -f interface/picoprobe.cfg -f target/rp2040.cfg -s tcl

正常启动openocd，显示日志如下：

Open On-Chip Debugger 0.11.0-g228ede4-dirty (2022-11-23-18:24)
Licensed under GNU GPL v2
For bug reports, read
        http://openocd.org/doc/doxygen/bugs.html
Info : only one transport option; autoselect 'swd'
adapter speed: 5000 kHz


Info : Hardware thread awareness created
Info : Hardware thread awareness created
Info : RP2040 Flash Bank Command
Info : Listening on port 6666 for tcl connections
Info : Listening on port 4444 for telnet connections
Info : clock speed 5000 kHz
Info : SWD DPIDR 0x0bc12477
Info : SWD DLPIDR 0x00000001
Info : SWD DPIDR 0x0bc12477
Info : SWD DLPIDR 0x10000001
Info : rp2040.core0: hardware has 4 breakpoints, 2 watchpoints
Info : rp2040.core1: hardware has 4 breakpoints, 2 watchpoints
Info : starting gdb server for rp2040.core0 on 3333
Info : Listening on port 3333 for gdb connections
  • 同时在另一命令终端中输入：
cd pico-examples/build/hello_world/serial
gdb-multiarch hello_serial.elf

在正常显示(gdb) ：后输入：

target remote localhost:3333

然后就可以输入b main等gdb指令，即可进行手工debug。

4、VSCode在线调试

使用手工运行openocd和gdb，对gdb熟悉度要求很高，我们可以借助VSCode相关功能进行可视化在线调试，无须再次手工输入一堆命令。

相关内容可以查看Chapter 7. Using Visual Studio Code一章。

1）插件安装

  • C/C++：用于C/C++语法支持，跳转，运行和调试功能
  • CMake：用于Cmake语法支持
  • Cmake Tools：让VSCode提供各种CMake编译相关的小工具，包括在底部状态栏显示一些快捷工具
  • Cortex-Debug：用来debug ARM cortex-M系列单片机

2）插件配置

VSCode运行和调试功能依赖C/C++插件和工程目录下的.vscode目录下相关.json文件配置。pico-examples工程提供了对应的配置文件。

在命令行下输入：

cd pico-examples
mkdir .vscode
cp ide/vscode/launch-raspberrypi-swd.json .vscode/launch.json
cp ide/vscode/settings.json .vscode/settings.json

由于我用的是Picoprobe，默认的lauch.json使用的是raspberrypi-swd模式，完成以上操作后，我们需要修改一下launch.json，将

 "configFiles": [
                "interface/raspberrypi-swd.cfg",
                "target/rp2040.cfg"
            ],

修改为：

 "configFiles": [
                "interface/picoprobe.cfg",
                "target/rp2040.cfg"
            ],

"configFiles"配置项为Cortex-Debug插件对应的相关配置文件。

3）Debug

点击VSCode的“运行和调试功能”按钮，点击“debug”按钮，VSCode会将当前目录下多个可执行人文件全部列出，让我们选择需要运行的目标文件。

  • 选择对应elf文件

  • 在线运行

VSCode会对当前工程下修改的文件做一次编译，编译没有错误后，调用openocd将选择后的elf下载至pico开发板，然后调用gdb，并跳转到main函数。

 点击右上角调试按钮，即可运行对应功能，分别对应“全速运行”、“运行至断点”、“单步调试”等功能。

  • debug过程中的相关信息查看

可通过“变量”、“监视”、“调用堆栈”、“断点”功能，查看代码运行过程中的相关值。

同时也可以通过Cortex-Debug插件对应的rp2040.svd文件提供的相关信息，查看“CORTEX PERIPHERALS”、“CORTEX REGISTERS”、“PERIPHERALS”等功能实时查看RP2040在运行过程中的状态，用于快速定位问题。

杭州_燕十三
关注
  • 3
    点赞
  • 踩
  • 16
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
树莓派单片机PICO的开发环境搭建资料
05-31
树莓派的小板子,PICO的开发环境搭建资料,有C++和python的两个环境搭建资料
ST7735/ITL9163B STM32F1 8位并口驱动_20pin
09-19
1.8寸ST7735 ITL9163B TFT 8位并口驱动keil项目； STM32F103R8 MCU //======液晶屏数据线接线==========// //本模块默认数据总线类型为8位并行模式 //8位模式接线：8位模式模块接低8位总线，即: //液晶屏LCD_D0对应单片机PC0 //液晶屏LCD_D1对应单片机PC1 //液晶屏LCD_D2对应单片机PC2 //液晶屏LCD_D3对应单片机PC3 //液晶屏LCD_D4对应单片机PC4 //液晶屏LCD_D5对应单片机PC5 //液晶屏LCD_D6对应单片机PC6 //液晶屏LCD_D7对应单片机PC7 //========== 液晶屏控制线接线 ================// //LCD_RST 接PB4 //复位信号 //LCD_CS 接PB3 //片选信号 //LCD_RS 接PB5 //寄存器/数据选择信号 /
qemu仿真raspberry_pi_5 arm64系统
最新发布
柳似烟的专栏
02-29 432
qemu运行Raspberry pi 5 方法 教程
stm32f4双区升级实例工程
07-05
使用一个标志位进行APP1和APP2区域的切换。只讲基本过程，具体的串口升级协议没有添加，大家仅供参考。与传统双区升级不同的是不存在临时区，每一个区都是代码区域，通过标志位进行快速切换。
清空树莓派pico原始程序文件
05-27
只要按着BOOTSEL按键再插USB口进入bootloader模式，然后在设备管理器里找到RP2 boot(interface0)的那一项，然后彻底卸载掉，重新拔插就会自动安装正确的驱动。也许这是常规操作，反正作者当时想不到。这就又回到了上一层问题：normal模式下设备管理器不识别开发板。 以为还是驱动问题，设备管理器不识别可不就是驱动问题吗？MicroPython论坛里几个大佬版主在解答新手提出的main函数停不下来怎么重置Pico的问题
树莓派pico清空flash固件
05-10
树莓派pico清空flash固件
树莓派 Pico(raspberry pi pico)极简入门
m0_71713477的博客
05-07 4253
尝试失败后，可在菜单栏“项目”中选择“导出已编译的二进制文件”，之后在项目目录中找到编译好的uf2文件，之后用第一段中介绍的方法将其烧写入pico中。可使用Arduino IDE自带的上传功能，或长按Pico上的BOOTSEL键并插入USB口，之后计算机会把pico识别为大容量U盘设备。这也是一个重载过很多次的方法，可以类别stdio.h中的getchar使用，此处不再展开。在编写好项目后，务必将项目保存，否则下次打开时会重新生成默认的setup和loop，之前写的代码也会丢失。两个结果里面随便选一个。
使用树莓派PICO点灯
优信电子的博客
10-31 1866
树莓派是使用基于RP2040芯片的树莓派微控制器开发板，使用双核Arm Cortex-M0+@133Mhz，芯片内置264KB SRAM 和2MB的板载内存，支持U2的USB大容量存储启动模式，用于拖放式编程，并支持MicroPython编程，此文章使用ThonnyMicroPython进行电灯。使用Thonny配合MicroPython进行编程对于新手使用入门树莓派PICO是非常简单的，后续也会更新其他模块的驱动方式，有对树莓派PICO和MicroPython感兴趣的小伙伴们可以点击关注哦！
【硬件控制】1. Pico介绍
raspberry_pi的博客
03-19 3058
树莓派0到4全部用的博通的处理器，现在树莓派出了一款微控制器RP2040，注意是微控制器，Arm Cortex-M0系列(Arm最低端)，有了这款微控制器后树莓派就出了一款开发板就是Pico，相当于是这款芯片的一个官方使用案例。当你长按BOOTSEL按钮时插入电脑USB接口，Pico会进入程序烧录模式，这时候电脑上显示一个USB存储设备，将自己写好的固件拷进去就好了，拷贝完成后Pico会自动重启，执行你的程序。找一款串口调试助手工具，然后串口号选择你的Pico串口号，波特率选择9600，点击打开串口。
UF2文件格式
IThaozi
12-20 6644
UF2是一种新的二进制文件格式，由Microsoft为PXT （也称为Microsoft MakeCode）开发，可以通过MSC（Mass Storage Class，也称为可移动闪存驱动器）方式更新程序。与DAPlink类似，UF2也提供了CDC串行接口，可以方便的和主机通信与调试程序。 总览 UF2文件包含512个字节的块，每个块都是独立的，并且彼此独立。每个512字节块包括（请参阅下面的详...
树莓派PICO入门教程
weixin_51684355的博客
09-25 4382
树莓派PICO-MicroPython基础教程
树莓派Pico开发环境-MicroPython.7z
07-30
SDK+Thonny+手册
Raspberry树莓派pico读取mpu6050+四元数、一阶互补滤波
05-22
Raspberry树莓派pico读取mpu6050+四元数、一阶互补滤波 详细介绍 https://gitee.com/Wind_to_valley/FallPrevent
【window下配置Maxim SDK环境】
vor234的博客
11-27 1703
MAX78000FTHR为快速开发平台，帮助工程师利用MAX78000 Arm® Cortex® M4F处理器快速实施超低功耗、人工智能(AI)方案，器件集成卷积神经网络加速器。本文为MAX78000羽毛板搭建window开发环境。下图为板载资源具体硬件介绍见。
STM32使用SWD连接报错总结
xuezhimeng2010的专栏
12-11 3万+
STM32使用SWD连接报错总结使用SWD通过J-Flash烧写STM32时，会出现各式各样的错误； 总结下原因： 1、复位脚被拉低了， 可以正常连接，但是烧写程序时会出现如下报错 –> - Erasing affected sectors … - ERROR: RAM check failed @ address 0x20000000. - ERROR:
体验S3C2440内存启动Das u-boot
老年程序员的思考
06-28 650
ARM指令集是加载/存储型的，就是说指令集仅仅能处理寄存器中的数据，而且处理结果都要放回寄存器中，而对系统存储器的访问则需要通过专门的加载/存储指令来完成。ARM微处理器的指令集可以分为六大类：跳转指令、数据处理指令、程序状态寄存器（PSR）处理指令、加载/存储指令、协处理器指令和异常产生指令。
树莓派Pico|RP2040简介|PINOUT|点灯示例
Medlar_CN的博客
06-24 7419
树莓派Pico RP2040简介|PINOUT|点灯示例
树莓派 PICO基础教程（基于MicroPython）
热门推荐
AI新手程序员
05-31 4万+
文章目录1 树莓派 PICO 简介1.1 简介1.2 配置 [^2]1.3 引脚图1.4 尺寸2 安装2.1 烧录固件2.2 安装IDE（Thonny IDE）2.3 离线运行程序3 基础3.01 点亮板载LED灯3.02 板载LED闪烁3.03 LED流水灯3.04 按键实验3.05 外部中断(改进3.04 按键实验)3.06 定时器中断(改进3.02 板载LED闪烁)3.07 PWM 脉冲宽度调制(实现板载LED呼吸灯)3.08 I2C总线(使用SSD1306 OLED屏幕)4 传感器程序4.1 温度传
Ubuntu搭建树莓派pico RP2040开发环境
weixin_44220832的博客
12-29 1768
Ubuntu搭建树莓派pico开发环境[CLion]
在WINDOS环境下安装树莓派pico
06-10
在Windows环境下安装树莓派pico需要进行以下步骤： 1. 安装Python 树莓派pico使用Micropython进行编程，因此需要安装Python。您可以从官方网站下载Python安装程序，并按照提示进行安装。 2. 安装Git Git是一个版本控制工具，也是树莓派pico的SDK依赖的工具。您可以从Git官网下载安装程序，然后按照提示进行安装。 3. 安装Pico-SDK Pico-SDK是树莓派pico的开发套件，是开发树莓派pico的必备工具。您可以通过以下命令在命令行中安装Pico-SDK： ``` git clone -b master https://github.com/raspberrypi/pico-sdk.git ``` 4. 安装Pico-Tool Pico-Tool是一个命令行工具，用于将编译后的固件烧录到树莓派pico上。您可以通过以下命令在命令行中安装Pico-Tool： ``` pip3 install pico_tool ``` 5. 编译程序 使用Pico-SDK编写您的程序并编译。您可以通过以下命令在命令行中编译程序： ``` cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug -DPICO_BOARD=rp2040 cmake --build build ``` 6. 烧录固件 使用Pico-Tool将编译后的固件烧录到树莓派pico上。您可以通过以下命令在命令行中烧录固件： ``` pico_tool load your_program.uf2 ``` 7. 测试程序 烧录成功后，您可以将树莓派pico连接到电脑上，并通过串口终端工具（如PuTTY）来测试程序。 希望以上步骤对您有所帮助。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值