保姆级教程：手把手教你编译RK3588 Linux内核并替换启动Logo

RK3588 Linux内核编译与启动Logo定制实战指南

从零开始：RK3588开发环境搭建

对于刚接触RK3588平台的开发者来说，定制启动Logo是一个既实用又能快速获得成就感的切入点。但在开始之前，我们需要确保开发环境配置正确。以下是完整的开发环境搭建步骤：

1. SDK获取与验证

   • 从官方渠道下载最新RK3588 Linux SDK
   • 验证SDK完整性：md5sum rk3588_linux_sdk.tar.gz
   • 解压SDK：tar -xzvf rk3588_linux_sdk.tar.gz

2. 交叉编译工具链安装

   sudo apt-get install gcc-aarch64-linux-gnu export CROSS_COMPILE=aarch64-linux-gnu-

3. 依赖库安装

   sudo apt-get install build-essential libncurses5-dev bison flex \ libssl-dev libc6-dev-arm64-cross u-boot-tools

4. 环境变量配置在SDK根目录下执行：

   source build/envsetup.sh lunch rk3588_spl_loader_v1.13.112-userdebug

5. 基础编译测试

   ./build.sh -j$(nproc) kernel

提示：建议使用Ubuntu 20.04 LTS或更新版本作为开发环境，避免因系统版本导致的兼容性问题。

启动Logo制作规范与技巧

RK3588平台支持两个阶段的启动Logo显示：

• U-Boot阶段Logo：文件名为logo.bmp
• 内核阶段Logo：文件名为logo_kernel.bmp

图片规格要求

图片转换最佳实践

1. 使用GIMP转换图片

   sudo apt-get install gimp

   • 打开原始图片
   • 选择"文件"→"导出为"
   • 选择BMP格式，取消"兼容性选项"中的"运行长度编码"

2. 命令行批量转换工具

   sudo apt-get install imagemagick convert input.png -type truecolor -define bmp:format=bmp3 output.bmp

3. 分辨率调整脚本

   #!/bin/bash INPUT=$1 OUTPUT=$2 WIDTH=${3:-1920} HEIGHT=${4:-1080} convert "$INPUT" -resize "${WIDTH}x${HEIGHT}" \ -background black -gravity center -extent "${WIDTH}x${HEIGHT}" \ -type truecolor -define bmp:format=bmp3 "$OUTPUT"

注意：避免使用Windows画图工具保存BMP文件，因其可能添加不必要的文件头信息导致显示异常。

内核配置与编译全流程

1. 内核配置调整

进入内核源码目录进行配置：

cd kernel/ make ARCH=arm64 rockchip_linux_defconfig make ARCH=arm64 menuconfig

关键配置项检查：

• LOGO支持：

  Device Drivers → Graphics support → Bootup logo → [*] Standard 224-color Linux logo [*] Black and white Linux logo (NEW) [*] 16-color Linux logo (NEW)

• 帧缓冲支持：

  Device Drivers → Graphics support → [*] Support for frame buffer devices [*] Rockchip LCD support

2. 替换Logo文件

将制作好的Logo文件复制到内核源码根目录：

cp ~/custom_logo.bmp logo.bmp cp ~/custom_kernel_logo.bmp logo_kernel.bmp

验证文件属性：

file logo.bmp logo_kernel.bmp

预期输出应为：

logo.bmp: PC bitmap, Windows 3.x format, 1920 x 1080 x 24 logo_kernel.bmp: PC bitmap, Windows 3.x format, 1920 x 1080 x 24

3. 编译内核与资源镜像

使用官方提供的编译脚本：

./make.sh

或手动执行完整编译流程：

# 编译内核镜像 make ARCH=arm64 Image -j$(nproc) # 编译设备树 make ARCH=arm64 dtbs -j$(nproc) # 生成resource.img ./scripts/resource_tool logo.bmp logo_kernel.bmp arch/arm64/boot/dts/rockchip/rk3588-evb.dtb # 打包boot.img ../device/rockchip/common/scripts/mk-fitimage.sh boot.img boot.its arch/arm64/boot/Image

编译产出物说明：

烧录与验证

1. 烧录工具准备

推荐使用RK官方工具进行烧录：

1. 下载RKDevTool：wget https://.../RKDevTool_Release_v2.9.zip
2. 解压并安装依赖：

   unzip RKDevTool_Release_v2.9.zip sudo apt-get install libusb-1.0-0-dev

2. 烧录步骤详解

1. 开发板进入Loader模式：

   • 断开电源
   • 按住Recovery键
   • 连接USB到PC
   • 松开Recovery键

2. 使用RKDevTool烧录：

   • 选择"Loader"设备
   • 加载parameter.txt和boot.img
   • 点击"执行"开始烧录

3. 烧录进度监控：

   Downloading boot.img 100% [================================>] 12.4MB/s Download completed, waiting for reset

3. 启动问题排查

常见问题及解决方案：

调试技巧：

# 查看内核启动日志 dmesg | grep -i logo # 检查帧缓冲设备 ls /dev/fb* cat /proc/fb

高级技巧与优化建议

1. 动态Logo切换方案

通过修改设备树实现多Logo切换：

/ { logo: logo { compatible = "rockchip,logo"; status = "okay"; logo-normal = <&logo_normal>; logo-boot = <&logo_boot>; logo_normal: logo-normal { filename = "logo.bmp"; }; logo_boot: logo-boot { filename = "logo_kernel.bmp"; }; }; };

2. 启动动画实现

利用内核帧缓冲实现简单动画：

static int __init logo_animation_init(void) { struct fb_info *info; int i; info = registered_fb[0]; for (i = 0; i < 255; i++) { memset_io(info->screen_base, i, info->fix.smem_len); msleep(10); } return 0; } module_init(logo_animation_init);

3. 性能优化参数

在parameter.txt中添加Logo相关优化参数：

logo.nologo=0 logo.rotation=0 logo.mode=center logo.bpp=24

常见问题深度解析

1. 图片格式验证工具

开发一个简单的BMP验证脚本：

#!/usr/bin/env python3 import struct import sys def check_bmp(filename): try: with open(filename, 'rb') as f: # Check BMP header if f.read(2) != b'BM': return False # Check bit depth (offset 0x1C) f.seek(0x1C) bpp = struct.unpack('<H', f.read(2))[0] if bpp != 24: return False return True except: return False if __name__ == '__main__': if len(sys.argv) != 2: print(f"Usage: {sys.argv[0]} <bmp_file>") sys.exit(1) print("Valid BMP" if check_bmp(sys.argv[1]) else "Invalid BMP")

2. 多屏幕适配方案

对于多显示设备场景，可修改显示驱动：

static int rk_show_logo(struct fb_info *info) { struct fb_image image; if (info->node > 0) // 只在主屏幕显示Logo return 0; /* 常规Logo显示代码 */ }

3. 低内存设备优化

对于内存受限设备，可压缩Logo资源：

# 使用lz4压缩Logo lz4 -9 logo.bmp logo.bmp.lz4 # 在内核中解压 static int __init decompress_logo(void) { int ret; ret = lz4_decompress(logo_data, logo_size, ...); /* ... */ }

工程实践：自动化构建脚本

完整的Logo替换自动化脚本示例：

#!/bin/bash # auto_logo.sh - Automated logo replacement script for RK3588 KERNEL_DIR=$(pwd) LOGO_SRC=$1 KERNEL_LOGO_SRC=$2 # Validate inputs [ $# -ne 2 ] && { echo "Usage: $0 <uboot_logo> <kernel_logo>"; exit 1; } [ ! -f "$LOGO_SRC" ] && { echo "Error: $LOGO_SRC not found"; exit 1; } [ ! -f "$KERNEL_LOGO_SRC" ] && { echo "Error: $KERNEL_LOGO_SRC not found"; exit 1; } # Convert and verify logos convert_logo() { local src=$1 dst=$2 convert "$src" -type truecolor -define bmp:format=bmp3 "$dst" || { echo "Conversion failed for $src"; exit 1; } } echo "Converting logos..." convert_logo "$LOGO_SRC" "${KERNEL_DIR}/logo.bmp" convert_logo "$KERNEL_LOGO_SRC" "${KERNEL_DIR}/logo_kernel.bmp" # Build kernel echo "Building kernel..." cd "$KERNEL_DIR" || exit 1 make ARCH=arm64 rockchip_linux_defconfig make ARCH=arm64 Image dtbs -j$(nproc) # Package resource image echo "Packaging resource.img..." ./scripts/resource_tool logo.bmp logo_kernel.bmp arch/arm64/boot/dts/rockchip/rk3588-evb.dtb # Generate boot image echo "Generating boot.img..." ../device/rockchip/common/scripts/mk-fitimage.sh boot.img boot.its arch/arm64/boot/Image echo "Build complete! Output files:" ls -lh arch/arm64/boot/Image boot.img resource.img

性能调优与监控

1. Logo加载时间优化

测量并优化Logo加载时间：

# 在内核命令行添加启动参数 console=ttyFIQ0 initcall_debug loglevel=8 # 查看启动日志 dmesg | grep -i "logo\|fb\|display"

关键优化参数：

# 缩短U-Boot Logo显示时间 setenv logo_delay 1 saveenv # 内核配置优化 CONFIG_LOGO=y CONFIG_LOGO_LINUX_CLUT224=y CONFIG_FRAMEBUFFER_CONSOLE=y

2. 内存占用分析

使用fbdev工具分析帧缓冲内存：

# 安装分析工具 sudo apt-get install fbset fbcat # 获取当前帧缓冲信息 fbset -i # 捕获屏幕内容 fbcat > screenshot.ppm

安全注意事项

1. 图片来源安全

   • 只使用可信来源的图片
   • 对图片进行病毒扫描
   • 避免使用可执行代码的复杂图片格式

2. 固件签名验证

   # 检查镜像签名 ./tools/fit_check_sign -f boot.img -k rk3588.pubkey

3. 安全启动配置

   CONFIG_RK_SECURE_BOOT=y CONFIG_RK_AVB_LIBAVB=y CONFIG_RK_CRYPTO=y

扩展应用：个性化定制方案

1. 根据设备状态显示不同Logo

修改显示逻辑代码：

static int show_dynamic_logo(struct fb_info *info) { if (is_battery_low()) return show_logo(info, "logo_lowbat.bmp"); else if (is_safe_mode()) return show_logo(info, "logo_safe.bmp"); else return show_logo(info, "logo_normal.bmp"); }

2. 节日主题自动切换

创建定时任务脚本：

#!/bin/bash # holiday_logo.sh TODAY=$(date +%m%d) LOGO_DIR="/etc/logo_themes" case $TODAY in 0101) cp $LOGO_DIR/newyear.bmp /logo.bmp ;; 020*) cp $LOGO_DIR/spring.bmp /logo.bmp ;; 1001) cp $LOGO_DIR/national.bmp /logo.bmp ;; *) cp $LOGO_DIR/default.bmp /logo.bmp ;; esac # 重新加载Logo echo 1 > /sys/class/graphics/fb0/logo_redraw

版本管理与回滚策略

1. 使用Git管理Logo变更

# 创建Logo专用分支 git checkout -b feature/custom-logo # 添加Logo文件 git add logo.bmp logo_kernel.bmp # 提交变更 git commit -m "Add custom logos for RK3588" # 创建标签 git tag -a v1.0-logo -m "Initial logo version"

2. 固件回滚机制

创建回滚脚本：

#!/bin/bash # rollback_logo.sh BACKUP_DIR="/logo_backup" CURRENT_LOGO="/logo.bmp" # 检查备份是否存在 [ ! -f "$BACKUP_DIR/logo.bmp" ] && { echo "Backup not found"; exit 1; } # 恢复备份 cp "$BACKUP_DIR/logo.bmp" "$CURRENT_LOGO" # 重启显示服务 systemctl restart display-manager

终极调试技巧

1. 使用QEMU调试Logo显示

qemu-system-aarch64 -M virt -cpu cortex-a72 \ -nographic -smp 4 -m 4096 \ -kernel arch/arm64/boot/Image \ -append "console=ttyAMA0 root=/dev/ram" \ -initrd rootfs.cpio.gz \ -drive file=boot.img,format=raw,if=none,id=hd0 \ -device virtio-blk-device,drive=hd0

2. 内核调试打印添加

// 在drivers/video/fbdev/core/fbmem.c中添加调试信息 static int fb_show_logo(struct fb_info *info) { printk(KERN_DEBUG "Displaying logo on fb%d\n", info->node); /* 原有代码 */ }

硬件加速显示优化

利用RK3588的RGA加速器优化Logo显示：

static int rga_show_logo(struct fb_info *info, const struct fb_image *image) { struct rga_req req; memset(&req, 0, sizeof(req)); req.src.act_w = image->width; req.src.act_h = image->height; req.src.vir_w = image->width; req.src.vir_h = image->height; req.src.yrgb_addr = virt_to_phys(image->data); req.dst.act_w = info->var.xres; req.dst.act_h = info->var.yres; req.dst.vir_w = info->var.xres_virtual; req.dst.vir_h = info->var.yres_virtual; req.dst.yrgb_addr = info->fix.smem_start; req.render_mode = update_palette ? RGA_BLIT_MODE : RGA_COPY_MODE; return rga_blit_sync(&req); }