一、開發環境
- 主 機:VMWare--Fedora 9
- 開發闆:Mini2440--64MB Nand, Kernel:2.6.30.4
- 編譯器:arm-linux-gcc-4.3.2
二、背景知識
1. LCD工作的硬體需求: 要使一塊LCD正常的顯示文字或圖像,不僅需要LCD驅動器,而且還需要相應的LCD控制器。在通常情況下,生産廠商把LCD驅動器會以COF/COG的形式與LCD玻璃基闆制作在一起,而LCD控制器則是由外部的電路來實作,現在很多的MCU内部都內建了LCD控制器,如S3C2410/2440等。通過LCD控制器就可以産生LCD驅動器所需要的控制信号來控制STN/TFT屏了。 2. S3C2440内部LCD控制器結構圖:
![](https://img.laitimes.com/img/__Qf2AjLwojIjJCLyojI0JCLicmbw5iM1IDN0ETMwMDMwEzX5QjNxATMvw1b09Gaw9CX0VmbugXauVXYulGaj5yZvxmYvw1LcpDc0RHaiojIsJye.png)
我們根據資料手冊來描述一下這個內建在S3C2440内部的LCD控制器: a:LCD控制器由REGBANK、LCDCDMA、TIMEGEN、VIDPRCS寄存器組成; b:REGBANK由17個可程式設計的寄存器組和一塊256*16的調色闆記憶體組成,它們用來配置LCD控制器的; c:LCDCDMA是一個專用的DMA,它能自動地把在偵記憶體中的視訊資料傳送到LCD驅動器,通過使用這個DMA通道,視訊資料在不需要 CPU的幹預的情況下顯示在LCD屏上; d:VIDPRCS接收來自LCDCDMA的資料,将資料轉換為合适的資料格式,比如說4/8位單掃,4位雙掃顯示模式,然後通過資料端口 VD[23:0]傳送視訊資料到LCD驅動器; e:TIMEGEN由可程式設計的邏輯組成,他生成LCD驅動器需要的控制信号,比如VSYNC、HSYNC、VCLK和LEND等等,而這些控制信号又與REGBANK寄存器組中的LCDCON1/2/3/4/5的配置密切相關,通過不同的配置,TIMEGEN就能産生這些信号的不同形态,進而支援不同的LCD驅動器(即不同的STN/TFT屏)。 3. 常見TFT屏工作時序分析:
LCD提供的外部接口信号:
|
所有顯示器顯示圖像的原理都是從上到下,從左到右的。這是什麼意思呢?這麼說吧,一副圖像可以看做是一個矩形,由很多排列整齊的點一行一行組成,這些點稱之為像素。那麼這幅圖在LCD上的顯示原理就是:
|
上面時序圖上各時鐘延時參數的含義如下:(這些參數的值,LCD産生廠商會提供相應的資料手冊)
|
對于以上這些參數的值将分别儲存到REGBANK寄存器組中的LCDCON1/2/3/4/5寄存器中:(對寄存器的操作請檢視S3c2440 資料手冊LCD部分)
|
4. 幀緩沖(FrameBuffer): 幀緩沖是Linux為顯示裝置提供的一個接口,它把一些顯示裝置描述成一個緩沖區,允許應用程式通過 FrameBuffer定義好的接口通路這些圖形裝置,進而不用去關心具體的硬體細節。對于幀緩沖裝置而言,隻要在顯示緩沖區與顯示點對應的區域寫入顔色值,對應的顔色就會自動的在螢幕上顯示。下面來看一下在不同色位模式下緩沖區與顯示點的對應關系:
三 、幀緩沖(FrameBuffer)裝置驅動結構 : 幀緩沖裝置為标準的字元型裝置,在Linux中主裝置号29,定義在/include/linux/major.h中的 FB_MAJOR,次裝置号定義幀緩沖的個數,最大允許有32個FrameBuffer,定義在/include/linux/fb.h中的 FB_MAX,對應于檔案系統下/dev/fb%d裝置檔案。
1. 幀緩沖裝置驅動在Linux子系統中的結構如下:
我們從上面這幅圖看,幀緩沖裝置在Linux中也可以看做是一個完整的子系統,大體由fbmem.c和 xxxfb.c組成。向上給應用程式提供完善的裝置檔案操作接口(即對FrameBuffer裝置進行read、write、ioctl等操作),接口在 Linux提供的fbmem.c檔案中實作;向下提供了硬體操作的接口,隻是這些接口Linux并沒有提供實作,因為這要根據具體的LCD控制器硬體進行設定,是以這就是我們要做的事情了(即xxxfb.c部分的實作)。
2. 幀緩沖相關的重要資料結構:
從幀緩沖裝置驅動程式結構看,該驅動主要跟fb_info結構體有關,該結構體記錄了幀緩沖裝置的全部資訊,包括裝置的設定參數、狀态以及對底層硬體操作的函數指針。在Linux 中,每一個幀緩沖裝置都必須對應一個fb_info,fb_info在/linux/fb.h中的定義如下:(隻列出重要的一些)
|
其中,比較重要的成員有struct fb_var_screeninfo var、struct fb_fix_screeninfo fix和struct fb_ops * fbops,他們也都是結構體。下面我們一個一個的來看。
fb_var_screeninfo結構體主要記錄使用者可以修改的控制器的參數,比如螢幕的分辨率和每個像素的比特數等,該結構體定義如下:
|
而fb_fix_screeninfo結構體又主要記錄使用者不可以修改的控制器的參數,比如螢幕緩沖區的實體位址和長度等,該結構體的定義如下:
|
fb_ops結構體是對底層硬體操作的函數指針,該結構體中定義了對硬體的操作有:(這裡隻列出了常用的操作)
|
3. 幀緩沖裝置作為平台裝置:
在S3C2440中,LCD控制器被內建在晶片的内部作為一個相對獨立的單元,是以Linux把它看做是一個平台裝置,故在核心代碼/arch/arm/plat-s3c24xx /devs.c中定義有LCD相關的平台裝置及資源,代碼如下:
|
除此之外,Linux還在/arch/arm/mach-s3c2410/include/mach/fb.h中為LCD平台裝置定義了一個 s3c2410fb_mach_info結構體,該結構體主要是記錄LCD的硬體參數資訊(比如該結構體的s3c2410fb_display成員結構中就用于記錄LCD的螢幕尺寸、螢幕資訊、可變的螢幕參數、LCD配置寄存器等),這樣在寫驅動的時候就直接使用這個結構體。下面,我們來看一下核心是如果使用這個結構體的。在/arch/arm/mach-s3c2440/mach-smdk2440.c中定義有:
|
注意:可能有很多朋友不知道上面紅色部分的參數是做什麼的,其值又是怎麼設定的?其實它是跟你的開發闆LCD控制器密切相關的,看了下面兩幅圖相信就大概知道他們是幹什麼用的:
上面第一幅圖是開發闆原理圖的LCD控制器部分,第二幅圖是S3c2440資料手冊中IO端口C和IO端口D控制器部分。原理圖中使用了 GPC8-15和GPD0-15來用做LCD控制器VD0-VD23的資料端口,又分别使用GPC0、GPC1端口用做LCD控制器的LEND和VCLK 信号,對于GPC2-7則是用做STN屏或者三星專業TFT屏的相關信号。然而,S3C2440的各個IO口并不是單一的功能,都是複用端口,要使用他們首先要對他們進行配置。是以上面紅色部分的參數就是把GPC和GPD的部分端口配置成LCD控制功能模式。
從以上講述的内容來看,要使LCD控制器支援其他的LCD屏,重要的是根據LCD的資料手冊修改以上這些參數的值。下面,我們再看一下在驅動中是如果引用到s3c2410fb_mach_info結構體的(注意上面講的是在核心中如何使用的)。在mach-smdk2440.c中有:
|
s3c24xx_fb_set_platdata定義在 plat- s3c24xx/devs.c中:
|
這裡再講一個小知識:不知大家有沒有留意,在平台裝置驅動中,platform_data可以儲存各自平台裝置執行個體的資料,但這些資料的類型都是不同的,為什麼都可以儲存?這就要看看platform_data的定義,定義在/linux/device.h中,void *platform_data是一個void類型的指針,在Linux中void可儲存任何資料類型。
四、幀緩沖(FrameBuffer)裝置驅動執行個體代碼:
①、建立驅動檔案:my2440_lcd.c,依就是驅動程式的最基本結構:FrameBuffer 驅動的初始化和解除安裝部分及其他,如下:
static char driver_name[] = " my2440_lcd " ; struct my2440fb_var { int lcd_irq_no; struct clk * lcd_clock; struct resource * lcd_mem; void __iomem * lcd_base; struct device * dev; struct s3c2410fb_hw regs; u32 palette_buffer[ 256] ; u32 pseudo_pal[16]; unsigned int palette_ready; } ; # define PALETTE_BUFF_CLEAR ( 0x80000000) static struct platform_driver lcd_fb_driver = { . probe = lcd_fb_probe, . remove = __devexit_p( lcd_fb_remove) , . suspend = lcd_fb_suspend, . resume = lcd_fb_resume, . driver = { . name = "s3c2410-lcd" , . owner = THIS_MODULE, } , } ; static int __init lcd_init( void ) { 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平台裝置各接口函數的實作:
fbinfo - > flags = FBINFO_FLAG_DEFAULT ; fbinfo->pseudo_palette = &fbvar->pseudo_pal; for ( i = 0; i < mach_info- > num_displays; i+ + ) { 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; } } msleep( 1) ; my2440fb_init_registers( fbinfo) ; my2440fb_check_var( fbinfo) ; ret = my2440fb_map_video_memory( fbinfo) ; if ( ret) { dev_err( & pdev- > dev, "failed to allocate video RAM: %d/n" , ret) ; ret = - ENOMEM; goto err_nofb; } ret = register_framebuffer( fbinfo) ; if ( ret < 0) { dev_err( & pdev- > dev, "failed to register framebuffer device: %d/n" , ret) ; goto err_video_nomem; } ret = device_create_file( & pdev- > dev, & dev_attr_debug) ; if ( ret) { dev_err( & pdev- > dev, "failed to add debug attribute/n" ) ; } return 0; err_nomem: release_resource( fbvar- > lcd_mem) ; kfree( fbvar- > lcd_mem) ; err_nomap: iounmap( fbvar- > lcd_base) ; err_noclk: clk_disable( fbvar- > lcd_clock) ; clk_put( fbvar- > lcd_clock) ; err_noirq: free_irq( fbvar- > lcd_irq_no, fbvar) ; err_nofb: platform_set_drvdata( pdev, NULL ) ; framebuffer_release( fbinfo) ; err_video_nomem: my2440fb_unmap_video_memory( fbinfo) ; return ret; } static irqreturn_t lcd_fb_irq( int irq, void * dev_id) { struct my2440fb_var * fbvar = dev_id; void __iomem * lcd_irq_base; unsigned long lcdirq; lcd_irq_base = fbvar- > lcd_base + S3C2410_LCDINTBASE; lcdirq = readl( lcd_irq_base + S3C24XX_LCDINTPND) ; if ( lcdirq & S3C2410_LCDINT_FRSYNC) { if ( fbvar- > palette_ready) { my2440fb_write_palette( fbvar) ; } writel( S3C2410_LCDINT_FRSYNC, lcd_irq_base + S3C24XX_LCDINTPND) ; writel( S3C2410_LCDINT_FRSYNC, lcd_irq_base + S3C24XX_LCDSRCPND) ; } return IRQ_HANDLED; } static void my2440fb_write_palette( struct my2440fb_var * fbvar) { unsigned int i; void __iomem * regs = fbvar- > lcd_base; fbvar- > palette_ready = 0; for ( i = 0; i < 256; i+ + ) { unsigned long ent = fbvar- > palette_buffer[ i] ; if ( ent = = PALETTE_BUFF_CLEAR) { continue ; } writel( ent, regs + S3C2410_TFTPAL( i) ) ; if ( readw( regs + S3C2410_TFTPAL( i) ) = = ent) { fbvar- > palette_buffer[ i] = PALETTE_BUFF_CLEAR; } else { fbvar- > palette_ready = 1; } } } static int my2440fb_init_registers( struct fb_info * fbinfo) { unsigned long flags; void __iomem * tpal; void __iomem * lpcsel; struct my2440fb_var * fbvar = fbinfo- > par; struct s3c2410fb_mach_info * mach_info = fbvar- > dev- > platform_data; tpal = fbvar- > lcd_base + S3C2410_TPAL; lpcsel = fbvar- > lcd_base + S3C2410_LPCSEL; local_irq_save( flags) ; modify_gpio( S3C2410_GPCUP, mach_info- > gpcup, mach_info- > gpcup_mask) ; modify_gpio( S3C2410_GPCCON, mach_info- > gpccon, mach_info- > gpccon_mask) ; modify_gpio( S3C2410_GPDUP, mach_info- > gpdup, mach_info- > gpdup_mask) ; modify_gpio( S3C2410_GPDCON, mach_info- > gpdcon, mach_info- > gpdcon_mask) ; local_irq_restore( flags) ; writel( 0x00, tpal) ; writel( mach_info- > lpcsel, lpcsel) ; return 0; } static inline void modify_gpio( void __iomem * reg, unsigned long set , unsigned long mask) { unsigned long tmp; tmp = readl( reg) & ~ mask; writel( tmp | set , reg) ; } static int my2440fb_check_var( struct fb_info * fbinfo) { unsigned i; struct fb_var_screeninfo * var = & fbinfo- > var; struct my2440fb_var * fbvar = fbinfo- > par; struct s3c2410fb_mach_info * mach_info = fbvar- > dev- > platform_data; struct s3c2410fb_display * display = NULL ; struct s3c2410fb_display * default_display = mach_info- > displays + mach_info- > default_display; int type = default_display- > type; if ( var- > yres = = default_display- > yres & & var- > xres = = default_display- > xres & & var- > bits_per_pixel = = default_display- > bpp) { display = default_display; } else { for ( i = 0; i < mach_info- > num_displays; i+ + ) { if ( type = = mach_info- > displays[ i] . type & & var- > yres = = mach_info- > displays[ i] . yres & & var- > xres = = mach_info- > displays[ i] . xres & & var- > bits_per_pixel = = mach_info- > displays[ i] . bpp) { display = mach_info- > displays + i; break ; } } } if ( ! display) { return - EINVAL; } fbvar- > regs. lcdcon1 = display- > type; fbvar- > regs. lcdcon5 = display- > lcdcon5; var- > xres_virtual = display- > xres; var- > yres_virtual = display- > yres; var- > height = display- > height; var- > width = display- > width; var- > pixclock = display- > pixclock; var- > left_margin = display- > left_margin; var- > right_margin = display- > right_margin; var- > upper_margin = display- > upper_margin; var- > lower_margin = display- > lower_margin; var- > vsync_len = display- > vsync_len; var- > hsync_len = display- > hsync_len; var- > transp. offset = 0; var- > transp. length = 0; 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; break ; case 8: if ( display- > type ! = S3C2410_LCDCON1_TFT) { var- > red. length = 3; var- > red. offset = 5; var- > green. length = 3; var- > green. offset = 2; var- > blue. length = 2; var- > blue. offset = 0; } else { var- > red. offset = 0; var- > red. length = 8; var- > green = var- > red; var- > blue = var- > red; } break ; case 12: var- > red. length = 4; var- > red. offset = 8; var- > green. length = 4; var- > green. offset = 4; var- > blue. length = 4; var- > blue. offset = 0; break ; case 16: if ( display- > lcdcon5 & S3C2410_LCDCON5_FRM565) { var- > red. offset = 11; var- > green. offset = 5; var- > blue. offset = 0; var- > red. length = 5; var- > green. length = 6; var- > blue. length = 5; } else { var- > red. offset = 11; var- > green. offset = 6; var- > blue. offset = 1; var- > red. length = 5; var- > green. length = 5; var- > blue. length = 5; } break ; case 32: var- > red. length = 8; var- > red. offset = 16; var- > green. length = 8; var- > green. offset = 8; var- > blue. length = 8; var- > blue. offset = 0; break ; } return 0; } static int __init my2440fb_map_video_memory( struct fb_info * fbinfo) { dma_addr_t map_dma; struct my2440fb_var * fbvar = fbinfo- > par; unsigned map_size = PAGE_ALIGN( fbinfo- > fix. smem_len) ; fbinfo- > screen_base = dma_alloc_writecombine( fbvar- > dev, map_size, & map_dma, GFP_KERNEL) ; if ( fbinfo- > screen_base) { memset ( fbinfo- > screen_base, 0x00, map_size) ; fbinfo- > fix. smem_start = map_dma; } return fbinfo- > screen_base ? 0 : - ENOMEM; } static inline void my2440fb_unmap_video_memory( struct fb_info * fbinfo) { struct my2440fb_var * fbvar = fbinfo- > par; unsigned map_size = PAGE_ALIGN( fbinfo- > fix. smem_len) ; dma_free_writecombine( fbvar- > dev, map_size, fbinfo- > screen_base, fbinfo- > fix. smem_start) ; } static int __devexit lcd_fb_remove( struct platform_device * pdev) { struct fb_info * fbinfo = platform_get_drvdata( pdev) ; struct my2440fb_var * fbvar = fbinfo- > par; unregister_framebuffer( fbinfo) ; my2440fb_lcd_enable( fbvar, 0) ; msleep( 1) ; my2440fb_unmap_video_memory( fbinfo) ; platform_set_drvdata( pdev, NULL ) ; framebuffer_release( fbinfo) ; free_irq( fbvar- > lcd_irq_no, fbvar) ; if (fbvar - >lcd_clock ) { clk_disable( fbvar- > lcd_clock) ; clk_put( fbvar- > lcd_clock) ; fbvar- > lcd_clock = NULL ; } iounmap( fbvar- > lcd_base) ; release_resource( fbvar- > lcd_mem) ; kfree( fbvar- > lcd_mem) ; return 0; } static void my2440fb_lcd_enable( struct my2440fb_var * fbvar, int enable) { unsigned long flags; local_irq_save( flags) ; if ( enable) { fbvar- > regs. lcdcon1 | = S3C2410_LCDCON1_ENVID; } else { fbvar- > regs. lcdcon1 & = ~ S3C2410_LCDCON1_ENVID; } writel( fbvar- > regs. lcdcon1, fbvar- > lcd_base + S3C2410_LCDCON1) ; local_irq_restore( flags) ; } # ifdef CONFIG_PM static int lcd_fb_suspend( struct platform_device * pdev, pm_message_t state) { struct fb_info * fbinfo = platform_get_drvdata(p dev) ; struct my2440fb_var * fbvar = fbinfo- > par; my2440fb_lcd_enable( fbvar, 0) ; msleep( 1) ; clk_disable( fbvar- > lcd_clock) ; return 0; } static int lcd_fb_resume( struct platform_device * pdev) { struct fb_info * fbinfo = platform_get_drvdata(p dev) ; struct my2440fb_var * fbvar = fbinfo- > par; clk_enable( fbvar- > lcd_clock) ; msleep( 1) ; my2440fb_init_registers( fbinfo) ; my2440fb_activate_var( fbinfo) ; my2440fb_blank( FB_BLANK_UNBLANK, fbinfo) ; return 0; } # else # define lcd_fb_suspend NULL # define lcd_fb_resume NULL # endif |
③、幀緩沖裝置驅動對底層硬體操作的函數接口實作(即:my2440fb_ops的實作):
|
五、從整體上再描述一下FrameBuffer裝置驅動執行個體代碼的結構: 1、在第①部分代碼中主要做的事情有: a.将LCD裝置注冊到系統平台裝置中; b.定義LCD平台裝置結構體lcd_fb_driver。 2、在第②部分代碼中主要做的事情有: a.擷取和設定LCD平台裝置的各種資源; b.配置設定fb_info結構體空間; c.初始化fb_info結構體中的各參數; d.初始化LCD控制器; e.檢查fb_info中可變參數; f.申請幀緩沖裝置的顯示緩沖區空間; g.注冊fb_info。 3、在第③ 部分代碼中主要做的事情有: a.實作對fb_info相關參數進行檢查的硬體接口函數; b.實作對LCD顯示模式進行設定的硬體接口函數; c.實作對LCD顯示開關(空白)的硬體接口函數等。
- c/c++(語言工具)(16)
- algorithm(算法)(7)
- android(30)
- Linux(36)
- wince6.0(31)
- hardware(硬體)(38)
- bootloader(引導程式)(1)
- device driver(裝置驅動)(1)
- file system(檔案系統)(1)
- OS(作業系統)(18)
- application(應用開發)(18)
- My life(生活感悟)(11)
- health(養生)(2)
- 單片機(3)