Raspberry Pi Pico GPIO Pinout
A beautiful GPIO pinout and pin function guide for the Raspberry Pi Pico, Pico W, Pico 2 and Pico 2 W.
Usage
usage: picopins [--...] [--all] or {spi,i2c,uart,pwm,hstx} [--find <text>]
--pico - Pico, the default. Or --picow, --pico2, --pico2w
--pins - show physical pin numbers
--all or {spi,i2c,uart,pwm,hstx} - pick list of interfaces to show
hstx is Pico 2 and Pico 2 W only
--hide-gpio - hide GPIO pins
--internal - list the pins wired to onboard hardware
--testpads - list the underside test pads
--light - melt your eyeballs
--find "<text>" - highlight pins matching <text>
supports regex if you're feeling sassy!
eg: picopins i2c - show GPIO and I2C labels
picopins - basic GPIO pinout
picopins --pico2w --all - everything, for a Pico 2 W
picopins --picow --internal - what the Pico W wires up itself
picopins --all --find "PWM3 A" - highlight any "PWM3 A" labels
picopins --all --find "PWM.* A" - highlight any PWM A channels
The 40-pin header is identical across all four boards, apart from HSTX on
GP12-GP19 of the RP2350 boards. What differs is the hardware wired up behind
the scenes - --internal and --testpads show it.
Installing
- Just run
python3 -m pip install picopins
Acknowledgements
This project was inspired by GPIO Zero's command-line pinout - https://github.com/gpiozero/gpiozero
It somehow wasn't inspired by Raspberry Pi Spy's "picopins" which came first and solves this same problem in bash - https://www.raspberrypi-spy.co.uk/2022/12/pi-pico-pinout-display-on-the-command-line/
Like RPi Spy's picopins it started as a GitHub gist, you can find the history here - https://gist.github.com/Gadgetoid/192af85a3eb05d4a6ac1db076c4ef118/revisions
Changelog
1.3.0
- Add
--picow,--pico2and--pico2walongside the default--pico - Add
hstxinterface for the RP2350 boards, numbered by bit - Add
--internalto list the pins wired to onboard hardware - Add
--testpadsto list the underside test pads - Draw the wireless module and relocated debug pads on the W boards
1.2.0
- Add
--version - Make
--find GP25and--find LEDhighlight the onboard LED - Refactor options parsing into a class
- Pin a minimum
richversion
1.1.0
- Highlight GPIO label if
--findmatches a hidden label - Add regex support to
--find - Rewrite render flow to make it less hacky
- Light mode is back!
--light - Move error text above usage message
1.0.1
- Tidy up readme
1.0.0
- Initial Release
- Ported from https://gist.github.com/Gadgetoid/192af85a3eb05d4a6ac1db076c4ef118
Release files for picopins 1.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| picopins-1.3.0.tar.gz | 44.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| picopins-1.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 57.3 kB
Release files / picopins-1.3.0.tar.gz
| Download URL | picopins-1.3.0.tar.gz |
|---|---|
| Size | 44.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
39ea98ce9d7266ac055ed47772ce25ee739ea42ea82dd914348ceea8f8c8fcd1
|
|
BLAKE2b-256 checksum How to use checksums |
afccb98b5cadbf449e1d7f68d4f94baaef38390dd85d81c7ec5ff530b3ee97b1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 28, 2026.
Transparency logRelease files / picopins-1.3.0-py3-none-any.whl
| Download URL | picopins-1.3.0-py3-none-any.whl |
|---|---|
| Size | 12.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6c2a6a28a071fe21b46bde449f4f76eb3859e7075bc692bd6238c9567854eb0b
|
|
BLAKE2b-256 checksum How to use checksums |
f6ed1024def7d1ec119c11b28ebf6a1daf9c9ee4ae3d97ecefb007a7880e9151
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 28, 2026.
Transparency log