RK3588 Android 12开机动画显示不全问题解决方案

1. 问题现象与背景分析

最近在RK3588平台上调试Android 12系统时，遇到了一个颇为棘手的问题：当设备屏幕设置为横向显示（landscape）模式后，开机动画只显示了一半画面。这个现象在开发过程中相当常见，特别是在需要定制显示方向的嵌入式设备上。

RK3588作为瑞芯微新一代旗舰SoC，广泛应用于智能终端、边缘计算设备等领域。其显示子系统支持多种显示接口（HDMI、eDP、MIPI等）和灵活的显示方向配置。Android 12系统在此基础上引入了更严格的显示管理机制，导致一些传统配置方式不再适用。

2. 显示方向配置原理

2.1 Android显示方向管理机制

Android系统通过SurfaceFlinger服务管理显示方向，主要涉及以下几个关键参数：

1. SF_PRIMARY_DISPLAY_ORIENTATION：这个系统属性决定了主显示器的初始方向
2. ro.surface_flinger.primary_display_orientation：在设备树中配置的显示方向
3. frameworks/base/services/surfaceflinger/DisplayDevice.cpp：处理显示方向的核心代码

在Android 12中，显示方向的处理流程发生了变化。系统现在会先读取硬件配置，再应用软件旋转，最后合成输出。这种改变导致开机动画等早期显示内容的方向处理需要特别注意。

2.2 RK3588显示子系统特点

RK3588的显示控制器具有以下特性：

• 支持硬件旋转（通过DPU模块）
• 最大支持8K分辨率输出
• 支持多显示通道独立配置
• 内置色彩空间转换和缩放功能

这些特性使得显示方向的配置更加灵活，但也增加了调试复杂度。特别是在开机阶段，当显示驱动尚未完全初始化时，容易出现显示异常。

3. 问题排查与解决方案

3.1 初步排查步骤

当遇到开机动画显示不全问题时，建议按以下步骤排查：

1. 检查当前显示方向配置：

   bash复制adb shell getprop | grep orientation
   

2. 查看SurfaceFlinger日志：

   bash复制adb logcat | grep SurfaceFlinger
   

3. 检查bootanimation服务状态：

   bash复制adb shell ps -A | grep bootanimation
   

3.2 关键配置修改

经过排查，发现问题出在显示方向配置的冲突上。以下是具体解决方案：

1. 修改设备树配置：
   在rk3588的设备树文件中（通常位于kernel/arch/arm64/boot/dts/rockchip/目录下），找到显示相关配置，确保方向参数一致：

   dts复制&display_subsystem {
       status = "okay";
       ports = <&vop_out>;
       logo-memory-region = <&drm_logo>;
       route {
           route_edp: route-edp {
               status = "okay";
               connect = <&vop_out_edp>;
           };
       };
   };
   
   &edp {
       status = "okay";
       force-hpd;
       pinctrl-names = "default";
       pinctrl-0 = <&edp_hpd>;
       hpd-gpios = <&gpio0 RK_PC2 GPIO_ACTIVE_HIGH>;
   };
   

2. 调整SurfaceFlinger配置：
   在device/rockchip/rk3588/init.rk3588.rc文件中添加：

   rc复制setprop SF_PRIMARY_DISPLAY_ORIENTATION 0
   

3. 修改bootanimation：
   对于Android 12，需要修改frameworks/base/cmds/bootanimation/BootAnimation.cpp：

   cpp复制// 在prepareSurfaces()函数中添加
   uint32_t transform = 0; // 0表示不旋转
   surface->setTransform(transform);
   

3.3 编译与验证

完成上述修改后，需要重新编译系统：

1. 编译bootimage：

   bash复制make bootimage -j8
   

2. 刷写新镜像：

   bash复制fastboot flash boot boot.img
   fastboot reboot
   

验证时特别注意：

• 开机动画是否完整显示
• 触摸坐标是否与显示方向匹配
• 系统UI在不同方向下的表现

4. 深入分析与优化建议

4.1 显示方向处理流程

Android 12中完整的显示方向处理流程如下：

1. 硬件初始化阶段：显示控制器读取物理连接方向
2. 系统启动阶段：SurfaceFlinger根据配置应用软件旋转
3. 应用运行时：WindowManager处理应用请求的方向变化

理解这个流程对调试显示问题至关重要。在RK3588上，还需要考虑DPU硬件旋转与软件旋转的叠加效应。

4.2 性能优化建议

1. 优先使用硬件旋转：
   RK3588的DPU支持硬件旋转，性能远优于软件旋转。在设备树中配置：

   dts复制&vop {
       assigned-clocks = <&cru ACLK_VOP>;
       assigned-clock-rates = <800000000>;
       support-multi-area;
       enable-afbc;
   };
   

2. 优化开机动画资源：
   准备不同方向的动画资源，避免运行时旋转：

   code复制/system/media/
   ├── bootanimation-land.zip
   └── bootanimation-port.zip
   

3. 显示时序调整：
   在kernel/drivers/gpu/drm/rockchip/rockchip_drm_vop.c中优化时序参数：

   c复制static const struct vop_ctrl ctrl = {
       .standby = VOP_REG(RK3588_SYS_STANDBY, 0x1, 0),
       .dma_stop = VOP_REG(RK3588_SYS_CTRL, 0x1, 1),
       // 其他参数...
   };
   

5. 常见问题与解决方案

5.1 开机动画完全不显示

可能原因：

• bootanimation服务未启动
• 资源文件路径错误
• 权限问题

解决方案：

1. 检查bootanimation服务：

   bash复制adb shell setprop debug.bootanimation 1
   adb shell start bootanimation
   

2. 验证资源文件：

   bash复制adb shell ls -l /system/media/bootanimation.zip
   

3. 检查SELinux策略：

   bash复制adb shell dmesg | grep avc
   

5.2 显示方向与触摸不匹配

解决方案：

1. 调整触摸屏方向：

   bash复制adb shell setprop persist.input.device.orientation 0
   

2. 修改触摸驱动：
   在触摸驱动中调整坐标转换矩阵：

   c复制static const struct input_absinfo absinfo[] = {
       ABS_X, 0, 1024, 0, 0,
       ABS_Y, 0, 600, 0, 0,
   };
   

5.3 多显示设备方向冲突

对于多显示设备，需要在frameworks/native/services/surfaceflinger/DisplayHardware/ComposerHal.cpp中处理：

cpp复制void setActiveConfigWithConstraints(
        Display display, Config config,
        const VsyncPeriodChangeConstraints& constraints,
        VsyncPeriodChangeTimeline* outTimeline) {
    // 添加方向处理逻辑
}

6. 高级调试技巧

6.1 使用dumpsys工具

获取详细的显示信息：

bash复制adb shell dumpsys SurfaceFlinger

重点关注：

• 当前显示方向
• 各层的transform状态
• VSync配置

6.2 内核调试

启用DRM调试日志：

bash复制adb shell "echo 0xff > /sys/module/drm/parameters/debug"
adb shell dmesg | grep drm

6.3 性能分析

使用systrace分析显示性能：

bash复制python systrace.py gfx view res

特别注意：

• SurfaceFlinger的合成周期
• 硬件vsync事件
• 应用提交帧的时间

7. 系统级优化方案

7.1 显示子系统调优

在device/rockchip/rk3588/BoardConfig.mk中添加：

makefile复制# 启用硬件加速
TARGET_USES_HWC2 := true
# 优化显示内存
NUM_FRAMEBUFFER_SURFACE_BUFFERS := 3

7.2 启动过程优化

修改init.rc缩短启动时间：

rc复制on property:sys.boot_completed=1
    start bootanimation

7.3 电源管理

优化显示电源配置：

dts复制&display_subsystem {
    power-domains = <&power RK3588_PD_VOP>;
    pm_qos = <&qos_vop_m0>, <&qos_vop_m1>;
};

8. 实际案例分享

在某车载设备项目中，我们遇到了类似问题。通过以下步骤解决：

1. 确认物理连接方向：eDP屏幕实际是横向安装
2. 修改设备树方向配置：

   dts复制&edp {
       rockchip,panel-rotation = <90>;
   }
   

3. 调整SurfaceFlinger配置：

   rc复制setprop ro.surface_flinger.primary_display_orientation ORIENTATION_90
   

4. 重新编译验证后，开机动画显示完整

关键教训：

• 物理安装方向必须与软件配置一致
• 避免硬件旋转和软件旋转叠加使用
• 早期启动阶段的显示需要特殊处理