mirror
/
pico-debug
kopia lustrzana https://github.com/majbthrd/pico-debug
1
0
Forkuj 0
Kod Zgłoszenia Projekty Wydania Wiki Aktywność
pico-debug runs on one core in a RP2040 and provides a USB CMSIS-DAP interface to debug the other core
15 Commity
1 Gałąź
6 Tagi
302 KiB
C 99.8%
Assembly 0.2%
 
 
Go to file
Peter Lawrence 53b27603e3 add unique serial number for USB descriptor and CMSIS-DAP DAP_Info 2021-03-21 14:09:12 -05:00
CMSIS_5@61cfe5d56f initial commit 2021-02-04 16:51:59 -06:00
howto added Mac info to howto/openocd.md 2021-03-13 09:51:10 -06:00
pico initial commit 2021-02-04 16:51:59 -06:00
rp2040 corrected core type in rp2040.h 2021-02-09 15:39:08 -06:00
tinyusb@09868434cd updated TinyUSB submodule 2021-02-16 14:58:39 -06:00
.gitmodules initial commit 2021-02-04 16:51:59 -06:00
DAP_config.h add unique serial number for USB descriptor and CMSIS-DAP DAP_Info 2021-03-21 14:09:12 -05:00
README.md added example instructions 2021-02-10 14:03:56 -06:00
bootcode.c add unique serial number for USB descriptor and CMSIS-DAP DAP_Info 2021-03-21 14:09:12 -05:00
main.c initial commit 2021-02-04 16:51:59 -06:00
myboard.c add unique serial number for USB descriptor and CMSIS-DAP DAP_Info 2021-03-21 14:09:12 -05:00
pico-debug.hzp add unique serial number for USB descriptor and CMSIS-DAP DAP_Info 2021-03-21 14:09:12 -05:00
picodebug_MemoryMap.xml add unique serial number for USB descriptor and CMSIS-DAP DAP_Info 2021-03-21 14:09:12 -05:00
picodebug_Startup.s add unique serial number for USB descriptor and CMSIS-DAP DAP_Info 2021-03-21 14:09:12 -05:00
picodebug_sram_placement.xml add unique serial number for USB descriptor and CMSIS-DAP DAP_Info 2021-03-21 14:09:12 -05:00
picodebug_xip_placement.xml add unique serial number for USB descriptor and CMSIS-DAP DAP_Info 2021-03-21 14:09:12 -05:00
spawn.c two variants; debugger now runs on Core1 2021-02-06 19:30:11 -06:00
tusb_config.h initial commit 2021-02-04 16:51:59 -06:00
usb_descriptors.c add unique serial number for USB descriptor and CMSIS-DAP DAP_Info 2021-03-21 14:09:12 -05:00

README.md

Description

RP2040 has two ARM Cortex-M0+ cores, and the second core normally remains dormant.

pico-debug runs on one core in a RP2040 and provides a USB CMSIS-DAP interface to debug the other core. No hardware is added; it is as if there were a virtual debug pod built-in.

Boot the RP2040 with the BOOTSEL button pressed, copy over pico-debug.uf2, and it immediately reboots as a CMSIS-DAP adapter. pico-debug loads as a RAM only .uf2 image, meaning that it is never written to flash and doesn't replace existing user code.

To cater to different user situations, there are two versions of pico-debug: MAXRAM and GIMMECACHE

Most users will prefer to use the GIMMECACHE version.

With pico-debug-maxram, all 264kBytes of SRAM on the RP2040 is available for running user code; pico-debug shoehorns itself entirely into the 16kBytes of XIP_SRAM (aka flash cache).

With pico-debug-gimmecache, 248kBytes (94% of total) of SRAM is available for running user code; pico-debug gives plenty of elbow room by occupying only 6% near the very top of SRAM, and unlike MAXRAM, leaves the flash cache operational.

If viewing this on github, pre-built binaries are available for download on the right under "Releases".

How to use

Please read howto/README.md for instructions on how to start using pico-debug.

Caveats whilst using pico-debug

The executive summary is:

pico-debug uses the USB port to provide debugging to the user, so the user's app can't be simultaneously using the USB port! :)

The specifics are:

  • MAXRAM only: the flash cache cannot be used by the user code, as pico-debug is using this memory
  • GIMMECACHE only: SRAM 0x2003C000 to 0x2003FFFF must not be used by user code
  • user code cannot reconfigure the PLL_USB, as the USB peripheral needs this
  • the USB peripheral is used to provide the debugger, so the user code cannot use it as well

License

TinyUSB and code specific to pico-debug is licensed under the MIT license.

ARM's CMSIS_5 code is licensed under the Apache 2.0 license.