1.15. 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 splash - display a BMP or PNG splash image 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:


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:



if [ ! -f $SPLASH ]; then
    exit 0

# first show splash
splash /path/to/mysplash.png

# enable framebuffer

# wait for signals to become stable
msleep 100

# finally enable backlight
gpio_direction_output 42 1

1.15.1. Framebuffer console

barebox has framebuffer console support which can be enabled with CONFIG_FRAMEBUFFER_CONSOLE. When registered each framebuffer device gets a corresponding fbconsole device. The console can be activated with fbconsolex.active=oe. Depending on compile time options there are different fonts available. These can be selected with the fbconsolex.font variable. To get a list of fonts use devinfo fbconsolex.