GNU/Linux - U-BOOT的GPIO command

在嵌入式Linux开发中，先运行的是u-boot，然后再加载Linux内核。

启动时如果设置了u-boot等待时间，在等待时间内，按任意键就会进入u-boot命令行环境。

在u-boot命令行环境下，可以使用gpio命令来操作GPIO。

Synopsis

gpio <input|set|clear|toggle> <pin>

gpio read <name> <pin>

gpio status [-a] [<bank>|<pin>]

gpio 命令用于访问通用输入/输出。

The gpio command is used to access General Purpose Inputs/Outputs.

gpio input

将 GPIO 引脚切换为输入模式。

Switch the GPIO pin to input mode.

gpio set

将 GPIO 引脚切换至输出模式，并将信号设置为 1。

Switch the GPIO pin to output mode and set the signal to 1.

gpio clear

将 GPIO 引脚切换至输出模式，并将信号设置为 0。

Switch the GPIO pin to output mode and set the signal to 0.

gpio toggle

将 GPIO 引脚切换至输出模式，并反转信号状态。

Switch the GPIO pin to output mode and reverse the signal state.

gpio read

读取 GPIO 引脚的信号状态，并将其保存在环境变量名称中。

Read the signal state of the GPIO pin and save it in environment variable name.

gpio status

显示一个或多个 GPIO 的状态。默认情况下，只显示声称的 GPIO。 gpio status 命令的输出字段有：

Display the status of one or multiple GPIOs. By default only claimed GPIOs are displayed. gpio status command output fields are:

<name>: <function>: <value> [x] <label>

函数可以取以下值:

function can take the following values:

• output

pin configured in gpio output, value indicates the pin’s level

• input

pin configured in gpio input, value indicates the pin’s level

• func

pin configured in alternate function, followed by label which shows pinmuxing label.

• unused

pin not configured

[x] or [ ] indicate respectively if the gpio is used or not.

label shows the gpio label.

Parameters

• -a

Display GPIOs irrespective of being claimed. 显示 GPIO，无论其是否被申领。

• bank

Name of a bank of GPIOs to be displayed. 显示 GPIO 组的名称。

• pin

Name of a single GPIO to be displayed or manipulated.要显示或操作的单个 GPIO 的名称。

Examples

Switch the status of a GPIO:

=> gpio set a5

gpio: pin a5 (gpio 133) value is 1

=> gpio clear a5

gpio: pin a5 (gpio 133) value is 0

=> gpio toggle a5

gpio: pin a5 (gpio 133) value is 1

=> gpio read myvar a5

gpio: pin a5 (gpio 133) value is 1

=> echo $myvar

1

=> gpio toggle a5

gpio: pin a5 (gpio 133) value is 0

=> gpio read myvar a5

gpio: pin a5 (gpio 133) value is 0

=> echo $myvar

0

Show the GPIO status:

=> gpio status

Bank GPIOA:

GPIOA1: func rgmii-0

GPIOA2: func rgmii-0

GPIOA7: func rgmii-0

GPIOA10: output: 0 [x] hdmi-transmitter@39.reset-gpios

GPIOA13: output: 1 [x] red.gpios

Bank GPIOB:

GPIOB0: func rgmii-0

GPIOB1: func rgmii-0

GPIOB2: func uart4-0

GPIOB7: input: 0 [x] mmc@58005000.cd-gpios

GPIOB11: func rgmii-0

Configuration

gpio 命令只有在 CONFIG_CMD_GPIO=y 时可用。gpio 读取命令只有在 CONFIG_CMD_GPIO_READ=y 时可用。

The gpio command is only available if CONFIG_CMD_GPIO=y. The gpio read command is only available if CONFIG_CMD_GPIO_READ=y.

Return value

如果命令成功执行，返回值 $? 设置为 0；如果命令出错，返回值 $? 设置为 1。

If the command succeds the return value $? is set to 0. If an error occurs, the return value $? is set to 1.

---

我的u-boot版本和构建信息：

u-boot=> help

...

version   - print monitor, compiler and linker version

...

u-boot=> version

U-Boot 2023.04-lf_v2023.04+g49b102d988 (Nov 21 2023 - 07:28:53 +0000)

aarch64-poky-linux-gcc (GCC) 12.3.0

GNU ld (GNU Binutils) 2.40.0.20230703

u-boot=> gpio status -a

Bank GPIO2_:

GPIO2_0: input: 1 [ ]

GPIO2_1: output: 0 [ ]

GPIO2_2: input: 0 [ ]

GPIO2_3: input: 0 [ ]

GPIO2_4: input: 0 [ ]

GPIO2_5: input: 0 [ ]

GPIO2_6: input: 0 [ ]

GPIO2_7: input: 0 [ ]

GPIO2_8: input: 0 [ ]

GPIO2_9: input: 0 [ ]

GPIO2_10: input: 0 [ ]

GPIO2_11: output: 0 [ ]

GPIO2_12: input: 0 [ ]

GPIO2_13: input: 1 [ ]

GPIO2_14: input: 0 [ ]

GPIO2_15: input: 0 [ ]

GPIO2_16: input: 0 [ ]

GPIO2_17: input: 0 [ ]

GPIO2_18: input: 0 [ ]

GPIO2_19: input: 0 [ ]

GPIO2_20: input: 0 [ ]

GPIO2_21: input: 0 [ ]

GPIO2_22: input: 1 [ ]

GPIO2_23: input: 0 [ ]

GPIO2_24: input: 0 [ ]

GPIO2_25: input: 0 [ ]

GPIO2_26: input: 0 [ ]

GPIO2_27: input: 0 [ ]

GPIO2_28: input: 1 [ ]

GPIO2_29: input: 0 [ ]

GPIO2_30: input: 0 [ ]

GPIO2_31: input: 0 [ ]

Bank GPIO3_:

GPIO3_0: input: 1 [x] mmc@42860000.cd-gpios

GPIO3_1: input: 0 [ ]

GPIO3_2: input: 0 [ ]

GPIO3_3: input: 0 [ ]

GPIO3_4: input: 0 [ ]

GPIO3_5: input: 0 [ ]

GPIO3_6: input: 0 [ ]

GPIO3_7: input: 0 [ ]

GPIO3_8: input: 0 [ ]

GPIO3_9: input: 0 [ ]

GPIO3_10: input: 0 [ ]

GPIO3_11: input: 0 [ ]

GPIO3_12: input: 0 [ ]

GPIO3_13: input: 0 [ ]

GPIO3_14: input: 0 [ ]

GPIO3_15: input: 0 [ ]

GPIO3_16: input: 0 [ ]

GPIO3_17: input: 0 [ ]

GPIO3_18: input: 0 [ ]

GPIO3_19: input: 0 [ ]

GPIO3_20: input: 0 [ ]

GPIO3_21: input: 0 [ ]

GPIO3_22: input: 0 [ ]

GPIO3_23: input: 0 [ ]

GPIO3_24: input: 0 [ ]

GPIO3_25: input: 0 [ ]

GPIO3_26: input: 0 [ ]

GPIO3_27: input: 0 [ ]

GPIO3_28: input: 0 [ ]

GPIO3_29: input: 0 [ ]

GPIO3_30: input: 0 [ ]

GPIO3_31: input: 0 [ ]

Bank GPIO4_:

GPIO4_0: input: 0 [ ]

GPIO4_1: input: 0 [ ]

GPIO4_2: input: 0 [ ]

GPIO4_3: input: 0 [ ]

GPIO4_4: input: 0 [ ]

GPIO4_5: input: 0 [ ]

GPIO4_6: input: 0 [ ]

GPIO4_7: input: 0 [ ]

GPIO4_8: input: 0 [ ]

GPIO4_9: input: 0 [ ]

GPIO4_10: input: 0 [ ]

GPIO4_11: input: 0 [ ]

GPIO4_12: input: 0 [ ]

GPIO4_13: input: 0 [ ]

GPIO4_14: input: 0 [ ]

GPIO4_15: input: 0 [ ]

GPIO4_16: input: 0 [ ]

GPIO4_17: input: 1 [ ]

GPIO4_18: input: 0 [ ]

GPIO4_19: input: 0 [ ]

GPIO4_20: input: 0 [ ]

GPIO4_21: input: 0 [ ]

GPIO4_22: input: 0 [ ]

GPIO4_23: input: 0 [ ]

GPIO4_24: input: 1 [ ]

GPIO4_25: input: 0 [ ]

GPIO4_26: input: 0 [ ]

GPIO4_27: input: 0 [ ]

GPIO4_28: input: 0 [ ]

GPIO4_29: input: 0 [ ]

GPIO4_30: input: 0 [ ]

GPIO4_31: input: 0 [ ]

Bank GPIO1_:

GPIO1_0: input: 1 [ ]

GPIO1_1: input: 1 [ ]

GPIO1_2: input: 0 [ ]

GPIO1_3: input: 0 [ ]

GPIO1_4: input: 0 [ ]

GPIO1_5: input: 0 [ ]

GPIO1_6: input: 0 [ ]

GPIO1_7: input: 1 [ ]

GPIO1_8: input: 0 [ ]

GPIO1_9: input: 0 [ ]

GPIO1_10: input: 0 [ ]

GPIO1_11: input: 0 [ ]

GPIO1_12: input: 0 [ ]

GPIO1_13: input: 0 [ ]

GPIO1_14: input: 0 [ ]

GPIO1_15: input: 0 [ ]

GPIO1_16: input: 0 [ ]

GPIO1_17: input: 0 [ ]

GPIO1_18: input: 0 [ ]

GPIO1_19: input: 0 [ ]

GPIO1_20: input: 0 [ ]

GPIO1_21: input: 0 [ ]

GPIO1_22: input: 0 [ ]

GPIO1_23: input: 0 [ ]

GPIO1_24: input: 0 [ ]

GPIO1_25: input: 0 [ ]

GPIO1_26: input: 0 [ ]

GPIO1_27: input: 0 [ ]

GPIO1_28: input: 0 [ ]

GPIO1_29: input: 0 [ ]

GPIO1_30: input: 0 [ ]

GPIO1_31: input: 0 [ ]

GPIO bank和pin name可以参照status的结果，然后运行gpio命令：

u-boot=> gpio status GPIO3_

Bank GPIO3_:

GPIO3_0: input: 1 [x] mmc@42860000.cd-gpios

u-boot=> gpio status GPIO3_0

Bank GPIO3_:

GPIO3_0: input: 1 [x] mmc@42860000.cd-gpios

u-boot=> gpio status GPIO3_1

Bank GPIO3_:

GPIO3_1: input: 0 [ ]

u-boot=> gpio set GPIO2_11

gpio: pin GPIO2_11 (gpio 11) value is 1

u-boot=> gpio clear GPIO2_11

gpio: pin GPIO2_11 (gpio 11) value is 0

参考：

gpio command — Das U-Boot unknown version documentation