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

History
Version	Issue Date	Notes
X.Y.Z	Month Year	TBD
[TBD_link X.Y.Z]	Month Year	TBD

Contents

Customizing the splash screenEdit

ResourcesEdit

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

• U-Boot Splash Screen Support
• U-Boot Bitmap Support

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)

Splash image in NOR SPI flashEdit

TBD: replace commands with SOC's one

U-Boot variablesEdit

loadsplash=run spi_loadsplash
spi_loadsplash=sf probe; sf read ${splashimage} 0x800000 ${splashsize}
splashfile=splash_image.bmp
splashimage=0x20000002
splashpos=m,m
splashsize=0x400000
loadsplashfile=tftpboot ${loadaddr} axel/${splashfile}
spi_updatesplash=sf probe; sf erase 0x800000 +${filesize}; sf write ${loadaddr} 0x800000 ${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

TBD: replace commands with SOC's one

U-Boot variablesEdit

mtdparts=mtdparts=gpmi-nand:8M(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
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 eMMCEdit

TBD: replace commands with SOC's one

U-Boot variablesEdit

loadsplash=run mmc_loadsplash
mmc_loadsplash=ext4load mmc ${mmcdev}:1 ${loadaddr} ${splashfile}; cp.b ${loadaddr} ${splashimage} ${filesize}
splashfile=splash_image.bmp
splashimage=0x20000002
splashpos=m,m
splashsize=0x400000

Please note that the eMMC first partition is used for storing the splash image file. The BMP should be present into this partition (formatted as ext2, ext3 or ext4).

---