1 # SPDX-License-Identifier: GPL-2.0
3 # For a description of the syntax of this configuration file,
4 # see Documentation/kbuild/kconfig-language.txt.
6 # Auxiliary display drivers configuration.
10 bool "Auxiliary Display support"
12 Say Y here to get to see options for auxiliary display drivers.
13 This option alone does not add any kernel code.
15 If you say N, all options in this submenu will be skipped and disabled.
18 tristate "Character LCD core support" if COMPILE_TEST
23 tristate "HD44780 Character LCD support"
24 depends on GPIOLIB || COMPILE_TEST
27 Enable support for Character LCDs using a HD44780 controller.
28 The LCD is accessible through the /dev/lcd char device (10, 156).
29 This code can either be compiled as a module, or linked into the
30 kernel and started at boot.
31 If you don't understand what all this is about, say N.
34 tristate "KS0108 LCD Controller"
38 If you have a LCD controlled by one or more KS0108
39 controllers, say Y. You will need also another more specific
42 Depends on Parallel Port support. If you say Y at
43 parport, you will be able to compile this as a module (M)
44 and built-in as well (Y).
46 To compile this as a module, choose M here:
47 the module will be called ks0108.
52 hex "Parallel port where the LCD is connected"
56 The address of the parallel port where the LCD is connected.
58 The first standard parallel port address is 0x378.
59 The second standard parallel port address is 0x278.
60 The third standard parallel port address is 0x3BC.
62 You can specify a different address if you need.
64 If you don't know what I'm talking about, load the parport module,
65 and execute "dmesg" or "cat /proc/ioports". You can see there how
66 many parallel ports are present and which address each one has.
68 Usually you only need to use 0x378.
70 If you compile this as a module, you can still override this
71 using the module parameters.
74 int "Delay between each control writing (microseconds)"
78 Amount of time the ks0108 should wait between each control write
81 If your LCD seems to miss random writings, increment this.
83 If you don't know what I'm talking about, ignore it.
85 If you compile this as a module, you can still override this
86 value using the module parameters.
89 tristate "CFAG12864B LCD"
93 select FB_SYS_FILLRECT
94 select FB_SYS_COPYAREA
95 select FB_SYS_IMAGEBLIT
99 If you have a Crystalfontz 128x64 2-color LCD, cfag12864b Series,
100 say Y. You also need the ks0108 LCD Controller driver.
102 For help about how to wire your LCD to the parallel port,
103 check Documentation/auxdisplay/cfag12864b
105 Depends on the x86 arch and the framebuffer support.
107 The LCD framebuffer driver can be attached to a console.
108 It will work fine. However, you can't attach it to the fbdev driver
111 To compile this as a module, choose M here:
112 the modules will be called cfag12864b and cfag12864bfb.
116 config CFAG12864B_RATE
117 int "Refresh rate (hertz)"
118 depends on CFAG12864B
121 Refresh rate of the LCD.
123 As the LCD is not memory mapped, the driver has to make the work by
124 software. This means you should be careful setting this value higher.
125 If your CPUs are really slow or you feel the system is slowed down,
128 Be careful modifying this value to a very high value:
129 You can freeze the computer, or the LCD maybe can't draw as fast as you
132 If you don't know what I'm talking about, ignore it.
134 If you compile this as a module, you can still override this
135 value using the module parameters.
138 tristate "Imagination Technologies ASCII LCD Display"
139 default y if MIPS_MALTA || MIPS_SEAD3
142 Enable this to support the simple ASCII LCD displays found on
143 development boards such as the MIPS Boston, MIPS Malta & MIPS SEAD3
144 from Imagination Technologies.
147 tristate "Holtek Ht16K33 LED controller with keyscan"
148 depends on FB && OF && I2C && INPUT
150 select FB_SYS_FILLRECT
151 select FB_SYS_COPYAREA
152 select FB_SYS_IMAGEBLIT
153 select INPUT_MATRIXKMAP
156 Say yes here to add support for Holtek HT16K33, RAM mapping 16*8
157 LED controller driver with keyscan.
162 bool "ARM Ltd. Character LCD Driver"
163 depends on PLAT_VERSATILE
165 This is a driver for the character LCD found on the ARM Ltd.
166 Versatile and RealView Platform Baseboards. It doesn't do
167 very much more than display the text "ARM Linux" on the first
168 line and the Linux version on the second line, but that's
172 tristate "Parallel port LCD/Keypad Panel support"
176 Say Y here if you have an HD44780 or KS-0074 LCD connected to your
177 parallel port. This driver also features 4 and 6-key keypads. The LCD
178 is accessible through the /dev/lcd char device (10, 156), and the
179 keypad through /dev/keypad (10, 185). This code can either be
180 compiled as a module, or linked into the kernel and started at boot.
181 If you don't understand what all this is about, say N.
186 int "Default parallel port number (0=LPT1)"
190 This is the index of the parallel port the panel is connected to. One
191 driver instance only supports one parallel port, so if your keypad
192 and LCD are connected to two separate ports, you have to start two
193 modules with different arguments. Numbering starts with '0' for LPT1,
197 int "Default panel profile (0-5, 0=custom)"
201 To ease configuration, the driver supports different configuration
202 profiles for past and recent wirings. These profiles can also be
203 used to define an approximative configuration, completed by a few
204 other options. Here are the profiles :
206 0 = custom (see further)
207 1 = 2x16 parallel LCD, old keypad
208 2 = 2x16 serial LCD (KS-0074), new keypad
209 3 = 2x16 parallel LCD (Hantronix), no keypad
210 4 = 2x16 parallel LCD (Nexcom NSA1045) with Nexcom's keypad
211 5 = 2x40 parallel LCD (old one), with old keypad
213 Custom configurations allow you to define how your display is
214 wired to the parallel port, and how it works. This is only intended
218 depends on PANEL_PROFILE="0"
219 int "Keypad type (0=none, 1=old 6 keys, 2=new 6 keys, 3=Nexcom 4 keys)"
223 This enables and configures a keypad connected to the parallel port.
224 The keys will be read from character device 10,185. Valid values are :
226 0 : do not enable this driver
227 1 : old 6 keys keypad
228 2 : new 6 keys keypad, as used on the server at www.ant-computing.com
229 3 : Nexcom NSA1045's 4 keys keypad
231 New profiles can be described in the driver source. The driver also
232 supports simultaneous keys pressed when the keypad supports them.
235 depends on PANEL_PROFILE="0"
236 int "LCD type (0=none, 1=custom, 2=old //, 3=ks0074, 4=hantronix, 5=Nexcom)"
240 This enables and configures an LCD connected to the parallel port.
241 The driver includes an interpreter for escape codes starting with
242 '\e[L' which are specific to the LCD, and a few ANSI codes. The
243 driver will be registered as character device 10,156, usually
244 under the name '/dev/lcd'. There are a total of 6 supported types :
246 0 : do not enable the driver
247 1 : custom configuration and wiring (see further)
248 2 : 2x16 & 2x40 parallel LCD (old wiring)
249 3 : 2x16 serial LCD (KS-0074 based)
250 4 : 2x16 parallel LCD (Hantronix wiring)
251 5 : 2x16 parallel LCD (Nexcom wiring)
253 When type '1' is specified, other options will appear to configure
254 more precise aspects (wiring, dimensions, protocol, ...). Please note
255 that those values changed from the 2.4 driver for better consistency.
257 config PANEL_LCD_HEIGHT
258 depends on PANEL_PROFILE="0" && PANEL_LCD="1"
259 int "Number of lines on the LCD (1-2)"
263 This is the number of visible character lines on the LCD in custom profile.
264 It can either be 1 or 2.
266 config PANEL_LCD_WIDTH
267 depends on PANEL_PROFILE="0" && PANEL_LCD="1"
268 int "Number of characters per line on the LCD (1-40)"
272 This is the number of characters per line on the LCD in custom profile.
273 Common values are 16,20,24,40.
275 config PANEL_LCD_BWIDTH
276 depends on PANEL_PROFILE="0" && PANEL_LCD="1"
277 int "Internal LCD line width (1-40, 40 by default)"
281 Most LCDs use a standard controller which supports hardware lines of 40
282 characters, although sometimes only 16, 20 or 24 of them are really wired
283 to the terminal. This results in some non-visible but addressable characters,
284 and is the case for most parallel LCDs. Other LCDs, and some serial ones,
285 however, use the same line width internally as what is visible. The KS0074
286 for example, uses 16 characters per line for 16 visible characters per line.
288 This option lets you configure the value used by your LCD in 'custom' profile.
289 If you don't know, put '40' here.
291 config PANEL_LCD_HWIDTH
292 depends on PANEL_PROFILE="0" && PANEL_LCD="1"
293 int "Hardware LCD line width (1-64, 64 by default)"
297 Most LCDs use a single address bit to differentiate line 0 and line 1. Since
298 some of them need to be able to address 40 chars with the lower bits, they
299 often use the immediately superior power of 2, which is 64, to address the
302 If you don't know what your LCD uses, in doubt let 16 here for a 2x16, and
305 config PANEL_LCD_CHARSET
306 depends on PANEL_PROFILE="0" && PANEL_LCD="1"
307 int "LCD character set (0=normal, 1=KS0074)"
311 Some controllers such as the KS0074 use a somewhat strange character set
312 where many symbols are at unusual places. The driver knows how to map
313 'standard' ASCII characters to the character sets used by these controllers.
316 0 : normal (untranslated) character set
317 1 : KS0074 character set
319 If you don't know, use the normal one (0).
321 config PANEL_LCD_PROTO
322 depends on PANEL_PROFILE="0" && PANEL_LCD="1"
323 int "LCD communication mode (0=parallel 8 bits, 1=serial)"
327 This driver now supports any serial or parallel LCD wired to a parallel
328 port. But before assigning signals, the driver needs to know if it will
329 be driving a serial LCD or a parallel one. Serial LCDs only use 2 wires
330 (SDA/SCL), while parallel ones use 2 or 3 wires for the control signals
331 (E, RS, sometimes RW), and 4 or 8 for the data. Use 0 here for a 8 bits
332 parallel LCD, and 1 for a serial LCD.
334 config PANEL_LCD_PIN_E
335 depends on PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO="0"
336 int "Parallel port pin number & polarity connected to the LCD E signal (-17...17) "
340 This describes the number of the parallel port pin to which the LCD 'E'
341 signal has been connected. It can be :
343 0 : no connection (eg: connected to ground)
344 1..17 : directly connected to any of these pins on the DB25 plug
345 -1..-17 : connected to the same pin through an inverter (eg: transistor).
347 Default for the 'E' pin in custom profile is '14' (AUTOFEED).
349 config PANEL_LCD_PIN_RS
350 depends on PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO="0"
351 int "Parallel port pin number & polarity connected to the LCD RS signal (-17...17) "
355 This describes the number of the parallel port pin to which the LCD 'RS'
356 signal has been connected. It can be :
358 0 : no connection (eg: connected to ground)
359 1..17 : directly connected to any of these pins on the DB25 plug
360 -1..-17 : connected to the same pin through an inverter (eg: transistor).
362 Default for the 'RS' pin in custom profile is '17' (SELECT IN).
364 config PANEL_LCD_PIN_RW
365 depends on PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO="0"
366 int "Parallel port pin number & polarity connected to the LCD RW signal (-17...17) "
370 This describes the number of the parallel port pin to which the LCD 'RW'
371 signal has been connected. It can be :
373 0 : no connection (eg: connected to ground)
374 1..17 : directly connected to any of these pins on the DB25 plug
375 -1..-17 : connected to the same pin through an inverter (eg: transistor).
377 Default for the 'RW' pin in custom profile is '16' (INIT).
379 config PANEL_LCD_PIN_SCL
380 depends on PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO!="0"
381 int "Parallel port pin number & polarity connected to the LCD SCL signal (-17...17) "
385 This describes the number of the parallel port pin to which the serial
386 LCD 'SCL' signal has been connected. It can be :
388 0 : no connection (eg: connected to ground)
389 1..17 : directly connected to any of these pins on the DB25 plug
390 -1..-17 : connected to the same pin through an inverter (eg: transistor).
392 Default for the 'SCL' pin in custom profile is '1' (STROBE).
394 config PANEL_LCD_PIN_SDA
395 depends on PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO!="0"
396 int "Parallel port pin number & polarity connected to the LCD SDA signal (-17...17) "
400 This describes the number of the parallel port pin to which the serial
401 LCD 'SDA' signal has been connected. It can be :
403 0 : no connection (eg: connected to ground)
404 1..17 : directly connected to any of these pins on the DB25 plug
405 -1..-17 : connected to the same pin through an inverter (eg: transistor).
407 Default for the 'SDA' pin in custom profile is '2' (D0).
409 config PANEL_LCD_PIN_BL
410 depends on PANEL_PROFILE="0" && PANEL_LCD="1"
411 int "Parallel port pin number & polarity connected to the LCD backlight signal (-17...17) "
415 This describes the number of the parallel port pin to which the LCD 'BL' signal
416 has been connected. It can be :
418 0 : no connection (eg: connected to ground)
419 1..17 : directly connected to any of these pins on the DB25 plug
420 -1..-17 : connected to the same pin through an inverter (eg: transistor).
422 Default for the 'BL' pin in custom profile is '0' (uncontrolled).
424 config PANEL_CHANGE_MESSAGE
425 bool "Change LCD initialization message ?"
428 This allows you to replace the boot message indicating the kernel version
429 and the driver version with a custom message. This is useful on appliances
430 where a simple 'Starting system' message can be enough to stop a customer
433 If you say 'Y' here, you'll be able to choose a message yourself. Otherwise,
434 say 'N' and keep the default message with the version.
436 config PANEL_BOOT_MESSAGE
437 depends on PANEL_CHANGE_MESSAGE="y"
438 string "New initialization message"
441 This allows you to replace the boot message indicating the kernel version
442 and the driver version with a custom message. This is useful on appliances
443 where a simple 'Starting system' message can be enough to stop a customer
446 An empty message will only clear the display at driver init time. Any other
447 printf()-formatted message is valid with newline and escape codes.