1. 项目概述与核心价值给嵌入式设备换上一个专属的开机画面这事儿听起来像是锦上添花但对于产品化开发来说却是塑造品牌形象、提升用户体验非常关键的一步。想象一下用户按下电源键映入眼帘的不再是千篇一律的企鹅或者枯燥的命令行滚动而是你精心设计的Logo和进度条那种专业感和归属感立刻就上来了。这次我拿瑞萨的RZ/G2L系列HD-G2L-IOT开发板开刀目标就是把那个默认的、略显“朴素”的psplash开机画面替换成我们自己的品牌标识。psplash是Yocto项目里一个非常经典的开机动画程序它轻量、高效专门用于在Linux内核启动后、系统服务完全起来之前显示一个图形化的启动界面。它通常包含一个静态的背景图和一个动态的进度条。我们的任务就是深入这个流程从源码开始完成交叉编译最终让开发板在启动时展示我们自定义的图片。整个过程会涉及到开源工具链的使用、交叉编译环境的配置、以及根文件系统的替换算是一次比较完整的嵌入式Linux用户空间开发实战。2. 开发环境搭建与源码获取工欲善其事必先利其器。自定义psplash的第一步就是准备好它的“原料”——源代码并搭建好可以加工这些原料的“车间”。2.1 获取psplash源码psplash的官方源码仓库托管在Yocto Project的Git服务器上。获取它非常简单只需要一条git clone命令。这里有一个细节需要注意虽然我们可以直接克隆主分支但为了更好的兼容性特别是与我们使用的Yocto版本如文中的3.1.14匹配有时需要切换到特定的标签tag或提交commit。不过对于基础的自定义图片功能主分支通常就是可用的。git clone git://git.yoctoproject.org/psplash执行这条命令后当前目录下就会生成一个名为psplash的文件夹里面包含了程序所有的源代码、脚本和资源文件。2.2 理解源码目录结构进入psplash目录我们先花几分钟看看里面的关键文件这对后续操作至关重要psplash.c主程序文件包含了图形绘制、进度更新、事件处理的核心逻辑。psplash.h头文件定义了各种数据结构和函数声明。psplash-write.c一个辅助工具的程序文件用于在系统运行时如从另一个终端向psplash进程发送命令例如更新进度条或显示文本信息。这个工具在我们调试时非常有用。psplash-default.h这是关键文件之一。它默认包含了使用C语言数组定义的、内置的启动图片数据。我们要替换的主要就是这里面的图片数据。make-image-header.sh这是另一个关键脚本。它的作用就是将一张普通的PNG格式图片转换成一个C语言头文件.h文件这个头文件里就以数组的形式存储了图片的每一个像素数据。autogen.sh通常是一个用于生成configure脚本的辅助脚本。如果源码包里没有configure文件我们就需要用它来生成。搞清楚这些文件的作用后面修改的时候就不会迷路了。3. 核心原理图片如何被嵌入程序在开始动手之前我们有必要搞清楚一个核心问题一张普通的图片是怎么变成程序的一部分并在屏幕上显示出来的这涉及到两个关键步骤数据转换和编译链接。3.1 图片数据的转换与嵌入计算机屏幕显示图形本质上是在控制每个像素点的颜色。一张PNG图片是经过压缩的二进制数据程序不能直接理解。make-image-header.sh脚本的工作就是充当一个“翻译官”。读取与解码脚本使用图像处理库如libpng读取你提供的logo.png文件将其解码为原始的像素数据通常每个像素包含R红、G绿、B蓝三个通道的值。数据格式化脚本将这些像素数据按照行优先的顺序排列成一个巨大的、一维的数组。每个数组元素就是一个像素的颜色值。生成C代码脚本创建一个C语言头文件例如logo-img.h在这个文件里它会定义一个静态的、常量类型的数组比如static const char数组的名字是预定义好的如psplash_logo_rgb。刚才整理好的像素数据就被逐字节地写入这个数组的初始化器中。头文件包含最后我们需要让主程序psplash.c知道这个新数组的存在。所以要去修改源码让它#include我们新生成的logo-img.h文件并且通常会注释掉或不再包含原来那个定义默认图片的psplash-default.h。这样在编译程序时编译器就会把logo-img.h里的数组数据直接编译进最终的可执行文件二进制码中。程序运行时直接从自己的内存空间里读取这些数据渲染到帧缓冲Framebuffer设备上图片就显示出来了。注意这种将资源“硬编码”进程序的方式优点是加载速度快、不依赖外部文件系统非常适合在启动初期、文件系统还未挂载时使用。缺点是一旦图片需要更换就必须重新编译整个程序。3.2 交叉编译的必要性我们的开发环境比如一台x86_64架构的Ubuntu PC和运行环境ARM64架构的RZ/G2L开发板是不同的CPU架构。在PC上直接gcc编译出来的程序是只能在PC上运行的机器码放到ARM板子上是无法执行的。因此我们需要交叉编译。交叉编译器的名字通常带有前缀比如aarch64-poky-linux-gcc。这个前缀指明了目标架构aarch64、工具链供应商或系统poky-linux。使用这个编译器我们在x86的PC上编译生成的就是能在ARM64板子上运行的二进制文件。后续的./configure和make步骤都必须在这个交叉编译环境生效的前提下进行。4. 逐步实操定制你的开机画面理论铺垫完毕现在开始动手。请确保你已经在Linux开发主机上并且能够访问到RZ/G2L开发板的根文件系统例如通过NFS挂载或直接修改SD卡镜像。4.1 准备自定义图片首先你需要准备一张想要显示的PNG图片。这里有几个必须严格遵守的要点否则图片可能无法显示或显示异常图片尺寸必须与开发板屏幕的分辨率严格一致。例如如果你的HD-G2L-IOT开发板配套的屏幕是800x480那么你的图片就应该是800像素宽480像素高。使用identify命令来自ImageMagick包可以查看图片尺寸identify logo.png。颜色格式psplash默认期望图片是RGB格式24位色即R、G、B各8位。避免使用带Alpha通道的PNGRGBA除非你确认psplash版本支持并做了相应处理。简单的图标或Logo用RGB格式即可。文件命名为了脚本兼容性建议使用英文、数字、下划线组成的文件名避免空格和中文。这里我们按示例使用logo.png。将准备好的图片复制到psplash源码目录下。4.2 执行图片转换脚本进入psplash源码目录执行转换命令。命令的格式需要特别注意./make-image-header.sh logo.png POKY这个命令有三个参数第一个参数logo.png输入的图片文件名。第二个参数POKY这是一个图片标识符。它会被用来生成头文件中的数组变量名。例如使用POKY生成的数组名可能就是psplash_poky_rgb。这个标识符最好与你的图片内容或品牌相关且需要大写。第三个参数示例中空缺这个参数用于指定输出头文件的路径。示例命令没有写意味着默认输出到当前目录并自动命名为类似logo-img.h的文件具体名字取决于脚本内部逻辑可能是psplash-poky-img.h。为了清晰我建议明确指定输出文件名./make-image-header.sh logo.png MYLOGO ./my-logo-img.h这样就会生成一个名为my-logo-img.h的头文件。执行成功后用ls命令查看应该能看到新生成的.h文件。可以用文本编辑器打开看一眼里面应该有一个巨大的、名为psplash_mylogo_rgb的char数组。4.3 修改源代码以使用新图片现在我们需要告诉psplash程序“别用你自带的那个默认图片了用我这个新的。”备份原始文件这是一个好习惯。先备份psplash.c文件cp psplash.c psplash.c.backup。编辑psplash.c使用vi或你喜欢的文本编辑器打开psplash.c。定位头文件包含位置在文件开头的#include区域找到类似下面这行#include psplash-default.h注释旧引用添加新引用将这行注释掉并在其旁边或下方添加对新生成头文件的引用。同时我们还需要注释掉另一个可能存在的、对默认背景图片的引用如果它单独存在的话。修改后的片段应该类似这样//#include psplash-default.h // 注释掉默认图片头文件 //#include psplash-bg.h // 如果存在也注释掉 #include my-logo-img.h // 添加我们自定义图片的头文件实操心得不同版本的psplash源码头文件引用方式可能有细微差别。有些版本可能将背景和Logo分开定义。最稳妥的方法是在psplash.c里搜索psplash_default_rgb或psplash_logo_rgb这样的变量名找到它们是在哪个头文件里声明的然后去替换对应的#include语句。保存并退出。4.4 生成构建配置脚本如果源码目录下没有configure这个可执行文件我们就需要生成它。通常开源项目使用GNU Autotools工具链autoconf, automake, libtool来生成可移植的构建脚本。创建autogen.sh脚本touch autogen.sh chmod x autogen.sh编辑autogen.sh写入以下内容#!/bin/bash aclocal autoheader automake --add-missing autoconf这个脚本依次调用了几个工具aclocal收集宏定义autoheader生成配置头文件模板automake生成Makefile.in模板autoconf生成configure脚本。运行脚本./autogen.sh执行成功后你应该能看到configure脚本被生成出来。4.5 配置交叉编译环境并编译这是将我们的代码“翻译”成开发板能听懂的语言的关键一步。激活交叉编译环境你需要先获取并运行Yocto SDK的环境设置脚本。这个脚本的路径根据你的Yocto SDK安装位置而定。示例中给出的路径是/opt/poky/3.1.14/environment-setup-aarch64-poky-linux。source /opt/poky/3.1.14/environment-setup-aarch64-poky-linux执行这条命令后当前终端会话的环境变量如CC,CXX,PATH,CFLAGS,LDFLAGS等都会被修改指向交叉编译工具链。你可以用echo $CC命令验证应该输出aarch64-poky-linux-gcc。重要提示这个环境设置是“会话级”的。如果你关闭了这个终端或者新开了一个终端窗口都需要重新执行一次source命令。运行configure脚本告诉构建系统我们使用交叉编译器。./configure --hostaarch64-poky-linux参数--hostaarch64-poky-linux指明了我们编译的目标平台。configure脚本会检查依赖并生成针对目标平台的Makefile。执行编译make如果一切顺利编译过程不会有错误。最终会在当前目录下生成两个可执行文件psplash主程序和psplash-write辅助工具。4.6 部署到开发板编译出的二进制文件需要在开发板的根文件系统中替换原有的文件。确定根文件系统位置你的开发板根文件系统可能位于一个已经挂载在开发主机上的NFS目录。一个SD卡镜像文件你可以通过loop设备挂载它。一张已经插在读卡器里的SD卡其分区被挂载在主机上。 假设你已将其挂载在/mnt/rootfs。备份并替换# 备份原来的文件如果存在 sudo cp /mnt/rootfs/usr/bin/psplash /mnt/rootfs/usr/bin/psplash.backup sudo cp /mnt/rootfs/usr/bin/psplash-write /mnt/rootfs/usr/bin/psplash-write.backup # 复制新编译的文件 sudo cp psplash psplash-write /mnt/rootfs/usr/bin/ # 确保文件权限正确通常可执行文件是755 sudo chmod 755 /mnt/rootfs/usr/bin/psplash /mnt/rootfs/usr/bin/psplash-write同步缓存使用sync命令确保所有数据都写入存储设备避免缓存导致文件未实际更新。sync4.7 重启验证将SD卡插入开发板或者重启NFS启动的开发板。观察启动过程你应该能看到自定义的图片取代了原来的默认开机画面。注意事项psplash的启动是由系统初始化系统如systemd或SysV init调用的通常在/etc/init.d/或/lib/systemd/system/下有对应的服务脚本如psplash.sh或psplash.service。只要我们的可执行文件路径和名称没变服务就会自动调用新的程序。如果开机画面没有变化请检查第4.6步的替换是否成功以及文件权限是否正确。5. 进阶调整与深度定制仅仅替换一张静态图片可能还不够。psplash还支持进度条、颜色、文本显示等元素的定制。这些通常需要通过修改源码中的常量定义来实现。5.1 修改进度条样式进度条的颜色、位置、大小都在psplash.c中通过常量定义。你可以搜索以下关键词进行修改PROGRESS_BAR_HEIGHT进度条高度。PROGRESS_BAR_WIDTH进度条宽度。PROGRESS_BAR_X,PROGRESS_BAR_Y进度条左上角的坐标位置。PROGRESS_BAR_COLOR_R,PROGRESS_BAR_COLOR_G,PROGRESS_BAR_COLOR_B进度条的颜色RGB值0-255范围。例如想把蓝色进度条改成红色可以找到并修改#define PROGRESS_BAR_COLOR_R 255 #define PROGRESS_BAR_COLOR_G 0 #define PROGRESS_BAR_COLOR_B 0修改后需要重新执行make编译并重新部署到开发板。5.2 添加或修改启动文本psplash可以在屏幕特定位置显示启动状态文本比如“Starting system...”。这些字符串定义在psplash.c的psplash_state结构体初始化附近或者以#define的形式存在。例如搜索Starting system字符串你可以将其替换为你想要的文字比如Initializing MyProduct v1.0...。注意修改文本后如果文本长度变化很大可能需要调整文本显示的位置坐标TEXT_X,TEXT_Y等宏定义以避免文本显示到屏幕外或被其他元素遮挡。5.3 使用psplash-write进行运行时调试psplash-write工具非常有用。当psplash作为守护进程运行后你可以在另一个终端通过SSH或串口登录到开发板使用它来动态控制开机画面。更新进度psplash-write PROGRESS 50会将进度条设置为50%。显示消息psplash-write MSG Loading kernel modules...会在屏幕上显示一条消息。退出psplashpsplash-write QUIT会让psplash进程退出通常系统服务会在启动完成后执行这个命令来关闭开机画面。你可以在自己的启动脚本中集成这些命令实现更精细的启动状态提示。6. 常见问题排查与解决实录在实际操作中你可能会遇到一些问题。下面是我在多次实践中总结的一些常见坑点及其解决方案。6.1 图片转换失败或编译报错问题现象执行./make-image-header.sh时报错提示找不到命令或图片格式错误。或者在make时编译报错提示找不到图片数组的定义。排查思路与解决依赖缺失make-image-header.sh脚本依赖imagemagick工具包中的convert和identify命令。确保你的开发主机上已安装sudo apt-get install imagemagick # 对于Ubuntu/Debian图片格式问题确保图片是标准的PNG格式并且不是索引颜色模式Indexed Color。可以使用GIMP或在线转换工具将其转换为“RGB颜色”模式的PNG。头文件引用错误编译报错“undefined reference topsplash_xxx_rgb”。这几乎肯定是psplash.c中没有正确包含你生成的头文件或者头文件中的数组名与代码中引用的名字不匹配。检查打开psplash.c搜索psplash_logo_rgb或psplash_default_rgb看它被声明在哪个头文件里。确保你#include的是正确的、新生成的头文件。核对数组名打开你生成的.h文件如my-logo-img.h查看数组的实际名称如static const char psplash_mylogo_rgb[]。然后去psplash.c里搜索确保所有使用到这个数组的地方名字都一致。有时脚本生成的数组名会包含你传入的标识符如POKY或MYLOGO而源码中可能硬编码了另一个名字如psplash_default_rgb。如果不一致你需要修改源码中的变量名或者修改转换脚本的调用方式以生成正确的名字。6.2 开机画面无变化或显示异常问题现象程序替换成功但重启后开机画面还是老的或者是黑屏、花屏、颜色错乱。排查思路与解决文件未成功替换这是最常见的原因。确保你替换的是开发板实际运行的根文件系统中的文件。如果你有多个SD卡或启动方式务必确认修改的是正确的那一份。替换后务必执行sync命令。图片尺寸不匹配这是导致黑屏或花屏的元凶。必须100%确认你的图片分辨率与开发板FB帧缓冲设备的分辨率完全相同。你可以通过以下命令在开发板上查询cat /sys/class/graphics/fb0/modes # 查看支持的模式 cat /sys/class/graphics/fb0/virtual_size # 查看当前虚拟分辨率然后根据查询到的分辨率如U:800x480p-60来制作图片。颜色深度不匹配开发板的FB可能运行在16位色RGB565或32位色ARGB8888模式下而psplash默认可能处理的是24位色RGB888。如果出现严重的颜色错乱比如一片洋红或绿色可能需要修改psplash.c中的绘图函数使其与FB的颜色格式对齐。这涉及到更深的源码修改通常Yocto的psplash配方会处理好这些适配。对于标准RGB888的图片在常见的32位色FB上通常能正常显示。psplash服务未启动或启动失败检查系统日志。journalctl -u psplash # 如果使用systemd或者查看/var/log/messages、dmesg看是否有psplash启动失败的错误信息。可能是依赖的FB设备节点如/dev/fb0权限问题或者缺少某些动态库。6.3 编译时configure或make报错问题现象运行./configure或make时提示找不到编译器、库或头文件。排查思路与解决交叉编译环境未生效这是首要怀疑对象。确保你已经在当前终端执行了source /path/to/environment-setup-xxx命令。用echo $CC和which aarch64-poky-linux-gcc验证交叉编译器是否已在路径中。依赖库缺失psplash编译可能依赖一些开发库如libpng、zlib。在Yocto SDK环境中这些库通常已经以交叉编译的形式存在但需要确保SDK安装完整。如果报错提示找不到png.h等可能需要检查SDK的sysroot目录下是否有对应的头文件和库。一个变通方法是在configure时通过CFLAGS和LDFLAGS明确指定sysroot路径但环境设置脚本通常已做好这些。使用clean slate如果之前编译失败过残留的中间文件可能导致奇怪问题。尝试make distclean # 或 make clean然后重新执行./configure和make。6.4 进度条不更新或与系统启动不同步问题现象图片显示了但进度条不动或者很快就跑满然后长时间等待才进入系统。排查思路与解决进度更新机制psplash的进度更新不是自动的它通过读取一个FIFO管道默认/tmp/progress_fifo来接收外部命令。系统启动脚本如psplash.sh或psplash-systemd服务会负责在启动的不同阶段向这个管道写入PROGRESS命令。检查启动脚本查看开发板根文件系统中/etc/init.d/psplash或/lib/systemd/system/psplash.service以及相关的psplash.sh脚本。确保这些脚本在适当的时机如启动服务前、后执行了psplash-write “PROGRESS XX”命令。手动测试系统启动后通过串口或SSH登录尝试手动执行psplash-write “PROGRESS 30”看进度条是否会更新。如果会说明psplash本身工作正常问题出在启动脚本的进度控制逻辑上。你需要调整启动脚本中进度更新的时机和数值使其与你的实际启动流程匹配。自定义开机画面是嵌入式产品开发中一个能立刻提升产品质感的环节。从获取源码、理解原理、转换图片、交叉编译到部署调试整个过程串联了嵌入式Linux开发的多个基础技能点。最关键的是图片规格必须严格匹配显示设备以及交叉编译环境的正确设置。当看到自己的Logo随着设备启动而亮起时那种成就感是对这些繁琐步骤的最好回报。如果第一次没有成功请耐心按照排查步骤逐一检查问题往往就出在某个细节上。
嵌入式Linux开机画面定制：基于psplash的交叉编译与部署实战
发布时间：2026/5/20 2:13:24
1. 项目概述与核心价值给嵌入式设备换上一个专属的开机画面这事儿听起来像是锦上添花但对于产品化开发来说却是塑造品牌形象、提升用户体验非常关键的一步。想象一下用户按下电源键映入眼帘的不再是千篇一律的企鹅或者枯燥的命令行滚动而是你精心设计的Logo和进度条那种专业感和归属感立刻就上来了。这次我拿瑞萨的RZ/G2L系列HD-G2L-IOT开发板开刀目标就是把那个默认的、略显“朴素”的psplash开机画面替换成我们自己的品牌标识。psplash是Yocto项目里一个非常经典的开机动画程序它轻量、高效专门用于在Linux内核启动后、系统服务完全起来之前显示一个图形化的启动界面。它通常包含一个静态的背景图和一个动态的进度条。我们的任务就是深入这个流程从源码开始完成交叉编译最终让开发板在启动时展示我们自定义的图片。整个过程会涉及到开源工具链的使用、交叉编译环境的配置、以及根文件系统的替换算是一次比较完整的嵌入式Linux用户空间开发实战。2. 开发环境搭建与源码获取工欲善其事必先利其器。自定义psplash的第一步就是准备好它的“原料”——源代码并搭建好可以加工这些原料的“车间”。2.1 获取psplash源码psplash的官方源码仓库托管在Yocto Project的Git服务器上。获取它非常简单只需要一条git clone命令。这里有一个细节需要注意虽然我们可以直接克隆主分支但为了更好的兼容性特别是与我们使用的Yocto版本如文中的3.1.14匹配有时需要切换到特定的标签tag或提交commit。不过对于基础的自定义图片功能主分支通常就是可用的。git clone git://git.yoctoproject.org/psplash执行这条命令后当前目录下就会生成一个名为psplash的文件夹里面包含了程序所有的源代码、脚本和资源文件。2.2 理解源码目录结构进入psplash目录我们先花几分钟看看里面的关键文件这对后续操作至关重要psplash.c主程序文件包含了图形绘制、进度更新、事件处理的核心逻辑。psplash.h头文件定义了各种数据结构和函数声明。psplash-write.c一个辅助工具的程序文件用于在系统运行时如从另一个终端向psplash进程发送命令例如更新进度条或显示文本信息。这个工具在我们调试时非常有用。psplash-default.h这是关键文件之一。它默认包含了使用C语言数组定义的、内置的启动图片数据。我们要替换的主要就是这里面的图片数据。make-image-header.sh这是另一个关键脚本。它的作用就是将一张普通的PNG格式图片转换成一个C语言头文件.h文件这个头文件里就以数组的形式存储了图片的每一个像素数据。autogen.sh通常是一个用于生成configure脚本的辅助脚本。如果源码包里没有configure文件我们就需要用它来生成。搞清楚这些文件的作用后面修改的时候就不会迷路了。3. 核心原理图片如何被嵌入程序在开始动手之前我们有必要搞清楚一个核心问题一张普通的图片是怎么变成程序的一部分并在屏幕上显示出来的这涉及到两个关键步骤数据转换和编译链接。3.1 图片数据的转换与嵌入计算机屏幕显示图形本质上是在控制每个像素点的颜色。一张PNG图片是经过压缩的二进制数据程序不能直接理解。make-image-header.sh脚本的工作就是充当一个“翻译官”。读取与解码脚本使用图像处理库如libpng读取你提供的logo.png文件将其解码为原始的像素数据通常每个像素包含R红、G绿、B蓝三个通道的值。数据格式化脚本将这些像素数据按照行优先的顺序排列成一个巨大的、一维的数组。每个数组元素就是一个像素的颜色值。生成C代码脚本创建一个C语言头文件例如logo-img.h在这个文件里它会定义一个静态的、常量类型的数组比如static const char数组的名字是预定义好的如psplash_logo_rgb。刚才整理好的像素数据就被逐字节地写入这个数组的初始化器中。头文件包含最后我们需要让主程序psplash.c知道这个新数组的存在。所以要去修改源码让它#include我们新生成的logo-img.h文件并且通常会注释掉或不再包含原来那个定义默认图片的psplash-default.h。这样在编译程序时编译器就会把logo-img.h里的数组数据直接编译进最终的可执行文件二进制码中。程序运行时直接从自己的内存空间里读取这些数据渲染到帧缓冲Framebuffer设备上图片就显示出来了。注意这种将资源“硬编码”进程序的方式优点是加载速度快、不依赖外部文件系统非常适合在启动初期、文件系统还未挂载时使用。缺点是一旦图片需要更换就必须重新编译整个程序。3.2 交叉编译的必要性我们的开发环境比如一台x86_64架构的Ubuntu PC和运行环境ARM64架构的RZ/G2L开发板是不同的CPU架构。在PC上直接gcc编译出来的程序是只能在PC上运行的机器码放到ARM板子上是无法执行的。因此我们需要交叉编译。交叉编译器的名字通常带有前缀比如aarch64-poky-linux-gcc。这个前缀指明了目标架构aarch64、工具链供应商或系统poky-linux。使用这个编译器我们在x86的PC上编译生成的就是能在ARM64板子上运行的二进制文件。后续的./configure和make步骤都必须在这个交叉编译环境生效的前提下进行。4. 逐步实操定制你的开机画面理论铺垫完毕现在开始动手。请确保你已经在Linux开发主机上并且能够访问到RZ/G2L开发板的根文件系统例如通过NFS挂载或直接修改SD卡镜像。4.1 准备自定义图片首先你需要准备一张想要显示的PNG图片。这里有几个必须严格遵守的要点否则图片可能无法显示或显示异常图片尺寸必须与开发板屏幕的分辨率严格一致。例如如果你的HD-G2L-IOT开发板配套的屏幕是800x480那么你的图片就应该是800像素宽480像素高。使用identify命令来自ImageMagick包可以查看图片尺寸identify logo.png。颜色格式psplash默认期望图片是RGB格式24位色即R、G、B各8位。避免使用带Alpha通道的PNGRGBA除非你确认psplash版本支持并做了相应处理。简单的图标或Logo用RGB格式即可。文件命名为了脚本兼容性建议使用英文、数字、下划线组成的文件名避免空格和中文。这里我们按示例使用logo.png。将准备好的图片复制到psplash源码目录下。4.2 执行图片转换脚本进入psplash源码目录执行转换命令。命令的格式需要特别注意./make-image-header.sh logo.png POKY这个命令有三个参数第一个参数logo.png输入的图片文件名。第二个参数POKY这是一个图片标识符。它会被用来生成头文件中的数组变量名。例如使用POKY生成的数组名可能就是psplash_poky_rgb。这个标识符最好与你的图片内容或品牌相关且需要大写。第三个参数示例中空缺这个参数用于指定输出头文件的路径。示例命令没有写意味着默认输出到当前目录并自动命名为类似logo-img.h的文件具体名字取决于脚本内部逻辑可能是psplash-poky-img.h。为了清晰我建议明确指定输出文件名./make-image-header.sh logo.png MYLOGO ./my-logo-img.h这样就会生成一个名为my-logo-img.h的头文件。执行成功后用ls命令查看应该能看到新生成的.h文件。可以用文本编辑器打开看一眼里面应该有一个巨大的、名为psplash_mylogo_rgb的char数组。4.3 修改源代码以使用新图片现在我们需要告诉psplash程序“别用你自带的那个默认图片了用我这个新的。”备份原始文件这是一个好习惯。先备份psplash.c文件cp psplash.c psplash.c.backup。编辑psplash.c使用vi或你喜欢的文本编辑器打开psplash.c。定位头文件包含位置在文件开头的#include区域找到类似下面这行#include psplash-default.h注释旧引用添加新引用将这行注释掉并在其旁边或下方添加对新生成头文件的引用。同时我们还需要注释掉另一个可能存在的、对默认背景图片的引用如果它单独存在的话。修改后的片段应该类似这样//#include psplash-default.h // 注释掉默认图片头文件 //#include psplash-bg.h // 如果存在也注释掉 #include my-logo-img.h // 添加我们自定义图片的头文件实操心得不同版本的psplash源码头文件引用方式可能有细微差别。有些版本可能将背景和Logo分开定义。最稳妥的方法是在psplash.c里搜索psplash_default_rgb或psplash_logo_rgb这样的变量名找到它们是在哪个头文件里声明的然后去替换对应的#include语句。保存并退出。4.4 生成构建配置脚本如果源码目录下没有configure这个可执行文件我们就需要生成它。通常开源项目使用GNU Autotools工具链autoconf, automake, libtool来生成可移植的构建脚本。创建autogen.sh脚本touch autogen.sh chmod x autogen.sh编辑autogen.sh写入以下内容#!/bin/bash aclocal autoheader automake --add-missing autoconf这个脚本依次调用了几个工具aclocal收集宏定义autoheader生成配置头文件模板automake生成Makefile.in模板autoconf生成configure脚本。运行脚本./autogen.sh执行成功后你应该能看到configure脚本被生成出来。4.5 配置交叉编译环境并编译这是将我们的代码“翻译”成开发板能听懂的语言的关键一步。激活交叉编译环境你需要先获取并运行Yocto SDK的环境设置脚本。这个脚本的路径根据你的Yocto SDK安装位置而定。示例中给出的路径是/opt/poky/3.1.14/environment-setup-aarch64-poky-linux。source /opt/poky/3.1.14/environment-setup-aarch64-poky-linux执行这条命令后当前终端会话的环境变量如CC,CXX,PATH,CFLAGS,LDFLAGS等都会被修改指向交叉编译工具链。你可以用echo $CC命令验证应该输出aarch64-poky-linux-gcc。重要提示这个环境设置是“会话级”的。如果你关闭了这个终端或者新开了一个终端窗口都需要重新执行一次source命令。运行configure脚本告诉构建系统我们使用交叉编译器。./configure --hostaarch64-poky-linux参数--hostaarch64-poky-linux指明了我们编译的目标平台。configure脚本会检查依赖并生成针对目标平台的Makefile。执行编译make如果一切顺利编译过程不会有错误。最终会在当前目录下生成两个可执行文件psplash主程序和psplash-write辅助工具。4.6 部署到开发板编译出的二进制文件需要在开发板的根文件系统中替换原有的文件。确定根文件系统位置你的开发板根文件系统可能位于一个已经挂载在开发主机上的NFS目录。一个SD卡镜像文件你可以通过loop设备挂载它。一张已经插在读卡器里的SD卡其分区被挂载在主机上。 假设你已将其挂载在/mnt/rootfs。备份并替换# 备份原来的文件如果存在 sudo cp /mnt/rootfs/usr/bin/psplash /mnt/rootfs/usr/bin/psplash.backup sudo cp /mnt/rootfs/usr/bin/psplash-write /mnt/rootfs/usr/bin/psplash-write.backup # 复制新编译的文件 sudo cp psplash psplash-write /mnt/rootfs/usr/bin/ # 确保文件权限正确通常可执行文件是755 sudo chmod 755 /mnt/rootfs/usr/bin/psplash /mnt/rootfs/usr/bin/psplash-write同步缓存使用sync命令确保所有数据都写入存储设备避免缓存导致文件未实际更新。sync4.7 重启验证将SD卡插入开发板或者重启NFS启动的开发板。观察启动过程你应该能看到自定义的图片取代了原来的默认开机画面。注意事项psplash的启动是由系统初始化系统如systemd或SysV init调用的通常在/etc/init.d/或/lib/systemd/system/下有对应的服务脚本如psplash.sh或psplash.service。只要我们的可执行文件路径和名称没变服务就会自动调用新的程序。如果开机画面没有变化请检查第4.6步的替换是否成功以及文件权限是否正确。5. 进阶调整与深度定制仅仅替换一张静态图片可能还不够。psplash还支持进度条、颜色、文本显示等元素的定制。这些通常需要通过修改源码中的常量定义来实现。5.1 修改进度条样式进度条的颜色、位置、大小都在psplash.c中通过常量定义。你可以搜索以下关键词进行修改PROGRESS_BAR_HEIGHT进度条高度。PROGRESS_BAR_WIDTH进度条宽度。PROGRESS_BAR_X,PROGRESS_BAR_Y进度条左上角的坐标位置。PROGRESS_BAR_COLOR_R,PROGRESS_BAR_COLOR_G,PROGRESS_BAR_COLOR_B进度条的颜色RGB值0-255范围。例如想把蓝色进度条改成红色可以找到并修改#define PROGRESS_BAR_COLOR_R 255 #define PROGRESS_BAR_COLOR_G 0 #define PROGRESS_BAR_COLOR_B 0修改后需要重新执行make编译并重新部署到开发板。5.2 添加或修改启动文本psplash可以在屏幕特定位置显示启动状态文本比如“Starting system...”。这些字符串定义在psplash.c的psplash_state结构体初始化附近或者以#define的形式存在。例如搜索Starting system字符串你可以将其替换为你想要的文字比如Initializing MyProduct v1.0...。注意修改文本后如果文本长度变化很大可能需要调整文本显示的位置坐标TEXT_X,TEXT_Y等宏定义以避免文本显示到屏幕外或被其他元素遮挡。5.3 使用psplash-write进行运行时调试psplash-write工具非常有用。当psplash作为守护进程运行后你可以在另一个终端通过SSH或串口登录到开发板使用它来动态控制开机画面。更新进度psplash-write PROGRESS 50会将进度条设置为50%。显示消息psplash-write MSG Loading kernel modules...会在屏幕上显示一条消息。退出psplashpsplash-write QUIT会让psplash进程退出通常系统服务会在启动完成后执行这个命令来关闭开机画面。你可以在自己的启动脚本中集成这些命令实现更精细的启动状态提示。6. 常见问题排查与解决实录在实际操作中你可能会遇到一些问题。下面是我在多次实践中总结的一些常见坑点及其解决方案。6.1 图片转换失败或编译报错问题现象执行./make-image-header.sh时报错提示找不到命令或图片格式错误。或者在make时编译报错提示找不到图片数组的定义。排查思路与解决依赖缺失make-image-header.sh脚本依赖imagemagick工具包中的convert和identify命令。确保你的开发主机上已安装sudo apt-get install imagemagick # 对于Ubuntu/Debian图片格式问题确保图片是标准的PNG格式并且不是索引颜色模式Indexed Color。可以使用GIMP或在线转换工具将其转换为“RGB颜色”模式的PNG。头文件引用错误编译报错“undefined reference topsplash_xxx_rgb”。这几乎肯定是psplash.c中没有正确包含你生成的头文件或者头文件中的数组名与代码中引用的名字不匹配。检查打开psplash.c搜索psplash_logo_rgb或psplash_default_rgb看它被声明在哪个头文件里。确保你#include的是正确的、新生成的头文件。核对数组名打开你生成的.h文件如my-logo-img.h查看数组的实际名称如static const char psplash_mylogo_rgb[]。然后去psplash.c里搜索确保所有使用到这个数组的地方名字都一致。有时脚本生成的数组名会包含你传入的标识符如POKY或MYLOGO而源码中可能硬编码了另一个名字如psplash_default_rgb。如果不一致你需要修改源码中的变量名或者修改转换脚本的调用方式以生成正确的名字。6.2 开机画面无变化或显示异常问题现象程序替换成功但重启后开机画面还是老的或者是黑屏、花屏、颜色错乱。排查思路与解决文件未成功替换这是最常见的原因。确保你替换的是开发板实际运行的根文件系统中的文件。如果你有多个SD卡或启动方式务必确认修改的是正确的那一份。替换后务必执行sync命令。图片尺寸不匹配这是导致黑屏或花屏的元凶。必须100%确认你的图片分辨率与开发板FB帧缓冲设备的分辨率完全相同。你可以通过以下命令在开发板上查询cat /sys/class/graphics/fb0/modes # 查看支持的模式 cat /sys/class/graphics/fb0/virtual_size # 查看当前虚拟分辨率然后根据查询到的分辨率如U:800x480p-60来制作图片。颜色深度不匹配开发板的FB可能运行在16位色RGB565或32位色ARGB8888模式下而psplash默认可能处理的是24位色RGB888。如果出现严重的颜色错乱比如一片洋红或绿色可能需要修改psplash.c中的绘图函数使其与FB的颜色格式对齐。这涉及到更深的源码修改通常Yocto的psplash配方会处理好这些适配。对于标准RGB888的图片在常见的32位色FB上通常能正常显示。psplash服务未启动或启动失败检查系统日志。journalctl -u psplash # 如果使用systemd或者查看/var/log/messages、dmesg看是否有psplash启动失败的错误信息。可能是依赖的FB设备节点如/dev/fb0权限问题或者缺少某些动态库。6.3 编译时configure或make报错问题现象运行./configure或make时提示找不到编译器、库或头文件。排查思路与解决交叉编译环境未生效这是首要怀疑对象。确保你已经在当前终端执行了source /path/to/environment-setup-xxx命令。用echo $CC和which aarch64-poky-linux-gcc验证交叉编译器是否已在路径中。依赖库缺失psplash编译可能依赖一些开发库如libpng、zlib。在Yocto SDK环境中这些库通常已经以交叉编译的形式存在但需要确保SDK安装完整。如果报错提示找不到png.h等可能需要检查SDK的sysroot目录下是否有对应的头文件和库。一个变通方法是在configure时通过CFLAGS和LDFLAGS明确指定sysroot路径但环境设置脚本通常已做好这些。使用clean slate如果之前编译失败过残留的中间文件可能导致奇怪问题。尝试make distclean # 或 make clean然后重新执行./configure和make。6.4 进度条不更新或与系统启动不同步问题现象图片显示了但进度条不动或者很快就跑满然后长时间等待才进入系统。排查思路与解决进度更新机制psplash的进度更新不是自动的它通过读取一个FIFO管道默认/tmp/progress_fifo来接收外部命令。系统启动脚本如psplash.sh或psplash-systemd服务会负责在启动的不同阶段向这个管道写入PROGRESS命令。检查启动脚本查看开发板根文件系统中/etc/init.d/psplash或/lib/systemd/system/psplash.service以及相关的psplash.sh脚本。确保这些脚本在适当的时机如启动服务前、后执行了psplash-write “PROGRESS XX”命令。手动测试系统启动后通过串口或SSH登录尝试手动执行psplash-write “PROGRESS 30”看进度条是否会更新。如果会说明psplash本身工作正常问题出在启动脚本的进度控制逻辑上。你需要调整启动脚本中进度更新的时机和数值使其与你的实际启动流程匹配。自定义开机画面是嵌入式产品开发中一个能立刻提升产品质感的环节。从获取源码、理解原理、转换图片、交叉编译到部署调试整个过程串联了嵌入式Linux开发的多个基础技能点。最关键的是图片规格必须严格匹配显示设备以及交叉编译环境的正确设置。当看到自己的Logo随着设备启动而亮起时那种成就感是对这些繁琐步骤的最好回报。如果第一次没有成功请耐心按照排查步骤逐一检查问题往往就出在某个细节上。
相关文章
终极WindowResizer使用指南：如何强制调整Windows窗口大小？
终极WindowResizer使用指南：如何强制调整Windows窗口大小？ 【免费下载链接】WindowResizer 一个可以强制调整应用程序窗口大小的工具 项目地址: https://gitcode.com/gh_mirrors/wi/WindowResizer 你是否厌倦了Windows中那些无法拖拽调整大小的固…
为新项目申请API Key并设置访问权限与用量提醒
🚀 告别海外账号与网络限制！稳定直连全球优质大模型，限时半价接入中。 👉 点击领取海量免费额度 为新项目申请API Key并设置访问权限与用量提醒 当你开始一个新的AI应用项目，首要任务之一就是获取一个安全、可控的API…
企业级AI Agent实战：如何解决异常考勤处理滞后与薪资核算难题？
摘要： 在2026年企业数字化转型步入深水区的今天，考勤管理与薪资核算的脱节已成为制约组织效能的隐形枷锁。作为一名在企业架构领域摸爬滚打15年的架构师，我观察到无数企业陷入“异常考勤处理滞后、员工满意度低、薪资核算频错”的恶性循环。传…
超导量子计算中的三量子比特门技术解析
1. 超导量子计算中的三量子比特门技术概述在量子计算领域，实现高保真度的多量子比特门操作一直是核心挑战。超导量子处理器作为当前最有前景的量子计算平台之一，其性能很大程度上取决于量子门操作的精度和效率。固定频率transmon架构因其出色的相干性和简…
USB HID设备中断传输ACK机制与MDK实现
1. USB HID设备中断传输的ACK确认机制解析 在USB HID设备开发过程中，确保数据包被主机正确接收是许多开发者遇到的典型问题。当使用中断传输(Interrupt Transfer)方式发送HID报告时，设备端需要明确知道主机是否成功接收了数据。这是USB协议栈中一个关键但…
终极指南：3秒预览Office文件，无需安装完整Office套件
终极指南：3秒预览Office文件，无需安装完整Office套件 【免费下载链接】QuickLook.Plugin.OfficeViewer Word, Excel, and PowerPoint plugin for QuickLook. 项目地址: https://gitcode.com/gh_mirrors/qu/QuickLook.Plugin.OfficeViewer 还在为查…
大模型|开源大模型和大模型微调
🌞欢迎来到人工智能的世界 🌈博客主页：卿云阁 💌欢迎关注🎉点赞👍收藏⭐️留言📝 📆首发时间：🌹2026年5月19日🌹 ✉️希望可以和大家一起完成进阶…
5分钟掌握碧蓝航线自动化脚本：解放双手的智能游戏助手终极指南
5分钟掌握碧蓝航线自动化脚本：解放双手的智能游戏助手终极指南 【免费下载链接】AzurLaneAutoScript Azur Lane bot (CN/EN/JP/TW) 碧蓝航线脚本 | 无缝委托科研，全自动大世界 项目地址: https://gitcode.com/gh_mirrors/az/AzurLaneAutoScript 你…
从IMX334到HDMI输入：Hi3559AV100 MPP代码中VI参数配置的保姆级调整指南
从IMX334到HDMI输入：Hi3559AV100 MPP代码中VI参数配置实战解析 当我们需要将Hi3559AV100开发板从默认的IMX334 MIPI摄像头切换为HDMI输入时，整个视频输入(VI)通道的参数配置需要彻底重构。这不仅涉及硬件接口的转换，更需要深入理解MPP框架中V…
顶伯在线语音工具背后的技术力量：AI语音合成与深度学习解析
顶伯在线语音工具背后的技术力量在人工智能浪潮中，语音交互正成为人机沟通的核心方式。顶伯作为行业领先的在线语音工具，凭借自主研发的深度学习架构，将文字转化为高度自然的语音，广泛应用于有声阅读、智能客服、教育辅助等领域。…
全志V3s开发板实战：用Buildroot 2020.02.4定制你的第一个最小Linux文件系统
全志V3s开发板实战：用Buildroot 2020.02.4定制最小Linux文件系统 在嵌入式开发领域，构建一个精简高效的Linux文件系统往往是项目成功的关键第一步。全志V3s作为一款高性价比的ARM Cortex-A7芯片，搭配Buildroot这一经典构建工具，能…
百考通：AI赋能期刊论文写作，智能生成优质内容
在学术研究领域，期刊论文的撰写是成果输出的关键环节，却也让众多科研工作者与学生倍感压力：选题迷茫、逻辑梳理困难、格式规范复杂、内容提炼耗时，严重拖慢了学术成果的发表节奏。百考通（https://www.baikaotongai.com…
【实用小程序】超轻量级文件上传下载中心 (File Download Server)
站内源码及jar包下载 一、项目概述 文件下载中心一个基于 Java 内置 HTTP 服务器（com.sun.net.httpserver）构建的轻量级文件管理服务。它零第三方依赖，单 JAR 包即可运行，适合在内网环境或临时场景中快速搭建文件共享站点。 你的团队需要临时共享一批日志文件或交付物，…
py每日spider案例之某website之xin东方选课搜索接口(难度一般 扣取代码即可)
加密位置: 逆向接口参数: 逆向接口: const g = globalThis; g.window = g; g.self = g; g.location = {<
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南 【免费下载链接】markor Text editor - Notes & ToDo (for Android) - Markdown, todo.txt, plaintext, math, .. 项目地址: https://gitcode.com/gh_mirrors/ma/markor 在移动设备上寻找一款…
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案 【免费下载链接】MPC-BE MPC-BE – универсальный проигрыватель аудио и видеофайлов для операционной системы Windows. 项目地址:…
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南 【免费下载链接】STL-Volume-Model-Calculator STL Volume Model Calculator Python 项目地址: https://gitcode.com/gh_mirrors/st/STL-Volume-Model-Calculator 你是否曾经为3D打印项目…
通过Taotoken CLI工具一键配置团队开发环境与模型密钥
通过Taotoken CLI工具一键配置团队开发环境与模型密钥 1. CLI工具安装与基本使用 Taotoken提供的CLI工具可通过npm全局安装或直接使用npx运行。对于需要频繁使用CLI的团队，推荐全局安装： npm install -g taotoken/taotoken对于临时使用或项目级配置&a…