一、让 LCD 显示可爱的小企鹅
还是先说说环境吧，处理器为 S3C2410 ， linux 的版本当然是 2.6.20 的。下面先说说怎样让 LCD 上显示出可爱的小企鹅。最直接的步骤如下（记住不要问为什么哈～ _ ～，一步一步跟着走就行了）：
1. 添加 s3c2410 处理器的 LCD 控制寄存器的初始值，具体做法为在文件 arch/arm/mach-s3c2410/mach-smdk2410.c 中添加 struct s3c2410fb_mach_info 类型的寄存器描述讯息，如下所示：
static struct s3c2410fb_mach_info smdk2410_lcd_platdata = {
.fixed_syncs=0,
.type = S3C2410_LCDCON1_TFT,
.width= 240,
.height= 320,
.xres = {
.defval= 240,
.min= 240,
.max= 240,
},
.yres = {
.defval= 320,
.min= 320,
.max= 320,
},
.bpp = {
.defval= 16,
.min= 16,
.max= 16,
},
.regs = {
.lcdcon1= S3C2410_LCDCON1_TFT16BPP | /
S3C2410_LCDCON1_TFT | /
S3C2410_LCDCON1_CLKVAL(5) | /
(0<<7),
.lcdcon2= S3C2410_LCDCON2_VBPD(2) | /
S3C2410_LCDCON2_LINEVAL(320-1) | /
S3C2410_LCDCON2_VFPD(2) | /
S3C2410_LCDCON2_VSPW(4),
.lcdcon3= S3C2410_LCDCON3_HBPD(8) | /
S3C2410_LCDCON3_HOZVAL(240-1) | /
S3C2410_LCDCON3_HFPD(8),
.lcdcon4= S3C2410_LCDCON4_HSPW(6) | /
S3C2410_LCDCON4_MVAL(13),
.lcdcon5= S3C2410_LCDCON5_FRM565 |
S3C2410_LCDCON5_HWSWP,
},
.gpcup= 0x0,
.gpcup_mask= 0xFFFFFFFF,
.gpccon= 0xaaaa56a9,
.gpccon_mask= 0xFFFFFFFF,
.gpdup= 0x0,
.gpdup_mask= 0xFFFFFFFF,
.gpdcon= 0xaaaaaaaa,
.gpdcon_mask= 0xFFFFFFFF,
.lpcsel= 0x00
};2. 通过 s3c24xx_fb_set_platdata 函数向内核注册上面的信息。具体做法为：修改 s3c24xx_fb_set_platdata 函数（当然也可以重新起名字），修改如下：（此函数在 arch/arm/mach-s3c2410/devs.c 中）
void __init s3c24xx_fb_set_platdata(struct s3c2410fb_mach_info *pd)
{
s3c_device_lcd.dev.platform_data = pd;
}然后在 arch/arm/mach-s3c2410/mach-smdk2410.c 的 smdk2410_map_io 函数中调用 s3c24xx_fb_set_platdata( ) ，具体为：
s3c24xx_fb_set_platdata(&smdk2410_lcd_platdata);
注：此处未采用内核中提供的源函数，因为系统会崩溃，估计是它调用 kmalloc 函数引起的。
3. 在 make menuconfig 的时候配置 Linux 的 logo 选项，然后的时候在 console 选项中选上 framebuffer console surpport ，要不然看不到小企鹅。
上面这些步骤均来源于网上，感谢您们的无私贡献！嘿嘿，到目前为止差不多也可以交差了，但我还想深入了解一下真正的驱动程序。呵呵，欲知后事如何且听下回分解。
二、 s3c2410fb_probe 函数分析
2.1 驱动的入口点
摆在面前的第一个问题相信应该是，这个函数是从那里开始运行的。这里就应该从long long ago 开始了，打开drivers/video/s3c2410fb.c 文件，然后找到s3c2410fb_init 函数，先不管它里面是怎么回事，再把目光下移就会看到这样一串字符串module_init(s3c2410fb_init) ，郁闷，这和S3C2410fb_probe 有啥关系嘛？这个问题问的好！不要着急慢慢往下面走。先摸摸module_init 是何方神圣再说，于是乎我就登陆了http://lxr.linux.no/linux+v2.6.20/ 网站，在上面一搜，原来module_init 老家在include/linux/init.h ，原来它居然还有两重身份，其原型如下：
#ifndef MODULE
……
#define module_init(x) __initcall(x); ①
……
#else
……
#define module_init(initfn) / ②
static inline initcall_t __inittest(void) /
{ return initfn; } /
int init_module(void) __attribute__((alias(#c)));
……
#endif 上面啰嗦了这么多，最终是要说明只要用module_init 申明了一个函数，该函数就会被Linux 内核在适当的时机运行，这些时机包括在linux 启动的do_initcalls() 时调用（设备被编译进内核），或者在动态插入时调用。
回到上面的module_init(s3c2410fb_init) 处，也就是说内核与buffer 驱动发生关系的第一次地点是在s3c2410fb_init 函数，该函数就只有一条语句
platform_driver_register (&s3c2410fb_driver) ；
？？？？？？……
2.2 platform 是何许人也
platform 可以理解成一种设备类型，就像字符设备、块设备和网络设备一样，而LCD 就属于这种设备。对于platform 设备Linux 为应用添加了相关的接口，在这里只是简单的说说这些接口的用法，而不去深入探讨这些接口的实现（我现在还没有那个能力呢！）。说到这里，马上就有个问题涌上心头了，那就是Linux 提供了那些接口呢？如果我们需要添加这些设备应该怎么样做呢？
platform 中的相关数据结构是应用的关键，为了向内核添加一个platform 设备，程序员应该填写两个数据结构platform_device 和platform_driver ，这两个数据结构的定义都可以在include/linux/platform_device.h 文件中找到。看看LCD 驱动是怎么做的，第一步是填写platform_device ，在arch/arm/mach-s3c2410/devs.c 可以找到填写platform_device 的代码，如下：
static u64 s3c_device_lcd_dmamask = 0xffffffffUL;
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
}
};#define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))
该宏可以方便的求出一个数组中有多少数据成员，这在很多情况下是很有用的，比如对于 int a[]={1,5,65,23,12,20,3} 数组，可以使用该宏求出a[] 有7 个元素。
另外，platform_device 的另外一项重要成员是resource ，在上面的代码中此域被赋予了s3c_lcd_resource ，s3c_lcd_resource 也可以在arch/arm/mach-s3c2410/devs.c 找到。
static struct resource s3c_lcd_resource[] = {
[0] = {
.start = S3C24XX_PA_LCD,
.end = S3C24XX_PA_LCD + S3C24XX_SZ_LCD - 1,
.flags = IORESOURCE_MEM,
},
[1] = {
.start = IRQ_LCD,
.end = IRQ_LCD,
.flags = IORESOURCE_IRQ,
}
}; 最后在smdk2410_devices 指针数组中添加上s3c_device_lcd 的大名，Linux 在初始化platform 的时候就知道系统中有个s3c_device_lcd 设备了。注意了这里只是向Linux 描述了设备需要的资源情况，不代表内核会给这些资源的。如果设备要得到这些设备还需要在自己的初始化函数中去申请。
static struct platform_device *smdk2410_devices[] __initdata = {
&s3c_device_usb,
&s3c_device_lcd,
&s3c_device_wdt,
&s3c_device_i2c,
&s3c_device_iis,
&s3c_device_ts,
}; 2.2 回到 s3c2410fb_init
终于把platform 的相关知识啰嗦了一番，下面回到s3c2410fb_init 函数所调用platform_driver_register(&s3c2410fb_driver) 。简单地说platform_driver_register 要将向内核注册一个platform 设备的驱动，这里是要注册LCD 设备。上面说过platform 有两个重要的数据结构platform_device 和platform_driver ，现在是应该提到后者的时候了。platform_driver 也在include/linux/platform_device.h 中，它的各个成员应该再明白不过来吧！在LCD 驱动程序（drivers/video/s3c2410fb.c ）中定义了填充了platform_driver 这个结构，如下：
static struct platform_driver s3c2410fb_driver = {
.probe = s3c2410fb_probe,
.remove = s3c2410fb_remove,
.suspend = s3c2410fb_suspend,
.resume = s3c2410fb_resume,
.driver = {
.name = "s3c2410-lcd",
.owner = THIS_MODULE,
},
}; 2.3 s3c2410fb_probe 揭秘
对于该函数，我想最好的办法就是跟着程序一步一步的解释。OK ，let’s go to ……
static int __init s3c2410fb_probe(struct platform_device *pdev)
{
struct s3c2410 fb_info *info; //s3c2410fb_info 结构在driver/video/s3c2410fb.h 中定义，
// 可以说该结构记录了s3c2410fb 驱动的所有信息。
struct fb_info *fbinfo; /* fb_info 为内核提供的buffer 驱动的接口数据结构, 每个帧缓冲驱动都对应一个这样的结构。s3c2410fb_probe 的最终目的填充该结构，并向内核注册。*/
struct s3c2410fb_hw *mregs; // s3c2410fb_hw 为描述LCD 的硬件控制寄存器的结构体，
// 在include/asm-arm/arch-s3c2410/fb.h 可以找到它的原型。
……
mach_info = pdev->dev.platform_data; /* 这一步看来要多费些口舌了。mach_info 是一个s3c2410fb_mach_info 类型的指针，注意区分s3c2410fb_mach_info 和s3c2410fb_info 结构, 简单地说前者只是用于描述LCD 初始化时所用的值，而后者是描述整个LCD 驱动的结构体。s3c2410fb_mach_info 在include/asm-arm/arch-s3c2410/fb.h 中定义，从他的位置可以看出它和平台相关，也即它不是内核认知的数据结构，这只是驱动程序设计者设计的结构。这里的主要疑问是什么呢？从下面的if 语句可以看出如果mach_info 等于NULL 的话，整个驱动程序就退出了，这就引出了问题――pdev->dev.platform_data 是在什么时候被初始化的呢？看来要回答这个问题，历史应该回到孙悟空大闹天宫的时候了。按住倒带键不放一直到本篇文章的第一部分，看看那个时候做了些什么。放在这里来解释第一部分的内容希望没有为时已晚。其实在内核启动init 进程之前就会执行smdk2410_map_io( ) 函数（内核的启动分析就免了吧@_@ ），而在smdk2410_map_io( ) 中我们加入了
s3c24xx_fb_set_platdata (&smdk2410_lcd_platdata);
这条语句，s3c24xx_fb_set_platdata() 的实现为：
void __init s3c24xx_fb_set_platdata(struct s3c2410fb_mach_info *pd)
{
s3c_device_lcd.dev.platform_data = pd;
}
根据这些代码，可以清楚的看到s3c_device_lcd.dev.platform_data 指向了smdk2410_lcd_platdata ，而这个smdk2410_lcd_platdata 就是一个s3c2410fb_mach_info 的变量，它里面就存放了LCD 驱动初始化需要的初始数据。当s3c2410fb_probe 被回调时，所传给它的参数实际就是s3c_device_lcd 的首地址，说到这里一切应该都明了了吧！好了，又撤了一通，现在假设这步成功，继续往下面走。*/
if (mach_info == NULL) {
dev_err(&pdev->dev,"no platform data for lcd, cannot attach/n");
return -EINVAL;
}
mregs = &mach_info->regs; //mregs 指向硬件各控制寄存器的初始值，可参见第一部
// 分的smdk2410_lcd_platdata 变量。
irq = platform_get_irq(pdev, 0); /* 该函数获得中断号，该函数的实现是通过比较struct resource 的flags 域，得到irq 中断号，在上2.1 的时候提到s3c_lcd_resource[] ，platform_get_irq 函数检测到flags ＝＝IORESOURCE_IRQ 时就返回中断号IRQ_LCD 。详细的内容请读它的源代码吧！*/
if (irq < 0) { // 没有找到可用的中断号，返回-ENOENT
dev_err(&pdev->dev, "no irq for device/n");
return -ENOENT;
}
fbinfo = framebuffer_alloc(sizeof(struct s3c2410fb_info), &pdev->dev); /* framebuffer_alloc 可以在include/linux/fb.h 文件中找到其原型：struct fb_info *framebuffer_alloc(size_t size, struct device *dev); 它的功能是向内核申请一段大小为sizeof(struct fb_info) + size 的空间，其中size 的大小代表设备的私有数据空间，并用fb_info 的par 域指向该私有空间。*/
if (!fbinfo) {
return -ENOMEM;
}
// 以下开始做正经事了，填充fbinfo 了。
info = fbinfo->par; // 你中有我，我中有你！
info->fb = fbinfo;
platform_set_drvdata(pdev, fbinfo); /* 该函数的实现非常简单，实际的操作为：pdev->dev.driver_data ＝ fbinfo ，device 结构的driver_data 域指向驱动程序的私有数据空间。*/
dprintk("devinit/n");
strcpy(fbinfo->fix.id, driver_name);
memcpy(&info->regs, &mach_info->regs, sizeof(info->regs));
/* Stop the video and unset ENVID if set */
info->regs.lcdcon1 &= ~S3C2410_LCDCON1_ENVID;
lcdcon1 = readl(S3C2410_LCDCON1);
writel(lcdcon1 & ~S3C2410_LCDCON1_ENVID, S3C2410_LCDCON1);// 停止硬件
/* 以下的对fbinfo 的填写就免了吧！对于fb_info 结构的各个成员，在include/linux/fb 文件中都有详细的说明，如果不知道说明的意思，就应该找些基本的知识读读了。 在众多的初始化中， fbinfo->fbops = &s3c2410fb_ops; 是值得一提的，变量 s3c2410fb_ops 就在 s3c2410fb.c 中定义，它记录了该帧缓冲区驱动所支持的操作 */
……
for (i = 0; i < 256; i++) // 初始化调色板缓冲区
info->palette_buffer[i] = PALETTE_BUFF_CLEAR;
if (!request_mem_region((unsigned long)S3C24XX_VA_LCD, SZ_1M, "s3c2410-lcd")) {
/* 向内核申请内存空间，如果request_mem_region 返回0 表示申请失败，此时程序跳到dealloc_fb 处开始执行，该处会调用framebuffer_release 释放刚才由framebuffer_alloc 申请的fb_info 空间 */
ret = -EBUSY;
goto dealloc_fb;
}
……
ret = request_irq(irq, s3c2410fb_irq, IRQF_DISABLED, pdev->name, info);/* 向内核注册中断，如果注册失败，程序跳转到release_mem 处运行，此处释放fb_info 和刚才由request_mem_region 申请的内存空间 */
if (ret) {
dev_err(&pdev->dev, "cannot get irq %d - err %d/n", irq, ret);
ret = -EBUSY;
goto release_mem;
}
info->clk = clk_get(NULL, "lcd"); // 该函数得到时钟源，并与硬件紧密相连，对于我的
// 板子，可以在arch/arm/mach-s3c2410/clock.c 看到它的原型和实现。
if (!info->clk || IS_ERR(info->clk)) {
printk(KERN_ERR "failed to get lcd clock source/n");
ret = -ENOENT;
goto release_irq; // 该处释放上面申请的fb_info ，内存，和irq 资源
}
clk_enable(info->clk); // 打开时钟
dprintk("got and enabled clock/n");
msleep(1); // 运行得太久有点累了，去打个盹再说
/* Initialize video memory */
ret = s3c2410fb_map_video_memory(info); /* 此函数就在 s3c2410fb.c 文件中被定义，它的作用是申请帧缓冲器内存空间 */
if (ret) {
printk( KERN_ERR "Failed to allocate video RAM: %d/n", ret);
ret = -ENOMEM;
goto release_clock; // 释放所有已得到的资源
}
dprintk("got video memory/n");
ret = s3c2410fb_init_registers(info); // 此函数也在s3c2410fb.c 文件中定义，后面会分析
ret = s3c2410fb_check_var(&fbinfo->var, fbinfo); // 此函数也在s3c2410fb.c 文件中定义
ret = register_framebuffer(fbinfo); // 神圣的时刻终于到来，向内核正式注册。
if (ret < 0) {
printk(KERN_ERR "Failed to register framebuffer device: %d/n", ret);
goto free_video_memory; // 不让注册真郁闷，那就释放所有的资源，出家算了！
}
/* create device files */
device_create_file(&pdev->dev, &dev_attr_debug); // 为该设备创建一个在sysfs 中的属性
printk(KERN_INFO "fb%d: %s frame buffer device/n",
fbinfo->node, fbinfo->fix.id);
return 0; // 大功告成！
free_video_memory:
s3c2410fb_unmap_video_memory(info);
release_clock:
clk_disable(info->clk);
clk_put(info->clk);
release_irq:
free_irq(irq,info);
release_mem:
release_mem_region((unsigned long)S3C24XX_VA_LCD, S3C24XX_SZ_LCD);
dealloc_fb:
framebuffer_release(fbinfo);
return ret;
}
本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/jwy1224/archive/2009/10/29/4744914.aspx
扫一扫
87
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
