This topic explains how to customize the logo images shown during the different graphical boot stages in Digi Embedded Yocto.

Depending on the configuration, you can have the following boot logos:

  • U-Boot splash logo: shows during the boot loader process (if supported for your platform and display configured in the U-Boot device tree).

  • Kernel logo: shows during the kernel load process.

  • Psplash logo: shows when the rootfs is mounted (disabled by default on DEY images).

  • Weston background: background image used on Weston desktop.

U-Boot logo shows during the boot loader process. It requires to have enabled video support and a display defined in U-Boot.

To configure the U-Boot logo set variable UBOOT_LOGO_BMP to point to a BMP file:

conf/local.conf
UBOOT_LOGO_BMP = "/path/to/mylogo.bmp"
U-Boot expects a BMP image with a supported color depth. A 24-bpp BMP is the safest option.

The Linux kernel logo requires a portable pixmap image (PPM). To create a PPM image out of a standard image format, install the netpbm package on your host computer, for instance:

$ sudo apt install netpbm

This package provides different applications (pngtopnm, jpegtopnm, bmptopnm…​) to convert standard image formats to PPM. For instance, to convert a PNG logo:

$ pngtopnm mylogo.png | ppmquant 224 | pnmnoraw > mylogo.ppm

To configure the kernel logo set variable KERNEL_LOGO_PPM to point to the PPM file:

conf/local.conf
KERNEL_LOGO_PPM = "/path/to/mylogo.ppm"

To configure the psplash logo set variable SPLASH_LOGO_PNG to point to a PNG file:

conf/local.conf
SPLASH_LOGO_PNG = "/path/to/mylogo.png"

psplash is disabled by default on DEY images. To enable it, add the following line to your project configuration:

conf/local.conf
IMAGE_FEATURES:append = " splash"
Note the required white space when appending a value to an array variable using the :append override syntax.

Customize Weston background

To configure the Weston background set variable WESTON_BACKGROUND_PNG to point to a PNG file:

conf/local.conf
WESTON_BACKGROUND_PNG = "/path/to/mybackground.png"

Rebuild and deploy your project

After changing any of these logo files, rebuild your project, for instance:

$ bitbake dey-image-qt

Then deploy the updated artifacts to the target. See Deploy for reference.