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