====== 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/xres|width in pixels| |/proc/stb/lcd/yres|height in pixels| |/proc/stb/lcd/bpp|bits per pixel| ---- ===== Display Section ===== Display { Driver 'vuplus4k' Port Font Backlight Foreground Background Basecolor } ---- ===== Parameters ===== |**Driver**|'vuplus4k'| |**Port**|LCD device of the box. This entry is required, there is no default.| |**Font**|font size, specified as x. Default is '6x8', every size from 6x8 upwards is possible (the built-in 6x8 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 [[:lcd4linux:colors]] for details)| |**Background**|color of inactive pixels (RRGGBBAA or RRGGBB), default is transparent 'ffffff00' (see [[:lcd4linux:colors]] for details)| |**Basecolor**|color of the virtual backlight (RRGGBB), default is white 'ffffff' (see [[:lcd4linux: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//. * If the file exists, its first line is displayed and the file is removed. This also happens when the splash screen is disabled. * If the file does not exist, 'goodbye!' is displayed, but only if LCD4Linux was started with //-s//. 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 [[:lcd4linux:driver_vuduo2|vuduo2 driver]] for the VU+ Duo2. ----