2,404 bytes added,
09:42, 22 December 2015 {{InfoBoxTop}}
{{AppliesToAxel}}
{{AppliesToAxelLite}}
{{InfoBoxBottom}}
== Introduction ==
Starting from version 2013.04-xelk-2.2.0, U-Boot for Axel SOMs provides support for a customizable splash screen. The following sections describe how to use this feature.
== Resources ==
For further details on splash screen support in U-Boot, please refer to:
* http://www.denx.de/wiki/DULG/UBootSplashScreen
* http://www.denx.de/wiki/DULG/UbootBitmapSupport.
== Customizing the splash screen ==
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 flash ===
==== U-Boot variables ====
<pre>
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}
</pre>
==== Commands ====
The following commands are used to store in NOR SPI flash a BMP image loaded via tftp:
<pre>
run loadsplashfile
run spi_updatesplash
</pre>
=== Splash image in NAND flash ===
==== U-Boot variables ====
<pre>
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}
</pre>
Please note that the NAND mtd partition for the splash image ('''nand-splash''') is defined using the <code>mtdparts</code> parameter, and then referenced by the nand {erase,read,write} commands.
==== Commands ====
The following commands are used to store in NAND flash a BMP image loaded via tftp:
<pre>
run loadsplashfile
run nand_updatesplash
</pre>