全志T113平台ST7701S LCD驱动移植实战

1. 项目背景与核心挑战

在嵌入式开发领域，显示驱动的移植工作往往是最考验工程师功底的环节之一。这次我们要在全志T113平台上适配一块400x960分辨率的LCD屏幕，驱动芯片采用的是ST7701S。这个组合在市面上并不常见，标准的BSP包里通常不会直接提供现成配置，需要我们从零开始啃手册、调参数。

这块屏的物理特性很有意思——400x960的分辨率意味着它是竖长条形的，常见于智能家居中控面板、工业HMI等需要纵向显示的场景。ST7701S作为一款经济型驱动IC，其初始化序列的灵活性给移植带来了不小挑战。我在实际调试过程中发现，全志平台的显示子系统对非标准分辨率支持需要特别注意时钟配置和时序参数的计算。

2. 硬件环境准备

2.1 关键硬件参数确认

首先需要明确几个核心硬件参数：

• 屏幕物理尺寸：82.08mm x 196.99mm（典型的3.97英寸竖屏）
• 像素密度：127 PPI
• 接口类型：RGB 24-bit并行接口
• 工作电压：3.3V/1.8V双电压

特别注意ST7701S的供电时序要求：必须先给AVDD（模拟电源）上电，延迟至少10ms后再给VCI（逻辑电源）上电。我在初期调试时曾因电源时序问题导致屏幕出现花屏现象。

2.2 全志T113显示子系统架构

T113的显示控制器（DE）支持多层混合，但我们需要重点关注：

• 时钟树配置：DE时钟来源于PLL_VIDEO0
• 时序生成器：负责产生HSYNC/VSYNC/DE等信号
• 色彩空间转换：RGB888到RGB666的压缩处理

通过示波器实测发现，当输出分辨率非标准时，PLL_VIDEO0的时钟分频系数需要手动计算，不能依赖默认配置。具体计算公式为：

code复制dotclock = (h_total * v_total) * frame_rate
n = PLL_VIDEO0 / dotclock (取最接近整数)

其中h_total = h_active + h_front_porch + h_back_porch + h_sync_width

3. 驱动移植实战

3.1 设备树配置关键点

在Linux内核的设备树文件中，需要特别注意以下参数的配置：

c复制&lcd0 {
    lcd_used            = <1>;
    lcd_driver_name     = "st7701s_rgb";
    lcd_x               = <400>;
    lcd_y               = <960>;
    lcd_width           = <82>;
    lcd_height          = <197>;
    lcd_dclk_freq       = <33>; /* 实际计算值为33.3MHz */
    
    /* 时序参数 - 单位：像素时钟周期 */
    lcd_ht              = <424>;  // h_total
    lcd_hbp             = <20>;   // h_back_porch
    lcd_vt              = <992>;  // v_total * 2 (基于interlace模式)
    lcd_vbp             = <10>;   // v_back_porch
    lcd_hspw            = <4>;    // h_sync_width
    lcd_vspw            = <4>;    // v_sync_width
    
    lcd_lvds_if         = <0>;
    lcd_rb_swap         = <1>;    // RGB顺序交换
    lcd_frm             = <1>;    // RGB666模式
};

特别注意：ST7701S的初始化序列需要通过GPIO模拟SPI发送，在设备树中要正确配置reset和dc引脚：

c复制&pio {
    lcd_rst_pin: lcd_rst_pin {
        pins = "PD10";
        function = "gpio_out";
    };
    
    lcd_dc_pin: lcd_dc_pin {
        pins = "PD22";
        function = "gpio_out";
    };
};

3.2 驱动代码移植要点

ST7701S的驱动主要需要实现以下函数：

c复制static int st7701s_init(struct lcd_panel *panel)
{
    /* 硬件复位序列 */
    gpiod_set_value(panel->reset_gpio, 0);
    msleep(20);
    gpiod_set_value(panel->reset_gpio, 1);
    msleep(120);
    
    /* 发送初始化命令序列 */
    st7701s_send_cmd(0x11); // Sleep Out
    msleep(120);
    
    /* 关键色彩配置 */
    st7701s_send_cmd(0x3A); // Interface Pixel Format
    st7701s_send_data(0x70); // RGB-18bit
    
    /* 设置扫描方向 */
    st7701s_send_cmd(0x36); // MADCTL
    st7701s_send_data(0xC0); // MY=1, MV=1
    
    /* 设置显示区域 */
    st7701s_send_cmd(0x2A); // Column Address Set
    st7701s_send_data(0x00);
    st7701s_send_data(0x00);
    st7701s_send_data(0x01);
    st7701s_send_data(0x8F); // 400-1=0x18F
    
    st7701s_send_cmd(0x2B); // Page Address Set
    st7701s_send_data(0x00);
    st7701s_send_data(0x00);
    st7701s_send_data(0x03);
    st7701s_send_data(0xBF); // 960-1=0x3BF
    
    st7701s_send_cmd(0x29); // Display On
}

调试中发现ST7701S对命令间隔时间非常敏感，建议每个命令后至少延迟1ms，关键命令如Sleep Out需要120ms以上延迟。

4. 常见问题排查指南

4.1 屏幕无显示问题排查流程

1. 电源检查：

   • 测量AVDD是否为3.3V±0.1V
   • 测量VCI是否为1.8V±0.05V
   • 检查背光使能信号是否正常

2. 信号线检查：

   • 用示波器查看HSYNC/VSYNC信号频率是否符合预期
   • 检查RGB数据线在DE有效期间是否有信号变化

3. 初始化序列验证：

   • 通过逻辑分析仪抓取SPI命令序列
   • 确认0x11(Sleep Out)命令已发送且延迟足够

4.2 显示异常问题处理

现象1：颜色失真

• 检查lcd_frm参数（RGB666/RGB888）
• 确认lcd_rb_swap设置是否正确
• 在ST7701S初始化序列中验证0x3A命令参数

现象2：画面偏移

• 重新计算并调整h_back_porch/v_back_porch
• 检查Column/Page Address Set命令参数
• 确认MADCTL(0x36)的扫描方向配置

现象3：屏幕闪烁

• 测量dotclock是否稳定
• 检查PLL_VIDEO0的锁定状态
• 适当增加v_back_porch值

5. 性能优化技巧

5.1 帧率提升方案

通过调整以下参数可将刷新率从默认30fps提升至60fps：

1. 降低垂直空白期：

   c复制lcd_vbp = <8>;  // 原值10
   lcd_vt = <980>; // 原值992
   

2. 优化PLL配置：

   c复制&pll_video0 {
       clock-frequency = <594000000>; // 原值540000000
   };
   

3. 在ST7701S中启用TE（Tearing Effect）信号：

   c复制st7701s_send_cmd(0x35); // TE ON
   st7701s_send_data(0x00);
   

5.2 功耗控制方法

1. 动态调整背光：

   c复制// 通过PWM控制背光电流
   &pwm {
       pinctrl-names = "default";
       pinctrl-0 = <&pwm0_pin>;
       status = "okay";
   };
   
   // 根据环境光传感器调整亮度
   static void update_backlight(int level) {
       pwm_config(pwm_dev, level, 255);
       pwm_enable(pwm_dev);
   }
   

2. 利用ST7701S的省电模式：

   c复制// 进入睡眠模式
   st7701s_send_cmd(0x10); // Sleep In
   
   // 唤醒时需重新初始化
   st7701s_send_cmd(0x11); // Sleep Out
   msleep(120);
   

6. 高级调试手段

6.1 使用示波器诊断时序问题

当遇到显示异常时，建议按以下顺序测量信号：

1. 测量DE信号的有效宽度，应等于400个像素时钟周期
2. 检查HSYNC脉冲间隔，应等于h_total(424)个周期
3. 确认VSYNC脉冲宽度是否为vspw(4)个行周期
4. 观察RGB数据线在DE有效期间的信号质量

实测案例：曾发现数据线出现振铃现象，通过以下措施解决：

• 在PCB上增加33Ω串联电阻
• 将GPIO驱动强度从默认的20mA调整为10mA
• 缩短排线长度至15cm以内

6.2 内核调试技巧

1. 启用帧缓冲调试信息：

   bash复制echo 0x0F > /sys/module/drm/parameters/debug
   

2. 实时查看时钟配置：

   bash复制cat /sys/kernel/debug/clk/clk_summary | grep video
   

3. 检查图层混合状态：

   bash复制cat /sys/kernel/debug/de/disp
   

7. 量产注意事项

7.1 硬件设计要点

1. 电源滤波：

   • AVDD需并联10μF+0.1μF电容
   • VCI需至少1μF去耦电容

2. 信号线处理：

   • RGB数据线长度差控制在±5mm以内
   • HSYNC/VSYDE走线需远离时钟信号

3. ESD防护：

   • 在连接器附近放置TVS二极管阵列
   • 建议使用ESD等级≥8KV的连接器

7.2 软件适配检查清单

• [ ] 确认设备树中lcd_x/lcd_y与实际屏参一致
• [ ] 验证ST7701S初始化序列中的扫描方向参数
• [ ] 检查帧缓冲的像素格式（DRM_FORMAT_RGB666）
• [ ] 测试低温（-20℃）下的启动时序
• [ ] 验证长时间运行（72h）无内存泄漏

在完成所有调试后，建议将配置参数固化到uboot的环境变量中，便于批量生产时烧写：

bash复制setenv bootargs ${bootargs} lcd_x=400 lcd_y=960 lcd_dclk=33
setenv bootargs ${bootargs} lcd_ht=424 lcd_vt=992
saveenv

通过这个项目，我深刻体会到嵌入式显示驱动开发就是"三分编码，七分调试"的工作。特别是在非标准分辨率下，每个时序参数都需要反复验证。建议大家在类似项目中一定要做好以下准备：

1. 备好逻辑分析仪和示波器
2. 保留足够的调试日志接口
3. 建立自动化测试脚本
4. 与屏厂保持密切技术沟通

最后分享一个实用技巧：在调试色彩问题时，可以先用纯色图片（红/绿/蓝）测试，快速定位是数据线序问题还是色彩空间配置问题。这个方法帮我节省了至少50%的调试时间。