S3C2440上LCD驅(qū)動(FrameBuffer)實例開發(fā)講解(二)
嵌入式Linux之我行,主要講述和總結(jié)了本人在學(xué)習(xí)嵌入式linux中的每個步驟。一為總結(jié)經(jīng)驗,二希望能給想入門嵌入式Linux的朋友提供方便。如有錯誤之處,謝請指正。
本文引用地址:http://cafeforensic.com/article/201608/295509.htm開發(fā)環(huán)境
主 機:VMWare--Fedora 9
開發(fā)板:Mini2440--64MB Nand, Kernel:2.6.30.4
編譯器:arm-linux-gcc-4.3.2
上接:S3C2440上LCD驅(qū)動(FrameBuffer)實例開發(fā)詳解(一)
四、幀緩沖(FrameBuffer)設(shè)備驅(qū)動實例代碼:
?、?、建立驅(qū)動文件:my2440_lcd.c,依就是驅(qū)動程序的最基本結(jié)構(gòu):FrameBuffer驅(qū)動的初始化和卸載部分及其他,如下:
#include
#include
#include
#include
#include
#include
#include
#include
#include interrupt.h>
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
/*FrameBuffer設(shè)備名稱*/
static char driver_name[] = "my2440_lcd";
/*定義一個結(jié)構(gòu)體用來維護驅(qū)動程序中各函數(shù)中用到的變量
先別看結(jié)構(gòu)體要定義這些成員,到各函數(shù)使用的地方就明白了*/
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中*/
/*定義一個數(shù)組來充當調(diào)色板。
據(jù)數(shù)據(jù)手冊描述,TFT屏色位模式為8BPP時,調(diào)色板(顏色表)的長度為256,調(diào)色板起始地址為0x4D000400*/
u32 palette_buffer[256];
u32 pseudo_pal[16];
unsigned int palette_ready;/*標識調(diào)色板是否準備好了*/
};
/*用做清空調(diào)色板(顏色表)*/
#define PALETTE_BUFF_CLEAR (0x80000000)
/*LCD平臺驅(qū)動結(jié)構(gòu)體,平臺驅(qū)動結(jié)構(gòu)體定義在platform_device.h中,該結(jié)構(gòu)體成員接口函數(shù)在第②步中實現(xiàn)*/
static struct platform_driver lcd_fb_driver =
{
.probe = lcd_fb_probe, /*FrameBuffer設(shè)備探測*/
.remove= __devexit_p(lcd_fb_remove),/*FrameBuffer設(shè)備移除*/
.suspend = lcd_fb_suspend, /*FrameBuffer設(shè)備掛起*/
.resume = lcd_fb_resume,/*FrameBuffer設(shè)備恢復(fù)*/
.driver =
{
/*注意這里的名稱一定要和系統(tǒng)中定義平臺設(shè)備的地方一致,這樣才能把平臺設(shè)備與該平臺設(shè)備的驅(qū)動關(guān)聯(lián)起來*/
.name = "s3c2410-lcd",
.owner = THIS_MODULE,
},
};
static int __init lcd_init(void)
{
/*在Linux中,幀緩沖設(shè)備被看做是平臺設(shè)備,所以這里注冊平臺設(shè)備*/
return platform_driver_register(&lcd_fb_driver);
}
static void __exit lcd_exit(void)
{
/*注銷平臺設(shè)備*/
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");
?、凇CD平臺設(shè)備各接口函數(shù)的實現(xiàn):
/*LCD FrameBuffer設(shè)備探測的實現(xiàn),注意這里使用一個__devinit宏,到lcd_fb_remove接口函數(shù)實現(xiàn)的地方講解*/
static int __devinit lcd_fb_probe(struct platform_device *pdev)
{
int i;
int ret;
struct resource *res;/*用來保存從LCD平臺設(shè)備中獲取的LCD資源*/
struct fb_info *fbinfo;/*FrameBuffer驅(qū)動所對應(yīng)的fb_info結(jié)構(gòu)體*/
struct s3c2410fb_mach_info *mach_info;/*保存從內(nèi)核中獲取的平臺設(shè)備數(shù)據(jù)*/
struct my2440fb_var *fbvar;/*上面定義的驅(qū)動程序全局變量結(jié)構(gòu)體*/
struct s3c2410fb_display *display;/*LCD屏的配置信息結(jié)構(gòu)體,該結(jié)構(gòu)體定義在mach-s3c2410/include/mach/fb.h中*/
/*獲取LCD硬件相關(guān)信息數(shù)據(jù),在前面講過內(nèi)核使用s3c24xx_fb_set_platdata函數(shù)將LCD的硬件相關(guān)信息保存到
了LCD平臺數(shù)據(jù)中,所以這里我們就從平臺數(shù)據(jù)中取出來在驅(qū)動中使用*/
mach_info = pdev->dev.platform_data;
if(mach_info == NULL)
{
/*判斷獲取數(shù)據(jù)是否成功*/
dev_err(&pdev->dev, "no platform data for lcdn");
return -EINVAL;
}
/*獲得在內(nèi)核中定義的FrameBuffer平臺設(shè)備的LCD配置信息結(jié)構(gòu)體數(shù)據(jù)*/
display = mach_info->displays + mach_info->default_display;
/*給fb_info分配空間,大小為my2440fb_var結(jié)構(gòu)的內(nèi)存,framebuffer_alloc定義在fb.h中在fbsysfs.c中實現(xiàn)*/
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平臺設(shè)備數(shù)據(jù)設(shè)置為fbinfo,好在后面的一些函數(shù)中來使用*/
/*這里的用途其實就是將fb_info的成員par(注意是一個void類型的指針)指向這里的私有變量結(jié)構(gòu)體fbvar,
目的是到其他接口函數(shù)中再取出fb_info的成員par,從而能繼續(xù)使用這里的私有變量*/
fbvar = fbinfo->par;
fbvar->dev = &pdev->dev;
/*在系統(tǒng)定義的LCD平臺設(shè)備資源中獲取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平臺設(shè)備所使用的IO端口資源,注意這個IORESOURCE_MEM標志和LCD平臺設(shè)備定義中的一致*/
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空間和內(nèi)存空間的區(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空間映射到內(nèi)存的虛擬地址,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的時鐘有關(guān)。系統(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中斷服務(wù),上面獲取的中斷號lcd_fb_irq,使用快速中斷方式:IRQF_DISABLED
中斷服務(wù)程序為:lcd_fb_irq,將LCD平臺設(shè)備pdev做參數(shù)傳遞過去了*/
ret = request_irq(fbvar->lcd_irq_no, lcd_fb_irq, IRQF_DISABLED, pdev->name, fbvar);
if(ret)
{
/*判斷申請中斷服務(wù)是否成功*/
dev_err(&pdev->dev, "IRQ%d error %dn", fbvar->lcd_irq_no, ret);
ret = -EBUSY;
goto err_noclk;
}
/*好了,以上是對要使用的資源進行了獲取和設(shè)置。下面就開始初始化填充fb_info結(jié)構(gòu)體*/
/*首先初始化fb_info中代表LCD固定參數(shù)的結(jié)構(gòu)體fb_fix_screeninfo*/
/*像素值與顯示內(nèi)存的映射關(guān)系有5種,定義在fb.h中?,F(xiàn)在采用FB_TYPE_PACKED_PIXELS方式,在該方式下,
像素值與內(nèi)存直接對應(yīng),比如在顯示內(nèi)存某單元寫入一個"1"時,該單元對應(yīng)的像素值也將是"1",這使得應(yīng)用層
把顯示內(nèi)存映射到用戶空間變得非常方便。Linux中當LCD為TFT屏?xí)r,顯示驅(qū)動管理顯示內(nèi)存就是基于這種方式*/
;/*字符串形式的標識符*/
fbinfo->fix.type = FB_TYPE_PACKED_PIXELS;
fbinfo->fix.type_aux = 0;/*以下這些根據(jù)fb_fix_screeninfo定義中的描述,當沒有硬件是都設(shè)為0*/
fbinfo->fix.xpanstep = 0;
fbinfo->fix.ypanstep = 0;
fbinfo->fix.ywrapstep= 0;
fbinfo->fix.accel = FB_ACCEL_NONE;
/*接著,再初始化fb_info中代表LCD可變參數(shù)的結(jié)構(gòu)體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;
/*指定對底層硬件操作的函數(shù)指針, 因內(nèi)容較多故其定義在第③步中再講*/
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;
/*初始化色調(diào)色板(顏色表)為空*/
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中的可變參數(shù),其定義在后面講到*/
my2440fb_check_var(fbinfo);
/*申請幀緩沖設(shè)備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;
}
評論