【引用】Linux-2.6.32.2内核在mini2440上的移植(七)---LCD驱动移植

时间:2021-10-30 17:12:27

移植环境(红色粗字体字修改后内容,蓝色粗体字为特别注意内容)

1,主机环境:VMare下CentOS 5.5 ,1G内存。

2,集成开发环境:Elipse IDE

3,编译编译环境:arm-linux-gcc v4.4.3,arm-none-linux-gnueabi-gcc v4.5.1。

4,开发板:mini2440,2M nor flash,128M nand flash。

5,u-boot版本:u-boot-2009.08

6,linux 版本:linux-2.6.32.2

7,参考文章:

嵌入式linux应用开发完全手册,韦东山,编著。

Mini2440 之Linux 移植开发实战指南

【1】LCD 驱动基础知识

Linux-2.6.32.2 内核已经支持S3C2440 的LCD 控制器驱动,但在此我们先介绍一下关于2440 LCD 控制器以及驱动相关的LCD 的一些基础知识。
注意:在此我们只讨论 TFT LCD,也就是真彩屏。
LCD 驱动中最关键的就是时钟频率(Clock frequency)的设置,时钟频率设置不对,LCD的显示就会闪,或者根本没有显示。一般LCD 的Datasheet 上会写有一个推荐的频率,比如mini2440 所用的统宝3.5”LCD,在它的数据手册第13 页,有这样一个表格:

【引用】Linux-2.6.32.2内核在mini2440上的移植(七)---LCD驱动移植

 可以看到,这里推荐的时钟频率是6.39MHz,近似于6.4MHz,范围,是5M-6.85MHz。S3C2440 之LCD 控制器与此相关的设置为CLKVAL,通过设置它,就可以在LCD 接口的VCLK引脚上产生LCD 所需要的时钟频率,那么CLKVAL 和VCLK 有何种关系呢?在2440 手册(411页)中,有这样一段描述:

The rate of VCLK signal depends on the CLKVAL field in the LCDCON1 register. Table 15-3 defines the
relationship of VCLK and CLKVAL. The minimum value of CLKVAL is 0

接下来,手册中提供了它们的数学关系公式:

VCLK(Hz) = HCLK/[(CLKVAL+1)x2]

因此可以得出:

VCLK = HCLK / ((CLKVAL+1)*2)

那么HCLK 是多少呢?我们的开发板运行于400Mhz,这个可以在u-boot/cpu/arm920t/start.s 的172行附近可以看到如下代码:

# if defined(CONFIG_S3C2440)   //the s3c2440\'clock
#define MPLLCON   0x4C000004   //the address of register base to the main frequency

    ldr  r0, =CLKDIVN          //FCLK:HCLK:PCLK = 1:4:8
    mov  r1, #5
    str  r1, [r0]
    ldr  r0, =MPLLCON  //the main frequency is 405MHz 
    ldr  r1, =0x7f021  //refer to the manual  PLL VALUE SELECTION TABLE of the s3c2440 chip
    str  r1, [r0]

可见,FCLK:HCLK:PCLK = 1:4:8,因此得出HCLK=100Mhz,再根据上述公式得出CLKVAL 应为:
CLKVAL=HCLK/(VCLK*2) -1
CLKVAL = 100000000 / (6400000 * 2) - 1 = 6.8
选择最接近的整数值7,并把它写入LCDCON1:17-8(注意:我们实际使用的数值是8),由此产生的VCLK 频率实测为5.63Mhz 左右,它也是在5-6.85Mhz 之间的数值,如图:

【引用】Linux-2.6.32.2内核在mini2440上的移植(七)---LCD驱动移植

 

【2】 新内核中的pixclock 参数

在以前较老的 Linux 内核中,对于LCD 寄存器的设置都是这样直接填写CLKVAL 的,但Linux-2.6.32.2 内核却不再使用这样简单直观的方式,而是通过一个称为“pixclock”的参数进行调节,它的计算变的复杂和难以理解,我们不清楚Linux 内核中关于2440 部分的移植为何改变成这样的方式,这有可能是为了和X86 体系中的设置保持一致的风格,下面我们根据实际的代码进行一些推导和说明,但推导结果和我们的实际设置是并不一致的,会有一些误差。
提示:我们实际提供的 pixclock 参数并不是按照以下的方式推导计算出的,而是先确定好CLKVAL 的数值,再反复尝试、猜测得到的。
在 Framebuffer 驱动(linux-2.6.32.2/ drivers/video/s3c2410fb.c)中有这样一个函数:
clkdiv = DIV_ROUND_UP(s3c2410fb_calc_pixclk(fbi, var->pixclock), 2);
这里的clkdiv 就是我们上面提到的CLKVAL,而DIV_ROUND_UP 是一个宏定义,它位于include/linux/kernel.h 文件中:
#define DIV_ROUND_UP(n,d) (((n) + (d) - 1) / (d))
这其实是一个数学概念:向上取整。下面是关于“向上取整”的一段说明:

以下信息来自:http://www.vckbase.com/document/viewdoc/?id=743
1>. 问题
A,B 都是整数并且 A>1, B>1
求┌ A/B ┐ 即 A/B 的上取整。
当 A/B 整除,往上取整返回值为 A/B。
当 不整除,返回值是 int(A/B) + 1
这个算法的一个应用:如果你有一个动态增长的缓冲区,增长的步长是 B,
某一次缓冲区申请的大小是 A,这个时候,就可以用这个算法,计算出缓冲区的一个合
适大小了,正好可以容纳 A,并且不会过于得多,多余部分不会比B 多。
2>. 方法
int( (A+B-1)/B )
3>. HUNTON 的证明
上取整用 UP 表示
由于 A>1、B>1,且A、B 都是整数,所以可以设A=NB+M
其中N 为非负整数,M 为0 到B-1 的数,则
A/B = N + M/B
(A+B-1)/B = N + 1 + (M - 1)/B;
当M 为0 时,
UP(A/B) = N,
int((A+B-1)/B) = N + int(1 - 1/B) = N
当M 为1 到B-1 的数时,0 <= M-1 <= B-2
UP(A/B) = N + 1,
int((A+B-1)/B) = N + 1 + int((M-1)/B) = N + 1
所以对A>1、B>1 的整数A、B 都有:
UP(A/B) = int((A+B-1)/B)

对于除数为“2”的本算法而言,我们可以简单的理解为“(n/2)+0.5”所对应的整数值,因此这里不可能避免的就出现了误差,也就是说n 的数值是有一定范围的,这里的n 就是“s3c2410fb_calc_pixclk(fbi, var->pixclock)”,因此上面的公式可以改写为:
clkdiv= s3c2410fb_calc_pixclk(fbi, var->pixclock)/2 + 0.5
而 s3c2410fb_calc_pixclk(fbi, var->pixclock) 这个函数在linux-2.6.32.2/drivers/video/s3c2410fb.c 中是这样定义的:

/* s3c2410fb_calc_pixclk()
*
* calculate divisor for clk->pixclk
*/
static unsigned int s3c2410fb_calc_pixclk(struct s3c2410fb_info *fbi,
unsigned long pixclk)
{
unsigned long clk = fbi->clk_rate;
unsigned long long div;
/* pixclk is in picoseconds, our clock is in Hz
*
* Hz -> picoseconds is / 10^-12
*/
//;这里计算出本函数的结果
div = (unsigned long long)clk * pixclk;
div >>= 12; /* div / 2^12 */
do_div(div, 625 * 625UL * 625); /* div / 5^12 */
dprintk(\"pixclk %ld, divisor is %ld\\n\", pixclk, (long)div);
return div;
}

因此得出:
clkdiv=clk*pixclk/(10^12)/2 + 0.5
根据实际打印结果验证,此处的clk 其实就是HCLK。
而根据 static void s3c2410fb_activate_var(struct fb_info *info)函数中的描述,会得出这样一个关系:
CLKVAL=clkdiv-1
再结合从2440 芯片手册得到的公式CLKVAL=HCLK/(VCLK*2) -1,因此可以得出大致这样的结果(“大致”可以理解为一定的误差范围):
Pixclk=(HCLK-VLCK)x10^12/HCLK*VCLK
以我们所用的统宝屏为例:
HCLK=100Mhz=100,000,000Hz
VLCK=6.4Mhz=6400,000Hz
因此计算出:pixclk =146250,单位是ps(picoseconds),这和我们实际设置的数值170000是有一定误差的。
另外 , 在 Linux 内核文档中, 还有另外一种计算pixclock 的方式, 见linux/Documentation/fb/framebuffer.txt,在此我们就不再详细介绍了,感兴趣的可以自己看下,或者到网上查下相关资料。
如果你对这些参数比较“晕”,建议你按照友善官方已经移植验证好的参数进行设置,下面是具体的参考步骤。

【3】在内核中添加各种LCD 类型的支持

打开 arch/arm/mach-s3c2440/mach-mini2440.c,定位到114行到157行之间,先删除之前的LCD 设备平台代码,如下:

/* LCD driver info */

static struct s3c2410fb_display mini2440_lcd_cfg __initdata = {

 .lcdcon5 = S3C2410_LCDCON5_FRM565 |
     S3C2410_LCDCON5_INVVLINE |
     S3C2410_LCDCON5_INVVFRAME |
     S3C2410_LCDCON5_PWREN |
     S3C2410_LCDCON5_HWSWP,

 .type  = S3C2410_LCDCON1_TFT,

 .width  = 240,
 .height  = 320,

 .pixclock = 166667, /* HCLK 60 MHz, divisor 10 */
 .xres  = 240,
 .yres  = 320,
 .bpp  = 16,
 .left_margin = 20,
 .right_margin = 8,
 .hsync_len = 4,
 .upper_margin = 8,
 .lower_margin = 7,
 .vsync_len = 4,
};

static struct s3c2410fb_mach_info mini2440_fb_info __initdata = {
 .displays = &mini2440_lcd_cfg,
 .num_displays = 1,
 .default_display = 0,

#if 0
 /* currently setup by downloader */
 .gpccon  = 0xaa940659,
 .gpccon_mask = 0xffffffff,
 .gpcup  = 0x0000ffff,
 .gpcup_mask = 0xffffffff,
 .gpdcon  = 0xaa84aaa0,
 .gpdcon_mask = 0xffffffff,
 .gpdup  = 0x0000faff,
 .gpdup_mask = 0xffffffff,
#endif

 .lpcsel  = ((0xCE6) & ~7) | 1<<4,
};
再把友善之臂已经移植好的代码加入,如下:

//;NEC 3.5”LCD 的配置和参数设置
#if defined(CONFIG_FB_S3C2410_N240320)
#define LCD_WIDTH 240
#define LCD_HEIGHT 320
#define LCD_PIXCLOCK 100000
#define LCD_RIGHT_MARGIN 36
#define LCD_LEFT_MARGIN 19
#define LCD_HSYNC_LEN 5
#define LCD_UPPER_MARGIN 1
#define LCD_LOWER_MARGIN 5
#define LCD_VSYNC_LEN 1
//;夏普8”LCD 的配置和参数设置
#elif defined(CONFIG_FB_S3C2410_TFT640480)
#define LCD_WIDTH 640
#define LCD_HEIGHT 480
#define LCD_PIXCLOCK 80000
#define LCD_RIGHT_MARGIN 67
#define LCD_LEFT_MARGIN 40
#define LCD_HSYNC_LEN 31
#define LCD_UPPER_MARGIN 25
#define LCD_LOWER_MARGIN 5
#define LCD_VSYNC_LEN 1
//;统宝3.5”LCD 的配置和参数设置
#elif defined(CONFIG_FB_S3C2410_T240320)
#define LCD_WIDTH 240
#define LCD_HEIGHT 320
#define LCD_PIXCLOCK 146250//170000
#define LCD_RIGHT_MARGIN 25
#define LCD_LEFT_MARGIN 0
#define LCD_HSYNC_LEN 4
#define LCD_UPPER_MARGIN 1
#define LCD_LOWER_MARGIN 4
#define LCD_VSYNC_LEN 1
//;群创7”LCD 的配置和参数设置
#elif defined(CONFIG_FB_S3C2410_TFT800480)
#define LCD_WIDTH 800
#define LCD_HEIGHT 480
#define LCD_PIXCLOCK 11463//40000
#define LCD_RIGHT_MARGIN 67
#define LCD_LEFT_MARGIN 40
#define LCD_HSYNC_LEN 31
#define LCD_UPPER_MARGIN 25
#define LCD_LOWER_MARGIN 5
#define LCD_VSYNC_LEN 1
//;LCD2VGA(分辨率为1024x768)模块的配置和参数设置
#elif defined(CONFIG_FB_S3C2410_VGA1024768)
#define LCD_WIDTH 1024
#define LCD_HEIGHT 768
#define LCD_PIXCLOCK 80000
#define LCD_RIGHT_MARGIN 15
#define LCD_LEFT_MARGIN 199
#define LCD_HSYNC_LEN 15
#define LCD_UPPER_MARGIN 1
#define LCD_LOWER_MARGIN 1
#define LCD_VSYNC_LEN 1
#define LCD_CON5 (S3C2410_LCDCON5_FRM565 | S3C2410_LCDCON5_HWSWP)
#endif
#if defined (LCD_WIDTH)
static struct s3c2410fb_display mini2440_lcd_cfg __initdata = {
#if !defined (LCD_CON5)
.lcdcon5 = S3C2410_LCDCON5_FRM565 |
S3C2410_LCDCON5_INVVLINE |
S3C2410_LCDCON5_INVVFRAME |
S3C2410_LCDCON5_PWREN |
S3C2410_LCDCON5_HWSWP,
#else
.lcdcon5 = LCD_CON5,
#endif
.type = S3C2410_LCDCON1_TFT,
.width = LCD_WIDTH,
.height = LCD_HEIGHT,
.pixclock = LCD_PIXCLOCK,
.xres = LCD_WIDTH,
.yres = LCD_HEIGHT,
.bpp = 16,
.left_margin = LCD_LEFT_MARGIN + 1,
.right_margin = LCD_RIGHT_MARGIN + 1,
.hsync_len = LCD_HSYNC_LEN + 1,
.upper_margin = LCD_UPPER_MARGIN + 1,
.lower_margin = LCD_LOWER_MARGIN + 1,
.vsync_len = LCD_VSYNC_LEN + 1,
};
static struct s3c2410fb_mach_info mini2440_fb_info __initdata = {
.displays = &mini2440_lcd_cfg,
.num_displays = 1,
.default_display = 0,
.gpccon = 0xaa955699,
.gpccon_mask = 0xffc003cc,
.gpcup = 0x0000ffff,
.gpcup_mask = 0xffffffff,
.gpdcon = 0xaa95aaa1,
.gpdcon_mask = 0xffc0fff0,
.gpdup = 0x0000faff,
.gpdup_mask = 0xffffffff,
.lpcsel = 0xf82,
};
#endif

然后打开drivers/video/Kconfig,在大概1930 行加入以下配置信息:

config FB_S3C2410_DEBUG
 bool \"S3C2410 lcd debug messages\"
 depends on FB_S3C2410
 help
   Turn on debugging messages. Note that you can set/unset at run time
   through sysfs
choice
 prompt \"LCD select\"
 depends on FB_S3C2410
 help
  S3C24x0 LCD size select

config FB_S3C2410_T240320
 boolean \"3.5 inch 240X320 Toppoly LCD\"
 depends on FB_S3C2410
 help
  3.5 inch 240X320 Toppoly LCD

config FB_S3C2410_N240320
 boolean \"3.5 inch 240X320 NEC LCD\"
 depends on FB_S3C2410
 help
  3.5 inch 240x320 NEC LCD

config FB_S3C2410_TFT640480
 boolean \"8 inch 640X480 L80 LCD\"
 depends on FB_S3C2410
 help
  8 inch 640X480 LCD

config FB_S3C2410_TFT800480
 boolean \"7 inch 800x480 TFT LCD\"
 depends on FB_S3C2410
 help
  7 inch 800x480 TFT LCD

config FB_S3C2410_VGA1024768
 boolean \"VGA 1024x768\"
 depends on FB_S3C2410
 help
  VGA 1024x768

endchoice

config FB_SM501
 tristate \"Silicon Motion SM501 framebuffer support\"
 depends on FB && MFD_SM501
 select FB_CFB_FILLRECT
 select FB_CFB_COPYAREA

定位到326行附近,在初始化部分加入:

static void __init mini2440_map_io(void)
{
 s3c24xx_init_io(mini2440_iodesc, ARRAY_SIZE(mini2440_iodesc));
 s3c24xx_init_clocks(12000000);
 s3c24xx_init_uarts(mini2440_uartcfgs, ARRAY_SIZE(mini2440_uartcfgs));
 
}

static void __init mini2440_machine_init(void)
{
#if defined (LCD_WIDTH)
 s3c24xx_fb_set_platdata(&mini2440_fb_info);
#endif
 s3c_i2c0_set_platdata(NULL);
 s3c_device_nand.dev.platform_data = &mini2440_nand_info;
 platform_add_devices(mini2440_devices, ARRAY_SIZE(mini2440_devices));
 //smdk_machine_init();
}

这样,我们就完成了LCD 驱动的移植,如果你需要加入其他型号的LCD 驱动,也可以参照上面的方式复制即可,一般小尺寸的pixclock 参数可以参考统宝3.5”的,超过640x480分辨率的参数可以参考8”LCD 的,特别要注意你使用的LCD 的长宽也要修改。

【4】配置内核并下载到开发板测试

现在,我们在命令行输入:make menuconfig 进入内核配置,依次按下面的子菜单项选择:

Device Drivers --->
    Graphics support --->
        <*> Support for frame buffer devices --->
            LCD select (3.5 inch 240X320 Toppoly LCD) --->

               (X) 3.5 inch 240X320 Toppoly LCD    //选择统宝3.5寸液晶

    Console display driver support  ---> 

         <*> Framebuffer Console support   //支持Framebuffer控制台

         [*] Select compiled-in fonts  //选择字库,默认VGA 8x8 , VGA 8x16

        [*]   VGA 8x8 font  

        [*]   VGA 8x16 font 

    [*] Bootup logo  ---> 

         [*]   Standard 224-color Linux logo  

 按空格或者回车键选择我们需要的 LCD 型号,然后退出保存内核配置。
在命令行执行:
#make uImage
将会生成arch/arm/boot/uImage,把它烧写到开发板中,就可以看到一个小企鹅出现在屏幕上了,如图

【引用】Linux-2.6.32.2内核在mini2440上的移植(七)---LCD驱动移植

而且logo左下方有一个光标提示符在闪动。

【5】修改Linux Logo

(1)使用命令行工具修改Linux LOGO

在上一小节中我们看到Linux 系统启动时会出现一个小企鹅图像。大部分Linux 系统会有这个开机图片, 它对应的文件其实就是
linux-2.6.32.2/drivers/video/logo/linux_logo_clut224.ppm
该文件是一个特殊格式的图像文件,有很多方法可以把普通的图片转换为 logo 文件,最常用的就是netpbm 工具组。
“netpbm”是一组命令行的工具,它可以转换很多格式的图片,在此以png 格式为例介绍一下如何把普通的PNG 文件转换为我们需要的Linux LOGO 图片:
假定我们要转换的文件名为 linux_logo.png,首先将png 图片转成pnm
# pngtopnm linux_logo.png > linux_logo.pnm
然后将pnm 图片的颜色数限制在224
# pnmquant 224 linux_logo.pnm > linux_logo_clut224.pnm
最后将pnm 图片转换成我们需要的ppm
# pnmtoplainpnm linux_logo_clut224.pnm > linux_logo_clut224.ppm
然linux_logo_clut224.ppm 替换linux-2.6.32.2/drivers/video/logo 中对应的图像就可以了。

(2)使用图形化的logomaker 制作Linux LOGO

为了让用户使用的更方便些,友善之臂开发一个图形界面的制作工具LogoMaker,它基于Fedora 9 平台开发,其实它的底层调用的就是上述命令行工具,如果你运行的结果出现浮点数错误,那可能你使用的平台并非Federa9,如果在Fedora9 下运行出现如图错误,你可能没有正确安装netpbm 工具(这里强烈推荐用户按照手册介绍的步骤安装Fedora9 平台):

【引用】Linux-2.6.32.2内核在mini2440上的移植(七)---LCD驱动移植

 友善官方光盘中logomaker工具包,这里复制到的linux-test目录

[root@localhost ~]# cd linux-test
[root@localhost linux-test]# ls
busybox-1.13.3               lzo-2.05
busybox-1.13.3-mini2440.tgz  mkyaffs2image.tgz
logomaker.tgz  

[root@localhost linux-test]# tar xzvf logomaker.tgz -C /
usr/sbin/logomaker
[root@localhost linux-test]#
注意:C 是大写的,C 后面有个空格,C 是改变解压安装目录的意思

执行以上命令,LogoMaker 将会被安装到/usr/sbin 目录下,它只有一个文件,安装完之后在命令行输入logomaker 可出现如下界面

【引用】Linux-2.6.32.2内核在mini2440上的移植(七)---LCD驱动移植

 

下面是Linux LogoMaker 的使用步骤:

点 File->Open a picture file…或者使用快捷键Ctrl+O 可以打开一个图片文件(其大小应该不大于屏幕像素大小),在跳出的文件打开窗口中选择一个图片:

【引用】Linux-2.6.32.2内核在mini2440上的移植(七)---LCD驱动移植

 

 这时点File->Convert the picture to a Linux Logo File,或者使用快捷键Crtl+C 会跳出文件保存目录窗口,不需要输入任何东西,选择要保存的目录即可,文件名将会自动保存为linux_logo_clut224.ppm,使用这个文件代替linux-2.6.32.2/drivers/video/logo 目录下的同名文件即可。

【6】通过LCD显示内核启动信息

之前内核通过串口打印内核信息时,内核命令行参数为console=ttySAC0,现在可以多加一项,即“console=ttySAC0, console=tty1 ”。

注意,tty1表示第一个虚拟终端,tty2表示第二个虚拟终端,... ... tty0表示当前虚拟终端。

不过要想通过它来登录,还需要修改inittab文件,增加以下6行:

#/etc/inittab
::sysinit:/etc/init.d/rcS
console::askfirst:-/bin/sh
tty1::askfirst:-/bin/sh
tty2::askfirst:-/bin/sh
tty3::askfirst:-/bin/sh
tty4::askfirst:-/bin/sh
tty5::askfirst:-/bin/sh
tty6::askfirst:-/bin/sh
::ctrlaltdel:/sbin/reboot
::shutdown:/bin/umount -a –r

这样会在虚拟终端上启动shell程序。在LCD的USB键盘上按下Alt+Fn(n=1~6)可以在第1~6个控制台之间切换。

在串口终端中

[root@mini2440 /]#ls -l /dev/tty0
crw-rw----    1 root     root       4,   0 Jan  1 00:00 /dev/tty0
[root@mini2440 /]#ls -l /dev/tty1
crw-rw----    1 root     root       4,   1 Jan  1 00:00 /dev/tty1
[root@mini2440 /]#

可以看到虚拟终端tty0,tty1的主设备号位4,此设备号分别为0和1,c表示是字符设备。

在串口终端中

[root@mini2440 /]#echo hello >/dev/tty0
[root@mini2440 /]#

可以子在当前LCD上显示hello 字符。

接下来,将要为内核添加ADC驱动。