search

raspberrypi / documentation

The official documentation for Raspberry Pi computers and microcontrollers
https://raspberrypi.com/documentation
Creative Commons Attribution Share Alike 4.0 International
5.26k stars 2.01k forks source link

PicoW SWD pins swapped #3888

Open ENAC-Robotique opened 1 month ago

ENAC-Robotique commented 1 month ago

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

nathan-contino commented 1 month ago

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 commented 1 month ago

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.

ENAC-Robotique commented 1 month ago

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

lurch commented 1 month ago

@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

nathan-contino commented 1 month ago

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