如何在设备树中定义一个GPIO引脚？

在设备树（Device Tree）中定义一个GPIO（通用输入输出）引脚通常涉及以下几个步骤：

1. **添加GPIO引脚属性**：首先，在设备树源文件（.dts或.dtsi文件）中，为使用该GPIO的设备节点添加一个属性来指定GPIO引脚。这通常通过`gpio`属性来完成，它包含了该设备所使用的GPIO引脚的编号和参数。

2. **指定GPIO控制器**：接下来，需要定义一个GPIO控制器的节点，并在其内指定`#gpio-cells`属性，该属性用于指示该GPIO控制器下每个GPIO单元需要多少个单元格来描述。

3. **映射GPIO引脚编号**：在GPIO控制器节点下，通常会有一个`gpio-map`或类似的节点，用于将设备的GPIO引脚映射到系统中实际的GPIO引脚编号上。

4. **连接GPIO引脚**：最后，在GPIO控制器节点下通过`gpio-controller`属性将GPIO引脚的定义与控制器节点相连接。

举个简单的例子，在设备树文件中定义一个名为"my_device"的设备使用的GPIO引脚，可能会像这样：

/ {
    ...

    my_device {
        compatible = "vendor,my-device";
        ...
        gpios = <&gpio1 2 GPIO_ACTIVE_HIGH>; /* 假设使用了编号为2的GPIO，且为高电平有效 */
        ...
    };

    gpio1: gpio@address {
        compatible = "vendor,my-gpio-controller";
        #gpio-cells = <2>; /* 两个单元格，一个用于GPIO编号，一个用于标志位（如是否为高电平有效） */
        ...
        my_gpio_map: gpio-map {
            /* 定义映射关系 */
            my_device_pin {
                gpios = <&gpio1 2 GPIO_ACTIVE_HIGH>;
            };
        };
    };
};

在这个示例中，`&gpio1`引用了GPIO控制器节点，`2`是GPIO引脚的编号，`GPIO_ACTIVE_HIGH`指明了高电平有效。`gpio@address`是GPIO控制器的节点，它定义了控制器的地址和兼容性。`my_gpio_map`定义了从"my_device"设备到物理GPIO引脚的映射。