Linux2.6的内核中引入了一种新的设备驱动模型-平台(platform)设备驱动,平台设备驱动分为平台设备(platform_device)和平台驱动(platform_driver),平台设备的引入使得Linux设备驱动更加便于移植。

一、平台设备
平台设备结构体:

1 struct platform_device {
 2     const char    * name;                      /* 设备名 */
 3     int        id;
 4     struct device    dev;                     /* 设备结构体 */
 5     u32        num_resources;                   /* 设备资源数量 */
 6     struct resource    * resource;              /* 设备资源 */
 7 
 8     const struct platform_device_id    *id_entry;
 9 
10     /* arch specific additions */
11     struct pdev_archdata    archdata;
12 };

平台设备主要是提供设备资源和平台数据给平台驱动,resource为设备资源数组,类型有IORESOURCE_IO、IORESOURCE_MEM、IORESOURCE_IRQ、IORESOURCE_DMA、IORESOURCE_DMA。下面是一个网卡芯片DM9000的外设资源:

1 static struct resource dm9000_resources[] = {
 2     [0] = {
 3         .start        = S3C64XX_PA_DM9000,
 4         .end        = S3C64XX_PA_DM9000 + 3,
 5         .flags        = IORESOURCE_MEM,
 6     },
 7     [1] = {
 8         .start        = S3C64XX_PA_DM9000 + 4,
 9         .end        = S3C64XX_PA_DM9000 + S3C64XX_SZ_DM9000 - 1,
10         .flags        = IORESOURCE_MEM,
11     },
12     [2] = {
13         .start        = IRQ_EINT(7),
14         .end        = IRQ_EINT(7),
15         .flags        = IORESOURCE_IRQ | IRQF_TRIGGER_HIGH,
16     },
17 };

dm9000_resources里面有三个设备资源,第一个为IORESOURCE_MEM类型,指明了第一个资源内存的起始地址为S3C64XX_PA_DM9000结束地址为S3C64XX_PA_DM9000 + 3,第二个同样为IORESOURCE_MEM类型,指明了第二个资源内存的起始地址为S3C64XX_PA_DM9000 + 4结束地址为S3C64XX_PA_DM9000 + S3C64XX_SZ_DM9000 - 1,第三个为IORESOURCE_IRQ类型,指明了中断号为IRQ_EINT(7)。

1 struct device {
 2     struct device        *parent;
 3 
 4     struct device_private    *p;
 5 
 6     struct kobject kobj;
 7     const char        *init_name; /* initial name of the device */
 8     struct device_type    *type;
 9 
10     struct mutex        mutex;    /* mutex to synchronize calls to
11                      * its driver.
12                      */
13 
14     struct bus_type    *bus;        /* type of bus device is on */
15     struct device_driver *driver;    /* which driver has allocated this
16                        device */
17     void        *platform_data;    /* Platform specific data, device
18                        core doesn't touch it */
19     ...
20 };

 

struct device结构体里面有一个重要成员platform_data,它是平台设备和平台驱动进行数据传递的重要成员。

 

平台设备注册:

1 int platform_device_register(struct platform_device *pdev);

platform_device_register()会对平台设备进行相应的初始化之后调用platform_device_register()函数把它添加到子系统中。

 

平台设备注销:

1 void platform_device_unregister(struct platform_device *pdev);

platform_device_unregister()函数释放设备资源之后从子系统中将其移除。

 

平台设备模板:

1 static struct resource xxx_resource = 
 2 {
 3     [0] = 
 4     {
 5         .start = ...,
 6         .end = ...,
 7         .flags = ...,
 8     },
 9     [1] = 
10     {
11         ...
12     }
13     ...
14 };
15 
16 static struct xxx_plat_data xxx_data = 
17 {
18     ...
19 };
20 
21 static struct platform_device xxx_platform_device = 
22 {
23     .name = NAME,
24     .num_resources = ARRAY_SIZE(xxx_resource),
25     .resource = xxx_resource,
26     .dev = 
27     {
28         .platform_data = &xxx_data,
29     }
30 };
31 
32 static int __init xxx_device_init(void)
33 {
34     ...
35     /* 注册平台设备 */
36     platform_device_register(&xxx_platform_device);
37     ...
38 }
39 
40 static void __exit xxx_device_exit(void)
41 {
42     ...
43     /* 注销平台设备 */
44     platform_device_unregister(&xxx_platform_device);
45     ...
46 }

 

 

二、平台驱动
平台驱动结构体:

1 struct platform_driver {
2     int (*probe)(struct platform_device *);
3     int (*remove)(struct platform_device *);
4     void (*shutdown)(struct platform_device *);
5     int (*suspend)(struct platform_device *, pm_message_t state);
6     int (*resume)(struct platform_device *);
7     struct device_driver driver;
8     const struct platform_device_id *id_table;
9 };

平台驱动结构体driver成员里面的name必须与平台设备结构体里面的name成员一致,在系统注册一个设备的时候,会通过设备结构体里面的name成员和平台驱动driver里面的name成员匹配,当匹配成功则调用平台驱动的probe函数,
通常在probe函数中获取平台设备的资源和私有数据并进行设备的初始化。

获取设备资源:

1 struct resource *platform_get_resource(struct platform_device *dev, unsigned int type, unsigned int num);

platform_get_resource()函数用于获取平台设备的资源,dev为要平台设备,type为平台设备资源类型,num为平台资源号(比如同一个资源有两个则资源号为0,1)。

 

平台驱动注册:

1 int platform_driver_register(struct platform_driver *drv);

platform_driver_register()函数完成平台驱动的注册,在驱动模块加载时调用。

 

平台驱动注销:

1 void platform_driver_unregister(struct platform_driver *drv);

platform_driver_unregister()函数完成平台驱动的注销,在驱动模块卸载时调用。

 

平台驱动模板:

1 static int __devinit xxx_probe(struct platform_device *pdev)
 2 {
 3     struct xxx_plat_data *pdata = pdev->dev.platform_data;    /* 获取私有数据 */
 4     platform_get_resource(pdev,xxx,x);                        /* 获取设备资源 */
 5     ...
 6 }
 7 
 8 static struct platform_driver xxx_platform_driver = 
 9 {
10     .probe = xxx_probe,
11     .remove = __devexit_p(xxx_remove),
12     .driver = 
13     {
14         .name = NAME,    /* 跟平台设备名一致 */
15         ...
16     },
17     ...
18 };
19 
20 static int __init xxx_driver_init(void)
21 {
22     ...
23     /* 驱动注册 */
24     platform_driver_register(&xxx_platform_driver);
25     ...
26 }
27 
28 static void __exit xxx_driver_exit(void)
29 {
30     ...
31     /* 驱动注销 */
32     platform_driver_unregister(&xxx_platform_driver);
33     ...
34 }