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

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

移植环境(红色粗字体字为修改后内容，蓝色粗体字为特别注意内容)
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 页，有这样一个表格：



 可以看到，这里推荐的时钟频率是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 之间的数值，如图：



 
【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，把它烧写到开发板中，就可以看到一个小企鹅出现在屏幕上了，如图



而且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 平台）：



 友善官方光盘中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 LogoMaker 的使用步骤：
点 File->Open a picture file…或者使用快捷键Ctrl+O 可以打开一个图片文件（其大小应该不大于屏幕像素大小），在跳出的文件打开窗口中选择一个图片：



 
 这时点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驱动。