pinctrl 子系统和 gpio 子系统虽然难度不大，但在内核里的使用率非常高，本文争取一次性把相关内容介绍一遍。

　　pinctrl

　　数据结构

　　使用 struct pinctrl_desc 抽象一个 pin controller，该结构的定义如下:

　　pins

　　变量 pins 和 npins 把系统中所有的 pin 描述出来，并建立索引。驱动为了和具体的 pin 对应上，再将这些描述的这些 pin 组织成一个 struct pinctrl_pin_desc 类型的数组，该类型的定义为：

　　SoC中，有时需要将很多 pin 组合在一起，以实现特定的功能，例如 uart 接口、i2c 接口等。因此 pin controller 需要以 group 为单位，访问、控制多个 pin，这就是 pin groups。

　　pinctrl core在struct pinctrl_ops中抽象出三个回调函数，用来获取pin groups相关信息，如下：

　　group 的组织方式是由驱动决定的。

　　pin configuration

　　除了上面的 pin 和 pin group，有些管脚可以配置，比如上拉，下拉，高阻等。pin configuration 来封装这些功能，具体体现在 struct pinconf_ops 数据结构中，如下：

　　pin mux

　　为了兼容不同的应用场景，有很多管脚可以配置为不同的功能，例如A和B两个管脚，既可以当作普通的GPIO使用，又可以配置为I2C的的SCL和SDA，也可以配置为UART的TX和RX，这称作管脚的复用（简称 pin mux）。使用 struct pinmux_ops 来抽象 pin mux 有关的操作，如下：

　　pin state

　　根据前面的描述，pinctrl driver 抽象出来了一些离散的对象：pin（pin group）、function、configuration，并实现了这些对象的控制和配置方式。然后我们回到某一个具体的 device 上（如 lpuart，usdhc）。一个设备在某一状态下（如工作状态、休眠状态、等等），所使用的pin（pin group）、pin（pin group）的 function 和 configuration，是唯一确定的。所以固定的组合可以确定固定的状态，在设备树里用 pinctrl-names 指明状态名字，pinctrl-x 指明状态引脚。

　　pin map

　　pin state 有关的信息是通过 pin map 收集，相关的数据结构如下：

　　pinctrl driver 确定了 pin map 各个字段的格式之后，就可以在 dts 文件中维护 pin state 以及相应的 mapping table。pinctrl core 在初始化的时候，会读取并解析 dts，并生成 pin map。

　　而各个 consumer，可以在自己的 dts node 中，直接引用 pinctrl driver 定义的 pin state，并在设备驱动的相应的位置，调用 pinctrl subsystem 提供的 API（pinctrl_lookup_state，pinctrl_select_state），active 或者 deactive 这些 state。

　　pin controller 驱动初始化

　　pin 控制器描述符中包括了三类操作函数：pctlops 是一些全局的控制函数；pmxops 是复用引脚相关的操作函数；confops操作函数是用来配置引脚的特性。pin 控制器驱动的初始化主要是注册这三类函数的回调。

　　struct pinctrl_ops *pctlops

　　c

　　pinctrl subsystem 的整体流程

　　pinctrl driver 根据 pin controller 的实际情况，定义 struct pinctrl_desc（包括pin/pin group 的抽象，function 的抽象，pinconf、pinmux 的 operation API 实现，dt_node_to_map 的实现，等等），并注册到 kernel 中。

　　pinctrl driver 在 pin controller的 dts node 中，根据自己定义的格式，描述每个 device 的所有 pin state。如下所示：

　　相应的 consumer driver 可以在自己的 dts node 中，引用 pinctrl driver 所定义的 pin state，如下所示：

　　consumer driver 在需要的时候，可以调用 pinctrl_get/devm_pinctrl_get 接口，获得一个 pinctrl handle（struct pinctrl类型的指针）。在 pinctrl get 的过程中，解析 consumer device 的 dts node，找到相应的 pin state，进行调用 pinctrl driver 提供的 dt_node_to_map 接口，解析 pin state 并转换为 pin map。

　　例子

　　上图中，左边是 pin controller 节点，右边是 client device 节点 。

　　pin state

　　对于一个“client device”来说，比如对于一个 UART 设备，它有多个“状态”：default、sleep 等，那对应的引脚也有这些状态。比如当这个设备处于 default 状态时，pinctrl 子系统会自动根据上述信息把所用引脚复用为 uart0 功能。当这这个设备处于 sleep 状态时，pinctrl 子系统会自动根据上述信息把所用引脚配置为高电平。

　　groups 和 function

　　一个设备会用到一个或多个引脚，这些引脚就可以归为一组 group。这些引脚可以复用为某个功能 function。当然，一个设备可以用到多组多功能引脚，比如A1、A2两组引脚，A1组复用为F1功能，A2组复用为F2功能。

　　sysfs 访问方法

　　gpio

　　数据结构

　　每个 GPIO 控制器用一个 gpio_device 来表示:

　　用 gpio_chip 来定义控制引脚和中断相关的函数：

　　设备树

　　GPIO一般都分为几组，每组中有若干个引脚。所以在使用GPIO子系统之前，就要先确定它所在的组以及在组中的哪一个。在设备树中，“GPIO组” 就是一个 GPIO Controller，这通常都由芯片厂家设置好。我们要做的是找到它的名字，比如“gpio1”，然后指定要用它里面的哪个引脚，比如 <&gpio1 0>。

　　“gpio-controller”表示这个节点是一个GPIO Controller，它下面有很多引脚。

　　“#gpio-cells = <2>”表示这个控制器下每一个引脚要用2个32位的数(cell)来描述。用第1个cell来表示哪一个引脚，用第2个cell来表示有效电平：GPIO_ACTIVE_HIGH(高电平有效)，GPIO_ACTIVE_LOW(低电平有效)。

　　怎么引用某个引脚呢？在自己的设备节点中使用属性"[name]-gpios"，示例如下：

　　gpio controller 驱动

　　gpio client 驱动

　　GPIO 子系统有两套接口：基于描述符的(descriptor-based)、老的(legacy)。前者的函数都有前缀 “gpiod_”，它使用 gpio_desc 结构体来表示一个引脚；后者的函数都有前缀 “gpio_”，它使用一个整数来表示一个引脚。

　　要操作一个引脚，首先要 get 引脚，然后设置方向，读值、写值。

　　建议使用“devm_”版本的相关函数。有前缀“devm_”的含义是“设备资源管理”(Managed Device Resource)，这是一种自动释放资源的机制。它的思想是“资源是属于设备的，设备不存在时资源就可以自动释放”。

　　比如在 Linux 开发过程中，先申请了GPIO，再申请内存；如果内存申请失败，那么在返回之前就需要先释放GPIO资源。如果使用devm的相关函数，在内存申请失败时可以直接返回：设备的销毁函数会自动地释放已经申请了的GPIO资源。

　　以上面的设备 max9286_mipi 为例，它的驱动实现如下：

　　sysfs 访问方法

　　先确定某个GPIO Controller的基准引脚号(base number)，再计算出某个引脚的号码。

　　然后进入某个gpiochip目录，查看文件label的内容，根据 label 的内容对比设备树，就可以知道这对应哪一个 GPIO Controller。比如用上面的例子，通过对比设备树可知 gpiochip448 对应 gpio1。

　　因为 pin number = base + offset，所以 GPIO1_27 的号码是 448 + 27 = 475，那么通过 sys 可以做如下操作。

　　pinctrl subsystem 和 gpio subsysem 之间的耦合

　　pinctrl subsystem 管理系统的所有管脚，GPIO 是这些管脚的用途之一，因此 gpio subsystem 应该是 pinctrl subsystem 的 backend。在使用 GPIO 的时候，都需要向系统的 pinctrl subsystem 申请管脚，并将管脚配置为 GPIO 功能。

　　内核也提供了通过 pinctrl 控制 gpio 的接口：

　　pinctrl subsystem会维护一个gpio number到pin number的map(gpio range)，将gpio subsystem传来的gpio number转换为pin number之后，调用struct pinmux_ops中有关的回调函数即可：

　　gpio ranges

　　当 gpio driver 需要使用某一个 gpio 的时候，可以在 struct gpio_chip 的 request 函数中，调用 pinctrl core 提供的 pinctrl_request_gpio 接口（参数是gpio编号），然后 pinctrl core 会查寻 gpio ranges 链表，将 gpio 编号转换成 pin 编号，然后调用 pinctrl 的相应接口（参数是pin编号），申请该 pin 的使用。

　更多信息可以来这里获取==>>电子技术应用-AET<<