GPIO - Pinctrl 子系统
Linux Pinctrl(引脚控制)子系统是Linux内核中用于管理和控制硬件引脚(GPIO、I2C、SPI等)的一个子系统。它允许Linux内核与底层硬件交互,配置和控制系统中的各种引脚以实现特定的功能。以下是Linux Pinctrl子系统的一些关键特性和组成部分:
- 
通用性: Linux Pinctrl子系统设计为通用的,可用于广泛的处理器体系结构和硬件平台。这使得它成为各种嵌入式系统和单板计算机的理想选择。
 - 
引脚描述符(pinctrl_desc): Pinctrl子系统使用引脚描述符来表示引脚的抽象。每个引脚描述符包含有关引脚的信息,如引脚号、功能、配置参数等。
 - 
引脚控制器(pinctrl_controller): 引脚控制器是Pinctrl子系统的核心组件之一,负责管理和控制一组相关的引脚。每个引脚控制器对应于特定的硬件模块或芯片,可以配置引脚以实现不同的功能。
 - 
引脚状态(pinctrl_state): 引脚状态表示引脚的特定配置和状态。通过切换引脚状态,可以实现不同的功能或操作。
 - 
设备树绑定(Device Tree Bindings): 在Linux系统中,设备树通常用于描述硬件平台的信息。Pinctrl子系统使用设备树绑定来将硬件描述符与设备树节点相关联,以实现引脚的配置和控制。
 - 
用户空间接口: Linux Pinctrl子系统提供了用户空间接口,允许用户空间程序通过sysfs接口或ioctl系统调用与Pinctrl子系统进行交互,配置和控制系统中的引脚。
 
模块配置
驱动配置
Pinctrl Drivers ->
	<*> Pinctrl Support for Allwinner SoCs
	<*>   Pinctrl Debugfs Driver
	< >   SUN8IW20 PIO // 根据芯片选择
	<*>   SUN55IW3 PIO
设备树配置
对于 Pinctrl,设备树公共配置如下
pio: pinctrl@2000000 {
	#address-cells = <1>;
	compatible = "allwinner,sun55iw3-pinctrl";
	/*
	* The reg control i2s0/dmic routes to cpus-pad or sys-pad
	* 0: use cpus pad, 1: use sys pad
	*/
	reg = <0x0 0x02000000 0x0 0x800>,
		<0x0 0x07010374 0x0 0x4>,
		<0x0 0x07010378 0x0 0x4>;
	reg-names = "pio", "i2s0", "dmic";
	interrupts = <GIC_SPI 69 IRQ_TYPE_LEVEL_HIGH>,       /* GPIOB */
				   <GIC_SPI 71 IRQ_TYPE_LEVEL_HIGH>,     /* GPIOC */
				   <GIC_SPI 73 IRQ_TYPE_LEVEL_HIGH>,     /* GPIOD */
				   <GIC_SPI 75 IRQ_TYPE_LEVEL_HIGH>,     /* GPIOE */
				   <GIC_SPI 77 IRQ_TYPE_LEVEL_HIGH>,     /* GPIOF */
				   <GIC_SPI 79 IRQ_TYPE_LEVEL_HIGH>,     /* GPIOG */
				   <GIC_SPI 81 IRQ_TYPE_LEVEL_HIGH>,     /* GPIOH */
				   <GIC_SPI 83 IRQ_TYPE_LEVEL_HIGH>,     /* GPIOI */
				   <GIC_SPI 85 IRQ_TYPE_LEVEL_HIGH>,     /* GPIOJ */
				   <GIC_SPI 140 IRQ_TYPE_LEVEL_HIGH>;    /* GPIOK */
	clocks = <&ccu CLK_APB1>, <&dcxo24M>, <&rtc_ccu CLK_OSC32K>;
	clock-names = "apb", "hosc", "losc";
	gpio-controller;
	#gpio-cells = <3>;
	interrupt-controller;
	#interrupt-cells = <3>;
};
部分平台存在两个 GPIO 域,一般来说 GPIO L 前的是 PIO 域,从 GPIO L 开始之后的是 RPIO 域,配置如下
r_pio: pinctrl@7022000 {
	#address-cells = <1>;
	compatible = "allwinner,sun55iw3-r-pinctrl";
	reg = <0x0 0x07022000 0x0 0x800>,
		<0x0 0x07010374 0x0 0x4>,
		<0x0 0x07010378 0x0 0x4>;
	/*
	* The reg control i2s0/dmic routes to cpus-pad or sys-pad
	* 0: use cpus pad, 1: use sys pad
	*/
	reg-names = "r-pio", "i2s0", "dmic";
	interrupts = <GIC_SPI 159 IRQ_TYPE_LEVEL_HIGH>,      /* GPIOL */
				  <GIC_SPI 161 IRQ_TYPE_LEVEL_HIGH>;     /* GPIOM */
	clocks = <&ccu CLK_R_APBS1>, <&dcxo24M>, <&rtc_ccu CLK_OSC32K>;
	clock-names = "apb", "hosc", "losc";
	gpio-controller;
	#gpio-cells = <3>;
	interrupt-controller;
	#interrupt-cells = <3>;
};
配置通用GPIO功能/中断功能
soc{
	gpiokey {
		device_type = "gpiokey";
		compatible = "gpio-keys";
		ok_key {
			device_type = "ok_key";
			label = "ok_key";
			gpios = <&pio PA 4 GPIO_ACTIVE_HIGH>;
			linux,input-type = "1>";
			linux,code = <0x1c>;
			wakeup-source = <0x1>;
		};
	};
};
gpios = <&pio  PA 4 GPIO_ACTIVE_HIGH>;
            |   |   |
            |   |   `-------------------gpio active时状态,如果需要上下拉,还可以或上GPIO_PULL_UP、GPIO_PULL_DOWN标志
            |   `-----------------------哪个bank
            `---------------------------指向哪个pio,属于cpus要用&r_pio
配置设备引脚
&pio {
    pwm0_4_pin_active: pwm0_4@0 {
		pins = "PI3";
		function = "pwm0_4";
	};
	pwm0_4_pin_sleep: pwm0_4@1 {
		pins = "PI3";
		function = "gpio_in";
		bias-pull-down;
	};
};
&pwm0_4 {
	pinctrl-names = "active", "sleep";
	pinctrl-0 = <&pwm0_4_pin_active>;
	pinctrl-1 = <&pwm0_4_pin_sleep>;
	status = "okay";
};
pinctrl-0对应pinctrl-names中的default,即模块正常工作模式下对应的pin配置。
pinctrl-1对应pinctrl-names中的sleep,即模块休眠模式下对应的pin配置。
模块接口
pinctrl_get
- 
函数原型:
struct pinctrl *pinctrl_get(struct device *dev); - 
作用:获取设备的pin操作句柄,所有pin操作必须基于此pinctrl句柄。
 - 
参数:
- dev:指向申请pin操作句柄的设备句柄。
 
 - 
返回:
- 成功,返回pinctrl句柄。
 - 失败,返回NULL。
 
 
pinctrl_put
- 
函数原型:
void pinctrl_put(struct pinctrl *p) - 
作用:释放pinctrl句柄,必须与pinctrl_get配对使用。
 - 
参数:
- p:指向释放的pinctrl句柄。
 
 - 
返回:
- 没有返回值。
 
 
devm_pinctrl_get
- 
函数原型:
struct pinctrl *devm_pinctrl_get(struct device *dev) - 
作用:根据设备获取pin操作句柄,所 有pin操作必须基于此pinctrl句柄,与pinctrl_get功能完全一样,只是devm_pinctrl_get会将申请到的pinctrl句柄做记录,绑定到设备句柄信息中。设备驱动申请pin资源, 推荐优先使用devm_pinctrl_get接口。
 - 
参数:
- dev:指向申请pin操作句柄的设备句柄。
 
 - 
返回:
- 成功,返回pinctrl句柄。
 - 失败,返回NULL。
 
 
devm_pinctrl_put
- 
函数原型:
void devm_pinctrl_put(struct pinctrl *p) - 
作用:释放pinctrl句柄,必须与devm_pinctrl_get配对使用。
 - 
参数:
- p:指向释放的pinctrl句柄。
 
 - 
返回:
- 没有返回值。
 
 
pinctrl_lookup_state
- 
函数原型:
struct pinctrl_state *pinctrl_lookup_state(struct pinctrl *p, const char *name) - 
作用:根据pin操作句柄,查找state状态句柄。
 - 
参数:
- p:指向要操作的pinctrl句柄。
 - name:指向状态名称,如"default"、"sleep"等。
 
 - 
返回:
- 成功,返回执行pin 状态的句柄struct pinctrl_state *。
 - 失败,返回NULL。
 
 
pinctrl_select_state
- 
函数原型:
int pinctrl_select_state(struct pinctrl *p, struct pinctrl_state *s) - 
作用:将pin句柄对应的pinctrl设置为state句柄对应的状态。
 - 
参数:
- p:指向要操作的pinctrl句柄。
 - s:指向state 句柄。
 
 - 
返回:
- 成功,返回0。
 - 失败,返回错误码。
 
 
devm_pinctrl_get_select
- 
函数原型:
struct pinctrl *devm_pinctrl_get_select(struct device *dev, const char *name) - 
作用:获取设备的pin操作句柄,并将句柄设定为指定状态。
 - 
参数:
- dev:指向管理pin操作句柄的设备句柄。
 - name:要设置的state名称,如"default"、"sleep"等。
 
 - 
返回:
- 成功,返回pinctrl句柄。
 - 失败,返回NULL。
 
 
devm_pinctrl_get_select_default
- 
函数原型:
struct pinctrl *devm_pinctrl_get_select_default(struct device *dev) - 
作用:获取设备的pin操作句柄,并将句柄设定为默认状态。
 - 
参数:
- dev:指向管理pin操作句柄的设备句柄。
 
 - 
返回:
- 成功,返回pinctrl句柄。
 - 失败,返回NULL。
 
 
gpio_request
- 
函数原型:
int gpio_request(unsigned gpio, const char *label) - 
作用:申请gpio,获取gpio的访问权。
 - 
参数:
- gpio:gpio编号。
 - label:gpio名称,可以为NULL。
 
 - 
返回:
- 成功,返回0。
 - 失败,返回错误码。
 
 
gpio_free
- 
函数原型:
void gpio_free(unsigned gpio) - 
作用:释放gpio。
 - 
参数:
- gpio:gpio编号。
 
 - 
返回:
- 无返回值。
 
 
gpio_direction_input
- 
函数原型:
int gpio_direction_input(unsigned gpio) - 
作用:设置gpio为input。
 - 
参数:
- gpio:gpio编号。
 
 - 
返回:
- 成功,返回0。
 - 失败,返回错误码。
 
 
gpio_direction_output
- 
函数原型:
int gpio_direction_output(unsigned gpio, int value) - 
作用:设置gpio为output。
 - 
参数:
- gpio:gpio编号。
 - value:期望设置的gpio电平值,非0表示高, 0表示低。
 
 - 
返回:
- 成功,返回0.
 - 失败,返回错误码。
 
 
__gpio_get_value
- 
函数原型:
int __gpio_get_value(unsigned gpio) - 
作用:获取gpio电平值(gpio已为input/output状态)。
 - 
参数:
- gpio:gpio编号。
 
 - 
返回:
- 返回gpio对应的电平逻辑,1表示高, 0表示低。
 
 
__gpio_set_value
- 
函数原型:
void __gpio_set_value(unsigned gpio, int value) - 
作用:设置gpio电平值(gpio已为input/output状态)。
 - 
参数:
- gpio:gpio编号。
 - value:期望设置的gpio电平值,非0表示高, 0表示低。
 
 - 
返回:
- 无返回值
 
 
of_get_named_gpio
- 
函数原型:
int of_get_named_gpio(struct device_node *np, const char *propname, int index) - 
作用:通过名称从dts解析gpio属性并返回gpio编号。
 - 
参数:
- np:指向使用gpio的设备结点。
 - propname:dts中属性的名称。
 - index:dts中gpio属性的索引值。
 
 - 
返回:
- 成功,返回gpio编号。
 - 失败,返回错误码。
 
 
of_get_named_gpio_flags
- 
函数原型:
int of_get_named_gpio_flags(struct device_node *np, const char *list_name, int index, enum of_gpio_flags *flags) - 
作用:通过名称从dts解析gpio属性并返回gpio编号。
 - 
参数:
- np:指向使用gpio的设备结点。
 - propname:dts中属性的名称。
 - index:dts中gpio属性的索引值
 - flags:输入、输出信息
of_gpio_flags 
 - 
返回:
- 成功,返回gpio编号。
 - 失败,返回错误码。