RK3576修改开机Logo后无法正常显示

Question

在基于RK3576平台修改开机Logo后，常见问题为更换的Logo图像无法正常显示或屏幕花屏、黑屏。该问题通常源于图像格式或分辨率不匹配：Rockchip要求Logo图像为RAW格式（RGB565或ARGB8888），且尺寸需与屏幕物理分辨率一致。若转换工具使用不当或字节对齐错误，会导致加载异常。此外，未正确更新分区表或未重新打包boot.img也会导致资源未被加载。建议检查mkimage工具生成的logo.img是否符合规范，并确认设备树中关于display-logo的节点已启用。

Answer 1

基于RK3576平台修改开机Logo的深度解析与问题排查

1. 问题现象与初步定位

在RK3576平台上，开发者常通过替换开机Logo来实现品牌定制。然而，更换后常出现屏幕黑屏、花屏或Logo无法显示等问题。这类问题多出现在系统启动的早期阶段，即U-Boot或Kernel初始化Display子系统时。

初步排查方向包括：

• 确认图像是否为RAW格式（RGB565或ARGB8888）
• 检查图像分辨率是否与屏幕物理分辨率完全一致
• 验证logo.img是否被正确打包进boot分区

2. 图像格式与编码规范详解

Rockchip平台对开机Logo有严格的格式要求。图像必须转换为原始二进制数据（RAW），不能使用PNG、JPG等封装格式。常见的错误是使用不支持透明通道的工具生成RGB565，或未正确处理字节序。

以下是两种常用格式的技术参数：

格式	位深	字节排列	适用场景
RGB565	16位	R(5)-G(6)-B(5)	无透明需求，节省空间
ARGB8888	32位	A(8)-R(8)-G(8)-B(8)	支持Alpha通道

3. 图像转换流程与常见错误

使用ffmpeg或自定义Python脚本进行转换时，需确保输出为纯RAW数据。例如：

ffmpeg -i logo.png -pix_fmt rgb565 -f rawvideo logo.raw

常见错误包括：

1. 未指定-pix_fmt导致颜色空间错误
2. 图像尺寸裁剪不当，造成内存越界
3. 字节对齐未按32位边界对齐，引发DMA传输异常
4. 未去除文件头信息，导致加载器读取错误

4. logo.img生成与mkimage工具链分析

RK平台通常使用mkimage工具将RAW图像封装为logo.img。该过程需遵循Rockchip定义的镜像结构：

./mkimage -n "rockchip-logo" -A arm -O linux -T firmware -C none -a 0x0 -e 0x0 -d logo.raw logo.img

若生成的logo.img头部信息缺失或校验失败，U-Boot将拒绝加载。

5. 分区表与boot.img集成机制

logo.img需写入特定分区（如misc或logo），或集成至boot.img中的ramdisk。若未更新partition_cfg.xml或未重新打包boot.img，新Logo将不会生效。

典型集成步骤：

1. 解包boot.img：使用unpack_bootimg
2. 替换ramdisk中logo文件
3. 重新打包并烧录

6. 设备树配置关键节点分析

设备树中必须启用display-logo相关节点，否则即使图像正确也不会触发显示。示例片段如下：

&display_subsystem {
    logo: logo {
        compatible = "rockchip,display-logo";
        status = "okay";
        logo-format = "rgb565";
        logo-width = <1920>;
        logo-height = <1080>;
    };
};

7. 调试手段与日志分析流程

通过串口日志可观察U-Boot阶段是否成功加载Logo：

[   0.123] Logo: loading from partition 'logo'
[   0.125] Logo: format RGB565, size 1920x1080
[   0.127] Logo: DMA copy to framebuffer @0xAAAAAA

若无此类输出，说明资源未被识别或分区未找到。

8. Mermaid流程图：Logo加载全流程诊断

graph TD
            A[开始] --> B{图像尺寸匹配?}
            B -- 否 --> C[调整分辨率]
            B -- 是 --> D{格式为RGB565/ARGB8888?}
            D -- 否 --> E[使用ffmpeg转换]
            D -- 是 --> F[生成logo.img]
            F --> G{mkimage成功?}
            G -- 否 --> H[检查参数]
            G -- 是 --> I[集成至boot.img]
            I --> J{设备树启用display-logo?}
            J -- 否 --> K[修改dts并重编]
            J -- 是 --> L[烧录测试]
            L --> M{显示正常?}
            M -- 是 --> N[完成]
            M -- 否 --> O[抓取串口日志]
            O --> P[分析DMA/Framebuffer错误]

9. 高级问题：Framebuffer冲突与时序竞争

在某些情况下，Kernel提前初始化Display驱动，导致U-Boot写入的Logo被覆盖。可通过延迟Kernel Display模块加载或使用fb_skip_init=1参数规避。

此外，双屏配置下需确认logo写入的是主屏Framebuffer地址。

10. 自动化验证脚本建议

为提升开发效率，可编写Shell脚本自动验证Logo合规性：

#!/bin/bash
file="logo.raw"
width=1920
height=1080
size=$((width * height * 2)) # RGB565

if [ ! -f "$file" ]; then
    echo "Error: logo.raw not found"
    exit 1
fi

actual_size=$(stat -c%s "$file")
if [ $actual_size -ne $size ]; then
    echo "Error: Size mismatch. Expected $size, got $actual_size"
    exit 1
fi
echo "Logo validation passed."