platform_device的注册过程分析

allen_yue

《Linux设备驱动程序》的linux设备模型章中说到设备模型中，所有设备都通过总线相连。添加设备devA，必须指定其device结构体的bus_type域，初始化其他域，然后调用device_register(&devA)，将设备devA注册到指定总线。
添加该设备驱动driverA，也必须指定其device_driver结构体的bus_type域，初始化其他域，然后调用driver_register(&driverA),将该驱动注册到总线上。
如果驱动driverA和设备devA匹配成功，即调用probe函数成功，则建立他们之间的符号链接，即将设备与驱动捆绑起来。

从2.6版本开始引入了platform这个概念，在开发底层驱动程序时，首先要确认的就是设备的资源信息，例如设备的地址，在2.6内核中将每个设备的资源用结构platform_device来描述，该结构体定义在kernel\include\linux\platform_device.h中，
struct platform_device {
       const char      * name;
       int           id;
       struct device   dev;
       u32         num_resources;
       struct resource       * resource;

       struct platform_device_id      *id_entry;
};
该结构一个重要的元素是resource，该元素存入了最为重要的设备资源信息，定义在kernel\include\linux\ioport.h中，
struct resource {
       resource_size_t start;
       resource_size_t end;
       const char *name;
       unsigned long flags;
       struct resource *parent, *sibling, *child;
};

下面举个例子来说明一下：
在kernel\arch\arm\mach-mmp\Devices.c定义了
static struct resource pxa-xxx_u2h_resources[] = {
       /* regbase */
       [0] = {
              .start       = PXA-xxx_U2H_REGBASE,
              .end = PXA-xxx_U2H_REGBASE + USB_REG_RANGE,
              .flags      = IORESOURCE_MEM,
              .name      = "u2h",
       },
       /* phybase */
       [1] = {
              .start       = PXA-xxx_U2H_PHYBASE,
              .end = PXA-xxx_U2H_PHYBASE + USB_PHY_RANGE,
              .flags      = IORESOURCE_MEM,
              .name      = "u2hphy",
       },
       [2] = {
              .start       = IRQ_PXA-xxx_USB2,
              .end = IRQ_PXA-xxx_USB2,
              .flags      = IORESOURCE_IRQ,
       },
};
这里定义了三组resource，它描述了一个usb host设备的资源，第1组描述了这个usb host寄存器设置，第二组描述了usb host物理地址设置， IORESOURCE_MEM表示第1组描述的是内存类型的资源信息，第3组描述了这个usb host设备的中断号，IORESOURCE_IRQ表示第2组描述的是中断资源信息。设备驱动会根据flags来获取相应的资源信息。

有了resource信息，就可以定义platform_device了：
struct platform_device pxa-xxx_device_u2h = {
        .name = "pxau2h-ehci",
        .id   = -1,
        .dev  = {
                .dma_mask = &ehci_hcd_pxa_dmamask,
                .coherent_dma_mask = DMA_BIT_MASK(32),
                .release = ehci_hcd_pxa_device_release,
        },

        .num_resources = ARRAY_SIZE(pxa-xxx_u2h_resources),
        .resource      = pxa-xxx_u2h_resources,
};
有了platform_device就可以调用函数platform_add_devices向系统中添加该设备了，这里的实现是
static inline int pxa-xxx_add_u2h(struct pxa_usb_plat_info *info)
{
       pxa-xxx_device_u2h.dev.platform_data = info;
       return platform_device_register(&pxa-xxx_device_u2h);
}
这里的aspenite_init必须在设备驱动加载之前被调用，可以把它放到
static void __init pxa-xxx_init(void)

驱动程序需要实现结构体struct platform_driver，参考kernel\driver\usb\host\ehci-pxau2h.c，
static struct platform_driver pxau2h_ehci_driver = {
       .probe = pxau2h_ehci_probe,
       .remove = pxau2h_ehci_remove,
       .shutdown = usb_hcd_platform_shutdown,
       .driver = {
                 .name = "pxau2h-ehci",
                 .bus = &platform_bus_type
                 },
#ifdef CONFIG_PM
       .suspend = pxau2h_driver_suspend,
       .resume = pxau2h_driver_resume,
#endif
};
在驱动初始化函数中调用函数platform_driver_register()注册platform_driver，需要注意的是ehci_device结构中name元素和pxau2h_ehci_driver结构中driver.name必须是相同的，这样在platform_driver_register()注册时会对所有已注册的所platform_device中的name和当前注册的platform_driver的driver.name进行比较，只有找到相同的名称的platfomr_device才能注册成功，当注册成功时会调用platform_driver结构元素probe函数指针，这里就是pxau2h_ehci_probe。

当进入probe函数后，需要获取设备的资源信息，获取资源的函数有：
struct resource * platform_get_resource(struct platform_device *dev, unsigned int type, unsigned int num);

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

struct resource * platform_get_resource_byname(struct platform_device *dev, unsigned int type, char *name);
根据参数name所指定的名称，来获取指定的资源。

int platform_get_irq_byname(struct platform_device *dev, char *name);
根据参数name所指定的名称，来获取资源中的中断号。


参考原文地址
http://www.eetop.cn/blog/?11145/action_viewspace_itemid_676.html



本文来自ChinaUnix博客，如果查看原文请点：http://blog.chinaunix.net/u3/105635/showart_2089765.html