之一:bus_type
总线是处理器和一个或多个设备之间的通道,在设备模型中,所有的设备都通过总线相连,甚至是内部的虚拟"platform"总线。可以通过ls -l /sys/bus看到系统加载的所有总线。
drwxr-xr-x
root
root
1970-01-01 00:02 platform
drwxr-xr-x
root
root
1970-01-01 00:02 spi
drwxr-xr-x
root
root
1970-01-01 00:02 scsi
drwxr-xr-x
root
root
1970-01-01 00:02 usb
drwxr-xr-x
root
root
1970-01-01 00:02 serio
drwxr-xr-x
root
root
1970-01-01 00:02 i2c
drwxr-xr-x
root
root
1970-01-01 00:02 mmc
drwxr-xr-x
root
root
1970-01-01 00:02 sdio
drwxr-xr-x
root
root
1970-01-01 00:02 ac97
总线可以相互插入。设备模型展示了总线和它们所控制的设备之间的实际连接。在Linux 设备模型中,总线由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
pm_ext_ops *pm;
struct
bus_type_private *p;
};
1,总线的注册和删除,总线的主要注册步骤:
(1)申明和初始化bus_type 结构体。只有很少的bus_type
成员需要初始化,大部分都由设备模型核心控制。但必须为总线指定名字及一些必要的方法。例如:
struct bus_type ldd_bus_type = {
.name =
"ldd",
.match =
ldd_match,
.uevent =
ldd_uevent,
};
(2)调用bus_register函数注册总线。int bus_register(struct bus_type
*bus),该调用可能失败,所以必须始终检查返回值。
ret = bus_register(&ldd_bus_type);
if (ret)
return ret;
若成功,新的总线子系统将被添加进系统,之后可以向总线添加设备。当必须从系统中删除一个总线时,调用:
void bus_unregister(struct bus_type *bus);
2,总线方法
在 bus_type 结构中定义了许多方法,它们允许总线核心作为设备核心与单独的驱动程序之间提供服务的中介,主要介绍以下两个方法:
int (*match)(struct device * dev, struct device_driver *
drv);
int (*uevent)(struct device *dev, struct kobj_uevent_env
*env);
对设备和驱动的迭代:若要编写总线层代码,可能不得不对所有已经注册到总线的设备或驱动进行一些迭代操作,这可能需要仔细研究嵌入到
bus_type 结构中的其他数据结构,但最好使用内核提供的辅助函数:
int bus_for_each_dev(struct bus_type *bus, struct device *start,
void *data, int (*fn)(struct device *, void *));
int bus_for_each_drv(struct bus_type *bus, struct device_driver
*start, void *data, int (*fn)(struct device_driver *, void
*));
3,总线属性
几乎Linux 设备模型中的每一层都提供添加属性的函数,总线层也不例外。bus_attribute 类型定义在 如下:
struct bus_attribute {
struct
attribute
attr;
ssize_t
(*show)(struct bus_type *, char * buf);
ssize_t
(*store)(struct bus_type *, const char * buf, size_t count);
};
内核提供了一个宏在编译时创建和初始化bus_attribute 结构:
BUS_ATTR(_name,_mode,_show,_store)
int bus_create_file(struct bus_type *bus, struct bus_attribute
*attr);
void bus_remove_file(struct bus_type *bus, struct bus_attribute
*attr);
例如创建一个包含源码版本号简单属性方法如下:
static ssize_t show_bus_version(struct bus_type *bus, char
*buf)
{
return snprintf(buf, PAGE_SIZE, "%sn",
Version);
}
static BUS_ATTR(version, S_IRUGO, show_bus_version, NULL); //得到bus_attr_version
if (bus_create_file(&ldd_bus_type,
&bus_attr_version))
printk(KERN_NOTICE "Unable to create version attributen");
之二:device
在最底层,Linux 系统中的每个设备由一个struct device 代表:
struct device
{
struct
klist klist_children;
struct
klist_node knode_parent;
struct
klist_node knode_driver;
struct
klist_node knode_bus;
struct
device *parent; * 设备的 "父"
设备,该设备所属的设备,通常一个父设备是某种总线或者主控制器。如果 parent 是 NULL, 则该设备是顶层设备,较少见
*/
struct
kobject kobj;
char bus_id[BUS_ID_SIZE];
const
char *init_name;
struct
device_type *type;
unsigned uevent_suppress:1;
struct
semaphore sem;
struct
bus_type *bus;
struct
device_driver *driver;
void *driver_data;
void *platform_data;
struct
dev_pm_info power;
#ifdef CONFIG_NUMA
int numa_node;
#endif
u64 *dma_mask;
u64 coherent_dma_mask;
struct
device_dma_parameters *dma_parms;
struct
list_head dma_pools;
struct
dma_coherent_mem *dma_mem;
struct
dev_archdata archdata;
spinlock_t devres_lock;
struct
list_head devres_head;
struct
list_head node;
struct
class *class;
dev_t devt;
struct
attribute_group **groups;
void (*release)(struct device
*dev);
};
(1)设备注册
在注册struct device 前,最少要设置parent, bus_id, bus, 和 release
成员,设备的注册和注销函数为:
int device_register(struct device *dev);
void device_unregister(struct device *dev);
一个实际的总线也是一个设备,所以必须单独注册,以下为lddbus注册它的虚拟总线设备:
static void ldd_bus_release(struct device *dev)
{
printk(KERN_DEBUG "lddbus releasen");
}
struct device ldd_bus = {
.bus_id = "ldd0",
.release = ldd_bus_release
};
ret = device_register(&ldd_bus);
if (ret)
printk(KERN_NOTICE "Unable to
register ldd0n");
(2)设备属性
sysfs 中的设备入口可有属性,相关的结构是:
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);
};
DEVICE_ATTR(_name,_mode,_show,_store);
int device_create_file(struct device
*device, struct device_attribute * entry);
void device_remove_file(struct device *
dev, struct device_attribute * attr);
一个实例是:终端执行:cd /sys/class/leds/lcd-backlight,
ls回显:
uevent
subsystem
device
power
brightness
这些属性可能都是通过device_create_file添加上去(至少brightness是这样)。进入device目录,再输入pwd,
回显:/sys/devices/platform/smdk-backlight。变换到devices目录下了,可见设备模型的不同构成是指向同一个设备的。
2.6下字符设备开始用struct cdev结构体表示,但是我想调用device_create_file(dev,
&dev_attr_debug);函数在/sys中导出信息,device_create_file()的第一个入口参数类型为struct
device结构体。问题是struct cdev与struct
device这两个结构体没有任何联系的地方?答案是可以采用共同拥有的Kobjcet这个成员作为纽带,所以从子类cdev--->父类
kobject--->子类device,推导得
到:container_of(kobj)-->list_entry(entry)->(struct
device*)
。因为containerof是从结构体指针成员找到结构体地址,所以从cdev的kobj可以找到父类kobject的地址,而所有的kobject的entery都是在一个链表里面,遍历这个链表,找到结构体成员为特定device结构的那一项。
(3)设备结构的嵌入
device 结构包含设备模型核心用来模拟系统的信息。但大部分子系统记录了关于它们拥有的设备的额外信息,所以很少单纯用device
结构代表设备,而是通常将其嵌入一个设备的高层结构体表示中。
lddbus 驱动创建了它自己的 device 类型(也即每类设备会建立自己的设备结构体,其中至少一个成员是struct
device类型,比如video_device),并期望每个设备驱动使用这个类型来注册它们的设备:
struct ldd_device {
char *name;
struct ldd_driver *driver;
struct device dev;
};
#define to_ldd_device(dev) container_of(dev, struct ldd_device,
dev);
lddbus 导出的注册和注销接口如下:
static void ldd_dev_release(struct device *dev)
{ }
int register_ldd_device(struct ldd_device *ldddev)
{
ldddev->dev.bus =
&ldd_bus_type;
//依赖的总线
ldddev->dev.parent =
&ldd_bus;
//父设备
ldddev->dev.release = ldd_dev_release;
strncpy(ldddev->dev.bus_id, ldddev->name, BUS_ID_SIZE);
//设备名拷贝入device结构体中
return
device_register(&ldddev->dev);
//仍然用device_register注册,只不过上层打包了
}
EXPORT_SYMBOL(register_ldd_device);
void unregister_ldd_device(struct ldd_device *ldddev)
{
device_unregister(&ldddev->dev);
}
EXPORT_SYMBOL(unregister_ldd_device);
之三:device_driver
设备模型跟踪所有系统已知的驱动,主要目的是使驱动程序核心能协调驱动和新设备之间的关系。一旦驱动在系统中是已知的对象就可能完成大量的工作。驱动程序的结构体device_driver
定义如下:
struct device_driver {
const
char *name;
struct
bus_type *bus;
struct
module *owner;
const char
*mod_name;
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 pm_ops *pm;
struct driver_private *p;
};
(1)驱动程序的注册和注销
int driver_register(struct device_driver *drv);
void driver_unregister(struct device_driver *drv);
(2)驱动程序的属性
struct driver_attribute {
struct attribute attr;
ssize_t (*show)(struct device_driver *drv, char
*buf);
ssize_t (*store)(struct device_driver *drv, const
char *buf, size_t count);
};
DRIVER_ATTR(_name,_mode,_show,_store)
*属性文件创建的方法:*/
int driver_create_file(struct device_driver * drv, struct
driver_attribute * attr);
void driver_remove_file(struct device_driver * drv, struct
driver_attribute * attr);
(3)驱动程序结构的嵌入
对大多数驱动程序核心结构,device_driver
结构通常被嵌入到一个更高层的、总线相关的结构中。当然也有直接注册驱动的,不用嵌入到高层结构体。如driver_register(&wm97xx_driver)。
以lddbus 子系统为例,它定义了ldd_driver 结构:
struct ldd_driver {
char *version;
struct module *module;
struct device_driver driver;
struct driver_attribute version_attr;
};
#define to_ldd_driver(drv) container_of(drv, struct ldd_driver,
driver);
lddbus总线中相关的驱动注册和注销函数是:
static ssize_t show_version(struct device_driver *driver, char
*buf)
{
struct
ldd_driver *ldriver = to_ldd_driver(driver);
sprintf(buf,
"%sn", ldriver->version);
return
strlen(buf);
}
int register_ldd_driver(struct ldd_driver
*driver) //device_driver被嵌入到更高层结构体
{
int ret;
driver->driver.bus = &ldd_bus_type;
ret =
driver_register(&driver->driver);
if (ret)
return ret;
driver->version_attr.attr.name =
"version";
driver->version_attr.attr.owner =
driver->module;
driver->version_attr.attr.mode = S_IRUGO;
driver->version_attr.show =
show_version;
driver->version_attr.store = NULL;
return driver_create_file(&driver->driver,
&driver->version_attr);
}
void unregister_ldd_driver(struct ldd_driver *driver)
{
driver_unregister(&driver->driver);
}
EXPORT_SYMBOL(register_ldd_driver);
EXPORT_SYMBOL(unregister_ldd_driver);
在sculld 中创建的 ldd_driver 结构如下:
static struct ldd_driver sculld_driver = {
.version =
"$Revision: 1.21 $",
.module =
THIS_MODULE,
.driver =
{
.name = "sculld",
},
};
之四:class_register
类是一个设备的高层视图,它抽象出了底层的实现细节,从而允许用户空间使用设备所提供的功能,而不用关心设备是如何连接和工作的。类成员通常由上层代码所控制,而无需驱动的明确支持。但有些情况下驱动也需要直接处理类。
几乎所有的类都显示在/sys/class目录中,可以通过ls -l
/sys/class来显示。出于历史的原因,有一个例外:块设备显示在/sys/block目录中。在许多情况,类子系统是向用户空间导出信息的最好方
法。当类子系统创建一个类时,它将完全拥有这个类,根本不用担心哪个模块拥有那些属性,而且信息的表示也比较友好。为了管理类,驱动程序核心导出了一些接
口,其目的之一是提供包含设备号的属性以便自动创建设备节点,所以udev的使用离不开类。类函数和结构与设备模型的其他部分遵循相同的模式,可与前三篇文章类比。
(1)管理类的接口和注册注销函数
类由 struct class 的结构体来定义:
struct class {
const
char *name; *每个类需要一个唯一的名字,
它将显示在 /sys/class 中*/
struct module *owner;
struct
class_attribute *class_attrs;
struct
device_attribute *dev_attrs;
struct
kobject *dev_kobj;
int (*dev_uevent)(struct device *dev, struct kobj_uevent_env *env);
void (*class_release)(struct class *class);
void (*dev_release)(struct device *dev);
int (*suspend)(struct device *dev, pm_message_t state);
int (*resume)(struct device *dev);
struct pm_ops *pm;
struct class_private *p;
};
int class_register(struct class *cls);
void class_unregister(struct class *cls);
struct class_attribute {
struct attribute attr;
ssize_t
(*show)(struct class *cls, char *buf);
ssize_t (*store)(struct class *cls, const char *buf, size_t
count);
};
CLASS_ATTR(_name,_mode,_show,_store);
int class_create_file(struct class *cls, const struct
class_attribute *attr);
void class_remove_file(struct class *cls, const struct
class_attribute *attr);、
(2)类设备,类存在的真正目的是给作为类成员的各个设备提供一个容器,成员由struct class_device
来表示,暂没用到。
(3)类接口
类子系统有一个 Linux
设备模型的其他部分找不到的附加概念,称为“接口”,可将它理解为一种设备加入或离开类时获得信息的触发机制,结构体如下:
struct class_interface {
struct list_head node;
struct class *class;
int
(*add_dev) (struct device *,
struct class_interface *);
void (*remove_dev) (struct device *, struct
class_interface *);
};
int class_interface_register(struct class_interface
*class_intf);
void class_interface_unregister(struct class_interface
*class_intf);
设定class的好处:设备驱动一般在注册的时候都会调用此类class的一些函数,主要作用就是在sys目录里面创建一些节点,比如cd到/sys /class下面可以看到这一类的设备,与这个相关的就是一些kobjects。当然对于一个新设备,可以注册进一个class也可以不注册进去,如果存 在对应class的话注册进去更好。
文章来源: 博客园
- 还没有人评论,欢迎说说您的想法!