Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools


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

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
products:sbc:common:configurations:change-boot-logo [2023/03/23 04:35]
xiong
products:sbc:common:configurations:change-boot-logo [2026/02/02 05:04] (current)
gray update by using AI
Line 3: Line 3:
 ===== Introduction ===== ===== Introduction =====
  
-This document mainly introduces how to Change Boot LogoThe document is divided into two partsthe first part is for the Ubuntu platform, and the second part is for the Android platform.+This document explains how to change the boot logoIt is divided into two partsthe first part covers the Ubuntu platform, and the second part covers the Android platform.
  
 ===== Linux ===== ===== Linux =====
  
 <WRAP info > <WRAP info >
-Our official Ubuntu image will display 3 logos during system boot:+The official Khadas Ubuntu image displays three logos during system boot:
   * U-Boot logo   * U-Boot logo
-  * Kernel logo +  * Linux kernel logo 
-  * Ubuntu logo+  * Plymouth (Ubuntu) boot splash logo
 </WRAP> </WRAP>
  
Line 17: Line 17:
  
 The U-Boot logo is located at ''/usr/share/fenix/logo/logo.bmp''. 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:+The required image format is BMP with a resolution of ''500x500px'' and a color depth of ''24 bits''
 + 
 +You can use the terminal to check the format of the default logo image:
  
 ```shell ```shell
 $ file /usr/share/fenix/logo/logo.bmp $ file /usr/share/fenix/logo/logo.bmp
 +```
 +Example output:
 +```
 /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 /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.+To change it, simply replace the default ''logo.bmp'' file with your own BMP image that meets the format requirements.
  
 ==== Linux Kernel Logo ==== ==== Linux Kernel Logo ====
  
-Use the netpbm tool to convert png images to ppm images.+Use the netpbm tool to convert a PNG image to the required PPM format.
  
 ```shell ```shell
Line 37: Line 41:
 $ pnmtoplainpnm linux_logo_clut224.pnm > logo_linux_clut224.ppm $ 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.+Place the generated ''logo_linux_clut224.ppm'' file into the ''drivers/video/logo/'' directory of your Linux kernel source codereplacing the existing file.
  
-Re-compile the kernel, and the logo will be replaced with a new picture.+Recompile the kernel. After flashing the new kernel, the boot logo will be updated.
  
-==== Ubuntu Logo ====+==== Plymouth (Ubuntu Boot Splash) Logo ====
  
-The Ubuntu logo file is located at ''/usr/share/fenix/logo/logo.png'', replace the .png file to change the Ubuntu boot logo.+The Plymouth logo file is located at ''/usr/share/fenix/logo/logo.png''. Replace this ''.png'' file to change the graphical boot splash screen.
  
-If you’ve [[/products/sbc/vim3/development/linux/build-ubuntu| built the image with Fenix]], replace the file ''archives/logo/png/logo.png'' to change the logo.+If you are [[/products/sbc/vim3/development/linux/build-ubuntu| building a custom image with Fenix]], you can change the logo by replacing the file at ''archives/logo/png/logo.png'' before the build.
  
  
 ===== Android ===== ===== Android =====
  
-<WRAP info > +Starting from Android 10, Rockchip merged the logo partition into the super partition, making it impossible to modify the boot logo dynamically without rebuilding the entire firmwareTo address this, a new custom partition has been added to allow for dynamic logo updates. 
-  *Where is original logo file + 
-Logo file is stored in the device/khadas/TARGET/logo_img_files/bootup.bmp directory in android code.+==== Logo Format Requirements====
  
-  *BMP format, should be+<WRAP info > 
-    *16bit RGB565 BMP format +  **Source Location:** The original logo file in the Android source code is located at ''kernel-6.1/logo.bmp''.  
-  *Resolution <= 1080P (1920 * 1080) +  * **Required Format:**  
-  *How To Change+    * 16-bit RGB565 BMP format 
 +    * Resolution should be ≤ 1080P (1920x1080 pixels).
  
-Replace the bootup.bmp ,then rebuild the logo.img 
 </WRAP> </WRAP>
  
-==== Build Logo on Android ==== 
  
-1) Update a new logo picture as you want:+==== Update Logo via ADB ====
  
-```shell +You can push a prepared ''logo.bmp'' file to the device using ADB.
-$ cp ~/Pictures/khadas.bmp device/khadas/kvim3/logo_img_files/bootup.bmp +
-``` +
- +
-2) Build the logo:+
  
 ```shell ```shell
-cd PATH_YOUR_PROJECT +adb root 
-source build/envsetup.sh +adb remount 
-lunch TARGET_LUNCH +adb push logo.bmp /vendor/custom/ 
-make logoimg+adb reboot
 ``` ```
  
-See this build log for reference: +Example command output:
 ```shell ```shell
-make logoimg+adb root 
 +restarting adbd as root
  
-...+$ adb remount 
 +AVB verification is disabled, disabling verity state may have no effect 
 +Remounted /system as RW 
 +Remounted /vendor as RW 
 +Remounted /odm as RW 
 +Remounted /system_dlkm as RW 
 +Remounted /system_ext as RW 
 +Remounted /vendor_dlkm as RW 
 +Remounted /odm_dlkm as RW 
 +Remounted /product as RW 
 +Remount succeeded
  
-generate out/target/product/kvim3/upgrade/logo.img +$ adb push logo.bmp /vendor/custom 
-gzip -c device/khadas/kvim3/logo_img_files/bootup.bmp > out/target/product/kvim3/upgrade/logo/bootup.bmp +logo.bmp: 1 file pushed, 0 skipped. 655.0 MB/s (4147272 bytes in 0.006s)
-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)) ####+$ adb reboot
 ``` ```
 +After the device reboots, the new logo should be displayed.
  
-==== Burn the logo.img Separately ====+==== Update Logo by Rebuilding Firmware ====
  
-1) Copy the new logo.img to thumbdrive (U-disk): +This method involves modifying the Android source code and building complete update package.
-```shell +
-$ cp images/logo.img /media/jason/9B98-6C15/ +
-``` +
-2) Insert the thumbdrive into your VIM3, then boot into U-Boot mode.+
  
-3Update logo partition as new logo.img: +1Replace the logo sourceReplace the ''logo.bmp'' file in the ''kernel-6.1/'' directory of your Android source code.
-```shell +
-kvim3# usb_update logo logo.img +
-``` +
-4) Refresh to see the new logo: +
-```shell +
-kvim3# run init_display +
-```+
  
- +2) build the update package:
-==== Updage the logo by upgrate whole firmware ==== +
- +
-1) replace device/khadas/TARGET/logo_img_files/bootup.bmp bmp file +
- +
-2) build upgrate package+
  
 ```shell ```shell
 $ cd PATH_YOUR_PROJECT $ cd PATH_YOUR_PROJECT
-$ source build/envsetup.sh +$ source build/envsetup.sh && lunch kedge2-userdebug 
-lunch TARGET_LUNCH +./build.sh -UCKAu
-$ make installclean -j8 +
-make otapackage -j8+
 ``` ```
 +This will generate an ''update.img'' file.
  
-3) Burn upgrate package update.img to your device you can refer How To Upgrate ,restart then you can see the new boot logo+3) Flash the firmware: Burn the generated ''update.img'' to your device using the standard upgrade method (refer to the "How To Upgrade" guide). After the device restarts, the new boot logo will be active.
  
-<WRAP info > 
-  *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 
-</WRAP> 
Last modified: 2023/03/23 04:35 by xiong