RK3588 HDMI转MIPI时旋转功能失效？

Question

在基于RK3588设计的HDMI转MIPI显示方案中，部分用户反馈屏幕旋转功能失效。典型表现为：通过设备树或系统接口配置屏幕旋转（如90°、180°）后，图像内容未按预期变换方向，甚至出现花屏或黑屏现象。该问题多源于GPU与显示子系统（如RGA、VOP模块）在跨接口转换时对旋转操作的支持不完整，尤其在HDMI输入经由ISP和TCON输出至MIPI显示屏的链路中，硬件图层处理未正确传递旋转标志。此外，内核驱动版本或DTS中未正确配置display-rotate属性，亦会导致旋转指令被忽略。需结合Rockchip官方SDK中的DRM/KMS框架进行调试，确认ROTATE功能是否在mipi_dsi_bridge或panel驱动中被正确解析与实现。

Answer 1

基于RK3588的HDMI转MIPI显示方案中屏幕旋转功能失效问题深度解析

1. 问题背景与现象描述

在基于Rockchip RK3588平台设计的HDMI输入转MIPI输出显示系统中，部分用户反馈通过系统接口或设备树配置屏幕旋转（如90°、180°、270°）后，图像方向未发生预期变化，甚至出现花屏、黑屏等异常现象。该问题并非普遍存在于所有MIPI面板，而是特定于某些硬件链路组合下触发。

典型场景包括：

• HDMI源信号经由ISP模块处理后送至TCON（Timing Controller）
• TCON驱动MIPI DSI接口连接显示屏
• 系统尝试通过DRM/KMS框架调用rotate属性进行UI层级旋转
• 最终显示内容未旋转或呈现撕裂、错位、色彩异常

2. 系统架构与关键组件分析

RK3588作为高性能SoC，其显示子系统采用DRM/KMS（Direct Rendering Manager / Kernel Mode Setting）架构，涉及多个核心模块协同工作：

模块	功能描述	是否参与旋转处理
GPU (Mali-G610)	负责图形渲染与合成	是（支持软件旋转）
RGA (Raster Graphic Accelerator)	2D图像加速器，支持缩放、旋转、格式转换	是（需正确配置）
VOP (Video Output Processor)	视频输出处理器，管理图层合成与输出时序	是（关键路径）
DSI Host + Bridge	MIPIDSI协议控制器及桥接驱动	否（但需传递旋转标志）
Panel Driver	具体MIPI屏厂定制驱动	是（依赖display-rotate）
ISP Pipeline	图像信号处理链路（可选）	可能阻断元数据传递

3. 故障根因分层排查

根据实际调试经验，屏幕旋转失败的根本原因可分为以下四类：

1. DTS配置缺失：设备树中未设置display-rotate = <90>;或相关属性被覆盖
2. DRM KMS流程中断：在mipi_dsi_bridge阶段未将rotation信息传递至下游panel驱动
3. 硬件加速限制：RGA/VOP模块不支持当前分辨率下的旋转操作，或未启用对应能力
4. ISP/TCON链路干扰：中间图像处理单元剥离了framebuffer的transform metadata

4. 调试方法与日志分析

建议使用如下命令组合定位问题源头：

# 查看当前connector支持的变换能力
modetest -c

# 检查plane是否支持rotation
modetest -P

# 设置旋转并观察输出
drmgrm -s <crtc_id> --rotation clockwise

# 内核日志过滤DRM相关消息
dmesg | grep -i "drm\|rotate\|vop\|rga"
    

重点关注日志中是否出现：

• "rotation not supported by plane"
• "failed to set property 'rotation'"
• "mipi_dsi_bridge: ignoring rotation flag"
• "panel does not declare support for display-rotate"

5. 设备树（DTS）修复示例

确保在panel节点正确定义旋转属性：

&mipi_dsi {
    ...
    panel: your-panel@0 {
        compatible = "your,panel";
        reg = <0>;
        
        // 必须显式声明旋转角度
        display-rotate = <90>;  // 可选值：0, 90, 180, 270
        
        // 或者使用transform表示镜像+旋转
        // drm,panel-transform = <1>; // DRM_MODE_REFLECT_X
        
        port {
            panel_in: endpoint {
                remote-endpoint = <&tcon_out_mipi>;
            };
        };
    };
};
    

6. 驱动层实现验证流程图

以下是ROTATE指令在RK3588 DRM框架中的传递路径：

graph TD
    A[User Space: set rotation via DRM_IOCTL_MODE_OBJ_SETPROPERTY] --> B{KMS Core}
    B --> C[VOP Plane: Check if rotation is supported]
    C -->|Supported| D[RGA: Configure hardware rotation]
    C -->|Not Supported| E[Fail with -EINVAL]
    D --> F[mipi_dsi_bridge: Propagate rotation flag?]
    F --> G[Panel Driver: Parse display-rotate from DTS]
    G --> H[TCON: Apply physical rotation?]
    H --> I[MIPI Display: Render rotated image]
    F -->|No propagation| J[Rotation ignored → Black/Scrambled screen]
    

7. 解决方案汇总

针对不同层级的问题，推荐采取以下措施：

问题层级	解决方案	影响范围
DTS配置	添加display-rotate或drm,panel-transform	全局生效
Bridge驱动	修改mipi_dsi_bridge.c传递rotation property	需重新编译内核
RGA/VOP	确认RGA参与合成且启用rotate功能	性能开销增加
ISP链路	关闭ISP passthrough模式或注入metadata	可能降低画质
Panel兼容性	更新panel driver支持rotation callback	厂商依赖
Firmware	升级屏端IC固件以识别host旋转指令	需硬件支持

8. Rockchip SDK适配建议

建议基于Rockchip官方提供的Linux SDK（如v5.10-mid或mainline分支）进行如下定制：

• 启用CONFIG_DRM_ROCKCHIP_DW_HDMI和CONFIG_DRM_ROCKCHIP_RGA
• 检查drivers/gpu/drm/rockchip/rockchip_drm_vop.c中对rotation的支持逻辑
• 在drivers/gpu/drm/bridge/synopsys/dw-mipi-dsi.c中添加rotation透传代码段
• 使用drm_mode_get_property_by_name获取"rotation"属性句柄
• 确保IOMMU/SMMU映射正确，避免DMA buffer访问失败导致黑屏