pintest - GPIO Zero pintest tool
Contents
Copyright
2015-2024 Ben Nuttall
2.0.1 Feb 15, 2024 PINTEST(1)
Description
A utility for testing the function of GPIOs on a Raspberry Pi. It is possible to damage the GPIOs on a Pi
by passing too much current (or voltage in the case of inputs) through them. The pintest utility can be
used to determine if any of the GPIOs on a Pi are broken.
The utility will test all physically exposed GPIOs (those on the main GPIO header) by default, but you
may wish to only test a subset, or to exclude certain GPIOs which can be accomplished with the pintest--pins or pintest--skip options.
NOTE:
You must ensure that nothing is connected to the GPIOs that you intend to test. By default, the
utility will prompt you before proceeding, repeating this warning.
In the event that any GPIO is found to be faulty, it will be reported in the output and the utility will
exit with a return code of 1. If all specified GPIOs test fine, the return code is zero.
Examples
Test all physically exposed GPIOs on the board:
$ pintest
Test just the I2C GPIOs without prompting:
$ pintest --pins 2,3 --yes
Exclude the SPI GPIOs from testing:
$ pintest --exclude GPIO7,GPIO8,GPIO9,GPIO10,GPIO11
Note that pin numbers can be given in any form accepted by GPIO Zero, e.g. 14, GPIO14, or BOARD8.
Name
pintest - GPIO Zero pintest tool
A utility for testing the GPIO pins on a Raspberry Pi, inspired by pigpio's gpiotest example script, and
wiringPi's pintest utility.
Options
-h,--help
show this help message and exit
--version
Show the program's version number and exit
-pPINS,--pinsPINS
The pin(s) to test. Can be specified as a comma-separated list of pins. Pin numbers can be given
in any form accepted by gpiozero, e.g. 14, GPIO14, BOARD8. The default is to test all pins
-sSKIP,--skipSKIP
The pin(s) to skip testing. Can be specified as comma-separated list of pins. Pin numbers can be
given in any form accepted by gpiozero, e.g. 14, GPIO14, BOARD8. The default is to skip no pins
-y,--yes
Proceed without prompting
-rREVISION,--revisionREVISION
Force board revision. Default is to autodetect revision of current device. You should avoid this
option unless you are very sure the detection is incorrect
See Also
pinout(1), gpiozero-env(7)
Synopsis
pintest [-h] [--version] [-p PINS] [-s SKIP] [-y] [-r REVISION]
