Linux驱动开发—设备模型框架 kobject创建属性文件

于 2024-08-27 17:08:45 发布
阅读量494 收藏 11
点赞数 4
分类专栏： 嵌入式开发 文章标签： linux 驱动开发
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_46999174/article/details/141607653
版权

文章目录

什么是属性文件？

在 Linux 内核中，属性文件（Attribute Files）指的是通过 sysfs 文件系统暴露给用户空间的文件，这些文件通常用于在用户空间与内核空间之间进行简单的数据交换或配置。

1. sysfs 与 kobject

  • sysfs 文件系统 是 Linux 内核中的一种虚拟文件系统，它将内核对象 (kobjects) 的属性映射为文件，通常位于 /sys 目录下。这些文件通过 sysfs 文件系统暴露给用户，可以被用户空间的程序读取或写入。

  • kobject 是内核对象管理机制的核心，sysfs 文件系统通过 kobject 来组织和管理这些属性文件。

2. 属性文件的作用

  • 读取内核状态：属性文件可以暴露内核对象的状态或统计信息，例如设备的当前状态、计数器值等。

  • 配置内核参数：用户可以通过写入属性文件来修改内核对象的参数，配置设备或调试内核模块。

3. 属性文件的基本操作

  • 读取操作 (show)：用户空间读取属性文件的内容，触发内核中的 show 函数，返回文件的内容。

  • 写入操作 (store)：用户空间写入属性文件的内容，触发内核中的 store 函数，更新内核对象的状态或参数。

4. 典型的属性文件用例

一个典型的例子是 /sys/class/net/eth0/ 目录下的属性文件，它们允许用户查看或配置网络接口 eth0 的一些属性，比如 speed, mtu, operstate 等。

例如：

  • 读取速度：cat /sys/class/net/eth0/speed
  • 配置 MTU：echo 1500 > /sys/class/net/eth0/mtu

5. 创建属性文件的步骤

当您在内核模块中定义一个 kobject 时，通常会定义一组 attribute 结构体，并将它们关联到 sysfs 文件系统中。每个属性文件在 sysfs 中对应一个 attribute 结构体，通常会包含以下信息：

  • name: 属性文件的名称。
  • mode: 文件的权限，例如 0444 表示只读，0666 表示可读可写。
  • show 函数: 定义了如何显示属性文件的内容。
  • store 函数: 定义了如何处理用户写入的内容。

6.示例代码

#include <linux/module.h>
#include <linux/init.h>
#include <linux/slab.h>
#include <linux/kernel.h>
#include <linux/kobject.h>

#define DISABLE 0
#define ENABLE 1

// 创建自己的kobj ，附带两个属性
struct mykobj
{
    struct kobject kobj;
    int reg_count;
    int reg_status;
};

struct mykobj *mykobject01;

static void dynamic_kobj_release(struct kobject *kobj)
{
    struct mykobj *mykobject01 = container_of(kobj, struct mykobj, kobj);
    kfree(mykobject01);
}

static struct attribute attr1 = {
    .name = "reg_count",
    .mode = 0666,
};

static struct attribute attr2 = {
    .name = "reg_status",
    .mode = 0666,
};

ssize_t my_show(struct kobject *kobj, struct attribute *attr, char *buf)
{
    if (strcmp(attr->name, "reg_count") == 0)
        return sprintf(buf, "%d\n", mykobject01->reg_count);
    if (strcmp(attr->name, "reg_status") == 0)
        return sprintf(buf, "%d\n", mykobject01->reg_status);

    return 0;
}

ssize_t my_store(struct kobject *kobj, struct attribute *attr, const char *buf, size_t count)
{
    int val;

    if (strcmp(attr->name, "reg_count") == 0)
    {
        sscanf(buf, "%d", &val);
        mykobject01->reg_count = val;
    }
    else if (strcmp(attr->name, "reg_status") == 0)
    {
        sscanf(buf, "%d", &val);
        mykobject01->reg_status = val;
    }

    return count;
}

static const struct sysfs_ops my_sysfs_ops = {
    .show = my_show,
    .store = my_store,
};

static struct attribute *attrs[] = {&attr1, &attr2, NULL};

static struct kobj_type my_type = {
    .release = dynamic_kobj_release,
    .sysfs_ops = &my_sysfs_ops,
    .default_attrs = attrs,
};

static int __init mykobj_init(void)
{
    int ret = 0;

    mykobject01 = kzalloc(sizeof(struct mykobj), GFP_KERNEL);
    if (!mykobject01)
        return -ENOMEM;

    mykobject01->reg_count = 2;
    mykobject01->reg_status = DISABLE;

    ret = kobject_init_and_add(&mykobject01->kobj, &my_type, NULL, "%s", "mykobj_root");
    if (ret)
    {
        kobject_put(&mykobject01->kobj);
        return ret;
    }

    return 0;
}

static void __exit mykobj_exit(void)
{
    kobject_put(&mykobject01->kobj);
}

module_init(mykobj_init);
module_exit(mykobj_exit);

MODULE_AUTHOR("Marxist");
MODULE_LICENSE("GPL");
MODULE_DESCRIPTION("A simple example of making kobject with sysfs attributes");

7.效果图

在这里插入图片描述

属性文件是内核与用户空间进行交互的重要方式之一。它们通常用于在内核模块中暴露一些简单的、可配置的参数，便于用户空间的应用程序进行读取或配置。这种机制在驱动开发、调试以及设备配置中广泛使用。

使用 ATTR 宏定义优化

上述暴露出一个问题，如果某个设备属性文件过多，如何优化if的次数？这样会让读写文件很臃肿，最好的方法，应该是一个属性对应一个show和store

可以使用ATTR宏定义来实现这个功能

__ATTR用法解析

__ATTR() 是 Linux 内核中的一个宏，用于简化属性文件（attribute file）的定义。它用于定义一个 struct attribute 结构体，同时设置该属性的名称、权限以及关联的 show 和 store 操作函数。

1. __ATTR() 宏的定义

#define __ATTR(_name, _mode, _show, _store) { \
    .attr = { .name = __stringify(_name), .mode = (_mode) }, \
    .show   = (_show), \
    .store  = (_store), \
}

2. __ATTR() 宏的参数

  • _name：属性的名称，将出现在 /sys 文件系统中的文件名。
  • _mode：属性文件的权限模式，通常是八进制数，比如 0644、0666 等，表示文件的读写权限。
  • _show：属性文件的读取函数指针，当用户读取该文件时将调用此函数。
  • _store：属性文件的写入函数指针，当用户写入该文件时将调用此函数。

3.优化示例

#include <linux/module.h>
#include <linux/init.h>
#include <linux/slab.h>
#include <linux/kernel.h>
#include <linux/kobject.h>
#include <linux/sysfs.h>

#define DISABLE 0
#define ENABLE 1

// 创建自己的kobj ，附带两个属性
struct mykobj
{
    struct kobject kobj;
    int reg_count;
    int reg_status;
};

struct mykobj *mykobject01;

static void dynamic_kobj_release(struct kobject *kobj)
{
    struct mykobj *mykobject01 = container_of(kobj, struct mykobj, kobj);
    kfree(mykobject01);
}


/*
 struct kobj_attribute {
	struct attribute attr;
	ssize_t (*show)(struct kobject *kobj, struct kobj_attribute *attr,
			char *buf);
	ssize_t (*store)(struct kobject *kobj, struct kobj_attribute *attr,
			 const char *buf, size_t count);
};

*/

//reg_count_show 属性
static ssize_t reg_count_show(struct kobject *kobj, struct kobj_attribute *attr, char *buf)
{
    pr_info("Reading reg_count: %d\n", mykobject01->reg_count);
    return sprintf(buf, "%d\n", mykobject01->reg_count);
}
static ssize_t reg_count_store(struct kobject *kobj, struct kobj_attribute *attr, const char *buf, size_t count) {
    sscanf(buf, "%d", &mykobject01->reg_count);
    return count;
}

struct kobj_attribute  reg_count_attr= __ATTR(reg_count,0664,reg_count_show,reg_count_store);

//reg_status 属性
static ssize_t reg_status_show(struct kobject *kobj, struct kobj_attribute *attr, char *buf)
{
    pr_info("Reading reg_status: %d\n", mykobject01->reg_status);
    return sprintf(buf, "%d\n", mykobject01->reg_status);
}
static ssize_t reg_status_store(struct kobject *kobj, struct kobj_attribute *attr, const char *buf, size_t count) {
    sscanf(buf, "%d", &mykobject01->reg_status);
    return count;
}
struct kobj_attribute  reg_status_attr= __ATTR(reg_status,0664,reg_status_show,reg_status_store);

ssize_t my_show(struct kobject *kobj, struct attribute *attr, char *buf)
{
    
    struct kobj_attribute *kobj_attr  = container_of(attr,struct kobj_attribute,attr);
    return kobj_attr->show(kobj,kobj_attr,buf);
}

ssize_t my_store(struct kobject *kobj, struct attribute *attr, const char *buf, size_t count)
{

    struct kobj_attribute *kobj_attr  = container_of(attr,struct kobj_attribute,attr);
    kobj_attr->store(kobj,kobj_attr,buf,count);
    return 0;
}

static const struct sysfs_ops my_sysfs_ops = {
    .show = my_show,
    .store = my_store,
};


static struct attribute *attrs[] = {&reg_status_attr.attr, &reg_count_attr.attr, NULL};

static struct kobj_type my_type = {
    .release = dynamic_kobj_release,
    .sysfs_ops = &my_sysfs_ops,
    .default_attrs = attrs,
};

static int __init mykobj_init(void)
{
    int ret = 0;

    mykobject01 = kzalloc(sizeof(struct mykobj), GFP_KERNEL);
    if (!mykobject01)
        return -ENOMEM;

    mykobject01->reg_count = 2;
    mykobject01->reg_status = DISABLE;

    ret = kobject_init_and_add(&mykobject01->kobj, &my_type, NULL, "%s", "mykobj_root");
    if (ret)
    {
        kobject_put(&mykobject01->kobj);
        return ret;
    }

    return 0;
}

static void __exit mykobj_exit(void)
{
    kobject_put(&mykobject01->kobj);
}

module_init(mykobj_init);
module_exit(mykobj_exit);

MODULE_AUTHOR("Marxist");
MODULE_LICENSE("GPL");
MODULE_DESCRIPTION("A simple example of making kobject with sysfs attributes");

优化关键点解析

这段代码的目的是创建一个内核对象（kobject），并通过 sysfs 暴露两个属性（reg_count 和 reg_status）供用户空间访问。用户可以通过读取或写入 /sys 目录下的文件来查看和修改这些属性。

1. 数据结构定义

struct mykobj
{
    struct kobject kobj;
    int reg_count;
    int reg_status;
};

struct mykobj *mykobject01;
  • mykobj 结构体包含了一个 kobject 对象以及两个整型成员变量 reg_count 和 reg_status。kobject 是内核对象管理的基础，它提供了 sysfs 的接口。

2. 属性定义

struct kobj_attribute reg_count_attr = __ATTR(reg_count, 0664, reg_count_show, reg_count_store);
struct kobj_attribute reg_status_attr = __ATTR(reg_status, 0664, reg_status_show, reg_status_store);
  • 使用 __ATTR 宏定义了两个 kobj_attribute 类型的属性：reg_count_attr 和 reg_status_attr。该宏将属性名称、访问权限和读写方法关联起来。

3. 属性的读写方法

static ssize_t reg_count_show(struct kobject *kobj, struct kobj_attribute *attr, char *buf)
{
    pr_info("Reading reg_count: %d\n", mykobject01->reg_count);
    return sprintf(buf, "%d\n", mykobject01->reg_count);
}

static ssize_t reg_count_store(struct kobject *kobj, struct kobj_attribute *attr, const char *buf, size_t count) {
    sscanf(buf, "%d", &mykobject01->reg_count);
    return count;
}
  • reg_count_show 和 reg_count_store 是 reg_count 属性的读写方法。
    • reg_count_show: 读取 reg_count 的值，并将其格式化输出到 buf。
    • reg_count_store: 从 buf 读取用户输入的值并更新 reg_count。

4. sysfs 操作接口

static const struct sysfs_ops my_sysfs_ops = {
    .show = my_show,
    .store = my_store,
};
  • sysfs_ops 结构体定义了如何处理 sysfs 文件的读写操作。my_show 和 my_store 实现了通用的属性读写逻辑，通过 container_of 获取属性对应的 kobj_attribute，然后调用具体的 show 或 store 方法。
Trump. yang
关注
  • 4
    点赞
  • 踩
  • 11
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
linux驱动开发：linux设备模型
m0_70983574的博客
09-01 689
简单介绍了linux设备模型，以及设备树，简要概括了平台驱动的编写框架
最全Linux驱动开发全流程详细解析（持续更新）
热门推荐
拉依达不拉跨的博客
02-19 4万+
Linux驱动开发详细解析
嵌入式Linux驱动开发初级-字符设备驱动基础框架
found_1的博客
03-06 435
嵌入式Linux驱动开发初级-字符设备驱动基础框架
Linux驱动开发—设备模型框架 kset和 kobject 详解
weixin_46999174的博客
08-16 974
设备模型（Device Model）是 Linux 内核中的一个抽象层，用于统一管理和组织系统中的各种硬件设备及其驱动程序。它为设备、驱动、总线和电源管理等提供了一个统一的接口和结构，使得内核能够更加高效和一致地管理系统中的硬件资源。
linux设备驱动模型
风雨无阻
08-28 1969
linux设备驱动模型分析
【linux驱动】最基本的驱动框架
weixin_46334900的博客
04-14 977
我们上面步骤4中注册。
linux驱动-设备驱动模型(device设备)
sty01z的博客
05-03 1092
从代码可以看出对于 dev 来说名字是一个非常重要的参数，首先使用 init_name 作为dev->kobj 的名字同时将 init_name 设置为空，如果 init_name 初始为空则使用 “bus->dev_nam + dev->id” 作为dev->kobj 的名字，如果设备没有设置名字则直接返回错误。
Linux字符驱动开发《02_字符设备框架》
weixin_44252380的博客
03-30 513
前言： 第一节只是了解了字符设备驱动程序是以内核模块的形式存在的,学习了内核内核模块的加载过程，本节将对字符设备的驱动框架做一个学习！ 文章目录一、理论知识1.Linux设备分类2. cdev介绍2.1 cdev数据结构2.2 cdev操作函数3. 设备号4. 设备节点，驱动，硬件设备的关联4.1 inode结构体4.2 file结构体4.3调用流程二、实验操作1.驱动代码2.Makefile3.测试程序三、遗留问题 一、理论知识 1.Linux设备分类 字符设备、块设备、网络设备三大类，具体概念可以
Linux驱动开发7---设备驱动模型的三大组件
weixin_43604927的博客
08-09 417
设备驱动模型
设备模型之kobject,kset及其关系1
08-08
设备模型通过`kobject`和`kset`的这种组织方式，实现了设备的层次化管理，允许驱动程序在统一的接口下进行设备的注册、注销、属性管理和事件处理。同时，通过sysfs，这些设备模型对象能够映射到用户空间，使得用户...
Linux驱动开发——字符设备驱动
weixin_43920383的博客
08-23 907
分享一句话：大事随心，小事随脑。字符驱动开发，字符驱动框架
Linux设备驱动模型(2)_Kobject
xhrc007的博客
03-29 392
1. 基本概念 Linux设备模型的核心是围绕Driver-Bus-Device（Class）设计的一整套框架，将大量的不同功能的硬件设备，以树状结构的形式进行抽象归纳，从而让内核统一进行管理。由于硬件设备以及相应驱动程序的繁杂庞大，Linux内核利用面向对象的思想从中抽象出一些共同的功能，从而构建了一个顶级的结构体，也就是kobject结构体。 kobject提供的功能： 1) 通过parent指针，可以将所有的kobject以层次结构的形式组合起来； 2) 使用kref（引用计数 referen
Linux设备驱动模型与 sysfs实现分析以及设计模式应用
tugouxp的专栏
02-19 1389
在驱动设计中，驱动开发者需要处理两类对象，分别是过程和设备，设备对象是驱动操作的目标，而过程则是设备运行规则的描述，RTOS和Linux系统上开发驱动的方式非常的不同，在RTOS系统下，驱动和驱动之间并没有实质性的联系，不同的驱动和BSP之间仅仅通过一层很薄很薄的设备管理框架聚合在一起构成RTOS的设备管理子系统。图形化表示如下：设备驱动&BSP之间互相独立，互不影响，互不依赖，独立实现，挂入设备管理框架中，构成一个个类似“烟囱”式的垂直架构。
Linux中的常见命令——用户管理命令
qq_45569925的博客
08-27 294
默认创建用户的时候会在home文件夹下创建一个与用户同名的文件夹【该用户的主目录】，也可以在创建用户的时候设置该用户主目录的名称。【输入的密码是不在控制台显示的，输入完之后直接按回车键即可】使用wgh用户查看root下的文件。【此时的用户是没有密码的】给创建的用户设置密码。查看某个用户是否存在。
虚拟内存和linux（操作系统part1）
linjixia的博客
08-24 618
八股之虚拟内存和Linux部分的笔记。
Linux 线程的控制 互斥与同步
qq_63145217的博客
08-23 952
include //头文件sem_t sem;信号量的类型 信号量的变量。
【Linux】进程｜进程的查看与管理｜创建进程
2202_75331338的博客
08-27 519
❍ 课本概念：程序的一个执行实例，正在执行的程序等❍ 内核观点：担当分配系统资源（CPU时间，内存的实体）简单来说：进程 == PCB(进程控制块) + 进程对应的代码和数据；一个进程对应一个PCB操作系统对进程的管理，最终变成了对链表的增删查改。注意：可执行程序加载到内存不是进程，只是进程对应的代码和数据。
Linux 常用命令 - lsblk 【查看磁盘（块设备）使用情况】
最新发布
随便转转
08-27 696
lsblk源自于 “list block devices” 的缩写。这个命令用于列出系统中的所有块设备（block devices），比如硬盘、光驱等。它展示块设备的层次结构、大小和挂载点等信息，非常有助于系统管理员理解系统存储结构。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Trump. yang

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值