AM335x(TQ335x)学习笔记——LCD驱动移植

TI的LCD控制器驱动是非常完善的，共通的地方已经由驱动封装好了，与按键一样，我们可以通过DTS配置完成LCD的显示。下面，我们来讨论下使用DTS方式配置内核完成LCD驱动的思路。

（1）初步分析

由于TQ335x使用的芯片是AM335x，故仍然可以参考am335x-evm.dts。当然，am335x-evmsk.dts、am335x-beagbone.dts都可以。本文以am335x-evm.dts为例。大体上浏览下DTS文件，可以发现两个醒目的节点：一个是panel，一个是backlight。接下来我们逐个分析。

（2）panel节点信息分析及配置

从panel节点可以获得如下信息：

[cpp]  view plain copy

1. 1. 匹配内核驱动的关键词是："ti,tilcdc,panel"，可以通过这个关键字找到相应的驱动。  
2. 2. 管脚配置在节点lcd_pins_s0内  
3. 3. panel-info中可以配置LCD的硬件信息，如LCD的分辨率等  
4. 4. display-times中记录了LCD刷屏的相关时序。  

TN92的水平扫描时序如下表：

垂直扫描时序如下图：

但是，如果对LCD各参数不怎么熟悉的话，很难建立这两个表与DTS中display-times的关系，这时应该去查阅一下linux内核的文档和芯片手册。在内核文档：”Documentation/devicetree/bindings/video/display-timing.txt"有相关的记载，该文件中有形象的描述，具体如下：

[cpp]  view plain copy

1. +----------+-------------------------------------+----------+-------+  
2. |          |        ↑                            |          |       |  
3. |          |        |vback_porch                 |          |       |  
4. |          |        ↓                            |          |       |  
5. +----------#######################################----------+-------+  
6. |          #        ↑                            #          |       |  
7. |          #        |                            #          |       |  
8. |  hback   #        |                            #  hfront  | hsync |  
9. |   porch  #        |       hactive              #  porch   |  len  |  
10. |<-------->#<-------+--------------------------->#<-------->|<----->|  
11. |          #        |                            #          |       |  
12. |          #        |vactive                     #          |       |  
13. |          #        |                            #          |       |  
14. |          #        ↓                            #          |       |  
15. +----------#######################################----------+-------+  
16. |          |        ↑                            |          |       |  
17. |          |        |vfront_porch                |          |       |  
18. |          |        ↓                            |          |       |  
19. +----------+-------------------------------------+----------+-------+  
20. |          |        ↑                            |          |       |  
21. |          |        |vsync_len                   |          |       |  
22. |          |        ↓                            |          |       |  
23. +----------+-------------------------------------+----------+-------+  

综合这三份资料，很容易确定下LCD的屏的时序参数的范围（需要强调的是，上述参数不一定精确，还需要使用图片实机测下效果），经过多次实验，最终确定下了LCD的时序参数，详情如下：

[cpp]  view plain copy

1. panel {  
2.     compatible = "ti,tilcdc,panel";  
3.     status = "okay";  
4.     pinctrl-names = "default";  
5.     pinctrl-0 = <&lcd_pins_s0>;  
6.     panel-info {  
7.         ac-bias           = <255>;  
8.         ac-bias-intrpt    = <0>;  
9.         dma-burst-sz      = <16>;  
10.         bpp               = <32>;  
11.         fdd               = <0x80>;  
12.         sync-edge         = <0>;  
13.         sync-ctrl         = <1>;  
14.         raster-order      = <0>;  
15.         fifo-th           = <0>;  
16.     };  
17.   
18.     display-timings {  
19.         800x480p62 {  
20.             clock-frequency = <30000000>;  
21.             hactive = <800>;  
22.             vactive = <480>;  
23.             hfront-porch = <214>;  
24.             hback-porch = <40>;  
25.             hsync-len = <4>;  
26.             vback-porch = <20>;  
27.             vfront-porch = <23>;  
28.             vsync-len = <4>;  
29.             hsync-active = <0>;  
30.             vsync-active = <0>;  
31.         };  
32.     };  
33. };  

（3）backlight节点分析及配置

从backlight节点中可以获得如下信息：

[cpp]  view plain copy

1. 1. 匹配内核驱动的关键词是"pwm-backlight"。  
2. 2. 使用的ECAP0进行PWM输出。  
3. 3. 有8个亮度等级。  
4. 4. 默认的亮度等级是8，也就是最亮。  

[cpp]  view plain copy

1. Step1. 将backlight节点中&eacp0改为&eacp2。  
2. Step2. 将&epwmss0改为&epwmss2，并将该节点内的ecap0: ecap@48304100改成ecap0:ecap@48304100，然后将该节点中的&ecap0_pins改成&ecap2_pins。  
3. Step3. 将ecap0_pins节点改名为ecap2_pins，然后将pinctrl-single,pins内的内容改为：0x19c MUX_MODE4。  

最后修改后的DTS相关部分如下：

[cpp]  view plain copy

1. backlight {  
2.     compatible = "pwm-backlight";  
3.     pwms = <&ecap2 0 50000 0>;  
4.     brightness-levels = <0 51 53 56 62 75 101 152 255>;  
5.     default-brightness-level = <8>;  
6. };  
7.   
8. &epwmss2 {  
9.     status = "okay";  
10.   
11.     ecap2: ecap@48304100 {  
12.         status = "okay";  
13.         pinctrl-names = "default";  
14.         pinctrl-0 = <&ecap2_pins>;  
15.     };  
16. };  
17.   
18. ecap2_pins: backlight_pins {  
19.     pinctrl-single,pins = <  
20.         0x19c MUX_MODE4 /* MCASP0_AHCLKR.eCAP2_in_PWM2_out MODE4 */  
21.     >;  
22. };  

这样就完成了背光功能的DTS配置。

[cpp]  view plain copy

1. make ARCH=arm menuconfig  

Step2. 开启通用pwm-backlight驱动和基于TI LCD控制器的通用panel驱动，配置内容如下：

[cpp]  view plain copy

1. Graphics support  --->  
2.     [*] Pulse-Width Modulation (PWM) Support  --->  
3.         <*>   ECAP PWM support  
4.         <*>   EHRPWM PWM support  
5.     -*- Backlight & LCD device support  --->  
6.         <*>     Generic PWM based Backlight Driver  
7. Graphics support  --->         
8.     Direct Rendering Manager  --->  
9.         <*> Direct Rendering Manager (XFree86 4.1.0 and higher DRI support)  --->  
10.         <*> DRM Support for TI LCDC Display Controller  

（5）编译DTB和内核

[cpp]  view plain copy

1. make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- tq335x.dtb  

执行内核编译指令：

[cpp]  view plain copy

1. make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- -j8  

（6）用新内核启动开发板
将新编译好的tq335x.dtb和zImage拷贝到SD卡的boot目录下，然后用SD启动开发板到u-boot命令行模式，通过u-boot指令启动内核（每次都这样启动会比较麻烦，可以通过设置u-boot的bootcmd环境变量并保存来简化此动作），启动内核的指令与前一篇文章的命令是相同的：

[cpp]  view plain copy

1. load mmc 0 0x88000000 /boot/tq335x.dtb  
2. load mmc 0 0x82000000 /boot/zImage  
3. load mmc 0 0x88080000 /boot/ramdisk.img  
4. bootz 0x82000000 0x88080000 0x88000000  

这时，可以看到开发板正常启动并且能看到熟悉的Linux小企鹅Logo，至此，就完成了am335x的LCD驱动移植，实际上是不需要我们写代码的，但需要了解内核的组织方式和DTS配置的方法。

（7）pinmux配置参数的确定方法

相信有些人看完这几篇文章之后有个疑问，就是配置pinmux的时候offset是如何确定的。配置GPIO管脚复用功能时经常用到pinctrl-single,pins = <offset, function>属性，内核解析该属性后根据offset和function配置对应的寄存器，是GPIO管脚配置为指定的复用功能。

讲offset的确定方法之前需要指出的是，TI的GPIO控制与三星的芯片不同，三星的芯片管脚复用功能是放在GPIO寄存器中的，而TI的芯片则有个专门的控制模块叫Control Module，该模块可以控制所有的GPIO管脚功能复用；另外，与三星芯片的另外一个不同是TI的芯片分为技术参考手册和数据手册，技术参考手册非常详细的讲述同family的芯片功能及使用方法，数据手册则用来讲述同family中不同芯片特有的属性。因此，调试TI芯片时需要结合技术参考手册和数据手册，而配置GPIO则需要阅读技术手册的GPIO、Control Module两章和数据手册中相关的部分。

从am33xx.dtsi中可以看到pinmux的基地址是0x44e10800，我们先来看这个地址是怎么来的。从技术参考手册的内存映射表可以确定该地址位于L4_WKUP段内，如下图：

点击L4_WKUP超链接，可以切换到L4_WKUP的地址映射表，从该表中可以确定，该地址位于Control Module，如下图：

点击Control Module的超链接，可以切换到Control Module的地址映射表，从该表中可以找到0x44e10800地址，实际上就是conf_gpmc_ad0控制寄存器的地址，也就是说，pinmux配置时的offset都基于这个地址的。

（8）效果展示

到这里LCD的移植工作就算完成了，下面是TQ335x驱动LCD后的效果图：

（9）总结

使用DTB方式配置内核驱动一般需要以下几个步骤：

[cpp]  view plain copy

1. Step1. 设置pinmux，配置的GPIO为相应的功能。  
2. Step2. 设置相应的节点，关联对应的驱动。  
3. Step3. 检查内核配置项，确保开启对应的驱动选项。