Inhaltsverzeichnis

vuplus4k driver

This driver supports the colour front display (OLED/LCD) of VU+ 4K set-top boxes. It was written for the VU+ Solo 4K and is also used on the VU+ Duo 4K.

The driver writes complete frames to the LCD device of the box. The resolution and the colour depth are not configured, they are read from the kernel driver of the box:

/proc/stb/lcd/xreswidth in pixels
/proc/stb/lcd/yresheight in pixels
/proc/stb/lcd/bppbits per pixel

Display Section

Display <name> {
    Driver       'vuplus4k'
    Port         <string>
    Font         <string>
    Backlight    <number>
    Foreground   <color>
    Background   <color>
    Basecolor    <color>
}

Parameters

Driver'vuplus4k'
PortLCD device of the box. This entry is required, there is no default.
Fontfont size, specified as <width>x<height>. Default is '6×8', every size from 6×8 upwards is possible (the built-in 6×8 font is scaled).
Backlightbrightness of the display, 0 (off) .. 10 (maximum). Default is 10.
Foregroundcolor of active pixels (RRGGBBAA or RRGGBB), default is opaque black '000000ff' (see Colors for details)
Backgroundcolor of inactive pixels (RRGGBBAA or RRGGBB), default is transparent 'ffffff00' (see Colors for details)
Basecolorcolor of the virtual backlight (RRGGBB), default is white 'ffffff' (see Colors for details)

The Backlight value is converted to 0..255 (255 * value / 10) and written to /proc/stb/lcd/oled_brightness. If this file does not exist, /proc/stb/fp/oled_brightness is used.


Example

The device name below is the one commonly found on VU+ images, check it on your box.

Display VUPLUS4K {
    Driver     'vuplus4k'
    Port       '/dev/dbox/lcd0'
    Font       '12x16'
    Backlight  7
    Foreground 'ffffff'
    Background '00000000'
    Basecolor  '000000'
}

Plugins

The driver provides the following function:

LCD::backlight(n)n = 0 switches the display off. Every other value sets brightness level 1 (the lowest step of the 0..10 scale), not the level from the Backlight entry.

Goodbye message

When LCD4Linux is stopped, the driver clears the display and looks for the file /tmp/lcd/goodbye.

The line must end with a newline character (as written by echo), otherwise the file is treated as empty. The message is drawn in the configured Font on the fourth text row, so it is only visible if the display has at least four text rows and the line fits into one row.

echo "Rebooting..." > /tmp/lcd/goodbye

Requirements

The driver is self-contained, no external libraries are needed. It is selected at build time with –with-drivers=VUPLUS4K.

See also the vuduo2 driver for the VU+ Duo2.