展锐平台MIPI触摸屏驱动调试实战

1. 项目概述

最近在展锐平台上调试一款MIPI接口的触摸屏，从点亮屏幕到触摸功能正常，整个过程遇到了不少坑。作为嵌入式开发的老兵，我决定把这次调试的完整过程记录下来，希望能帮到同样在展锐平台上奋斗的同行们。

这次调试的硬件平台是展锐UMS9620，屏幕型号是ICNL9951R，分辨率为1600x2176，采用MIPI接口。触摸屏是HIMAX的HX83102J方案。整个调试过程分为两大块：LCD屏幕驱动配置和触摸屏驱动配置。

2. LCD屏幕驱动配置

2.1 LK部分修改

LK（Little Kernel）是展锐平台的bootloader阶段，我们需要在这里完成屏幕的初始化和基本显示功能。

2.1.1 驱动文件添加

首先需要在LK中添加屏幕的驱动文件，主要修改以下几个文件：

code复制/platform/sprd_shared/driver/video/sprd/lcd/lcd_icnl9951r_tlcm_hjr127009d_mipi_fhd.c
/platform/sprd_shared/driver/video/sprd/lcd/panel_cfg.h
/platform/sprd_shared/driver/video/sprd/rules.mk
/project/ums9620_1h10.mk

驱动文件中最关键的是三个部分：

1. 屏幕的初始化命令序列（init_data数组）
2. 屏幕的上电时序控制
3. 屏幕参数的配置（分辨率、时序等）

这里特别要注意的是上电时序，不同屏幕的复位时序、电源稳定时间要求可能不同。我们的屏幕需要：

1. 先拉高电源使能引脚
2. 等待20ms
3. 然后操作复位引脚：高->低->高，每次变化间隔5ms
4. 最后再等待20ms

2.1.2 屏幕参数配置

在panel_info结构体中，需要配置以下关键参数：

c复制static struct panel_info icnl9951r_tlcm_hjr127009d_info = {
    .width = 1600,
    .height = 2176,
    .pixel_clk = 246000000, /*Hz*/
    .rgb_timing = {
        .hfp = 60,
        .hbp = 52,
        .hsync = 20,
        .vfp = 116,
        .vbp = 32,
        .vsync = 8,
    },
    .phy_freq = 1476000, // MIPI时钟频率
    .lane_num = 4,       // MIPI通道数
    .dpi_clk_div = 6,    // 六分频
    // 其他参数...
};

这些参数必须与屏幕规格书完全一致，否则会出现显示异常、花屏等问题。

2.2 Kernel部分修改

2.2.1 DTS配置

在kernel中需要为屏幕添加对应的DTS配置，主要参数要与LK中保持一致：

dts复制sprd,dsi-lane-number = <4>;
sprd,phy-bit-clock = <1476000>;    /* kbps */
sprd,dpi-clk-div = <6>;
sprd,slice-width = <800>;
sprd,slice-height = <8>;

DTS中的initial-command需要与LK中的init_data完全一致，这是屏幕的初始化命令序列。

2.2.2 显示时序配置

显示时序配置非常关键，配置错误会导致显示位置偏移、闪烁等问题：

dts复制display-timings {
    native-mode = <&icnl9951r_tlcm_hjr127009d_timing0>;
    icnl9951r_tlcm_hjr127009d_timing0: timing0 {
        clock-frequency = <246000000>;
        hactive = <1600>;
        vactive = <2176>;
        hback-porch = <52>;
        hfront-porch = <60>;
        vback-porch = <32>;
        vfront-porch = <116>;
        hsync-len = <20>;
        vsync-len = <8>;
    };
};

注意事项：

1. 时钟频率计算要准确，必须与像素时钟匹配
2. 前后porch和sync长度必须与屏幕规格书一致
3. 不同分辨率的屏幕这些参数差异很大，不能简单复制

3. 触摸屏驱动配置

3.1 DTS设备树配置

触摸屏的配置主要在设备树中完成，需要添加以下节点：

dts复制touchpanel@0 {
    compatible = "himax,hxcommon";
    reg = <0>;
    spi-max-frequency = <8000000>;
    himax,panel-coords = <0 1600 0 2176>;
    himax,display-coords = <1600 2176>;
    himax,irq-gpio = <&ap_gpio 13 GPIO_ACTIVE_HIGH>;
    himax,rst-gpio = <&ap_gpio 14 GPIO_ACTIVE_HIGH>;
    report_type = <1>;
};

关键点：

1. 配置正确的SPI时钟频率（与触摸IC规格书一致）
2. 坐标范围必须与屏幕分辨率匹配
3. GPIO配置要正确，特别是中断引脚

3.2 驱动集成

将触摸驱动代码集成到内核模块中，主要步骤：

1. 将驱动源码放到bsp/modules/kernel5.15/input/touchscreen/目录
2. 在build.config中添加驱动路径：

   code复制EXT_MODULES+=" ../modules/kernel5.15/touchscreen/himax_hx83102j"
   

3. 配置模块自动加载，修改modules.load文件

3.3 固件配置

触摸IC通常需要固件支持，需要：

1. 将固件文件(.bin)放到device/sprd/vnd_mpool/module/vendor/ts/firmware目录
2. 在md.mk中添加固件拷贝规则：

   makefile复制PRODUCT_COPY_FILES += \
       $(VND_MPOOL)/module/vendor/ts/firmware/HJR_IVO12.7_102J_D00_C07_20251223_014849.bin:$(TARGET_COPY_OUT_ODM)/firmware/Himax_firmware_hjr_1217.bin
   

常见问题：

1. 固件版本不匹配会导致触摸无反应或坐标错误
2. 固件路径配置错误会导致加载失败
3. 不同批次的触摸屏可能需要不同的固件

4. 调试技巧与问题排查

4.1 LCD常见问题

1. 屏幕点不亮

   • 检查电源时序是否正确
   • 用示波器测量MIPI时钟信号
   • 确认初始化命令序列正确

2. 显示花屏

   • 检查分辨率配置是否正确
   • 确认像素格式（RGB顺序）配置正确
   • 检查MIPI时钟频率是否合适

3. 显示位置偏移

   • 调整前后porch参数
   • 检查同步信号极性配置

4.2 触摸常见问题

1. 触摸无反应

   • 检查中断引脚配置和测量
   • 确认SPI通信正常
   • 检查固件是否加载成功

2. 触摸坐标错误

   • 确认panel-coords和display-coords配置正确
   • 检查触摸屏方向配置
   • 可能需要调整固件参数

3. 触摸不灵敏

   • 调整触摸阈值参数
   • 检查电源噪声
   • 可能需要更新固件

4.3 实用调试命令

bash复制# 查看显示相关时钟
cat /d/clk/clk_summary | grep dsi

# 查看显示参数
cat /sys/class/graphics/fb0/modes

# 查看触摸设备信息
getevent -l

# 查看触摸驱动日志
dmesg | grep -i touch

5. 经验总结

1. 文档是关键：屏幕和触摸IC的规格书必须仔细阅读，特别是时序要求和寄存器配置。

2. 分步调试：先确保LCD显示正常，再调试触摸功能。不要同时修改多处配置。

3. 工具准备：

   • 示波器：测量电源时序和信号完整性
   • 逻辑分析仪：抓取SPI/I2C通信
   • 万用表：检查电源电压和GPIO状态

4. 日志分析：展锐平台有丰富的调试日志，善用printk和dmesg。

5. 社区资源：展锐开发者社区和芯片原厂支持是解决问题的宝贵资源。

这次调试中最耗时的部分是屏幕初始化命令的调试，由于规格书提供的命令序列与实际要求有差异，我们通过与原厂工程师反复沟通才最终确定正确的序列。这也提醒我们，当遇到不符合预期的现象时，及时寻求原厂支持可以节省大量时间。

最后，对于展锐平台的显示和触摸调试，耐心和细致的记录是成功的关键。每次修改配置后都要做好记录，这样才能在出现问题时快速回溯和定位。