summaryrefslogtreecommitdiff
path: root/doc/README.splashprepare
blob: 56c1bef66216310667b2110103224fe5dc5fd6bd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
---------------------------------------------------------------------
Splash Screen
---------------------------------------------------------------------
The splash_screen_prepare() function is a weak function defined in
common/splash.c. It is called as part of the splash screen display
sequence. It gives the board an opportunity to prepare the splash
image data before it is processed and sent to the frame buffer by
U-Boot.  Define your own version to use this feature.

CONFIG_SPLASH_SOURCE

Use the splash_source.c library. This library provides facilities to declare
board specific splash image locations, routines for loading splash image from
supported locations, and a way of controlling the selected splash location
using the "splashsource" environment variable.

splashsource works as follows:
- If splashsource is set to a supported location name as defined by board code,
  use that splash location.
- If splashsource is undefined, use the first splash location as default.
- If splashsource is set to an unsupported value, do not load a splash screen.

A splash source location can describe either storage with raw data, or storage
formatted with a file system. In case of a filesystem, the splash screen data is
loaded as a file. The name of the splash screen file can be controlled with the
environment variable "splashfile".