RK平台MIPI与eDP点亮及屏参调试问题分析与修复

2026-11-22 1616阅读

MIPI 与 eDP 屏的点亮流程可以拆成四段:设备树把显示控制器、DSI 主机、面板或桥片连接起来;内核按屏参生成显示模式并初始化 PHY;面板收到初始化命令后进入显示状态;最后 VOP 按模式扫描输出。任何一段没有对齐,表现都是背光亮但无画面、偶尔点亮、花屏或进入系统后黑屏。下面按失败位置说明排查方法与修复手段。

一、背景

MIPI DSI 使用差分时钟和数据通道,主机侧需要配置 lane 数、像素格式、视频模式以及 PHY 的时序参数。设备树中的 route 节点决定哪个 VOP 输出到哪个 DSI,endpoint 的 remote-endpoint 必须成对出现。面板节点通常使用 simple-panel-dsi,提供 display-timings、dsi,flags、dsi,lanes 和初始化序列。eDP 则多一层链路训练,主机和接收端需要协商 lane 数、链路速率、电压摆幅和预加重。

同一个 DSI 控制器在不同 SoC 上的能力不同。RK3399 有两路 MIPI TX,但两路共享 PLL,DSI1 不能脱离 DSI0 单独工作;RK3288 的 MIPI TXRX 也是同样的共享结构。设备树只打开 DSI1、关闭 DSI0 时,控制器看起来已经注册,实际时钟和 PHY 没有正确初始化,屏幕无法点亮。

二、问题现象

常见现象是背光已经点亮,屏幕没有图像,串口打印 failed to bind ff960000.dsi (ops dw_mipi_dsi_ops): -517,随后又出现 Host reports that the configured timeout counter for the high-speed transmission has expired。部分项目还会打印 generic write fifo is full 和 failed to write dcs cmd: -110。客户容易把 -517 当成致命错误,实际上它只是 EPROBE_DEFER,表示面板或桥片还没准备好,display-subsystem 稍后会重新绑定。

RK3288 项目把 LVDS 桥片接到 DSI1、MIPI 屏接到 DSI0 时,只打开 DSI1 会出现 PHY is not locked、写命令超时,屏幕始终不亮。把两路都打开、按参考配置同时输出后,链路才建立。

eDP 项目在 3840x2160 下显示正常,但移动鼠标、弹出对话框或打开录音应用时闪屏,降低像素时钟后帧率掉到 30fps 以下。另有 480x640、两 lane 的 MIPI 屏配置后只能显示一部分画面,修改缩放参数后显示完整,但每隔几秒黑一下。还有项目在系统启动阶段点亮正常,进入桌面一段时间后白屏,测量发现面板 VCC 或 HPD 被其他电源域拉低。

需要读取屏幕寄存器时,单字节读取正常,连续读取两个以上字节就返回 -110 并黑屏。横屏产品修改 ro.sf.hwrotation 或直接改属性都不生效,或者旋转后画面不能满屏。

三、根因分析

第一,-517 不是根因。DSI 主机在绑定时通过 drm_of_find_panel_or_bridge 查找 panel 或下一个 bridge,找不到就返回 -EPROBE_DEFER,display-subsystem 会延迟重试。真正导致黑屏的,往往是屏参错误、初始化序列不匹配、复位和延时不够,或者桥片供电没有起来。判断方法是看最终是否 bound 成功,再用 /sys/kernel/debug/dri/0/summary 确认 connector、mode 和 plane 是否处于 ACTIVE。

kernel-5.10/drivers/gpu/drm/bridge/synopsys/dw-mipi-dsi.c
dw_mipi_dsi_bind()

ret = drm_of_find_panel_or_bridge(host->dev->of_node, 1, -1,
 &dsi->panel, &dsi->next_bridge);
if (ret) {
 DRM_DEV_ERROR(dsi->dev, "Failed to find panel or bridge: %dn", ret);
 return ret;
}

第二,屏参和上电时序必须逐项对齐。panel-simple 从设备树读取 prepare、enable、disable、unprepare、reset、init 六组延时,初始化序列按 header 中的 delay 逐条等待。复位拉高与第一条 DCS 命令之间的间隔太短,桥片还没退出复位,写 FIFO 就会满;间隔太长,又可能错过面板要求的窗口。示波器要把 reset 与 data0 一起测,确认 data0 的第一个高电平出现在 reset 释放之后。

kernel-5.10/drivers/gpu/drm/panel/panel-simple.c
panel_simple_parse_dt()

of_property_read_u32(np, "prepare-delay-ms", &desc->delay.prepare);
of_property_read_u32(np, "enable-delay-ms", &desc->delay.enable);
of_property_read_u32(np, "disable-delay-ms", &desc->delay.disable);
of_property_read_u32(np, "unprepare-delay-ms", &desc->delay.unprepare);
of_property_read_u32(np, "reset-delay-ms", &desc->delay.reset);
of_property_read_u32(np, "init-delay-ms", &desc->delay.init);

第三,路由必须完整。RK3399 的 DSI 输出需要同时配置 dsi_in_vopb 或 dsi_in_vopl、vopb_out_dsi、route_dsi 三处,DSI1 则对应 dsi1_in_vopb、vopb_out_dsi1、route_dsi1。只改其中一处,VOP 和 DSI 之间的端点没有连上,控制器不会产生有效视频流。

kernel-5.10/arch/arm64/boot/dts/rockchip/rk3399-evb-rev3-android-mipi-edp.dts

&dsi_in_vopb {
 status = "okay";
};

&dsi_in_vopl {
 status = "disabled";
};

&route_dsi {
 status = "okay";
 connect = <&vopb_out_dsi>;
};

第四,视频模式标志决定 DSI 的发送方式。dw-mipi-dsi 根据 mode_flags 选择 burst、non-burst sync pulse 或 non-burst sync event。只写 MIPI_DSI_MODE_VIDEO 时走 sync event,适合要求连续时钟、事件同步的桥片;带 MIPI_DSI_MODE_VIDEO_BURST 时走 burst,适合普通屏。桥片手册要求 non-burst 时误加 BURST,画面会花或直接无输出。

kernel-5.10/drivers/gpu/drm/bridge/synopsys/dw-mipi-dsi.c
dw_mipi_dsi_video_mode_config()

val = ENABLE_LOW_POWER;

if (dsi->mode_flags & MIPI_DSI_MODE_VIDEO_BURST)
 val |= VID_MODE_TYPE_BURST;
else if (dsi->mode_flags & MIPI_DSI_MODE_VIDEO_SYNC_PULSE)
 val |= VID_MODE_TYPE_NON_BURST_SYNC_PULSES;
else
 val |= VID_MODE_TYPE_NON_BURST_SYNC_EVENTS;

dsi_write(dsi, DSI_VID_MODE_CFG, val);

第五,DCS 多字节读取需要先设置最大返回包长度。DSI 的读命令通过反向通道返回数据,主机必须告诉面板本次最多返回多少字节,否则面板只回一个字节,后续读取超时。设置长度后再发 generic read,才能一次读回多个寄存器值。

kernel-5.10/drivers/gpu/drm/drm_mipi_dsi.c
mipi_dsi_set_maximum_return_packet_size()

int mipi_dsi_set_maximum_return_packet_size(struct mipi_dsi_device *dsi,
 u16 value)
{
 u8 tx[2] = { value & 0xff, value >> 8 };
 struct mipi_dsi_msg msg = {
 .channel = dsi->channel,
 .type = MIPI_DSI_SET_MAXIMUM_RETURN_PACKET_SIZE,
 .tx_len = sizeof(tx),
 .tx_buf = tx,
 };
 int ret = mipi_dsi_device_transfer(dsi, &msg);

 return (ret < 0) ? ret : 0;
}

第六,显示不全与 HWC 缩放参数有关。480x640 小屏在 Android 7.1 的 drmhwc 中按 w_scale、h_scale 计算 displayFrame,参数仍按 1080P 配置时,图层会被裁切或偏移,画面只显示一部分,系统周期性检查显示参数时还会黑一下。把 w_scale 改成与当前面板匹配的值后画面完整。

hardware/rockchip/hwcomposer/drmhwc/hwcomposer.cpp
DrmHwcLayer::InitFromHwcLayer()

display_frame = DrmHwcRect(
 hd->w_scale * sf_layer->displayFrame.left, hd->h_scale * sf_layer->displayFrame.top,
 hd->w_scale * sf_layer->displayFrame.right, hd->h_scale * sf_layer->displayFrame.bottom);

第七,横屏方向由产品配置决定。Android 12 的 SurfaceFlinger 在编译期读取 SF_PRIMARY_DISPLAY_ORIENTATION,再通过 device.mk 生成 ro.surface_flinger.primary_display_orientation 属性。只在运行时 setprop 或只改 common 目录,产品目录中的 0 会覆盖设置,表现为怎么改都不生效。

device/rockchip/rk3588/BoardConfig.mk
SF_PRIMARY_DISPLAY_ORIENTATION := 0

device/rockchip/common/device.mk
ifneq ($(filter 90 180 270, $(strip $(SF_PRIMARY_DISPLAY_ORIENTATION))), )
PRODUCT_DEFAULT_PROPERTY_OVERRIDES += 
 ro.surface_flinger.primary_display_orientation=ORIENTATION_$(SF_PRIMARY_DISPLAY_ORIENTATION)
endif

第八,eDP 白屏要先查供电。面板的 VCC、HPD 或背光使能被其他电源域共用,系统进入桌面后其他模块上电把这一路拉低,eDP 链路随之断开。软件日志只能看到 link training 成功后又断开,必须用示波器同时测供电和 HPD。

5ce1a0b6-e249-11f1-944c-92fbcf53809c.jpg

四、修复方案

点不亮时先用 SDK 自带的 EVB 设备树验证硬件,再把自己的屏参一项项移植过去,不要一上来就在完整产品树上改。确认 bound 成功后,用 cat /sys/kernel/debug/dri/0/summary 看 connector 和 mode,用 cat /sys/kernel/debug/clk/clk_summary | grep vop 看 dclk 是否与屏参一致。dclk 为 0 或明显偏离,说明 route 或时钟没有配对。

MIPI 屏按屏厂规格书填写 hactive、hfront-porch、hsync-len、hback-porch、vactive 和前后肩,像素时钟用 (h_total × v_total × 帧率) 复核。初始化序列的延时按规格书设置,reset 与 data0 的先后关系用示波器确认。桥片要求 non-burst 时,dsi,flags 只保留 MIPI_DSI_MODE_VIDEO 和必要的 LPM、EOT 标志,不要带 BURST。

RK3288、RK3399 的 DSI1 必须与 DSI0 配合使用,设备树同时打开两路,不能只保留 DSI1。需要两路同时显示时,按 SDK 提供的 dual-channel 或 dual-dsi 补丁配置,并确认两路 PLL 和 PHY 的初始化顺序。

eDP 4K 闪屏先尝试把 compose_policy 设为 0,排除 HWC 叠加路径;再按屏厂参数优化 porch 和像素时钟,给链路留出余量。白屏项目先解决供电,软件侧不要用反复 link training 掩盖电源跌落。读取多个寄存器时,先调用 mipi_dsi_set_maximum_return_packet_size 设置返回长度,再用 generic read,读完后恢复默认长度,避免影响后续命令。

小屏显示不全时,把 w_scale 改为 1.0 或按实际分辨率与 UI 分辨率比例计算,修改后清 SurfaceFlinger 缓存并重启。横屏产品把 SF_PRIMARY_DISPLAY_ORIENTATION 写到具体产品目录的 BoardConfig.mk,编译后用 get_build_var 和 getprop 双重确认;导航栏不旋转时再配合 wm density 或 config_navBarCanMove 调整。

五、适用范围与升级建议

涉及平台包括 RK3288、RK3399、RK3568、RK3588,系统覆盖 Android 7.1、8.1、11.0、12.0 以及 Linux、Debian,内核覆盖 4.4、4.19、5.10、6.1。DSI 路由和面板延时配置在各版本间基本一致;Android 12 的方向配置改为编译期属性,升级时不能沿用 7.1 的 ro.sf.hwrotation 写法。

升级 SDK 时重点核对三处:设备树的 route 与 endpoint 是否仍成对,panel-simple 的延时属性名是否变化,HWC 的缩放与方向属性是否迁到新路径。eDP 项目还要确认 link training 的电压摆幅策略,部分新 SDK 默认从最低档开始训练,长线或转接板场景需要提高档位。屏参变更后必须重新做亮灭屏、休眠唤醒和高低温测试,单次点亮不能说明链路稳定。