全志T113 RGB屏幕驱动调试：从设备树到uboot的完整适配指南

1. 全志T113 RGB屏幕驱动适配概述

第一次接触全志T113平台时，我被它的性价比和丰富的外设接口所吸引。但在实际开发中，RGB屏幕的驱动适配却让我踩了不少坑。记得当时为了调试一个5寸800x480的屏幕，整整花了两天时间才搞定时序问题。本文将分享我从设备树配置到uboot调试的完整经验，帮助开发者少走弯路。

全志T113的显示子系统支持多种接口，其中RGB并行接口是最常用的LCD连接方式。与MIPI接口相比，RGB接口的硬件设计更简单，但时序配置要求更精确。在Tina Linux系统中，完整的显示驱动流程涉及三个关键环节：设备树参数配置、uboot显示初始化和内核驱动加载。

屏幕驱动异常时通常表现为几种典型现象：完全无显示、花屏、闪烁或者图像偏移。这些问题90%以上都与时序参数配置不当有关。我曾遇到一个案例，屏幕右侧总有约20像素的偏移，最后发现是HBP参数理解错误导致的。通过本文的详细解析，你将掌握快速定位这类问题的方法。

2. 设备树配置详解

2.1 关键参数解析

设备树是驱动配置的核心，全志T113的LCD配置集中在board.dts文件的lcd0节点。下面是一个典型的800x480屏幕配置示例：

&lcd0 { lcd_used = <1>; // 启用LCD控制器 lcd_driver_name = "default_lcd"; lcd_backlight = <50>; // 初始背光亮度 lcd_if = <0>; // 0表示RGB接口 /* 屏幕物理参数 */ lcd_x = <800>; // 水平分辨率 lcd_y = <480>; // 垂直分辨率 lcd_width = <108>; // 屏幕物理宽度(mm) lcd_height = <65>; // 屏幕物理高度(mm) /* 时序参数 */ lcd_dclk_freq = <33>; // 像素时钟(MHz) lcd_hbp = <88>; // 水平后沿 lcd_ht = <928>; // 水平总周期 lcd_hspw = <48>; // 水平同步脉宽 lcd_vbp = <32>; // 垂直后沿 lcd_vt = <525>; // 垂直总周期 lcd_vspw = <1>; // 垂直同步脉宽 /* 其他配置 */ lcd_pwm_used = <1>; // 启用PWM背光 lcd_pwm_ch = <7>; // PWM通道号 pinctrl-0 = <&rgb18_pins_a>; // RGB引脚配置 };

时序参数的计算需要参考屏幕规格书。以常见的800x480屏幕为例：

• HT = HBP + HFP + HSPW + 水平分辨率
• VT = VBP + VFP + VSPW + 垂直分辨率

全志平台的参数定义有个特殊之处：HBP和VBP实际包含了同步脉宽。也就是说：

• 配置中的lcd_hbp = 规格书的HBP + HSPW
• 配置中的lcd_vbp = 规格书的VBP + VSPW

2.2 常见问题排查

当屏幕出现显示异常时，可以按以下步骤排查：

1. 无背光：

   • 检查PWM配置是否正确，测量PWM引脚是否有输出
   • 确认背光电源使能信号是否正常

2. 花屏或条纹：

   • 检查数据线连接是否牢固
   • 确认数据位宽配置（18/24位）
   • 调整lcd_io_phase参数（0x0000~0xffff）

3. 图像偏移：

   • 重新计算HT/VT参数
   • 检查HBP/HSPW是否与规格书一致

4. 闪烁：

   • 降低像素时钟频率
   • 检查电源稳定性

我曾遇到一个典型案例：屏幕右侧有固定宽度的花屏。最终发现是lcd_ht参数比实际值小了16个时钟周期。通过逻辑分析仪抓取时序后，将928调整为944问题解决。

3. U-Boot适配关键步骤

3.1 禁用默认显示驱动

全志T113的U-Boot默认会初始化显示控制器，这可能与某些屏幕的时序冲突。建议先禁用默认配置：

# 修改U-Boot配置文件 vim lichee/brandy-2.0/u-boot-2018/configs/sun8iw20p1_defconfig # 注释掉以下配置 # CONFIG_DISP2_SUNXI=y

3.2 同步设备树配置

U-Boot使用独立的设备树文件(uboot-board.dts)，需要保持与内核设备树一致：

# 复制内核设备树的lcd0节点到 vim device/config/chips/t113/configs/mq_r/uboot-board.dts

特别注意：全志平台的U-Boot不会自动加载LCD参数，需要在代码中手动初始化。可以参考以下补丁：

// 在board_init_f()中添加显示初始化 int sunxi_lcd_init(void) { sunxi_display_init(); return 0; }

3.3 显示测试命令

U-Boot下可以通过以下命令测试显示：

# 显示测试图案 bmp display 0x43000000 # 设置背景色 setenv lcd_bgr 0x00ff00

4. 内核级调试技巧

4.1 调试信息获取

通过sysfs可以获取详细的显示参数：

# 查看当前显示模式 cat /sys/class/disp/disp/attr/sys # 获取屏幕参数 cat /sys/class/disp/disp/attr/lcd

4.2 动态参数调整

调试时可以实时修改参数而不必重新编译：

# 调整背光亮度 echo 80 > /sys/class/backlight/backlight/brightness # 测试颜色条 echo 1 > /sys/class/disp/disp/attr/colorbar

4.3 常见问题解决方案

案例1：屏幕边缘闪烁修改lcd_io_phase参数，通常设置为0x0000或0x0300可以解决：

lcd_io_phase = <0x0300>;

案例2：颜色异常检查数据线位序，在pinctrl配置中调整：

pinctrl-0 = <&rgb18_pins_a>; // 18位RGB pinctrl-1 = <&rgb24_pins_a>; // 24位RGB

案例3：启动时花屏在内核驱动中添加延迟初始化：

// 在disp_lcd.c中添加 msleep(100); // 等待电源稳定

5. 实战案例：5寸800x480屏幕适配

以一款常见的5寸RGB屏幕为例，完整适配流程如下：

1. 获取规格书：

   • 像素时钟：33.3MHz
   • 分辨率：800x480
   • 时序参数：
     • HBP=40, HFP=40, HSPW=48
     • VBP=32, VFP=13, VSPW=3

2. 计算设备树参数：

   lcd_ht = 800 + 40 + 40 + 48 = 928; lcd_hbp = 40 + 48 = 88; lcd_vt = 480 + 32 + 13 + 3 = 528; lcd_vbp = 32 + 3 = 35;

3. 完整配置：

   &lcd0 { lcd_used = <1>; lcd_x = <800>; lcd_y = <480>; lcd_dclk_freq = <33>; lcd_hbp = <88>; lcd_ht = <928>; lcd_hspw = <48>; lcd_vbp = <35>; lcd_vt = <528>; lcd_vspw = <3>; lcd_pwm_used = <1>; lcd_pwm_ch = <7>; pinctrl-0 = <&rgb24_pins_a>; };

4. 验证步骤：

   # 测试颜色显示 echo 8 > /sys/class/disp/disp/attr/colorbar # 测试随机图案 cat /dev/urandom > /dev/fb0

6. 高级调试技巧

6.1 使用逻辑分析仪

当时序问题难以定位时，可以用逻辑分析仪抓取实际信号：

1. 连接CLK、HSYNC、VSYNC和数据线
2. 测量关键时序参数是否与配置一致
3. 特别注意HSYNC和VSYNC的极性

6.2 内核日志分析

启用调试日志可以获取更多信息：

# 启用调试输出 echo 7 > /proc/sys/kernel/printk # 查看内核日志 dmesg | grep disp

6.3 性能优化

对于高分辨率屏幕，可能需要优化性能：

lcd_frm = <1>; // 启用时间抖动算法 deu_mode = <1>; // 启用显示增强单元

7. 从实践中总结的经验

在完成多个T113项目后，我总结出几个关键点：首先，一定要仔细阅读屏幕规格书，特别是时序参数部分。曾经因为忽略了一个脚注说明，导致花费半天时间调试一个简单的时序问题。其次，保持uboot和内核设备树的同步非常重要，这是最容易出错的地方。

对于复杂的显示问题，建议采用分步调试法：先确保uboot能正常显示LOGO，再调试内核驱动。同时合理使用示波器和逻辑分析仪，可以事半功倍。最后，记得在项目完成后详细记录所有参数和修改，这对后续维护和其他项目参考都非常有价值。