• 零基础学Linux内核之设备驱动篇(8)_设备模型_概念篇


    零基础学Linux内核系列文章目录

    前置知识篇
    1. 进程
    2. 线程
    进程间通信篇
    1. IPC概述
    2. 信号
    3. 消息传递
    4. 同步
    5. 共享内存区
    编译相关篇
    1. GCC编译
    2. 静态链接与动态链接
    3. makefile入门基础
    设备驱动篇
    1. 设备驱动概述
    2. 内核模块_理论篇
    3. 内核模块_实验篇
    4. 字符设备_理论篇1
    5. 字符设备_理论篇2
    6. 字符设备_实验篇1
    7. 字符设备_实验篇2
    8. 设备模型


    一、前言

    本节主要介绍总线是如何将设备与驱动之间联系起来的,同时介绍了BUS_ATTR / DEVICE_ATTR / DRIVER_ATTR_RO几个较为特殊的将属性文件从内核导出至用户空间的宏定义,以供用户层进行查询(cat <–> show) / 修改(echo <–> store)。


    二、前置条件


    三、本文参考资料

    《 [野火]i.MX Linux开发实战指南》
    百度


    四、正文部分

    4.1 概述

    4.1.1 目的

    我们将硬件的信息都写进了驱动里了,根据某个硬件编写的驱动只要修改了一下引脚接口,这个驱动代码就得重新修改才能使用,
    这显然是不合理的,那有没有合适的解决方案呢?
    答案是肯定的,Linux引入了设备驱动模型分层的概念,
    将我们编写的驱动代码分成了两块:设备与驱动。
    设备负责提供硬件资源驱动代码负责去使用这些设备提供的硬件资源
    由总线将它们联系起来。这样子就构成以下图形中的关系。
    在这里插入图片描述
    有 设备 或是 驱动 注册时,会去总线匹配match名字,在匹配过程中会忽略掉那些已经有驱动匹配的设备,相同则回调总线的probe函数(最终会调用驱动提供的probe函数)
    sysfs文件系统用于把内核的设备驱动导出到用户空间, 用户便可通过访问sys目录及其下的文件,来查看甚至控制内核的一些驱动设备

    4.1.2 相关概念

    设备模型通过几个数据结构来反映当前系统中总线、设备以及驱动的工作状况,提出了以下几个重要概念:

    • 设备(device) :挂载在某个总线的物理设备;
    • 驱动(driver) :与特定设备相关的软件,负责初始化该设备以及提供一些操作该设备的操作方式;
    • 总线(bus) :负责管理挂载对应总线的设备以及驱动;
    • 类(class) :对于具有相同功能的设备,归结到一种类别,进行分类管理;
      在这里插入图片描述

    基本匹配步骤:

    1. match匹配
    2. probe获取设备资源
    3. remove移除
      在这里插入图片描述
      在总线上管理着两个链表,分别管理着设备和驱动
      当我们向系统注册一个驱动时,便会向驱动的管理链表插入我们的新驱动,
      同样当我们向系统注册一个设备时,便会向设备的管理链表插入我们的新设备。
      在插入的同时总线会执行一个bus_type结构体中match的方法对新插入的设备 / 驱动进行匹配
      (它们之间最简单的匹配方式则是对比名字,存在名字相同的设备/驱动便成功匹配)。
      匹配成功的时候会调用驱动device_driver结构体中probe方法(通常在probe中获取设备资源,具体的功能可由驱动编写人员自定义),
      并且在移除设备或驱动时,会调用device_driver结构体中remove方法

    sysfs文件系统用于把内核的设备驱动导出到用户空间, 用户便可通过访问sys目录及其下的文件,来查看甚至控制内核的一些驱动设备
    接下来对总线、驱动、设备进行进一步的了解了,具体了解如何使用代码来实现创建自己的总线并在自己的总线上创建设备及驱动。
    同时也可以将我们驱动的某个控制变量,导出到用户空间。

    4.1.2.1 总线bus

    总线是连接处理器和设备之间的桥梁,总线代表着同类设备需要共同遵守的工作时序,是连接处理器和设备之间的桥梁。
    我们接触到的设备大部分是依靠总线来进行通信的, 它们之间的物理连接如图所示,
    对于野火开发板而言,触摸芯片是依赖于I2C,鼠标、键盘等HID设备,则是依赖于USB。
    从功能上讲,这些设备都是将文字、字符、控制命令或采集的数据等信息输入到计算机。
    在这里插入图片描述
    总线驱动则负责实现总线的各种行为,其管理着两个链表,分别是添加到该总线的设备链表以及注册到该总线的驱动链表
    当你向总线添加(移除)一个设备(驱动)时,便会在对应的列表上添加新的节点,

    同时对挂载在该总线的驱动以及设备进行匹配,在匹配过程中会忽略掉那些已经有驱动匹配的设备
    在这里插入图片描述
    在内核中使用结构体bus_type来表示总线,如下所示:

    bus_type结构体(内核源码/include/linux/device.h)
    
    	struct bus_type {
    	
    		const char              *name;
    		
    		const struct attribute_group **bus_groups;
    		const struct attribute_group **dev_groups;
    		const struct attribute_group **drv_groups;
    		
    		/* 当向总线注册一个新的设备或者是新的驱动时,会调用该回调函数 */
    		int (*match)(struct device *dev, struct device_driver *drv);
    		
    		/* 总线上的设备发生添加、移除或者其它动作时,就会调用该函数,来通知驱动做出相应的对策 */
    		int (*uevent)(struct device *dev, struct kobj_uevent_env *env);
    		
    		/* 当总线将设备以及驱动相匹配之后,执行该回调函数,最终会调用驱动提供的probe函数 */
    		int (*probe)(struct device *dev);
    		
    		/* 当设备从总线移除时,调用该回调函数 */
    		int (*remove)(struct device *dev);
    		
    		/* 电源管理的相关函数,当总线进入睡眠模式时,会调用suspend回调函数;而resume回调函数则是在唤醒总线的状态下执行 */
    		int (*suspend)(struct device *dev, pm_message_t state);
    		int (*resume)(struct device *dev);
    		
    		/* 电源管理的结构体,存放了一系列跟总线电源管理有关的函数,与device_driver结构体中的pm_ops有关 */
    		const struct dev_pm_ops *pm;
    		
    		/* 该结构体用于存放特定的私有数据,其成员klist_devices和klist_drivers记录了挂载在该总线的设备和驱动 */
    		struct subsys_private *p;
    	
    	};
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33

    其中
    - name: 指定总线的名称,当新注册一种总线类型时,会在/sys/bus目录创建一个新的目录,目录名就是该参数的值
    - bus/drv/dev_groups: 分别表示驱动、设备以及总线的属性,这些属性可以是内部变量、字符串等等。
    –> 通常会在对应的/sys目录下在以文件的形式存在
    –> 驱动在目录/sys/bus/< bus-name >/driver/< driver-name >存放了设备的默认属性,设备则在目录/sys/bus/< bus-name >/devices/< driver-name > 中
    在这里插入图片描述
    –> 这些文件一般是可读写的,用户可以通过读写操作来获取和设置这些attribute的值
    - match: 主要负责判断是否有注册了的驱动适合新的设备,或者新的驱动能否驱动总线上已注册但没有驱动匹配的设备
    - probe: 当总线将设备以及驱动相匹配之后,执行该回调函数,最终会 调用驱动提供的probe函数

    在实际编写linux驱动模块时,Linux内核已经为我们写好了大部分总线驱动,正常情况下我们一般不会去注册一个新的总线
    内核中提供了bus_register函数来注册总线,以及bus_unregister函数来注销总线,其函数原型如下:

    • 注册/注销总线API(内核源码/drivers/base/bus.c)
      int bus_register(struct bus_type *bus);
      	参数: bus: bus_type类型的结构体指针
      	返回值:成功: 0 / 失败: 负数
      
      • 1
      • 2
      • 3
    • 注册/注销总线API(内核源码/drivers/base/bus.c)
      void bus_unregister(struct bus_type *bus);
      	参数: bus :bus_type类型的结构体指针
      	返回值: 无
      
      • 1
      • 2
      • 3

    当我们成功注册总线时,会在 /sys/bus/ 目录下创建一个新目录,目录名为我们新注册的总线名
    bus目录中包含了当前系统中已经注册了的所有总线,例如i2c,spi,platform等。
    我们看到每个总线目录都拥有两个子目录devices和drivers,分别记录着挂载在该总线的所有设备以及驱动。
    在这里插入图片描述

    4.1.2.2 设备devices

    驱动开发的过程中,我们最关心的莫过于设备以及对应的驱动了。
    我们编写驱动的目的,最终就是为了使设备可以正常工作。
    在Linux中,一切都是以文件的形式存在, 设备也不例外。
    /sys/devices目录记录了系统中所有设备,实际上在sys目录下所有设备文件最终都会指向该目录对应的设备文件
    此外还有另一个目录/sys/dev记录所有的设备节点,但实际上都是些链接文件,同样指向了devices目录下的文件。
    (即/sys/dev/xx --> /sys/devices/xxx)
    在这里插入图片描述

    在内核使用device结构体来描述我们的物理设备,如下所示,

    device结构体(内核源码/include/linux/device.h)
    	struct device {
    	
    		const char *init_name;
    		
    		/* 表示该设备的父对象,前面提到过,旧版本的设备之间没有任何关联,引入Linux设备模型之后,设备之间呈树状结构,便于管理各种设备 */
    		struct device           *parent;
    		
    		struct bus_type *bus;
    		
    		struct device_driver *driver;
    		
    		/* 特定设备的私有数据,通常定义在板级文件中 */
    		void            *platform_data;
    		
    		/* 同上,驱动层可通过dev_set/get_drvdata函数来获取该成员 */
    		void            *driver_data;
    		
    		/* 存放设备树中匹配的设备节点。当内核使能设备树,总线负责将驱动的of_match_table以及设备树的compatible属性进行比较之后,将匹配的节点保存到该变量 */
    		struct device_node      *of_node;
    		
    		/* dev_t类型变量,字符设备章节提及过,它是用于标识设备的设备号,该变量主要用于向/sys目录中导出对应的设备 */
    		dev_t                   devt;
    		
    		struct class            *class;
    		
    		/* 回调函数,当设备被注销时,会调用该函数 */
    		/* 如果我们没定义该函数时,移除设备时,会提示“Device ‘xxxx’ does not have a release() function, it is broken and must be fixed”的错误 */
    		void (*release)(struct device *dev);
    		
    		/* 指向struct attribute_group类型的指针,指定该设备的属性 */
    		const struct attribute_group **groups;  /* optional groups */
    		struct device_private   *p;
    	};
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34

    其中
    - init_name: 指定该设备的名称,总线匹配时,一般会根据比较名字,来进行配对
    - bus: 表示该设备依赖于哪个总线,当我们注册设备时,内核便会将该设备注册到对应的总线
    - class: 指向了该设备对应类,对于计算机而言,鼠标以及键盘都具有相同的功能,都归属于输入设备;我们可以在/sys/class目录下对应的类找到该设备,如input、leds、pwm等目录

    内核也提供相关的API来注册和注销设备,如下所示:

    • 内核注册/注销设备(内核源码/driver/base/core.c)
      int device_register(struct device *dev);
      	参数: dev :struct device结构体类型指针
      	返回值:成功: 0 / 失败: 负数
      
      • 1
      • 2
      • 3
    • 内核注册/注销设备(内核源码/driver/base/core.c)
      void device_unregister(struct device *dev);
      	参数: dev :struct device结构体类型指针
      
      • 1
      • 2

    当成功注册总线时,会在/sys/bus目录下创建对应总线的目录,该目录下有两个子目录,分别是drivers和devices,
    我们使用device_register注册的设备从属于某个总线时,该总线的devices目录下便会存在该设备文件

    4.1.2.3 驱动drivers

    设备能否正常工作,取决于驱动。
    驱动需要告诉内核, 自己可以驱动哪些设备,如何初始化设备。
    在内核中,使用device_driver结构体来描述我们的驱动,如下所示:

    device_driver结构体(内核源码/include/linux/device.h)
    
    	struct device_driver {
    		
    		const char              *name;
    		
    		struct bus_type         *bus;
    		
    		/* 表示该驱动的拥有者,一般设置为THIS_MODULE */
    		struct module           *owner;
    		const char              *mod_name;      /* used for built-in modules */
    		
    		/* 布尔量,用于指定是否通过sysfs导出bind与unbind文件,bind与unbind文件是驱动用于绑定/解绑关联的设备 */
    		bool suppress_bind_attrs;       /* disables bind/unbind via sysfs */
    		
    		/* 指定该驱动支持的设备类型。当内核使能设备树时,会利用该成员与设备树中的compatible属性进行比较 */
    		const struct of_device_id       *of_match_table;
    		const struct acpi_device_id     *acpi_match_table;
    		
    		int (*probe) (struct device *dev);
    		
    		/* 当设备从操作系统中拔出或者是系统重启时,会调用该回调函数 */
    		int (*remove) (struct device *dev);
    		
    		/* 指向struct attribute_group类型的指针,指定该驱动的属性 */
    		const struct attribute_group **groups;
    		struct driver_private *p;
    	
    	};
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29

    其中
    - name: 指定驱动名称,总线进行匹配时,利用该成员与设备名进行比较
    - bus: 表示该驱动依赖于哪个总线,内核需要保证在驱动执行之前,对应的总线能够正常工作
    - probe: 当驱动以及设备匹配后,会执行该回调函数,对设备进行初始化。通常的代码,都是以main函数开始执行的,但是**在内核的驱动代码,都是从probe函数开始的**

    内核提供了driver_register函数以及driver_unregister函数来注册/注销驱动,成功注册的驱动会记录在/sys/bus/ < bus > /drivers目录,函数原型如下所示:

    device_driver结构体(内核源码/include/linux/device.h)
    	int driver_register(struct device_driver *drv);
    		参数: drv :struct device_driver结构体类型指针
    		返回值:成功: 0 / 失败: 负数
    
    device_driver结构体(内核源码/include/linux/device.h)
    	void driver_unregister(struct device_driver *drv);
    		参数: drv :struct device_drive结构体类型指针
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    4.1.2.4 小结

    下图是总线关联上设备与驱动之后的数据结构关系图
    在这里插入图片描述
    大致注册流程如下
    在这里插入图片描述

    1. 系统启动之后会调用buses_init函数创建/sys/bus文件目录,这部分系统在开机时已经帮我们准备好了,
    2. 接下去就是通过总线注册函数bus_register进行总线注册,
    3. 注册完总线后在总线的目录下生成devices文件夹和drivers文件夹,
    4. 最后分别通过device_register以及driver_register函数注册相对应的设备和驱动。

     

    4.2 attribute属性文件

    /sys目录有各种子目录以及文件,
    当我们注册新的总线、设备或驱动时,内核会在对应的地方创建一个新的目录,目录名为各自结构体的name成员,
    每个子目录下的文件,都是内核导出到用户空间,用于控制我们的设备的。

    内核中以attribute结构体来描述/sys目录下的文件,如下所示:

    struct attribute结构体(内核源码/include/linux/sysfs.h)
    
    	struct attribute {
    		/* 指定文件的文件名 */
    		const char              *name;
    		
    		/* 指定文件的权限 */
    		umode_t                 mode;
    	};
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9

    bus_type、device、device_driver结构体中都包含了一种数据类型struct attribute_group,如下所示,
    它是多个attribute文件的集合, 利用它进行初始化,可以避免一个个注册attribute。

    struct attribute_group结构体(内核源码/include/linux/sysfs.h)
    
    	struct attribute_group {
    		const char              *name;
    		
    		umode_t                 (*is_visible)(struct kobject *, struct attribute *, int);
    		
    		struct attribute        **attrs;
    		
    		struct bin_attribute    **bin_attrs;
    	};
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11

    4.2.1 设备属性文件

    在开发单片机的时候,如果想要读取某个寄存器的值,你可能需要加入一些新的代码,并重新编译。
    但对于 Linux 内核来讲,每次都需要编译一遍源码, 实在太浪费时间和精力了。
    为此,Linux提供以下接口,来注册和注销一个设备属性文件
    我们可以通过这些接口 直接在用户层进行查询/修改 ,避免了重新编译内核的麻烦。

    设备属性文件接口(内核源码/include/linux/device.h)
    
    	struct device_attribute {
    		struct attribute        attr;
    		ssize_t (*show)(struct device *dev, struct device_attribute *attr,
    			char *buf);
    		ssize_t (*store)(struct device *dev, struct device_attribute *attr,
    			const char *buf, size_t count);
    	};
    	
    	/* 用于定义一个device_attribute类型的变量,##表示将##左右两边的标签拼接在一起,因此, 我们得到变量的名称应该是带有dev_attr_前缀的 */
    	/* 该宏定义需要传入四个参数_name,_mode,_show,_store,分别代表了文件名, 文件权限,show回调函数,store回调函数  */
    	/* 参数_mode的值,可以使用S_IRUSR、S_IWUSR、S_IXUSR等宏定义,更多选项可以查看读写文件章节关于文件权限的内容 */
    	#define DEVICE_ATTR(_name, _mode, _show, _store) \
    		struct device_attribute dev_attr_##_name = __ATTR(_name, _mode, _show, _store)
    		
    	/* 用于创建文件 */
    	/* 第一个参数表示设备,前面讲解device结构体时,其成员中有个bus_type变量, 用于指定设备挂载在某个总线上,并且会在总线的devices子目录创建一个属于该设备的目录 */
    	/* device参数可以理解为在哪个设备目录下,创建设备文件 */
    	/* 第二个参数则是我们自己定义的device_attribute类型变量 */
    	extern int device_create_file(struct device *device,
    			const struct device_attribute *entry);
    			
    	/* 用于删除文件,当我们的驱动注销时,对应目录以及文件都需要被移除。 其参数和device_create_file函数的参数是一样 */
    	extern void device_remove_file(struct device *dev,
    			const struct device_attribute *attr);
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26

    其中
    - DEVICE_ATTR: 用于定义一个device_attribute类型的变量,当我们 使用cat命令,来获取/sys目录下某个文件时,最终会执行show回调函数使用echo命令,则会执行store回调函数

    4.2.2 驱动属性文件

    驱动属性文件,和设备属性文件的作用是一样,唯一的区别在于函数参数的不同,函数接口如下:

    驱动属性文件接口(内核源码/include/linux/device.h)
    
    	struct driver_attribute {
    		struct attribute attr;
    		ssize_t (*show)(struct device_driver *driver, char *buf);
    		ssize_t (*store)(struct device_driver *driver, const char *buf,
    				size_t count);
    	};
    	
    	/* 用于定义一个driver_attribute类型的变量,带有driver_attr_的前缀,区别在于文件权限不同, RW后缀表示文件可读写,RO后缀表示文件仅可读,WO后缀表示文件仅可写 */
    	#define DRIVER_ATTR_RW(_name) \
    		struct driver_attribute driver_attr_##_name = __ATTR_RW(_name)
    	#define DRIVER_ATTR_RO(_name) \
    		struct driver_attribute driver_attr_##_name = __ATTR_RO(_name)
    	#define DRIVER_ATTR_WO(_name) \
    		struct driver_attribute driver_attr_##_name = __ATTR_WO(_name)
    
    	/* 用于创建和移除文件,使用driver_create_file函数, 会在/sys/bus//drivers//目录下创建文件 */
    	extern int __must_check driver_create_file(struct device_driver *driver,
    					const struct driver_attribute *attr);
    	extern void driver_remove_file(struct device_driver *driver,
    					const struct driver_attribute *attr);
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22

    其中
    - DRIVER_ATTR_RW: 用于定义一个driver_attribute类型的变量,带有driver_attr_的前缀,区别在于文件权限不同, RW后缀表示文件可读写,RO后缀表示文件仅可读,WO后缀表示文件仅可写
    - DRIVER_ATTR类型的宏定义没有参数来设置show和store回调函数,在写驱动代码时,只需要你提供xxx_store以及xxx_show这两个函数, 并确保两个函数的xxx和DRIVER_ATTR类型的宏定义中名字是一致的即可

    4.2.3 总线属性文件

    同样的,Linux也为总线通过了相应的函数接口,如下所示:

    总线属性文件接口(内核源码/include/linux/device.h)
    
    	struct bus_attribute {
    		struct attribute        attr;
    		ssize_t (*show)(struct bus_type *bus, char *buf);
    		ssize_t (*store)(struct bus_type *bus, const char *buf, size_t count);
    	};
    	
    	/* 用于定义一个bus_attribute变量 */
    	#define BUS_ATTR(_name, _mode, _show, _store)       \
    	        struct bus_attribute bus_attr_##_name = __ATTR(_name, _mode, _show, _store)
    	
    	/* 使用bus_create_file函数,会在/sys/bus/下创建对应的文件 */
    	extern int __must_check bus_create_file(struct bus_type *,
    	                    struct bus_attribute *);
    	
    	/* bus_remove_file则用于移除该文件 */
    	extern void bus_remove_file(struct bus_type *, struct bus_attribute *);
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18

     

    4.3 实验

    步骤

    1. 声明一个总线结构体并创建一个总线xbus,实现match方法,对设备和驱动进行匹配
    2. 声明一个设备结构体,挂载到我们的xbus总线中 ,实现release方法
    3. 声明一个驱动结构体,挂载到xbus总线,实现probe、remove方法
    4. 将总线、设备、驱动导出属性文件到用户空间。

    4.3.1 总线

    4.3.1.1 定义新总线
    	int xbus_match(struct device *dev, struct device_driver *drv)
    	{
    		printk("%s-%s\n",__FILE__, __func__);   //ssd/build/work_xsy/linux/fire/embed_linux_tutorial/base_code/linux_driver/linux_device_model/xbus.c-xbus_match
    		
    		/* 使用字符串比较的方式,通过对比驱动以及设备的名字来确定是否匹配 */
    		/* 如果相同,则说明匹配成功,返回1;反之,则返回0 */
    		if(!strncmp(dev_name(dev), drv->name, strlen(drv->name))){ 
    			printk("dev & drv match\n");
    			return 1;                                               
    		}
    		return 0;
    	}
    	
    	static struct bus_type xbus = {
    		.name = "xbus",
    	
    		/* 负责总线下的设备以及驱动匹配,没有这个函数,设备与驱动便不可以进行匹配 */
    		.match = xbus_match,
    	};
    	
    	/* 相当于作为一个全局变量,其他的ko文件使用时,只需要extern就好了 */
    	EXPORT_SYMBOL(xbus);
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    4.3.1.2 导出总线属性文件

    我们通过BUS_ATTR宏,将我们自定义的变量导出到/sys目录,方便用户查询。

    	/* 定义了一个bus_name变量,存放了该总线的名字 */
    	static char *bus_name = "xbus";
    	
    	/* 提供show回调函数,这样用户便可以通过cat命令,来查询总线的名称 */
    	ssize_t xbus_test_show(struct bus_type *bus, char *buf)
    	{
    		return sprintf(buf, "%s\n", bus_name);
    	}
    	
    	/* 设置该文件的文件权限为文件拥有者可读,组内成员以及其他成员不可操作。(store函数为NULL) */
    	/* bus_attr + xbus_test将名字拼接起来 = bus_attr_xbus_test */
    	/* 宏定义相当于申明变量了:struct bus_attribute bus_attr_xbus_test = __ATTR(_name, _mode, _show, _store) */
    	BUS_ATTR(xbus_test, S_IRUSR, xbus_test_show, NULL);
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    4.3.1.3 注册总线

    内核的驱动代码,都是基于内核模块,我们在模块初始化的函数中注册总线,在模块注销的函数中注销该总线。

    	static __init int xbus_init(void)
    	{
    		printk("xbus init\n");
    	
    		/* 实现总线的装载函数,注册总线并将总线属性文件导出 */
    		bus_register(&xbus);
    		bus_create_file(&xbus, &bus_attr_xbus_test);
    		return 0;
    	}
    	module_init(xbus_init);
    	
    	static __exit void xbus_exit(void)
    	{
    		printk("xbus exit\n");
    		
    		/* 实现总线的卸载函数,注销总线并将总线属性文件删除 */
    		bus_remove_file(&xbus, &bus_attr_xbus_test);
    		bus_unregister(&xbus);
    	}
    	module_exit(xbus_exit);
    	
    	MODULE_AUTHOR("embedfire");
    	MODULE_LICENSE("GPL");
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    4.3.1.4 现象

    当我们成功加载该内核模块时,内核便会出现一种新的总线xbus,如图所示:
    在这里插入图片描述
    我们可以看到,总线的devices和drivers目录都是空的,并没有什么设备和驱动挂载在该总线下。
    红框处便是我们自定义的总线属性文件,当我们执行命令“cat xbus_test”时,可以看到终端上会打印一行字符串:xbus。

    4.3.2 内核RGB模块的加载和卸载函数

    Linux设备模型中,总线已经注册好了,还缺少设备和驱动。
    注册一个新的设备,主要完成这两个工作:

    • 名字,这是总相匹配的依据;
    • 总线,该设备挂载在哪个总线上,不能张冠李戴。

    这里,我们注册一个设备xdev,并且定义一个变量id,将该变量导出到用户空间,使得用户可以通过sysfs文件系统来修改该变量的值。

    4.3.2.1 定义新的设备
    	/* 声明了外部的总线变量xbus(由bus总线使用EXPORT_SYMBOL向外申明) */
    	extern struct bus_type xbus;
    	
    	/* 编写release函数,防止卸载(注销)模块时会报错 */
    	void xdev_release(struct device *dev)
    	{
    		printk("%s-%s\n", __FILE__, __func__);
    	}
    	
    	/* 定义了一个名为xdev的设备,将其挂载在xbus上 */
    	static struct device xdev = {
    		.init_name = "xdev",
    		.bus = &xbus,
    		.release = xdev_release,
    	};
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    4.3.2.2 导出设备属性文件
    	unsigned long id = 0;
    	
    	/* show回调函数中,直接将id的值通过sprintf函数拷贝至buf中 */
    	ssize_t xdev_id_show(struct device *dev, struct device_attribute *attr, char *buf) 
    	{
    		return sprintf(buf, "%d\n", id);
    	}
    	
    	/* store回调函数(echo调用)则是利用kstrtoul函数,该函数有三个参数,其中第二个参数是采用几进制的方式 */
    	ssize_t xdev_id_store(struct device *dev, struct device_attribute *attr, const char *buf, size_t count)     
    	{
    		/* 传入的是10,意味着buf中的内容将转换为10进制的数传递给id,实现了通过sysfs修改驱动的目的 */
    		kstrtoul(buf, 10, &id);
    		return count;
    	}
    	
    	/* 使用DEVICE_ATTR宏定义定义了xdev_id,定义后的全称为device_attr_xdev_id */
    	/* 并且设置该文件的文件权限是文件拥有者可读可写,组内成员以及其他成员不可操作 */
    	DEVICE_ATTR(xdev_id, S_IRUSR|S_IWUSR, xdev_id_show, xdev_id_store);
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    4.3.2.3 注册设备

    需要调用device_register函数以及device_create_file函数,将上面的设备结构体以及属性文件结构体注册到内核即可。

    	static __init int xdev_init(void)
    	{
    		printk("xdev init\n");
    		device_register(&xdev);
    		device_create_file(&xdev, &dev_attr_xdev_id);
    		return 0;
    	}
    	/* 实现模块的装载函数,注册设备并将设备属性文件导出 */
    	module_init(xdev_init);
    	
    	
    	static __exit void xdev_exit(void)
    	{
    		printk("xdev exit\n");
    		device_remove_file(&xdev, &dev_attr_xdev_id);
    		device_unregister(&xdev);
    	}
    	/* 实现模块的卸载函数,注销设备并将设备属性文件删除 */
    	module_exit(xdev_exit);
    	
    	MODULE_AUTHOR("embedfire");
    	MODULE_LICENSE("GPL");
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    4.3.2.4 现象

    加载内核模块后,我们可以看到在/sys/bus/xbus/devices/中多了个设备xdev,它是个链接文件,最终指向了/sys/devices中的设备
    在这里插入图片描述
    我们直接切换到xdev的目录下,可以看到,我们自定义的属性文件xdev_id。
    在这里插入图片描述
    通过echo以及cat命令,可以进行修改和查询,如下所示:
    在这里插入图片描述

    4.2.3 驱动

    关于驱动的部分,由于本章实验没有具体的物理设备,因此,没有涉及到设备初始化、设备的函数接口等内容。

    4.2.3.1 定义新的驱动
    	/* 声明了外部的总线变量xbus */
    	extern struct bus_type xbus;
    	
    	/* 当驱动和设备匹配成功之后,便会执行驱动的probe函数,这里只是在终端上打印当前的文件以及函数名 */
    	int xdrv_probe(struct device *dev)
    	{
    		printk("%s-%s\n", __FILE__, __func__);
    		return 0;
    	}
    	
    	/* xdrv_remove函数,当注销驱动时,需要关闭物理设备的某些功能等,这里也只是打印出当前的文件名以及函数名 */
    	int xdrv_remove(struct device *dev)
    	{
    		printk("%s-%s\n", __FILE__, __func__);
    		return 0;
    	}
    	
    	/* 定义了一个驱动结构体xdrv,.name成员需要和设备的.name相同,否则就不能成功匹配。该驱动挂载在已经注册好的总线xbus下 */
    	static struct device_driver xdrv = {
    		.name = "xdev",
    		.bus = &xbus,
    		.probe = xdrv_probe,
    		.remove = xdrv_remove,
    	};
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    4.2.3.2 导出驱动属性文件
    	char *name = "xdrv";
    	ssize_t drvname_show(struct device_driver *drv, char *buf)
    	{
    		return sprintf(buf, "%s\n", name);
    	}
    	
    	/* DRIVER_ATTR_RO定义驱动属性文件时,没有参数可以设置show和store回调函数, 我们只要保证store和show函数的前缀与驱动属性文件一致即可 */
    	/* 如代码所示,定义了一个drvname属性文件, show回调函数的函数名则为drvname_show,这样便可以完成两者之间的关联 */
    	/* 生成文件名字为driver_attr_drvname */
    	DRIVER_ATTR_RO(drvname);
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    4.2.3.3 注册驱动

    最后,调用driver_register函数以及driver_create_file函数进行注册我们的驱动以及驱动属性文件。

    	static __init int xdrv_init(void)
    	{
    		printk("xdrv init\n");
    		driver_register(&xdrv);
    		driver_create_file(&xdrv, &driver_attr_drvname);
    		return 0;
    	}
    	/* 实现模块的装载函数,注册驱动并将驱动属性文件导出 */
    	module_init(xdrv_init);
    	
    	static __exit void xdrv_exit(void)
    	{
    		printk("xdrv exit\n");
    		driver_remove_file(&xdrv, &driver_attr_drvname);
    		driver_unregister(&xdrv);
    	}
    	/* 实现模块的卸载函数,注销驱动并将驱动属性文件删除 */
    	module_exit(xdrv_exit); 
    	
    	MODULE_AUTHOR("embedfire");
    	MODULE_LICENSE("GPL");
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    4.2.3.4 现象

    成功加载驱动后,可以看到/sys/bus/xbus/driver多了个驱动xdev目录,如图所示:
    在该目录下存在一个我们自定义的属性文件, 使用cat命令读该文件的内容,终端会打印字符串“xdrv”。
    在这里插入图片描述

    使用命令“dmesg | tail”来查看模块加载过程的打印信息,
    当我们加载完设备和驱动之后,总线开始进行匹配,执行match函数,发现这两个设备的名字是一致的,就将设备和驱动关联到一起,最后会执行驱动的probe函数。
    在这里插入图片描述
    在这里插入图片描述
     


    五、总结

    有 设备 或是 驱动 注册时,会去总线匹配match名字,在匹配过程中会忽略掉那些已经有驱动匹配的设备,相同则回调总线的probe函数(最终会调用驱动提供的probe函数)
    sysfs文件系统用于把内核的设备驱动导出到用户空间, 用户便可通过访问sys目录及其下的文件,来查看甚至控制内核的一些驱动设备

    struct bus_type {
    	/* /sys/bus目录创建一个新的目录 */
    	const char              *name;
    	/* 用户可以通过读写操作来获取和设置这些attribute的值 */
    	/* /sys/bus//driver/存放了设备的默认属性,设备则在目录/sys/bus//devices/ */
    	const struct attribute_group **bus_groups;
    	const struct attribute_group **dev_groups;
    	const struct attribute_group **drv_groups;
    	int (*match)(struct device *dev, struct device_driver *drv);
    	int (*probe)(struct device *dev);
    	int (*remove)(struct device *dev);
    	...
    };
    
    struct device {
    	/* 指定该设备的名称,总线匹配时,一般会根据比较名字,来进行配对 */
    	const char *init_name;
    	/* 表示该设备依赖于哪个总线,当我们注册设备时,内核便会将该设备注册到对应的总线 */
    	struct bus_type *bus;
    	/* 存放设备树中匹配的设备节点。当内核使能设备树,总线负责将驱动的of_match_table以及设备树的compatible属性进行比较之后,将匹配的节点保存到该变量 */
    	struct device_node      *of_node;
    	/* 指向了该设备对应类,可以在/sys/class目录下对应的类找到该设备 */
    	struct class            *class;
    	/* 回调函数,当设备被注销时,会调用该函数 */
    	/* 如果我们没定义该函数时,移除设备时,会提示“Device ‘xxxx’ does not have a release() function, it is broken and must be fixed”的错误 */
    	void (*release)(struct device *dev);
    	...
    };
    
    struct device_driver {
    	const char              *name;
    	struct bus_type         *bus;
    	/* 当驱动以及设备匹配后,会执行该回调函数,对设备进行初始化。*/ 
    	/* 通常的代码,都是以main函数开始执行的,但是在内核的驱动代码,都是从probe函数开始 */
    	int (*probe) (struct device *dev);
    	...
    };
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37

    当我们注册新的总线、设备或驱动时,内核会在对应的地方创建一个新的目录,目录名为各自结构体的name成员,每个子目录下的文件,都是内核导出到用户空间,用于控制我们的设备的。
    内核中以attribute结构体来描述/sys目录下的文件。
    使用cat命令,来获取/sys目录下某个文件时,最终会执行show回调函数, 使用echo命令,则会执行store回调函数

    步骤

    1. 声明一个总线结构体并创建一个总线xbus,实现match方法,对设备和驱动进行匹配

      • 填充bus_type结构体xbus的name/match,并使用EXPORT_SYMBOL导出
      • 通过BUS_ATTR宏,将我们自定义的变量bus_attr_xbus_test导出到/sys目录
      • 注册总线(bus_register(&xbus))并将总线属性文件导出(bus_create_file(&xbus, &bus_attr_xbus_test))
    2. 声明一个设备结构体,挂载到我们的xbus总线中 ,实现release方法

      • 声明外部的总线变量xbus
      • 填充device结构体xdev的init_name/bus/release(其中若无release则移除设备时会提示错误)
      • 实现dev的show/store函数,通过DEVICE_ATTR宏,定义device_attr_xdev_id,导出到用户空间
      • 注册设备(device_register(&xdev))并将设备属性文件导出(device_create_file(&xdev, &dev_attr_xdev_id)),将上面的设备结构体以及属性文件结构体注册到内核即可
    3. 声明一个驱动结构体,挂载到xbus总线,实现probe、remove方法

      • 声明外部的总线变量xbus
      • 填充device_driver结构体xdrv的name/bus/probe/remove
      • 实现drv的show/store函数,通过DRIVER_ATTR_RO宏,定义driver_attr_drvname,导出到用户空间(show回调函数的函数名则为drvname_show,这样便可以完成两者之间的关联)
      • 调用driver_register函数以及driver_create_file函数进行注册我们的驱动以及驱动属性文件
      • 注册驱动(driver_register(&xdrv))并将驱动属性文件导出(driver_create_file(&xdrv, &driver_attr_drvname)),将上面的驱动结构体以及属性文件结构体注册到内核即可
    4. 将总线、设备、驱动导出属性文件到用户空间。

  • 相关阅读:
    VScode快捷键(win + mac)
    一年后斩获腾讯T5,这份呕心之作Java学习笔记有多厉害
    Linux基础 - 虚拟化介绍(KVM)
    这个Spring Security登录插件牛啊,验证码、小程序、OAuth2都能快速接入
    ​LeetCode解法汇总2342. 数位和相等数对的最大和
    一文带你了解redux的工作流程——action/reducer/store
    如何为你的Python程序配置HTTP/HTTPS爬虫IP
    c语言基础学习笔记(五):for循环
    利用python学习如何处理需要登录的网站
    6.搭建Eureka
  • 原文地址:https://blog.csdn.net/qq_38211182/article/details/126598328