Linux Platform Device and Driver

 

参考资料：

linux-2.6.24/Documentation/driver-model/platform.txt

http://blog.chinaunix.net/u2/60011/showart_1018502.html

《platform _device 和 platform_driver 注册过程》

http://www.eetop.cn/blog/html/45/11145-676.html

http://blog.csdn.net/unbutun/archive/2009/03/25/4023313.aspx

 

    从 Linux 2.6 起引入了一套新的驱动管理和注册机制 :platform_device 和 platform_driver 。 Linux 中大部分的设备驱动，都可以使用这套机制 , 设备用 platform_device 表示，驱动用 platform_driver 进行注册。   

      Linux platform driver 机制和传统的 device driver 机制 ( 通过 driver_register 函数进行注册 ) 相比，一个十分明显的优势在于 platform 机制将设备本身的资源注册进内核，由内核统一管理，在驱动程序中使用这些资源时通过 platform device 提供的标准接口进行申请并使用 。这样提高了驱动和资源管理的独立性，并且拥有较好的可移植性和安全性 ( 这些标准接口是安全的 ) 。

    platform 机制的本身并不复杂，由两部分组成： platform _ device 和  platform _ driver

    通过 Platform 机制开发发底层驱动的大致流程为 :  定义 platform_device -> 注册 platform_device -> 定义 platform_driver -> 注册 platform_driver 。

 

数据结构

在 2.6 内核中 platform 设备用结构体 platform_device 来描述，

// 该结构体定义在kernel/include/linux/platform_device.h struct platform_device { const char * name; u32 id; struct device dev; u32 num_resources; struct resource * resource; };

该结构一个重要的元素是 resource ，该元素存入了最为重要的设备资源信息，

// 定义在kernel/include/linux/ioport.h struct resource { const char *name; unsigned long start, end; unsigned long flags; struct resource *parent, *sibling, *child; };

实际上是对地址范围及其属性的一个描述。最后几个用于树型结构的指针是内核用于管理所有资源的。

 

定义resource

下面举 s3c2410 平台的 i2c 驱动作为例子来说明：

/* arch/arm/mach-s3c2410/devs.c */ /* I2C */ static struct resource s3c_i2c_resource[] = { [0] = { .start = S3C24XX_PA_IIC, .end = S3C24XX_PA_IIC + S3C24XX_SZ_IIC - 1, .flags = IORESOURCE_MEM, }, [1] = { .start = IRQ_IIC, //S3C2410_IRQ(27) .end = IRQ_IIC, .flags = IORESOURCE_IRQ, } };

       这里定义了两组resource，它描述了一个I2C设备的资源，第1组描述了这个I2C设备所占用的总线地址范围，IORESOURCE_MEM表示第 1组描述的是内存类型的资源信息，第2组描述了这个I2C设备的中断号，IORESOURCE_IRQ表示第2组描述的是中断资源信息。设备驱动会根据 flags来获取相应的资源。

 

platform_device

 

struct platform_device s3c_device_i2c = { .name = "s3c2410-i2c", .id = -1, .num_resources = ARRAY_SIZE(s3c_i2c_resource), .resource = s3c_i2c_resource, }; 。。。。 platform_add_devices(...); // 向内核注册设备

 

        定义好了platform_device结构体后就可以调用函数platform_add_devices向系统中添加该设备 了，之后可以调用 platform_driver_register()进行设备注册 。要注意的是，这里的platform_device设备的注册过程必须在相应设备驱动加载之前被调用，即执行platform_driver_register之前,原因是因为驱动注册时需要匹配内核中所以已注册的设备名 。

 

platform_driver

 

// include/linux/platform_device.h /* device driver for platform bus bits */ static struct platform_driver s3c2410_i2c_driver = { .probe = s3c24xx_i2c_probe, .remove = s3c24xx_i2c_remove, .resume = s3c24xx_i2c_resume, .driver = { .owner = THIS_MODULE, .name = "s3c2410-i2c", }, }; ... platform_driver_register(...); // 向内核注册驱动

       在驱动初始化函数中调用函数platform_driver_register()注册platform_driver，需要注意的是 s3c_device_i2c结构中name元素和s3c2410_i2c_driver结构中driver.name必须是相同的，这样在 platform_driver_register()注册时会对所有已注册的所有platform_device中的name和当前注册的 platform_driver的driver.name进行比较，只有找到相同的名称的platfomr_device才能注册成功，当注册成功时会调用platform_driver结构元素probe函数指针，这里就是s3c24xx_i2c_probe,当进入probe函数后，需要获取设备的资源信息，常用获取资源的函数主要是：

struct resource * platform_get_resource(struct platform_device *dev, unsigned int type, unsigned int num);
根据参数type所指定类型，例如IORESOURCE_MEM，来获取指定的资源。

 

那什么情况使用 platform driver 机制编写驱动

     我的理解是只要和内核本身运行依赖性不大的外围设备 ( 换句话说只要不在内核运行所需的一个最小系统之内的设备 ), 相对独立的 , 拥有各自独自的资源 (addresses and IRQs) ， 都可以用 platform_driver 实现。如： lcd,usb,uart 等，都可以用 platfrom_driver 写，而 timer,irq 等最小系统之内的设备则最好不用 platfrom_driver 机制，实际上内核实现也是这样的。

 

/* 以下为本人注解：

1、更多的概况了解，可参考文档 Documentation/driver-model/platform.txt

2、在 Understanding the Linux Kernel一书的第13.1.1.1节中有这样一段话

      “... 尽管访问I/O端口很容易, 检测哪个I/O端口已被分配给I/O设备却并非易事. 对基于ISA总线(译注:原始IBM PC采用的总线)的系统来说尤其如此. 通常设备驱动必须盲目地写数据到一些I/O端口来探测设备的存在, 然而,如果该端口已经被另外一种设备占用, 这样的操作就可能导致系统崩溃... ”

        以下为文档platform.txt中的话：

        “... 不提倡这种驱动方式. 假如你在升级这样一个驱动, 请尽力把设备列举从驱动中转移到更合适的地方. 这样做很赚, 因为驱动程序一开始就处在"正常模式", 可以直接使用由即插即用(PNP)设置或平台设备设置代码所创建的设备..

struct platform_ device *platform_device_alloc(const char *name, int id);

你可以用 platform_device_alloc _alloc( )来动态地给设备分配空间, 然后在用platform_device_register()加上一些资源来初始化该设备.

经常也用另外一个更好的解决办法:

struct platform_device *platform_device_register_simple(const char *name, int id,struct resource *res, unsigned int nres);

你可以用platform_device_register_simple()一次完成分配空间和注册设备的任务, 设备命名和驱动绑定 ”

        所以，比较老的现成的较多的驱动中，我们可以看到用 request_mem_region()和 request_irq()等申请device资源,而看到上面的话后，在最新的驱动中，应尽量的采用platform_device_alloc等platform机制的函数实现。