设备树中pinctrl的简单使用

pinctrl介绍文档:

内核目录\Documentation/devicetree/bindings/pinctrl/samsung-pinctrl.txt

 

首先介绍几个概念:
Bank: 以引脚名为依据, 这些引脚分为若干组, 每组称为一个Bank
比如s3c2440里有GPA、GPB、GPC等Bank。
每个Bank中有若干个引脚, 比如GPA0,GPA1, ..., GPC0, GPC1,...等引脚

Group: 以功能为依据, 具有相同功能的引脚称为一个Group
比如s3c2440中串口0的TxD、RxD引脚使用 GPH2,GPH3, 那这2个引脚可以列为一组
比如s3c2440中串口0的流量控制引脚使用 GPH0,GPH1, 那这2个引脚也可以列为一组

State: 设备的某种状态, 比如内核自己定义的"default","init","idel","sleep"状态;
也可以是其他自己定义的状态, 比如串口的"flow_ctrl"状态(使用流量控制)
每种状态会对应一组或多组group。
可以通过函数设置设备状态。

 

a. 设备树中pinctrl节点:
a.1 它定义了各种 pin bank, 比如s3c2440有GPA,GPB,GPC,...,GPB各种BANK, 每个BANK中有若干引脚:

	pinctrl_0: pinctrl@56000000 {
		reg = <0x56000000 0x1000>;

		gpa: gpa {
			gpio-controller; //表示是一个bank
			#gpio-cells = <2>;  /* 使用gpa bank中的引脚时, 需要2个u32来指定引脚 */
		};

		gpb: gpb {
			gpio-controller;
			#gpio-cells = <2>;
		};

		gpc: gpc {
			gpio-controller;
			#gpio-cells = <2>;
		};

		gpd: gpd {
			gpio-controller;
			#gpio-cells = <2>;
		};
	};

a.2 它还定义了各种group(组合), 某种功能所涉及的引脚称为group,

pin groups是pinctrl下面的子节点

比如串口0要用到2个引脚: gph0, gph1:

	uart0_data: uart0-data {
/* 在GPHCON寄存器中gph0,gph1可以设置以下值:
   0 --- 输入功能
   1 --- 输出功能
   2 --- 串口功能
我们要使用串口功能,samsung,pin-function 设置为2
*/
		samsung,pins = "gph-0", "gph-1"; //用哪些引脚实现这个功能
		samsung,pin-function = <2>;//使用这个功能需要将寄存器设置成什么值   
  	};

	uart0_sleep: uart0_sleep {
/* 在GPHCON寄存器中gph0,gph1可以设置以下值:
   0 --- 输入功能
   1 --- 输出功能
   2 --- 串口功能
我们要使用输入功能,samsung,pin-function 设置为0
*/     
		samsung,pins = "gph-0", "gph-1";
		samsung,pin-function = <0>;   
	};
 

samsung-pinctrl.txt中也定义了一下几种属性的用法：

- samsung,pin-val: Initial value of pin output buffer.

- samsung,pin-pud: Pull up/down configuration.

- samsung,pin-drv: Drive strength configuration.

- samsung,pin-pud-pdn: Pull up/down configuration in power down mode.

- samsung,pin-drv-pdn: Drive strength configuration in power down mode.

b. 设备节点中要使用某一个 pin group:

	serial@50000000 {
	    ......
		pinctrl-names = "default", "sleep";  /* 既是名字, 也称为state(状态) */
		pinctrl-0 = <&uart0_data>;
		pinctrl-1 = <&uart0_sleep>;
	};
	
	pinctrl-names中定义了2种state: default 和 sleep,
	default 对应的引脚是: pinctrl-0, 它指定了使用哪些pin group: uart0_data
	sleep   对应的引脚是: pinctrl-1, 它指定了使用哪些pin group: uart0_sleep

c. platform_device, platform_driver匹配时对pinctrl的处理:

platform_device和platform_driver的匹配完成后,最终都会调用到 really_probe()函数 (drivers/base/dd.c)

really_probe:
	/* If using pinctrl, bind pins now before probing */
	ret = pinctrl_bind_pins(dev);
				dev->pins->default_state = pinctrl_lookup_state(dev->pins->p,
								PINCTRL_STATE_DEFAULT);  /* 获得"default"状态的pinctrl */
				dev->pins->init_state = pinctrl_lookup_state(dev->pins->p,
								PINCTRL_STATE_INIT);    /* 获得"init"状态的pinctrl */

				ret = pinctrl_select_state(dev->pins->p, dev->pins->init_state);    /* 优先设置"init"状态的引脚 */
				ret = pinctrl_select_state(dev->pins->p, dev->pins->default_state); /* 如果没有init状态, 则设置"default"状态的引脚 */
								
	......
	ret = drv->probe(dev);

如果设备节点中指定了pinctrl, 在对应的probe函数被调用之前, 先"bind pins", 即先绑定、设置引脚状态。

 

d. 在驱动程序中设置引脚状态:

   devm_pinctrl_get_select_default(struct device *dev); // 将引脚设置为"default"状态
   
   // 根据name将引脚设置为某种状态 比如default，sleep
   pinctrl_get_select(struct device *dev, const char *name); 
   
   pinctrl_put(struct pinctrl *p);   // 不再使用, 退出时调用