列出、读取、写入和配置 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>
是使用的中断模式。接受的值包括 default
、edge-high
、edge-low
、edge-both
、level-low
或 level-high
。
别名:q
函数
gpioutil function <name> <value>
为引脚设置函数。
<name>
应为 list
返回的值之一。
<value>
是特定于所用 GPIO 控制器的函数编号。
别名:f
拉取
gpioutil pull <name> <value>
为引脚配置上拉或下拉电阻。
<name>
应为 list
返回的值之一。
<value>
是电阻拉动。接受的值包括 down
、up
或 none
。
别名: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。
这是设备端命令,而非 fx
或 ffx
等主机端命令。换句话说,在调用此命令之前,您必须先访问 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/