kopia lustrzana https://github.com/majbthrd/pico-debug
added pyOCD instructions
Peter Lawrence
rodzic
53b27603e3
commit
c7ab23b657
|
|
@ -6,11 +6,31 @@ This [executive summary](about.md) might be of interest, particularly if you are
|
||||||
|
|
||||||
For applications that use pico-sdk (pico-examples, etc. ... this is true of nearly all code), please follow the instructions in [building.md](building.md).
|
For applications that use pico-sdk (pico-examples, etc. ... this is true of nearly all code), please follow the instructions in [building.md](building.md).
|
||||||
|
|
||||||
## debugging Pico applications with pico-debug
|
## debugging Pico applications with pico-debug using the GDB protocol
|
||||||
|
|
||||||
For OpenOCD users (including [Visual Studio Code](https://code.visualstudio.com/), etc.), after following the above steps on building Pico applications, please follow the instructions in [openocd.md](openocd.md). For Visual Studio Code users, then also read [vscode.md](vscode.md).
|
You have a choice between this and "debugging Pico applications with pico-debug without using the GDB protocol" further below.
|
||||||
|
|
||||||
Or, if you are a [Rowley Crossworks for ARM](https://www.rowley.co.uk/arm/index.htm) user, take a look at the pico-crossworks example in [pico-demos](https://github.com/majbthrd/pico-demos).
|
First make certain that you have followed the steps above in "building Pico applications".
|
||||||
|
|
||||||
Or, if you are a [SEGGER Embedded Studio](https://www.segger.com/products/development-tools/embedded-studio/) user, take a look at the pico-ses example in [pico-demos](https://github.com/majbthrd/pico-demos). Before debugging a target with SEGGER Embedded Studio, you will need to run openocd as shown in the [openocd.md](openocd.md) instructions.
|
For OpenOCD users, please follow the instructions in [openocd.md](openocd.md).
|
||||||
|
|
||||||
|
For pyOCD users, please follow the instructions in [pyocd.md](pyocd.md).
|
||||||
|
|
||||||
|
Then proceed to "debuggers that use GDB" immediately below.
|
||||||
|
|
||||||
|
## debuggers that use GDB
|
||||||
|
|
||||||
|
First make certain that you have your GDB implementation of choice running (OpenOCD, pyOCD, etc.).
|
||||||
|
|
||||||
|
For [Visual Studio Code](https://code.visualstudio.com/) users, then also read [vscode.md](vscode.md).
|
||||||
|
|
||||||
|
For [SEGGER Embedded Studio](https://www.segger.com/products/development-tools/embedded-studio/) users, take a look at the pico-ses example in [pico-demos](https://github.com/majbthrd/pico-demos).
|
||||||
|
|
||||||
|
## debugging Pico applications with pico-debug without using the GDB protocol
|
||||||
|
|
||||||
|
You have a choice between this and "debugging Pico applications with pico-debug using the GDB protocol" further above.
|
||||||
|
|
||||||
|
First make certain that you have followed the steps above in "building Pico applications".
|
||||||
|
|
||||||
|
If you are a [Rowley Crossworks for ARM](https://www.rowley.co.uk/arm/index.htm) user, take a look at the pico-crossworks example in [pico-demos](https://github.com/majbthrd/pico-demos).
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,137 @@
|
||||||
|
## Install pyOCD
|
||||||
|
|
||||||
|
You must already have python3 and pip installed prior to these instructions. Be sure to also read the limitations section at the end of this document.
|
||||||
|
|
||||||
|
Option #1: install the latest stable package for your system
|
||||||
|
|
||||||
|
```
|
||||||
|
pip install -U pyocd
|
||||||
|
```
|
||||||
|
|
||||||
|
At least on my system at the time of writing, this installed pyOCD v0.30.3, which did not support writing RP2040 flash properly. So, I would encourage trying the second option...
|
||||||
|
|
||||||
|
Option #2: install the latest prerelease code (suggested)
|
||||||
|
|
||||||
|
```
|
||||||
|
python3 -mpip install --pre -U git+https://github.com/pyocd/pyOCD.git
|
||||||
|
```
|
||||||
|
|
||||||
|
After the installation, confirm the pyOCD version with the following command:
|
||||||
|
|
||||||
|
```
|
||||||
|
pyocd -V
|
||||||
|
```
|
||||||
|
|
||||||
|
## Install GDB
|
||||||
|
|
||||||
|
```
|
||||||
|
$ sudo apt install gdb-multiarch
|
||||||
|
```
|
||||||
|
|
||||||
|
## Use GDB, pyOCD, and pico-debug to debug 'blinky'
|
||||||
|
|
||||||
|
If you have not already built blinky (or whichever app that you might choose to debug), some [sample instructions are here](building.md).
|
||||||
|
|
||||||
|
Obtain "pico-debug-gimmecache.uf2" from the Releases at:
|
||||||
|
|
||||||
|
https://github.com/majbthrd/pico-debug
|
||||||
|
|
||||||
|
Boot the RP2040 with the BOOTSEL button pressed, copy over pico-debug-gimmecache.uf2 to the RP2040, and it immediately reboots as a CMSIS-DAP adapter (ready for pyOCD to talk to it).
|
||||||
|
|
||||||
|
```
|
||||||
|
pyocd gdbserver -t rp2040_core0
|
||||||
|
```
|
||||||
|
|
||||||
|
Your output should look something like this:
|
||||||
|
|
||||||
|
```
|
||||||
|
0001147:INFO:board:Target type is rp2040_core0
|
||||||
|
0001205:INFO:dap:DP IDR = 0x0bc12477 (v2 MINDP rev0)
|
||||||
|
0001219:INFO:ap:AHB-AP#0 IDR = 0x04770031 (AHB-AP var3 rev0)
|
||||||
|
0001240:INFO:rom_table:AHB-AP#0 Class 0x1 ROM table #0 @ 0xe00ff000 (designer=43b part=4c0)
|
||||||
|
0001249:INFO:rom_table:[0]<e000e000:SCS-M0+ class=14 designer=43b part=008>
|
||||||
|
0001255:INFO:rom_table:[1]<e0001000:DWT-M0+ class=14 designer=43b part=00a>
|
||||||
|
0001261:INFO:rom_table:[2]<e0002000:BPU class=14 designer=43b part=00b>
|
||||||
|
0001265:INFO:cortex_m:CPU core #0 is Cortex-M0+ r0p1
|
||||||
|
0001270:INFO:dwt:2 hardware watchpoints
|
||||||
|
0001274:INFO:fpb:4 hardware breakpoints, 0 literal comparators
|
||||||
|
0001288:INFO:server:Semihost server started on port 4444 (core 0)
|
||||||
|
0001315:INFO:gdbserver:GDB server started on port 3333 (core 0)
|
||||||
|
0014740:INFO:gdbserver:Client connected to port 3333!
|
||||||
|
0014966:INFO:gdbserver:Attempting to load argon
|
||||||
|
0014966:INFO:gdbserver:Attempting to load freertos
|
||||||
|
0014967:INFO:gdbserver:Attempting to load rtx5
|
||||||
|
0014967:INFO:gdbserver:Attempting to load threadx
|
||||||
|
0014968:INFO:gdbserver:Attempting to load zephyr
|
||||||
|
```
|
||||||
|
|
||||||
|
This pyOCD terminal needs to be left open. So go ahead and open another terminal; in this one we’ll attach a gdb instance to pyOCD:
|
||||||
|
|
||||||
|
```
|
||||||
|
$ cd ~/pico/pico-examples/build/picoboard/blinky
|
||||||
|
$ gdb-multiarch picoboard_blinky.elf
|
||||||
|
```
|
||||||
|
|
||||||
|
Connect GDB to pyOCD:
|
||||||
|
|
||||||
|
```
|
||||||
|
(gdb) target remote localhost:3333
|
||||||
|
```
|
||||||
|
|
||||||
|
and load picoboard_blinky.elf into flash:
|
||||||
|
|
||||||
|
```
|
||||||
|
(gdb) load
|
||||||
|
Loading section .boot2, size 0x100 lma 0x10000000
|
||||||
|
Loading section .text, size 0x4828 lma 0x10000100
|
||||||
|
Loading section .rodata, size 0xd6c lma 0x10004928
|
||||||
|
Loading section .binary_info, size 0x1c lma 0x10005694
|
||||||
|
Loading section .data, size 0xa4c lma 0x100056b0
|
||||||
|
Start address 0x100001e8, load size 24828
|
||||||
|
Transfer rate: 8 KB/sec, 4138 bytes/write.
|
||||||
|
```
|
||||||
|
|
||||||
|
and then start it running:
|
||||||
|
|
||||||
|
```
|
||||||
|
(gdb) monitor reset
|
||||||
|
(gdb) continue
|
||||||
|
```
|
||||||
|
|
||||||
|
Or, if you want to set a breakpoint at main() before running the executable:
|
||||||
|
|
||||||
|
```
|
||||||
|
(gdb) monitor reset
|
||||||
|
(gdb) b main
|
||||||
|
(gdb) continue
|
||||||
|
Continuing.
|
||||||
|
Note: automatically using hardware breakpoints for read-only addresses.
|
||||||
|
|
||||||
|
Breakpoint 1, main () at ../main.c:48
|
||||||
|
48 sys_init();
|
||||||
|
```
|
||||||
|
|
||||||
|
before continuing after you have hit the breakpoint:
|
||||||
|
|
||||||
|
```
|
||||||
|
(gdb) continue
|
||||||
|
```
|
||||||
|
|
||||||
|
if the target is running, it can be interrupted with Ctrl-C, at which point another gdb prompt should appear:
|
||||||
|
|
||||||
|
```
|
||||||
|
(gdb)
|
||||||
|
```
|
||||||
|
|
||||||
|
To quit from gdb, type:
|
||||||
|
|
||||||
|
```
|
||||||
|
(gdb) quit
|
||||||
|
```
|
||||||
|
|
||||||
|
## pyOCD limitations
|
||||||
|
|
||||||
|
With the "0.30.4.dev30" version of pyOCD that I tried, "monitor reset" does not stop execution after reset. Moreover, pyOCD seems to defeat all breakpoints that were set before the "monitor reset" command.
|
||||||
|
|
||||||
|
The user has to "continue" before pyOCD even realizes that the target is already running, and then and only then can the user stop execution to set breakpoints **again**. This does limit the utility of pyOCD at the time of writing.
|
||||||
|
|
||||||
Ładowanie…
Reference in New Issue