====== picoLCD Graphic driver ======
This driver supports the picoLCD Graphic (256x64 pixels) USB display from [[http://www.mini-box.com/picoLCD|mini-box.com]]. The display has a keypad, eight LEDs and is a true USB HID device (vendor ID 0x04d8, product ID 0xc002).
For the 20x2 character display see the [[:lcd4linux:driver_picolcd|picoLCD driver]].
Example configurations can be found in the directory //contrib/picoLCD// of the source.
----
===== Display Section =====
Display {
Driver 'picoLCDGraphic'
Size
Update
Timeout
Contrast
Backlight <0|1>
Inverted <0|1>
}
----
===== Parameters =====
|**Driver**|'picoLCDGraphic'|
|**Size**|x. The entry is required, but the driver always uses 256x64.|
|**Update**|interval (msec) in which the display is redrawn from the internal framebuffer, default is 200. With 0 the display is redrawn after every changed widget (//direct update//), which is much slower.|
|**Timeout**|USB read timeout in msec (1..1000, default is 5). The display times out on every read unless a key has been pressed, so this value influences how fast LCD4Linux reacts.|
|**Contrast**|initial contrast, 0..255|
|**Backlight**|initial backlight state, 0 (off) or 1 (on). Values greater than 1 are rejected here; use the function //LCD::backlight()// for finer steps.|
|**Inverted**|set to 1 to invert the display|
The font is fixed to 6x8.
----
===== Plugins =====
The driver provides the following functions:
|LCD::contrast(n)|set the contrast to n (0..255)|
|LCD::backlight(n)|set the backlight brightness to n (0..255)|
|LCD::gpo(n,v)|switch LED n (0..7) on (v = 1) or off (v = 0)|
|LCD::GPI(1)|returns the code of the key that is currently pressed (0 = none)|
The eight LEDs are also available as GPO1 .. GPO8 for the [[:lcd4linux:widget_gpo|GPO widget]].
----
===== Keypad =====
The keys of the display can be used with the [[:lcd4linux:widget_keypad|keypad widget]]. They are polled every 100 msec, press and release events are reported.
|**key code**|**keypad widget**|
|1|cancel|
|2|left|
|3|right|
|5|up|
|6|confirm|
|7|down|
----
===== Example =====
Display picoLCDGraphic {
Driver 'picoLCDGraphic'
Size '256x64'
Update 200
Contrast 230
Backlight 1
}
----
===== Requirements =====
libusb (0.1) is needed. The driver is selected at build time with //--with-drivers=picoLCDGraphic//.
----