手把手教你使用 Gpio 子系统 API

本文讲解 pinctrl 子系统和 gpio 子系统的 API，以及使用示例。

传统的配置 pin 的方式就是直接操作相应的寄存器，但是这种配置方式比较繁琐、而且容易出问题(比如 pin 功能冲突)。pinctrl 子系统就是为了解决这个问题而引入的，pinctrl 子系统主要工作内容如下：

①获取设备树中 pin 信息。

②根据获取到的 pin 信息来设置 pin 的复用功能

③根据获取到的 pin 信息来设置 pin 的电气特性，比如上/下拉、速度、驱动能力等。

对于我们使用者来讲，只需要在设备树里面设置好某个 pin 的相关属性即可，其他的初始化工作均由 pinctrl 子系统来完成。

如果 pinctrl 将一个 pin 脚初始化为 GPIO 而不是 IIC 或者 SPI，那么接下来就可以使用 gpio 子系统的API。

gpio 子系统是基于 pinctrl 子系统的!pin controller 和 GPIO Controller 不是一回事，前者控制引脚可用于 GPIO 功能、I2C 功能等功能性切换;后者只是把引脚配置为输入、输出、设置GPIO方向、获取值等简单的功能。(pinctrl 的 api 其实可以实现所有需求，但 gpio 的函数更常用一些)

1、gpio 子系统 API

gpio 子系统中操作一个 GPIO 需要如下几步：

1. 1、of_find_compatible_node
2. 2、of_get_named_gpio
3. 3、gpio_request
4. 4、控制gpio（gpio_direction_input、gpio_direction_output……）
5. 5、gpio_free

1)of_find_compatible_node 函数在设备树中根据 device_type 和 compatible 这两个属性查找指定的节点，此处是为了获取在设备树中设置的 GPIO 的节点句柄。如果其他地方有获得句柄，那么可以直接使用这个句柄。

2) of_get_named_gpio ，获取所设置的 gpio number。

3) gpio_request ，请求这个 gpio 。如果其他地方请求了这个 gpio，还没有释放，那么我们会请求不到。

4)请求到这个 gpio 以后，我们就可以对它进行操作，比如获取到它的值，设置它的值。

5)使用完以后，释放这个 gpio。

原理图：

博主手里有一个 正点原子 imx6ull 开发板，查原理图，发现蜂鸣器直连的 GPIO 是 GPIO5_1。我把此 IO 口拉低，蜂鸣器就会响。

在设备树中增加如下代码(imx6ull-alientek-emmc.dts)

1. test:test {
2. compatible = "Jason_hello";
3. hello = <&gpio5 1 GPIO_ACTIVE_HIGH>;
4. };

设置 GPIO 为 GPIO5_1，高电平有效，但实际上第三个参数我没有使用。

gpio.c

1. #include
2. #include
3. #include
4. #include
5. #include of.h>
6. #include
7. static int __init mypinctrl_init(void)
8. {
9. int gpionum = 0;
10. int ret = 0;
11. struct device_node *node = NULL;
12. node = of_find_compatible_node(NULL,NULL,"Jason_hello");
13. if(!node){
14. printk("get node error\n");
15. return ret;
16. }
17. gpionum = of_get_named_gpio(node,"hello",0);
18. if(gpionum < 0){
19. printk("get gpionum error\n");
20. return ret;
21. }
22. ret = gpio_request(gpionum,"hello");
23. if(ret){
24. printk("gpio_request error\n");
25. return ret;
26. }
27. printk("gpio(%d) value = %d\n",gpionum,ret);
28. ret = gpio_get_value(gpionum);
29. printk("gpio(%d) value = %d\n",gpionum,ret);
30. gpio_direction_output(gpionum,0); // 设置 gpio 输出低电平
31. ret = gpio_get_value(gpionum);
32. printk("gpio(%d) value = %d\n",gpionum,ret);
33. return 0;
34. }
35. static void __exit mypinctrl_exit(void)
36. {
37. printk("%s\n",__func__);
38. }
39. module_init(mypinctrl_init);
40. module_exit(mypinctrl_exit);
41. MODULE_LICENSE("GPL");

Makefile

1. KERNELDIR := /home/book/linux/tool/kernel/linux-imx-rel_imx_4.1.15_2.1.0_ga_alientek
2. CURRENT_PATH := $(shell pwd)
3. obj-m := gpio.o
4. build: kernel_modules
5. kernel_modules:
6. $(MAKE) -C $(KERNELDIR) M=$(CURRENT_PATH) modules
7. clean:
8. $(MAKE) -C $(KERNELDIR) M=$(CURRENT_PATH) clean

在 Linux 内核源码根目录中输入 make dtbs，编译一份设备树，下载进开发板。

在 kernel/drivers/misc/ 中新建文件夹，命名为 mygpio，里面放置 gpio.c 和 Makefile。然后输入 make 编译出 gpio.ko。然后拷贝进板子，insmod 上去，可以发现蜂鸣器有响。

2、pinctrl 子系统 API

pinctrl 子系统的 API 有很多，对于驱动工程师来说，pinctrl 操作一个 GPIO 只需要三步：

1. 1、devm_pinctrl_get
2. 2、pinctrl_lookup_state
3. 3、pinctrl_select_state

在 Linux 中，加 devm_ 开头的函数，代表这个函数支持资源管理。一般情况下，我们写一个驱动程序，在程序开头都会申请资源，比如内存、中断号等，万一后面哪一步申请出错，我们要回滚到第一步，去释放已经申请的资源，这样很麻烦。后来 Linux 开发出了很多 devm_ 开头的函数，代表这个函数有支持资源管理的版本，不管哪一步出错，只要错误退出，就会自动释放所申请的资源。

1)devm_pinctrl_get：用于获取设备树中自己用 pinctrl 建立的节点的句柄;

2) pinctrl_lookup_state：用于选择其中一个 pinctrl 的状态，同一个 pinctrl 可以有很多状态。比如 GPIO50 ，一开始初始化的时候是 I2C ，设备待机时候，我希望切换到普通 GPIO 模式，并且配置为下拉输入，省电。这时候如果 pinctrl 节点有描述，我们就可以在代码中切换 pin 的功能，从 I2C 功能切换成普通 GPIO 功能;

3) pinctrl_select_stat：用于真正设置，在上一步获取到某个状态以后，这一步真正设置为这个状态。

对于 pinctrl 子系统的设备树配置，是遵守 service 和 client 结构。

client 端各个平台基本都是一样的，server 端每个平台都不一样，使用的字符串的配置也不一样。

设备树配置：

1. //client端，设置不同状态
2. &test {
3. pinctrl-names = "default","test_low","test_high";
4. pinctrl-0 = <&test_default>;
5. pinctrl-1 = <&test_low>;
6. pinctrl-2 = <&test_high>;
7. gpio = <&gpio5 1 GPIO_ACTIVE_LOW>;
8. status = "okay";
9. };
10. //server 即 pin controller 端，设置 GPIO 几种功能状态
11. &gpio5 {
12. test_default:test_default{};
13. test_low:test_low{
14. fsl,pins = <
15. MX6UL_PAD_GPIO5_IO01__GPIO5_IO01 0x17059
16. >
17. };
18. test_high:test_low{
19. fsl,pins = <
20. MX6UL_PAD_GPIO5_IO01__GPIO5_IO01 0x1b0b1
21. >
22. };
23. };

pinctrl.c

1. #include
2. #include
3. #include
4. #include
5. #include
6. #include
7. #include
8. static int __init mypinctrl_init(void)
9. {
10. int ret = 0;
11. struct pinctrl *pctrl;
12. struct platform_device *pdev;
13. struct pinctrl_state *test_high;
14. struct pinctrl_state *test_low;
15. pctrl = devm_pinctrl_get(&pdev->dev);
16. if(IS_ERR(pctrl)){
17. ret = PTR_ERR(pctrl);
18. printk("devm_pinctrl_get error\n");
19. return ret;
20. }
21. test_high = pinctrl_lookup_state(pctrl,"test_high");
22. if(IS_ERR(pctrl)){
23. ret = PTR_ERR(test_high);
24. printk("pinctrl_lookup_state test_high error\n");
25. return ret;
26. }
27. test_low = pinctrl_lookup_state(pctrl,"test_low");
28. if(IS_ERR(pctrl)){
29. ret = PTR_ERR(test_low);
30. printk("pinctrl_lookup_state test_low error\n");
31. return ret;
32. }
33. pinctrl_select_state(pctrl,test_low);
34. udelay(200);
35. pinctrl_select_state(pctrl,test_high);
36. return 0;
37. }
38. static void __exit mypinctrl_exit(void)
39. {
40. printk("%s\n",__func__);
41. }
42. module_init(mypinctrl_init);
43. module_exit(mypinctrl_exit);
44. MUDULE_LICENSE("GPL");

Makefile 与上面相同，只是更改一下编译输出的名字。

这个驱动加载上去，可以切换GPIO口的功能状态，我这里只是控制GPIO输出高低，具体看你设备树怎么配，比如你可以配置某个GPIO一开始是I2C功能，待机时候是普通GPIO功能，达到省电的目的。

补充：

设备树是用来描述板子上的设备信息的，不同的设备其信息不同，反映到设备树中就是属性不同。那么我们在设备树中添加一个硬件对应的节点的时候从哪里查阅相关的说明呢?在Linux 内核源码中有详细的.txt 文档描述了如何添加节点，这些.txt 文档叫做绑定文档，路径为：Linux 源码目录/Documentation/devicetree/bindings。

比如我们现在要想在 I.MX6ULL 这颗 SOC 的 I2C 下添加一个节点，那么就可以查看Documentation/devicetree/bindings/i2c/i2c-imx.txt，此文档详细的描述了 I.MX 系列的 SOC 如何在设备树中添加 I2C 设备节点。

有时候使用的一些芯片在 Documentation/devicetree/bindings 目录下找不到对应的文档，这个时候就要咨询芯片的提供商，让他们给你提供参考的设备树文件。

小技巧：很多时候我们看设备树文件，里面的内容看不懂，这时候你看 .dts 最开始引用的头文件，点进去，你就会发现这些字符串是定义在这里的。

参考文档：

Documentation\devicetree\bindings\Pinctrl\Pinctrl-bindings.txt

Documentation\gpio\Pinctrl-bindings.txt

Documentation\devicetree\bindings\gpio\gpio.txt

Documentation\devicetree\bindings\pinctrl\pinctrl-bindings.txt