Linux-2.6.38的LCD驱动分析（三）

三、解剖s3cfb_driver变量

s3cfb_driver变量有什么作用呢？在前面的2.2节提到了它的定义，从它的原型可以看出s3cfb_driver是个platform_driver类型的变量，前面的几个小节提到了从platform_driver的名字可以看出它应该是platform_device的驱动类型。为了方便阅读，这里再贴一次s3cfb_driver的定义：

static struct platform_driver s3cfb_driver = {

.probe = s3cfb_probe,

.remove = s3cfb_remove,

.suspend = s3cfb_suspend,

.resume = s3cfb_resume,

.driver = {

.name = "s3c-fb",

.owner = THIS_MODULE,

},

};

从定义可以看出，该platform_device的驱动函数有s3cfb_probe，s3cfb_remove，s3cfb_suspend和s3cfb_suspend。.resource成员前面的章节有说明，.driver成员的值相信不用再说明了吧，再明白不过了。前面的章节，s3cfb_probe被比较详细的介绍，这节中的主要任务就是解释其他的几个函数。在解释他们之前，s3cfb_probe里面在该函数结尾的时候调用了几个函数没有说到，所以在这里补上。



3.1 s3cfb_probe余党

在s3cfb_probe中最好调用了s3cfb_init_registers和s3cfb_check_var函数，这里应该将他们交代清楚。很显然，s3cfb_init_registers是初始化相关寄存器。那么后者呢？这里先把s3cfb_init_registers搞定再说。在文件drivers\video\samsung\s3cfb_fimd4x.c中，s3cfb_init_registers的定义与实现如下，先根据它的指向流程，一步一步解释：

int s3cfb_init_registers(s3cfb_info_t *fbi)

{

struct clk *lcd_clock;

struct fb_var_screeninfo *var = &fbi->fb.var;

unsigned long flags = 0, page_width = 0, offset = 0;

unsigned long video_phy_temp_f1 = fbi->screen_dma_f1;

unsigned long video_phy_temp_f2 = fbi->screen_dma_f2;

int win_num = fbi->win_id;

/* Initialise LCD with values from hare */

local_irq_save(flags);

/* 关闭中断，在关闭中断前，中断的当前状态被保存在flags中，对于关闭中断的函数，linux内核有很多种，可以查阅相关的资料。*/

page_width = var->xres * s3cfb_fimd.bytes_per_pixel;

offset = (var->xres_virtual - var->xres) * s3cfb_fimd.bytes_per_pixel;

if (win_num == 0) {

s3cfb_fimd.vidcon0 = s3cfb_fimd.vidcon0 & ~(S3C_VIDCON0_ENVID_ENABLE | S3C_VIDCON0_ENVID_F_ENABLE);

writel(s3cfb_fimd.vidcon0, S3C_VIDCON0);

lcd_clock = clk_get(NULL, "lcd");

s3cfb_fimd.vidcon0 |= S3C_VIDCON0_CLKVAL_F((int) (s3cfb_fimd.pixclock));

#if defined(CONFIG_FB_S3C_EXT_VIRTUAL_SCREEN)

offset = 0;

s3cfb_fimd.vidw00add0b0 = video_phy_temp_f1;

s3cfb_fimd.vidw00add0b1 = video_phy_temp_f2;

s3cfb_fimd.vidw00add1b0 = S3C_VIDWxxADD1_VBASEL_F((unsigned long) video_phy_temp_f1 + (page_width + offset) * (var->yres));

s3cfb_fimd.vidw00add1b1 = S3C_VIDWxxADD1_VBASEL_F((unsigned long) video_phy_temp_f2 + (page_width + offset) * (var->yres));

#endif

}

writel(video_phy_temp_f1, S3C_VIDW00ADD0B0 + (0x08 * win_num));

writel(S3C_VIDWxxADD1_VBASEL_F((unsigned long) video_phy_temp_f1 + (page_width + offset) * (var->yres)), S3C_VIDW00ADD1B0 + (0x08 * win_num));

writel(S3C_VIDWxxADD2_OFFSIZE_F(offset) | (S3C_VIDWxxADD2_PAGEWIDTH_F(page_width)), S3C_VIDW00ADD2 + (0x04 * win_num));

if (win_num < 2) {

writel(video_phy_temp_f2, S3C_VIDW00ADD0B1 + (0x08 * win_num));

writel(S3C_VIDWxxADD1_VBASEL_F((unsigned long) video_phy_temp_f2 + (page_width + offset) * (var->yres)), S3C_VIDW00ADD1B1 + (0x08 * win_num));

}

下面的几个writel函数开始初始化LCD控制寄存器

switch (win_num) {

case 0://window0

writel(s3cfb_fimd.wincon0, S3C_WINCON0);

writel(s3cfb_fimd.vidcon0, S3C_VIDCON0);

writel(s3cfb_fimd.vidcon1, S3C_VIDCON1);

writel(s3cfb_fimd.vidtcon0, S3C_VIDTCON0);

writel(s3cfb_fimd.vidtcon1, S3C_VIDTCON1);

writel(s3cfb_fimd.vidtcon2, S3C_VIDTCON2);

writel(s3cfb_fimd.dithmode, S3C_DITHMODE);

writel(s3cfb_fimd.vidintcon0, S3C_VIDINTCON0);

writel(s3cfb_fimd.vidintcon1, S3C_VIDINTCON1);

writel(s3cfb_fimd.vidosd0a, S3C_VIDOSD0A);

writel(s3cfb_fimd.vidosd0b, S3C_VIDOSD0B);

writel(s3cfb_fimd.vidosd0c, S3C_VIDOSD0C);

writel(s3cfb_fimd.wpalcon, S3C_WPALCON);

s3cfb_onoff_win(fbi, ON);

break;

case 1://window1

writel(s3cfb_fimd.wincon1, S3C_WINCON1);

writel(s3cfb_fimd.vidosd1a, S3C_VIDOSD1A);

writel(s3cfb_fimd.vidosd1b, S3C_VIDOSD1B);

writel(s3cfb_fimd.vidosd1c, S3C_VIDOSD1C);

writel(s3cfb_fimd.vidosd1d, S3C_VIDOSD1D);

writel(s3cfb_fimd.wpalcon, S3C_WPALCON);

s3cfb_onoff_win(fbi, OFF);

break;

case 2://window2

writel(s3cfb_fimd.wincon2, S3C_WINCON2);

writel(s3cfb_fimd.vidosd2a, S3C_VIDOSD2A);

writel(s3cfb_fimd.vidosd2b, S3C_VIDOSD2B);

writel(s3cfb_fimd.vidosd2c, S3C_VIDOSD2C);

writel(s3cfb_fimd.vidosd2d, S3C_VIDOSD2D);

writel(s3cfb_fimd.wpalcon, S3C_WPALCON);

s3cfb_onoff_win(fbi, OFF);

break;

case 3://window3

writel(s3cfb_fimd.wincon3, S3C_WINCON3);

writel(s3cfb_fimd.vidosd3a, S3C_VIDOSD3A);

writel(s3cfb_fimd.vidosd3b, S3C_VIDOSD3B);

writel(s3cfb_fimd.vidosd3c, S3C_VIDOSD3C);

writel(s3cfb_fimd.wpalcon, S3C_WPALCON);

s3cfb_onoff_win(fbi, OFF);

break;

case 4://window4

writel(s3cfb_fimd.wincon4, S3C_WINCON4);

writel(s3cfb_fimd.vidosd4a, S3C_VIDOSD4A);

writel(s3cfb_fimd.vidosd4b, S3C_VIDOSD4B);

writel(s3cfb_fimd.vidosd4c, S3C_VIDOSD4C);

writel(s3cfb_fimd.wpalcon, S3C_WPALCON);

s3cfb_onoff_win(fbi, OFF);

break;

}

local_irq_restore(flags);

//使能中断，并恢复以前的状态

return 0;

}



OK，s3cfb_init_registers就简单介绍到这里。下面看看s3cfb_check_var函数要干些什么事，要说到这个函数，还得提到fb_var_screeninfo结构类型，与它对应的是fb_fix_screeninfo结构类型。这两个类型分别代表了显示屏的属性信息，这些信息可以分为可变属性信息（如：颜色深度，分辨率等）和不可变的信息（如帧缓冲的其实地址）。既然fb_var_screeninfo表示了可变的属下信息，那么这些可变信息就应该有一定范围，否则显示就会出问题，所以s3cfb_check_var函数的功能就是要在LCD的帧缓冲驱动开始运行之前将这些值初始到合法的范围内。知道了s3cfb_check_var要做什么，再去阅读s3cfb_check_var函数的代码就没什么问题了。



3.2 s3cfb_remove

从这里开始将解释s3cfb_driver中的其他几个函数。那么就从s3cfb_remove开刀吧！顾名思义该函数就该知道，它要将这个platform设备从系统中移除，可以推测它应该释放掉所有的资源，包括内存空间，中断线等等。还是按照惯例，在它的实现代码中一步步的解释。\

static int s3cfb_remove(struct platform_device *pdev)

{

struct fb_info *fbinfo = platform_get_drvdata(pdev);该函数从platform_device中，获取fb_info信息

s3cfb_info_t *info = fbinfo->par;得到私有数据

int index = 0, irq;

s3cfb_stop_lcd();停止LCD控制器

msleep(1);休息以下，等待LCD停止

停止时钟
if (info->clk) {

clk_disable(info->clk);

clk_put(info->clk);

info->clk = NULL;

}

irq = platform_get_irq(pdev, 0);得到中断线，以便释放

release_resource(info->mem);释放内存空间

for (index = 0; index < S3CFB_NUM; index++) {

s3cfb_unmap_video_memory((s3cfb_info_t *) &s3cfb_info[index]);释放缓冲区

free_irq(irq, &s3cfb_info[index]);释放该中断

unregister_framebuffer(&info[index].fb);向内核注销该帧缓冲

}

return 0;

}

3.3 s3cfb_suspend与s3cfb_resume

在实际的设备，常常可以看到LCD在不需要的时候进入休眠状态，当需要使用的时候又开始工作，比如手机，在不需要的时候LCD就熄灭，当需要使用的时候LCD又被点亮。从实际中可以看出这对函数非常重要。虽然他们很重要，但不一定很复杂，下面看看它们是怎么样实现的。



int s3cfb_suspend(struct platform_device *dev, pm_message_t state)

{

struct fb_info *fbinfo = platform_get_drvdata(dev);//获取帧缓冲设备数据结构

s3cfb_info_t *info = fbinfo->par;

s3cfb_stop_lcd();停止LCD

s3c6410_pm_do_save(s3c_lcd_save, ARRAY_SIZE(s3c_lcd_save));保存当前LCD寄存器等的信息

/* sleep before disabling the clock, we need to ensure

* the LCD DMA engine is not going to get back on the bus

* before the clock goes off again (bjd) */

msleep(1);//等待一下，因为LCD停止需要一点时间

clk_disable(info->clk);//关闭LCD的时钟

return 0;

}

下面来看看s3cfb_resume

int s3cfb_resume(struct platform_device *dev)

{

struct fb_info *fbinfo = platform_get_drvdata(dev);

s3cfb_info_t *info = fbinfo->par;

clk_enable(info->clk);

s3c6410_pm_do_restore(s3c_lcd_save, ARRAY_SIZE(s3c_lcd_save));恢复LCD寄存器值

s3cfb_set_gpio();从新设置LCD GPIO

s3cfb_start_lcd();使能LCD

return 0;

}



OK，到现在为止，对于platform device的相关驱动就over了。不过精彩的还在后头哦！