分类： LINUX
2014-07-07 17:53:09
原文地址：总线设备驱动模型总结 作者：gongping11
主机开发环境：Fedora14
开发板： TQ2440
编译器： arm-linux-gcc-4.3.2
总线设备驱动模型其实现主要是基于Kobject和sysfs等机制，对于驱动模型程序开发主要是理解三个元素：总线、设备、驱动的关系。三者之间因为一定的联系性实现对设备的控制。
首先是总线，总线是三者联系起来的基础，通过一种总线类型，将设备和驱动联系起来。总线类型中的match函数用来匹配设备和驱动。当匹配操作晚餐之后就会控制驱动程序中的probe函数。
总线设备驱动模型的设计主要包括三个元素的注册，将三个元素加载到内核中，然后通过内核的内部机制将三者联系起来。
首先，总线类型的注册，包括属性文件的添加，总线也是一种设备，也需要将总线设备注册。
其次，完成设备的注册和添加以及对设备添加设备属性文件，同时填充最基本的函数操作。
最后，完成驱动的注册和天极以及对设备驱动添加属性文件，同时填充最基本的函数操作。
1、总线
总线类型是通过结构体bus_type表示的。其源码如下所示：
struct bus_type {
/*总线名*/
const char *name;
/*总线、设备、驱动属性*/
struct bus_attribute *bus_attrs;
struct device_attribute *dev_attrs;
struct driver_attribute *drv_attrs;
/*总线支持的函数操作*/
/*匹配函数，主要用来识别相应的设备和驱动，是两者直接形成关联
用来判断指定的驱动程序能否处理指定的设备
*/
int (*match)(struct device *dev, struct device_driver *drv);
/*在进行热插拔事件之前，为设备配置环境变量操作函数*/
int (*uevent)(struct device *dev, struct kobj_uevent_env *env);
int (*probe)(struct device *dev);
int (*remove)(struct device *dev);
void (*shutdown)(struct device *dev);
int (*suspend)(struct device *dev, pm_message_t state);
int (*suspend_late)(struct device *dev, pm_message_t state);
int (*resume_early)(struct device *dev);
int (*resume)(struct device *dev);
struct dev_pm_ops *pm;
struct bus_type_private *p;
};
其中的int (*match)(struct device * dev, struct device_driver * drv)是必须实现的函数，因为这个函数主要是实现设备和驱动之间的匹配管理。其中匹配的具体逻辑关系需要驱动设计着设定。
int (*uevent)(struct device *dev, char **envp, int num_envp,char *buffer, int buffer_size)则在热插拔事件之前，允许总线为设备添加环境变量。
通常创建一种总线类型的过程中只要完成总线类型结构体的填充，然后完成相应的注册、属性文件创建即可实现总线类型的添加。并不需要对bus_type类型中的所有变量进行赋值，只要将其中的name,bus_attribute,match实现即可。
最后不要忘了总线也是设备，需要将总线设备添加到内核中（注册函数）。
关于总线类型的属性设置，实质上就是完成一个结构体的操作。
如下源码所示：
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);
};
/*可以通过宏命令定义一个总线结构体，但是需要自己实现属性读写操作函数，如果没有，可设置为NULL*/
/*总线属性定义宏*/
#define BUS_ATTR(_name, _mode, _show, _store) \
struct bus_attribute bus_attr_##_name = __ATTR(_name, _mode, _show, _store)
/*__ATTR的宏实现如下所示：*/
#define __ATTR(_name,_mode,_show,_store) { \
.attr = {.name = __stringify(_name), .mode = _mode }, \
.show = _show, \
.store = _store, \
}
由于通常情况下需要查找总线的版本信息，可以将版本信息添加到属性的读属性操作函数中，这样就能显示具体的版本信息。
在宏定义中##是指链接符的作用，相当于将两个部分链接起来，比如bus_attr_##name = bus_attr_name。这是在宏定义中比较常用的定义方式之一。
总线类型的注册和总线类型属性文件创建，以及总线设备的注册主要是依据下面几个函数来实现：
/*总线类型注册函数，由于可能会出错，因此必须对返回值进行检查*/
int __must_check bus_register(struct bus_type *bus);
/*总线类型释放函数*/
void bus_unregister(struct bus_type *bus);
/*总线文件属性创建函数，将相关的文件属性添加给总线类型，同时也必须检查返回值是否正确*/
int __must_check bus_create_file(struct bus_type *,struct bus_attribute *);
/*总线类型文件属性删除函数，将两者之间的关联性切断*/
void bus_remove_file(struct bus_type *, struct bus_attribute *);
最后需要将总线设备添加到系统中，主要采用设备注册函数;
设备注册函数：
int __must_check device_register(struct device *dev);
设备释放函数：
void device_unregister(struct device *dev);
2、设备
设备的实现主要是依靠struct device函数实现的，设备的实现主要是对结构体的填充。实现相应的函数即可。
struct device {
/*父设备，通常就是总线设备，这也是为什么需要将总线作为设备添加的原因*/
struct device *parent;
struct device_private *p;
struct kobject kobj;
/*init_name是新添加的，替代了原来的bus_id,但是init_name不能直接被读写操作*/
const char *init_name; /* initial name of the device */
struct device_type *type;
struct semaphore sem; /* semaphore to synchronize calls to
* its driver.
*/
/*总线类型，主要是关联总线类型，这是前面添加的总线类型，通过相同的总线类型关联设备和驱动*/
struct bus_type *bus; /* type of bus device is on */
struct device_driver *driver; /* which driver has allocated this device */
void *driver_data; /* data private to the driver */
void *platform_data; /* Platform specific data, device
core doesn't touch it */
struct dev_pm_info power;
#ifdef CONFIG_NUMA
int numa_node; /* NUMA node this device is close to */
#endif
u64 *dma_mask; /* dma mask (if dma'able device) */
u64 coherent_dma_mask; /* Like dma_mask, but for
alloc_coherent mappings as
not all hardware supports
64 bit addresses for consistent
allocations such descriptors. */
struct device_dma_parameters *dma_parms;
struct list_head dma_pools; /* dma pools (if dma'ble) */
struct dma_coherent_mem *dma_mem; /* internal for coherent mem
override */
/* arch specific additions */
struct dev_archdata archdata;
dev_t devt; /* dev_t, creates the sysfs "dev" */
spinlock_t devres_lock;
struct list_head devres_head;
struct klist_node knode_class;
struct class *class;
struct attribute_group **groups; /* optional groups */
/*必须实现的release函数*/
void (*release)(struct device *dev);
};
/*由于init_name 不能直接读写，只能通过*dev_name来读写设备名*/
static inline const char *dev_name(const struct device *dev)
{
return kobject_name(&dev->kobj);
}
/*实现对设备名的设置*/
int dev_set_name(struct device *dev, const char *name, ...)
__attribute__((format(printf, 2, 3)));
/*设备文件属性结构体，必须注意的改变点*/
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);
};
/*设备属性宏定义，主要用来实现设备文件属性*/
#define DEVICE_ATTR(_name, _mode, _show, _store) \
struct device_attribute dev_attr_##_name = __ATTR(_name, _mode, _show, _store)
/*创建设备文件属性函数，必须检查返回值*/
int __must_check device_create_file(struct device *device,struct device_attribute *entry);
/*删除设备文件属性函数*/
void device_remove_file(struct device *dev,struct device_attribute *attr);
/*设备注册函数，必须检查返回值*/
int __must_check device_register(struct device *dev);
/*设备释放函数*/
void device_unregister(struct device *dev);
需要注意的是linux-2.6.30内核以前，没有init_name元素，而是元素bus_id，这个主要是实现设备名的填充，但是linux-2.6.30内核之后的在struct device中init_name代替了bus_id,但是需要注意的是init_name不能直接被读写，当需要读写设备名时只能采用特定的函数实现:dev_name()，set_dev_name()。当直接读写init_name会导致内核错误，出现Unable to handle kernel NULL pointer dereference at virtual address 00000000的错误。
最后注意device_attribute中的show,store函数不同于其他类型（总线、驱动）的函数，device_attribute中的show和store函数中的参数数量多了一个。
3、驱动
驱动管理一定的设备，其中的关系主要是内核的内部机制实现的，但是实现的具体逻辑需要在bus_type中的match函数中具体设计。通常是一定的设备名和驱动名匹配，当然也可以有其他的逻辑，具体的只需要设计好bus_type中的match函数。
驱动是由驱动结构体实现的。具体如下所示：
/*驱动结构体*/
struct device_driver {
/*驱动名，通常用来匹配设备*/
const char *name;
/*关联的总线类型，总线、设备、驱动关联的总线类型*/
struct bus_type *bus;
struct module *owner;
const char *mod_name; /* used for built-in modules */
/*驱动中最应该实现的操作函数主要包括probe和remove函数*/
/*当匹配完成以后的，入口函数*/
int (*probe) (struct device *dev);
/*驱动卸载时操作的相关函数，退出函数*/
int (*remove) (struct device *dev);
void (*shutdown) (struct device *dev);
int (*suspend) (struct device *dev, pm_message_t state);
int (*resume) (struct device *dev);
struct attribute_group **groups;
struct dev_pm_ops *pm;
struct driver_private *p;
};
/*驱动注册函数，返回值必须检测*/
int __must_check driver_register(struct device_driver *drv);
/*驱动释放函数*/
void driver_unregister(struct device_driver *drv);
/*驱动属性结构体*/
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);
};
/*驱动属性定义宏命令*/
#define DRIVER_ATTR(_name, _mode, _show, _store) \
struct driver_attribute driver_attr_##_name = \
__ATTR(_name, _mode, _show, _store)
/*驱动属性文件创建函数，返回值必须检测*/
int __must_check driver_create_file(struct device_driver *driver,struct driver_attribute *attr);
/*驱动属性文件移除函数*/
void driver_remove_file(struct device_driver *driver,struct driver_attribute *attr);
驱动结构体的定义不需要完成所有元素的赋值，只需要完成主要的几个变量的赋值即可，其中主要的元素包含name,bus,以及probe和remove函数的实现。
其中的probe函数是当总线中的match完成匹配操作以后，进入驱动的入口函数，因此必须实现。remove我认为就是对应的退出函数，因此也有必要实现。
驱动的注册,释放也有相关的函数来操作，主要是driver_register()和driver_unregister()。
总结：
1、在总线驱动模型中我认为最主要的是搞清楚三个不同的结构体，分别是总线、驱动、设备。了解三个元素对应的属性结构体以及相应的属性操作函数的差异性。
2、不同驱动设计的关键主要是完成不同结构体的填充过程，但是并不需要对结构体中所有的对象进行赋值，只需要完成重要的几个元素的值。
3、总线是一种类型，同时也是一种设备，在总线的相关处理中需要首先添加总线类型，然后添加总线设备，这是需要注意的。由于总线类型关联驱动和设备，因此需要导出总线类型变量。由于总线设备是设备的父设备，因此也需要将总线设备变量导出。同样在驱动和设备中也要导出相关的结构体变量，便于总线中的match函数实现驱动和设备的匹配操作。
4、XXX_attr结构体基本相同，都是一个属性结构体和函数show()、stroe()。但是不同的XXX可能会导致show、stroe函数的参数发生变化。这需要对照源码。
5、struct device中的init_name是一个特殊的量，不能直接读写操作，只能采用函数device_name()和set_device_name来设置设备名。
6、xxx_register()之类的函数，需要对返回值进行检查。因为很有可能不成功。
