| config PANEL |
| tristate "Parallel port LCD/Keypad Panel support" |
| depends on PARPORT |
| ---help--- |
| Say Y here if you have an HD44780 or KS-0074 LCD connected to your |
| parallel port. This driver also features 4 and 6-key keypads. The LCD |
| is accessible through the /dev/lcd char device (10, 156), and the |
| keypad through /dev/keypad (10, 185). Both require misc device to be |
| enabled. This code can either be compiled as a module, or linked into |
| the kernel and started at boot. If you don't understand what all this |
| is about, say N. |
| |
| config PANEL_PARPORT |
| int "Default parallel port number (0=LPT1)" |
| depends on PANEL |
| range 0 255 |
| default "0" |
| ---help--- |
| This is the index of the parallel port the panel is connected to. One |
| driver instance only supports one parallel port, so if your keypad |
| and LCD are connected to two separate ports, you have to start two |
| modules with different arguments. Numbering starts with '0' for LPT1, |
| and so on. |
| |
| config PANEL_PROFILE |
| int "Default panel profile (0-5, 0=custom)" |
| depends on PANEL |
| range 0 5 |
| default "5" |
| ---help--- |
| To ease configuration, the driver supports different configuration |
| profiles for past and recent wirings. These profiles can also be |
| used to define an approximative configuration, completed by a few |
| other options. Here are the profiles : |
| |
| 0 = custom (see further) |
| 1 = 2x16 parallel LCD, old keypad |
| 2 = 2x16 serial LCD (KS-0074), new keypad |
| 3 = 2x16 parallel LCD (Hantronix), no keypad |
| 4 = 2x16 parallel LCD (Nexcom NSA1045) with Nexcom's keypad |
| 5 = 2x40 parallel LCD (old one), with old keypad |
| |
| Custom configurations allow you to define how your display is |
| wired to the parallel port, and how it works. This is only intended |
| for experts. |
| |
| config PANEL_KEYPAD |
| depends on PANEL && PANEL_PROFILE="0" |
| int "Keypad type (0=none, 1=old 6 keys, 2=new 6 keys, 3=Nexcom 4 keys)" |
| range 0 3 |
| default 0 |
| ---help--- |
| This enables and configures a keypad connected to the parallel port. |
| The keys will be read from character device 10,185. Valid values are : |
| |
| 0 : do not enable this driver |
| 1 : old 6 keys keypad |
| 2 : new 6 keys keypad, as used on the server at www.ant-computing.com |
| 3 : Nexcom NSA1045's 4 keys keypad |
| |
| New profiles can be described in the driver source. The driver also |
| supports simultaneous keys pressed when the keypad supports them. |
| |
| config PANEL_LCD |
| depends on PANEL && PANEL_PROFILE="0" |
| int "LCD type (0=none, 1=custom, 2=old //, 3=ks0074, 4=hantronix, 5=Nexcom)" |
| range 0 5 |
| default 0 |
| ---help--- |
| This enables and configures an LCD connected to the parallel port. |
| The driver includes an interpreter for escape codes starting with |
| '\e[L' which are specific to the LCD, and a few ANSI codes. The |
| driver will be registered as character device 10,156, usually |
| under the name '/dev/lcd'. There are a total of 6 supported types : |
| |
| 0 : do not enable the driver |
| 1 : custom configuration and wiring (see further) |
| 2 : 2x16 & 2x40 parallel LCD (old wiring) |
| 3 : 2x16 serial LCD (KS-0074 based) |
| 4 : 2x16 parallel LCD (Hantronix wiring) |
| 5 : 2x16 parallel LCD (Nexcom wiring) |
| |
| When type '1' is specified, other options will appear to configure |
| more precise aspects (wiring, dimensions, protocol, ...). Please note |
| that those values changed from the 2.4 driver for better consistency. |
| |
| config PANEL_LCD_HEIGHT |
| depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" |
| int "Number of lines on the LCD (1-2)" |
| range 1 2 |
| default 2 |
| ---help--- |
| This is the number of visible character lines on the LCD in custom profile. |
| It can either be 1 or 2. |
| |
| config PANEL_LCD_WIDTH |
| depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" |
| int "Number of characters per line on the LCD (1-40)" |
| range 1 40 |
| default 40 |
| ---help--- |
| This is the number of characters per line on the LCD in custom profile. |
| Common values are 16,20,24,40. |
| |
| config PANEL_LCD_BWIDTH |
| depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" |
| int "Internal LCD line width (1-40, 40 by default)" |
| range 1 40 |
| default 40 |
| ---help--- |
| Most LCDs use a standard controller which supports hardware lines of 40 |
| characters, although sometimes only 16, 20 or 24 of them are really wired |
| to the terminal. This results in some non-visible but addressable characters, |
| and is the case for most parallel LCDs. Other LCDs, and some serial ones, |
| however, use the same line width internally as what is visible. The KS0074 |
| for example, uses 16 characters per line for 16 visible characters per line. |
| |
| This option lets you configure the value used by your LCD in 'custom' profile. |
| If you don't know, put '40' here. |
| |
| config PANEL_LCD_HWIDTH |
| depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" |
| int "Hardware LCD line width (1-64, 64 by default)" |
| range 1 64 |
| default 64 |
| ---help--- |
| Most LCDs use a single address bit to differentiate line 0 and line 1. Since |
| some of them need to be able to address 40 chars with the lower bits, they |
| often use the immediately superior power of 2, which is 64, to address the |
| next line. |
| |
| If you don't know what your LCD uses, in doubt let 16 here for a 2x16, and |
| 64 here for a 2x40. |
| |
| config PANEL_LCD_CHARSET |
| depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" |
| int "LCD character set (0=normal, 1=KS0074)" |
| range 0 1 |
| default 0 |
| ---help--- |
| Some controllers such as the KS0074 use a somewhat strange character set |
| where many symbols are at unusual places. The driver knows how to map |
| 'standard' ASCII characters to the character sets used by these controllers. |
| Valid values are : |
| |
| 0 : normal (untranslated) character set |
| 1 : KS0074 character set |
| |
| If you don't know, use the normal one (0). |
| |
| config PANEL_LCD_PROTO |
| depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" |
| int "LCD communication mode (0=parallel 8 bits, 1=serial)" |
| range 0 1 |
| default 0 |
| ---help--- |
| This driver now supports any serial or parallel LCD wired to a parallel |
| port. But before assigning signals, the driver needs to know if it will |
| be driving a serial LCD or a parallel one. Serial LCDs only use 2 wires |
| (SDA/SCL), while parallel ones use 2 or 3 wires for the control signals |
| (E, RS, sometimes RW), and 4 or 8 for the data. Use 0 here for a 8 bits |
| parallel LCD, and 1 for a serial LCD. |
| |
| config PANEL_LCD_PIN_E |
| depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO="0" |
| int "Parallel port pin number & polarity connected to the LCD E signal (-17...17) " |
| range -17 17 |
| default 14 |
| ---help--- |
| This describes the number of the parallel port pin to which the LCD 'E' |
| signal has been connected. It can be : |
| |
| 0 : no connection (eg: connected to ground) |
| 1..17 : directly connected to any of these pins on the DB25 plug |
| -1..-17 : connected to the same pin through an inverter (eg: transistor). |
| |
| Default for the 'E' pin in custom profile is '14' (AUTOFEED). |
| |
| config PANEL_LCD_PIN_RS |
| depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO="0" |
| int "Parallel port pin number & polarity connected to the LCD RS signal (-17...17) " |
| range -17 17 |
| default 17 |
| ---help--- |
| This describes the number of the parallel port pin to which the LCD 'RS' |
| signal has been connected. It can be : |
| |
| 0 : no connection (eg: connected to ground) |
| 1..17 : directly connected to any of these pins on the DB25 plug |
| -1..-17 : connected to the same pin through an inverter (eg: transistor). |
| |
| Default for the 'RS' pin in custom profile is '17' (SELECT IN). |
| |
| config PANEL_LCD_PIN_RW |
| depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO="0" |
| int "Parallel port pin number & polarity connected to the LCD RW signal (-17...17) " |
| range -17 17 |
| default 16 |
| ---help--- |
| This describes the number of the parallel port pin to which the LCD 'RW' |
| signal has been connected. It can be : |
| |
| 0 : no connection (eg: connected to ground) |
| 1..17 : directly connected to any of these pins on the DB25 plug |
| -1..-17 : connected to the same pin through an inverter (eg: transistor). |
| |
| Default for the 'RW' pin in custom profile is '16' (INIT). |
| |
| config PANEL_LCD_PIN_SCL |
| depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO!="0" |
| int "Parallel port pin number & polarity connected to the LCD SCL signal (-17...17) " |
| range -17 17 |
| default 1 |
| ---help--- |
| This describes the number of the parallel port pin to which the serial |
| LCD 'SCL' signal has been connected. It can be : |
| |
| 0 : no connection (eg: connected to ground) |
| 1..17 : directly connected to any of these pins on the DB25 plug |
| -1..-17 : connected to the same pin through an inverter (eg: transistor). |
| |
| Default for the 'SCL' pin in custom profile is '1' (STROBE). |
| |
| config PANEL_LCD_PIN_SDA |
| depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" && PANEL_LCD_PROTO!="0" |
| int "Parallel port pin number & polarity connected to the LCD SDA signal (-17...17) " |
| range -17 17 |
| default 2 |
| ---help--- |
| This describes the number of the parallel port pin to which the serial |
| LCD 'SDA' signal has been connected. It can be : |
| |
| 0 : no connection (eg: connected to ground) |
| 1..17 : directly connected to any of these pins on the DB25 plug |
| -1..-17 : connected to the same pin through an inverter (eg: transistor). |
| |
| Default for the 'SDA' pin in custom profile is '2' (D0). |
| |
| config PANEL_LCD_PIN_BL |
| depends on PANEL && PANEL_PROFILE="0" && PANEL_LCD="1" |
| int "Parallel port pin number & polarity connected to the LCD backlight signal (-17...17) " |
| range -17 17 |
| default 0 |
| ---help--- |
| This describes the number of the parallel port pin to which the LCD 'BL' signal |
| has been connected. It can be : |
| |
| 0 : no connection (eg: connected to ground) |
| 1..17 : directly connected to any of these pins on the DB25 plug |
| -1..-17 : connected to the same pin through an inverter (eg: transistor). |
| |
| Default for the 'BL' pin in custom profile is '0' (uncontrolled). |
| |
| config PANEL_CHANGE_MESSAGE |
| depends on PANEL |
| bool "Change LCD initialization message ?" |
| default "n" |
| ---help--- |
| This allows you to replace the boot message indicating the kernel version |
| and the driver version with a custom message. This is useful on appliances |
| where a simple 'Starting system' message can be enough to stop a customer |
| from worrying. |
| |
| If you say 'Y' here, you'll be able to choose a message yourself. Otherwise, |
| say 'N' and keep the default message with the version. |
| |
| config PANEL_BOOT_MESSAGE |
| depends on PANEL && PANEL_CHANGE_MESSAGE="y" |
| string "New initialization message" |
| default "" |
| ---help--- |
| This allows you to replace the boot message indicating the kernel version |
| and the driver version with a custom message. This is useful on appliances |
| where a simple 'Starting system' message can be enough to stop a customer |
| from worrying. |
| |
| An empty message will only clear the display at driver init time. Any other |
| printf()-formatted message is valid with newline and escape codes. |
