Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools


Sidebar

products:sbc:common:configurations:change-boot-logo

Change Boot Logo

Introduction

This document mainly introduces how to Change Boot Logo. The document is divided into two parts, the first part is for the Ubuntu platform, and the second part is for the Android platform.

Linux

Our official Ubuntu image will display 3 logos during system boot:

  • U-Boot logo
  • Kernel logo
  • Ubuntu logo

The U-Boot logo is located at /usr/share/fenix/logo/logo.bmp. The image format is BMP with a resolution of 500x500px, and bit-depth of 24 bits.

You can use Terminal to check the default logo image format:

$ file /usr/share/fenix/logo/logo.bmp
/usr/share/fenix/logo/logo.bmp: PC bitmap, Windows 3.x format, 500 x 500 x 24, image size 750002, resolution 2834 x 2834 px/m, cbSize 750056, bits offset 54

You can replace the default logo with your own BMP image.

Use the netpbm tool to convert png images to ppm images.

$ pngtopnm linux_logo.png > linux_logo.pnm
$ pnmquant 224 linux_logo.pnm > linux_logo_clut224.pnm
$ pnmtoplainpnm linux_logo_clut224.pnm > logo_linux_clut224.ppm

Put the converted ppm file into the drivers/video/logo/ directory of the kernel, and replace the logo_linux_clut224.ppm file.

Re-compile the kernel, and the logo will be replaced with a new picture.

The Ubuntu logo file is located at /usr/share/fenix/logo/logo.png, replace the .png file to change the Ubuntu boot logo.

If you’ve built the image with Fenix, replace the file archives/logo/png/logo.png to change the logo.

Android

  • Where is original logo file

Logo file is stored in the device/khadas/TARGET/logo_img_files/bootup.bmp directory in android code.

  • BMP format, should be:
    • 16bit RGB565 BMP format
  • Resolution ⇐ 1080P (1920 * 1080)
  • How To Change

Replace the bootup.bmp ,then rebuild the logo.img

Build Logo on Android

1) Update a new logo picture as you want:

$ cp ~/Pictures/khadas.bmp device/khadas/kvim3/logo_img_files/bootup.bmp

2) Build the logo:

$ cd PATH_YOUR_PROJECT
$ source build/envsetup.sh
$ lunch TARGET_LUNCH
$ make logoimg

See this build log for reference:

$ make logoimg
 
...
 
generate out/target/product/kvim3/upgrade/logo.img
gzip -c device/khadas/kvim3/logo_img_files/bootup.bmp > out/target/product/kvim3/upgrade/logo/bootup.bmp
dbg:item num 8
dbg:pack item [bootup]
dbg:pack item [upgrade_upgrading]
dbg:pack item [upgrade_fail]
dbg:pack item [upgrade_unfocus]
dbg:pack item [upgrade_error]
dbg:pack item [upgrade_success]
dbg:pack item [upgrade_logo]
dbg:pack item [upgrade_bar]
Installed out/target/product/kvim3/upgrade/logo.img
 
#### make completed successfully (01:54 (mm:ss)) ####

Burn the logo.img Separately

1) Copy the new logo.img to a thumbdrive (U-disk):

$ cp images/logo.img /media/jason/9B98-6C15/

2) Insert the thumbdrive into your VIM3, then boot into U-Boot mode.

3) Update logo partition as new logo.img:

kvim3# usb_update logo logo.img

4) Refresh to see the new logo:

kvim3# run init_display

Updage the logo by upgrate whole firmware

1) replace device/khadas/TARGET/logo_img_files/bootup.bmp bmp file

2) build upgrate package

$ cd PATH_YOUR_PROJECT
$ source build/envsetup.sh
$ lunch TARGET_LUNCH
$ make installclean -j8
$ make otapackage -j8

3) Burn upgrate package update.img to your device you can refer How To Upgrate ,restart then you can see the new boot logo

  • Replace PATH_YOUR_PROJECT to your project path
  • Replace TARGET_LUNCH to your lunch select.
  • For VIM3, it’s kvim3-userdebug.
  • For VIM3L, it’s kvim3l-userdebug.
  • TARGET should be kvim3 or kvim3l
Last modified: 2023/03/23 04:35 by xiong