gpioutil

列出、读取、写入和配置 GPIO。

用法

gpioutil <command> [<name>] [<value>]

命令

list

gpioutil list

列出已知的 GPIO。

list 会返回如下值:

[gpio-0] GPIO_HW_ID_3

括号内的值 (gpio-0) 是对引脚编号的引用。括号 (GPIO_HW_ID_3) 后的值是提供给其他 gpioutil 命令的 <name> 值。如需了解详情,请参阅 GPIO 名称

别名:l

阅读

gpioutil read <name>

读取配置为 OUT 的 GPIO 的当前值。

<name> 应为 list 返回的值之一。

可能的返回值为 0(低)或 1(高)。

别名:r

in

gpioutil in <name>

将 GPIO 配置为 IN。

<name> 应为 list 返回的值之一。

此命令不会返回值。

别名:i

gpioutil out <name> <value>

将 GPIO 配置为 OUT。

<name> 应为 list 返回的值之一。

<value> 是初始 OUT 值。接受的值为 0(低)或 1(高)。

此命令不会返回值。

别名:o

开车

gpioutil drive <name> [<value>]

以微安为单位获取或设置 GPIO 的驱动强度。

<name> 应为 list 返回的值之一。

省略 <value> 后,drive 会返回 GPIO 的当前驱动强度(以微安为单位)。

提供 <value> 时,drive 会更新 GPIO 的驱动强度。<value> 应以微安表示。

别名:d

中断

gpioutil interrupt <name> <value>

获取 GPIO 中断并等待其触发一次。

<name> 应为 list 返回的值之一。

<value> 是使用的中断模式。接受的值包括 defaultedge-highedge-lowedge-bothlevel-lowlevel-high

别名:q

函数

gpioutil function <name> <value>

为引脚设置函数。

<name> 应为 list 返回的值之一。

<value> 是特定于所用 GPIO 控制器的函数编号。

别名:f

拉取

gpioutil pull <name> <value>

为引脚配置上拉或下拉电阻。

<name> 应为 list 返回的值之一。

<value> 是电阻拉动。接受的值包括 downupnone

别名:p

帮助

gpioutil help

输出帮助文本。

别名:h

示例

列出所有已知 GPIO

$ gpioutil list
[gpio-0] GPIO_HW_ID_3
[gpio-1] GPIO_SOC_TH_BOOT_MODE_L
...

读取 GPIO 的当前值

$ gpioutil read GPIO_HW_ID_3
GPIO Value: 1

向 GPIO 写入 LOW 值

$ gpioutil write GPIO_HW_ID_3 0

使用下拉电阻将 GPIO 配置为 IN

$ gpioutil in GPIO_HW_ID_3 down

将 GPIO 配置为 OUT,初始值为 HIGH

$ gpioutil out GPIO_HW_ID_3 1

获取 GPIO 的当前驱动强度(以微安为单位)

$ gpioutil drive GPIO_HW_ID_3
Drive Strength: 500 ua

将 GPIO 的驱动强度设置为 500 微安

$ gpioutil drive GPIO_HW_ID_3 500
Set drive strength to 500

等待 GPIO 上的下降沿

$ gpioutil interrupt GPIO_HW_ID_3 edge-low
Received interrupt at time 12345

将引脚设置为函数 6

$ gpioutil function GPIO_HW_ID_3 6

备注

访问此命令

此命令仅适用于某些诊断和测试 Fuchsia build。

这是设备端命令,而非 fxffx 等主机端命令。换句话说,在调用此命令之前,您必须先访问 Fuchsia 设备的 shell。

如需交互式访问 Fuchsia 设备的 shell,请执行以下操作:

ffx component explore <component>

<component> 替换为有权访问本页中记录的命令的组件的名称。

如需调用单个命令并将输出返回给主机,请执行以下操作:

ffx component explore <component> -c "<command>"

<command> 替换为本页面上记录的某个命令。

GPIO 名称

GPIO 名称在驱动程序源代码中定义,通常与数据表中 GPIO 的名称一致。如需查看示例,请参阅 vim3-gpio.cc 中的 DECL_GPIO_PIN 语句。

源代码

gpioutil 的源代码://src/devices/gpio/bin/gpioutil/