pinout 用于查询 GPIO 引脚输出信息的实用程序。

pinout

用于查询 GPIO 引脚输出信息的实用程序。

在终端窗口中，顶部显示的是电路板的描述，其次是电路板的彩色 ASCII 图，最后是 GPIO 针座上的针脚颜色匹配列表。

简介

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

 

说明

用于查询 Raspberry Pi GPIO 引脚输出信息的实用程序。单独运行 pinout 会输出当前 Raspberry Pi 的电路板图和 GPIO 接头图。还可以手动指定 Pi 的版本，或（通过 配置远程GPIO）输出远程 Pi 的信息。

选项

• -h，--help

  显示帮助信息并退出

• -r REVISION, --revision REVISION

  指定特定的 Raspberry Pi 板修订代码。默认情况下，通过读取 /proc/cpuinfo 自动检测当前设备的修订版本。

• -c, --color

  强制彩色输出（默认情况下，如果在支持彩色的终端运行，输出将包括 ANSI 颜色代码）。另请参阅 pinout --monochrome

• -m, --monochrome 强制单色输出。另请参阅 pinout --color

• -x，--xyz

  在默认网页浏览器中打开 pinout.xyz

示例

输出当前 Raspberry Pi 的信息：

pinout

 

对于型号为 3B 的 Raspberry Pi，输出结果如下：

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/

 

默认情况下，如果 stdout 是支持彩色的控制台，将使用 ANSI 编码来生成彩色输出。可以强制输出为 --monochrome：

pinout --monochrome

 

或者强制输出为 --color，以防重定向到能够支持 ANSI 编码的地方：

pinout --color | less -SR

 

要手动指定要查询的 Pi 版本，请使用 --revision]。该工具可理解旧式 修订代码（如 B 型）：

pinout -r 000d

 

或 新式修订代码（如 Pi Zero W）：

pinout -r 9000c1

 

你也可以使用 配置远程GPIO 的工具来查询远程 Raspberry Pi：

GPIOZERO_PIN_FACTORY=pigpio PIGPIO_ADDR=other_pi pinout

 

或者使用模拟引脚实现直接在 PC 上运行该工具（不过在这种情况下，您几乎肯定需要手动指定 Pi 的版本）：

GPIOZERO_PIN_FACTORY=mock pinout -r a22042

 

pintest

受 pigpio 的 gpiotest 示例脚本和 wiringPi 的 pintest 工具启发，用于测试 Raspberry Pi 上的 GPIO 引脚。

在 2.0 版中添加： pintest 实用程序。

简介

pintest [-h] [--version] [-p PINS] [-s SKIP] [-y] [-r REVISION]

 

说明

用于测试 Raspberry Pi 上 GPIO 功能的实用程序。通过 Pi 上 GPIO 的电流（或输入端的电压）过大，可能会损坏 GPIO。pintest 实用程序可用于确定 Pi 上的任何 GPIO 是否损坏。

该实用程序默认将测试所有物理暴露的 GPIO（主 GPIO 头上的那些），但您可能希望只测试一个子集，或排除某些 GPIO，这可以通过 pintest --pins 或 pintest --skip 选项来实现。

注意

必须确保打算测试的 GPIO 未连接任何设备。默认情况下，实用程序会在继续测试前提示您，并重复此警告。

如果发现任何 GPIO 有问题，将在输出中报告，实用程序将以返回代码 1 退出。

选项

• -h，--help

  显示帮助信息并退出

• --version 显示程序的版本号并退出

• -p PINS, --pins PINS

  要测试的引脚。可指定为以逗号分隔的引脚列表。引脚编号可以是 gpiozero 接受的任何形式，例如 14、GPIO14、BOARD8。默认情况下测试所有引脚

• -s SKIP, --skip SKIP

  要跳过测试的引脚。可指定为以逗号分隔的引脚列表。引脚编号可以是 gpiozero 接受的任何形式，例如 14、GPIO14、BOARD8。默认情况下不跳过任何引脚

• -y, --yes

  无提示继续

• -r REVISION, --revision REVISION

  强制指定电路板修订代码。默认为自动检测当前设备的版本。除非您非常确定检测结果不正确，否则应避免使用此选项。

示例

测试电路板上所有物理暴露的 GPIO：

pintest

 

仅测试 I2C GPIO，不提示：

pintest --pins 2,3 --yes

 

不测试 SPI GPIO：

pintest --exclude GPIO7,GPIO8,GPIO9,GPIO10,GPIO11

 

请注意，引脚编号可以 GPIO Zero 接受的任何形式给出，例如 14、GPIO14 或 BOARD8。

环境变量

GPIO Zero 提供的所有实用程序都接受以下环境变量：

• GPIOZERO_PIN_FACTORY

  与 GPIO 引脚通信时使用的库。默认先尝试加载 lgpio，然后是 RPi.GPIO，最后是 pigpio，最后使用本地 Python 实现。有效值包括 lgpio、rpigpio、pigpio、native 和 mock。后者在非 Pi 平台上最有用，因为它模拟的是 Raspberry Pi 型号 3B（默认情况下）。

• PIGPIO_ADDR

  pigpio 库应尝试连接的 Raspberry Pi 的主机名（如果使用的是 pigpio 引脚工厂）。默认为 localhost。

• PIGPIO_PORT

  pigpio 库应尝试连接的端口号（如果使用了 pigpio 引脚工厂）。默认为 8888。