使用pinctrl子系统实现引脚功能动态切换

使用pinctrl子系统实现动态切换引脚功能

 

设备dts (msm8909-pinctrl.dtsi)

&soc {

         tlmm_pinmux:pinctrl@1000000 {

                   compatible= "qcom,msm-tlmm-8916";

                   reg= <0x1000000 0x300000>;

                   interrupts= <0 208 0>;

                   /*Generalpurpose pins*/

                   gp:gp {

                            qcom,num-pins= <113>;

                            #qcom,pin-cells= <1>;

                            msm_gpio:msm_gpio {

                                     compatible= "qcom,msm-tlmm-gp";

                                     gpio-controller;

                                     #gpio-cells= <2>;

                                     interrupt-controller;

                                     #interrupt-cells= <2>;

                                     num_irqs= <113>;

                            };

                   };

 

                   cam_sensor_mclk0{

                            /*MCLK */

                            qcom,pins= <&gp 26>;

                            qcom,num-grp-pins= <1>;

                            qcom,pin-func= <1>;

                            label= "cam-sensor-mclk0";

                             /* active state */

                            cam_sensor_mclk0_default:default {

                                     drive-strength= <2>; /* 2 MA */

                                     bias-disable= <0>; /* No PULL */

                            };

                   };

                   cam_sensor_mclk0_sleep{

                            /*MCLK */

                            qcom,pins= <&gp 26>;

                            qcom,num-grp-pins= <1>;

                            label= "cam-sensor-mclk0-sleep";

                            /*suspend state */

                            cam_sensor_mclk0_sleep:sleep {

                                     drive-strength= <2>; /* 2 MA */

                                     bias-pull-down;/* PULL DOWN */

                            };

                   };

                   /*test */

                   uart_0_console{

                            qcom,pins= <&gp 4>, <&gp 5>;

                            qcom,num-grp-pins= <2>;

                            qcom,pin-func= <2>;

                            label= "uart0-console";

                            uart_0_active:uart_0_active {

                                                drive-strength = <8>;

                                                bias-pull-down;

                            };

                   };

 

                   uart_0_gpio{

                            qcom,pins= <&gp 4>, <&gp 5>;

                            qcom,num-grp-pins= <2>;

                            qcom,pin-func= <0>;

                            label= "uart0-gpio";

                            uart_0_gpio:uart_0_gpio {

                                                drive-strength = <8>;

                                                bias-pull-down;

                                                output-high;

                            };

                   };

         };

};

 

定义串口引脚的两个状态uart_0_console(uart_0_active)和uart_0_gpio(uart_0_gpio)。

前者是配置gpio4/5作为uart功能,function2。后者配置gpio4,5作为普通gpio功能,function0。

 

具体设备引用:

&soc {

         gpio_uart_exchage{

                   compatible= "gpio-uart-exchage";

                   pinctrl-names= "default", "gpio";

                   pinctrl-0= <&uart_0_active>;

                   pinctrl-1= <&uart_0_gpio>;

         };

};

 

注意:

"default"对应的引脚配置为pinctrl-0;

"gpio"对应的引脚配置为pinctrl-1;

一般引脚的状态为两个就可以了,一个为活跃状态的引脚状态,一个是休眠状态的引脚状态。

如SDIO接口配置;

         pinctrl-names= "active", "sleep";

         pinctrl-0= <&sdc2_clk_on &sdc2_cmd_on &sdc2_data_on &sdc2_cd_on>;

         pinctrl-1= <&sdc2_clk_off &sdc2_cmd_off &sdc2_data_off&sdc2_cd_off>;

站在应用的逻辑上来讲,设置某模块的两种工作状态。

 

驱动

设备配置好了,我们来看驱动程序。

 

首先介绍下主要pinctrl函数(Core.c (drivers\pinctrl))

头文件:#include <linux/pinctrl/consumer.h>

参考:http://blog.youkuaiyun.com/hanp_linux/article/details/72818437

1. 获取一个pinctrl句柄,参数是dev是包含这个pin的device结构体即xxx这个设备的device

[cpp] view plain copy

/** 

 * struct devm_pinctrl_get() - Resource managed pinctrl_get() 

 * @dev: the device to obtain the handle for 

 * 

 * If there is a need to explicitly destroy the returned struct pinctrl, 

 * devm_pinctrl_put() should be used, rather than plain pinctrl_put(). 

 */  

struct pinctrl *devm_pinctrl_get(struct device *dev)  

 

2. 获取这个pin对应pin_state,引脚状态

[cpp] view plain copy

/** 

 * pinctrl_lookup_state() - retrieves a state handle from a pinctrl handle 

 * @p: the pinctrl handle to retrieve the state from 

 * @name: the state name to retrieve 

 */  

struct pinctrl_state *pinctrl_lookup_state(struct pinctrl *p, const char *name)  

3.设置引脚为为某个state

[cpp] view plain copy

/** 

 * pinctrl_select_state() - select/activate/program a pinctrl state to HW 

 * @p: the pinctrl handle for the device that requests configuration 

 * @state: the state handle to select/activate/program 

 */  

int pinctrl_select_state(struct pinctrl *p, struct pinctrl_state *state)  

 

下面是一个简单驱动程序:

#define pr_fmt(fmt) "%s:" fmt, __func__
 
#include <linux/init.h>
#include <linux/module.h>
#include <linux/fs.h>
#include <linux/slab.h>
#include<linux/miscdevice.h>
#include <linux/delay.h>
#include <linux/io.h>
#include<linux/uaccess.h>
#include<linux/regulator/consumer.h>
#include <linux/pinctrl/consumer.h>
#include<linux/platform_device.h>
#include <linux/mutex.h>
#include <linux/of.h>
#include <linux/gpio.h>
 
unsigned long isGPIO =0; 
struct pinctrl *gp_pinctrl;
struct pinctrl_state*gp_default;//uart
struct pinctrl_state*gp_gpio;//gpio
 
const char*gp_PINCTRL_STATE_DEFAULT = "default";
const char*gp_PINCTRL_STATE_GPIO = "gpio";
 
static int gp_request_gpios(intstate)
{
    int result = 0;
 
    if(state){
        result = pinctrl_select_state(gp_pinctrl, gp_default);
        if (result) {
            printk("%s: Can not set %s pins\n",
            __func__, "default");
        }
    }else{
        result = pinctrl_select_state(gp_pinctrl, gp_gpio);
        if (result) {
            printk("%s: Can not set %s pins\n",
            __func__, "gpio");
        }
    }
    printk(KERN_ERR "%s, eliot request state(%s) ok, result = %d\n",
            __func__, state ? "default" : "gpio",result);
 
        return result;
}
static ssize_t lock_show(structdevice* cd,struct device_attribute *attr, char* buf) 
{ 
    ssize_t ret = 0; 
    sprintf(buf, "%lu\n",isGPIO);  
    ret = strlen(buf) + 1;
    return ret; 
} 
 
static ssize_tlock_store(struct device* cd, struct device_attribute *attr, 
const char* buf, size_tlen) 
{ 
    unsigned long on_off = simple_strtoul(buf, NULL, 10); 
    isGPIO = on_off; 
    printk("%s: %lu\n",__func__, isGPIO); 
    gp_request_gpios(!!isGPIO);
 
    if(!isGPIO){
        printk(KERN_ERR "set gpio 4 & 5to 0\n");
        gpio_set_value(4 + 911, !!isGPIO);
        gpio_set_value(5 + 911, !!isGPIO);
    }
    return len; 
}
static DEVICE_ATTR(gp_ex,S_IRUGO | S_IWUSR, lock_show, lock_store); 
static intgp_pinctrl_init(struct platform_device *pdata)
{
    gp_pinctrl = devm_pinctrl_get(&pdata->dev);
    if (IS_ERR_OR_NULL(gp_pinctrl)) {
        printk("Failed to get pin ctrl\n");
        return PTR_ERR(gp_pinctrl);
    }
 
    // default
    gp_default = pinctrl_lookup_state(gp_pinctrl,
                gp_PINCTRL_STATE_DEFAULT);
    if (IS_ERR_OR_NULL(gp_default)) {
        printk("Failed to lookup pinctrl default state\n");
        return PTR_ERR(gp_default);
    }
 
    // gpio
    gp_gpio = pinctrl_lookup_state(gp_pinctrl,
                gp_PINCTRL_STATE_GPIO);
    if (IS_ERR_OR_NULL(gp_gpio)) {
        printk("Failed to lookup pinctrl gpio state\n");
        return PTR_ERR(gp_gpio);
    }
   
    printk("eliot %s,---ok\n", __func__);
    return 0;
 
}
// echo 0 >/sys/bus/platform/devices/gpio_uart_exchage.67/gp_ex //设置为普通GPIO
// echo 1 >/sys/bus/platform/devices/gpio_uart_exchage.67/gp_ex //设置为UART模式
static int gp_ex_probe(structplatform_device *pdev)
{
    int ret = 0;
    printk(KERN_ERR "eliot :gp_ex_probe\n");
    gp_pinctrl_init(pdev);
if(device_create_file(&pdev->dev, &dev_attr_gp_ex)) 
    printk(KERN_ERR "Unable to createsysfs entry: '%s'\n", 
            dev_attr_gp_ex.attr.name); 
    return ret;
 
}
static int gp_ex_remove(structplatform_device *plat)
{
    return 0;
}
 
static struct of_device_id__attribute__ ((unused)) gp_ex_of_match[] = {
    { .compatible = "gpio-uart-exchage", },
    {}
};
 
static struct platform_drivergp_ex_driver = {
    .probe = gp_ex_probe,
    .remove = gp_ex_remove,
    .driver = {
        .name = "gpio-exchage",
        .owner = THIS_MODULE,
        .of_match_table = of_match_ptr(gp_ex_of_match),
    },
};
 
static int __initgp_ex_init(void)
{
    return platform_driver_register(&gp_ex_driver);
}
 
static void __exitgp_ex_exit(void)
{
    platform_driver_unregister(&gp_ex_driver);
}
 
MODULE_LICENSE("GPLv2");
MODULE_AUTHOR("Eliot shao<http://blog.youkuaiyun.com/eliot_shao>");
MODULE_DESCRIPTION("Driverto exchager gpio4/5.");
MODULE_VERSION("1.0");
 
module_init(gp_ex_init);
module_exit(gp_ex_exit);


 

在sys文件系统下面创建一个节点,通过读写这个节点来设置gpio4,5的状态。使用方法:

// echo 0 >/sys/bus/platform/devices/gpio_uart_exchage.67/gp_ex //设置为普通GPIO

// echo 1 >/sys/bus/platform/devices/gpio_uart_exchage.67/gp_ex //设置为UART模式

 

其中调用的接口函数

int pinctrl_select_state(struct pinctrl *p, struct pinctrl_state *state)

来选择在dts中配置的两个引脚状态。

 

另外函数:

struct pinctrl_state *pinctrl_lookup_state(struct pinctrl *p, const char *name)

中的name在dts中pinctrl-names ="default", "gpio";配置,驱动中通过名称进行查找引脚状态。


<think>嗯,用户想深入了解Linux驱动开发中的pinctrl子系统,这属于嵌入式Linux的核心内容。从用户提问的精准度看,应该是有一定驱动开发基础的技术人员,可能正在调试板级引脚配置。 用户提供的引用材料很全面,覆盖了pinctrl的架构设计、设备树集成、GPIO子系统联动等关键点。特别注意到引用[3]详细描述了pinctrl_dev结构体,这是理解子系统内部机制的重要突破口。用户可能最关心的是如何在实际驱动中正确应用pinctrl,而不仅是理论概念。 需要重点解释清楚三个层次:首先是子系统存在的必要性——为什么裸机寄存器操作被淘汰(如引用[5]对比的STM32/IMX6ULL案例);其次是设备树配置的实践细节(引用[1][2]强调的设备树依赖);最后是驱动代码中的API调用时机(引用[4]的LED控制示例很典型)。 用户可能隐含的需求是解决实际引脚冲突问题,比如某个GPIO无法正确复用为I2C功能。因此回复中要突出“状态切换”这个易错点,通过休眠/唤醒的状态机示例说明配置流程。对于结构体字段这类底层细节,采用表格对比更直观,但需控制深度避免信息过载。 最后生成的问题要引导用户向具体场景延伸:比如针对功耗优化场景询问pinctrl的省电配置,或者结合GPIO子系统讨论中断处理。这样既能检验理解程度,又切合实际开发需求。</think>好的,我们来详细解析 Linux 驱动开发中的 `pinctrl` 子系统。 ## 1. 为什么需要 `pinctrl` 子系统? 在现代复杂的系统级芯片(SoC)上,一个物理引脚(Pin)通常具有多种功能(复用功能)。例如,一个引脚可能可以被配置为: * 通用输入/输出引脚(GPIO) * I²C 总线的时钟线(SCL)或数据线(SDA) * SPI 总线的片选(CS)、时钟(SCK)、数据输入(MISO)或数据输出(MOSI) * UART 的发送(TX)或接收(RX) * PWM 输出 * 等等 同时,每个引脚可能还需要配置其电气特性,如上拉/下拉电阻、驱动强度(输出电流能力)、施密特触发器使能、输入/输出模式(开漏、推挽)等。 在 `pinctrl` 子系统出现之前,这些配置通常分散在板级支持包(BSP)代码、具体驱动代码或 `arch/` 目录下的平台相关代码中。这导致了: 1. **代码重复:** 不同驱动需要重复实现引脚配置逻辑。 2. **维护困难:** 引脚配置与具体驱动和平台代码耦合紧密,改动困难。 3. **缺乏抽象:** 没有统一的接口管理引脚复用和配置。 4. **板级定制麻烦:** 为不同开发板适配引脚配置需要修改多处代码。 `pinctrl` 子系统的引入就是为了**统一管理 SoC 引脚的复用(Multiplexing)和配置(Configuration)**,提供一套标准的、与具体硬件无关的接口给内核其他部分(尤其是设备驱动)使用,并将引脚配置信息从驱动代码中剥离出来,放入设备树(Device Tree),极大地提高了代码的可重用性和可维护性[^1][^2][^5]。 ## 2. `pinctrl` 子系统核心概念 理解 `pinctrl` 子系统需要掌握几个关键概念: 1. **Pin Controller Device (引脚控制器设备):** * 这是物理上控制 SoC 上引脚复用和配置的硬件模块(通常是一个寄存器块)。 * 在设备树中,它表现为一个节点(例如 `&iomuxc` 或 `&pinctrl`),描述了这个控制器所能控制的所有引脚以及这些引脚可用的功能组(Pin Groups)和状态(Pin States)。 * 一个 SoC 可能包含多个 Pin Controller(例如,一个负责 Bank A,一个负责 Bank B)。 2. **Client Device (客户端设备):** * 这是需要使用引脚的设备,如 I2C 控制器、SPI 控制器、UART 控制器、MMC/SD 控制器、GPIO 控制器本身,甚至是一个简单的 LED 设备。 * 在设备树中,它表现为一个设备节点(例如 `&i2c1`, `&usdhc1`)。 * 它通过 `pinctrl-` 属性(如 `pinctrl-0`, `pinctrl-1`, ... `pinctrl-names`)来引用 Pin Controller 中定义好的引脚状态(Pin States),告诉内核它需要哪种引脚配置。 3. **Pin State (引脚状态):** * 这是 `pinctrl` 子系统的核心抽象。它代表了一组引脚在某个特定时刻的配置集合。 * 在 Pin Controller 的设备树节点中,使用子节点来定义不同的状态。常见的预定义状态名包括: * `default`: 设备正常操作时需要的状态。 * `init`: 设备初始化时可能需要的特殊状态(有时与 `default` 合并)。 * `sleep`, `idle`: 设备进入低功耗状态(睡眠、空闲)时需要的状态。 * 驱动也可以定义和使用自定义状态名(如 `active`, `inactive`)。 * 每个状态节点内部使用 `pinctrl` 绑定规定的属性(如 `fsl,pins`,具体属性名由 SoC 厂商的 Pin Controller 驱动定义)来描述该状态下涉及的**引脚组(Pin Group)**及其**复用功能**和**电气属性配置**。 4. **Pin Group (引脚组):** * 指逻辑上属于同一功能的一组引脚。例如,一个 UART 的 TX 和 RX 引脚可以组成一个名为 `uart1grp` 的组;一个 SPI 接口的 4 个引脚(CS, SCK, MISO, MOSI)可以组成名为 `spi0grp` 的组。 * 在 Pin Controller 设备树节点中定义的状态节点里,配置信息通常就是按组(或单个引脚)来指定的。组名通常作为状态节点的属性值出现。 5. **Pin Bank:** * 指物理上属于同一个寄存器块控制的一组引脚。通常一个 Pin Controller 可能管理多个 Bank。例如,一个 32 位寄存器控制 Bank A 的 32 个引脚,另一个 32 位寄存器控制 Bank B 的 32 个引脚。 * 这个概念更多存在于 Pin Controller 驱动实现的底层,对使用 `pinctrl` 的设备驱动通常是透明的[^1][^3]。 ## 3. `pinctrl` 子系统的工作原理与流程 1. **设备树描述:** * **Pin Controller 节点:** SoC 厂商或板级支持包(BSP)开发者在设备树(`.dtsi` 或 `.dts` 文件)中定义 Pin Controller 节点。在这个节点下,定义各种**状态子节点**(如 `pinctrl_mydevice_default`),在每个状态子节点内,使用 SoC 特定的属性(如 `fsl,pins`, `rockchip,pins`)列出该状态需要配置的**引脚组**(或单个引脚),并指定每个引脚的**复用功能编号**和**电气属性位掩码**。 * **Client Device 节点:** 设备驱动开发者或板级开发者在需要使用引脚的设备节点(如 `&i2c1`)中添加 `pinctrl-names` 和 `pinctrl-` 属性。例如: ```dts &i2c1 { pinctrl-names = "default", "sleep"; pinctrl-0 = <&pinctrl_i2c1_default>; // 引用Pin Controller中定义的状态节点 pinctrl-1 = <&pinctrl_i2c1_sleep>; ... }; ``` 2. **内核启动/驱动加载:** * **Pin Controller 驱动注册:** 在内核启动过程中,特定 SoC 的 Pin Controller 驱动(通常是平台驱动)被加载。它解析设备树中对应的 Pin Controller 节点,创建并注册一个 `struct pinctrl_desc` 和 `struct pinctrl_dev` 结构体实例到 `pinctrl` 子系统核心[^3]。这个 `pinctrl_dev` 代表了物理的 Pin Controller 硬件。 * **状态解析与存储:** Pin Controller 驱动解析设备树中该 Pin Controller 节点下定义的所有状态子节点,将配置信息存储在其私有数据结构中。 * **Client Device 驱动加载:** 当 Client Device 的驱动(如 `i2c-imx.c`)被加载时,其 `probe` 函数被调用。 * **获取 `pinctrl` 句柄:** 在 `probe` 函数中,驱动通常调用 `devm_pinctrl_get(dev)` 或 `pinctrl_get(dev)`。这个函数: * 根据设备节点(`dev->of_node`)查找 `pinctrl-names` 和 `pinctrl-` 属性。 * 找到关联的 Pin Controller (`pinctrl_dev`)。 * 遍历 `pinctrl-` 属性引用的所有状态节点(在 Pin Controller 节点下定义),并请求对应的 Pin Controller 驱动解析这些状态(如果还没解析的话)。 * 创建一个 `struct pinctrl` 对象来管理这个设备的所有状态,并返回一个 `struct pinctrl` 的句柄。 3. **状态选择与应用:** * **查找状态:** 驱动使用 `pinctrl_lookup_state(pinctrl, name)` 根据状态名(如 `"default"`)查找对应的 `struct pinctrl_state` 对象。 * **应用状态:** 驱动调用 `pinctrl_select_state(pinctrl, state)` 来应用该状态。这个函数最终会调用到关联的 Pin Controller 驱动注册的 `->set_state()` 或 `->set_mux()` / `->config_set()` 等操作函数。 * **硬件配置:** Pin Controller 驱动根据 `pinctrl_state` 中存储的配置信息(复用功能ID、电气属性掩码),操作 SoC 上实际的配置寄存器(MUX 寄存器、PAD 控制寄存器等),完成引脚复用功能和电气属性的设置[^3][^5]。 4. **状态切换(如休眠唤醒):** * 当设备需要进入低功耗状态(如 `suspend`)时,驱动(或 PM 子系统)会调用 `pinctrl_select_state(pinctrl, sleep_state)` 切换到休眠状态(如 `"sleep"`)。 * 当设备从低功耗状态恢复(`resume`)时,驱动会再次调用 `pinctrl_select_state(pinctrl, default_state)` 切换回默认状态。 ## 4. `pinctrl` 子系统与 GPIO 子系统的关系 这两个子系统紧密协作,但职责分明: * **`pinctrl` 子系统:** 负责引脚的**复用(Muxing)** 和 **配置(Configuration)**。它决定一个引脚当前是作为 GPIO 功能,还是作为某个特定外设(如 I2C、SPI)的功能。如果配置为 GPIO,它还负责设置该引脚作为 GPIO 时的基本电气属性(如上下拉、驱动强度)[^4][^5]。 * **GPIO 子系统:** 当引脚通过 `pinctrl` **配置为 GPIO 功能**后,GPIO 子系统负责提供 API 来**操作**这个 GPIO 引脚:设置方向(输入/输出)、读取输入电平、设置输出电平、申请/释放 GPIO、设置中断(如果该 GPIO 支持中断)等[^2][^4]。 **简单来说:`pinctrl` 决定了“这个引脚现在是什么(功能)”,GPIO 子系统决定了“当它是 GPIO 时,怎么操作它”。** 一个引脚必须先由 `pinctrl` 配置为 GPIO 功能,然后才能通过 GPIO 子系统 API 进行操作[^4][^5]。 ## 5. 关键数据结构(驱动开发者视角) 虽然驱动开发者通常不需要直接操作这些结构体内部,但了解它们有助于理解流程: 1. **`struct pinctrl_dev`:** * 代表一个注册到内核的 Pin Controller 硬件实例。 * 包含指向 `pinctrl_desc` 的指针、管理的引脚描述树、GPIO 范围列表、私有数据指针等[^3]。 * 由 SoC 厂商的 Pin Controller 驱动创建和注册。 2. **`struct pinctrl_desc`:** * 描述 Pin Controller 的能力和操作函数集。由 Pin Controller 驱动填充并传递给 `pinctrl_register()`。 * 关键成员: * `name`: 控制器名称。 * `pins`: `struct pinctrl_pin_desc` 数组,描述该控制器管理的所有物理引脚(名称、编号)。 * `npins`: `pins` 数组的大小。 * `pctlops`: `struct pinctrl_ops`,提供引脚/组枚举等操作。 * `pmxops`: `struct pinmux_ops`,提供引脚复用操作(核心)。 * `confops`: `struct pinconf_ops`,提供引脚配置操作(核心)。 * `owner`: 通常是 `THIS_MODULE`。 3. **`struct pinctrl`:** * 代表一个 Client Device 与 `pinctrl` 子系统的关联。通过 `devm_pinctrl_get()` 或 `pinctrl_get()` 获得。 * 包含该设备在设备树中引用的所有状态。 4. **`struct pinctrl_state`:** * 代表一个引脚配置状态(如 `"default"`, `"sleep"`)。 * 包含该状态下需要应用的配置设置列表(指向底层 Pin Controller 驱动存储的实际配置数据)。 * 通过 `pinctrl_lookup_state()` 获得。 5. **`struct pinctrl_setting`:** * `pinctrl_state` 内部包含一个或多个 `pinctrl_setting`。 * 每个 `setting` 代表一个具体的操作:复用(`PIN_MAP_TYPE_MUX_GROUP`)或配置(`PIN_MAP_TYPE_CONFIGS_*`)一个引脚组。 ## 6. 在 Client Device 驱动中使用 `pinctrl`(典型代码片段) ```c #include <linux/pinctrl/consumer.h> // 必须包含 static int my_driver_probe(struct platform_device *pdev) { struct device *dev = &pdev->dev; struct pinctrl *pinctrl; struct pinctrl_state *default_state, *sleep_state; int ret; /* 1. 获取该设备的 pinctrl 句柄 */ pinctrl = devm_pinctrl_get(dev); if (IS_ERR(pinctrl)) { ret = PTR_ERR(pinctrl); dev_err(dev, "Failed to get pinctrl: %d\n", ret); return ret; // 或 probe deferral } /* 2. 查找需要的状态 */ default_state = pinctrl_lookup_state(pinctrl, PINCTRL_STATE_DEFAULT); // "default" if (IS_ERR(default_state)) { ret = PTR_ERR(default_state); dev_err(dev, "Failed to get default pinctrl state: %d\n", ret); goto err_pinctrl; } sleep_state = pinctrl_lookup_state(pinctrl, PINCTRL_STATE_SLEEP); // "sleep" if (IS_ERR(sleep_state)) { dev_warn(dev, "No sleep pinctrl state defined, ignoring\n"); sleep_state = NULL; // 不是所有设备都需要sleep状态 } /* 3. 应用默认状态 (通常在probe早期应用) */ ret = pinctrl_select_state(pinctrl, default_state); if (ret) { dev_err(dev, "Failed to apply default pinctrl state: %d\n", ret); goto err_pinctrl; } /* ... 驱动其他初始化代码 ... */ /* 存储 pinctrl 和 states 以备后用 (例如在 suspend/resume 中) */ my_priv_data->pinctrl = pinctrl; my_priv_data->default_state = default_state; my_priv_data->sleep_state = sleep_state; return 0; err_pinctrl: devm_pinctrl_put(pinctrl); // 如果使用 pinctrl_get() 则需要手动调用 return ret; } static int my_driver_suspend(struct device *dev) { struct my_priv_data *priv = dev_get_drvdata(dev); int ret = 0; if (priv->sleep_state) { ret = pinctrl_select_state(priv->pinctrl, priv->sleep_state); if (ret) dev_warn(dev, "Failed to apply sleep pinctrl state: %d\n", ret); } /* ... 其他 suspend 操作 ... */ return ret; } static int my_driver_resume(struct device *dev) { struct my_priv_data *priv = dev_get_drvdata(dev); int ret = 0; /* ... 其他 resume 操作 ... */ ret = pinctrl_select_state(priv->pinctrl, priv->default_state); if (ret) { dev_err(dev, "Failed to apply default pinctrl state on resume: %d\n", ret); return ret; } return 0; } static const struct dev_pm_ops my_driver_pm_ops = { .suspend = my_driver_suspend, .resume = my_driver_resume, // 可能还有 .suspend_noirq, .resume_noirq 等 }; ``` ## 7. 总结 * `pinctrl` 子系统是 Linux 内核中**统一管理 SoC 引脚复用和配置**的核心框架。 * 它通过**设备树**描述硬件引脚资源和设备所需的引脚状态(`default`, `sleep` 等),实现了**配置与驱动代码的分离**。 * 核心概念包括 **Pin Controller**、**Client Device**、**Pin State**、**Pin Group**。 * Client Device 驱动通过 `pinctrl_get()` / `devm_pinctrl_get()` 获取句柄,通过 `pinctrl_lookup_state()` 查找状态,通过 `pinctrl_select_state()` 应用状态。 * 状态切换(如休眠唤醒)是 `pinctrl` 的关键应用场景之一。 * `pinctrl` 负责**决定引脚功能(复用)和基本配置**,**GPIO 子系统**负责**操作配置为 GPIO 功能引脚**,两者分工明确,协同工作[^4][^5]。 理解并正确使用 `pinctrl` 子系统是编写可移植、易维护的现代 Linux 设备驱动(尤其是涉及外设接口的驱动)的基础。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值