S3C2440上LCD驅動(FrameBuffer)實例開發(fā)講解（二）

　　嵌入式Linux之我行，主要講述和總結了本人在學習嵌入式linux中的每個步驟。一為總結經驗，二希望能給想入門嵌入式Linux的朋友提供方便。如有錯誤之處，謝請指正。

　　開發(fā)環(huán)境

　　主 機：VMWare--Fedora 9

　　開發(fā)板：Mini2440--64MB Nand, Kernel:2.6.30.4

　　編譯器：arm-linux-gcc-4.3.2

　　上接：S3C2440上LCD驅動(FrameBuffer)實例開發(fā)詳解(一)

　　四、幀緩沖(FrameBuffer)設備驅動實例代碼：

　?、佟⒔Ⅱ寗游募簃y2440_lcd.c，依就是驅動程序的最基本結構：FrameBuffer驅動的初始化和卸載部分及其他，如下：

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include interrupt.h>

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　/*FrameBuffer設備名稱*/

　　static char driver_name[] = "my2440_lcd";

　　/*定義一個結構體用來維護驅動程序中各函數中用到的變量

　　先別看結構體要定義這些成員，到各函數使用的地方就明白了*/

　　struct my2440fb_var

　　{

　　int lcd_irq_no; /*保存LCD中斷號*/

　　struct clk *lcd_clock;/*保存從平臺時鐘隊列中獲取的LCD時鐘*/

　　struct resource *lcd_mem;/*LCD的IO空間*/

　　void __iomem *lcd_base;/*LCD的IO空間映射到虛擬地址*/

　　struct device *dev;

　　struct s3c2410fb_hw regs;/*表示5個LCD配置寄存器，s3c2410fb_hw定義在mach-s3c2410/include/mach/fb.h中*/

　　/*定義一個數組來充當調色板。

　　據數據手冊描述，TFT屏色位模式為8BPP時，調色板(顏色表)的長度為256，調色板起始地址為0x4D000400*/

　　u32 palette_buffer[256];

　　u32 pseudo_pal[16];

　　unsigned int palette_ready;/*標識調色板是否準備好了*/

　　};

　　/*用做清空調色板(顏色表)*/

　　#define PALETTE_BUFF_CLEAR (0x80000000)

　　/*LCD平臺驅動結構體，平臺驅動結構體定義在platform_device.h中，該結構體成員接口函數在第②步中實現*/

　　static struct platform_driver lcd_fb_driver =

　　{

　　.probe = lcd_fb_probe, /*FrameBuffer設備探測*/

　　.remove= __devexit_p(lcd_fb_remove),/*FrameBuffer設備移除*/

　　.suspend = lcd_fb_suspend, /*FrameBuffer設備掛起*/

　　.resume = lcd_fb_resume,/*FrameBuffer設備恢復*/

　　.driver =

　　{

　　/*注意這里的名稱一定要和系統(tǒng)中定義平臺設備的地方一致，這樣才能把平臺設備與該平臺設備的驅動關聯(lián)起來*/

　　.name = "s3c2410-lcd",

　　.owner = THIS_MODULE,

　　},

　　};

　　static int __init lcd_init(void)

　　{

　　/*在Linux中，幀緩沖設備被看做是平臺設備，所以這里注冊平臺設備*/

　　return platform_driver_register(&lcd_fb_driver);

　　}

　　static void __exit lcd_exit(void)

　　{

　　/*注銷平臺設備*/

　　platform_driver_unregister(&lcd_fb_driver);

　　}

　　module_init(lcd_init);

　　module_exit(lcd_exit);

　　MODULE_LICENSE("GPL");

　　MODULE_AUTHOR("Huang Gang");

　　MODULE_DESCRIPTION("My2440 LCD FrameBuffer Driver");

　?、?、LCD平臺設備各接口函數的實現：

　　/*LCD FrameBuffer設備探測的實現，注意這里使用一個__devinit宏，到lcd_fb_remove接口函數實現的地方講解*/

　　static int __devinit lcd_fb_probe(struct platform_device *pdev)

　　{

　　int i;

　　int ret;

　　struct resource *res;/*用來保存從LCD平臺設備中獲取的LCD資源*/

　　struct fb_info *fbinfo;/*FrameBuffer驅動所對應的fb_info結構體*/

　　struct s3c2410fb_mach_info *mach_info;/*保存從內核中獲取的平臺設備數據*/

　　struct my2440fb_var *fbvar;/*上面定義的驅動程序全局變量結構體*/

　　struct s3c2410fb_display *display;/*LCD屏的配置信息結構體，該結構體定義在mach-s3c2410/include/mach/fb.h中*/

　　/*獲取LCD硬件相關信息數據，在前面講過內核使用s3c24xx_fb_set_platdata函數將LCD的硬件相關信息保存到

　　了LCD平臺數據中，所以這里我們就從平臺數據中取出來在驅動中使用*/

　　mach_info = pdev->dev.platform_data;

　　if(mach_info == NULL)

　　{

　　/*判斷獲取數據是否成功*/

　　dev_err(&pdev->dev, "no platform data for lcdn");

　　return -EINVAL;

　　}

　　/*獲得在內核中定義的FrameBuffer平臺設備的LCD配置信息結構體數據*/

　　display = mach_info->displays + mach_info->default_display;

　　/*給fb_info分配空間，大小為my2440fb_var結構的內存，framebuffer_alloc定義在fb.h中在fbsysfs.c中實現*/

　　fbinfo = framebuffer_alloc(sizeof(struct my2440fb_var), &pdev->dev);

　　if(!fbinfo)

　　{

　　dev_err(&pdev->dev, "framebuffer alloc of registers failedn");

　　ret = -ENOMEM;

　　goto err_noirq;

　　}

　　platform_set_drvdata(pdev, fbinfo);/*重新將LCD平臺設備數據設置為fbinfo，好在后面的一些函數中來使用*/

　　/*這里的用途其實就是將fb_info的成員par(注意是一個void類型的指針)指向這里的私有變量結構體fbvar，

　　目的是到其他接口函數中再取出fb_info的成員par，從而能繼續(xù)使用這里的私有變量*/

　　fbvar = fbinfo->par;

　　fbvar->dev = &pdev->dev;

　　/*在系統(tǒng)定義的LCD平臺設備資源中獲取LCD中斷號,platform_get_irq定義在platform_device.h中*/

　　fbvar->lcd_irq_no = platform_get_irq(pdev, 0);

　　if(fbvar->lcd_irq_no < 0)

　　{

　　/*判斷獲取中斷號是否成功*/

　　dev_err(&pdev->dev, "no lcd irq for platformn");

　　return -ENOENT;

　　}

　　/*獲取LCD平臺設備所使用的IO端口資源，注意這個IORESOURCE_MEM標志和LCD平臺設備定義中的一致*/

　　res = platform_get_resource(pdev, IORESOURCE_MEM, 0);

　　if(res == NULL)

　　{

　　/*判斷獲取資源是否成功*/

　　dev_err(&pdev->dev, "failed to get memory region resourcen");

　　return -ENOENT;

　　}

　　/*申請LCD IO端口所占用的IO空間(注意理解IO空間和內存空間的區(qū)別),request_mem_region定義在ioport.h中*/

　　fbvar->lcd_mem = request_mem_region(res->start, res->end - res->start + 1, pdev->name);

　　if(fbvar->lcd_mem == NULL)

　　{

　　/*判斷申請IO空間是否成功*/

　　dev_err(&pdev->dev, "failed to reserve memory regionn");

　　return -ENOENT;

　　}

　　/*將LCD的IO端口占用的這段IO空間映射到內存的虛擬地址，ioremap定義在io.h中

　　注意：IO空間要映射后才能使用，以后對虛擬地址的操作就是對IO空間的操作*/

　　fbvar->lcd_base = ioremap(res->start, res->end - res->start + 1);

　　if(fbvar->lcd_base == NULL)

　　{

　　/*判斷映射虛擬地址是否成功*/

　　dev_err(&pdev->dev, "ioremap() of registers failedn");

　　ret = -EINVAL;

　　goto err_nomem;

　　}

　　/*從平臺時鐘隊列中獲取LCD的時鐘，這里為什么要取得這個時鐘，從LCD屏的時序圖上看，各種控制信號的延遲

　　都跟LCD的時鐘有關。系統(tǒng)的一些時鐘定義在arch/arm/plat-s3c24xx/s3c2410-clock.c中*/

　　fbvar->lcd_clock = clk_get(NULL, "lcd");

　　if(!fbvar->lcd_clock)

　　{

　　/*判斷獲取時鐘是否成功*/

　　dev_err(&pdev->dev, "failed to find lcd clock sourcen");

　　ret = -ENOENT;

　　goto err_nomap;

　　}

　　/*時鐘獲取后要使能后才可以使用，clk_enable定義在arch/arm/plat-s3c/clock.c中*/

　　clk_enable(fbvar->lcd_clock);

　　/*申請LCD中斷服務，上面獲取的中斷號lcd_fb_irq，使用快速中斷方式:IRQF_DISABLED

　　中斷服務程序為:lcd_fb_irq，將LCD平臺設備pdev做參數傳遞過去了*/

　　ret = request_irq(fbvar->lcd_irq_no, lcd_fb_irq, IRQF_DISABLED, pdev->name, fbvar);

　　if(ret)

　　{

　　/*判斷申請中斷服務是否成功*/

　　dev_err(&pdev->dev, "IRQ%d error %dn", fbvar->lcd_irq_no, ret);

　　ret = -EBUSY;

　　goto err_noclk;

　　}

　　/*好了，以上是對要使用的資源進行了獲取和設置。下面就開始初始化填充fb_info結構體*/

　　/*首先初始化fb_info中代表LCD固定參數的結構體fb_fix_screeninfo*/

　　/*像素值與顯示內存的映射關系有5種，定義在fb.h中?，F在采用FB_TYPE_PACKED_PIXELS方式，在該方式下，

　　像素值與內存直接對應，比如在顯示內存某單元寫入一個"1"時，該單元對應的像素值也將是"1"，這使得應用層

　　把顯示內存映射到用戶空間變得非常方便。Linux中當LCD為TFT屏時，顯示驅動管理顯示內存就是基于這種方式*/

　　;/*字符串形式的標識符*/

　　fbinfo->fix.type = FB_TYPE_PACKED_PIXELS;

　　fbinfo->fix.type_aux = 0;/*以下這些根據fb_fix_screeninfo定義中的描述，當沒有硬件是都設為0*/

　　fbinfo->fix.xpanstep = 0;

　　fbinfo->fix.ypanstep = 0;

　　fbinfo->fix.ywrapstep= 0;

　　fbinfo->fix.accel = FB_ACCEL_NONE;

　　/*接著，再初始化fb_info中代表LCD可變參數的結構體fb_var_screeninfo*/

　　fbinfo->var.nonstd = 0;

　　fbinfo->var.activate = FB_ACTIVATE_NOW;

　　fbinfo->var.accel_flags = 0;

　　fbinfo->var.vmode = FB_VMODE_NONINTERLACED;

　　fbinfo->var.xres = display->xres;

　　fbinfo->var.yres = display->yres;

　　fbinfo->var.bits_per_pixel = display->bpp;

　　/*指定對底層硬件操作的函數指針, 因內容較多故其定義在第③步中再講*/

　　fbinfo->fbops = &my2440fb_ops;

　　fbinfo->flags = FBINFO_FLAG_DEFAULT;

　　fbinfo->pseudo_palette = &fbvar->pseudo_pal;

　　fbinfo->flags = FBINFO_FLAG_DEFAULT;

　　fbinfo->pseudo_palette = &fbvar->pseudo_pal;

　　/*初始化色調色板(顏色表)為空*/

　　for(i = 0; i < 256; i++)

　　{

　　fbvar->palette_buffer[i] = PALETTE_BUFF_CLEAR;

　　}

　　for (i = 0; i < mach_info->num_displays; i++) /*fb緩存的長度*/

　　{

　　/*計算FrameBuffer緩存的最大大小，這里右移3位(即除以8)是因為色位模式BPP是以位為單位*/

　　unsigned long smem_len = (mach_info->displays[i].xres * mach_info->displays[i].yres * mach_info->displays[i].bpp) >> 3;

　　if(fbinfo->fix.smem_len < smem_len)

　　{

　　fbinfo->fix.smem_len = smem_len;

　　}

　　}

　　/*初始化LCD控制器之前要延遲一段時間*/

　　msleep(1);

　　/*初始化完fb_info后，開始對LCD各寄存器進行初始化，其定義在后面講到*/

　　my2440fb_init_registers(fbinfo);

　　/*初始化完寄存器后，開始檢查fb_info中的可變參數，其定義在后面講到*/

　　my2440fb_check_var(fbinfo);

　　/*申請幀緩沖設備fb_info的顯示緩沖區(qū)空間，其定義在后面講到*/

　　ret = my2440fb_map_video_memory(fbinfo);

　　if (ret)

　　{

　　dev_err(&pdev->dev, "failed to allocate video RAM: %dn", ret);

　　ret = -ENOMEM;

　　goto err_nofb;

　　}