Content for the cmsis-dap Debug Probe in "Getting Started with Raspberry Pi Pico"

Open
#336 7 comments 0 reactions 1 assignee View on GitHub

@nathan-contino is already working on this.

Since Sep 5, 2023.

Assessment

This issue has not been assessed yet.

Description

hardware pdf

Regarding: https://datasheets.raspberrypi.com/pico/getting-started-with-pico.pdf

As the official Debug Probe is now available, it would be helpful to have this formally covered for C/C++ development - especially for use with an IDE such as Visual Studio Code.

The changes are small but significant (and quite hard to track down!)

Section 7.3

Having worked through this document for the first time, it was not clear that pico debug was different to the debug probe. I wasted considerable time trying to unpick the problem. I suspect I will not be the only person to make this incorrect assumption. I wonder if this is worth highlighting?

For the pico debug probe, the key to seamless debug in VS Code seems to be launch.json
I've raised a PR to have a suitable template added to the examples. However, the change is quite easy (summarised below) and might be worth documenting?

Changes:

The file that becomes launch.json would need changing as follows:

  • Line 15 would need "interface/raspberrypi-swd.cfg" replaced with "interface/cmsis-dap.cfg"

  • To get the correct adapter speed, add the following:

    "serverArgs": [
      "-c", "adapter speed 5000"
    ],
    

This might save someone a lot of time.

Dominant language
No language data
Stars
35
Forks
4
PR merge metrics
No merged PRs in 30d

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from raspberrypi/pico-feedback

All issues in raspberrypi/pico-feedback

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.