RK3568驱动指南｜第九篇 设备模型-第98章 创建多个属性文件的简便方法

瑞芯微RK3568芯片是一款定位中高端的通用型SOC，采用22nm制程工艺，搭载一颗四核Cortex-A55处理器和Mali G52 2EE 图形处理器。RK3568 支持4K 解码和 1080P 编码，支持SATA/PCIE/USB3.0 外围接口。RK3568内置独立NPU，可用于轻量级人工智能应用。RK3568 支持安卓 11 和 linux 系统，主要面向物联网网关、NVR 存储、工控平板、工业检测、工控盒、卡拉 OK、云终端、车载中控等行业。

​
【公众号】迅为电子

【粉丝群】824412014（加群获取驱动文档+例程）

【视频观看】嵌入式学习之Linux驱动（第九期_设备模型_全新升级）_基于RK3568

【购买链接】迅为RK3568开发板瑞芯微Linux安卓鸿蒙ARM核心板人工智能AI主板

---

第98章 创建多个属性文件的简便方法

在上一章节中，我们创建了一个属性文件，但是在情况中，我们可能需要创建N个属性文件，如果还按照上个章节的方法是非常麻烦的。本章节我们来学习创建多个属性文件的简便方法，这样可以更好地组织和管理相关属性文件，提供更清晰和一致的sysfs接口。

98.1 sysfs_create_group函数

sysfs_create_group函数，用于在sysfs中创建一个组(group)。组是一组相关的属性文件的集合，可以将它们放在同一个目录下提供更好的组织性和可读性。

函数原型如下所示：

int sysfs_create_group(struct kobject *kobj, const struct attribute_group *grp);

此函数有俩个参数，分别为如下所示：

kobj: 指向包含目标组的kobject的指针。

grp: 指向attribute_group结构体的指针，该结构体定义了组中的属性文件。

attribute_group 结构体定义如下：

struct attribute_group {
    const char *name;
    const struct attribute **attrs;
    mode_t (*is_visible)(struct kobject *kobj, struct attribute *attr, int index);
};

结构体中包含如下字段：

• name: 组的名称，将用作sysfs目录的名称。
• attrs: 指向属性文件数组的指针
• is_visible : 可选的回调函数，用于决定每个属性文件是否可见。如果为NULL，则所有属性文件都可见。

属性文件数组是一个以struct attribute *类型为元素的数组，以NULL结束。每个struct attribute结构体表示一个属性文件，可以使用&运算符将属性对象（如struct kobject_attribute）的.attr字段传递给属性文件数组。

下面展示使用sysfs_create_group创建一个组并添加属性文件

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

const struct attribute_group attr_group = {
    .name = "my_group",
    .attrs = attrs,
};

sysfs_create_group(kobj, &attr_group);

在上述示例中，我们创建了一个名叫“my_group”的组，并将属性文件attr1和attr2添加到该组中，然后使用sys_create_group将该组添加到指定的kobject kobj中。接下来我们开始做实验。

98.2实验程序的编写

98.2.1 驱动程序编写

本实验对应的网盘路径为：iTOP-RK3568开发板【底板V1.7版本】\03_【iTOP-RK3568开发板】指南教程\02_Linux驱动配套资料\04_Linux驱动例程\73_attr04\module。

我们编写驱动代码，创建了一个名为 "mykobject01" 的自定义 kobject，并在其中使用上小节介绍的方式创建了两个属性文件 "value1" 和 "value2"。编写完成的attr.c代码如下所示：

#include 
#include 
#include 
#include 
#include 
#include 
#include 

// 定义了mykobj结构体指针变量mykobject01
struct kobject *mykobject01;

// 自定义的show函数，用于读取属性值
ssize_t show_myvalue1(struct kobject *kobj, struct kobj_attribute *attr, char *buf)
{
    ssize_t count;
    count = sprintf(buf, "show_myvalue1\n");
    return count;
};

// 自定义的store函数，用于写入属性值
ssize_t store_myvalue1(struct kobject *kobj, struct kobj_attribute *attr, const char *buf, size_t count)
{
    printk("buf is %s\n", buf);
    return count;
};

// 自定义的show函数，用于读取属性值
ssize_t show_myvalue2(struct kobject *kobj, struct kobj_attribute *attr, char *buf)
{
    ssize_t count;
    count = sprintf(buf, "show_myvalue2\n");
    return count;
};

// 自定义的store函数，用于写入属性值
ssize_t store_myvalue2(struct kobject *kobj, struct kobj_attribute *attr, const char *buf, size_t count)
{
    printk("buf is %s\n", buf);
    return count;
};

// 定义attribute对象value1和value2
struct kobj_attribute value1 = __ATTR(value1, 0664, show_myvalue1, store_myvalue1);
struct kobj_attribute value2 = __ATTR(value2, 0664, show_myvalue2, store_myvalue2);

struct attribute *attr[] = {
    &value1.attr,
    &value2.attr,
    NULL,
};

const struct attribute_group my_attr_group = {
    .name = "myattr",
    .attrs = attr,
};

// 模块的初始化函数
static int mykobj_init(void)
{
    int ret;

    // 创建并添加kobject "mykobject01"
    mykobject01 = kobject_create_and_add("mykobject01", NULL);

    // 在kobject "mykobject01" 中创建属性组
    ret = sysfs_create_group(mykobject01, &my_attr_group);

    return ret;
}

// 模块的退出函数
static void mykobj_exit(void)
{
    // 释放kobject "mykobject01"
    kobject_put(mykobject01);
}

module_init(mykobj_init); // 指定模块的初始化函数
module_exit(mykobj_exit); // 指定模块的退出函数
MODULE_LICENSE("GPL");    // 模块使用的许可证
MODULE_AUTHOR("topeet");  // 模块的作者

接下来驱动编写好之后，我们修改Linux源码中的kernel/lib/kobject.c文件，添加如下打印：

图98-1

然后重新编译内核镜像，单独烧写内核镜像。

98.3 运行测试

98.3.1 编译驱动程序

在上一小节中的attr.c代码同一目录下创建 Makefile 文件，Makefile 文件内容如下所示：

export ARCH=arm64#设置平台架构
export CROSS_COMPILE=aarch64-linux-gnu-#交叉编译器前缀
obj-m += attr.o   #此处要和你的驱动源文件同名
KDIR :=/home/topeet/Linux/linux_sdk/kernel    #这里是你的内核目录                                                                                                                            
PWD ?= $(shell pwd)
all:
    make -C $(KDIR) M=$(PWD) modules    #make操作
clean:
    make -C $(KDIR) M=$(PWD) clean    #make clean操作

对于Makefile的内容注释已在上图添加，保存退出之后，来到存放attr.c和Makefile文件目录下，如下图（图98-2）所示：

图 98-2

然后使用命令“make”进行驱动的编译，编译完成如下图（图98-3）所示：

图 98-3

编译完生成attr.ko目标文件，如下图（图98-4）所示：

图 98-4

至此驱动模块就编译成功了，接下来进行测试。

98.3.2 运行测试

内核镜像更新之后，开发板启动，使用以下命令进行驱动模块的加载，如下图（图98-5）所示：

insmod attr.ko

图98-5

驱动加载之后，我们进入/sys/目录下，可以看到创建生成的myobject01，如下图所示

最后可以使用以下命令进行驱动的卸载，如下图（图98-6）所示： 

rmmod attr

图 98-6

至此，创建多个属性文件实验就完成了。

---