设备树pinctrl子系统

🕗 发布于 2024-10-12 01:26 驱动

1.pinctrl子系统

大多数 SOC 的 pin 都是支持复用的，比如 IMX6ULL 的 GPIO1_IO03 既可以作为普通的GPIO 使用，也可以作为 I2C1 的 SDA 等等。此外我们还需要配置 pin 的电气特性，比如上/下拉、速度、驱动能力等等。传统的配置 pin 的方式就是直接操作相应的寄存器，但是这种配置方式比较繁琐、而且容易出问题(比如 pin 功能冲突)。pinctrl 子系统就是为了解决这个问题而引入的，pinctrl 子系统主要工作内容如下：
①、获取设备树中 pin 信息。
②、根据获取到的 pin 信息来设置 pin 的复用功能
③、根据获取到的 pin 信息来设置 pin 的电气特性，比如上/下拉、速度、驱动能力等。

要使用 pinctrl 子系统，我们需要在设备树里面设置 PIN 的配置信息，毕竟 pinctrl 子系统要
根据你提供的信息来配置 PIN 功能，一般会在设备树里面创建一个节点来描述 PIN 的配置信
息。在imx6ull.dtsi中有者三个节点表示imx6ull的pin引脚：

分别是iomuxc，iomuxc-gpr，iomuxc-snvs节点，可以在这三个节点下添加GPIO节点信息：

iomuxc: iomuxc@020e0000 {
compatible = "fsl,imx6ul-iomuxc";
reg = <0x020e0000 0x4000>;
};
 
gpr: iomuxc-gpr@020e4000 {
compatible = "fsl,imx6ul-iomuxc-gpr",
"fsl,imx6q-iomuxc-gpr", "syscon";
reg = <0x020e4000 0x4000>;
};
 
iomuxc_snvs: iomuxc-snvs@02290000 {
compatible = "fsl,imx6ull-iomuxc-snvs";
reg = <0x02290000 0x10000>;
};

2.引脚定义解析

开发板中MX6UL_PAD_UART1_RTS_B__GPIO1_IO19的定义如下：


#define MX6UL_PAD_UART1_RTS_B__GPIO1_IO19 0x0090 0x031C 0x0000 0x5 0x0


0x0090 0x031C 0x0000 0x5 0x0,这 5 个值的含义如下所示对应关系：
< 0x0090    0x031C    0x0000     0x5       0x0      >
< mux_reg   conf_reg  input_reg  mux_mode  input_val>

地址解析：

0x0090：mux_reg 寄存器偏移地址；dtsi中的 iomuxc 节点就是 IOMUXC 外设对应的节点，根据其 reg 属性可知 IOMUXC 外设寄存器起始地址为 0x020e0000 。因此
0x020e0000+0x0090=0x020e0090。

0x031C：conf_reg 寄存器偏移地址，和 mux_reg 一样，0x020e0000+0x031c=0x020e031c，这个就是寄存器 IOMUXC_SW_PAD_CTL_PAD_UART1_RTS_B 的地址。

0x0000：input_reg 寄存器偏移地址，有 input_reg 寄存器的外设需要配置 input_reg 寄存器。没有的话就不需要设置。

0x5 ： mux_reg 寄存器值，相当于设置IOMUXC_SW_MUX_CTL_PAD_UART1_RTS_B 寄存器为 0x5，也即是设置 UART1_RTS_B 这个 PIN 复用为 GPIO1_IO19。
0x0：input_reg 寄存器值，在这里无效。

注意上面没有config_reg的值，因此0x17059 就是他的值，此值由用户自行设置，通过此值来设置一个 IO 的上/下拉、驱动能力和速度等。

==========================

3.设备GPIO树节点

gpioled {
    #address-cells = <1>;
    #size-cells = <1>;
    compatible = "atkalpha-gpioled";
    pinctrl-names = "default";
    pinctrl-0 = <&pinctrl_led>;
    led-gpio = <&gpio1 3 GPIO_ACTIVE_LOW>;
    status = "okay";
};

设备树节点描述信息

inctrl-names：用来表示设备的状态，这里有1个，为默认状态（default),也可以有其他的状态，还可以自定义状态，比如state_100mhz：表示这个gpio运行为100mhz状态。

pinctrl-0：表示第0个状态对应于"default"状态，对应的引脚在pinctrl-0里面定义。

led-gpios：描述led使用到的IO引脚信息
“&gpio1”表示引脚所使用的 IO 属于 GPIO1 组，“19” 表示 GPIO1 组的第 19 号 IO，“GPIO_ACTIVE_LOW” 表示低电平有效，如果改为“GPIO_ACTIVE_HIGH”就表示高电平有效。

============================

4.gpio 子系统 API 函数

gpio_request 函数

gpio_request 函数用于申请一个 GPIO 管脚，在使用一个 GPIO 之前一定要使用 gpio_request进行申请，函数原型如下：

int gpio_request(unsigned gpio, const char *label)

@gpio:要申请的 gpio 标号，使用 of_get_named_gpio 函数从设备树获取指定 GPIO 属性信
息，此函数会返回这个 GPIO 的标号。
@label：给 gpio 设置个名字。

gpio_free 函数

如果不使用某个 GPIO 了，那么就可以调用进行释放。

void gpio_free(unsigned gpio)
@gpio：要释放的 gpio 标号。

gpio_direction_input 函数

用于设置某个 GPIO 为输入:

int gpio_direction_input(unsigned gpio)
gpio：要设置为输入的 GPIO 标号。
返回值：0，设置成功；负值，设置失败。

gpio_direction_output 函数

用于设置某个 GPIO 为输出，并且设置默认输出值

int gpio_direction_output(unsigned gpio, int value)
gpio：要设置为输出的 GPIO 标号。
value：GPIO 默认输出值。

gpio_get_value 函数

用于获取某个 GPIO 的值(0 或 1)，此函数是个宏

#define gpio_get_value __gpio_get_value
int __gpio_get_value(unsigned gpio)

gpio_set_value 函数

用于设置某个 GPIO 的值，此函数是个宏

#define gpio_set_value __gpio_set_value
void __gpio_set_value(unsigned gpio, int value)
@gpio：要设置的 GPIO 标号。
@value：要设置的值。

=========================

5.驱动代码编写：

#include <linux/module.h>
#include <linux/fs.h>
#include <linux/kernel.h>
#include <linux/init.h>
#include <linux/ide.h>
#include <linux/types.h>
#include <linux/uaccess.h>
#include <asm/io.h>
#include <linux/device.h>
#include <linux/cdev.h>
#include <linux/of.h>
#include <linux/of_address.h>
#include <linux/err.h>
#include <linux/of_gpio.h>
#include <linux/gpio.h>
 
#define GPIOLED_CNT      1
#define GPIOLED_NAME     "gpioled"
 
#define LED_ON      1
#define LED_OFF     0
 
 
 
/* gpioled设备结构体 */
typedef struct gpioled_dev{
    dev_t devid;                    /* 设备号   */
    int major;                      /* 主设备号 */
    int minor;                      /* 次设备号 */
    struct cdev cdev;               /* 字符设备 */
    struct class *class;            /* 类      */
    struct device *device;          /* 类的设备 */
    struct device_node *nd;         /* 节点 */
    int led_gpio;                   /* LED的gpio编号 */
}gpioled_dev;
gpioled_dev gpioled;
 
 
 
/* LED等控制函数 */
static int Led_Switch(unsigned char Led_Status)
{
 
    if(Led_Status == LED_ON){
        gpio_set_value(gpioled.led_gpio,0);
    }else if(Led_Status == LED_OFF){
        gpio_set_value(gpioled.led_gpio,1);
    }else{
        return -1;
    }
    return 0;
}
 
/* 打开驱动文件 */
static int gpioled_open (struct inode *Inode, struct file *File)
{
    File->private_data = &gpioled;   /* 设置私有数据 */
    return 0;
}
/* 关闭驱动文件 */
static int gpioled_release (struct inode *Inode, struct file *File)
{
 
    return 0;
}
/* 对驱动文件进行写操作 */
static ssize_t gpioled_write (struct file *File, const char __user *buf,
                            size_t Count, loff_t *Loff)
{
    int ret = 0;
    unsigned char databuf[1];
 
    ret = copy_from_user(databuf,buf,Count);
    if(ret < 0){
        return ret;
    }
 
    Led_Switch(databuf[0]);
    return 0;
}
 
/* 字符设备的文件操作集合 */
static const struct file_operations gpioled_opts = {
    .owner = THIS_MODULE,
    .open = gpioled_open,
    .release = gpioled_release,
    .write = gpioled_write,
};
 
/* 模块入口 */
static int __init gpioled_init(void)
{
    int ret = 0;
 
    /* 获取设备节点：gpioled */
    gpioled.nd = of_find_node_by_path("/gpioled");
    if(gpioled.nd == NULL){
        ret = -EINVAL;
        goto fail_nd;
    }
    /* 获取设备树中的gpio属性，得到LED所使用的GPIO编号 */
    gpioled.led_gpio = of_get_named_gpio(gpioled.nd,"led-gpio", 0);
    if(gpioled.led_gpio < 0){
        ret = -EINVAL;
        goto fail_nd;
    }
    printk("led-gpio num = %d\r\n",gpioled.led_gpio);
 
    /* 申请GPIO */
    ret = gpio_request(gpioled.led_gpio, "led-gpio");
    if(ret){
        goto fail_nd;
    }
 
    /* 将LED的GPIO设置为输出，默认关闭LED灯（低电平点亮） */
    ret = gpio_direction_output(gpioled.led_gpio, 0);
    if(ret < 0){
        goto fail_gpio;
    }
 
    /* 注册字符设备 */
    /* 1、注册设备号 */
    gpioled.major = 0;
    if(gpioled.major){               /* 指定了设备号 */
        gpioled.devid = MKDEV(gpioled.major,0);
        ret = register_chrdev_region(gpioled.devid, GPIOLED_CNT, GPIOLED_NAME);
    }else{                          /* 没有指定设备号 */
        ret = alloc_chrdev_region(&gpioled.devid, 0, GPIOLED_CNT, GPIOLED_NAME);
        gpioled.major = MAJOR(gpioled.devid);
        gpioled.minor = MINOR(gpioled.devid);
        
    }
    if(ret < 0){                    /* 注册设备号失败 */
        goto fail_devid;
    }
    printk("major=%d,minor=%d\r\n",gpioled.major,gpioled.minor);
 
    /* 2、注册字符设备 */
    gpioled.cdev.owner = THIS_MODULE;
    cdev_init(&gpioled.cdev, &gpioled_opts);               /* 初始化 */
    ret = cdev_add(&gpioled.cdev, gpioled.devid, GPIOLED_CNT);
    if(ret < 0){
        goto fail_cdev;
    }
 
    /* 自动添加节点 */
    /* 1、添加类 */
    gpioled.class = class_create(THIS_MODULE,GPIOLED_NAME);
    if(IS_ERR(gpioled.class)){
        ret = PTR_ERR(gpioled.class);
        goto fail_class;
    }
    /* 2、添加类的设备 */
    gpioled.device = device_create(gpioled.class, NULL,gpioled.devid, NULL, GPIOLED_NAME);
    if(IS_ERR(gpioled.device)){
        ret = PTR_ERR(gpioled.device);
        goto fail_device;
    }
 
 
    return 0;
 
fail_device:
    class_destroy(gpioled.class);
fail_class:
    cdev_del(&gpioled.cdev);
fail_cdev:
    unregister_chrdev_region(gpioled.devid,GPIOLED_CNT);
fail_devid:
fail_gpio:
    gpio_free(gpioled.led_gpio);
fail_nd:
    return ret;
}
 
/* 模块出口 */
static void __exit gpioled_exit(void)
{
    /* 关灯 */
    Led_Switch(LED_OFF);
    
    /* gpio释放 */
    gpio_free(gpioled.led_gpio);
 
    /* 删除设备 */
    cdev_del(&gpioled.cdev);
    /* 注销设备号 */
    unregister_chrdev_region(gpioled.devid,GPIOLED_CNT);
    printk("gpioled_exit\r\n");
 
    /* 销毁类的设备 */
    device_destroy(gpioled.class,gpioled.devid);
    /* 销毁类 */
    class_destroy(gpioled.class);
 
}
 
/* 注册模块入口和出口函数 */
module_init(gpioled_init);
module_exit(gpioled_exit);
 
MODULE_LICENSE("GPL");
MODULE_AUTHOR("ZhangXueGuo");

原文地址：https://blog.csdn.net/weixin_44651073/article/details/142852193

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

上一篇：怎样才可以快速加入大量的微信群？
下一篇：Python 基于 Bert 的中文情歌分析，多分类中文情感分析

开发指南072-图片热点
/处理跳转： area.getAttribute('href');平台支持使用图像导航界面，例如展示如下一张图，用户点击对应位置触发对应动作。热点数据通过后台接口获取（注意处理权限，没有权限的热点不生
阅读更多2024-10-13
使用机器学习边缘设备的快速目标检测
这项机器学习研究探讨了一种低成本的边缘设备，该设备与具有计算机视觉功能的嵌入式系统集成，以提高目标检测和分类的推理时间和精度。研究的主要目标是减少推理时间并降低功耗，以支持一个竞技型类人机器人的嵌入式
阅读更多2024-10-13
【Windows】【DevOps】Windows Server 2022 安装ansible，基于powershell实现远程自动化运维部署入门到放弃！
文件URL：https://www.python.org/ftp/python/3.13.0/python-3.13.0-amd64.exe。直接拿linux主机测试ansible连接windows
阅读更多2024-10-13
C# 中循环的应用说明
一循环的概念说明二、循环类型三、循环控制语句四、无限循环
阅读更多2024-10-13
Linux `vmstat` 命令详解
vmstat（Virtual Memory Statistics）是 Linux 系统中的一个监控工具，用于报告系统的虚拟内存、进程、CPU 活动等信息。它能帮助用户了解系统的整体性能状况，尤其是内存
阅读更多2024-10-13
Linux下多任务编程（网络编程2）
本文介绍解决accpet和recv相互阻塞的问题，可以用多线程并发外也可以用epoll I/O多路复用的方式解决。
阅读更多2024-10-13
[单master节点k8s部署]37.微服务（一)springCloud 微服务
微服务架构的一个重要特点是，它与开发中使用的具体或无关。每个微服务都可以使用最适合其功能需求的语言或技术来实现。例如，一个微服务可以用Java编写，另一个微服务可以用Python、Go、Node.js
阅读更多2024-10-13
Zynq(3)使用外设MIO/EMIO
使用MIO/EMIO实现流水灯，着重介绍Zynq IP核的配置，解读vitis中的c语言程序，介绍MIO与EMIO的区别。
阅读更多2024-10-13
笔试算法总结
思路很简单，但是当时做题提交的时候，通过率总是18%。不知道为啥，后面我改成了Long类型，然后就通过了全部用例。（易错1：第一次提交没考虑0的情况）使用 StringBuilder 模拟栈的行为，通
阅读更多2024-10-13
快速学习一个算法，Transformer模型架构
它的主要思想是在同一时间通过多个独立的注意力头（Attention Head）来关注序列中不同部分的信息，然后将这些信息综合起来，生成更丰富的表示。自注意力机制的目的是对输入序列中的每个元素计算一个输
阅读更多2024-10-13