设备树pinctrl子系统

news/2024/10/11 17:05:25/

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 0x00x0090 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");


http://www.ppmy.cn/news/1537539.html

相关文章

Javascript Object.assgin()详解以及深浅拷贝

Object.assign() 方法是 JavaScript 中用于将所有可枚举属性的值从一个或多个源对象复制到目标对象的方法。它将返回目标对象。这是一种浅拷贝&#xff0c;也就是说&#xff0c;如果源对象中的属性是一个对象或数组&#xff0c;那么这个属性的引用将被复制&#xff0c;而不是对…

uni-app 实现APP版本更新的深度解析

版本更新是保持应用活力、修复漏洞、增强功能的重要手段。对于使用uni-app框架开发的跨平台应用而言&#xff0c;实现版本更新功能同样重要。本文将详细解析如何在uni-app项目中通过结合uni.request网络请求和plus.runtime API来实现应用的版本更新功能&#xff0c;并重点解析文…

【S32K3 RTD LLD篇5】K344 ADC SW+HW trigger

【S32K3 RTD LLD篇5】K344 ADC SWHW trigger 一&#xff0c;文档简介二&#xff0c;ADC SW HW 触发2.1 软硬件平台2.2 SWADC 软件触发2.3 SWBCTUADC 软件BCTU触发2.4 PITTRIGMUXADC 硬件PIT TRIGUMX触发2.5 EMIOSBCTUHWADC硬件EMIOS BCTU触发2.6 EMIOSBCTUHW LISTADC硬件EMIOS …

asp.net core Partial 分部视图、视图组件(core mvc 才支持)、视图、Razor组件 、razor pages

分部视图 》》》传参 》》两个东西换个名称&#xff0c;PartialView()>渲染视图>不带Layout 部分视图与普通视图没太大区别&#xff0c;它可以将重复使用的HTML内容结合起来&#xff0c;可以单独使用。 一般命名是在名称前面加下划线&#xff0c;放在/Views/Shared 目…

Spring Boot DevTools:如何关闭自动重启功能

目录 1. 什么是Spring Boot DevTools&#xff1f; 2. 为什么有时需要关闭自动重启&#xff1f; 3. 如何关闭自动重启&#xff1f; 方法 1: 修改 application.properties 文件 方法 2: 修改 application.yml 文件 方法 3: 使用环境变量 方法 4: 使用 Maven 配置 方法 5:…

深入理解栈(Stack)(纯小白进)

目录&#xff1a; 一、栈是什么&#xff1f;1. 栈的概念2.栈的结构选择 二、栈的实现1. 栈结构体的定义2. 栈的初始化3. 栈的销毁4. 入栈5.出栈6. 取栈顶元素7. 栈中元素的个数8. 判断栈是否为空 总结 一、栈是什么&#xff1f; 1. 栈的概念 栈&#xff08;Stack&#xff09;…

第七章 常见攻击事件分析--钓鱼邮件

简介 请勿在本机运行恶意文件样本 请勿在本机运行恶意文件样本 请勿在本机运行恶意文件样本 小张的公司最近遭到了钓鱼邮件攻击&#xff0c;多名员工的终端被控制做为跳板攻击了内网系统&#xff0c;请对钓鱼邮件样本和内网被攻陷的系统进行溯源分析&#xff0c;请根据小张备…

LeetCode Hot100 | Day1 | 二叉树:二叉树的直径

LeetCode Hot100 | Day1 | 二叉树&#xff1a;二叉树的直径 主要学习内容&#xff1a; 二叉树深度求法 深度的 leftright1 得到的是从根结点到叶子结点的节点数量 543.二叉树的直径 [543. 二叉树的直径 - 力扣&#xff08;LeetCode&#xff09;](https://leetcode.cn/prob…