支持分辨率为 640*480、320*240、160*160 以及其他规格的多种 LCD。
2.TFT 屏
支持单色、4 级灰度、256 色的调色板显示模式。
支持 64K 和 16M 色非调色板显示模式。
支持分辨率为 640*480,320*240 及其他多种规格的 LCD。
下图所示为 S3C2410 LCD 控制器内部的逻辑结构,REGBANK 是 LCD 控制器的寄存器组,用来对 LCD 控制器的各项参数进行设置。而 LCDCDMA 则是 LCD控制器专用的 DMA 信道,负责将视频资料从系统总线(System Bus)上取来,通过VIDPRCS 从 VD[23:0]发送给 LCD 屏。同时 TIMEGEN 和 LPC3600 负责产生 LCD 屏所需要的控制时序,例如 VSYNC、HSYNC、VCLK、VDEN,然后从 VIDEO MUX送给 LCD 屏。
S3C2410 LCD 驱动的模块加载与卸载函数
在 S3C2410 中,作为一个相对独立的硬件单元,LCD 控制器被认定为平台设备,因此,在驱动的模块加载和卸载函数中,分别注册和注销对应的 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, }, }; int __devinit s3c2410fb_init(void) { return platform_driver_register(&s3c2410fb_driver); } static void __exit s3c2410fb_cleanup(void) { platform_driver_unregister(&s3c2410fb_driver); }S3C2410 LCD 控制器平台设备定义于 arch/arm/mach-s3c2410 对应的目录中,其对应的 platform_device 结构体如下所示。
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 } };s3c_lcd_resource 为平台设备所使用的资源,S3C2410 LCD平台设备所使用的资源如代码所示。
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, } };另外,内核还定义了一个 s3c2410fb_mach_info 结构体,记录 LCD 的“机器信息”(即硬件特征),并将这个结构体赋值给平台设备的平台数据(platform_data),如代码 所示。
void __init s3c24xx_fb_set_platdata(struct s3c2410fb_mach_info *pd) { struct s3c2410fb_mach_info *npd; npd = kmalloc(sizeof(*npd), GFP_KERNEL); if (npd) { memcpy(npd, pd, sizeof(*npd)); s3c_device_lcd.dev.platform_data = npd;//将s3c2410fb_mach_info付接到platform dev上 } else { printk(KERN_ERR "no memory for LCD platform data\n"); } }s3c2410fb_mach_info的定义:
struct s3c2410fb_mach_info { unsigned char fixed_syncs; /* /* 不更新同步和边界 */*/ /* LCD types */ int type; /* 屏幕尺寸 */ int width; int height; /* 屏幕信息 */ struct s3c2410fb_val xres; struct s3c2410fb_val yres; struct s3c2410fb_val bpp; /* LCD 配置寄存器 */ struct s3c2410fb_hw regs; /* GPIOs */ unsigned long gpcup; unsigned long gpcup_mask; unsigned long gpccon; unsigned long gpccon_mask; unsigned long gpdup; unsigned long gpdup_mask; unsigned long gpdcon; unsigned long gpdcon_mask; /* lpc3600 control register */ unsigned long lpcsel; };s3c2410fb_val的定义:
struct s3c2410fb_val { unsigned int defval;//默认值 unsigned int min;//最小值 unsigned int max;//最大值 };
struct s3c2410fb_hw {//5个配置寄存器 unsigned long lcdcon1; unsigned long lcdcon2; unsigned long lcdcon3; unsigned long lcdcon4; unsigned long lcdcon5; };S3C2410 LCD 驱动的探测与移除函数
static int __init s3c2410fb_probe(struct platform_device *pdev)
{
struct s3c2410fb_info *info;
struct fb_info *fbinfo;
struct s3c2410fb_hw *mregs;
int ret;
int irq;
int i;
u32 lcdcon1;
mach_info = pdev->dev.platform_data;//获得 mach_info 结构体指针
if (mach_info == NULL) {
dev_err(&pdev->dev,"no platform data for lcd, cannot attach\n");
return -EINVAL;
}
mregs = &mach_info->regs;//获得 mach_info 结构体中的寄存器指针
irq = platform_get_irq(pdev, 0);//获得 IRQ 号
if (irq < 0) {
dev_err(&pdev->dev, "no irq for device\n");
return -ENOENT;
}
fbinfo = framebuffer_alloc(sizeof(struct s3c2410fb_info), &pdev->dev);//分配 FBI 结构体
if (!fbinfo) {
return -ENOMEM;
}
info = fbinfo->par;
info->fb = fbinfo;
info->dev = &pdev->dev;
platform_set_drvdata(pdev, fbinfo);/设置平台设备数据
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);
// add by thisway.diy@163.com, for eBlocks
s3c2410_gpio_setpin(S3C2410_GPB0, 0); // back light control
info->mach_info = pdev->dev.platform_data;
//初始化固定参数
fbinfo->fix.type = FB_TYPE_PACKED_PIXELS;
fbinfo->fix.type_aux = 0;
fbinfo->fix.xpanstep = 0;
fbinfo->fix.ypanstep = 0;
fbinfo->fix.ywrapstep = 0;
fbinfo->fix.accel = FB_ACCEL_NONE;
//初始化可变参数
fbinfo->var.nonstd = 0;
fbinfo->var.activate = FB_ACTIVATE_NOW;
fbinfo->var.height = mach_info->height;
fbinfo->var.width = mach_info->width;
fbinfo->var.accel_flags = 0;
fbinfo->var.vmode = FB_VMODE_NONINTERLACED;
fbinfo->fbops = &s3c2410fb_ops;//fb_ops
fbinfo->flags = FBINFO_FLAG_DEFAULT;
fbinfo->pseudo_palette = &info->pseudo_pal;
//初始化可变参数中的分辨率和 bpp
fbinfo->var.xres = mach_info->xres.defval;
fbinfo->var.xres_virtual = mach_info->xres.defval;
fbinfo->var.yres = mach_info->yres.defval;
fbinfo->var.yres_virtual = mach_info->yres.defval;
fbinfo->var.bits_per_pixel = mach_info->bpp.defval;
//初始化可变参数中的上下边界和垂直同步
fbinfo->var.upper_margin = S3C2410_LCDCON2_GET_VBPD(mregs->lcdcon2) + 1;
fbinfo->var.lower_margin = S3C2410_LCDCON2_GET_VFPD(mregs->lcdcon2) + 1;
fbinfo->var.vsync_len = S3C2410_LCDCON2_GET_VSPW(mregs->lcdcon2) + 1;
//初始化可变参数中的左右边界和水平同步
fbinfo->var.left_margin = S3C2410_LCDCON3_GET_HFPD(mregs->lcdcon3) + 1;
fbinfo->var.right_margin = S3C2410_LCDCON3_GET_HBPD(mregs->lcdcon3) + 1;
fbinfo->var.hsync_len = S3C2410_LCDCON4_GET_HSPW(mregs->lcdcon4) + 1;
//设置可变参数中的 R/G/B 位数和位置
fbinfo->var.red.offset = 11;
fbinfo->var.green.offset = 5;
fbinfo->var.blue.offset = 0;
fbinfo->var.transp.offset = 0;
fbinfo->var.red.length = 5;
fbinfo->var.green.length = 6;
fbinfo->var.blue.length = 5;
fbinfo->var.transp.length = 0;
fbinfo->fix.smem_len = mach_info->xres.max *
mach_info->yres.max *
mach_info->bpp.max / 8;//buffer 长度
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")) {
ret = -EBUSY;
goto dealloc_fb;
}
dprintk("got LCD region\n");
//申请中断
ret = request_irq(irq, s3c2410fb_irq, IRQF_DISABLED, pdev->name, info);
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");
if (!info->clk || IS_ERR(info->clk)) {
printk(KERN_ERR "failed to get lcd clock source\n");
ret = -ENOENT;
goto release_irq;
}
//获得时钟源并使能
clk_enable(info->clk);
dprintk("got and enabled clock\n");
msleep(1);
/* Initialize video memory */
ret = s3c2410fb_map_video_memory(info);/* 初始化显示缓冲区 */
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);//初始化 S3C2410 的 LCD 控制器的寄存器
ret = s3c2410fb_check_var(&fbinfo->var, fbinfo);//检查可变参数
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);/* 创建设备文件 *
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;
}
S3C2410 LCD 驱动的移除函数
static int s3c2410fb_remove(struct platform_device *pdev) { struct fb_info *fbinfo = platform_get_drvdata(pdev); struct s3c2410fb_info *info = fbinfo->par; int irq; s3c2410fb_stop_lcd(info);//停止 LCD msleep(1); s3c2410fb_unmap_video_memory(info);//释放显示缓冲区 if (info->clk) { clk_disable(info->clk);//释放时钟源 clk_put(info->clk); info->clk = NULL; } irq = platform_get_irq(pdev, 0);//获得平台设备使用的 IRQ free_irq(irq,info);//释放 IRQ release_mem_region((unsigned long)S3C24XX_VA_LCD, S3C24XX_SZ_LCD);//释放内存区域 unregister_framebuffer(fbinfo);//注销帧缓冲设备 return 0; }s3c2410fb_map_video_memory()用于申请显示缓冲区,
如代码 所示。
static int __init s3c2410fb_map_video_memory(struct s3c2410fb_info *fbi) { dprintk("map_video_memory(fbi=%p)\n", fbi); fbi->map_size = PAGE_ALIGN(fbi->fb->fix.smem_len + PAGE_SIZE); fbi->map_cpu = dma_alloc_writecombine(fbi->dev, fbi->map_size, &fbi->map_dma, GFP_KERNEL);//分配内存 fbi->map_size = fbi->fb->fix.smem_len;//显示缓冲区长度 if (fbi->map_cpu) { /* prevent initial garbage on screen */ dprintk("map_video_memory: clear %p:%08x\n", fbi->map_cpu, fbi->map_size); memset(fbi->map_cpu, 0xf0, fbi->map_size); fbi->screen_dma = fbi->map_dma; fbi->fb->screen_base = fbi->map_cpu; fbi->fb->fix.smem_start = fbi->screen_dma;//显示缓冲区开始地址 dprintk("map_video_memory: dma=%08x cpu=%p size=%08x\n", fbi->map_dma, fbi->map_cpu, fbi->fb->fix.smem_len); } return fbi->map_cpu ? 0 : -ENOMEM; }
static inline void s3c2410fb_unmap_video_memory(struct s3c2410fb_info *fbi) { dma_free_writecombine(fbi->dev,fbi->map_size,fbi->map_cpu, fbi->map_dma);//释放内存 }S3C2410 LCD 驱动挂起(suspend)与恢复函数(resume)
static int s3c2410fb_suspend(struct platform_device *dev, pm_message_t state) { struct fb_info *fbinfo = platform_get_drvdata(dev); struct s3c2410fb_info *info = fbinfo->par; printk("100ask suspend\n"); s3c2410fb_stop_lcd(info);//停止 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);//在停止时钟源前延迟 clk_disable(info->clk);//停止时钟源 return 0; }
static int s3c2410fb_resume(struct platform_device *dev) { struct fb_info *fbinfo = platform_get_drvdata(dev); struct s3c2410fb_info *info = fbinfo->par; printk("100ask resume\n"); clk_enable(info->clk);//启动时钟源 msleep(1); s3c2410fb_init_registers(info);//初始化 LCD 控制器寄存器 return 0; }S3C2410 LCD 驱动的 fb_ops 成员函数
static struct fb_ops s3c2410fb_ops = { .owner = THIS_MODULE, .fb_check_var = s3c2410fb_check_var,//检查可变参数 .fb_set_par = s3c2410fb_set_par,//设置参数 .fb_blank = s3c2410fb_blank,//显示空白 .fb_setcolreg = s3c2410fb_setcolreg,//设置颜色表 .fb_fillrect = cfb_fillrect,//矩形填充 .fb_copyarea = cfb_copyarea, .fb_imageblit = cfb_imageblit, };参数检查函数
static int s3c2410fb_check_var(struct fb_var_screeninfo *var, struct fb_info *info) { struct s3c2410fb_info *fbi = info->par; dprintk("check_var(var=%p, info=%p)\n", var, info); /* 验证 x/y 解析度 */ if (var->yres > fbi->mach_info->yres.max) var->yres = fbi->mach_info->yres.max; else if (var->yres < fbi->mach_info->yres.min) var->yres = fbi->mach_info->yres.min; if (var->xres > fbi->mach_info->xres.max) var->yres = fbi->mach_info->xres.max; else if (var->xres < fbi->mach_info->xres.min) var->xres = fbi->mach_info->xres.min; /* 验证 bpp */ if (var->bits_per_pixel > fbi->mach_info->bpp.max) var->bits_per_pixel = fbi->mach_info->bpp.max; else if (var->bits_per_pixel < fbi->mach_info->bpp.min) var->bits_per_pixel = fbi->mach_info->bpp.min; /* 设置 R、G、B 位置 */ switch (var->bits_per_pixel) { case 1: case 2: case 4: var->red.offset = 0; var->red.length = var->bits_per_pixel; var->green = var->red; var->blue = var->red; var->transp.offset = 0; var->transp.length = 0; break; case 8: if ( fbi->mach_info->type != S3C2410_LCDCON1_TFT ) { /* 8 bpp 332 */ var->red.length = 3; var->red.offset = 5; var->green.length = 3; var->green.offset = 2; var->blue.length = 2; var->blue.offset = 0; var->transp.length = 0; } else { var->red.offset = 0; var->red.length = var->bits_per_pixel; var->green = var->red; var->blue = var->red; var->transp.offset = 0; var->transp.length = 0; } break; case 12: /* 12 bpp 444 */ var->red.length = 4; var->red.offset = 8; var->green.length = 4; var->green.offset = 4; var->blue.length = 4; var->blue.offset = 0; var->transp.length = 0; break; default: case 16: if (fbi->regs.lcdcon5 & S3C2410_LCDCON5_FRM565 ) { /* 16 bpp, 565 format */ var->red.offset = 11; var->green.offset = 5; var->blue.offset = 0; var->red.length = 5; var->green.length = 6; var->blue.length = 5; var->transp.length = 0; } else { /* 16 bpp, 5551 format */ var->red.offset = 11; var->green.offset = 6; var->blue.offset = 1; var->red.length = 5; var->green.length = 5; var->blue.length = 5; var->transp.length = 0; } break; case 24: /* 24 bpp 888 */ var->red.length = 8; var->red.offset = 16; var->green.length = 8; var->green.offset = 8; var->blue.length = 8; var->blue.offset = 0; var->transp.length = 0; break; } return 0; }参数设置函数
static int s3c2410fb_set_par(struct fb_info *info) { struct s3c2410fb_info *fbi = info->par; struct fb_var_screeninfo *var = &info->var; switch (var->bits_per_pixel) { case 16: fbi->fb->fix.visual = FB_VISUAL_TRUECOLOR; break; case 1: fbi->fb->fix.visual = FB_VISUAL_MONO01; break; default: fbi->fb->fix.visual = FB_VISUAL_PSEUDOCOLOR; break; } fbi->fb->fix.line_length = (var->width*var->bits_per_pixel)/8;//一行的字节数 /* activate this new configuration */ s3c2410fb_activate_var(fbi, var);//激活新的配置 return 0; }
static void s3c2410fb_activate_var(struct s3c2410fb_info *fbi, struct fb_var_screeninfo *var) {/* 根据 var 和 fix 参数设置 LCD 控制器的硬件寄存器 */ int hs; fbi->regs.lcdcon1 &= ~S3C2410_LCDCON1_MODEMASK; fbi->regs.lcdcon1 &= ~S3C2410_LCDCON1_TFT; dprintk("%s: var->xres = %d\n", __FUNCTION__, var->xres); dprintk("%s: var->yres = %d\n", __FUNCTION__, var->yres); dprintk("%s: var->bpp = %d\n", __FUNCTION__, var->bits_per_pixel); fbi->regs.lcdcon1 |= fbi->mach_info->type; if (fbi->mach_info->type == S3C2410_LCDCON1_TFT) switch (var->bits_per_pixel) {//设置 bpp case 1: fbi->regs.lcdcon1 |= S3C2410_LCDCON1_TFT1BPP; break; case 2: fbi->regs.lcdcon1 |= S3C2410_LCDCON1_TFT2BPP; break; case 4: fbi->regs.lcdcon1 |= S3C2410_LCDCON1_TFT4BPP; break; case 8: fbi->regs.lcdcon1 |= S3C2410_LCDCON1_TFT8BPP; break; case 16: fbi->regs.lcdcon1 |= S3C2410_LCDCON1_TFT16BPP; break; default: /* invalid pixel depth */ dev_err(fbi->dev, "invalid bpp %d\n", var->bits_per_pixel); } else switch (var->bits_per_pixel) { case 1: fbi->regs.lcdcon1 |= S3C2410_LCDCON1_STN1BPP; break; case 2: fbi->regs.lcdcon1 |= S3C2410_LCDCON1_STN2GREY; break; case 4: fbi->regs.lcdcon1 |= S3C2410_LCDCON1_STN4GREY; break; case 8: fbi->regs.lcdcon1 |= S3C2410_LCDCON1_STN8BPP; break; case 12: fbi->regs.lcdcon1 |= S3C2410_LCDCON1_STN12BPP; break; default: /* invalid pixel depth */ dev_err(fbi->dev, "invalid bpp %d\n", var->bits_per_pixel); } /* check to see if we need to update sync/borders */ /* 检查是否需要更新同步和边界 */ if (!fbi->mach_info->fixed_syncs) { dprintk("setting vert: up=%d, low=%d, sync=%d\n", var->upper_margin, var->lower_margin, var->vsync_len); dprintk("setting horz: lft=%d, rt=%d, sync=%d\n", var->left_margin, var->right_margin, var->hsync_len); fbi->regs.lcdcon2 = S3C2410_LCDCON2_VBPD(var->upper_margin - 1) | S3C2410_LCDCON2_VFPD(var->lower_margin - 1) | S3C2410_LCDCON2_VSPW(var->vsync_len - 1); fbi->regs.lcdcon3 = S3C2410_LCDCON3_HBPD(var->right_margin - 1) | S3C2410_LCDCON3_HFPD(var->left_margin - 1); fbi->regs.lcdcon4 &= ~S3C2410_LCDCON4_HSPW(0xff); fbi->regs.lcdcon4 |= S3C2410_LCDCON4_HSPW(var->hsync_len - 1); } /* update X/Y info */ /* 更新 X/Y 信息 */ fbi->regs.lcdcon2 &= ~S3C2410_LCDCON2_LINEVAL(0x3ff); fbi->regs.lcdcon2 |= S3C2410_LCDCON2_LINEVAL(var->yres - 1); switch(fbi->mach_info->type) { case S3C2410_LCDCON1_DSCAN4: case S3C2410_LCDCON1_STN8: hs = var->xres / 8; break; case S3C2410_LCDCON1_STN4: hs = var->xres / 4; break; default: case S3C2410_LCDCON1_TFT: hs = var->xres; break; } /* Special cases : STN color displays */ if ( ((fbi->regs.lcdcon1 & S3C2410_LCDCON1_MODEMASK) == S3C2410_LCDCON1_STN8BPP) \ || ((fbi->regs.lcdcon1 & S3C2410_LCDCON1_MODEMASK) == S3C2410_LCDCON1_STN12BPP) ) { hs = hs * 3; } fbi->regs.lcdcon3 &= ~S3C2410_LCDCON3_HOZVAL(0x7ff); fbi->regs.lcdcon3 |= S3C2410_LCDCON3_HOZVAL(hs - 1); if (var->pixclock > 0) { int clkdiv = s3c2410fb_calc_pixclk(fbi, var->pixclock); if (fbi->mach_info->type == S3C2410_LCDCON1_TFT) { clkdiv = (clkdiv / 2) -1; if (clkdiv < 0) clkdiv = 0; } else { clkdiv = (clkdiv / 2); if (clkdiv < 2) clkdiv = 2; } fbi->regs.lcdcon1 &= ~S3C2410_LCDCON1_CLKVAL(0x3ff); fbi->regs.lcdcon1 |= S3C2410_LCDCON1_CLKVAL(clkdiv); } /* write new registers */ /* 重写 LCD 控制器寄存器 */ dprintk("new register set:\n"); dprintk("lcdcon[1] = 0x%08lx\n", fbi->regs.lcdcon1); dprintk("lcdcon[2] = 0x%08lx\n", fbi->regs.lcdcon2); dprintk("lcdcon[3] = 0x%08lx\n", fbi->regs.lcdcon3); dprintk("lcdcon[4] = 0x%08lx\n", fbi->regs.lcdcon4); dprintk("lcdcon[5] = 0x%08lx\n", fbi->regs.lcdcon5); writel(fbi->regs.lcdcon1 & ~S3C2410_LCDCON1_ENVID, S3C2410_LCDCON1); writel(fbi->regs.lcdcon2, S3C2410_LCDCON2); writel(fbi->regs.lcdcon3, S3C2410_LCDCON3); writel(fbi->regs.lcdcon4, S3C2410_LCDCON4); writel(fbi->regs.lcdcon5, S3C2410_LCDCON5); /* set lcd address pointers */ s3c2410fb_set_lcdaddr(fbi); writel(fbi->regs.lcdcon1, S3C2410_LCDCON1); }总结