linux驱动模型 - 设备

TheBasic Device Structure

~~~~~~~~~~~~~~~~~~~~~~~~~~

See the kerneldoc for the struct device.





ProgrammingInterface

~~~~~~~~~~~~~~~~~~~~~

检测到设备的总线驱动使用如下函数将设备注册到内核:

int device_register(struct device * dev);



总线负责初始化device结构的下列域:

- parent

- name

- bus_id

- bus



当设备的reference count变为0时，会从内核中移除. 使用下列函数调整reference count

struct device * get_device(struct device * dev);

void put_device(struct device * dev);



如果reference count还不是0（如果正好处于移除的过程中），get_device()会返回指向传递给它的struct device的指针.



驱动可以使用下列函数访问device结构中的lock:

void lock_device(struct device * dev);

void unlock_device(struct device * dev);





Attributes

~~~~~~~~~~

struct device_attribute {

structattribute 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);

};



驱动可以使用一个类似于procfs（sysfs）的接口来导出设备的属性。有关sysfs如何工作的内容，请参考Documentation/filesystems/sysfs.txt.



设备属性可以通过宏DEVICE_ATTR声明:

#define DEVICE_ATTR(name,mode,show,store)



Example:

DEVICE_ATTR(power,0644,show_power,store_power);



这个宏声明了一个名为'dev_attr_power'的device_attribute结构. 通过下列函数可以将属性添加/移除到设备在/sysfs的目录:

int device_create_file(struct device *device, structdevice_attribute * entry);

void device_remove_file(struct device * dev, structdevice_attribute * attr);



Example:

device_create_file(dev,&dev_attr_power);

device_remove_file(dev,&dev_attr_power);



该文件的名字是'power' ，访问权限为0644 (-rw-r--r--).



警告: 无论何时，当内核允许对一个设备调用device_create_file()和

device_remove_file(), 用户空间对设备属性何时被创建有严格的期望. 当一个新设备注册到内核，会产生一个uevent以提示用户空间（比如udev）有新设备可用. 如果属性在设备注册之后才添加，用户空间则无从了解这个属性.



对于设备驱动而言，在探测（probe）设备时要做的一项重要工作是为设备发布额外的属性. 如果设备驱动只是简单地对传递给它的device结构调用device_create_file(), 那么用户空间永远无法获得新属性的通知. 相反地，设备驱动或许应当在模块入口函数modules_init()中使用class_create() 和 class->dev_attrs创建一个属性列表，而后在

.probe()中使用device_create()创建一个设备，作为被探测到的设备的子设备. 这个新的设备会产生uevent并将新的属性发布到用户空间.



举例来说，如果一个驱动想要增添如下属性:

struct device_attribute mydriver_attribs[] = {

__ATTR(port_count,0444, port_count_show),

__ATTR(serial_number,0444, serial_number_show),

NULL

};



在模块入口函数中应该做:

mydriver_class= class_create(THIS_MODULE, "my_attrs");

mydriver_class.dev_attr= mydriver_attribs;



假设'dev' 是传递到probe（）的参数，设备驱动的probe函数则要做:

device_create(&mydriver_class,dev, chrdev, &private_data, "my_name");