linux驱动中的platform总线

    在设备驱动程序中经常会见到和platform相关的字段，分布在驱动程序的多个角落，这也是2.6内核中比较重要的一种机制，把它的原理弄懂了，对以后分析驱动程序很有帮助，下面简单介绍一下：

    在linux2.6设备模型中，关心总线，设备，驱动这三个实体，总线将设备和驱动绑定，在系统每注册一个设备的时候，会寻找与之匹配的驱动。相反，在系统每注册一个驱动的时候，寻找与之匹配的设备，匹配是由总线来完成的。
    一个现实的Linux 设备和驱动通常都需要挂接在一种总线上，对于本身依附于PCI、USB、I2C、SPI 等的设备而言，这自然不是问题，但是在嵌入式系统里面，SoC 系统中集成的独立的外设控制器、挂接在SoC 内存空间的外设等确不依附于此类总线。基于这一背景，Linux 发明了一种虚拟的总线，称为platform 总线
    SOC系统中集成的独立外设单元（I2C，LCD，SPI，RTC等）都被当作平台设备来处理，而它们本身是字符型设备。
    从Linux2.6内核起，引入一套新的驱动管理和注册机制：platform_device 和 platform_driver 。Linux 中大部分的设备驱动，都可以使用这套机制，设备用 platform_device 表示；驱动用platform_driver 进行注册。

 

platform_device 结构体       include/linux/platform_device.h

struct platform_device
{
    const char *name; //设备名
    u32 id;
    struct device dev;
    u32 num_resources; //设备所使用的各类资源数量
    struct resource *resource; //使用的资源
}

platform_driver 结构体       include/linux/platform_device.h

struct platform_driver
{
    int (*probe)(struct platform_device *);
    int (*remove)(struct platform_device *);
    void (*shutdown)(struct platform_device *);
    int (*suspend)(struct platform_device *, pm_message_t state);
    int (*suspend_late)(struct platform_device *, pm_message_t state);
    int (*resume_early)(struct platform_device *);
    int (*resume)(struct platform_device *);
    struct pm_ext_ops *pm;
    struct device_driver driver;
};

   

    系统为platform总线定义一个bus_type的实例platform_bus_type，通过其成员函数match()，确定device和driver如何匹配。
    匹配platform_device和platform_driver主要看二者的name字段是否相同。（name必须要相同才能匹配）

 

用platform_device_register()函数注册单个的平台设备。
一般是在平台的BSP文件中定义platform_device，通过platform_add_devices()函数将平台设备注册到系统中

 

platform_driver 的注册与注销：
 platform_driver_register()
 platform_driver_unregister()
 
以s3c2440 LCD驱动为例：
在BSP文件中：

struct platform_device s3c_device_lcd = {
    .name         = "s3c2410-lcd",
    .id         = -1,
    .num_resources     = ARRAY_SIZE(s3c_lcd_resource),
    .resource     = s3c_lcd_resource,
    .dev = {
        .dma_mask        = &s3c_device_lcd_dmamask,
        .coherent_dma_mask    = 0xffffffffUL
    }
};

为了完成LCD设备的注册，将其放进/arch/arm/mach-s3c2440/mach-smdk2440.c中定义的smdk2440_devices数组中：

static struct platform_device *smdk2440_devices[] __initdata = {
    ........
    ........
    &s3c_device_lcd,
};

由platform_add_devices(smdk2440_devices, ARRAY_SIZE(smdk2440_devices));注册

在相应的driver文件中：（/drivers/video/s3c2410fb.c）

static struct platform_driver s3c2410fb_driver = {
    .probe        = s3c2410fb_probe, //驱动探测
    .remove        = __devexit_p(s3c2410fb_remove), //驱动移除
    .suspend    = s3c2410fb_suspend,
    .resume        = s3c2410fb_resume,
    .driver        = {
        .name    = "s3c2410-lcd", //和platform_device中的name相同
        .owner    = THIS_MODULE,
    },
};

static int __devinit s3c2410_fb_init(void)
{
    return platform_driver_register(&s3c2410fb_driver);
}

static void __exit s3c2410fb_cleanup(void)
{
    platform_driver_unregister(&s3c2410fb_driver);
}

 

注册成功后会在下面两个目录下看到设备节点：
/sys/bus/platform/devices/
/sys/devices/platform/

 

平台设备资源和数据：
resource结构体：

struct resource
{
    resource_size_t start;
    resource_size_t end;
    const char *name;
    unsigned long flags;
    struct resource *parent, *sibling, *child;
};

 

我们通常关心start、end 和flags 这3 个字段，分别标明资源的开始值、结束值和类型，flags
可以为IORESOURCE_IO、IORESOURCE_MEM、IORESOURCE_IRQ、IORESOURCE_DMA 等。

如LCD资源：

static struct resource s3c_lcd_resource[] = {
    [0] = {
        .start = S3C24XX_PA_LCD, //LCD的IO资源起始地始（LCD控制器寄存器地址）
        .end = S3C24XX_PA_LCD + S3C24XX_SZ_LCD - 1, //结束地址
        .flags = IORESOURCE_MEM,
    },
    [1] = {
        .start = IRQ_LCD, //LCD中断号
        .end = IRQ_LCD,
        .flags = IORESOURCE_IRQ,
    }
};

在driver中用platform_get_resource()或platform_get_irq()等函数获取设备资源

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

获取到的内存或IO资源，需要ioremap后才能使用
获取到的IRQ资源，需要request_irq

 

    设备除了可以在BSP 中定义资源以外，还可以附加一些数据信息，因为对设备的硬件描述除了中断、内存、DMA 通道以外，可能还会有一些配置信息，而这些配置信息也依赖于板，不适宜直接放置在设备驱动本身，因此，platform 也提供了platform_data 的支持。

platform_data可以自定义，比如DM9000驱动，用platform_data描述它的一些属性：

static struct dm9000_plat_data s3c_dm9000_platdata = {
    .flags = DM9000_PLATF_16BITONLY,
};

static struct platform_device s3c_device_dm9000 = {
    .name = "dm9000",
    .id = 0,
    .num_resources = ARRAY_SIZE(s3c_dm9000_resource),
    .resource = s3c_dm9000_resource,
    .dev = {
        .platform_data = &s3c_dm9000_platdata,
    }
};

 

在相应的驱动中使用：
struct dm9000_plat_data *pdata = pdev->dev.platform_data;
可获取platform_data

 

    找一个和平台相关的驱动程序，从BSP文件开始分析它的结构，一直分析到它的最底层的硬件操作，这样很快就能熟悉platform的工作原理