~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/Documentation/admin-guide/auxdisplay/cfag12864b.rst

Version: ~ [ linux-6.11.5 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.58 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.114 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.169 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.228 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.284 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.322 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.9 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

  1 ===================================
  2 cfag12864b LCD Driver Documentation
  3 ===================================
  4 
  5 :License:               GPLv2
  6 :Author & Maintainer:   Miguel Ojeda <ojeda@kernel.org>
  7 :Date:                  2006-10-27
  8 
  9 
 10 
 11 .. INDEX
 12 
 13         1. DRIVER INFORMATION
 14         2. DEVICE INFORMATION
 15         3. WIRING
 16         4. USERSPACE PROGRAMMING
 17 
 18 1. Driver Information
 19 ---------------------
 20 
 21 This driver supports a cfag12864b LCD.
 22 
 23 
 24 2. Device Information
 25 ---------------------
 26 
 27 :Manufacturer:  Crystalfontz
 28 :Device Name:   Crystalfontz 12864b LCD Series
 29 :Device Code:   cfag12864b
 30 :Webpage:       http://www.crystalfontz.com
 31 :Device Webpage: http://www.crystalfontz.com/products/12864b/
 32 :Type:          LCD (Liquid Crystal Display)
 33 :Width:         128
 34 :Height:        64
 35 :Colors:        2 (B/N)
 36 :Controller:    ks0108
 37 :Controllers:   2
 38 :Pages:         8 each controller
 39 :Addresses:     64 each page
 40 :Data size:     1 byte each address
 41 :Memory size:   2 * 8 * 64 * 1 = 1024 bytes = 1 Kbyte
 42 
 43 
 44 3. Wiring
 45 ---------
 46 
 47 The cfag12864b LCD Series don't have official wiring.
 48 
 49 The common wiring is done to the parallel port as shown::
 50 
 51   Parallel Port                          cfag12864b
 52 
 53     Name Pin#                            Pin# Name
 54 
 55   Strobe ( 1)------------------------------(17) Enable
 56   Data 0 ( 2)------------------------------( 4) Data 0
 57   Data 1 ( 3)------------------------------( 5) Data 1
 58   Data 2 ( 4)------------------------------( 6) Data 2
 59   Data 3 ( 5)------------------------------( 7) Data 3
 60   Data 4 ( 6)------------------------------( 8) Data 4
 61   Data 5 ( 7)------------------------------( 9) Data 5
 62   Data 6 ( 8)------------------------------(10) Data 6
 63   Data 7 ( 9)------------------------------(11) Data 7
 64          (10)                      [+5v]---( 1) Vdd
 65          (11)                      [GND]---( 2) Ground
 66          (12)                      [+5v]---(14) Reset
 67          (13)                      [GND]---(15) Read / Write
 68     Line (14)------------------------------(13) Controller Select 1
 69          (15)
 70     Init (16)------------------------------(12) Controller Select 2
 71   Select (17)------------------------------(16) Data / Instruction
 72   Ground (18)---[GND]              [+5v]---(19) LED +
 73   Ground (19)---[GND]
 74   Ground (20)---[GND]              E    A             Values:
 75   Ground (21)---[GND]       [GND]---[P1]---(18) Vee    - R = Resistor = 22 ohm
 76   Ground (22)---[GND]                |                 - P1 = Preset = 10 Kohm
 77   Ground (23)---[GND]       ----   S ------( 3) V0     - P2 = Preset = 1 Kohm
 78   Ground (24)---[GND]       |  |
 79   Ground (25)---[GND] [GND]---[P2]---[R]---(20) LED -
 80 
 81 
 82 4. Userspace Programming
 83 ------------------------
 84 
 85 The cfag12864bfb describes a framebuffer device (/dev/fbX).
 86 
 87 It has a size of 1024 bytes = 1 Kbyte.
 88 Each bit represents one pixel. If the bit is high, the pixel will
 89 turn on. If the pixel is low, the pixel will turn off.
 90 
 91 You can use the framebuffer as a file: fopen, fwrite, fclose...
 92 Although the LCD won't get updated until the next refresh time arrives.
 93 
 94 Also, you can mmap the framebuffer: open & mmap, munmap & close...
 95 which is the best option for most uses.
 96 
 97 Check samples/auxdisplay/cfag12864b-example.c
 98 for a real working userspace complete program with usage examples.

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php