3fef396bb4
This is a rewrite of the Documentation in reStructuredText format using Sphinx as build system, see http://sphinx-doc.org/. The documentation is built into static html pages with 'make docs'. The pages can be found under Documentation/html after building. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
44 lines
1.2 KiB
ReStructuredText
44 lines
1.2 KiB
ReStructuredText
Framebuffer support
|
|
===================
|
|
|
|
barebox has support for framebuffer devices. Currently there is no console support
|
|
for framebuffers, so framebuffer usage is limited to splash screens only. barebox
|
|
supports BMP and PNG graphics using the :ref:`command_splash` command. barebox
|
|
currently has no support for backlights, so unless there is a board specific enable
|
|
hook for enabling a display it must be done manually with a script. Since barebox
|
|
has nothing useful to show on the framebuffer it doesn't enable it during startup.
|
|
A framebuffer can be enabled with the ``enable`` parameter of the framebuffer device:
|
|
|
|
.. code-block:: sh
|
|
|
|
fb0.enable=1
|
|
|
|
Some framebuffer devices support different resolutions. These can be configured
|
|
with the ``mode_name`` parameter. See a list of supported modes using ``devinfo fb0``.
|
|
A mode can only be changed when the framebuffer is disabled.
|
|
|
|
A typical script to enable the framebuffer could look like this:
|
|
|
|
.. code-block:: sh
|
|
|
|
#!/bin/sh
|
|
|
|
SPLASH=/path/to/mysplash.png
|
|
|
|
if [ ! -f $SPLASH ]; then
|
|
exit 0
|
|
fi
|
|
|
|
# first show splash
|
|
splash /path/to/mysplash.png
|
|
|
|
# enable framebuffer
|
|
fb0.enable=1
|
|
|
|
# wait for signals to become stable
|
|
msleep 100
|
|
|
|
# finally enable backlight
|
|
gpio_direction_output 42 1
|
|
|