xref: /openbmc/linux/drivers/auxdisplay/Kconfig (revision fcc8487d)
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
8menuconfig 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
16config CHARLCD
17	tristate "Character LCD core support" if COMPILE_TEST
18
19if AUXDISPLAY
20
21config 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
32config 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
50config 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
72config 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
87config 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
115config 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
136config 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
145config 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
158endif # AUXDISPLAY
159
160config 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
170config 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
182if PANEL
183
184config 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
195config 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
216config 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
233config 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
256config 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
265config 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
274config 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
290config 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
304config 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
320config 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
333config 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
348config 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
363config 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
378config 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
393config 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
408config 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
423config 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
435config 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
448endif # PANEL
449