diff options
Diffstat (limited to 'documentation/ref-manual/variables.rst')
-rw-r--r-- | documentation/ref-manual/variables.rst | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 6680322f4c..6a7888ab47 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst | |||
@@ -7826,6 +7826,38 @@ system and gives an overview of their function and contents. | |||
7826 | for such applications to use. This variable is set by default to | 7826 | for such applications to use. This variable is set by default to |
7827 | ``psplash``. | 7827 | ``psplash``. |
7828 | 7828 | ||
7829 | :term:`SPLASH_IMAGES` | ||
7830 | This variable, used by the ``psplash`` recipe, allows to customize | ||
7831 | the default splashscreen image. | ||
7832 | |||
7833 | Specified images in PNG format are converted to ``.h`` files by the recipe, | ||
7834 | and are included in the ``psplash`` binary, so you won't find them in | ||
7835 | the root filesystem. | ||
7836 | |||
7837 | To make such a change, it is recommended to customize the | ||
7838 | ``psplash`` recipe in a custom layer. Here is an example structure for | ||
7839 | an ``ACME`` board:: | ||
7840 | |||
7841 | meta-acme/recipes-core/psplash | ||
7842 | ├── files | ||
7843 | │ └── logo-acme.png | ||
7844 | └── psplash_%.bbappend | ||
7845 | |||
7846 | And here are the contents of the ``psplash_%.bbappend`` file in | ||
7847 | this example:: | ||
7848 | |||
7849 | SPLASH_IMAGES = "file://logo-acme.png;outsuffix=default" | ||
7850 | FILESEXTRAPATHS:prepend := "${THISDIR}/files:" | ||
7851 | |||
7852 | You could even add specific configuration options for ``psplash``, | ||
7853 | for example:: | ||
7854 | |||
7855 | EXTRA_OECONF += "--disable-startup-msg --enable-img-fullscreen" | ||
7856 | |||
7857 | For information on append files, see the | ||
7858 | ":ref:`dev-manual/layers:appending other layers metadata with your layer`" | ||
7859 | section. | ||
7860 | |||
7829 | :term:`SRCREV_FORMAT` | 7861 | :term:`SRCREV_FORMAT` |
7830 | See :term:`bitbake:SRCREV_FORMAT` in the BitBake manual. | 7862 | See :term:`bitbake:SRCREV_FORMAT` in the BitBake manual. |
7831 | 7863 | ||