documentation icon indicating copy to clipboard operation
documentation copied to clipboard

PicoW SWD pins swapped

Open ENAC-Robotique opened this issue 1 year ago • 2 comments

Hello, I don't know if this is the right place to report this, but the SWDCLK and SWDIO pins are swapped in the documentation. I had trouble debugging the PicoW(H), and it worked after swapping SWDCLK and SWDIO. I have a "Raspberry Pi Pico WH 2022". https://www.raspberrypi.com/documentation/microcontrollers/pico-series.html#raspberry-pi-pico-w-and-pico-wh

ENAC-Robotique avatar Oct 17 '24 20:10 ENAC-Robotique

Hmmm. I just looked at my Pico 2 and my Pico, and SWCLK is on the left side of the board, looking at the front, just like the documentation says.

Whenever we put a bunch of letters on a silkscreen and make a bunch of docs, it's possible that we mess something up. But I think the diagram on the linked page (and the linked PDF diagram on that page, and the diagrams in Getting Started with Pico and the Pico Datasheet) is correct. Is it possible that your board is just upside-down?

A picture of your setup could be helpful here. Any chance you can include one?

nathan-contino avatar Oct 18 '24 09:10 nathan-contino

And I just checked the Pico W datasheet, and SWCLK appears to be in the correct place, on the left, especially notable because it's square instead of a circle. I don't think there's a hardware difference between the Pico W board and the Pico WH board aside from the soldered-on bits, so I'd like some evidence from your side before I make any changes.

Thanks for bringing this up, though. The documentation doesn't get any better unless we get feedback from people like you.

nathan-contino avatar Oct 18 '24 09:10 nathan-contino

This is working just fine: The yellow wire is SWDCLK and the blue one is SWDIO. So from the left to the right I have SWDIO, GND, SWDCLK. I am absolutely certain of the labels on my debug probe because I used it with other microcontrollers. image image

In the doc, this is the opposite. image

ENAC-Robotique avatar Oct 21 '24 18:10 ENAC-Robotique

@ENAC-Robotique I think you're mixing up Pico W and Pico WH :slightly_smiling_face: The diagram you've posted above is correct for the Pico W, but the Pico WH (and also the Pico H) use the smaller 3-pin debug connector, which is documented in https://datasheets.raspberrypi.com/debug/debug-connector-specification.pdf

@nathan-contino I guess a variation of this NOTE from the Pico / Pico H section probably also needs adding to the Pico W / Pico WH section? Screenshot from 2024-10-22 13-20-27

lurch avatar Oct 22 '24 12:10 lurch

Aha, thank you @lurch . That explains everything. Thanks for the suggestion, @ENAC-Robotique !

nathan-contino avatar Oct 22 '24 13:10 nathan-contino

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

github-actions[bot] avatar Dec 22 '24 02:12 github-actions[bot]