Skip to main content

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.

Example image

Build Status PyPi Package Python Versions

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, --pico2 and --pico2w alongside the default --pico
  • Add hstx interface for the RP2350 boards, numbered by bit
  • Add --internal to list the pins wired to onboard hardware
  • Add --testpads to list the underside test pads
  • Draw the wireless module and relocated debug pads on the W boards

1.2.0

  • Add --version
  • Make --find GP25 and --find LED highlight the onboard LED
  • Refactor options parsing into a class
  • Pin a minimum rich version

1.1.0

  • Highlight GPIO label if --find matches 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

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)

Source distribution for picopins 1.3.0
File Size Uploaded
picopins-1.3.0.tar.gz 44.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for picopins 1.3.0
File Interpreter ABI Platform
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 log

Release 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

Release history Release notifications | RSS feed

This release

1.3.0 This release

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page