6.3 虚拟pinctrl驱动

已于 2023-08-23 21:12:19 修改
阅读量77 收藏
点赞数
分类专栏： linux驱动开发 文章标签： linux 驱动开发
于 2023-08-02 21:26:40 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/lf282481431/article/details/132071188
版权

Pinctrl子系统主要有三大作用，分别是引脚枚举与命名（获取单个引脚或引脚组、设备树解析等）、引脚复用功能配置（比如用作GPIO、I2C或其他功能）、引脚电气特性配置（比如上拉、下拉、open drain、驱动强度等）

驱动代码编写

实验程序是一个虚拟的pinctrl控制器，它一共有6个引脚，每个引脚分别有gpio、af0~af15、analog、reserved等复用功能，在程序中将这6个引脚分别作为一个引脚组（即每个组一个引脚），另外程序还用到了/drivers/pinctrl目录下core.h文件，因为此文件未包含在内核编译头文件路径中，这里采用将此头文件复制到虚拟驱动实在目录方案。

设备树编写

设备树包括两个部分，分别是虚拟pinctr控制器l的节点和使用pinctrl的虚拟设备节点

//在顶层设备树的跟节点中加入如下内容
	//虚拟pinctrl的节点
	virtual_pinctrl {
		compatible = "atk,virtual_pinctrl";
	
		//描述设备引脚的节点，节点内容通过dt_node_to_map解析到pinctrl_map中
		pinctrl_i2c: i2cgrp {
			functions = "af1", "af5";
			groups = "pin0", "pin1";
			configs = <0x1122 0x3344>;
		};
	};
	
	//使用pinctrl的虚拟设备
	virtual_i2c {
		compatible = "atk,virtual_i2c";
		pinctrl-names = "default";
		pinctrl-0 = <&pinctrl_i2c>;
	};
//用make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabihf- dtbs -j8编译设备树
//用新的.dtb文件启动系统

驱动代码编写

编写一个pinctrl驱动主要包括以下步骤

  1. 分配一个pinctrl_desc
  2. 设置pinctrl_desc的名字等参数
  3. 实现对单个引脚的描述，主要实现pinctrl_desc中pins和npins部分内容
  4. 实现引脚组获取、设备树解析的功能，主要实现pinctrl_desc中pctlops部分内容
  5. 实现引脚电气特性配置相关功能，主要实现pinctrl_desc中confops部分内容
  6. 实现引脚复用功能配置相关功能，主要实现pinctrl_desc中pmxops部分内容
  7. 使用pinctrl_desc在系统分配并注册pinctrl_dev
#include <linux/clk.h>
#include <linux/gpio/driver.h>
#include <linux/hwspinlock.h>
#include <linux/io.h>
#include <linux/irq.h>
#include <linux/mfd/syscon.h>
#include <linux/module.h>
#include <linux/of.h>
#include <linux/of_address.h>
#include <linux/of_device.h>
#include <linux/of_irq.h>
#include <linux/pinctrl/consumer.h>
#include <linux/pinctrl/machine.h>
#include <linux/pinctrl/pinconf.h>
#include <linux/pinctrl/pinconf-generic.h>
#include <linux/pinctrl/pinctrl.h>
#include <linux/pinctrl/pinmux.h>
#include <linux/platform_device.h>
#include <linux/regmap.h>
#include <linux/reset.h>
#include <linux/slab.h>

#include "core.h"

/* 引脚支持的复用功能列表 */
static const char * const pin_functions[] = {
   "gpio", "af0", "af1",
   "af2", "af3", "af4",
   "af5", "af6", "af7",
   "af8", "af9", "af10",
   "af11", "af12", "af13",
   "af14", "af15", "analog",
   "reserved",
};

/* 引脚列表 */
static const struct pinctrl_pin_desc pins_desc[] = {
   {0, "pin0", NULL},
   {1, "pin1", NULL},
   {2, "pin2", NULL},
   {3, "pin3", NULL},
   {4, "pin4", NULL},
   {5, "pin5", NULL},
};

/* 引脚组，将每个引脚单独作为一个组 */
const char *pin_groups[] = {pins_desc[0].name, pins_desc[1].name, pins_desc[2].name, pins_desc[3].name, pins_desc[4].name, pins_desc[5].name};

/* 缓存引脚电气特性配置 */
unsigned long pin_configs[ARRAY_SIZE(pins_desc)] = {0};
/* 缓存引脚复用功能配置 */
unsigned long pin_mux[ARRAY_SIZE(pins_desc)] = {0};

/* 获取总共多少组，将一个引脚作为一个组 */
static int virtual_get_groups_count(struct pinctrl_dev *pctldev)
{
   return ARRAY_SIZE(pins_desc);
}

/* 获取每某一组的名称，组名与引脚名相同 */
static const char *virtual_get_group_name(struct pinctrl_dev *pctldev, unsigned group)
{
   if (group >= ARRAY_SIZE(pins_desc))
   	return NULL;

   //每个引脚都作为一个组
   return pins_desc[group].name;
}

/* 获取某一组的所有引脚 */
static int virtual_get_group_pins(struct pinctrl_dev *pctldev, unsigned group, const unsigned **pins, unsigned *npins)
{
   if (group >= ARRAY_SIZE(pins_desc))
   	return -EINVAL;

   //每个引脚都作为一个组
   *pins = &pins_desc[group].number;
   *npins = 1;

   return 0;
}

/* 解析设备树内容为pinctrl_map列表 */
static int virtual_dt_node_to_map(struct pinctrl_dev *pctldev, struct device_node *np, struct pinctrl_map **map, unsigned *num_maps)
{
   int i;
   int num_groups;
   int num_functions;
   u32 config;
   char *buffer;
   const char *group;
   const char *function;
   unsigned long *configs;
   struct pinctrl_map *pctl_map;

   /* 获取设备树中引脚组数组的长度，即此节点描述了多少个引脚 */
   for(num_groups=0; ; num_groups++)
   {
   	if(of_property_read_string_index(np, "groups", num_groups, &group) < 0)
   		break;
   }
   /* 获取设备树中复用功能组数组的长度 */
   for(num_functions=0; ; num_functions++)
   {
   	if(of_property_read_string_index(np, "functions", num_functions, &function) < 0)
   		break;
   }
   /* 引脚数数组长度和复用功能数组长度必须相等，即每个引脚都对应一个复用功能 */
   if((num_groups != num_functions) || (num_groups == 0))
   {
   	printk("device tree error\r\n");
   	return -EINVAL;
   }

   /* 分配pinctrl_map和以及存储配置参数的内存，每个（组）引脚2个pinctrl_map加4byte配置字（分别用于存储配置复用功能配置和电气特性配置），pinctrl_map位于前面部分空间 */
   buffer = kmalloc((sizeof(struct pinctrl_map) * num_groups * 2) + (num_groups * sizeof(unsigned long)), GFP_KERNEL);
   if(!buffer) {
   	printk("alloc pinctrl_map failed\r\n");
   	return -ENOMEM;
   }

   /* 偏移到pinctrl_map地址 */
   pctl_map = (struct pinctrl_map*)buffer;
   /* 偏移到配置字地址 */
   configs = (unsigned long*)(buffer + sizeof(struct pinctrl_map) * num_groups * 2);

   for(i=0; i<num_groups; i++)
   {
   	//获取引脚组名称
   	of_property_read_string_index(np, "groups", i, &group);
   	//获取引脚组的复用功能
   	of_property_read_string_index(np, "functions", i, &function);
   	//获取引脚组的配置参数
   	if(of_property_read_u32_index(np, "configs", i, &config) == 0)
   		configs[i] = config;
   	else
   		configs[i] = 0x9988;

   	//复用功能配置的pctl_map
   	pctl_map[i*2].type = PIN_MAP_TYPE_MUX_GROUP;
   	pctl_map[i*2].data.mux.function = function;
   	pctl_map[i*2].data.mux.group = group;

   	//电气特性配置的pctl_map
   	pctl_map[i*2+1].type = PIN_MAP_TYPE_CONFIGS_GROUP;
   	pctl_map[i*2+1].data.configs.group_or_pin = group;
   	pctl_map[i*2+1].data.configs.num_configs = 1;
   	pctl_map[i*2+1].data.configs.configs = &configs[i];
   }

   //pctl_map地址和数量
   *map = pctl_map;
   *num_maps = num_groups * 2;

   return 0;
}

/* 释放virtual_dt_node_to_map中分配的资源 */
static void virtual_dt_free_map(struct pinctrl_dev *pctldev, struct pinctrl_map *map, unsigned num_maps)
{
   kfree(map);
}

/* 获取引脚组的引脚和处理设备树操的作函数集合 */
static const struct pinctrl_ops virtual_ops = {
   .get_groups_count = virtual_get_groups_count,
   .get_group_name = virtual_get_group_name,
   .get_group_pins = virtual_get_group_pins,
   .dt_node_to_map = virtual_dt_node_to_map,
   .dt_free_map = virtual_dt_free_map,
};

/* 获取引脚配置 */
static int virtual_pconf_get(struct pinctrl_dev *pctldev, unsigned pin, unsigned long *config)
{
   if(pin >= ARRAY_SIZE(pin_configs))
   	return -EINVAL;

   *config = pin_configs[pin];

   return 0;
}

/* 配置引脚 */
static int virtual_pconf_set(struct pinctrl_dev *pctldev, unsigned pin, unsigned long *configs, unsigned num_configs)
{
   if((num_configs != 1) || (pin >= ARRAY_SIZE(pin_configs)))
   	return -EINVAL;

   pin_configs[pin] = *configs;
   printk("pin config %s as 0x%lx\n", pctldev->desc->pins[pin].name, *configs);

   return 0;
}

/* 获取引脚组配置 */
static int virtual_pconf_group_get(struct pinctrl_dev *pctldev, unsigned group, unsigned long *config)
{
   if(group >= ARRAY_SIZE(pin_configs))
   	return -EINVAL;

   //因为一个引脚对应一个引脚组，所以引脚的配置与引脚组的配置一样
   *config = pin_configs[group];

   return 0;
}

/* 配置引脚组 */
static int virtual_pconf_group_set(struct pinctrl_dev *pctldev, unsigned group, unsigned long *configs, unsigned num_configs)
{
   if((num_configs != 1) || (group >= ARRAY_SIZE(pin_configs)))
   	return -EINVAL;

   pin_configs[group] = *configs;
   printk("group config %s as 0x%lx\n", pctldev->desc->pins[group].name, *configs);

   return 0;
}

static void virtual_pconf_dbg_show(struct pinctrl_dev *pctldev, struct seq_file *s, unsigned pin)
{
   if(pin >= ARRAY_SIZE(pin_configs))
   	return ;

   seq_printf(s, "0x%lx", pin_configs[pin]);
}

static void virtual_pconf_group_dbg_show(struct pinctrl_dev *pctldev, struct seq_file *s, unsigned group)
{
   if(group >= ARRAY_SIZE(pin_configs))
   	return ;

   seq_printf(s, "0x%lx", pin_configs[group]);
}

/* 引脚配置的操作函数集合 */
static const struct pinconf_ops virtual_pconf_ops = {
   .pin_config_get = virtual_pconf_get,
   .pin_config_set = virtual_pconf_set,
   .pin_config_group_get = virtual_pconf_group_get,
   .pin_config_group_set = virtual_pconf_group_set,
   .pin_config_dbg_show = virtual_pconf_dbg_show,
   .pin_config_group_dbg_show = virtual_pconf_group_dbg_show,
};

/* 获取共计多少种复用功能 */
static int virtual_pmx_get_funcs_cnt(struct pinctrl_dev *pctldev)
{
   return ARRAY_SIZE(pin_functions);
}

/* 获取某种复用功能的名称 */
static const char *virtual_pmx_get_func_name(struct pinctrl_dev *pctldev, unsigned function)
{
   if(function >= ARRAY_SIZE(pin_functions))
   	return NULL;

   return pin_functions[function];
}

/* 获取支持某复用功能的引脚组 */
static int virtual_pmx_get_func_groups(struct pinctrl_dev *pctldev, unsigned function, const char * const **groups, unsigned * const num_groups)
{
   if(function >= ARRAY_SIZE(pin_functions))
   	return -EINVAL;

   //所有引脚都支持相同的复用功能
   *groups = pin_groups;
   *num_groups = ARRAY_SIZE(pin_groups);

   return 0;
}

/* 设置引脚组的复用功能 */
static int virtual_pmx_set_mux(struct pinctrl_dev *pctldev, unsigned function, unsigned group)
{
   if((group >= ARRAY_SIZE(pin_mux)) || (function >= ARRAY_SIZE(pin_functions)))
   	return -EINVAL;

   pin_mux[group] = function;
   printk("group mux %s as 0x%x\n", pctldev->desc->pins[group].name, function);

   return 0;
}

/* 引脚复用功能选择和GPIO控制相关的操作函数集合 */
static const struct pinmux_ops virtual_pmx_ops = {
   .get_functions_count = virtual_pmx_get_funcs_cnt,
   .get_function_name = virtual_pmx_get_func_name,
   .get_function_groups = virtual_pmx_get_func_groups,
   .set_mux = virtual_pmx_set_mux,
   .strict = true,
};

//设备和驱动匹配成功执行
static int virtual_probe(struct platform_device *pdev)
{
   struct pinctrl_desc *pctl_desc;
   struct pinctrl_dev *pctl_dev;

   printk("%s\n", __FUNCTION__);

   /* a. 分配pinctrl_desc */
   pctl_desc = devm_kzalloc(&pdev->dev, sizeof(struct pinctrl_desc), GFP_KERNEL);
   if(!pctl_desc)
   {
   	printk("alloc pctl_desc failed\r\n");
   	return -ENOMEM;
   }

   /* b. 设置pinctrl_desc */
   /* b.1 设置名称和所属模块 */
   pctl_desc->name = dev_name(&pdev->dev);
   pctl_desc->owner = THIS_MODULE;
   /* b.2 描述单个引脚 */
   pctl_desc->pins = pins_desc;
   pctl_desc->npins = ARRAY_SIZE(pins_desc);
   /* b.3 绑定用于获取引脚组的引脚和处理设备树操的作函数集合 */
   pctl_desc->pctlops = &virtual_ops;
   /* b.5 绑定引脚配置的操作函数集合 */
   pctl_desc->confops = &virtual_pconf_ops;
   /* b.4 绑定引脚复用功能选择和GPIO控制相关的操作函数集合 */
   pctl_desc->pmxops = &virtual_pmx_ops;
   /* c. 注册pinctrl_desc，devm表示模块卸载时自动释放 */
   pctl_dev = devm_pinctrl_register(&pdev->dev, pctl_desc, NULL);
   if (IS_ERR(pctl_dev))
   {
   	printk("Failed pinctrl register\n");
   	return PTR_ERR(pctl_dev);
   }

   return 0;
}

//设备或驱动卸载时执行
static int virtual_remove(struct platform_device *pdev)
{
   printk("%s\n", __FUNCTION__);
   return 0;
}

/* 匹配列表，用于设备树和平台驱动匹配 */
static const struct of_device_id virtual_of_match[] = {
   {.compatible = "atk,virtual_pinctrl"},
   { /* Sentinel */ }
};
/* 平台驱动 */
static struct platform_driver virtual_drv = {
   .driver = {
   	.name = "virtual_pinctrl",
   	.owner = THIS_MODULE,
   	.pm = NULL,
   	.of_match_table = virtual_of_match,
   },
   .probe = virtual_probe,
   .remove = virtual_remove,
};
static int __init virtual_drv_init(void)
{
   int result;

   printk("%s\r\n", __FUNCTION__);

   //注册平台驱动
   result = platform_driver_register(&virtual_drv);
   if(result != 0)
   	printk("add virtual driver failed\r\n");
   return result;
}

static void __exit virtual_drv_exit(void)
{
   printk("%s\r\n", __FUNCTION__);

   //注销平台驱动
   platform_driver_unregister(&virtual_drv);
}

module_init(virtual_drv_init);
module_exit(virtual_drv_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("CSDN");
MODULE_DESCRIPTION("virtual_drv");

驱动测试程序

驱动测试程序是一个platform driver它没有实现如何具体的功能，仅仅是在设备树节点中引用了虚拟pinctrl的引脚描述节点

#include <linux/module.h>
#include <linux/err.h>
#include <linux/init.h>
#include <linux/io.h>
#include <linux/mfd/syscon.h>
#include <linux/of.h>
#include <linux/of_device.h>
#include <linux/of_address.h>
#include <linux/pinctrl/machine.h>
#include <linux/pinctrl/pinconf.h>
#include <linux/pinctrl/pinctrl.h>
#include <linux/pinctrl/pinmux.h>
#include <linux/slab.h>
#include <linux/regmap.h>
static int virtual_client_probe(struct platform_device *pdev)
{
	printk("%s\n", __FUNCTION__);
	return 0;
}
static int virtual_client_remove(struct platform_device *pdev)
{
	printk("%s\n", __FUNCTION__);
	return 0;
}

static const struct of_device_id virtual_client_of_match[] = {
	{ .compatible = "atk,virtual_i2c", },
	{ },
};

static struct platform_driver virtual_client_driver = {
	.probe		= virtual_client_probe,
	.remove		= virtual_client_remove,
	.driver		= {
		.name	= "atk,virtual_i2c",
		.of_match_table = of_match_ptr(virtual_client_of_match),
	}
};


/* 1. 入口函数 */
static int __init virtual_client_init(void)
{
	printk("%s\n", __FUNCTION__);
	/* 1.1 注册一个platform_driver */
	return platform_driver_register(&virtual_client_driver);
}


/* 2. 出口函数 */
static void __exit virtual_client_exit(void)
{
	printk("%s\n", __FUNCTION__);
	/* 2.1 反注册platform_driver */
	platform_driver_unregister(&virtual_client_driver);
}

module_init(virtual_client_init);
module_exit(virtual_client_exit);

MODULE_LICENSE("GPL");

上机测试

  1. 修改设备树，然后用新的设备树启动目标板
  2. 从这里下载代码。然后进行编译，并拷贝到目标板root目录
  3. 执行命令insmod virtual_pinctrl.ko加载虚拟pinctrl控制器驱动
    在这里插入图片描述
  4. 执行命令insmod virtual_client.ko加载使用虚拟pinctrl控制器的platform driver，可以看到在执行probe函数之前引脚电气特性配置函数和复用功能配置函数被调用
    5.
lf282481431
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
wacomTablet手绘板驱动程序6.3
12-28
wacomTablet手绘板驱动程序6.3
mariadb ,qt6.3 64位驱动
04-23
MariaDB和Qt 6.3 64位驱动程序是两个关键组件，它们在开发数据库应用程序时发挥着重要作用。MariaDB是一种开源的关系型数据库管理系统，它由MySQL的原始开发团队创建，旨在提供更高的性能、安全性和稳定性。而Qt 6.3...
VDA 6.3 中文图表下载
12-15
VDA 6.3 是德国汽车工业协会（Verband der Automobilindustrie, VDA）制定的质量审核标准，主要用于过程质量评估。这个标准在汽车行业内广泛应用，旨在确保产品的高质量和生产过程的优化。以下是对VDA 6.3中文图表...
虚拟磁盘驱动程序设计报告
12-13
**6.3 创建虚拟光驱** - 介绍了创建虚拟光驱的方法。 - 显示了虚拟光驱的挂载状态及其对.iso文件的支持情况。 **6.4 卸载虚拟光驱** - 描述了卸载虚拟光驱的步骤。 - 展示了卸载后系统的状态。 #### 五、心得体会 ...
76DRVCN V6.3（打印机驱动）.
12-03
《76DRVCN V6.3 打印机驱动详解》 在计算机技术领域，驱动程序是连接硬件设备与操作系统的关键桥梁。打印机驱动作为其中的一员，起着至关重要的作用，它使得操作系统能够识别并控制打印机，从而实现文档的打印功能...
Linux：基础命令学习
qq_55038440的博客
07-20 1129
实例：-F根据文件类型在列出的文件名称后加一符号。实例： -R 递归显示目录中的所有文件和子目录。. 开头的隐藏文件也会列出。可执行文件则加 "*"，用于显示目录文件信息。
GNU/Linux - Bazaar版本管理工具
guoqx的专栏
07-24 297
根据 Jelmer Vernooij 的说法，Canonical 的 Bazaar 团队的成员在 2012 年初被分配到不同的任务，他本人在7年来为该项目做出贡献后，于2012年底停止了对 Bazaar 的贡献。同样，Bugzilla项目在2014 3月从 Bazaar 改为使用 git，其中一个原因是 Bazaar 几乎已被放弃的印象：“每个月可能有 2-3 次向主干提交。并用来进行Ubuntu项目的版本控制。Bazaar 可以由一个开发本地内容的多个分支的开发人员使用，也可以由跨网络协作的团队使用。
【Linux服务器Java环境搭建】010在linux中安装Redis，以及对Redis的配置与远程连接
liuzhenhe1988的专栏
07-19 1069
好久没有更新博客了，今天下了班回到家，看到电脑桌上尘封已久的《Spring Boot应用开发实战》，翻开目录想起来之前写的系列【Linux服务器Java环境搭建】还未完结，那就继续吧，今天主要是按linux服务器中安装和配置redis。本系列其他文章，请查看系列【Linux服务器Java环境搭建】
linux学习笔记整理: 关于linux:Shell脚本 2024/7/20；
gzx233的博客
07-20 916
Shell脚本的使用
Linux 注意事项
m0_74012211的博客
07-19 613
Linux 与 Windows 是两个相互独立的操作系统，两者有较大差距
【Linux】-----权限详解
m0_73470633的博客
07-21 709
Linux权限详解,看这一篇就够了！！！！！！
【嵌入式开发 Linux 常用命令系列 7.7 -- find 和 sed 配合使用介绍】
最新发布
CodingCos的博客
07-24 295
命令将文件中所有"demo" 字符串替换为 “hello”
linux中使用docker安装mongodb
qq_56661788的博客
07-20 726
v /data/mongo/config/mongod.conf:/etc/mongod.conf：将主机上的/data/mongo/config/mongod.conf文件挂载到容器的/etc/mongod.conf位置，作为 MongoDB 的配置文件。-v /data/mongo/logs:/var/log/mongodb：将主机上的/data/mongo/logs目录挂载到容器的/var/log/mongodb位置，作为 MongoDB 的日志存储目录。登录阿里云，开通容器镜像服务，进入控制台。
Linux 之 awk命令详解
Aaadsda414114的博客
07-19 478
我们可以在awk脚本中定义自己的函数。之后我们掌握其各种功能可以大大提高我们处理结构化文本数据的效率。
linux 安装c语言编辑器
weixin_45631123的博客
07-20 230
在 Linux 系统中运行 C 语言程序有以下几个步骤:
linux字符设备驱动+fops应用测试程序
qq_39797956的博客
07-21 222
【代码】linux字符设备驱动+fops应用测试程序。
Linux 之 grep命令详解
Aaadsda414114的博客
07-19 478
grep命令是一个功能强大的文本搜索工具，掌握其各种选项和用法可以大大提高我们处理文本文件的效率。希望这篇文章能帮助你更好地理解和使用grep命令。
Linux知识点汇总
a1546464545454的博客
07-20 393
【代码】Linux知识点汇总。
Linux_实现TCP网络通信
安权_code的博客
07-24 595
在Linux下，实现传输层协议为TCP的套接字进行网络通信，网络层协议为IPv4，需要用到的接口如下：实现服务器的接口有（socket、bind、listen、accept、read、write），实现客户端的接口有（socket、connect、write、read）。 实现方式：因为网络通信的本质是进程间通信在云服务器上创建一个服务器进程和一个客户端进程，服务器进程先启动，然后让客户端链接到服务器上，至此客户端可以向服务器发送消息，并且服务器收到消息后可以给对方反馈信息。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值