7  * This code drives an LCD module (/dev/lcd), and a keypad (/dev/keypad)
10  * The LCD module may either be an HD44780-like 8-bit parallel LCD, or a 1-bit
18  * Several profiles are provided for commonly found LCD+keypad modules on the
27  *      - make the LCD a part of a virtual screen of Vx*Vy
198 /* lcd-specific variables */
217 } lcd;  variable
223  * Bit masks to convert LCD signals to parallel port outputs.
232  * one entry for each bit on the LCD
252  * LCD protocols
259  * LCD character sets
265  * LCD types
408 MODULE_DESCRIPTION("Generic parallel port LCD/Keypad driver");
428 		 "LCD type: 0=none, 1=compiled-in, 2=old, 3=serial ks0074, 4=hantronix, 5=nexcom");
432 MODULE_PARM_DESC(lcd_height, "Number of lines on the LCD");
436 MODULE_PARM_DESC(lcd_width, "Number of columns on the LCD");
440 MODULE_PARM_DESC(lcd_bwidth, "Internal LCD line width (40)");
444 MODULE_PARM_DESC(lcd_hwidth, "LCD line hardware address (64)");
448 MODULE_PARM_DESC(lcd_charset, "LCD character set: 0=standard, 1=KS0074");
453 		 "LCD communication: 0=parallel (//), 1=serial, 2=TI LCD Interface");
456  * These are the parallel port pins the LCD control signals are connected to.
467 		 "# of the // port pin connected to LCD 'E' signal, with polarity (-17..17)");
472 		 "# of the // port pin connected to LCD 'RS' signal, with polarity (-17..17)");
477 		 "# of the // port pin connected to LCD 'RW' signal, with polarity (-17..17)");
482 		 "# of the // port pin connected to serial LCD 'SCL' signal, with polarity (-17..17)");
487 		 "# of the // port pin connected to serial LCD 'SDA' signal, with polarity (-17..17)");
492 		 "# of the // port pin connected to LCD backlight, with polarity (-17..17)");
504 /* for some LCD drivers (ks0074) we need a charset conversion table. */
681  * send a serial byte to the LCD panel. The caller is responsible for locking
690 	 * LCD reads D0 on STROBE's rising edge.  in lcd_send_serial()
713 	if (lcd.pins.bl == PIN_NONE)  in lcd_backlight()
726 /* send a command to the LCD panel in serial mode */
737 /* send data to the LCD panel in serial mode */
748 /* send a command to the LCD panel in 8 bits parallel mode */
770 /* send data to the LCD panel in 8 bits parallel mode */
792 /* send a command to the TI LCD panel */
802 /* send data to the TI LCD panel */
894 /* initialize the LCD driver */
904 	 * Init lcd struct with load-time values to preserve exact  in lcd_init()
915 		lcd.proto = LCD_PROTO_PARALLEL;  in lcd_init()
916 		lcd.charset = LCD_CHARSET_NORMAL;  in lcd_init()
917 		lcd.pins.e = PIN_STROBE;  in lcd_init()
918 		lcd.pins.rs = PIN_AUTOLF;  in lcd_init()
927 		lcd.proto = LCD_PROTO_SERIAL;  in lcd_init()
928 		lcd.charset = LCD_CHARSET_KS0074;  in lcd_init()
929 		lcd.pins.bl = PIN_AUTOLF;  in lcd_init()
930 		lcd.pins.cl = PIN_STROBE;  in lcd_init()
931 		lcd.pins.da = PIN_D0;  in lcd_init()
940 		lcd.proto = LCD_PROTO_PARALLEL;  in lcd_init()
941 		lcd.charset = LCD_CHARSET_NORMAL;  in lcd_init()
942 		lcd.pins.e = PIN_AUTOLF;  in lcd_init()
943 		lcd.pins.rs = PIN_SELECP;  in lcd_init()
944 		lcd.pins.rw = PIN_INITP;  in lcd_init()
953 		lcd.proto = DEFAULT_LCD_PROTO;  in lcd_init()
954 		lcd.charset = DEFAULT_LCD_CHARSET;  in lcd_init()
960 		lcd.proto = LCD_PROTO_PARALLEL;  in lcd_init()
961 		lcd.charset = LCD_CHARSET_NORMAL;  in lcd_init()
962 		lcd.pins.e = PIN_STROBE;  in lcd_init()
963 		lcd.pins.rs = PIN_SELECP;  in lcd_init()
982 		lcd.charset = lcd_charset;  in lcd_init()
984 		lcd.proto = lcd_proto;  in lcd_init()
986 		lcd.pins.e = lcd_e_pin;  in lcd_init()
988 		lcd.pins.rs = lcd_rs_pin;  in lcd_init()
990 		lcd.pins.rw = lcd_rw_pin;  in lcd_init()
992 		lcd.pins.cl = lcd_cl_pin;  in lcd_init()
994 		lcd.pins.da = lcd_da_pin;  in lcd_init()
996 		lcd.pins.bl = lcd_bl_pin;  in lcd_init()
1008 	if (lcd.proto == LCD_PROTO_SERIAL) {	/* SERIAL */  in lcd_init()
1011 		if (lcd.pins.cl == PIN_NOT_SET)  in lcd_init()
1012 			lcd.pins.cl = DEFAULT_LCD_PIN_SCL;  in lcd_init()
1013 		if (lcd.pins.da == PIN_NOT_SET)  in lcd_init()
1014 			lcd.pins.da = DEFAULT_LCD_PIN_SDA;  in lcd_init()
1016 	} else if (lcd.proto == LCD_PROTO_PARALLEL) {	/* PARALLEL */  in lcd_init()
1019 		if (lcd.pins.e == PIN_NOT_SET)  in lcd_init()
1020 			lcd.pins.e = DEFAULT_LCD_PIN_E;  in lcd_init()
1021 		if (lcd.pins.rs == PIN_NOT_SET)  in lcd_init()
1022 			lcd.pins.rs = DEFAULT_LCD_PIN_RS;  in lcd_init()
1023 		if (lcd.pins.rw == PIN_NOT_SET)  in lcd_init()
1024 			lcd.pins.rw = DEFAULT_LCD_PIN_RW;  in lcd_init()
1029 	if (lcd.pins.bl == PIN_NOT_SET)  in lcd_init()
1030 		lcd.pins.bl = DEFAULT_LCD_PIN_BL;  in lcd_init()
1032 	if (lcd.pins.e == PIN_NOT_SET)  in lcd_init()
1033 		lcd.pins.e = PIN_NONE;  in lcd_init()
1034 	if (lcd.pins.rs == PIN_NOT_SET)  in lcd_init()
1035 		lcd.pins.rs = PIN_NONE;  in lcd_init()
1036 	if (lcd.pins.rw == PIN_NOT_SET)  in lcd_init()
1037 		lcd.pins.rw = PIN_NONE;  in lcd_init()
1038 	if (lcd.pins.bl == PIN_NOT_SET)  in lcd_init()
1039 		lcd.pins.bl = PIN_NONE;  in lcd_init()
1040 	if (lcd.pins.cl == PIN_NOT_SET)  in lcd_init()
1041 		lcd.pins.cl = PIN_NONE;  in lcd_init()
1042 	if (lcd.pins.da == PIN_NOT_SET)  in lcd_init()
1043 		lcd.pins.da = PIN_NONE;  in lcd_init()
1045 	if (lcd.charset == NOT_SET)  in lcd_init()
1046 		lcd.charset = DEFAULT_LCD_CHARSET;  in lcd_init()
1048 	if (lcd.charset == LCD_CHARSET_KS0074)  in lcd_init()
1053 	pin_to_bits(lcd.pins.e, lcd_bits[LCD_PORT_D][LCD_BIT_E],  in lcd_init()
1055 	pin_to_bits(lcd.pins.rs, lcd_bits[LCD_PORT_D][LCD_BIT_RS],  in lcd_init()
1057 	pin_to_bits(lcd.pins.rw, lcd_bits[LCD_PORT_D][LCD_BIT_RW],  in lcd_init()
1059 	pin_to_bits(lcd.pins.bl, lcd_bits[LCD_PORT_D][LCD_BIT_BL],  in lcd_init()
1061 	pin_to_bits(lcd.pins.cl, lcd_bits[LCD_PORT_D][LCD_BIT_CL],  in lcd_init()
1063 	pin_to_bits(lcd.pins.da, lcd_bits[LCD_PORT_D][LCD_BIT_DA],  in lcd_init()
1066 	lcd.charlcd = charlcd;  in lcd_init()
1067 	lcd.initialized = true;  in lcd_init()
1406 	if (keypressed && lcd.enabled && lcd.initialized)  in panel_scan_timer()
1407 		charlcd_poke(lcd.charlcd);  in panel_scan_timer()
1601 	/* must init LCD first, just in case an IRQ from the keypad is  in panel_attach()
1604 	if (lcd.enabled) {  in panel_attach()
1606 		if (!lcd.charlcd || charlcd_register(lcd.charlcd))  in panel_attach()
1620 	if (lcd.enabled)  in panel_attach()
1621 		charlcd_unregister(lcd.charlcd);  in panel_attach()
1623 	charlcd_free(lcd.charlcd);  in panel_attach()
1624 	lcd.charlcd = NULL;  in panel_attach()
1647 	if (lcd.enabled) {  in panel_detach()
1648 		charlcd_unregister(lcd.charlcd);  in panel_detach()
1649 		lcd.initialized = false;  in panel_detach()
1650 		charlcd_free(lcd.charlcd);  in panel_detach()
1651 		lcd.charlcd = NULL;  in panel_detach()
1713 	 * Overwrite selection with module param values (both keypad and lcd),  in panel_init_module()
1728 	lcd.enabled = (selected_lcd_type > 0);  in panel_init_module()
1730 	if (lcd.enabled) {  in panel_init_module()
1732 		 * Init lcd struct with load-time values to preserve exact  in panel_init_module()
1735 		lcd.charset = lcd_charset;  in panel_init_module()
1736 		lcd.proto = lcd_proto;  in panel_init_module()
1737 		lcd.pins.e = lcd_e_pin;  in panel_init_module()
1738 		lcd.pins.rs = lcd_rs_pin;  in panel_init_module()
1739 		lcd.pins.rw = lcd_rw_pin;  in panel_init_module()
1740 		lcd.pins.cl = lcd_cl_pin;  in panel_init_module()
1741 		lcd.pins.da = lcd_da_pin;  in panel_init_module()
1742 		lcd.pins.bl = lcd_bl_pin;  in panel_init_module()
1760 	if (!lcd.enabled && !keypad.enabled) {  in panel_init_module()