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 }