DEVICE_ATTR

"DEVICE_ATTR"是Linux内核中的一个宏定义，用于定义一个设备（device）的属性（attribute）。它定义了一个名为"dev_attr_<name>"的静态结构体实例，其中"<name>"是属性的名称，该结构体包含了属性的名称、读取函数和写入函数等信息。

以下是一个示例"DEVICE_ATTR"的定义：

#define DEVICE_ATTR(_name, _mode, _show, _store) \
    struct device_attribute dev_attr_##_name = __ATTR(_name, _mode, _show, _store)

其中，参数含义如下：

- "_name"：属性名称，类型为字符串；
- "_mode"：属性文件的访问权限，包括读/写、读和写权限等；
- "_show"：读取属性值的函数，类型为"ssize_t (*show)(struct device *dev, struct device_attribute *attr, char *buf)"；
- "_store"：写入属性值的函数，类型为"ssize_t (*store)(struct device *dev, struct device_attribute *attr, const char *buf, size_t count)"。

通过使用"DEVICE_ATTR"宏定义，可以方便地为一个设备添加新的属性，并且在sysfs文件系统中创建相应的属性文件，从而实现对设备的属性进行读取和写入操作。

相关问题

DEVICE_ATTR_RW和DEVICE_ATTR区别

### DEVICE_ATTR_RW 和 DEVICE_ATTR 的区别

Linux内核提供了多种宏来简化设备属性的创建过程。`DEVICE_ATTR` 是用于定义只读或可写属性的基础宏[^2]。

对于 `DEVICE_ATTR` 宏而言，其语法结构如下：

#define DEVICE_ATTR(_name, _mode, _show, _store)

此宏接受四个参数：属性名称 `_name`、权限模式 `_mode` 以及两个函数指针 `_show` 和 `_store` 分别对应于读取操作和写入操作。当只需要实现单向的数据访问（即要么能读不能写，要么能写不能读），可以仅提供相应的回调函数；如果不需要某个方向的操作，则可以把该位置设为空(NULL)。

而 `DEVICE_ATTR_RW` 则是一个更高层次封装版本，在功能上更加具体化。它专门用来声明既支持读又支持写的双向属性，并自动为用户提供默认的读写接口模板。因此，使用起来更为简便快捷。其实现方式本质上还是依赖于基础版的 `DEVICE_ATTR` 来完成实际工作[^1]。

通过比较可以看出，虽然两者都基于相同的底层机制构建而成，但是面向的应用场景有所不同——前者给予开发者更大的灵活性去定制特定行为，后者则更侧重于快速搭建常规性的读写特性。

#### 示例代码展示

以下是利用上述两种不同类型的宏实例化的简单示例：

// 使用 DEVICE_ATTR 创建一个名为 "example_attr" 的属性，
// 支持读 (read_example_show)，也支持写 (write_example_store).
static ssize_t read_example_show(struct device *dev,
                                 struct device_attribute *attr,
                                 char *buf);
static ssize_t write_example_store(struct device *dev,
                                   struct device_attribute *attr,
                                   const char *buf, size_t count);

static DEVICE_ATTR(example_attr, 0644, read_example_show, write_example_store);

// 使用 DEVICE_ATTR_RW 可以达到相同的效果，但编码量减少。
static ssize_t example_rw_show(struct device *dev,
                               struct device_attribute *attr,
                               char *buf);
static ssize_t example_rw_store(struct device *dev,
                                struct device_attribute *attr,
                                const char *buf, size_t count);

static DEVICE_ATTR_RW(wakealarm); // 实际应用中的例子来自 rtc-sysfs.c 文件

DEVICE_ATTR定义

DEVICE_ATTR 是一个宏定义，用于在 Linux 内核中定义设备属性。它是通过 sysfs 接口提供设备的属性信息。使用 DEVICE_ATTR 宏定义的属性可以被用户空间程序读取和写入，从而实现对设备的控制和监控。

DEVICE_ATTR 宏定义的语法如下：

DEVICE_ATTR(attr_name, mode, show_func, store_func)

其中，attr_name 是属性名称，mode 是属性的访问权限（如只读、只写、可读可写等），show_func 是一个读取属性值的回调函数，store_func 是一个写入属性值的回调函数。

示例代码：

static ssize_t show_attr(struct device *dev, struct device_attribute *attr, char *buf)
{
    // 读取属性值的逻辑
    return sprintf(buf, "%d\n", attr_value);
}

static ssize_t store_attr(struct device *dev, struct device_attribute *attr, const char *buf, size_t count)
{
    // 写入属性值的逻辑
    sscanf(buf, "%d", &attr_value);
    return count;
}

static DEVICE_ATTR(my_attr, 0664, show_attr, store_attr);

在上面的示例中，定义了一个名为 my_attr 的设备属性，权限为 0664，读取属性值的回调函数为 show_attr，写入属性值的回调函数为 store_attr。用户空间程序可以通过 sysfs 接口读取和写入 my_attr 属性的值。

需要注意的是，DEVICE_ATTR 宏定义的属性只能在驱动程序中使用，它是通过 struct device_attribute 结构体与设备关联起来的。