红联Linux门户
Linux帮助

Linux驱动程序中的platform总线详解

发布时间:2015-03-01 11:11:34来源:linux网站作者:xgc94418297

在设备驱动程序中经常会见到和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的工作原理。