Commit | Line | Data |
---|---|---|
7005b584 WT |
1 | config PANEL |
2 | tristate "Parallel port LCD/Keypad Panel support" | |
3 | depends on PARPORT | |
4 | ---help--- | |
5 | Say Y here if you have an HD44780 or KS-0074 LCD connected to your | |
63023177 WT |
6 | parallel port. This driver also features 4 and 6-key keypads. The LCD |
7 | is accessible through the /dev/lcd char device (10, 156), and the | |
8 | keypad through /dev/keypad (10, 185). Both require misc device to be | |
9 | enabled. This code can either be compiled as a module, or linked into | |
10 | the kernel and started at boot. If you don't understand what all this | |
11 | is about, say N. | |
7005b584 WT |
12 | |
13 | config PANEL_PARPORT | |
14 | int "Default parallel port number (0=LPT1)" | |
15 | depends on PANEL | |
16 | range 0 255 | |
17 | default "0" | |
18 | ---help--- | |
19 | This is the index of the parallel port the panel is connected to. One | |
20 | driver instance only supports one parallel port, so if your keypad | |
21 | and LCD are connected to two separate ports, you have to start two | |
22 | modules with different arguments. Numbering starts with '0' for LPT1, | |
23 | and so on. | |
24 | ||
25 | config PANEL_PROFILE | |
26 | int "Default panel profile (0-5, 0=custom)" | |
27 | depends on PANEL | |
28 | range 0 5 | |
29 | default "5" | |
30 | ---help--- | |
31 | To ease configuration, the driver supports different configuration | |
32 | profiles for past and recent wirings. These profiles can also be | |
33 | used to define an approximative configuration, completed by a few | |
34 | other options. Here are the profiles : | |
35 | ||
36 | 0 = custom (see further) | |
37 | 1 = 2x16 parallel LCD, old keypad | |
38 | 2 = 2x16 serial LCD (KS-0074), new keypad | |
39 | 3 = 2x16 parallel LCD (Hantronix), no keypad | |
40 | 4 = 2x16 parallel LCD (Nexcom NSA1045) with Nexcom's keypad | |
41 | 5 = 2x40 parallel LCD (old one), with old keypad | |
42 | ||
43 | Custom configurations allow you to define how your display is | |
44 | wired to the parallel port, and how it works. This is only intended | |
45 | for experts. | |
46 | ||
7005b584 WT |
47 | config PANEL_KEYPAD |
48 | depends on PANEL && PANEL_PROFILE="0" | |
49 | int "Keypad type (0=none, 1=old 6 keys, 2=new 6 keys, 3=Nexcom 4 keys)" | |
ae08961a | 50 | range 0 3 |
7005b584 WT |
51 | default 0 |
52 | ---help--- | |
53 | This enables and configures a keypad connected to the parallel port. | |
54 | The keys will be read from character device 10,185. Valid values are : | |
55 | ||
56 | 0 : do not enable this driver | |
57 | 1 : old 6 keys keypad | |
58 | 2 : new 6 keys keypad, as used on the server at www.ant-computing.com | |
59 | 3 : Nexcom NSA1045's 4 keys keypad | |
60 | ||
61 | New profiles can be described in the driver source. The driver also | |
62 | supports simultaneous keys pressed when the keypad supports them. | |
63 | ||
64 | config PANEL_LCD | |
65 | depends on PANEL && PANEL_PROFILE="0" | |
66 | int "LCD type (0=none, 1=custom, 2=old //, 3=ks0074, 4=hantronix, 5=Nexcom)" | |
67 | range 0 5 | |
68 | default 0 | |
69 | ---help--- | |
70 | This enables and configures an LCD connected to the parallel port. | |
71 | The driver includes an interpreter for escape codes starting with | |
72 | '\e[L' which are specific to the LCD, and a few ANSI codes. The | |
73 | driver will be registered as character device 10,156, usually | |
74 | under the name '/dev/lcd'. There are a total of 6 supported types : | |
75 | ||
76 | 0 : do not enable the driver | |
77 | 1 : custom configuration and wiring (see further) | |
78 | 2 : 2x16 & 2x40 parallel LCD (old wiring) | |
79 | 3 : 2x16 serial LCD (KS-0074 based) | |
80 | 4 : 2x16 parallel LCD (Hantronix wiring) | |
81 | 5 : 2x16 parallel LCD (Nexcom wiring) | |
82 | ||
83 | When type '1' is specified, other options will appear to configure | |
84 | more precise aspects (wiring, dimensions, protocol, ...). Please note | |
85 | that those values changed from the 2.4 driver for better consistency. | |
86 | ||
87 | config PANEL_LCD_HEIGHT | |
88 | depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" | |
89 | int "Number of lines on the LCD (1-2)" | |
90 | range 1 2 | |
91 | default 2 | |
92 | ---help--- | |
93 | This is the number of visible character lines on the LCD in custom profile. | |
94 | It can either be 1 or 2. | |
95 | ||
96 | config PANEL_LCD_WIDTH | |
97 | depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" | |
98 | int "Number of characters per line on the LCD (1-40)" | |
99 | range 1 40 | |
100 | default 40 | |
101 | ---help--- | |
102 | This is the number of characters per line on the LCD in custom profile. | |
103 | Common values are 16,20,24,40. | |
104 | ||
105 | config PANEL_LCD_BWIDTH | |
106 | depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" | |
107 | int "Internal LCD line width (1-40, 40 by default)" | |
108 | range 1 40 | |
109 | default 40 | |
110 | ---help--- | |
111 | Most LCDs use a standard controller which supports hardware lines of 40 | |
112 | characters, although sometimes only 16, 20 or 24 of them are really wired | |
692105b8 | 113 | to the terminal. This results in some non-visible but addressable characters, |
7005b584 WT |
114 | and is the case for most parallel LCDs. Other LCDs, and some serial ones, |
115 | however, use the same line width internally as what is visible. The KS0074 | |
116 | for example, uses 16 characters per line for 16 visible characters per line. | |
117 | ||
118 | This option lets you configure the value used by your LCD in 'custom' profile. | |
119 | If you don't know, put '40' here. | |
120 | ||
121 | config PANEL_LCD_HWIDTH | |
122 | depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" | |
123 | int "Hardware LCD line width (1-64, 64 by default)" | |
124 | range 1 64 | |
125 | default 64 | |
126 | ---help--- | |
127 | Most LCDs use a single address bit to differentiate line 0 and line 1. Since | |
128 | some of them need to be able to address 40 chars with the lower bits, they | |
129 | often use the immediately superior power of 2, which is 64, to address the | |
130 | next line. | |
131 | ||
132 | If you don't know what your LCD uses, in doubt let 16 here for a 2x16, and | |
133 | 64 here for a 2x40. | |
134 | ||
135 | config PANEL_LCD_CHARSET | |
136 | depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" | |
137 | int "LCD character set (0=normal, 1=KS0074)" | |
138 | range 0 1 | |
139 | default 0 | |
140 | ---help--- | |
141 | Some controllers such as the KS0074 use a somewhat strange character set | |
142 | where many symbols are at unusual places. The driver knows how to map | |
143 | 'standard' ASCII characters to the character sets used by these controllers. | |
144 | Valid values are : | |
145 | ||
146 | 0 : normal (untranslated) character set | |
147 | 1 : KS0074 character set | |
148 | ||
149 | If you don't know, use the normal one (0). | |
150 | ||
151 | config PANEL_LCD_PROTO | |
152 | depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" | |
153 | int "LCD communication mode (0=parallel 8 bits, 1=serial)" | |
154 | range 0 1 | |
155 | default 0 | |
156 | ---help--- | |
157 | This driver now supports any serial or parallel LCD wired to a parallel | |
158 | port. But before assigning signals, the driver needs to know if it will | |
159 | be driving a serial LCD or a parallel one. Serial LCDs only use 2 wires | |
160 | (SDA/SCL), while parallel ones use 2 or 3 wires for the control signals | |
161 | (E, RS, sometimes RW), and 4 or 8 for the data. Use 0 here for a 8 bits | |
162 | parallel LCD, and 1 for a serial LCD. | |
163 | ||
164 | config PANEL_LCD_PIN_E | |
165 | depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO="0" | |
166 | int "Parallel port pin number & polarity connected to the LCD E signal (-17...17) " | |
167 | range -17 17 | |
168 | default 14 | |
169 | ---help--- | |
170 | This describes the number of the parallel port pin to which the LCD 'E' | |
171 | signal has been connected. It can be : | |
172 | ||
173 | 0 : no connection (eg: connected to ground) | |
174 | 1..17 : directly connected to any of these pins on the DB25 plug | |
175 | -1..-17 : connected to the same pin through an inverter (eg: transistor). | |
176 | ||
177 | Default for the 'E' pin in custom profile is '14' (AUTOFEED). | |
178 | ||
179 | config PANEL_LCD_PIN_RS | |
180 | depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO="0" | |
181 | int "Parallel port pin number & polarity connected to the LCD RS signal (-17...17) " | |
182 | range -17 17 | |
183 | default 17 | |
184 | ---help--- | |
185 | This describes the number of the parallel port pin to which the LCD 'RS' | |
186 | signal has been connected. It can be : | |
187 | ||
188 | 0 : no connection (eg: connected to ground) | |
189 | 1..17 : directly connected to any of these pins on the DB25 plug | |
190 | -1..-17 : connected to the same pin through an inverter (eg: transistor). | |
191 | ||
192 | Default for the 'RS' pin in custom profile is '17' (SELECT IN). | |
193 | ||
194 | config PANEL_LCD_PIN_RW | |
195 | depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO="0" | |
196 | int "Parallel port pin number & polarity connected to the LCD RW signal (-17...17) " | |
197 | range -17 17 | |
198 | default 16 | |
199 | ---help--- | |
200 | This describes the number of the parallel port pin to which the LCD 'RW' | |
201 | signal has been connected. It can be : | |
202 | ||
203 | 0 : no connection (eg: connected to ground) | |
204 | 1..17 : directly connected to any of these pins on the DB25 plug | |
205 | -1..-17 : connected to the same pin through an inverter (eg: transistor). | |
206 | ||
207 | Default for the 'RW' pin in custom profile is '16' (INIT). | |
208 | ||
209 | config PANEL_LCD_PIN_SCL | |
210 | depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO!="0" | |
211 | int "Parallel port pin number & polarity connected to the LCD SCL signal (-17...17) " | |
212 | range -17 17 | |
213 | default 1 | |
214 | ---help--- | |
215 | This describes the number of the parallel port pin to which the serial | |
216 | LCD 'SCL' signal has been connected. It can be : | |
217 | ||
218 | 0 : no connection (eg: connected to ground) | |
219 | 1..17 : directly connected to any of these pins on the DB25 plug | |
220 | -1..-17 : connected to the same pin through an inverter (eg: transistor). | |
221 | ||
222 | Default for the 'SCL' pin in custom profile is '1' (STROBE). | |
223 | ||
224 | config PANEL_LCD_PIN_SDA | |
225 | depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO!="0" | |
226 | int "Parallel port pin number & polarity connected to the LCD SDA signal (-17...17) " | |
227 | range -17 17 | |
228 | default 2 | |
229 | ---help--- | |
230 | This describes the number of the parallel port pin to which the serial | |
231 | LCD 'SDA' signal has been connected. It can be : | |
232 | ||
233 | 0 : no connection (eg: connected to ground) | |
234 | 1..17 : directly connected to any of these pins on the DB25 plug | |
235 | -1..-17 : connected to the same pin through an inverter (eg: transistor). | |
236 | ||
237 | Default for the 'SDA' pin in custom profile is '2' (D0). | |
238 | ||
239 | config PANEL_LCD_PIN_BL | |
240 | depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" | |
241 | int "Parallel port pin number & polarity connected to the LCD backlight signal (-17...17) " | |
242 | range -17 17 | |
243 | default 0 | |
244 | ---help--- | |
245 | This describes the number of the parallel port pin to which the LCD 'BL' signal | |
246 | has been connected. It can be : | |
247 | ||
248 | 0 : no connection (eg: connected to ground) | |
249 | 1..17 : directly connected to any of these pins on the DB25 plug | |
250 | -1..-17 : connected to the same pin through an inverter (eg: transistor). | |
251 | ||
252 | Default for the 'BL' pin in custom profile is '0' (uncontrolled). | |
253 | ||
254 | config PANEL_CHANGE_MESSAGE | |
255 | depends on PANEL | |
256 | bool "Change LCD initialization message ?" | |
257 | default "n" | |
258 | ---help--- | |
259 | This allows you to replace the boot message indicating the kernel version | |
260 | and the driver version with a custom message. This is useful on appliances | |
261 | where a simple 'Starting system' message can be enough to stop a customer | |
262 | from worrying. | |
263 | ||
264 | If you say 'Y' here, you'll be able to choose a message yourself. Otherwise, | |
265 | say 'N' and keep the default message with the version. | |
266 | ||
267 | config PANEL_BOOT_MESSAGE | |
268 | depends on PANEL && PANEL_CHANGE_MESSAGE="y" | |
269 | string "New initialization message" | |
270 | default "" | |
271 | ---help--- | |
272 | This allows you to replace the boot message indicating the kernel version | |
273 | and the driver version with a custom message. This is useful on appliances | |
274 | where a simple 'Starting system' message can be enough to stop a customer | |
275 | from worrying. | |
276 | ||
277 | An empty message will only clear the display at driver init time. Any other | |
278 | printf()-formatted message is valid with newline and escape codes. |