瑞芯微RK平台显示排障全链路指南｜资深工程师排障笔记，干货收藏备用

本文基于触觉智能RK3576开发板Purple Pi OH2演示，为大家整理一套调屏显示排障全链路指南！

开篇

显示问题的本质是"画面从VOP2合成→输出接口→屏/显示器"这条链路在哪一段断了、或时序/信号不对。本文把显示链路讲透：先定位黑屏/无信号，再逐个接口（MIPI DSI、HDMI）排查，最后是花屏/撕裂与信号质量。

排障从"画面到哪一步就没了"入手：应用层能设置吗（modetest）、内核接口起来了没（dmesg）、屏/显示器本身通不通（背光/EDID）。下面六个问题域覆盖显示排障的主要场景。

黑屏/无信号：从哪一段断起

黑屏先分清"是完全没信号，还是有信号没画面"。"没信号"大多在输出接口→屏这一段（接口没使能、屏没上电、线缆/时序）；"有信号但黑"在VOP2→应用这一段（图层/帧缓冲没提交）。

接口在dts里的开关是"黑屏"高发原因：本板MIPI/HDMI就是靠#define HDMI 0/1切换&dsi/&hdmi的status。

MIPI DSI屏点不亮：时序、背光、初始化序列

触觉智能Purple Pi OH2官方适配的MIPI屏（1200x1920）的配置在kernel-6.1/arch/arm64/boot/dts/rockchip/ido-evb7608-v1a-mipi.dtsi，是排查"点不亮"的对照依据。点不亮按"背光→reset→初始化序列→时序→lane"顺序查：

MIPI DSI控制器驱动是drivers/gpu/drm/rockchip/dw-mipi-dsi2-rockchip.c。排查时可先用modetest确认dsi connector是否probe 出来、分辨率是否正确，再回头逐项对dts。

HDMI输出排障：EDID、分辨率与CEC

RK3576 HDMI驱动是drivers/gpu/drm/rockchip/dw_hdmi-rockchip.c。HDMI问题大多围绕EDID（显示器反馈内核支持分辨率）和输出是否协商到：

判断链路最快的方式仍是modetest：能列出HDMI connector和modes，说明接口与EDID基本正常；列不出来，问题在接口/EDID/物理链路。

花屏/撕裂/vsync如何解决

花屏和撕裂的根因不同：

• 花屏

• 撕裂（tearing）

• vsync

先用modetest -s出静态画面排除应用因素；若静态也花，回查时序/带宽/信号；只有动态撕裂，多半是 vsync/页翻转同步问题。

modetest与DRM直接显示

验证显示链路，modetest（libdrm自带）是最快的工具：

modetest -p                    # 列 connector / modes / encodermodetest -c                    # 列出所有 connector 状态modetest -s 32:1920x1080@60    # 在 connector 32 上强制出一帧（验证输出）# 直接显示 API（RK 提供，绕开合成，直接送帧）# kernel-6.1/drivers/gpu/drm/rockchip/rockchip_drm_direct_show.c

RK官方的rockchip_drm_direct_show（alloc buffer → get plane/crtc → commit）用于在带显示的调试里直接送帧，配合官方DRM_Direct_Show文档可作为"绕过应用层"的验证手段。

信号质量：DP 眼图 SI 测试等

画面"时好时坏"、特定速率才花屏，多半是信号完整性问题。这类要靠仪器：示波器/眼图看MIPI/HDMI/DP的信号质量，按官方SI测试指南测量与判据（如DP 的Rockchip_DisplayPort_SI_Test_Guide_CN.pdf）。软件侧能做的：降速率/降分辨率验证、查lane数配置、确认线缆与连接器。

本节涉及示波器/眼图等仪器，需硬件实验室配合；软件侧结论以"降参验证+dts 配置核对"为主。

显示排障按链路走：黑屏先分段定位（应用/接口/屏）→MIPI屏按背光/reset/序列/时序/lane逐项→HDMI看EDID/协商→花屏撕裂分静态动态→modetest/直接显示做快速验证→信号问题上仪器。链路每一段都有dts配置、dmesg、modetest三层证据可查。

官方文档依据：

docs/cn/Common/DISPLAY/DRM/Rockchip_Developer_Guide_DRM_Display_Driver_CN.pdf、DRM_Direct_Show_CN.pdf、HDMI_CN.pdf、HDMI-CEC_CN.pdf、MIPI_DSI2_CN.pdf、eDP_CN.pdf、LVDS_CN.pdf、DP/DisplayPort_CN.pdf、DP/DisplayPort_SI_Test_Guide_CN.pdf、docs/cn/Linux/Graphics/Rockchip_Developer_Guide_Linux_Graphics_CN.pdf

SDK源码依据：

kernel-6.1/drivers/gpu/drm/rockchip/rockchip_drm_vop2.c、rockchip_drm_vop2_reg.c、dw-mipi-dsi2-rockchip.c、dw_hdmi-rockchip.c、rockchip_lvds.c、rockchip_rgb.c、rockchip_drm_direct_show.c、kernel-6.1/arch/arm64/boot/dts/rockchip/ido-evb7608-v1a-mipi.dtsi（1200x1920 屏/背光/初始化序列/时序）、ido-evb7609-v1a-mipi.dts（#define HDMI切换）、kernel-6.1/arch/arm64/configs/rockchip_linux_rk3576_defconfig（CONFIG_DRM_ROCKCHIP=y）

Purple Pi OH2开发板，是触觉智能RK3576核心板SOM7609系列配套的评估开发板，搭载4核A72+4核A53+M0多核异构处理器，主频2.2GHz，集成 6Tops NPU，轻松应对AI推理、边缘计算与轻量级深度学习。配套完善SDK、丰富资料与Demo，有助于项目前期快速开发验证。