forked from ~ljy/RK356X_SDK_RELEASE
blame | history | patch | commit | commitdiff
hc
2024-10-09 244b2c5ca8b14627e4a17755e5922221e121c771 
 kernel/drivers/auxdisplay/Kconfig
....@@ -1,14 +1,14 @@
11 # SPDX-License-Identifier: GPL-2.0
22 #
33 # For a description of the syntax of this configuration file,
4
-# see Documentation/kbuild/kconfig-language.txt.
4
+# see Documentation/kbuild/kconfig-language.rst.
55 #
66 # Auxiliary display drivers configuration.
77 #
88 
99 menuconfig AUXDISPLAY
1010 	bool "Auxiliary Display support"
11
-	---help---
11
+	help
1212 	  Say Y here to get to see options for auxiliary display drivers.
1313 	  This option alone does not add any kernel code.
1414 
....@@ -20,7 +20,7 @@
2020 	tristate "HD44780 Character LCD support"
2121 	depends on GPIOLIB || COMPILE_TEST
2222 	select CHARLCD
23
-	---help---
23
+	help
2424 	  Enable support for Character LCDs using a HD44780 controller.
2525 	  The LCD is accessible through the /dev/lcd char device (10, 156).
2626 	  This code can either be compiled as a module, or linked into the
....@@ -31,7 +31,7 @@
3131 	tristate "KS0108 LCD Controller"
3232 	depends on PARPORT_PC
3333 	default n
34
-	---help---
34
+	help
3535 	  If you have a LCD controlled by one or more KS0108
3636 	  controllers, say Y. You will need also another more specific
3737 	  driver for your LCD.
....@@ -49,7 +49,7 @@
4949 	hex "Parallel port where the LCD is connected"
5050 	depends on KS0108
5151 	default 0x378
52
-	---help---
52
+	help
5353 	  The address of the parallel port where the LCD is connected.
5454 
5555 	  The first  standard parallel port address is 0x378.
....@@ -71,7 +71,7 @@
7171 	int "Delay between each control writing (microseconds)"
7272 	depends on KS0108
7373 	default "2"
74
-	---help---
74
+	help
7575 	  Amount of time the ks0108 should wait between each control write
7676 	  to the parallel port.
7777 
....@@ -92,12 +92,12 @@
9292 	select FB_SYS_IMAGEBLIT
9393 	select FB_SYS_FOPS
9494 	default n
95
-	---help---
95
+	help
9696 	  If you have a Crystalfontz 128x64 2-color LCD, cfag12864b Series,
9797 	  say Y. You also need the ks0108 LCD Controller driver.
9898 
9999 	  For help about how to wire your LCD to the parallel port,
100
-	  check Documentation/auxdisplay/cfag12864b
100
+	  check Documentation/admin-guide/auxdisplay/cfag12864b.rst
101101 
102102 	  Depends on the x86 arch and the framebuffer support.
103103 
....@@ -111,10 +111,10 @@
111111 	  If unsure, say N.
112112 
113113 config CFAG12864B_RATE
114
-       int "Refresh rate (hertz)"
114
+	int "Refresh rate (hertz)"
115115 	depends on CFAG12864B
116116 	default "20"
117
-	---help---
117
+	help
118118 	  Refresh rate of the LCD.
119119 
120120 	  As the LCD is not memory mapped, the driver has to make the work by
....@@ -164,13 +164,11 @@
164164 	  line and the Linux version on the second line, but that's
165165 	  still useful.
166166 
167
-endif # AUXDISPLAY
168
-
169
-menuconfig PANEL
167
+menuconfig PARPORT_PANEL
170168 	tristate "Parallel port LCD/Keypad Panel support"
171169 	depends on PARPORT
172170 	select CHARLCD
173
-	---help---
171
+	help
174172 	  Say Y here if you have an HD44780 or KS-0074 LCD connected to your
175173 	  parallel port. This driver also features 4 and 6-key keypads. The LCD
176174 	  is accessible through the /dev/lcd char device (10, 156), and the
....@@ -178,13 +176,13 @@
178176 	  compiled as a module, or linked into the kernel and started at boot.
179177 	  If you don't understand what all this is about, say N.
180178 
181
-if PANEL
179
+if PARPORT_PANEL
182180 
183181 config PANEL_PARPORT
184182 	int "Default parallel port number (0=LPT1)"
185183 	range 0 255
186184 	default "0"
187
-	---help---
185
+	help
188186 	  This is the index of the parallel port the panel is connected to. One
189187 	  driver instance only supports one parallel port, so if your keypad
190188 	  and LCD are connected to two separate ports, you have to start two
....@@ -195,7 +193,7 @@
195193 	int "Default panel profile (0-5, 0=custom)"
196194 	range 0 5
197195 	default "5"
198
-	---help---
196
+	help
199197 	  To ease configuration, the driver supports different configuration
200198 	  profiles for past and recent wirings. These profiles can also be
201199 	  used to define an approximative configuration, completed by a few
....@@ -217,7 +215,7 @@
217215 	int "Keypad type (0=none, 1=old 6 keys, 2=new 6 keys, 3=Nexcom 4 keys)"
218216 	range 0 3
219217 	default 0
220
-	---help---
218
+	help
221219 	  This enables and configures a keypad connected to the parallel port.
222220 	  The keys will be read from character device 10,185. Valid values are :
223221 
....@@ -234,7 +232,7 @@
234232 	int "LCD type (0=none, 1=custom, 2=old //, 3=ks0074, 4=hantronix, 5=Nexcom)"
235233 	range 0 5
236234 	default 0
237
-	---help---
235
+	help
238236 	   This enables and configures an LCD connected to the parallel port.
239237 	   The driver includes an interpreter for escape codes starting with
240238 	   '\e[L' which are specific to the LCD, and a few ANSI codes. The
....@@ -257,7 +255,7 @@
257255 	int "Number of lines on the LCD (1-2)"
258256 	range 1 2
259257 	default 2
260
-	---help---
258
+	help
261259 	  This is the number of visible character lines on the LCD in custom profile.
262260 	  It can either be 1 or 2.
263261 
....@@ -266,7 +264,7 @@
266264 	int "Number of characters per line on the LCD (1-40)"
267265 	range 1 40
268266 	default 40
269
-	---help---
267
+	help
270268 	  This is the number of characters per line on the LCD in custom profile.
271269 	  Common values are 16,20,24,40.
272270 
....@@ -275,7 +273,7 @@
275273 	int "Internal LCD line width (1-40, 40 by default)"
276274 	range 1 40
277275 	default 40
278
-	---help---
276
+	help
279277 	  Most LCDs use a standard controller which supports hardware lines of 40
280278 	  characters, although sometimes only 16, 20 or 24 of them are really wired
281279 	  to the terminal. This results in some non-visible but addressable characters,
....@@ -291,7 +289,7 @@
291289 	int "Hardware LCD line width (1-64, 64 by default)"
292290 	range 1 64
293291 	default 64
294
-	---help---
292
+	help
295293 	  Most LCDs use a single address bit to differentiate line 0 and line 1. Since
296294 	  some of them need to be able to address 40 chars with the lower bits, they
297295 	  often use the immediately superior power of 2, which is 64, to address the
....@@ -305,7 +303,7 @@
305303 	int "LCD character set (0=normal, 1=KS0074)"
306304 	range 0 1
307305 	default 0
308
-	---help---
306
+	help
309307 	  Some controllers such as the KS0074 use a somewhat strange character set
310308 	  where many symbols are at unusual places. The driver knows how to map
311309 	  'standard' ASCII characters to the character sets used by these controllers.
....@@ -321,7 +319,7 @@
321319 	int "LCD communication mode (0=parallel 8 bits, 1=serial)"
322320 	range 0 1
323321 	default 0
324
-	---help---
322
+	help
325323 	  This driver now supports any serial or parallel LCD wired to a parallel
326324 	  port. But before assigning signals, the driver needs to know if it will
327325 	  be driving a serial LCD or a parallel one. Serial LCDs only use 2 wires
....@@ -331,10 +329,10 @@
331329 
332330 config PANEL_LCD_PIN_E
333331 	depends on PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO="0"
334
-        int "Parallel port pin number & polarity connected to the LCD E signal (-17...17) "
332
+	int "Parallel port pin number & polarity connected to the LCD E signal (-17...17) "
335333 	range -17 17
336334 	default 14
337
-	---help---
335
+	help
338336 	  This describes the number of the parallel port pin to which the LCD 'E'
339337 	  signal has been connected. It can be :
340338 
....@@ -346,10 +344,10 @@
346344 
347345 config PANEL_LCD_PIN_RS
348346 	depends on PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO="0"
349
-        int "Parallel port pin number & polarity connected to the LCD RS signal (-17...17) "
347
+	int "Parallel port pin number & polarity connected to the LCD RS signal (-17...17) "
350348 	range -17 17
351349 	default 17
352
-	---help---
350
+	help
353351 	  This describes the number of the parallel port pin to which the LCD 'RS'
354352 	  signal has been connected. It can be :
355353 
....@@ -361,10 +359,10 @@
361359 
362360 config PANEL_LCD_PIN_RW
363361 	depends on PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO="0"
364
-        int "Parallel port pin number & polarity connected to the LCD RW signal (-17...17) "
362
+	int "Parallel port pin number & polarity connected to the LCD RW signal (-17...17) "
365363 	range -17 17
366364 	default 16
367
-	---help---
365
+	help
368366 	  This describes the number of the parallel port pin to which the LCD 'RW'
369367 	  signal has been connected. It can be :
370368 
....@@ -376,10 +374,10 @@
376374 
377375 config PANEL_LCD_PIN_SCL
378376 	depends on PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO!="0"
379
-        int "Parallel port pin number & polarity connected to the LCD SCL signal (-17...17) "
377
+	int "Parallel port pin number & polarity connected to the LCD SCL signal (-17...17) "
380378 	range -17 17
381379 	default 1
382
-	---help---
380
+	help
383381 	  This describes the number of the parallel port pin to which the serial
384382 	  LCD 'SCL' signal has been connected. It can be :
385383 
....@@ -391,10 +389,10 @@
391389 
392390 config PANEL_LCD_PIN_SDA
393391 	depends on PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO!="0"
394
-        int "Parallel port pin number & polarity connected to the LCD SDA signal (-17...17) "
392
+	int "Parallel port pin number & polarity connected to the LCD SDA signal (-17...17) "
395393 	range -17 17
396394 	default 2
397
-	---help---
395
+	help
398396 	  This describes the number of the parallel port pin to which the serial
399397 	  LCD 'SDA' signal has been connected. It can be :
400398 
....@@ -406,12 +404,12 @@
406404 
407405 config PANEL_LCD_PIN_BL
408406 	depends on PANEL_PROFILE="0" && PANEL_LCD="1"
409
-        int "Parallel port pin number & polarity connected to the LCD backlight signal (-17...17) "
407
+	int "Parallel port pin number & polarity connected to the LCD backlight signal (-17...17) "
410408 	range -17 17
411409 	default 0
412
-	---help---
410
+	help
413411 	  This describes the number of the parallel port pin to which the LCD 'BL' signal
414
-          has been connected. It can be :
412
+	  has been connected. It can be :
415413 
416414 	          0 : no connection (eg: connected to ground)
417415 	      1..17 : directly connected to any of these pins on the DB25 plug
....@@ -419,10 +417,13 @@
419417 
420418 	  Default for the 'BL' pin in custom profile is '0' (uncontrolled).
421419 
420
+endif # PARPORT_PANEL
421
+
422422 config PANEL_CHANGE_MESSAGE
423423 	bool "Change LCD initialization message ?"
424
+	depends on CHARLCD
424425 	default "n"
425
-	---help---
426
+	help
426427 	  This allows you to replace the boot message indicating the kernel version
427428 	  and the driver version with a custom message. This is useful on appliances
428429 	  where a simple 'Starting system' message can be enough to stop a customer
....@@ -435,7 +436,7 @@
435436 	depends on PANEL_CHANGE_MESSAGE="y"
436437 	string "New initialization message"
437438 	default ""
438
-	---help---
439
+	help
439440 	  This allows you to replace the boot message indicating the kernel version
440441 	  and the driver version with a custom message. This is useful on appliances
441442 	  where a simple 'Starting system' message can be enough to stop a customer
....@@ -444,7 +445,39 @@
444445 	  An empty message will only clear the display at driver init time. Any other
445446 	  printf()-formatted message is valid with newline and escape codes.
446447 
447
-endif # PANEL
448
+choice
449
+	prompt "Backlight initial state"
450
+	default CHARLCD_BL_FLASH
451
+	help
452
+	  Select the initial backlight state on boot or module load.
453
+
454
+	  Previously, there was no option for this: the backlight flashed
455
+	  briefly on init. Now you can also turn it off/on.
456
+
457
+	config CHARLCD_BL_OFF
458
+		bool "Off"
459
+		help
460
+		  Backlight is initially turned off
461
+
462
+	config CHARLCD_BL_ON
463
+		bool "On"
464
+		help
465
+		  Backlight is initially turned on
466
+
467
+	config CHARLCD_BL_FLASH
468
+		bool "Flash"
469
+		help
470
+		  Backlight is flashed briefly on init
471
+
472
+endchoice
473
+
474
+endif # AUXDISPLAY
475
+
476
+config PANEL
477
+	tristate "Parallel port LCD/Keypad Panel support (OLD OPTION)"
478
+	depends on PARPORT
479
+	select AUXDISPLAY
480
+	select PARPORT_PANEL
448481 
449482 config CHARLCD
450483 	tristate "Character LCD core support" if COMPILE_TEST