]> git.proxmox.com Git - mirror_ubuntu-bionic-kernel.git/blob - drivers/auxdisplay/Kconfig
Merge tag 'v4.12-rc1' into patchwork
[mirror_ubuntu-bionic-kernel.git] / drivers / auxdisplay / Kconfig
1 #
2 # For a description of the syntax of this configuration file,
3 # see Documentation/kbuild/kconfig-language.txt.
4 #
5 # Auxiliary display drivers configuration.
6 #
7
8 menuconfig AUXDISPLAY
9 bool "Auxiliary Display support"
10 ---help---
11 Say Y here to get to see options for auxiliary display drivers.
12 This option alone does not add any kernel code.
13
14 If you say N, all options in this submenu will be skipped and disabled.
15
16 config CHARLCD
17 tristate "Character LCD core support" if COMPILE_TEST
18
19 if AUXDISPLAY
20
21 config HD44780
22 tristate "HD44780 Character LCD support"
23 depends on GPIOLIB || COMPILE_TEST
24 select CHARLCD
25 ---help---
26 Enable support for Character LCDs using a HD44780 controller.
27 The LCD is accessible through the /dev/lcd char device (10, 156).
28 This code can either be compiled as a module, or linked into the
29 kernel and started at boot.
30 If you don't understand what all this is about, say N.
31
32 config KS0108
33 tristate "KS0108 LCD Controller"
34 depends on PARPORT_PC
35 default n
36 ---help---
37 If you have a LCD controlled by one or more KS0108
38 controllers, say Y. You will need also another more specific
39 driver for your LCD.
40
41 Depends on Parallel Port support. If you say Y at
42 parport, you will be able to compile this as a module (M)
43 and built-in as well (Y).
44
45 To compile this as a module, choose M here:
46 the module will be called ks0108.
47
48 If unsure, say N.
49
50 config KS0108_PORT
51 hex "Parallel port where the LCD is connected"
52 depends on KS0108
53 default 0x378
54 ---help---
55 The address of the parallel port where the LCD is connected.
56
57 The first standard parallel port address is 0x378.
58 The second standard parallel port address is 0x278.
59 The third standard parallel port address is 0x3BC.
60
61 You can specify a different address if you need.
62
63 If you don't know what I'm talking about, load the parport module,
64 and execute "dmesg" or "cat /proc/ioports". You can see there how
65 many parallel ports are present and which address each one has.
66
67 Usually you only need to use 0x378.
68
69 If you compile this as a module, you can still override this
70 using the module parameters.
71
72 config KS0108_DELAY
73 int "Delay between each control writing (microseconds)"
74 depends on KS0108
75 default "2"
76 ---help---
77 Amount of time the ks0108 should wait between each control write
78 to the parallel port.
79
80 If your LCD seems to miss random writings, increment this.
81
82 If you don't know what I'm talking about, ignore it.
83
84 If you compile this as a module, you can still override this
85 value using the module parameters.
86
87 config CFAG12864B
88 tristate "CFAG12864B LCD"
89 depends on X86
90 depends on FB
91 depends on KS0108
92 select FB_SYS_FILLRECT
93 select FB_SYS_COPYAREA
94 select FB_SYS_IMAGEBLIT
95 select FB_SYS_FOPS
96 default n
97 ---help---
98 If you have a Crystalfontz 128x64 2-color LCD, cfag12864b Series,
99 say Y. You also need the ks0108 LCD Controller driver.
100
101 For help about how to wire your LCD to the parallel port,
102 check Documentation/auxdisplay/cfag12864b
103
104 Depends on the x86 arch and the framebuffer support.
105
106 The LCD framebuffer driver can be attached to a console.
107 It will work fine. However, you can't attach it to the fbdev driver
108 of the xorg server.
109
110 To compile this as a module, choose M here:
111 the modules will be called cfag12864b and cfag12864bfb.
112
113 If unsure, say N.
114
115 config CFAG12864B_RATE
116 int "Refresh rate (hertz)"
117 depends on CFAG12864B
118 default "20"
119 ---help---
120 Refresh rate of the LCD.
121
122 As the LCD is not memory mapped, the driver has to make the work by
123 software. This means you should be careful setting this value higher.
124 If your CPUs are really slow or you feel the system is slowed down,
125 decrease the value.
126
127 Be careful modifying this value to a very high value:
128 You can freeze the computer, or the LCD maybe can't draw as fast as you
129 are requesting.
130
131 If you don't know what I'm talking about, ignore it.
132
133 If you compile this as a module, you can still override this
134 value using the module parameters.
135
136 config IMG_ASCII_LCD
137 tristate "Imagination Technologies ASCII LCD Display"
138 default y if MIPS_MALTA || MIPS_SEAD3
139 select SYSCON
140 help
141 Enable this to support the simple ASCII LCD displays found on
142 development boards such as the MIPS Boston, MIPS Malta & MIPS SEAD3
143 from Imagination Technologies.
144
145 config HT16K33
146 tristate "Holtek Ht16K33 LED controller with keyscan"
147 depends on FB && OF && I2C && INPUT
148 select FB_SYS_FOPS
149 select FB_SYS_FILLRECT
150 select FB_SYS_COPYAREA
151 select FB_SYS_IMAGEBLIT
152 select INPUT_MATRIXKMAP
153 select FB_BACKLIGHT
154 help
155 Say yes here to add support for Holtek HT16K33, RAM mapping 16*8
156 LED controller driver with keyscan.
157
158 endif # AUXDISPLAY
159
160 config ARM_CHARLCD
161 bool "ARM Ltd. Character LCD Driver"
162 depends on PLAT_VERSATILE
163 help
164 This is a driver for the character LCD found on the ARM Ltd.
165 Versatile and RealView Platform Baseboards. It doesn't do
166 very much more than display the text "ARM Linux" on the first
167 line and the Linux version on the second line, but that's
168 still useful.
169
170 config PANEL
171 tristate "Parallel port LCD/Keypad Panel support"
172 depends on PARPORT
173 select CHARLCD
174 ---help---
175 Say Y here if you have an HD44780 or KS-0074 LCD connected to your
176 parallel port. This driver also features 4 and 6-key keypads. The LCD
177 is accessible through the /dev/lcd char device (10, 156), and the
178 keypad through /dev/keypad (10, 185). This code can either be
179 compiled as a module, or linked into the kernel and started at boot.
180 If you don't understand what all this is about, say N.
181
182 if PANEL
183
184 config PANEL_PARPORT
185 int "Default parallel port number (0=LPT1)"
186 range 0 255
187 default "0"
188 ---help---
189 This is the index of the parallel port the panel is connected to. One
190 driver instance only supports one parallel port, so if your keypad
191 and LCD are connected to two separate ports, you have to start two
192 modules with different arguments. Numbering starts with '0' for LPT1,
193 and so on.
194
195 config PANEL_PROFILE
196 int "Default panel profile (0-5, 0=custom)"
197 range 0 5
198 default "5"
199 ---help---
200 To ease configuration, the driver supports different configuration
201 profiles for past and recent wirings. These profiles can also be
202 used to define an approximative configuration, completed by a few
203 other options. Here are the profiles :
204
205 0 = custom (see further)
206 1 = 2x16 parallel LCD, old keypad
207 2 = 2x16 serial LCD (KS-0074), new keypad
208 3 = 2x16 parallel LCD (Hantronix), no keypad
209 4 = 2x16 parallel LCD (Nexcom NSA1045) with Nexcom's keypad
210 5 = 2x40 parallel LCD (old one), with old keypad
211
212 Custom configurations allow you to define how your display is
213 wired to the parallel port, and how it works. This is only intended
214 for experts.
215
216 config PANEL_KEYPAD
217 depends on PANEL_PROFILE="0"
218 int "Keypad type (0=none, 1=old 6 keys, 2=new 6 keys, 3=Nexcom 4 keys)"
219 range 0 3
220 default 0
221 ---help---
222 This enables and configures a keypad connected to the parallel port.
223 The keys will be read from character device 10,185. Valid values are :
224
225 0 : do not enable this driver
226 1 : old 6 keys keypad
227 2 : new 6 keys keypad, as used on the server at www.ant-computing.com
228 3 : Nexcom NSA1045's 4 keys keypad
229
230 New profiles can be described in the driver source. The driver also
231 supports simultaneous keys pressed when the keypad supports them.
232
233 config PANEL_LCD
234 depends on PANEL_PROFILE="0"
235 int "LCD type (0=none, 1=custom, 2=old //, 3=ks0074, 4=hantronix, 5=Nexcom)"
236 range 0 5
237 default 0
238 ---help---
239 This enables and configures an LCD connected to the parallel port.
240 The driver includes an interpreter for escape codes starting with
241 '\e[L' which are specific to the LCD, and a few ANSI codes. The
242 driver will be registered as character device 10,156, usually
243 under the name '/dev/lcd'. There are a total of 6 supported types :
244
245 0 : do not enable the driver
246 1 : custom configuration and wiring (see further)
247 2 : 2x16 & 2x40 parallel LCD (old wiring)
248 3 : 2x16 serial LCD (KS-0074 based)
249 4 : 2x16 parallel LCD (Hantronix wiring)
250 5 : 2x16 parallel LCD (Nexcom wiring)
251
252 When type '1' is specified, other options will appear to configure
253 more precise aspects (wiring, dimensions, protocol, ...). Please note
254 that those values changed from the 2.4 driver for better consistency.
255
256 config PANEL_LCD_HEIGHT
257 depends on PANEL_PROFILE="0" && PANEL_LCD="1"
258 int "Number of lines on the LCD (1-2)"
259 range 1 2
260 default 2
261 ---help---
262 This is the number of visible character lines on the LCD in custom profile.
263 It can either be 1 or 2.
264
265 config PANEL_LCD_WIDTH
266 depends on PANEL_PROFILE="0" && PANEL_LCD="1"
267 int "Number of characters per line on the LCD (1-40)"
268 range 1 40
269 default 40
270 ---help---
271 This is the number of characters per line on the LCD in custom profile.
272 Common values are 16,20,24,40.
273
274 config PANEL_LCD_BWIDTH
275 depends on PANEL_PROFILE="0" && PANEL_LCD="1"
276 int "Internal LCD line width (1-40, 40 by default)"
277 range 1 40
278 default 40
279 ---help---
280 Most LCDs use a standard controller which supports hardware lines of 40
281 characters, although sometimes only 16, 20 or 24 of them are really wired
282 to the terminal. This results in some non-visible but addressable characters,
283 and is the case for most parallel LCDs. Other LCDs, and some serial ones,
284 however, use the same line width internally as what is visible. The KS0074
285 for example, uses 16 characters per line for 16 visible characters per line.
286
287 This option lets you configure the value used by your LCD in 'custom' profile.
288 If you don't know, put '40' here.
289
290 config PANEL_LCD_HWIDTH
291 depends on PANEL_PROFILE="0" && PANEL_LCD="1"
292 int "Hardware LCD line width (1-64, 64 by default)"
293 range 1 64
294 default 64
295 ---help---
296 Most LCDs use a single address bit to differentiate line 0 and line 1. Since
297 some of them need to be able to address 40 chars with the lower bits, they
298 often use the immediately superior power of 2, which is 64, to address the
299 next line.
300
301 If you don't know what your LCD uses, in doubt let 16 here for a 2x16, and
302 64 here for a 2x40.
303
304 config PANEL_LCD_CHARSET
305 depends on PANEL_PROFILE="0" && PANEL_LCD="1"
306 int "LCD character set (0=normal, 1=KS0074)"
307 range 0 1
308 default 0
309 ---help---
310 Some controllers such as the KS0074 use a somewhat strange character set
311 where many symbols are at unusual places. The driver knows how to map
312 'standard' ASCII characters to the character sets used by these controllers.
313 Valid values are :
314
315 0 : normal (untranslated) character set
316 1 : KS0074 character set
317
318 If you don't know, use the normal one (0).
319
320 config PANEL_LCD_PROTO
321 depends on PANEL_PROFILE="0" && PANEL_LCD="1"
322 int "LCD communication mode (0=parallel 8 bits, 1=serial)"
323 range 0 1
324 default 0
325 ---help---
326 This driver now supports any serial or parallel LCD wired to a parallel
327 port. But before assigning signals, the driver needs to know if it will
328 be driving a serial LCD or a parallel one. Serial LCDs only use 2 wires
329 (SDA/SCL), while parallel ones use 2 or 3 wires for the control signals
330 (E, RS, sometimes RW), and 4 or 8 for the data. Use 0 here for a 8 bits
331 parallel LCD, and 1 for a serial LCD.
332
333 config PANEL_LCD_PIN_E
334 depends on PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO="0"
335 int "Parallel port pin number & polarity connected to the LCD E signal (-17...17) "
336 range -17 17
337 default 14
338 ---help---
339 This describes the number of the parallel port pin to which the LCD 'E'
340 signal has been connected. It can be :
341
342 0 : no connection (eg: connected to ground)
343 1..17 : directly connected to any of these pins on the DB25 plug
344 -1..-17 : connected to the same pin through an inverter (eg: transistor).
345
346 Default for the 'E' pin in custom profile is '14' (AUTOFEED).
347
348 config PANEL_LCD_PIN_RS
349 depends on PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO="0"
350 int "Parallel port pin number & polarity connected to the LCD RS signal (-17...17) "
351 range -17 17
352 default 17
353 ---help---
354 This describes the number of the parallel port pin to which the LCD 'RS'
355 signal has been connected. It can be :
356
357 0 : no connection (eg: connected to ground)
358 1..17 : directly connected to any of these pins on the DB25 plug
359 -1..-17 : connected to the same pin through an inverter (eg: transistor).
360
361 Default for the 'RS' pin in custom profile is '17' (SELECT IN).
362
363 config PANEL_LCD_PIN_RW
364 depends on PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO="0"
365 int "Parallel port pin number & polarity connected to the LCD RW signal (-17...17) "
366 range -17 17
367 default 16
368 ---help---
369 This describes the number of the parallel port pin to which the LCD 'RW'
370 signal has been connected. It can be :
371
372 0 : no connection (eg: connected to ground)
373 1..17 : directly connected to any of these pins on the DB25 plug
374 -1..-17 : connected to the same pin through an inverter (eg: transistor).
375
376 Default for the 'RW' pin in custom profile is '16' (INIT).
377
378 config PANEL_LCD_PIN_SCL
379 depends on PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO!="0"
380 int "Parallel port pin number & polarity connected to the LCD SCL signal (-17...17) "
381 range -17 17
382 default 1
383 ---help---
384 This describes the number of the parallel port pin to which the serial
385 LCD 'SCL' signal has been connected. It can be :
386
387 0 : no connection (eg: connected to ground)
388 1..17 : directly connected to any of these pins on the DB25 plug
389 -1..-17 : connected to the same pin through an inverter (eg: transistor).
390
391 Default for the 'SCL' pin in custom profile is '1' (STROBE).
392
393 config PANEL_LCD_PIN_SDA
394 depends on PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO!="0"
395 int "Parallel port pin number & polarity connected to the LCD SDA signal (-17...17) "
396 range -17 17
397 default 2
398 ---help---
399 This describes the number of the parallel port pin to which the serial
400 LCD 'SDA' signal has been connected. It can be :
401
402 0 : no connection (eg: connected to ground)
403 1..17 : directly connected to any of these pins on the DB25 plug
404 -1..-17 : connected to the same pin through an inverter (eg: transistor).
405
406 Default for the 'SDA' pin in custom profile is '2' (D0).
407
408 config PANEL_LCD_PIN_BL
409 depends on PANEL_PROFILE="0" && PANEL_LCD="1"
410 int "Parallel port pin number & polarity connected to the LCD backlight signal (-17...17) "
411 range -17 17
412 default 0
413 ---help---
414 This describes the number of the parallel port pin to which the LCD 'BL' signal
415 has been connected. It can be :
416
417 0 : no connection (eg: connected to ground)
418 1..17 : directly connected to any of these pins on the DB25 plug
419 -1..-17 : connected to the same pin through an inverter (eg: transistor).
420
421 Default for the 'BL' pin in custom profile is '0' (uncontrolled).
422
423 config PANEL_CHANGE_MESSAGE
424 bool "Change LCD initialization message ?"
425 default "n"
426 ---help---
427 This allows you to replace the boot message indicating the kernel version
428 and the driver version with a custom message. This is useful on appliances
429 where a simple 'Starting system' message can be enough to stop a customer
430 from worrying.
431
432 If you say 'Y' here, you'll be able to choose a message yourself. Otherwise,
433 say 'N' and keep the default message with the version.
434
435 config PANEL_BOOT_MESSAGE
436 depends on PANEL_CHANGE_MESSAGE="y"
437 string "New initialization message"
438 default ""
439 ---help---
440 This allows you to replace the boot message indicating the kernel version
441 and the driver version with a custom message. This is useful on appliances
442 where a simple 'Starting system' message can be enough to stop a customer
443 from worrying.
444
445 An empty message will only clear the display at driver init time. Any other
446 printf()-formatted message is valid with newline and escape codes.
447
448 endif # PANEL