NAME

       pinout - GPIO Zero pinout tool

       A utility for querying GPIO pin-out information.

SYNOPSIS

          pinout [-h] [-r REVISION] [-c] [-m] [-x]

DESCRIPTION

       A  utility  for  querying  Raspberry Pi GPIO pin-out information. Running pinout on its own will output a
       board diagram, and GPIO header diagram for the current Raspberry Pi. It  is  also  possible  to  manually
       specify a revision of Pi, or (by Configuring Remote GPIO) to output information about a remote Pi.

OPTIONS

       -h, --help
              Show a help message and exit

       -r REVISION, --revision REVISION
              Specifies  a particular Raspberry Pi board revision code. The default is to autodetect revision of
              current device by reading /proc/cpuinfo

       -c, --color
              Force colored output (by  default,  the  output  will  include  ANSI  color  codes  if  run  in  a
              color-capable terminal). See also pinout --monochrome

       -m, --monochrome
              Force monochrome output. See also pinout --color

       -x, --xyz
              Open pinout.xyz <https://pinout.xyz/> in the default web browser

EXAMPLES

       To output information about the current Raspberry Pi:

          $ pinout

       For a Raspberry Pi model 3B, this will output something like the following:

          Description        : Raspberry Pi 3B rev 1.2
          Revision           : a02082
          SoC                : BCM2837
          RAM                : 1GB
          Storage            : MicroSD
          USB ports          : 4 (of which 0 USB3)
          Ethernet ports     : 1 (100Mbps max. speed)
          Wi-fi              : True
          Bluetooth          : True
          Camera ports (CSI) : 1
          Display ports (DSI): 1

          ,--------------------------------.
          | oooooooooooooooooooo J8     +====
          | 1ooooooooooooooooooo        | USB
          |                             +====
          |      Pi Model 3B  V1.2         |
          | |D      +---+               +====
          | |S      |SoC|               | USB
          | |I      +---+               +====
          | |0               C|            |
          |                  S|       +======
          |                  I| |A|   |   Net
          | pwr      |HDMI|  0| |u|   +======
          `-| |------|    |-----|x|--------'

          J8:
             3V3  (1) (2)  5V
           GPIO2  (3) (4)  5V
           GPIO3  (5) (6)  GND
           GPIO4  (7) (8)  GPIO14
             GND  (9) (10) GPIO15
          GPIO17 (11) (12) GPIO18
          GPIO27 (13) (14) GND
          GPIO22 (15) (16) GPIO23
             3V3 (17) (18) GPIO24
          GPIO10 (19) (20) GND
           GPIO9 (21) (22) GPIO25
          GPIO11 (23) (24) GPIO8
             GND (25) (26) GPIO7
           GPIO0 (27) (28) GPIO1
           GPIO5 (29) (30) GND
           GPIO6 (31) (32) GPIO12
          GPIO13 (33) (34) GND
          GPIO19 (35) (36) GPIO16
          GPIO26 (37) (38) GPIO20
             GND (39) (40) GPIO21

          For further information, please refer to https://pinout.xyz/

       By  default, if stdout is a console that supports color, ANSI codes will be used to produce color output.
       Output can be forced to be --monochrome:

          $ pinout --monochrome

       Or forced to be --color, in case you are redirecting to something capable of supporting ANSI codes:

          $ pinout --color | less -SR

       To manually specify the revision of Pi you want to query,  use  --revision.  The  tool  understands  both
       old-style       revision       codes      <https://www.raspberrypi.com/documentation/computers/raspberry-
       pi.html#raspberry-pi-revision-codes> (such as for the model B):

          $ pinout -r 000d

       Or    new-style    revision     codes     <https://www.raspberrypi.com/documentation/computers/raspberry-
       pi.html#raspberry-pi-revision-codes> (such as for the Pi Zero W):

          $ pinout -r 9000c1
       [image]

       You can also use the tool with Configuring Remote GPIO to query remote Raspberry Pi's:

          $ GPIOZERO_PIN_FACTORY=pigpio PIGPIO_ADDR=other_pi pinout

       Or  run  the tool directly on a PC using the mock pin implementation (although in this case you'll almost
       certainly want to specify the Pi revision manually):

          $ GPIOZERO_PIN_FACTORY=mock pinout -r a22042

SEE ALSO

       pintest(1), remote-gpio(7), gpiozero-env(7)

AUTHOR

       Ben Nuttall

COPYRIGHT

       2015-2024 Ben Nuttall

2.0.1                                             Feb 15, 2024                                         PINOUT(1)