Open main menu

DAVE Developer's Wiki β

DESK-MX6-L/Deployment/Customizing the splash screen

< DESK-MX6-L
Revision as of 12:23, 4 March 2022 by U0007 (talk | contribs)

History
Version Issue Date Notes

1.0.0

Oct 2020 New documentation layout
3.0.0 Feb 2022 DESK 3.0.0 release


Contents

Customizing the splash screenEdit

ResourcesEdit

For further details on splash screen support in U-Boot, please refer to:

InstructionsEdit

The following U-Boot environment variables are required:

  • splashimage: RAM address where the BMP image is loaded. Please note that it must be a 32-bit aligned address with a 0x2 offset (eg: 0x20000002)
  • loadsplash: comand for loading the BMP image from the storage device (e.g flash memory) to RAM. This command is automatically run by U-Boot at startup
  • splashpos: image position (eg: splashpos=m,m, for centering the image)

Please note that loadsplash command will differ depends on used storage device.

Splash image in NOR SPI flashEdit

U-Boot variablesEdit
loadsplash=run spi_loadsplash
spi_loadsplash=sf probe; sf read ${splashimage} 0xA00000 ${splashsize}
splashfile=splash_image.bmp
splashimage=0x20000002
splashpos=m,m
splashsize=0x400000
loadsplashfile=tftpboot ${loadaddr} axel/${splashfile}
spi_updatesplash=sf probe; sf erase 0xA00000 +${filesize}; sf write ${loadaddr} 0xA00000 ${filesize}
CommandsEdit

The following commands are used to store in NOR SPI flash a BMP image loaded via tftp:

run loadsplashfile
run spi_updatesplash

Splash image in NAND flashEdit

U-Boot variablesEdit
mtdparts=mtdparts=gpmi-nand:2M(nand-SPL),6M(nand-uboot),1M(nand-env1),1M(nand-env2),1M(nand-fdt),1M(nand-spare),8M(nand-kernel),4M(nand-splash),-(nand-ubi)
loadsplash=run nand_loadsplash
nand_loadsplash=nand read ${splashimage} nand-splash ${splashsize}
splashfile=splash_image.bmp
splashimage=0x20000002
splashpos=m,m
splashsize=0x400000
loadsplashfile=tftpboot ${loadaddr} axel/${splashfile}
nand_updatesplash=nand erase.part nand-splash; nand write ${loadaddr} nand-splash ${filesize}

Please note that the NAND mtd partition for the splash image (nand-splash) is defined using the mtdparts parameter, and then referenced by the nand {erase,read,write} commands.

CommandsEdit

The following commands are used to store in NAND flash a BMP image loaded via tftp:

run loadsplashfile
run nand_updatesplash

Splash image in SD/eMMCEdit

If an SD card or a eMMC device is used as boot device, the splashscreen image is directly loaded from the storage device.

U-Boot variablesEdit

In this example, the first partition - FAT format - is used directly reading the ${splashimage} BMP file.

loadsplash=run mmc_loadsplash
splashfile=splash_image.bmp
splashimage=0x20000002
mmc_loadsplash=fatload mmc ${mmcdev}:1 ${loadaddr} ${splashfile}; cp.b ${loadaddr} ${splashimage} ${filesize}