pinout(1)
Display GPIO pinout information for Raspberry Pi and other single-board computers.
Synopsis
pinout [OPTION]... [BOARD]Description
pinout is a command-line utility that displays the GPIO (General Purpose Input/Output) pinout diagrams and reference information for Raspberry Pi boards and compatible single-board computers. It provides visual ASCII representations of pin layouts with their functions, voltage levels, and standard designations.
The tool helps developers and hobbyists quickly reference which pins are available, their purposes (power, ground, SPI, I2C, etc.), and any special functions. Output can be customized to show specific boards or provide detailed information about individual pins.
Common options
| Flag | What it does |
|---|---|
-h, --help | Show help message and exit |
-v, --version | Show program version and exit |
-b, --board BOARD | Specify the board type (e.g., 'pi', 'zero', 'pi4'); defaults to detected board |
-r, --raw | Output raw machine-readable format instead of ASCII diagram |
-j, --json | Output pinout information in JSON format |
-p, --pin PIN | Show detailed information about a specific pin number or name |
--bcm | Use Broadcom (BCM) pin numbering scheme |
--board-info | Display board information and specifications |
Examples
Display the GPIO pinout diagram for the detected Raspberry Pi board
pinoutShow the pinout diagram specifically for a Raspberry Pi 4
pinout -b pi4Display detailed information about GPIO pin 17 (also known as BCM 17)
pinout -p GPIO17Output pinout data as JSON and parse it with jq for further processing
pinout -j | jqShow board specifications including CPU, RAM, and revision information
pinout --board-infoDisplay the pinout for a Raspberry Pi Zero board
pinout -b zero