pinctrl-names使用示例

`pinctrl-names`是一个Linux内核驱动程序中的工具，用于提供一组标准命名，帮助管理和配置GPIO (通用输入输出) 管道。它主要用于规范化GPIO控制器的名字，使得设备树或者其他需要访问GPIO的模块可以更容易地找到对应的控制信息。

一个简单的示例通常包括以下几个步骤：

1. 首先，在设备树（Device Tree，DT）文件中，会声明GPIO控制器节点，并赋予它一个统一的`pinctrl_name`属性，如`gpio-controller0`：

gpio-controller0 {
    compatible = "arm,pinctrl-single";
    reg = <0x400>; /* GPIO控制器地址 */
    pins = <&gpio_pins 0x0 0x1f>;
    pinctrl-names = "default"; /* 标准名称 */
};

2. 当系统启动时，会根据这个名称加载相应的pinctrl驱动，例如`pinctrl-arm`：

static const struct pinctrl_dev_desc pinctrl_desc[] = {
    { .desc = {
        .name       = "gpio-controller0",
        .driver     = "pinctrl-arm",
        ._of_node   = of_find_compatible_node(NULL, NULL, "arm,pinctrl-single"),
        .desc_size  = sizeof(struct pinctrl_desc),
      } },
    ... /* 其他pin controllers */
};

int __init pinctrl_register_all(void)
{
    return pinctrl_register_desc(pinctrl_desc);
}

3. 应用程序可以通过`pinctrl_get_instance()`函数获取并操作特定名字下的GPIO控制器：

struct pinctrl *pc;
pc = pinctrl_get_instance("gpio-controller0");
if (!pc) {
    // 错误处理...
}

/* 使用pinctrl API设置和读取GPIO的状态等 */
pinctrl_apply_state(pc, PINCTRL_STATE_DEFAULT);
/*...*/
pinctrl_free(pc);