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/xres | width in pixels |
| /proc/stb/lcd/yres | height in pixels |
| /proc/stb/lcd/bpp | bits per pixel |
Display <name> {
Driver 'vuplus4k'
Port <string>
Font <string>
Backlight <number>
Foreground <color>
Background <color>
Basecolor <color>
}
| Driver | 'vuplus4k' |
| Port | LCD device of the box. This entry is required, there is no default. |
| Font | font 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). |
| Backlight | brightness of the display, 0 (off) .. 10 (maximum). Default is 10. |
| Foreground | color of active pixels (RRGGBBAA or RRGGBB), default is opaque black '000000ff' (see Colors for details) |
| Background | color of inactive pixels (RRGGBBAA or RRGGBB), default is transparent 'ffffff00' (see Colors for details) |
| Basecolor | color 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.
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'
}
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. |
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
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.