framebuffer

disclaimer / info:

DISCLAIMER:
THIS IS EXPERIMENTAL SOFTWARE AND HARDWARE. USE AT YOUR OWN RISK. THE MAINTAINER(S) OF THESE PAGES AND THE DEVELOPER(S) OF SOFTWARE AND HARDWARE PRESENTED ON THESE PAGES CAN NOT BE HELD LIABLE UNDER ANY CIRCUMSTANCES FOR DAMAGE TO HARDWARE OR SOFTWARE, LOST DATA, OR OTHER DIRECT OR INDIRECT DAMAGE RESULTING FROM THE USE OF THIS SOFTWARE OR HARDWARE. IF YOU DO NOT AGREE TO THESE CONDITIONS, YOU ARE NOT PERMITTED TO USE OR FURTHER DISTRIBUTE THIS SOFTWARE OR TO USE ANY TEMPLATES FOR BUILDING HARDWARE PRESENTED HERE.

framebuffer:

description

this driver supports framebuffer devices that are supported by linux framebuffer support. even an attached touchscreen may be used if it supported by linux.

Attention: this is a linux-only driver at the moment.

specifications
resolution variable
colours variable
adjustable contrast no
supported since serdisplib version 2.01
name in serdisplib "FRAMEBUFFER"       (example: serdisp_init(sdcd, "FRAMEBUFFER", ""); )
top ^

connecting a framebuffer device:

intro

the framebuffer device must already be configured and initialised by linux - including resolution and colour depth.

important

example for configuration of the touchscreen:
SUBSYSTEM=="input",ATTRS{idVendor}=="1ac7", ATTRS{idProduct}=="0001", GROUP="users",MODE="0660", SYMLINK+="input/touchscreen"
examples
configuration in lcd4linux
 Display SerDispLib {
   Driver 'serdisplib'
   Model 'framebuffer'
   Options 'FBDEVICE=/dev/fb1;TOUCHDEVICE=/dev/input/touchscreen'
 }
configuration in graphlcd
 [serdisp_framebuffer]
 Driver=serdisp
 Controller=framebuffer
 Options=FBDEVICE=/dev/fb0

 [mimo720s]
 Driver=serdisp
 Controller=framebuffer
 Options=FBDEVICE=/dev/fb1;TOUCHDEVICE=/dev/input/touchscreen;TOUCHSWAPY=1
calling test program testserdisp
  testserdisp -n framebuffer -o 'FBDEV=/dev/fb1'
  testserdisp -n framebuffer -o 'FBDEV=/dev/fb1;TOUCHDEVICE=/dev/input/touchscreen;TOUCHSWAPY=1;ROTATE=90'
top ^

passing options through serdisp_init():

intro

using the third parameter of serdisp_init(), driver specific options and custom wiring can be set.
common information about passing options can be found in a separate document.
    examples:

      serdisp_init(sdcd, "FRAMEBUFFER", "FBDEV=/dev/fb1");
      serdisp_init(sdcd, "FRAMEBUFFER", "FBDEV=/dev/fb1;TOUCHDEVICE=/dev/input/touchscreen;TOUCHSWAPY=1;ROTATE=90");
    

options

identifiershortremarkdefault
FBDEVICE FBDEV set the framebuffer device/dev/fb0
REPORTDAMAGEDAMAGE report damage (0: no damage report, 1: automatic, 2: udlfb, 3: ugly (send '\n' after refresh)1
TOUCHDEVICE TSDEV set the touchscreen device(none)
TOUCHSWAPX TSSWAPXswap x-asis of touchscreen0
TOUCHSWAPY TSSWAPYswap y-asis of touchscreen0

ranges, aliases

identifierrangealiases
REPORTDAMAGE[0 - 3]NONE=0,OFF=0,AUTO=1,UDLFB=2,UGLY=3
TOUCHSWAPX0, 1OFF=0,ON=1,NO=0,YES=1
TOUCHSWAPY0, 1OFF=0,ON=1,NO=0,YES=1

options for specific framebuffer devices

modeltouchscreentouchscreen options
Mimo 720syesTOUCHSWAPY=1
top ^

history:

2017-02-06 moving documentation to serdisplib page
2013-05-19 first release of documentation (SVN only)
top ^

design by wolfgang astleitner, (C) 1998 - 2017