====== ili9486_fb driver ======
This driver supports SPI TFT displays with an ILI9486 controller on Orange Pi and Raspberry Pi boards. It does not talk to the controller itself, it writes to the Linux framebuffer device that is provided by the kernel modules **fbtft** and **fb_ili9486**.
The driver was tested on an Orange Pi PC2 with a 3.5 inch SPI TFT (480x320, RGB). The touchscreen of these displays is not supported.
----
===== Display Section =====
Display {
Driver 'ili9486_fb'
Port
Size
Bpp
Font
Foreground
Background
Basecolor
}
----
===== Parameters =====
|**Driver**|'ili9486_fb'|
|**Port**|framebuffer device of the display, e.g. '/dev/fb1'. Required.|
|**Size**|size of the display in **pixels**, specified as x. Required, the maximum is '480x320'.|
|**Bpp**|bits per pixel of the framebuffer. Required, the maximum is 16. The pixels are written as RGB565.|
|**Font**|font size, specified as x. Default is '6x8', every size from 6x8 upwards is possible (the built-in 6x8 font is scaled).|
|**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)|
A //Backlight// entry (0..10) is accepted, but has no effect: the driver has no way to control the backlight.
----
===== Example =====
This is the entry from //lcd4linux.conf.sample//:
Display ILI9486_FB {
Driver 'ili9486_fb'
Port '/dev/fb1'
Size '480x320'
Bpp '16'
Font '24x42'
Basecolor '000000'
Foreground 'ffffffff'
Background '00000000'
}
----
===== Plugins =====
|LCD::backlight(n)|registered, but without function (see above). Returns 0 for n = 0, otherwise 1.|
----
===== 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.
----
===== Requirements =====
* kernel modules //fbtft// and //fb_ili9486//, so that the display shows up as a framebuffer device
* no external libraries
The driver is selected at build time with //--with-drivers=ILI9486_FB//.
----