blob: 3cb5b5aeb484c18b9f7c6f0173fab4c7e2fb9ec1 [file] [log] [blame]
Robert Winkler59b15922013-06-17 11:31:30 -07001---------------------------------------------------------------------
2Splash Screen
3---------------------------------------------------------------------
4The splash_screen_prepare() function is a weak function defined in
5common/splash.c. It is called as part of the splash screen display
6sequence. It gives the board an opportunity to prepare the splash
7image data before it is processed and sent to the frame buffer by
tomas.melin@vaisala.comdb1b79b2017-01-13 13:20:14 +02008U-Boot. Define your own version to use this feature.
Nikita Kiryanovf82eb2f2015-01-14 10:42:54 +02009
10CONFIG_SPLASH_SOURCE
11
12Use the splash_source.c library. This library provides facilities to declare
13board specific splash image locations, routines for loading splash image from
14supported locations, and a way of controlling the selected splash location
15using the "splashsource" environment variable.
16
17splashsource works as follows:
18- If splashsource is set to a supported location name as defined by board code,
19 use that splash location.
20- If splashsource is undefined, use the first splash location as default.
21- If splashsource is set to an unsupported value, do not load a splash screen.
Nikita Kiryanov870dd302015-10-29 11:54:41 +020022
tomas.melin@vaisala.comdb1b79b2017-01-13 13:20:14 +020023A splash source location can describe either storage with raw data, a storage
24formatted with a file system or a FIT image. In case of a filesystem, the splash
25screen data is loaded as a file. The name of the splash screen file can be
26controlled with the environment variable "splashfile".
27
28To enable loading the splash image from a FIT image, CONFIG_FIT must be
Leo Ruan3d92f312019-02-08 10:51:35 +010029enabled. The FIT image has to start at the 'offset' field address in the
30selected splash location. The name of splash image within the FIT shall be
31specified by the environment variable "splashfile".
32
33In case the environment variable "splashfile" is not defined the default name
34'splash.bmp' will be used.