TextLCD_chinese_version - C.Dupaty 03-2018 test on NUCLEO STM32-F411RE L…

Users » cdupaty » Code » TextLCD_chinese_version

Christian Dupaty / TextLCD_chinese_version

C.Dupaty 03-2018 test on NUCLEO STM32-F411RE LCD 2x16, I2C interface Chinese model, adress I2C=0x4E (search on AliExpress for IIC/I2C 1602 Module) Important ! configure in TextLCD_Config.h : Valid only one of the lines : #define DFROBOT 0 // chinese OK #define YWROBOT 0 // chinese 0K #define SYDZ 1 // chinese OK Font is the same as http://www.farnell.com/datasheets/2362518.pdf

Fork of TextLCD by Wim Huiskamp

/* Hello World! for the TextLCD Enhanced Library C.Dupaty 03-2018 test on NUCLEO STM32-F411RE LCD 2x16, I2C interface Chinese model, adress I2C=0x4E (search on AliExpress for IIC/I2C 1602 Module) Important ! configure in TextLCD_Config.h : Valid only one of the lines :

define DFROBOT 0 chinese OK
define YWROBOT 0 chinese 0K
define SYDZ 1 chinese OK Font is the same as http://www.farnell.com/datasheets/2362518.pdf

TextLCD.cpp@38:cbe275b0b647, 2015-04-18 (annotated)

Committer:: wim
Date:: Sat Apr 18 11:33:02 2015 +0000
Revision:: 38:cbe275b0b647
Parent:: 37:ce348c002929
Child:: 39:e9c2319de9c5

Fixed Adafruit I2C/SPI portexpander pinmappings, fixed SYDZ Backlight control

Who changed what in which revision?

User	Revision	Line number	New contents of line
wim	37:ce348c002929	1	/* mbed TextLCD Library, for LCDs based on HD44780 controllers
simon	6:e4cb7ddee0d3	2	* Copyright (c) 2007-2010, sford, http://mbed.org
wim	14:0c32b66b14b8	3	* 2013, v01: WH, Added LCD types, fixed LCD address issues, added Cursor and UDCs
wim	14:0c32b66b14b8	4	* 2013, v02: WH, Added I2C and SPI bus interfaces
wim	15:b70ebfffb258	5	* 2013, v03: WH, Added support for LCD40x4 which uses 2 controllers
wim	18:bd65dc10f27f	6	* 2013, v04: WH, Added support for Display On/Off, improved 4bit bootprocess
wim	18:bd65dc10f27f	7	* 2013, v05: WH, Added support for 8x2B, added some UDCs
wim	19:c747b9e2e7b8	8	* 2013, v06: WH, Added support for devices that use internal DC/DC converters
wim	20:e0da005a777f	9	* 2013, v07: WH, Added support for backlight and include portdefinitions for LCD2004 Module from DFROBOT
wim	22:35742ec80c24	10	* 2014, v08: WH, Refactored in Base and Derived Classes to deal with mbed lib change regarding 'NC' defined pins
wim	25:6162b31128c9	11	* 2014, v09: WH/EO, Added Class for Native SPI controllers such as ST7032
wim	26:bd897a001012	12	* 2014, v10: WH, Added Class for Native I2C controllers such as ST7032i, Added support for MCP23008 I2C portexpander, Added support for Adafruit module
wim	30:033048611c01	13	* 2014, v11: WH, Added support for native I2C controllers such as PCF21XX, Improved the _initCtrl() method to deal with differences between all supported controllers
wim	32:59c4b8f648d4	14	* 2014, v12: WH, Added support for native I2C controller PCF2119 and native I2C/SPI controllers SSD1803, ST7036, added setContrast method (by JH1PJL) for supported devices (eg ST7032i)
wim	34:e5a0dcb43ecc	15	* 2014, v13: WH, Added support for controllers US2066/SSD1311 (OLED), added setUDCBlink() method for supported devices (eg SSD1803), fixed issue in setPower()
wim	34:e5a0dcb43ecc	16	* 2014, v14: WH, Added support for PT6314 (VFD), added setOrient() method for supported devices (eg SSD1803, US2066), added Double Height lines for supported devices,
wim	34:e5a0dcb43ecc	17	* added 16 UDCs for supported devices (eg PCF2103), moved UDC defines to TextLCD_UDC file, added TextLCD_Config.h for feature and footprint settings.
wim	35:311be6444a39	18	* 2014, v15: WH, Added AC780 support, added I2C expander modules, fixed setBacklight() for inverted logic modules. Fixed bug in LCD_SPI_N define
wim	36:9f5f86dfd44a	19	* 2014, v16: WH, Added ST7070 and KS0073 support, added setIcon(), clrIcon() and setInvert() method for supported devices
wim	37:ce348c002929	20	* 2015, v17: WH, Clean up low-level _writeCommand() and _writeData(), Added support for alternative fonttables (eg PCF21XX), Added ST7066_ACM controller for ACM1602 module
wim	38:cbe275b0b647	21	* 2015, v18: WH, Performance improvement I2C portexpander
wim	38:cbe275b0b647	22	* 2015, v19: WH, Fixed Adafruit I2C/SPI portexpander pinmappings, fixed SYDZ Backlight
simon	1:ac48b187213c	23	*
simon	1:ac48b187213c	24	* Permission is hereby granted, free of charge, to any person obtaining a copy
simon	1:ac48b187213c	25	* of this software and associated documentation files (the "Software"), to deal
simon	1:ac48b187213c	26	* in the Software without restriction, including without limitation the rights
simon	1:ac48b187213c	27	* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
simon	1:ac48b187213c	28	* copies of the Software, and to permit persons to whom the Software is
simon	1:ac48b187213c	29	* furnished to do so, subject to the following conditions:
simon	1:ac48b187213c	30	*
simon	1:ac48b187213c	31	* The above copyright notice and this permission notice shall be included in
simon	1:ac48b187213c	32	* all copies or substantial portions of the Software.
simon	1:ac48b187213c	33	*
simon	1:ac48b187213c	34	* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
simon	1:ac48b187213c	35	* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
simon	1:ac48b187213c	36	* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
simon	1:ac48b187213c	37	* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
simon	1:ac48b187213c	38	* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
simon	1:ac48b187213c	39	* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
simon	1:ac48b187213c	40	* THE SOFTWARE.
simon	1:ac48b187213c	41	*/
wim	34:e5a0dcb43ecc	42	#include "mbed.h"
simon	1:ac48b187213c	43	#include "TextLCD.h"
wim	34:e5a0dcb43ecc	44	#include "TextLCD_UDC.inc"
wim	34:e5a0dcb43ecc	45
wim	21:9eb628d9e164	46	/** Create a TextLCD_Base interface
wim	15:b70ebfffb258	47	*
wim	21:9eb628d9e164	48	* @param type Sets the panel size/addressing mode (default = LCD16x2)
wim	21:9eb628d9e164	49	* @param ctrl LCD controller (default = HD44780)
wim	15:b70ebfffb258	50	*/
wim	21:9eb628d9e164	51	TextLCD_Base::TextLCD_Base(LCDType type, LCDCtrl ctrl) : _type(type), _ctrl(ctrl) {
wim	30:033048611c01	52
wim	30:033048611c01	53	// Extract LCDType data
wim	30:033048611c01	54
wim	30:033048611c01	55	// Columns encoded in b7..b0
wim	30:033048611c01	56	_nr_cols = (_type & 0xFF);
wim	30:033048611c01	57
wim	30:033048611c01	58	// Rows encoded in b15..b8
wim	30:033048611c01	59	_nr_rows = ((_type >> 8) & 0xFF);
wim	30:033048611c01	60
wim	30:033048611c01	61	// Addressing mode encoded in b19..b16
wim	30:033048611c01	62	_addr_mode = _type & LCD_T_ADR_MSK;
wim	37:ce348c002929	63
wim	37:ce348c002929	64	// Font table, encoded in LCDCtrl
wim	37:ce348c002929	65	_font = _type & LCD_C_FNT_MSK;
wim	14:0c32b66b14b8	66	}
wim	14:0c32b66b14b8	67
wim	21:9eb628d9e164	68	/** Init the LCD Controller(s)
wim	21:9eb628d9e164	69	* Clear display
wim	36:9f5f86dfd44a	70	* @param _LCDDatalength dl sets the datalength of data/commands
wim	36:9f5f86dfd44a	71	* @return none
wim	21:9eb628d9e164	72	*/
wim	36:9f5f86dfd44a	73	void TextLCD_Base::_init(_LCDDatalength dl) {
wim	38:cbe275b0b647	74
wim	38:cbe275b0b647	75	wait_ms(100); // Wait 100ms to ensure powered up
wim	15:b70ebfffb258	76
wim	15:b70ebfffb258	77	// Select and configure second LCD controller when needed
wim	15:b70ebfffb258	78	if(_type==LCD40x4) {
wim	30:033048611c01	79	_ctrl_idx=_LCDCtrl_1; // Select 2nd controller
wim	36:9f5f86dfd44a	80	_initCtrl(dl); // Init 2nd controller
wim	15:b70ebfffb258	81	}
wim	15:b70ebfffb258	82
wim	15:b70ebfffb258	83	// Select and configure primary LCD controller
wim	27:22d5086f6ba6	84	_ctrl_idx=_LCDCtrl_0; // Select primary controller
wim	36:9f5f86dfd44a	85	_initCtrl(dl); // Init primary controller
wim	28:30fa94f7341c	86
wim	32:59c4b8f648d4	87	// Clear whole display and Reset Cursor location
wim	32:59c4b8f648d4	88	// Note: This will make sure that some 3-line displays that skip topline of a 4-line configuration
wim	32:59c4b8f648d4	89	// are cleared and init cursor correctly.
wim	32:59c4b8f648d4	90	cls();
wim	15:b70ebfffb258	91	}
wim	15:b70ebfffb258	92
wim	21:9eb628d9e164	93	/** Init the LCD controller
wim	36:9f5f86dfd44a	94	* Set number of lines, fonttype, no cursor etc
wim	36:9f5f86dfd44a	95	* The controller is accessed in 4-bit parallel mode either directly via mbed pins or through I2C or SPI expander.
wim	36:9f5f86dfd44a	96	* Some controllers also support native I2C or SPI interfaces.
wim	36:9f5f86dfd44a	97	*
wim	36:9f5f86dfd44a	98	* @param _LCDDatalength dl sets the 4 or 8 bit datalength of data/commands. Required for some native serial modes.
wim	36:9f5f86dfd44a	99	* @return none
wim	30:033048611c01	100	*
wim	30:033048611c01	101	* Note: some configurations are commented out because they have not yet been tested due to lack of hardware
wim	21:9eb628d9e164	102	*/
wim	36:9f5f86dfd44a	103	void TextLCD_Base::_initCtrl(_LCDDatalength dl) {
wim	32:59c4b8f648d4	104	int _bias_lines=0; // Set Bias and lines (Instr Set 1), temporary variable.
wim	32:59c4b8f648d4	105	int _lines=0; // Set lines (Ext Instr Set), temporary variable.
wim	36:9f5f86dfd44a	106
wim	26:bd897a001012	107	this->_setRS(false); // command mode
simon	1:ac48b187213c	108
wim	37:ce348c002929	109	if (dl == _LCD_DL_4) {
wim	37:ce348c002929	110	// The Controller could be in 8 bit mode (power-on reset) or in 4 bit mode (warm reboot) at this point.
wim	37:ce348c002929	111	// Follow this procedure to make sure the Controller enters the correct state. The hardware interface
wim	37:ce348c002929	112	// between the uP and the LCD can only write the 4 most significant bits (Most Significant Nibble, MSN).
wim	37:ce348c002929	113	// In 4 bit mode the LCD expects the MSN first, followed by the LSN.
wim	37:ce348c002929	114	//
wim	38:cbe275b0b647	115	// Current state: 8 bit mode \| 4 bit mode, MSN is next \| 4 bit mode, LSN is next
wim	37:ce348c002929	116	//-------------------------------------------------------------------------------------------------
wim	38:cbe275b0b647	117	_writeNibble(0x3); // set 8 bit mode (MSN) and dummy LSN, \| set 8 bit mode (MSN), \| set dummy LSN,
wim	38:cbe275b0b647	118	// remains in 8 bit mode \| remains in 4 bit mode \| remains in 4 bit mode
wim	37:ce348c002929	119	wait_ms(15); //
wim	37:ce348c002929	120
wim	38:cbe275b0b647	121	_writeNibble(0x3); // set 8 bit mode (MSN) and dummy LSN, \| set dummy LSN, \| set 8bit mode (MSN),
wim	38:cbe275b0b647	122	// remains in 8 bit mode \| change to 8 bit mode \| remains in 4 bit mode
wim	37:ce348c002929	123	wait_ms(15); //
wim	33:900a94bc7585	124
wim	38:cbe275b0b647	125	_writeNibble(0x3); // set 8 bit mode (MSN) and dummy LSN, \| set 8 bit mode (MSN) and dummy LSN, \| set dummy LSN,
wim	38:cbe275b0b647	126	// remains in 8 bit mode \| remains in 8 bit mode \| change to 8 bit mode
wim	37:ce348c002929	127	wait_ms(15); //
wim	37:ce348c002929	128
wim	37:ce348c002929	129	// Controller is now in 8 bit mode
wim	37:ce348c002929	130
wim	37:ce348c002929	131	_writeNibble(0x2); // Change to 4-bit mode (MSN), the LSN is undefined dummy
wim	37:ce348c002929	132	wait_us(40); // most instructions take 40us
wim	37:ce348c002929	133
wim	37:ce348c002929	134	// Controller is now in 4-bit mode
wim	37:ce348c002929	135	// Note: 4/8 bit mode is ignored for most native SPI and I2C devices. They dont use the parallel bus.
wim	37:ce348c002929	136	// However, _writeNibble() method is void anyway for native SPI and I2C devices.
wim	38:cbe275b0b647	137	}
wim	38:cbe275b0b647	138	else {
wim	38:cbe275b0b647	139	// Reset in 8 bit mode, final Function set will follow
wim	38:cbe275b0b647	140	_writeCommand(0x30); // Function set 0 0 1 DL=1 N F x x
wim	37:ce348c002929	141	}
wim	25:6162b31128c9	142
wim	29:a3663151aa65	143	// Device specific initialisations: DC/DC converter to generate VLCD or VLED, number of lines etc
wim	19:c747b9e2e7b8	144	switch (_ctrl) {
wim	32:59c4b8f648d4	145
wim	36:9f5f86dfd44a	146	case KS0073:
wim	36:9f5f86dfd44a	147	// Initialise Display configuration
wim	36:9f5f86dfd44a	148	switch (_type) {
wim	36:9f5f86dfd44a	149	case LCD8x1: //8x1 is a regular 1 line display
wim	36:9f5f86dfd44a	150	case LCD12x1:
wim	36:9f5f86dfd44a	151	case LCD16x1:
wim	36:9f5f86dfd44a	152	case LCD20x1:
wim	36:9f5f86dfd44a	153	case LCD24x1:
wim	36:9f5f86dfd44a	154	// case LCD32x1: // EXT pin is High, extension driver needed
wim	36:9f5f86dfd44a	155	// case LCD40x1: // EXT pin is High, extension driver needed
wim	36:9f5f86dfd44a	156	_function = 0x02; // Function set 001 DL N RE(0) DH REV (Std Regs)
wim	36:9f5f86dfd44a	157	// DL=0 (4 bits bus)
wim	36:9f5f86dfd44a	158	// N=0 (1-line mode, N=1 2-line mode)
wim	36:9f5f86dfd44a	159	// RE=0 (Dis. Extended Regs, special mode for KS0073)
wim	36:9f5f86dfd44a	160	// DH=1 (Disp shift enable, special mode for KS0073)
wim	36:9f5f86dfd44a	161	// REV=0 (Reverse normal, special mode for KS0073)
wim	36:9f5f86dfd44a	162
wim	36:9f5f86dfd44a	163	_function_1 = 0x04; // Function set 001 DL N RE(1) BE LP (Ext Regs)
wim	36:9f5f86dfd44a	164	// DL=0 (4 bits bus)
wim	36:9f5f86dfd44a	165	// N=0 (1-line mode, N=1 2-line mode)
wim	36:9f5f86dfd44a	166	// RE=1 (Ena Extended Regs, special mode for KS0073)
wim	36:9f5f86dfd44a	167	// BE=0 (Blink Enable, CG/SEG RAM, special mode for KS0073)
wim	36:9f5f86dfd44a	168	// LP=0 (LP=1 Low power mode, LP=0 Normal)
wim	36:9f5f86dfd44a	169
wim	36:9f5f86dfd44a	170	_function_x = 0x00; // Ext Function set 0000 1 FW BW NW (Ext Regs)
wim	36:9f5f86dfd44a	171	// NW=0 (1,2 line), NW=1 (4 Line, special mode for KS0073)
wim	36:9f5f86dfd44a	172	break;
wim	36:9f5f86dfd44a	173
wim	36:9f5f86dfd44a	174	// case LCD12x3D: // Special mode for KS0073, KS0078 and PCF21XX
wim	36:9f5f86dfd44a	175	// case LCD12x3D1: // Special mode for KS0073, KS0078 and PCF21XX
wim	36:9f5f86dfd44a	176	case LCD12x4D: // Special mode for KS0073, KS0078 and PCF21XX
wim	36:9f5f86dfd44a	177	// case LCD16x3D: // Special mode for KS0073, KS0078
wim	36:9f5f86dfd44a	178	// case LCD16x4D: // Special mode for KS0073, KS0078
wim	36:9f5f86dfd44a	179	case LCD20x4D: // Special mode for KS0073, KS0078
wim	36:9f5f86dfd44a	180	_function = 0x02; // Function set 001 DL N RE(0) DH REV (Std Regs)
wim	36:9f5f86dfd44a	181	// DL=0 (4 bits bus)
wim	36:9f5f86dfd44a	182	// N=0 (dont care for 4 line mode)
wim	36:9f5f86dfd44a	183	// RE=0 (Dis. Extended Regs, special mode for KS0073)
wim	36:9f5f86dfd44a	184	// DH=1 (Disp shift enable, special mode for KS0073)
wim	36:9f5f86dfd44a	185	// REV=0 (Reverse normal, special mode for KS0073)
wim	36:9f5f86dfd44a	186
wim	36:9f5f86dfd44a	187	_function_1 = 0x04; // Function set 001 DL N RE(1) BE LP (Ext Regs)
wim	36:9f5f86dfd44a	188	// DL=0 (4 bits bus)
wim	36:9f5f86dfd44a	189	// N=0 (1-line mode), N=1 (2-line mode)
wim	36:9f5f86dfd44a	190	// RE=1 (Ena Extended Regs, special mode for KS0073)
wim	36:9f5f86dfd44a	191	// BE=0 (Blink Enable, CG/SEG RAM, special mode for KS0073)
wim	36:9f5f86dfd44a	192	// LP=0 (LP=1 Low power mode, LP=0 Normal)
wim	36:9f5f86dfd44a	193
wim	36:9f5f86dfd44a	194	_function_x = 0x01; // Ext Function set 0000 1 FW BW NW (Ext Regs)
wim	36:9f5f86dfd44a	195	// NW=0 (1,2 line), NW=1 (4 Line, special mode for KS0073)
wim	36:9f5f86dfd44a	196	break;
wim	36:9f5f86dfd44a	197
wim	36:9f5f86dfd44a	198
wim	36:9f5f86dfd44a	199	case LCD16x3G: // Special mode for ST7036
wim	36:9f5f86dfd44a	200	// case LCD24x3D: // Special mode for KS0078
wim	36:9f5f86dfd44a	201	// case LCD24x3D1: // Special mode for KS0078
wim	36:9f5f86dfd44a	202	case LCD24x4D: // Special mode for KS0078
wim	36:9f5f86dfd44a	203	error("Error: LCD Controller type does not support this Display type\n\r");
wim	36:9f5f86dfd44a	204	break;
wim	36:9f5f86dfd44a	205
wim	36:9f5f86dfd44a	206	default:
wim	36:9f5f86dfd44a	207	// All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
wim	36:9f5f86dfd44a	208	_function = 0x0A; // Function set 001 DL N RE(0) DH REV (Std Regs)
wim	36:9f5f86dfd44a	209	// DL=0 (4 bits bus)
wim	36:9f5f86dfd44a	210	// N=1 (2-line mode), N=0 (1-line mode)
wim	36:9f5f86dfd44a	211	// RE=0 (Dis. Extended Regs, special mode for KS0073)
wim	36:9f5f86dfd44a	212	// DH=1 (Disp shift enable, special mode for KS0073)
wim	36:9f5f86dfd44a	213	// REV=0 (Reverse normal, special mode for KS0073)
wim	36:9f5f86dfd44a	214
wim	36:9f5f86dfd44a	215	_function_1 = 0x0C; // Function set 001 DL N RE(1) BE LP (Ext Regs)
wim	36:9f5f86dfd44a	216	// DL=0 (4 bits bus)
wim	36:9f5f86dfd44a	217	// N=1 (2 line mode), N=0 (1-line mode)
wim	36:9f5f86dfd44a	218	// RE=1 (Ena Extended Regs, special mode for KS0073)
wim	36:9f5f86dfd44a	219	// BE=0 (Blink Enable, CG/SEG RAM, special mode for KS0073)
wim	36:9f5f86dfd44a	220	// LP=0 (LP=1 Low power mode, LP=0 Normal)
wim	36:9f5f86dfd44a	221
wim	36:9f5f86dfd44a	222	_function_x = 0x00; // Ext Function set 0000 1 FW BW NW (Ext Regs)
wim	36:9f5f86dfd44a	223	// NW=0 (1,2 line), NW=1 (4 Line, special mode for KS0073)
wim	36:9f5f86dfd44a	224	break;
wim	36:9f5f86dfd44a	225	} // switch type
wim	36:9f5f86dfd44a	226
wim	36:9f5f86dfd44a	227	// init special features
wim	36:9f5f86dfd44a	228	_writeCommand(0x20 \| _function_1);// Function set 001 DL N RE(1) BE LP (Ext Regs)
wim	36:9f5f86dfd44a	229	// DL=0 (4 bits bus), DL=1 (8 bits mode)
wim	36:9f5f86dfd44a	230	// N=0 (1 line mode), N=1 (2 line mode)
wim	36:9f5f86dfd44a	231	// RE=1 (Ena Extended Regs, special mode for KS0073)
wim	36:9f5f86dfd44a	232	// BE=0 (Blink Enable/Disable, CG/SEG RAM, special mode for KS0073)
wim	36:9f5f86dfd44a	233	// LP=0 (LP=1 Low power mode, LP=0 Normal)
wim	36:9f5f86dfd44a	234
wim	36:9f5f86dfd44a	235	_writeCommand(0x08 \| _function_x); // Ext Function set 0000 1 FW BW NW (Ext Regs)
wim	36:9f5f86dfd44a	236	// FW=0 (5-dot font, special mode for KS0073)
wim	36:9f5f86dfd44a	237	// BW=0 (Cur BW invert disable, special mode for KS0073)
wim	36:9f5f86dfd44a	238	// NW=0 (1,2 Line), NW=1 (4 line, special mode for KS0073)
wim	36:9f5f86dfd44a	239
wim	36:9f5f86dfd44a	240	_writeCommand(0x10); // Scroll/Shift set 0001 DS/HS4 DS/HS3 DS/HS2 DS/HS1 (Ext Regs)
wim	36:9f5f86dfd44a	241	// Dotscroll/Display shift enable (Special mode for KS0073)
wim	36:9f5f86dfd44a	242
wim	36:9f5f86dfd44a	243	_writeCommand(0x80); // Scroll Quantity set 1 0 SQ5 SQ4 SQ3 SQ2 SQ1 SQ0 (Ext Regs)
wim	36:9f5f86dfd44a	244	// Scroll quantity (Special mode for KS0073)
wim	36:9f5f86dfd44a	245
wim	36:9f5f86dfd44a	246	_writeCommand(0x20 \| _function); // Function set 001 DL N RE(0) DH REV (Std Regs)
wim	36:9f5f86dfd44a	247	// DL=0 (4 bits bus), DL=1 (8 bits mode)
wim	36:9f5f86dfd44a	248	// N=0 (1 line mode), N=1 (2 line mode)
wim	36:9f5f86dfd44a	249	// RE=0 (Dis. Extended Regs, special mode for KS0073)
wim	36:9f5f86dfd44a	250	// DH=1 (Disp shift enable/disable, special mode for KS0073)
wim	36:9f5f86dfd44a	251	// REV=0 (Reverse/Normal, special mode for KS0073)
wim	36:9f5f86dfd44a	252	break; // case KS0073 Controller
wim	36:9f5f86dfd44a	253
wim	36:9f5f86dfd44a	254
wim	29:a3663151aa65	255	case KS0078:
wim	29:a3663151aa65	256	// Initialise Display configuration
wim	29:a3663151aa65	257	switch (_type) {
wim	29:a3663151aa65	258	case LCD8x1: //8x1 is a regular 1 line display
wim	29:a3663151aa65	259	case LCD8x2B: //8x2B is a special case of 16x1
wim	29:a3663151aa65	260	// case LCD12x1:
wim	29:a3663151aa65	261	case LCD16x1:
wim	30:033048611c01	262	// case LCD20x1:
wim	29:a3663151aa65	263	case LCD24x1:
wim	32:59c4b8f648d4	264	_function = 0x02; // Function set 001 DL N RE(0) DH REV (Std Regs)
wim	32:59c4b8f648d4	265	// DL=0 (4 bits bus)
wim	32:59c4b8f648d4	266	// N=0 (1 line mode), N=1 (2 line mode)
wim	32:59c4b8f648d4	267	// RE=0 (Dis. Extended Regs, special mode for KS0078)
wim	32:59c4b8f648d4	268	// DH=1 (Disp shift enable, special mode for KS0078)
wim	32:59c4b8f648d4	269	// REV=0 (Reverse normal, special mode for KS0078)
wim	32:59c4b8f648d4	270
wim	33:900a94bc7585	271	_function_1 = 0x04; // Function set 001 DL N RE(1) BE 0 (Ext Regs)
wim	32:59c4b8f648d4	272	// DL=0 (4 bits bus)
wim	32:59c4b8f648d4	273	// N=0 (1 line mode), N=1 (2 line mode)
wim	32:59c4b8f648d4	274	// RE=1 (Ena Extended Regs, special mode for KS0078)
wim	32:59c4b8f648d4	275	// BE=0 (Blink Enable, CG/SEG RAM, special mode for KS0078)
wim	32:59c4b8f648d4	276	// 0
wim	30:033048611c01	277
wim	32:59c4b8f648d4	278	_function_x = 0x00; // Ext Function set 0000 1 FW BW NW (Ext Regs)
wim	32:59c4b8f648d4	279	// NW=0 (1,2 line), NW=1 (4 Line, special mode for KS0078)
wim	29:a3663151aa65	280	break;
wim	29:a3663151aa65	281
wim	36:9f5f86dfd44a	282	// case LCD12x3D: // Special mode for KS0073, KS0078 and PCF21XX
wim	36:9f5f86dfd44a	283	// case LCD12x3D1: // Special mode for KS0073, KS0078 and PCF21XX
wim	36:9f5f86dfd44a	284	// case LCD12x4D: // Special mode for KS0073, KS0078 and PCF21XX
wim	36:9f5f86dfd44a	285	// case LCD16x3D: // Special mode for KS0073, KS0078
wim	36:9f5f86dfd44a	286	// case LCD16x4D: // Special mode for KS0073, KS0078
wim	36:9f5f86dfd44a	287	// case LCD20x4D: // Special mode for KS0073, KS0078
wim	30:033048611c01	288	// case LCD24x3D: // Special mode for KS0078
wim	30:033048611c01	289	// case LCD24x3D1: // Special mode for KS0078
wim	30:033048611c01	290	case LCD24x4D: // Special mode for KS0078
wim	32:59c4b8f648d4	291	_function = 0x02; // Function set 001 DL N RE(0) DH REV (Std Regs)
wim	32:59c4b8f648d4	292	// DL=0 (4 bits bus)
wim	32:59c4b8f648d4	293	// N=0 (dont care for 4 line mode)
wim	32:59c4b8f648d4	294	// RE=0 (Dis. Extended Regs, special mode for KS0078)
wim	32:59c4b8f648d4	295	// DH=1 (Disp shift enable, special mode for KS0078)
wim	32:59c4b8f648d4	296	// REV=0 (Reverse normal, special mode for KS0078)
wim	32:59c4b8f648d4	297
wim	33:900a94bc7585	298	_function_1 = 0x04; // Function set 001 DL N RE(1) BE 0 (Ext Regs)
wim	32:59c4b8f648d4	299	// DL=0 (4 bits bus)
wim	32:59c4b8f648d4	300	// N=0 (1 line mode), N=1 (2 line mode)
wim	32:59c4b8f648d4	301	// RE=1 (Ena Extended Regs, special mode for KS0078)
wim	32:59c4b8f648d4	302	// BE=0 (Blink Enable, CG/SEG RAM, special mode for KS0078)
wim	32:59c4b8f648d4	303	// 0
wim	29:a3663151aa65	304
wim	32:59c4b8f648d4	305	_function_x = 0x01; // Ext Function set 0000 1 FW BW NW (Ext Regs)
wim	32:59c4b8f648d4	306	// NW=0 (1,2 line), NW=1 (4 Line, special mode for KS0078)
wim	30:033048611c01	307	break;
wim	33:900a94bc7585	308
wim	33:900a94bc7585	309	case LCD16x3G: // Special mode for ST7036
wim	33:900a94bc7585	310	error("Error: LCD Controller type does not support this Display type\n\r");
wim	33:900a94bc7585	311	break;
wim	30:033048611c01	312
wim	29:a3663151aa65	313	default:
wim	30:033048611c01	314	// All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
wim	32:59c4b8f648d4	315	_function = 0x0A; // Function set 001 DL N RE(0) DH REV (Std Regs)
wim	32:59c4b8f648d4	316	// DL=0 (4 bits bus)
wim	32:59c4b8f648d4	317	// N=1 (1 line mode), N=1 (2 line mode)
wim	32:59c4b8f648d4	318	// RE=0 (Dis. Extended Regs, special mode for KS0078)
wim	32:59c4b8f648d4	319	// DH=1 (Disp shift enable, special mode for KS0078)
wim	32:59c4b8f648d4	320	// REV=0 (Reverse normal, special mode for KS0078)
wim	32:59c4b8f648d4	321
wim	33:900a94bc7585	322	_function_1 = 0x0C; // Function set 001 DL N RE(1) BE 0 (Ext Regs)
wim	32:59c4b8f648d4	323	// DL=0 (4 bits bus)
wim	32:59c4b8f648d4	324	// N=1 (1 line mode), N=1 (2 line mode)
wim	32:59c4b8f648d4	325	// RE=1 (Ena Extended Regs, special mode for KS0078)
wim	32:59c4b8f648d4	326	// BE=0 (Blink Enable, CG/SEG RAM, special mode for KS0078)
wim	32:59c4b8f648d4	327	// 0
wim	30:033048611c01	328
wim	32:59c4b8f648d4	329	_function_x = 0x00; // Ext Function set 0000 1 FW BW NW (Ext Regs)
wim	32:59c4b8f648d4	330	// NW=0 (1,2 line), NW=1 (4 Line, special mode for KS0078)
wim	29:a3663151aa65	331	break;
wim	29:a3663151aa65	332	} // switch type
wim	29:a3663151aa65	333
wim	32:59c4b8f648d4	334	// init special features
wim	32:59c4b8f648d4	335	_writeCommand(0x20 \| _function_1);// Function set 001 DL N RE(1) BE 0 (Ext Regs)
wim	32:59c4b8f648d4	336	// DL=0 (4 bits bus), DL=1 (8 bits mode)
wim	32:59c4b8f648d4	337	// N=0 (1 line mode), N=1 (2 line mode)
wim	32:59c4b8f648d4	338	// RE=1 (Ena Extended Regs, special mode for KS0078)
wim	32:59c4b8f648d4	339	// BE=0 (Blink Enable/Disable, CG/SEG RAM, special mode for KS0078)
wim	32:59c4b8f648d4	340	// 0
wim	32:59c4b8f648d4	341
wim	32:59c4b8f648d4	342	_writeCommand(0x08 \| _function_x); // Ext Function set 0000 1 FW BW NW (Ext Regs)
wim	32:59c4b8f648d4	343	// FW=0 (5-dot font, special mode for KS0078)
wim	32:59c4b8f648d4	344	// BW=0 (Cur BW invert disable, special mode for KS0078)
wim	32:59c4b8f648d4	345	// NW=0 (1,2 Line), NW=1 (4 line, special mode for KS0078)
wim	32:59c4b8f648d4	346
wim	32:59c4b8f648d4	347	_writeCommand(0x10); // Scroll/Shift set 0001 DS/HS4 DS/HS3 DS/HS2 DS/HS1 (Ext Regs)
wim	32:59c4b8f648d4	348	// Dotscroll/Display shift enable (Special mode for KS0078)
wim	32:59c4b8f648d4	349
wim	32:59c4b8f648d4	350	_writeCommand(0x80); // Scroll Quantity set 1 0 SQ5 SQ4 SQ3 SQ2 SQ1 SQ0 (Ext Regs)
wim	32:59c4b8f648d4	351	// Scroll quantity (Special mode for KS0078)
wim	32:59c4b8f648d4	352
wim	32:59c4b8f648d4	353	_writeCommand(0x20 \| _function); // Function set 001 DL N RE(0) DH REV (Std Regs)
wim	32:59c4b8f648d4	354	// DL=0 (4 bits bus), DL=1 (8 bits mode)
wim	32:59c4b8f648d4	355	// N=0 (1 line mode), N=1 (2 line mode)
wim	32:59c4b8f648d4	356	// RE=0 (Dis. Extended Regs, special mode for KS0078)
wim	32:59c4b8f648d4	357	// DH=1 (Disp shift enable/disable, special mode for KS0078)
wim	32:59c4b8f648d4	358	// REV=0 (Reverse/Normal, special mode for KS0078)
wim	29:a3663151aa65	359	break; // case KS0078 Controller
wim	29:a3663151aa65	360
wim	26:bd897a001012	361	case ST7032_3V3:
wim	26:bd897a001012	362	// ST7032 controller: Initialise Voltage booster for VLCD. VDD=3V3
wim	26:bd897a001012	363	case ST7032_5V:
wim	32:59c4b8f648d4	364	// ST7032 controller: Disable Voltage booster for VLCD. VDD=5V
wim	29:a3663151aa65	365
wim	29:a3663151aa65	366	// Initialise Display configuration
wim	29:a3663151aa65	367	switch (_type) {
wim	29:a3663151aa65	368	case LCD8x1: //8x1 is a regular 1 line display
wim	29:a3663151aa65	369	case LCD8x2B: //8x2B is a special case of 16x1
wim	29:a3663151aa65	370	// case LCD12x1:
wim	29:a3663151aa65	371	case LCD16x1:
wim	30:033048611c01	372	// case LCD20x1:
wim	32:59c4b8f648d4	373	case LCD24x1:
wim	32:59c4b8f648d4	374	_function = 0x00; // FUNCTION SET 0 0 1 DL=0 (4 bit), N=0 (1-line display mode), F=0 (5*7dot), 0, IS
wim	32:59c4b8f648d4	375	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	32:59c4b8f648d4	376	// Saved to allow switch between Instruction sets at later time
wim	32:59c4b8f648d4	377	break;
wim	28:30fa94f7341c	378
wim	32:59c4b8f648d4	379	case LCD12x3D: // Special mode for KS0078 and PCF21XX
wim	32:59c4b8f648d4	380	case LCD12x3D1: // Special mode for KS0078 and PCF21XX
wim	32:59c4b8f648d4	381	case LCD12x4D: // Special mode for KS0078 and PCF21XX
wim	33:900a94bc7585	382	case LCD16x3G: // Special mode for ST7036
wim	32:59c4b8f648d4	383	case LCD24x4D: // Special mode for KS0078
wim	32:59c4b8f648d4	384	error("Error: LCD Controller type does not support this Display type\n\r");
wim	30:033048611c01	385	break;
wim	29:a3663151aa65	386
wim	32:59c4b8f648d4	387	default:
wim	32:59c4b8f648d4	388	// All other LCD types are initialised as 2 Line displays
wim	32:59c4b8f648d4	389	_function = 0x08; // FUNCTION SET 0 0 1 DL=0 (4 bit), N=1 (2-line display mode), F=0 (5*7dot), 0, IS
wim	32:59c4b8f648d4	390	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	32:59c4b8f648d4	391	// Saved to allow switch between Instruction sets at later time
wim	32:59c4b8f648d4	392	break;
wim	32:59c4b8f648d4	393	} // switch type
wim	32:59c4b8f648d4	394
wim	32:59c4b8f648d4	395	// init special features
wim	33:900a94bc7585	396	_writeCommand(0x20 \| _function \| 0x01); // Set function, 0 0 1 DL N F 0 IS=1 Select Instr Set = 1
wim	33:900a94bc7585	397
wim	33:900a94bc7585	398	_writeCommand(0x1C); // Internal OSC frequency adjustment Framefreq=183HZ, Bias will be 1/4 (Instr Set=1)
wim	32:59c4b8f648d4	399
wim	32:59c4b8f648d4	400	_contrast = LCD_ST7032_CONTRAST;
wim	32:59c4b8f648d4	401	_writeCommand(0x70 \| (_contrast & 0x0F)); // Set Contrast Low bits, 0 1 1 1 C3 C2 C1 C0 (IS=1)
wim	32:59c4b8f648d4	402
wim	32:59c4b8f648d4	403
wim	32:59c4b8f648d4	404	if (_ctrl == ST7032_3V3) {
wim	36:9f5f86dfd44a	405	// _icon_power = 0x04; // Icon display off, Booster circuit is turned on (IS=1)
wim	36:9f5f86dfd44a	406	_icon_power = 0x0C; // Icon display on, Booster circuit is turned on (IS=1)
wim	32:59c4b8f648d4	407	// Saved to allow contrast change at later time
wim	32:59c4b8f648d4	408	}
wim	32:59c4b8f648d4	409	else {
wim	36:9f5f86dfd44a	410	// _icon_power = 0x00; // Icon display off, Booster circuit is turned off (IS=1)
wim	36:9f5f86dfd44a	411	_icon_power = 0x08; // Icon display on, Booster circuit is turned off (IS=1)
wim	32:59c4b8f648d4	412	// Saved to allow contrast change at later time
wim	32:59c4b8f648d4	413	}
wim	32:59c4b8f648d4	414	_writeCommand(0x50 \| _icon_power \| ((_contrast >> 4) & 0x03)); // Set Icon, Booster and Contrast High bits, 0 1 0 1 Ion Bon C5 C4 (IS=1)
wim	32:59c4b8f648d4	415	wait_ms(10); // Wait 10ms to ensure powered up
wim	32:59c4b8f648d4	416
wim	32:59c4b8f648d4	417	_writeCommand(0x68 \| (LCD_ST7032_RAB & 0x07)); // Voltage follower, 0 1 1 0 FOn=1, Ampl ratio Rab2=1, Rab1=0, Rab0=0 (IS=1)
wim	32:59c4b8f648d4	418	wait_ms(10); // Wait 10ms to ensure powered up
wim	32:59c4b8f648d4	419
wim	32:59c4b8f648d4	420	_writeCommand(0x20 \| _function); // Select Instruction Set = 0
wim	32:59c4b8f648d4	421
wim	32:59c4b8f648d4	422	break; // case ST7032_3V3 Controller
wim	32:59c4b8f648d4	423	// case ST7032_5V Controller
wim	32:59c4b8f648d4	424
wim	32:59c4b8f648d4	425	case ST7036_3V3:
wim	32:59c4b8f648d4	426	// ST7036 controller: Initialise Voltage booster for VLCD. VDD=3V3
wim	32:59c4b8f648d4	427	// Note: supports 1,2 (LCD_T_A) or 3 lines (LCD_T_G)
wim	32:59c4b8f648d4	428	case ST7036_5V:
wim	32:59c4b8f648d4	429	// ST7036 controller: Disable Voltage booster for VLCD. VDD=5V
wim	32:59c4b8f648d4	430	// Note: supports 1,2 (LCD_T_A) or 3 lines (LCD_T_G)
wim	32:59c4b8f648d4	431
wim	32:59c4b8f648d4	432	// Initialise Display configuration
wim	32:59c4b8f648d4	433	switch (_type) {
wim	32:59c4b8f648d4	434	case LCD8x1: //8x1 is a regular 1 line display
wim	32:59c4b8f648d4	435	case LCD8x2B: //8x2D is a special case of 16x1
wim	32:59c4b8f648d4	436	// case LCD12x1:
wim	32:59c4b8f648d4	437	case LCD16x1:
wim	32:59c4b8f648d4	438	case LCD24x1:
wim	32:59c4b8f648d4	439	_function = 0x00; // Set function, 0 0 1 DL=0 (4-bit Databus), N=0 (1 Line), DH=0 (5x7font), IS2, IS1 (Select Instruction Set)
wim	32:59c4b8f648d4	440	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	32:59c4b8f648d4	441	// Saved to allow switch between Instruction sets at later time
wim	32:59c4b8f648d4	442
wim	32:59c4b8f648d4	443	_bias_lines = 0x04; // Bias: 1/5, 1 or 2-Lines LCD
wim	32:59c4b8f648d4	444	break;
wim	32:59c4b8f648d4	445
wim	32:59c4b8f648d4	446	// case LCD12x3G: // Special mode for ST7036
wim	32:59c4b8f648d4	447	case LCD16x3G: // Special mode for ST7036
wim	32:59c4b8f648d4	448	_function = 0x08; // Set function, 0 0 1 DL=0 (4-bit Databus), N=1 (2 Line), DH=0 (5x7font), IS2,IS1 (Select Instruction Set)
wim	32:59c4b8f648d4	449	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	32:59c4b8f648d4	450	// Saved to allow switch between Instruction sets at later time
wim	32:59c4b8f648d4	451
wim	32:59c4b8f648d4	452	_bias_lines = 0x05; // Bias: 1/5, 3-Lines LCD
wim	32:59c4b8f648d4	453	break;
wim	32:59c4b8f648d4	454
wim	32:59c4b8f648d4	455	// case LCD12x3D1: // Special mode for KS0078 and PCF21XX
wim	32:59c4b8f648d4	456	// case LCD16x3D1: // Special mode for SSD1803
wim	30:033048611c01	457	case LCD12x4D: // Special mode for PCF2116
wim	30:033048611c01	458	case LCD24x4D: // Special mode for KS0078
wim	30:033048611c01	459	error("Error: LCD Controller type does not support this Display type\n\r");
wim	29:a3663151aa65	460	break;
wim	28:30fa94f7341c	461
wim	29:a3663151aa65	462	default:
wim	32:59c4b8f648d4	463	// All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
wim	32:59c4b8f648d4	464	_function = 0x08; // Set function, 0 0 1 DL=0 (4-bit Databus), N=1 (2 Line), DH=0 (5x7font), IS2,IS1 (Select Instruction Set)
wim	32:59c4b8f648d4	465	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	32:59c4b8f648d4	466	// Saved to allow switch between Instruction sets at later time
wim	32:59c4b8f648d4	467
wim	32:59c4b8f648d4	468	_bias_lines = 0x04; // Bias: 1/5, 1 or 2-Lines LCD
wim	32:59c4b8f648d4	469	break;
wim	32:59c4b8f648d4	470	} // switch type
wim	32:59c4b8f648d4	471
wim	29:a3663151aa65	472
wim	32:59c4b8f648d4	473	// init special features
wim	33:900a94bc7585	474	_writeCommand(0x20 \| _function \| 0x01); // Set function, IS2,IS1 = 01 (Select Instr Set = 1)
wim	32:59c4b8f648d4	475	_writeCommand(0x10 \| _bias_lines); // Set Bias and 1,2 or 3 lines (Instr Set 1)
wim	29:a3663151aa65	476
wim	32:59c4b8f648d4	477	_contrast = LCD_ST7036_CONTRAST;
wim	32:59c4b8f648d4	478	_writeCommand(0x70 \| (_contrast & 0x0F)); // Set Contrast, 0 1 1 1 C3 C2 C1 C0 (Instr Set 1)
wim	32:59c4b8f648d4	479
wim	32:59c4b8f648d4	480	if (_ctrl == ST7036_3V3) {
wim	36:9f5f86dfd44a	481	_icon_power = 0x0C; // Set Icon, Booster, Contrast High bits, 0 1 0 1 Ion=1 Bon=1 C5 C4 (Instr Set 1)
wim	36:9f5f86dfd44a	482	// _icon_power = 0x04; // Set Icon, Booster, Contrast High bits, 0 1 0 1 Ion=0 Bon=1 C5 C4 (Instr Set 1)
wim	32:59c4b8f648d4	483	// Saved to allow contrast change at later time
wim	32:59c4b8f648d4	484	}
wim	32:59c4b8f648d4	485	else {
wim	36:9f5f86dfd44a	486	_icon_power = 0x08; // Set Icon, Booster, Contrast High bits, 0 1 0 1 Ion=1 Bon=0 C5 C4 (Instr Set 1)
wim	36:9f5f86dfd44a	487	// _icon_power = 0x00; // Set Icon, Booster, Contrast High bits, 0 1 0 1 Ion=0 Bon=0 C5 C4 (Instr Set 1)
wim	32:59c4b8f648d4	488	}
wim	29:a3663151aa65	489
wim	32:59c4b8f648d4	490	_writeCommand(0x50 \| _icon_power \| ((_contrast >> 4) & 0x03)); // Set Contrast C5, C4 (Instr Set 1)
wim	32:59c4b8f648d4	491	wait_ms(10); // Wait 10ms to ensure powered up
wim	32:59c4b8f648d4	492
wim	32:59c4b8f648d4	493	_writeCommand(0x68 \| (LCD_ST7036_RAB & 0x07)); // Voltagefollower On = 1, Ampl ratio Rab2, Rab1, Rab0 = 1 0 1 (Instr Set 1)
wim	32:59c4b8f648d4	494	wait_ms(10); // Wait 10ms to ensure powered up
wim	28:30fa94f7341c	495
wim	32:59c4b8f648d4	496	_writeCommand(0x20 \| _function); // Set function, IS2,IS1 = 00 (Select Instruction Set = 0)
wim	32:59c4b8f648d4	497
wim	32:59c4b8f648d4	498	break; // case ST7036_3V3 Controller
wim	32:59c4b8f648d4	499	// case ST7036_5V Controller
wim	36:9f5f86dfd44a	500
wim	36:9f5f86dfd44a	501	case ST7070:
wim	36:9f5f86dfd44a	502	// Initialise Display configuration
wim	36:9f5f86dfd44a	503	switch (_type) {
wim	36:9f5f86dfd44a	504	case LCD8x1: //8x1 is a regular 1 line display
wim	36:9f5f86dfd44a	505	case LCD8x2B: //8x2D is a special case of 16x1
wim	36:9f5f86dfd44a	506	// case LCD12x1:
wim	36:9f5f86dfd44a	507	case LCD16x1:
wim	36:9f5f86dfd44a	508	case LCD24x1:
wim	36:9f5f86dfd44a	509	_function = dl \| 0x00; // Set function, 0 0 1 DL=0 (4-bit Databus), N=0 (1 Line), EXT=0, x, x
wim	36:9f5f86dfd44a	510	// Note: 4 bit mode is NOT ignored for native SPI !
wim	36:9f5f86dfd44a	511	// Saved to allow switch between Instruction sets at later time
wim	36:9f5f86dfd44a	512	break;
wim	36:9f5f86dfd44a	513
wim	36:9f5f86dfd44a	514	// case LCD12x3D1: // Special mode for KS0078 and PCF21XX
wim	36:9f5f86dfd44a	515	// case LCD16x3D1: // Special mode for SSD1803
wim	36:9f5f86dfd44a	516	case LCD12x4D: // Special mode for PCF2116
wim	36:9f5f86dfd44a	517	case LCD24x4D: // Special mode for KS0078
wim	36:9f5f86dfd44a	518	// case LCD12x3G: // Special mode for ST7036
wim	36:9f5f86dfd44a	519	case LCD16x3G: // Special mode for ST7036
wim	36:9f5f86dfd44a	520	error("Error: LCD Controller type does not support this Display type\n\r");
wim	36:9f5f86dfd44a	521	break;
wim	36:9f5f86dfd44a	522
wim	36:9f5f86dfd44a	523	default:
wim	36:9f5f86dfd44a	524	// All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
wim	36:9f5f86dfd44a	525	_function = dl \| 0x08; // Set function, 0 0 1 DL, N=1 (2 Line), EXT=0, x, x
wim	36:9f5f86dfd44a	526	// Note: 4 bit mode is NOT ignored for native SPI !
wim	36:9f5f86dfd44a	527	// Saved to allow switch between Instruction sets at later time
wim	36:9f5f86dfd44a	528	break;
wim	36:9f5f86dfd44a	529	} // switch type
wim	36:9f5f86dfd44a	530
wim	36:9f5f86dfd44a	531	// _writeCommand(0x00); // NOP, make sure to sync SPI
wim	36:9f5f86dfd44a	532
wim	36:9f5f86dfd44a	533	// init special features
wim	36:9f5f86dfd44a	534	_writeCommand(0x20 \| _function \| 0x04); // Set function, 0 0 1 DL N EXT=1 x x (Select Instr Set = 1)
wim	36:9f5f86dfd44a	535
wim	36:9f5f86dfd44a	536	_writeCommand(0x04 \| 0x00); // Set Bias resistors 0 0 0 0 0 1 Rb1,Rb0= 0 0 (Extern Res) (Instr Set 1)
wim	36:9f5f86dfd44a	537
wim	36:9f5f86dfd44a	538	_writeCommand(0x40 \| 0x00); // COM/SEG directions 0 1 0 0 C1, C2, S1, S2 (Instr Set 1)
wim	36:9f5f86dfd44a	539	// C1=1: Com1-8 -> Com8-1; C2=1: Com9-16 -> Com16-9
wim	36:9f5f86dfd44a	540	// S1=1: Seg1-40 -> Seg40-1; S2=1: Seg41-80 -> Seg80-41
wim	36:9f5f86dfd44a	541
wim	36:9f5f86dfd44a	542	_writeCommand(0x20 \| _function); // Set function, EXT=0 (Select Instr Set = 0)
wim	36:9f5f86dfd44a	543
wim	36:9f5f86dfd44a	544	break; // case ST7070 Controller
wim	36:9f5f86dfd44a	545
wim	32:59c4b8f648d4	546	case SSD1803_3V3:
wim	32:59c4b8f648d4	547	// SSD1803 controller: Initialise Voltage booster for VLCD. VDD=3V3
wim	32:59c4b8f648d4	548	// Note: supports 1,2, 3 or 4 lines
wim	32:59c4b8f648d4	549	// case SSD1803_5V:
wim	32:59c4b8f648d4	550	// SSD1803 controller: No Voltage booster for VLCD. VDD=5V
wim	32:59c4b8f648d4	551
wim	29:a3663151aa65	552	// Initialise Display configuration
wim	29:a3663151aa65	553	switch (_type) {
wim	29:a3663151aa65	554	case LCD8x1: //8x1 is a regular 1 line display
wim	30:033048611c01	555	case LCD8x2B: //8x2D is a special case of 16x1
wim	29:a3663151aa65	556	// case LCD12x1:
wim	29:a3663151aa65	557	case LCD16x1:
wim	29:a3663151aa65	558	case LCD24x1:
wim	32:59c4b8f648d4	559	_function = 0x00; // Set function 0 0 1 DL N DH RE(0) IS
wim	32:59c4b8f648d4	560	// Saved to allow switch between Instruction sets at later time
wim	32:59c4b8f648d4	561	// DL=0 4-bit Databus,
wim	32:59c4b8f648d4	562	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	32:59c4b8f648d4	563	// N=0 1 Line / 3 Line
wim	32:59c4b8f648d4	564	// DH=0 Double Height disable
wim	32:59c4b8f648d4	565	// IS=0
wim	32:59c4b8f648d4	566
wim	33:900a94bc7585	567	_function_1 = 0x02; // Set function, 0 0 1 DL N BE RE(1) REV
wim	32:59c4b8f648d4	568	// Saved to allow switch between Instruction sets at later time
wim	32:59c4b8f648d4	569	// DL=0 4-bit Databus,
wim	32:59c4b8f648d4	570	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	32:59c4b8f648d4	571	// N=0 1 Line / 3 Line
wim	32:59c4b8f648d4	572	// BE=0 Blink Enable off, special feature of SSD1803
wim	32:59c4b8f648d4	573	// REV=0 Reverse off, special feature of SSD1803
wim	32:59c4b8f648d4	574
wim	32:59c4b8f648d4	575	_lines = 0x00; // Ext function set 0 0 0 0 1 FW BW NW
wim	32:59c4b8f648d4	576	// NW=0 1-Line LCD (N=0)
wim	29:a3663151aa65	577	break;
wim	32:59c4b8f648d4	578
wim	33:900a94bc7585	579	case LCD12x3D: // Special mode for KS0078 and PCF21XX
wim	32:59c4b8f648d4	580	// case LCD12x3D1: // Special mode for KS0078 and PCF21XX
wim	33:900a94bc7585	581	case LCD16x3D: // Special mode for KS0078
wim	32:59c4b8f648d4	582	// case LCD16x3D1: // Special mode for SSD1803
wim	32:59c4b8f648d4	583	// case LCD20x3D: // Special mode for SSD1803
wim	32:59c4b8f648d4	584	_function = 0x00; // Set function 0 0 1 DL N DH RE(0) IS
wim	32:59c4b8f648d4	585	// Saved to allow switch between Instruction sets at later time
wim	32:59c4b8f648d4	586	// DL=0 4-bit Databus,
wim	32:59c4b8f648d4	587	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	32:59c4b8f648d4	588	// N=0 1 Line / 3 Line
wim	32:59c4b8f648d4	589	// DH=0 Double Height disable
wim	32:59c4b8f648d4	590	// IS=0
wim	32:59c4b8f648d4	591
wim	33:900a94bc7585	592	_function_1 = 0x02; // Set function, 0 0 1 DL N BE RE(1) REV
wim	32:59c4b8f648d4	593	// Saved to allow switch between Instruction sets at later time
wim	32:59c4b8f648d4	594	// DL=0 4-bit Databus,
wim	32:59c4b8f648d4	595	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	32:59c4b8f648d4	596	// N=0 1 Line / 3 Line
wim	32:59c4b8f648d4	597	// BE=0 Blink Enable off, special feature of SSD1803
wim	32:59c4b8f648d4	598	// REV=0 Reverse off, special feature of SSD1803
wim	32:59c4b8f648d4	599
wim	32:59c4b8f648d4	600	_lines = 0x00; // Ext function set 0 0 0 0 1 FW BW NW
wim	32:59c4b8f648d4	601	// NW=1 3-Line LCD (N=0)
wim	29:a3663151aa65	602	break;
wim	30:033048611c01	603
wim	32:59c4b8f648d4	604	case LCD20x4D: // Special mode for SSD1803
wim	32:59c4b8f648d4	605	_function = 0x08; // Set function 0 0 1 DL N DH RE(0) IS
wim	32:59c4b8f648d4	606	// Saved to allow switch between Instruction sets at later time
wim	32:59c4b8f648d4	607	// DL=0 4-bit Databus,
wim	32:59c4b8f648d4	608	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	32:59c4b8f648d4	609	// N=1 4 Line
wim	32:59c4b8f648d4	610	// DH=0 Double Height disable
wim	32:59c4b8f648d4	611	// IS=0
wim	32:59c4b8f648d4	612
wim	33:900a94bc7585	613	_function_1 = 0x0A; // Set function, 0 0 1 DL N BE RE(1) REV
wim	32:59c4b8f648d4	614	// Saved to allow switch between Instruction sets at later time
wim	32:59c4b8f648d4	615	// DL=0 4-bit Databus,
wim	32:59c4b8f648d4	616	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	32:59c4b8f648d4	617	// N=1 4 Line
wim	32:59c4b8f648d4	618	// BE=0 Blink Enable off, special feature of SSD1803
wim	32:59c4b8f648d4	619	// REV=0 Reverse off, special feature of SSD1803
wim	32:59c4b8f648d4	620
wim	32:59c4b8f648d4	621	_lines = 0x01; // Ext function set 0 0 0 0 1 FW BW NW
wim	32:59c4b8f648d4	622	// NW=1 4-Line LCD (N=1)
wim	32:59c4b8f648d4	623	break;
wim	32:59c4b8f648d4	624
wim	33:900a94bc7585	625	case LCD16x3G: // Special mode for ST7036
wim	32:59c4b8f648d4	626	case LCD24x4D: // Special mode for KS0078
wim	30:033048611c01	627	error("Error: LCD Controller type does not support this Display type\n\r");
wim	30:033048611c01	628	break;
wim	30:033048611c01	629
wim	29:a3663151aa65	630	default:
wim	30:033048611c01	631	// All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
wim	32:59c4b8f648d4	632	_function = 0x08; // Set function 0 0 1 DL N DH RE(0) IS
wim	32:59c4b8f648d4	633	// Saved to allow switch between Instruction sets at later time
wim	32:59c4b8f648d4	634	// DL=0 4-bit Databus,
wim	32:59c4b8f648d4	635	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	32:59c4b8f648d4	636	// N=1 2 line / 4 Line
wim	32:59c4b8f648d4	637	// DH=0 Double Height disable
wim	36:9f5f86dfd44a	638	// RE=0
wim	32:59c4b8f648d4	639	// IS=0
wim	29:a3663151aa65	640
wim	33:900a94bc7585	641	_function_1 = 0x0A; // Set function, 0 0 1 DL N BE RE(1) REV
wim	32:59c4b8f648d4	642	// Saved to allow switch between Instruction sets at later time
wim	32:59c4b8f648d4	643	// DL=0 4-bit Databus,
wim	32:59c4b8f648d4	644	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	32:59c4b8f648d4	645	// N=1 2 line / 4 Line
wim	32:59c4b8f648d4	646	// BE=0 Blink Enable off, special feature of SSD1803
wim	36:9f5f86dfd44a	647	// RE=1
wim	32:59c4b8f648d4	648	// REV=0 Reverse off, special feature of SSD1803
wim	32:59c4b8f648d4	649
wim	32:59c4b8f648d4	650	_lines = 0x00; // Ext function set 0 0 0 0 1 FW BW NW
wim	32:59c4b8f648d4	651	// NW=0 2-Line LCD (N=1)
wim	32:59c4b8f648d4	652	break;
wim	32:59c4b8f648d4	653	} // switch type
wim	32:59c4b8f648d4	654
wim	32:59c4b8f648d4	655
wim	32:59c4b8f648d4	656	// init special features
wim	33:900a94bc7585	657	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 DL N BE RE(1) REV
wim	32:59c4b8f648d4	658	// Select Extended Instruction Set
wim	33:900a94bc7585	659
wim	33:900a94bc7585	660	_writeCommand(0x06); // Set ext entry mode, 0 0 0 0 0 1 BDC=1 COM1-32, BDS=0 SEG100-1 "Bottom View" (Ext Instr Set)
wim	33:900a94bc7585	661	// _writeCommand(0x05); // Set ext entry mode, 0 0 0 0 0 1 BDC=0 COM32-1, BDS=1 SEG1-100 "Top View" (Ext Instr Set)
wim	33:900a94bc7585	662	wait_ms(5); // Wait to ensure completion or SSD1803 fails to set Top/Bottom after reset..
wim	33:900a94bc7585	663
wim	33:900a94bc7585	664	_writeCommand(0x08 \| _lines); // Set ext function 0 0 0 0 1 FW BW NW 1,2,3 or 4 lines (Ext Instr Set)
wim	32:59c4b8f648d4	665
wim	32:59c4b8f648d4	666	_writeCommand(0x10); // Double Height and Bias, 0 0 0 1 UD2=0, UD1=0, BS1=0 Bias 1/5, DH=0 (Ext Instr Set)
wim	32:59c4b8f648d4	667
wim	32:59c4b8f648d4	668	// _writeCommand(0x76); // Set TC Control, 0 1 1 1 0 1 1 0 (Ext Instr Set)
wim	32:59c4b8f648d4	669	// _writeData(0x02); // Set TC data, 0 0 0 0 0 TC2,TC1,TC0 = 0 1 0 (Ext Instr Set)
wim	32:59c4b8f648d4	670
wim	32:59c4b8f648d4	671	_writeCommand(0x20 \| _function \| 0x01); // Set function, 0 0 1 DL N DH RE(0) IS=1 Select Instruction Set 1
wim	32:59c4b8f648d4	672	// Select Std Instr set, Select IS=1
wim	32:59c4b8f648d4	673
wim	32:59c4b8f648d4	674	_contrast = LCD_SSD1_CONTRAST;
wim	32:59c4b8f648d4	675	_writeCommand(0x70 \| (_contrast & 0x0F)); // Set Contrast 0 1 1 1 C3, C2, C1, C0 (Instr Set 1)
wim	32:59c4b8f648d4	676
wim	36:9f5f86dfd44a	677	// _icon_power = 0x04; // Icon off, Booster on (Instr Set 1)
wim	36:9f5f86dfd44a	678	_icon_power = 0x0C; // Icon on, Booster on (Instr Set 1)
wim	32:59c4b8f648d4	679	// Saved to allow contrast change at later time
wim	32:59c4b8f648d4	680	_writeCommand(0x50 \| _icon_power \| ((_contrast >> 4) & 0x03)); // Set Power, Icon and Contrast, 0 1 0 1 Ion Bon C5 C4 (Instr Set 1)
wim	32:59c4b8f648d4	681	wait_ms(10); // Wait 10ms to ensure powered up
wim	32:59c4b8f648d4	682
wim	32:59c4b8f648d4	683	_writeCommand(0x68 \| (LCD_SSD1_RAB & 0x07)); // Set Voltagefollower 0 1 1 0 Don = 1, Ampl ratio Rab2, Rab1, Rab0 = 1 1 0 (Instr Set 1)
wim	32:59c4b8f648d4	684	wait_ms(10); // Wait 10ms to ensure powered up
wim	32:59c4b8f648d4	685
wim	33:900a94bc7585	686	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 DL N BE RE(1) REV
wim	32:59c4b8f648d4	687	// Select Extended Instruction Set 1
wim	32:59c4b8f648d4	688	_writeCommand(0x10); // Shift/Scroll enable, 0 0 0 1 DS4/HS4 DS3/HS3 DS2/HS2 DS1/HS1 (Ext Instr Set 1)
wim	32:59c4b8f648d4	689
wim	32:59c4b8f648d4	690
wim	32:59c4b8f648d4	691	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
wim	32:59c4b8f648d4	692	// Select Std Instr set, Select IS=0
wim	32:59c4b8f648d4	693
wim	32:59c4b8f648d4	694	break; // case SSD1803 Controller
wim	32:59c4b8f648d4	695
wim	29:a3663151aa65	696
wim	32:59c4b8f648d4	697	// Note1: The PCF21XX family of controllers has several types that dont have an onboard voltage generator for V-LCD.
wim	32:59c4b8f648d4	698	// You must supply this LCD voltage externally and not try to enable VGen.
wim	32:59c4b8f648d4	699	// Note2: The early versions of PCF2116 controllers (eg PCF2116C) can not generate sufficiently negative voltage for the LCD at a VDD of 3V3.
wim	32:59c4b8f648d4	700	// You must supply this voltage externally and not enable VGen or you must use a higher VDD (e.g. 5V) and enable VGen.
wim	32:59c4b8f648d4	701	// More recent versions of the controller (eg PCF2116K) have an improved VGen that will work with 3V3.
wim	32:59c4b8f648d4	702	// Note3: See datasheet, PCF2116 and other types provide a V0 pin to control the LCD contrast voltage that is provided by VGen. This pins allows
wim	32:59c4b8f648d4	703	// contrast control similar to that of pin 3 on the standard 14pin LCD module connector.
wim	32:59c4b8f648d4	704	// You can disable VGen by connecting Vo to VDD. VLCD will then be used directly as LCD voltage.
wim	32:59c4b8f648d4	705	// Note4: PCF2113 and PCF2119 are different wrt to VLCD generator! There is no V0 pin. The contrast voltage is software controlled by setting the VA and VB registers.
wim	32:59c4b8f648d4	706	// Vgen is automatically switched off when the contrast voltage VA or VB is set to 0x00. Note that certain limits apply to allowed values for VA and VB.
wim	32:59c4b8f648d4	707	// Note5: See datasheet, members of the PCF21XX family support different numbers of rows/columns. Not all can support 3 or 4 rows.
wim	32:59c4b8f648d4	708	// Note6: See datasheet, the PCF21XX-C and PCF21XX-K use a non-standard character set. This may result is strange looking text when not corrected..
wim	32:59c4b8f648d4	709
wim	34:e5a0dcb43ecc	710	case PCF2103_3V3:
wim	34:e5a0dcb43ecc	711	// PCF2103 controller: No Voltage generator for VLCD, VDD=3V3..5V, VLCD input controls contrast voltage.
wim	34:e5a0dcb43ecc	712	// Initialise Display configuration
wim	34:e5a0dcb43ecc	713	switch (_type) {
wim	34:e5a0dcb43ecc	714	case LCD24x1:
wim	34:e5a0dcb43ecc	715	_function = 0x00; //FUNCTION SET 0 0 1 DL=0 4-bit, 0, M=0 1-line/24 chars display mode, 0, H=0
wim	34:e5a0dcb43ecc	716	//Note: 4 bit mode is ignored for I2C mode
wim	34:e5a0dcb43ecc	717	break;
wim	34:e5a0dcb43ecc	718
wim	34:e5a0dcb43ecc	719	// case LCD12x1D: //Special mode for PCF21XX, Only top line used
wim	34:e5a0dcb43ecc	720	case LCD12x2:
wim	34:e5a0dcb43ecc	721	_function = 0x04; //FUNCTION SET 0 0 1 DL=0 4-bit, 0, M=1 2-line/12 chars display mode, 0, H=0
wim	34:e5a0dcb43ecc	722	//Note: 4 bit mode is ignored for I2C mode
wim	34:e5a0dcb43ecc	723	break;
wim	34:e5a0dcb43ecc	724
wim	34:e5a0dcb43ecc	725	default:
wim	34:e5a0dcb43ecc	726	error("Error: LCD Controller type does not support this Display type\n\r");
wim	34:e5a0dcb43ecc	727	break;
wim	34:e5a0dcb43ecc	728
wim	34:e5a0dcb43ecc	729	} // switch type
wim	34:e5a0dcb43ecc	730
wim	34:e5a0dcb43ecc	731	_writeCommand(0x20 \| _function \| 0x01); // Set function, Select Instr Set = 1
wim	34:e5a0dcb43ecc	732	wait_ms(10); // Wait 10ms to ensure powered up
wim	34:e5a0dcb43ecc	733
wim	34:e5a0dcb43ecc	734	// Note: Display from GA628 shows 12 chars. This is actually the right half of a 24x1 display. The commons have been connected in reverse order.
wim	34:e5a0dcb43ecc	735	_writeCommand(0x05); // Display Conf Set 0000 0, 1, P=0, Q=1 (Instr. Set 1)
wim	34:e5a0dcb43ecc	736
wim	34:e5a0dcb43ecc	737	_writeCommand(0x02); // Screen Config 0000 001, L=0 (Instr. Set 1)
wim	34:e5a0dcb43ecc	738	_writeCommand(0x08); // ICON Conf 0000 1, IM=0 (Char mode), IB=0 (no Icon blink), 0 (Instr. Set 1)
wim	34:e5a0dcb43ecc	739
wim	34:e5a0dcb43ecc	740	_writeCommand(0x20 \| _function); // Set function, Select Instr Set = 0
wim	34:e5a0dcb43ecc	741
wim	36:9f5f86dfd44a	742	#if(0)
wim	34:e5a0dcb43ecc	743	// Select CG RAM
wim	34:e5a0dcb43ecc	744	_writeCommand(0x40); //Set CG-RAM address, 8 sequential locations needed per UDC
wim	34:e5a0dcb43ecc	745	// Store UDC/Icon pattern:
wim	34:e5a0dcb43ecc	746	// 3 x 8 rows x 5 bits = 120 bits for Normal pattern (UDC 0..2) and
wim	34:e5a0dcb43ecc	747	// 3 x 8 rows x 5 bits = 120 bits for Blink pattern (UDC 4..6)
wim	34:e5a0dcb43ecc	748	for (int i=0; i<(8 * 8); i++) {
wim	34:e5a0dcb43ecc	749	// _writeData(0x1F); // All On
wim	34:e5a0dcb43ecc	750	_writeData(0x00); // All Off
wim	34:e5a0dcb43ecc	751	}
wim	36:9f5f86dfd44a	752	#endif
wim	34:e5a0dcb43ecc	753	break; // case PCF2103_3V3 Controller
wim	34:e5a0dcb43ecc	754
wim	30:033048611c01	755	case PCF2113_3V3:
wim	32:59c4b8f648d4	756	// PCF2113 controller: Initialise Voltage booster for VLCD. VDD=3V3. VA and VB control contrast.
wim	29:a3663151aa65	757	// Initialise Display configuration
wim	29:a3663151aa65	758	switch (_type) {
wim	29:a3663151aa65	759	// case LCD12x1:
wim	33:900a94bc7585	760	// _function = 0x02; // FUNCTION SET 0 0 1 DL=0 4 bit, 0, M=0 1-line/12 chars display mode, SL=1, IS=0
wim	32:59c4b8f648d4	761	// Note: 4 bit mode is ignored for I2C mode
wim	29:a3663151aa65	762	case LCD24x1:
wim	33:900a94bc7585	763	_function = 0x00; // FUNCTION SET 0 0 1 DL=0 4 bit, 0, M=0 1-line/24 chars display mode, SL=0, IS=0
wim	32:59c4b8f648d4	764	// Note: 4 bit mode is ignored for I2C mode
wim	30:033048611c01	765	break;
wim	30:033048611c01	766
wim	30:033048611c01	767	case LCD12x2:
wim	33:900a94bc7585	768	_function = 0x04; // FUNCTION SET 0 0 1 DL=0 4 bit, 0, M=1 2-line/12 chars display mode, SL=0, IS=0
wim	30:033048611c01	769	break;
wim	30:033048611c01	770
wim	30:033048611c01	771	default:
wim	30:033048611c01	772	error("Error: LCD Controller type does not support this Display type\n\r");
wim	30:033048611c01	773	break;
wim	30:033048611c01	774
wim	30:033048611c01	775	} // switch type
wim	30:033048611c01	776
wim	32:59c4b8f648d4	777	// Init special features
wim	33:900a94bc7585	778	_writeCommand(0x20 \| _function \| 0x01); // Set function, Select Instr Set = 1
wim	33:900a94bc7585	779
wim	33:900a94bc7585	780	_writeCommand(0x04); // Display Conf Set 0000 0, 1, P=0, Q=0 (Instr. Set 1)
wim	33:900a94bc7585	781	_writeCommand(0x10); // Temp Compensation Set 0001 0, 0, TC1=0, TC2=0 (Instr. Set 1)
wim	33:900a94bc7585	782	// _writeCommand(0x42); // HV GEN 0100 S1=1, S2=0 (2x multiplier) (Instr. Set 1)
wim	33:900a94bc7585	783	_writeCommand(0x40 \| (LCD_PCF2_S12 & 0x03)); // HV Gen 0100 S1=1, S2=0 (2x multiplier) (Instr. Set 1)
wim	32:59c4b8f648d4	784
wim	32:59c4b8f648d4	785	_contrast = LCD_PCF2_CONTRAST;
wim	33:900a94bc7585	786	_writeCommand(0x80 \| 0x00 \| (_contrast & 0x3F)); // VLCD_set (Instr. Set 1) 1, V=0, VA=contrast
wim	33:900a94bc7585	787	_writeCommand(0x80 \| 0x40 \| (_contrast & 0x3F)); // VLCD_set (Instr. Set 1) 1, V=1, VB=contrast
wim	32:59c4b8f648d4	788	wait_ms(10); // Wait 10ms to ensure powered up
wim	32:59c4b8f648d4	789
wim	33:900a94bc7585	790	_writeCommand(0x02); // Screen Config 0000 001, L=0 (Instr. Set 1)
wim	33:900a94bc7585	791	_writeCommand(0x08); // ICON Conf 0000 1, IM=0 (Char mode), IB=0 (no icon blink) DM=0 (no direct mode) (Instr. Set 1)
wim	33:900a94bc7585	792
wim	33:900a94bc7585	793	_writeCommand(0x20 \| _function); // Set function, Select Instr Set = 0
wim	32:59c4b8f648d4	794
wim	30:033048611c01	795	break; // case PCF2113_3V3 Controller
wim	30:033048611c01	796
wim	30:033048611c01	797
wim	32:59c4b8f648d4	798	// case PCF2113_5V:
wim	32:59c4b8f648d4	799	// PCF2113 controller: No Voltage generator for VLCD. VDD=5V. Contrast voltage controlled by VA or VB.
wim	32:59c4b8f648d4	800	//@TODO
wim	32:59c4b8f648d4	801
wim	30:033048611c01	802
wim	30:033048611c01	803	case PCF2116_3V3:
wim	32:59c4b8f648d4	804	// PCF2116 controller: Voltage generator for VLCD. VDD=5V. V0 controls contrast voltage.
wim	30:033048611c01	805	// Initialise Display configuration
wim	30:033048611c01	806	switch (_type) {
wim	30:033048611c01	807	// case LCD12x1:
wim	30:033048611c01	808	// case LCD12x2:
wim	30:033048611c01	809	case LCD24x1:
wim	34:e5a0dcb43ecc	810	_writeCommand(0x22); //FUNCTION SET 0 0 1 DL=0 4-bit, N=0/M=0 1-line/24 chars display mode, G=1 Vgen on, 0
wim	29:a3663151aa65	811	//Note: 4 bit mode is ignored for I2C mode
wim	29:a3663151aa65	812	wait_ms(10); // Wait 10ms to ensure powered up
wim	29:a3663151aa65	813	break;
wim	29:a3663151aa65	814
wim	32:59c4b8f648d4	815	case LCD12x3D: // Special mode for KS0078 and PCF21XX
wim	32:59c4b8f648d4	816	case LCD12x3D1: // Special mode for PCF21XX
wim	32:59c4b8f648d4	817	case LCD12x4D: // Special mode for PCF21XX:
wim	34:e5a0dcb43ecc	818	_writeCommand(0x2E); //FUNCTION SET 0 0 1 DL=0 4-bit, N=1/M=1 4-line/12 chars display mode, G=1 VGen on, 0
wim	29:a3663151aa65	819	//Note: 4 bit mode is ignored for I2C mode
wim	29:a3663151aa65	820	wait_ms(10); // Wait 10ms to ensure powered up
wim	29:a3663151aa65	821	break;
wim	30:033048611c01	822
wim	30:033048611c01	823	case LCD24x2:
wim	34:e5a0dcb43ecc	824	_writeCommand(0x2A); //FUNCTION SET 0 0 1 DL=0 4-bit, N=1/M=0 2-line/24 chars display mode, G=1 VGen on, 0
wim	29:a3663151aa65	825	//Note: 4 bit mode is ignored for I2C mode
wim	30:033048611c01	826	wait_ms(10); // Wait 10ms to ensure powered up
wim	32:59c4b8f648d4	827	break;
wim	32:59c4b8f648d4	828
wim	30:033048611c01	829	default:
wim	30:033048611c01	830	error("Error: LCD Controller type does not support this Display type\n\r");
wim	30:033048611c01	831	break;
wim	30:033048611c01	832
wim	29:a3663151aa65	833	} // switch type
wim	29:a3663151aa65	834
wim	30:033048611c01	835	break; // case PCF2116_3V3 Controller
wim	29:a3663151aa65	836
wim	32:59c4b8f648d4	837
wim	32:59c4b8f648d4	838	//Experimental for cellphone 3-line display, SA=0x74, No Ack supported, Character set C or K, DL = 8 bit, N=0,M=1 (reserved mode !!), external VLCD -2V5
wim	32:59c4b8f648d4	839	//@TODO
wim	32:59c4b8f648d4	840	case PCF2116_5V:
wim	32:59c4b8f648d4	841	// PCF2116 controller: No Voltage generator for VLCD. VDD=5V. V0 controls contrast voltage.
wim	32:59c4b8f648d4	842	// Initialise Display configuration
wim	32:59c4b8f648d4	843	switch (_type) {
wim	32:59c4b8f648d4	844	// case LCD12x1:
wim	32:59c4b8f648d4	845	// case LCD12x2:
wim	32:59c4b8f648d4	846	// case LCD24x1:
wim	34:e5a0dcb43ecc	847	// _writeCommand(0x20); //FUNCTION SET 0 0 1 DL=0 4-bit, N=0/M=0 1-line/24 chars display mode, G=0 no Vgen, 0
wim	32:59c4b8f648d4	848	//Note: 4 bit mode is ignored for I2C mode
wim	32:59c4b8f648d4	849	// wait_ms(10); // Wait 10ms to ensure powered up
wim	32:59c4b8f648d4	850	// break;
wim	32:59c4b8f648d4	851
wim	32:59c4b8f648d4	852	case LCD12x3D: // Special mode for KS0078 and PCF21XX
wim	32:59c4b8f648d4	853	case LCD12x3D1: // Special mode for PCF21XX
wim	32:59c4b8f648d4	854	case LCD12x4D: // Special mode for PCF21XX:
wim	32:59c4b8f648d4	855	// _writeCommand(0x34); //FUNCTION SET 8 bit, N=0/M=1 4-line/12 chars display mode OK
wim	32:59c4b8f648d4	856	// _writeCommand(0x24); //FUNCTION SET 4 bit, N=0/M=1 4-line/12 chars display mode OK
wim	34:e5a0dcb43ecc	857	_writeCommand(0x2C); //FUNCTION SET 0 0 1 DL=0 4-bit, N=1/M=1 4-line/12 chars display mode, G=0 no Vgen, 0 OK
wim	32:59c4b8f648d4	858	//Note: 4 bit mode is ignored for I2C mode
wim	32:59c4b8f648d4	859	wait_ms(10); // Wait 10ms to ensure powered up
wim	32:59c4b8f648d4	860	break;
wim	32:59c4b8f648d4	861
wim	32:59c4b8f648d4	862	// case LCD24x2:
wim	32:59c4b8f648d4	863	// _writeCommand(0x28); //FUNCTION SET 4 bit, N=1/M=0 2-line/24 chars display mode
wim	32:59c4b8f648d4	864	//Note: 4 bit mode is ignored for I2C mode
wim	32:59c4b8f648d4	865	// wait_ms(10); // Wait 10ms to ensure powered up
wim	32:59c4b8f648d4	866	// break;
wim	32:59c4b8f648d4	867
wim	32:59c4b8f648d4	868	default:
wim	32:59c4b8f648d4	869	error("Error: LCD Controller type does not support this Display type\n\r");
wim	32:59c4b8f648d4	870	break;
wim	32:59c4b8f648d4	871
wim	32:59c4b8f648d4	872	} // switch type
wim	32:59c4b8f648d4	873
wim	32:59c4b8f648d4	874	break; // case PCF2116_5V Controller
wim	32:59c4b8f648d4	875
wim	32:59c4b8f648d4	876	case PCF2119_3V3:
wim	32:59c4b8f648d4	877	// PCF2119 controller: Initialise Voltage booster for VLCD. VDD=3V3. VA and VB control contrast.
wim	32:59c4b8f648d4	878	// Note1: See datasheet, the PCF2119 supports icons and provides separate constrast control for Icons and characters.
wim	32:59c4b8f648d4	879	// Note2: Vgen is switched off when the contrast voltage VA or VB is set to 0x00.
wim	32:59c4b8f648d4	880
wim	32:59c4b8f648d4	881	//POR or Hardware Reset should be applied
wim	32:59c4b8f648d4	882	wait_ms(10); // Wait 10ms to ensure powered up
wim	32:59c4b8f648d4	883
wim	32:59c4b8f648d4	884	// Initialise Display configuration
wim	32:59c4b8f648d4	885	switch (_type) {
wim	32:59c4b8f648d4	886	case LCD8x1:
wim	32:59c4b8f648d4	887	// case LCD12x1:
wim	32:59c4b8f648d4	888	case LCD16x1:
wim	34:e5a0dcb43ecc	889	_function = 0x02; // FUNCTION SET 0 0 1 DL=0 4-bit, 0 , M=0 1-line/16 chars display mode, SL=1
wim	32:59c4b8f648d4	890	// Note: 4 bit mode is ignored for I2C mode
wim	32:59c4b8f648d4	891	break;
wim	32:59c4b8f648d4	892
wim	32:59c4b8f648d4	893	case LCD24x1:
wim	32:59c4b8f648d4	894	// case LCD32x1:
wim	34:e5a0dcb43ecc	895	_function = 0x00; // FUNCTION SET 0 0 1 DL=0 4-bit, 0 , M=0 1-line/32 chars display mode, SL=0
wim	32:59c4b8f648d4	896	// Note: 4 bit mode is ignored for I2C mode
wim	32:59c4b8f648d4	897	break;
wim	32:59c4b8f648d4	898
wim	32:59c4b8f648d4	899	case LCD8x2:
wim	32:59c4b8f648d4	900	// case LCD12x2:
wim	32:59c4b8f648d4	901	case LCD16x2:
wim	34:e5a0dcb43ecc	902	_function = 0x04; // FUNCTION SET 0 0 1 DL=0 4-bit, 0, M=1 2-line/16 chars display mode, SL=0
wim	32:59c4b8f648d4	903	// Note: 4 bit mode is ignored for I2C mode
wim	32:59c4b8f648d4	904	break;
wim	32:59c4b8f648d4	905
wim	32:59c4b8f648d4	906	default:
wim	32:59c4b8f648d4	907	error("Error: LCD Controller type does not support this Display type\n\r");
wim	32:59c4b8f648d4	908	break;
wim	32:59c4b8f648d4	909
wim	32:59c4b8f648d4	910	} // switch type
wim	32:59c4b8f648d4	911
wim	32:59c4b8f648d4	912	// Init special features
wim	32:59c4b8f648d4	913	_writeCommand(0x20 \| _function \| 0x01); // Set function, Select Instruction Set = 1
wim	32:59c4b8f648d4	914
wim	32:59c4b8f648d4	915	_writeCommand(0x04); // DISP CONF SET (Instr. Set 1) 0000, 0, 1, P=0, Q=0
wim	32:59c4b8f648d4	916	_writeCommand(0x10); // TEMP CTRL SET (Instr. Set 1) 0001, 0, 0, TC1=0, TC2=0
wim	32:59c4b8f648d4	917	// _writeCommand(0x42); // HV GEN (Instr. Set 1) 0100, 0, 0, S1=1, S2=0 (2x multiplier)
wim	32:59c4b8f648d4	918	_writeCommand(0x40 \| (LCD_PCF2_S12 & 0x03)); // HV GEN (Instr. Set 1) 0100, 0, 0, S1=1, S2=0 (2x multiplier)
wim	32:59c4b8f648d4	919
wim	32:59c4b8f648d4	920	_contrast = LCD_PCF2_CONTRAST;
wim	32:59c4b8f648d4	921	_writeCommand(0x80 \| 0x00 \| (_contrast & 0x3F)); // VLCD_set (Instr. Set 1) V=0, VA=contrast
wim	32:59c4b8f648d4	922	_writeCommand(0x80 \| 0x40 \| (_contrast & 0x3F)); // VLCD_set (Instr. Set 1) V=1, VB=contrast
wim	32:59c4b8f648d4	923	wait_ms(10); // Wait 10ms to ensure powered up
wim	32:59c4b8f648d4	924
wim	32:59c4b8f648d4	925	_writeCommand(0x02); // SCRN CONF (Instr. Set 1) L=0
wim	32:59c4b8f648d4	926	_writeCommand(0x08); // ICON CONF (Instr. Set 1) IM=0 (Char mode) IB=0 (no icon blink) DM=0 (no direct mode)
wim	32:59c4b8f648d4	927
wim	32:59c4b8f648d4	928	_writeCommand(0x20 \| _function); // Select Instruction Set = 0
wim	32:59c4b8f648d4	929
wim	32:59c4b8f648d4	930	break; // case PCF2119_3V3 Controller
wim	32:59c4b8f648d4	931
wim	32:59c4b8f648d4	932	// case PCF2119_5V:
wim	32:59c4b8f648d4	933	// PCF2119 controller: No Voltage booster for VLCD. VDD=3V3. VA and VB control contrast.
wim	32:59c4b8f648d4	934	// Note1: See datasheet, the PCF2119 supports icons and provides separate constrast control for Icons and characters.
wim	32:59c4b8f648d4	935	// Note2: Vgen is switched off when the contrast voltage VA or VB is set to 0x00.
wim	30:033048611c01	936	//@TODO
wim	29:a3663151aa65	937
wim	19:c747b9e2e7b8	938	case WS0010:
wim	19:c747b9e2e7b8	939	// WS0010 OLED controller: Initialise DC/DC Voltage converter for LEDs
wim	30:033048611c01	940	// Note1: Identical to RS0010
wim	30:033048611c01	941	// Note2: supports 1 or 2 lines (and 16x100 graphics)
wim	30:033048611c01	942	// supports 4 fonts (English/Japanese (default), Western European-I, English/Russian, Western European-II)
wim	19:c747b9e2e7b8	943	// Cursor/Disp shift set 0001 SC RL 0 0
wim	19:c747b9e2e7b8	944	//
wim	30:033048611c01	945	// Mode and Power set 0001 GC PWR 1 1
wim	19:c747b9e2e7b8	946	// GC = 0 (Graph Mode=1, Char Mode=0)
wim	30:033048611c01	947	// PWR = 1 (DC/DC On/Off)
wim	30:033048611c01	948
wim	30:033048611c01	949	//@Todo: This may be needed to enable a warm reboot
wim	32:59c4b8f648d4	950	//_writeCommand(0x13); // Char mode, DC/DC off
wim	30:033048611c01	951	//wait_ms(10); // Wait 10ms to ensure powered down
wim	32:59c4b8f648d4	952	_writeCommand(0x17); // Char mode, DC/DC on
wim	30:033048611c01	953	wait_ms(10); // Wait 10ms to ensure powered up
wim	29:a3663151aa65	954
wim	29:a3663151aa65	955	// Initialise Display configuration
wim	29:a3663151aa65	956	switch (_type) {
wim	29:a3663151aa65	957	case LCD8x1: //8x1 is a regular 1 line display
wim	29:a3663151aa65	958	case LCD8x2B: //8x2B is a special case of 16x1
wim	29:a3663151aa65	959	// case LCD12x1:
wim	29:a3663151aa65	960	case LCD16x1:
wim	30:033048611c01	961	case LCD24x1:
wim	30:033048611c01	962	_writeCommand(0x20); // Function set 001 DL N F FT1 FT0
wim	30:033048611c01	963	// DL=0 (4 bits bus)
wim	30:033048611c01	964	// N=0 (1 line)
wim	30:033048611c01	965	// F=0 (5x7 dots font)
wim	30:033048611c01	966	// FT=00 (00 = Engl/Jap, 01 = WestEur1, 10 = Engl/Russian, 11 = WestEur2
wim	30:033048611c01	967	break;
wim	30:033048611c01	968
wim	32:59c4b8f648d4	969	case LCD12x3D: // Special mode for KS0078 and PCF21XX
wim	32:59c4b8f648d4	970	case LCD12x3D1: // Special mode for PCF21XX
wim	32:59c4b8f648d4	971	case LCD12x4D: // Special mode for PCF21XX:
wim	33:900a94bc7585	972	case LCD16x3G: // Special mode for ST7036
wim	30:033048611c01	973	case LCD24x4D: // Special mode for KS0078
wim	30:033048611c01	974	error("Error: LCD Controller type does not support this Display type\n\r");
wim	29:a3663151aa65	975	break;
wim	29:a3663151aa65	976
wim	29:a3663151aa65	977	default:
wim	30:033048611c01	978	// All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
wim	30:033048611c01	979	_writeCommand(0x28); // Function set 001 DL N F FT1 FT0
wim	30:033048611c01	980	// DL=0 (4 bits bus)
wim	30:033048611c01	981	// N=1 (2 lines)
wim	30:033048611c01	982	// F=0 (5x7 dots font)
wim	30:033048611c01	983	// FT=00 (00 = Engl/Jap, 01 = WestEur1, 10 = Engl/Russian, 11 = WestEur2
wim	30:033048611c01	984
wim	29:a3663151aa65	985	break;
wim	29:a3663151aa65	986	} // switch type
wim	29:a3663151aa65	987
wim	32:59c4b8f648d4	988	break; // case WS0010 Controller
wim	33:900a94bc7585	989
wim	33:900a94bc7585	990
wim	33:900a94bc7585	991	case US2066_3V3:
wim	33:900a94bc7585	992	// US2066/SSD1311 OLED controller, Initialise for VDD=3V3
wim	33:900a94bc7585	993	// Note: supports 1,2, 3 or 4 lines
wim	33:900a94bc7585	994	// case USS2066_5V:
wim	33:900a94bc7585	995	// US2066 controller, VDD=5V
wim	33:900a94bc7585	996
wim	33:900a94bc7585	997	// Initialise Display configuration
wim	33:900a94bc7585	998	switch (_type) {
wim	33:900a94bc7585	999	case LCD8x1: //8x1 is a regular 1 line display
wim	33:900a94bc7585	1000	case LCD8x2B: //8x2D is a special case of 16x1
wim	33:900a94bc7585	1001	// case LCD12x1:
wim	33:900a94bc7585	1002	case LCD16x1:
wim	33:900a94bc7585	1003	// case LCD20x1:
wim	33:900a94bc7585	1004	_function = 0x00; // Set function 0 0 1 X N DH RE(0) IS
wim	33:900a94bc7585	1005	// Saved to allow switch between Instruction sets at later time
wim	33:900a94bc7585	1006	// DL=X bit is ignored for US2066. Uses hardwired pins instead
wim	33:900a94bc7585	1007	// N=0 1 Line / 3 Line
wim	33:900a94bc7585	1008	// DH=0 Double Height disable
wim	33:900a94bc7585	1009	// IS=0
wim	33:900a94bc7585	1010
wim	33:900a94bc7585	1011	_function_1 = 0x02; // Set function, 0 0 1 X N BE RE(1) REV
wim	33:900a94bc7585	1012	// Saved to allow switch between Instruction sets at later time
wim	33:900a94bc7585	1013	// DL=X bit is ignored for US2066. Uses hardwired pins instead
wim	33:900a94bc7585	1014	// N=0 1 Line / 3 Line
wim	33:900a94bc7585	1015	// BE=0 Blink Enable off, special feature of SSD1803, US2066
wim	33:900a94bc7585	1016	// REV=0 Reverse off, special feature of SSD1803, US2066
wim	33:900a94bc7585	1017
wim	33:900a94bc7585	1018	_lines = 0x00; // Ext function set 0 0 0 0 1 FW BW NW
wim	33:900a94bc7585	1019	// NW=0 1-Line LCD (N=0)
wim	33:900a94bc7585	1020	break;
wim	33:900a94bc7585	1021
wim	33:900a94bc7585	1022	case LCD16x1C:
wim	33:900a94bc7585	1023	case LCD8x2:
wim	33:900a94bc7585	1024	case LCD16x2:
wim	33:900a94bc7585	1025	case LCD20x2:
wim	33:900a94bc7585	1026	_function = 0x08; // Set function 0 0 1 X N DH RE(0) IS
wim	33:900a94bc7585	1027	// Saved to allow switch between Instruction sets at later time
wim	33:900a94bc7585	1028	// DL=X bit is ignored for US2066. Uses hardwired pins instead
wim	33:900a94bc7585	1029	// N=1 2 line / 4 Line
wim	33:900a94bc7585	1030	// DH=0 Double Height disable
wim	33:900a94bc7585	1031	// IS=0
wim	33:900a94bc7585	1032
wim	33:900a94bc7585	1033	_function_1 = 0x0A; // Set function, 0 0 1 X N BE RE(1) REV
wim	33:900a94bc7585	1034	// Saved to allow switch between Instruction sets at later time
wim	33:900a94bc7585	1035	// DL=X bit is ignored for US2066. Uses hardwired pins instead
wim	33:900a94bc7585	1036	// N=1 2 line / 4 Line
wim	33:900a94bc7585	1037	// BE=0 Blink Enable off, special feature of SSD1803, US2066
wim	33:900a94bc7585	1038	// REV=0 Reverse off, special feature of SSD1803, US2066
wim	33:900a94bc7585	1039
wim	33:900a94bc7585	1040	_lines = 0x00; // Ext function set 0 0 0 0 1 FW BW NW
wim	33:900a94bc7585	1041	// NW=0 2-Line LCD (N=1)
wim	33:900a94bc7585	1042	break;
wim	33:900a94bc7585	1043
wim	33:900a94bc7585	1044	case LCD12x3D: // Special mode for KS0078 and PCF21XX
wim	33:900a94bc7585	1045	// case LCD12x3D1: // Special mode for KS0078 and PCF21XX
wim	33:900a94bc7585	1046	case LCD16x3D: // Special mode for KS0078, SSD1803 and US2066
wim	33:900a94bc7585	1047	// case LCD16x3D1: // Special mode for SSD1803, US2066
wim	33:900a94bc7585	1048	// case LCD20x3D: // Special mode for SSD1803, US2066
wim	33:900a94bc7585	1049	_function = 0x00; // Set function 0 0 1 X N DH RE(0) IS
wim	33:900a94bc7585	1050	// Saved to allow switch between Instruction sets at later time
wim	33:900a94bc7585	1051	// DL=X bit is ignored for US2066. Uses hardwired pins instead
wim	33:900a94bc7585	1052	// N=0 1 Line / 3 Line
wim	33:900a94bc7585	1053	// DH=0 Double Height disable
wim	33:900a94bc7585	1054	// IS=0
wim	33:900a94bc7585	1055
wim	33:900a94bc7585	1056	_function_1 = 0x02; // Set function, 0 0 1 X N BE RE(1) REV
wim	33:900a94bc7585	1057	// Saved to allow switch between Instruction sets at later time
wim	33:900a94bc7585	1058	// DL=X bit is ignored for US2066. Uses hardwired pins instead
wim	33:900a94bc7585	1059	// N=0 1 Line / 3 Line
wim	33:900a94bc7585	1060	// BE=0 Blink Enable off, special feature of SSD1803, US2066
wim	33:900a94bc7585	1061	// REV=0 Reverse off, special feature of SSD1803, US2066
wim	33:900a94bc7585	1062
wim	33:900a94bc7585	1063	_lines = 0x00; // Ext function set 0 0 0 0 1 FW BW NW
wim	33:900a94bc7585	1064	// NW=1 3-Line LCD (N=0)
wim	33:900a94bc7585	1065	break;
wim	33:900a94bc7585	1066
wim	33:900a94bc7585	1067	case LCD20x4D: // Special mode for SSD1803, US2066
wim	33:900a94bc7585	1068	_function = 0x08; // Set function 0 0 1 X N DH RE(0) IS
wim	33:900a94bc7585	1069	// Saved to allow switch between Instruction sets at later time
wim	33:900a94bc7585	1070	// DL=X bit is ignored for US2066. Uses hardwired pins instead
wim	33:900a94bc7585	1071	// N=1 2 line / 4 Line
wim	33:900a94bc7585	1072	// DH=0 Double Height disable
wim	33:900a94bc7585	1073	// IS=0
wim	33:900a94bc7585	1074
wim	33:900a94bc7585	1075	_function_1 = 0x0A; // Set function, 0 0 1 DL N BE RE(1) REV
wim	33:900a94bc7585	1076	// Saved to allow switch between Instruction sets at later time
wim	33:900a94bc7585	1077	// DL=0 bit is ignored for US2066. Uses hardwired pins instead
wim	33:900a94bc7585	1078	// N=1 2 line / 4 Line
wim	33:900a94bc7585	1079	// BE=0 Blink Enable off, special feature of SSD1803, US2066
wim	33:900a94bc7585	1080	// REV=0 Reverse off, special feature of SSD1803, US2066
wim	33:900a94bc7585	1081
wim	33:900a94bc7585	1082	_lines = 0x01; // Ext function set 0 0 0 0 1 FW BW NW
wim	33:900a94bc7585	1083	// NW=1 4-Line LCD (N=1)
wim	33:900a94bc7585	1084	break;
wim	33:900a94bc7585	1085
wim	33:900a94bc7585	1086	// case LCD24x1:
wim	33:900a94bc7585	1087	// case LCD16x3G: // Special mode for ST7036
wim	33:900a94bc7585	1088	// case LCD24x4D: // Special mode for KS0078
wim	33:900a94bc7585	1089	default:
wim	33:900a94bc7585	1090	error("Error: LCD Controller type does not support this Display type\n\r");
wim	33:900a94bc7585	1091	break;
wim	33:900a94bc7585	1092
wim	33:900a94bc7585	1093	} // switch type
wim	33:900a94bc7585	1094
wim	34:e5a0dcb43ecc	1095	_writeCommand(0x00); // NOP, make sure to sync SPI
wim	33:900a94bc7585	1096
wim	33:900a94bc7585	1097	// init special features
wim	33:900a94bc7585	1098	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 X N BE RE(1) REV
wim	33:900a94bc7585	1099	// Select Extended Instruction Set
wim	33:900a94bc7585	1100
wim	33:900a94bc7585	1101	_writeCommand(0x71); // Function Select A: 0 1 1 1 0 0 0 1 (Ext Instr Set)
wim	33:900a94bc7585	1102	_writeData(0x00); // Disable Internal VDD
wim	33:900a94bc7585	1103
wim	33:900a94bc7585	1104	_writeCommand(0x79); // Function Select OLED: 0 1 1 1 1 0 0 1 (Ext Instr Set)
wim	33:900a94bc7585	1105
wim	33:900a94bc7585	1106	_writeCommand(0xD5); // Display Clock Divide Ratio: 1 1 0 1 0 1 0 1 (Ext Instr Set, OLED Instr Set)
wim	33:900a94bc7585	1107	_writeCommand(0x70); // Display Clock Divide Ratio value: 0 1 1 1 0 0 0 0 (Ext Instr Set, OLED Instr Set)
wim	33:900a94bc7585	1108
wim	33:900a94bc7585	1109	_writeCommand(0x78); // Function Disable OLED: 0 1 1 1 1 0 0 0 (Ext Instr Set)
wim	33:900a94bc7585	1110
wim	33:900a94bc7585	1111	// _writeCommand(0x06); // Set ext entry mode, 0 0 0 0 0 1 BDC=1 COM1-32, BDS=0 SEG100-1 "Bottom View" (Ext Instr Set)
wim	33:900a94bc7585	1112	_writeCommand(0x05); // Set ext entry mode, 0 0 0 0 0 1 BDC=0 COM32-1, BDS=1 SEG1-100 "Top View" (Ext Instr Set)
wim	33:900a94bc7585	1113
wim	33:900a94bc7585	1114	_writeCommand(0x08 \| _lines); // Set ext function 0 0 0 0 1 FW BW NW 1,2,3 or 4 lines (Ext Instr Set)
wim	33:900a94bc7585	1115
wim	34:e5a0dcb43ecc	1116	// _writeCommand(0x1C); // Double Height, 0 0 0 1 UD2=1, UD1=1, X, DH'=0 (Ext Instr Set)
wim	33:900a94bc7585	1117	// // Default
wim	33:900a94bc7585	1118
wim	33:900a94bc7585	1119	_writeCommand(0x72); // Function Select B: 0 1 1 1 0 0 1 0 (Ext Instr Set)
wim	33:900a94bc7585	1120	_writeData(0x01); // Select ROM A (CGRAM 8, CGROM 248)
wim	33:900a94bc7585	1121
wim	33:900a94bc7585	1122	_writeCommand(0x79); // Function Select OLED: 0 1 1 1 1 0 0 1 (Ext Instr Set)
wim	33:900a94bc7585	1123
wim	33:900a94bc7585	1124	_writeCommand(0xDA); // Set Segm Pins Config: 1 1 0 1 1 0 1 0 (Ext Instr Set, OLED)
wim	33:900a94bc7585	1125	_writeCommand(0x10); // Set Segm Pins Config value: Altern Odd/Even, Disable Remap (Ext Instr Set, OLED)
wim	33:900a94bc7585	1126
wim	33:900a94bc7585	1127	_writeCommand(0xDC); // Function Select C: 1 1 0 1 1 1 0 0 (Ext Instr Set, OLED)
wim	33:900a94bc7585	1128	// _writeCommand(0x00); // Set internal VSL, GPIO pin HiZ (always read low)
wim	33:900a94bc7585	1129	_writeCommand(0x80); // Set external VSL, GPIO pin HiZ (always read low)
wim	33:900a94bc7585	1130
wim	33:900a94bc7585	1131	_contrast = LCD_US20_CONTRAST;
wim	33:900a94bc7585	1132	_writeCommand(0x81); // Set Contrast Control: 1 0 0 0 0 0 0 1 (Ext Instr Set, OLED)
wim	33:900a94bc7585	1133	_writeCommand((_contrast << 2) \| 0x03); // Set Contrast Value: 8 bits, use 6 bits for compatibility
wim	33:900a94bc7585	1134
wim	33:900a94bc7585	1135	_writeCommand(0xD9); // Set Phase Length: 1 1 0 1 1 0 0 1 (Ext Instr Set, OLED)
wim	33:900a94bc7585	1136	_writeCommand(0xF1); // Set Phase Length Value:
wim	33:900a94bc7585	1137
wim	33:900a94bc7585	1138	_writeCommand(0xDB); // Set VCOMH Deselect Lvl: 1 1 0 1 1 0 1 1 (Ext Instr Set, OLED)
wim	33:900a94bc7585	1139	_writeCommand(0x30); // Set VCOMH Deselect Value: 0.83 x VCC
wim	33:900a94bc7585	1140
wim	33:900a94bc7585	1141	wait_ms(10); // Wait 10ms to ensure powered up
wim	33:900a94bc7585	1142
wim	33:900a94bc7585	1143	//Test Fade/Blinking. Hard Blink on/off, No fade in/out ??
wim	33:900a94bc7585	1144	// _writeCommand(0x23); // Set (Ext Instr Set, OLED)
wim	33:900a94bc7585	1145	// _writeCommand(0x3F); // Set interval 128 frames
wim	33:900a94bc7585	1146	//End Test Blinking
wim	33:900a94bc7585	1147
wim	33:900a94bc7585	1148	_writeCommand(0x78); // Function Disable OLED: 0 1 1 1 1 0 0 0 (Ext Instr Set)
wim	33:900a94bc7585	1149
wim	33:900a94bc7585	1150	_writeCommand(0x20 \| _function \| 0x01); // Set function, 0 0 1 X N DH RE(0) IS=1 Select Instruction Set 1
wim	33:900a94bc7585	1151	// Select Std Instr set, Select IS=1
wim	33:900a94bc7585	1152
wim	33:900a94bc7585	1153	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 X N BE RE(1) REV
wim	33:900a94bc7585	1154	// Select Ext Instr Set, IS=1
wim	33:900a94bc7585	1155	_writeCommand(0x10); // Shift/Scroll enable, 0 0 0 1 DS4/HS4 DS3/HS3 DS2/HS2 DS1/HS1 (Ext Instr Set, IS=1)
wim	33:900a94bc7585	1156
wim	33:900a94bc7585	1157	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
wim	34:e5a0dcb43ecc	1158	// Select Std Instr set, Select IS=0
wim	33:900a94bc7585	1159	break; // case US2066/SSD1311 Controller
wim	33:900a94bc7585	1160
wim	34:e5a0dcb43ecc	1161	//not yet tested on hardware
wim	34:e5a0dcb43ecc	1162	case PT6314 :
wim	34:e5a0dcb43ecc	1163	// Initialise Display configuration
wim	34:e5a0dcb43ecc	1164	switch (_type) {
wim	34:e5a0dcb43ecc	1165	case LCD8x1: //8x1 is a regular 1 line display
wim	34:e5a0dcb43ecc	1166	case LCD8x2B: //8x2B is a special case of 16x1
wim	34:e5a0dcb43ecc	1167	// case LCD12x1:
wim	34:e5a0dcb43ecc	1168	case LCD16x1:
wim	34:e5a0dcb43ecc	1169	case LCD20x1:
wim	34:e5a0dcb43ecc	1170	case LCD24x1:
wim	34:e5a0dcb43ecc	1171	_function = 0x00; // Function set 001 DL N X BR1 BR0
wim	34:e5a0dcb43ecc	1172	// DL=0 (4 bits bus)
wim	34:e5a0dcb43ecc	1173	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	34:e5a0dcb43ecc	1174	// N=0 (1 line)
wim	34:e5a0dcb43ecc	1175	// X
wim	34:e5a0dcb43ecc	1176	// BR1=0 (2 significant bits for brightness
wim	34:e5a0dcb43ecc	1177	// BR0=0
wim	34:e5a0dcb43ecc	1178	// 0x0 = 100%
wim	34:e5a0dcb43ecc	1179	// 0x1 = 75%
wim	34:e5a0dcb43ecc	1180	// 0x2 = 50%
wim	34:e5a0dcb43ecc	1181	// 0x3 = 25%
wim	34:e5a0dcb43ecc	1182
wim	34:e5a0dcb43ecc	1183	break;
wim	34:e5a0dcb43ecc	1184
wim	34:e5a0dcb43ecc	1185	// All other valid LCD types are initialised as 2 Line displays
wim	34:e5a0dcb43ecc	1186	case LCD8x2:
wim	34:e5a0dcb43ecc	1187	case LCD16x2:
wim	34:e5a0dcb43ecc	1188	case LCD20x2:
wim	34:e5a0dcb43ecc	1189	case LCD24x2:
wim	34:e5a0dcb43ecc	1190	_function = 0x08; // Function set 001 DL N X BR1 BR2
wim	34:e5a0dcb43ecc	1191	// DL=0 (4 bits bus)
wim	34:e5a0dcb43ecc	1192	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	34:e5a0dcb43ecc	1193	// N=1 (2 lines)
wim	34:e5a0dcb43ecc	1194	// X
wim	34:e5a0dcb43ecc	1195	// BR1=0 (2 significant bits for brightness
wim	34:e5a0dcb43ecc	1196	// BR0=0
wim	34:e5a0dcb43ecc	1197	break;
wim	34:e5a0dcb43ecc	1198
wim	34:e5a0dcb43ecc	1199	default:
wim	34:e5a0dcb43ecc	1200	error("Error: LCD Controller type does not support this Display type\n\r");
wim	34:e5a0dcb43ecc	1201	break;
wim	34:e5a0dcb43ecc	1202	} // switch type
wim	34:e5a0dcb43ecc	1203
wim	34:e5a0dcb43ecc	1204	_contrast = LCD_PT63_CONTRAST;
wim	34:e5a0dcb43ecc	1205	_writeCommand(0x20 \| _function \| ((~_contrast) >> 4)); // Invert and shift to use 2 MSBs
wim	34:e5a0dcb43ecc	1206	break; // case PT6314 Controller (VFD)
wim	29:a3663151aa65	1207
wim	37:ce348c002929	1208	case ST7066_ACM: // ST7066 4/8 bit, I2C on ACM1602 using a PIC
wim	19:c747b9e2e7b8	1209	default:
wim	32:59c4b8f648d4	1210	// Devices fully compatible to HD44780 that do not use any DC/DC Voltage converters but external VLCD, no icons etc
wim	10:dd9b3a696acd	1211
wim	29:a3663151aa65	1212	// Initialise Display configuration
wim	29:a3663151aa65	1213	switch (_type) {
wim	29:a3663151aa65	1214	case LCD8x1: //8x1 is a regular 1 line display
wim	29:a3663151aa65	1215	case LCD8x2B: //8x2B is a special case of 16x1
wim	29:a3663151aa65	1216	// case LCD12x1:
wim	29:a3663151aa65	1217	case LCD16x1:
wim	30:033048611c01	1218	// case LCD20x1:
wim	29:a3663151aa65	1219	case LCD24x1:
wim	30:033048611c01	1220	// case LCD40x1:
wim	32:59c4b8f648d4	1221	_function = 0x00; // Function set 001 DL N F - -
wim	29:a3663151aa65	1222	// DL=0 (4 bits bus)
wim	29:a3663151aa65	1223	// N=0 (1 line)
wim	29:a3663151aa65	1224	// F=0 (5x7 dots font)
wim	29:a3663151aa65	1225	break;
wim	29:a3663151aa65	1226
wim	32:59c4b8f648d4	1227	case LCD12x3D: // Special mode for KS0078 and PCF21XX
wim	32:59c4b8f648d4	1228	case LCD12x3D1: // Special mode for KS0078 and PCF21XX
wim	32:59c4b8f648d4	1229	case LCD12x4D: // Special mode for KS0078 and PCF21XX:
wim	33:900a94bc7585	1230	case LCD16x3D: // Special mode for KS0078
wim	32:59c4b8f648d4	1231	// case LCD16x3D1: // Special mode for KS0078
wim	30:033048611c01	1232	// case LCD24x3D: // Special mode for KS0078
wim	32:59c4b8f648d4	1233	// case LCD24x3D1: // Special mode for KS0078
wim	30:033048611c01	1234	case LCD24x4D: // Special mode for KS0078
wim	30:033048611c01	1235	error("Error: LCD Controller type does not support this Display type\n\r");
wim	30:033048611c01	1236	break;
wim	30:033048611c01	1237
wim	30:033048611c01	1238	// All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
wim	29:a3663151aa65	1239	default:
wim	32:59c4b8f648d4	1240	_function = 0x08; // Function set 001 DL N F - -
wim	29:a3663151aa65	1241	// DL=0 (4 bits bus)
wim	29:a3663151aa65	1242	// Note: 4 bit mode is ignored for native SPI and I2C devices
wim	29:a3663151aa65	1243	// N=1 (2 lines)
wim	29:a3663151aa65	1244	// F=0 (5x7 dots font, only option for 2 line display)
wim	32:59c4b8f648d4	1245	// - (Don't care)
wim	29:a3663151aa65	1246	break;
wim	29:a3663151aa65	1247	} // switch type
wim	10:dd9b3a696acd	1248
wim	34:e5a0dcb43ecc	1249	_writeCommand(0x20 \| _function);
wim	29:a3663151aa65	1250	break; // case default Controller
wim	29:a3663151aa65	1251
wim	34:e5a0dcb43ecc	1252	} // switch Controller specific initialisations
wim	10:dd9b3a696acd	1253
wim	30:033048611c01	1254	// Controller general initialisations
wim	32:59c4b8f648d4	1255	// _writeCommand(0x01); // cls, and set cursor to 0
wim	32:59c4b8f648d4	1256	// wait_ms(10); // The CLS command takes 1.64 ms.
wim	32:59c4b8f648d4	1257	// // Since we are not using the Busy flag, Lets be safe and take 10 ms
wim	28:30fa94f7341c	1258
wim	28:30fa94f7341c	1259	_writeCommand(0x02); // Return Home
wim	28:30fa94f7341c	1260	// Cursor Home, DDRAM Address to Origin
wim	28:30fa94f7341c	1261
wim	28:30fa94f7341c	1262	_writeCommand(0x06); // Entry Mode 0000 0 1 I/D S
wim	13:24506ba22480	1263	// Cursor Direction and Display Shift
wim	28:30fa94f7341c	1264	// I/D=1 (Cur incr)
wim	28:30fa94f7341c	1265	// S=0 (No display shift)
wim	10:dd9b3a696acd	1266
wim	29:a3663151aa65	1267	_writeCommand(0x14); // Cursor or Display shift 0001 S/C R/L x x
wim	29:a3663151aa65	1268	// S/C=0 Cursor moves
wim	29:a3663151aa65	1269	// R/L=1 Right
wim	29:a3663151aa65	1270	//
wim	29:a3663151aa65	1271
wim	13:24506ba22480	1272	// _writeCommand(0x0C); // Display Ctrl 0000 1 D C B
wim	17:652ab113bc2e	1273	// // Display On, Cursor Off, Blink Off
wim	36:9f5f86dfd44a	1274
wim	21:9eb628d9e164	1275	setCursor(CurOff_BlkOff);
wim	21:9eb628d9e164	1276	setMode(DispOn);
simon	1:ac48b187213c	1277	}
simon	1:ac48b187213c	1278
wim	8:03116f75b66e	1279
wim	21:9eb628d9e164	1280	/** Clear the screen, Cursor home.
wim	21:9eb628d9e164	1281	*/
wim	21:9eb628d9e164	1282	void TextLCD_Base::cls() {
wim	15:b70ebfffb258	1283
wim	15:b70ebfffb258	1284	// Select and configure second LCD controller when needed
wim	15:b70ebfffb258	1285	if(_type==LCD40x4) {
wim	21:9eb628d9e164	1286	_ctrl_idx=_LCDCtrl_1; // Select 2nd controller
wim	15:b70ebfffb258	1287
wim	15:b70ebfffb258	1288	// Second LCD controller Cursor always Off
wim	21:9eb628d9e164	1289	_setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
wim	15:b70ebfffb258	1290
wim	15:b70ebfffb258	1291	// Second LCD controller Clearscreen
wim	27:22d5086f6ba6	1292	_writeCommand(0x01); // cls, and set cursor to 0
wim	29:a3663151aa65	1293	wait_ms(10); // The CLS command takes 1.64 ms.
wim	29:a3663151aa65	1294	// Since we are not using the Busy flag, Lets be safe and take 10 ms
wim	15:b70ebfffb258	1295
wim	21:9eb628d9e164	1296	_ctrl_idx=_LCDCtrl_0; // Select primary controller
wim	15:b70ebfffb258	1297	}
wim	15:b70ebfffb258	1298
wim	15:b70ebfffb258	1299	// Primary LCD controller Clearscreen
wim	27:22d5086f6ba6	1300	_writeCommand(0x01); // cls, and set cursor to 0
wim	29:a3663151aa65	1301	wait_ms(10); // The CLS command takes 1.64 ms.
wim	29:a3663151aa65	1302	// Since we are not using the Busy flag, Lets be safe and take 10 ms
wim	15:b70ebfffb258	1303
wim	15:b70ebfffb258	1304	// Restore cursormode on primary LCD controller when needed
wim	15:b70ebfffb258	1305	if(_type==LCD40x4) {
wim	17:652ab113bc2e	1306	_setCursorAndDisplayMode(_currentMode,_currentCursor);
wim	15:b70ebfffb258	1307	}
wim	15:b70ebfffb258	1308
wim	29:a3663151aa65	1309	setAddress(0, 0); // Reset Cursor location
wim	32:59c4b8f648d4	1310	// Note: This is needed because some displays (eg PCF21XX) don't use line 0 in the '3 Line' mode.
simon	1:ac48b187213c	1311	}
simon	1:ac48b187213c	1312
wim	29:a3663151aa65	1313	/** Locate cursor to a screen column and row
wim	29:a3663151aa65	1314	*
wim	29:a3663151aa65	1315	* @param column The horizontal position from the left, indexed from 0
wim	29:a3663151aa65	1316	* @param row The vertical position from the top, indexed from 0
wim	29:a3663151aa65	1317	*/
wim	21:9eb628d9e164	1318	void TextLCD_Base::locate(int column, int row) {
wim	15:b70ebfffb258	1319
wim	15:b70ebfffb258	1320	// setAddress() does all the heavy lifting:
wim	15:b70ebfffb258	1321	// check column and row sanity,
wim	15:b70ebfffb258	1322	// switch controllers for LCD40x4 if needed
wim	15:b70ebfffb258	1323	// switch cursor for LCD40x4 if needed
wim	15:b70ebfffb258	1324	// set the new memory address to show cursor at correct location
wim	32:59c4b8f648d4	1325	setAddress(column, row);
wim	15:b70ebfffb258	1326	}
wim	30:033048611c01	1327
wim	15:b70ebfffb258	1328
wim	21:9eb628d9e164	1329	/** Write a single character (Stream implementation)
wim	21:9eb628d9e164	1330	*/
wim	21:9eb628d9e164	1331	int TextLCD_Base::_putc(int value) {
wim	15:b70ebfffb258	1332	int addr;
wim	15:b70ebfffb258	1333
wim	15:b70ebfffb258	1334	if (value == '\n') {
wim	15:b70ebfffb258	1335	//No character to write
wim	15:b70ebfffb258	1336
wim	15:b70ebfffb258	1337	//Update Cursor
wim	15:b70ebfffb258	1338	_column = 0;
wim	15:b70ebfffb258	1339	_row++;
wim	15:b70ebfffb258	1340	if (_row >= rows()) {
wim	15:b70ebfffb258	1341	_row = 0;
wim	15:b70ebfffb258	1342	}
wim	15:b70ebfffb258	1343	}
wim	15:b70ebfffb258	1344	else {
wim	37:ce348c002929	1345	//Character to write
wim	37:ce348c002929	1346	#if (LCD_DEFAULT_FONT == 1)
wim	37:ce348c002929	1347	_writeData(value);
wim	37:ce348c002929	1348	#else
wim	37:ce348c002929	1349	_writeData(ASCII_2_LCD(value));
wim	37:ce348c002929	1350	#endif
wim	15:b70ebfffb258	1351	//Update Cursor
wim	15:b70ebfffb258	1352	_column++;
wim	15:b70ebfffb258	1353	if (_column >= columns()) {
wim	15:b70ebfffb258	1354	_column = 0;
wim	15:b70ebfffb258	1355	_row++;
wim	15:b70ebfffb258	1356	if (_row >= rows()) {
wim	15:b70ebfffb258	1357	_row = 0;
wim	15:b70ebfffb258	1358	}
wim	15:b70ebfffb258	1359	}
wim	15:b70ebfffb258	1360	} //else
wim	15:b70ebfffb258	1361
wim	15:b70ebfffb258	1362	//Set next memoryaddress, make sure cursor blinks at next location
wim	15:b70ebfffb258	1363	addr = getAddress(_column, _row);
wim	15:b70ebfffb258	1364	_writeCommand(0x80 \| addr);
wim	15:b70ebfffb258	1365
wim	15:b70ebfffb258	1366	return value;
wim	15:b70ebfffb258	1367	}
wim	15:b70ebfffb258	1368
wim	15:b70ebfffb258	1369
wim	16:c276b75e6585	1370	// get a single character (Stream implementation)
wim	21:9eb628d9e164	1371	int TextLCD_Base::_getc() {
simon	1:ac48b187213c	1372	return -1;
simon	1:ac48b187213c	1373	}
simon	1:ac48b187213c	1374
wim	37:ce348c002929	1375	/** Convert ASCII character code to the LCD fonttable code
wim	37:ce348c002929	1376	*
wim	37:ce348c002929	1377	* @param c The character to write to the display
wim	37:ce348c002929	1378	* @return The character code for the specific fonttable of the controller
wim	37:ce348c002929	1379	*/
wim	37:ce348c002929	1380	int TextLCD_Base::ASCII_2_LCD (int c) {
wim	37:ce348c002929	1381
wim	37:ce348c002929	1382	//LCD_C_FT0 is default for HD44780 and compatible series
wim	37:ce348c002929	1383	if (_font == LCD_C_FT0) return c;
wim	37:ce348c002929	1384
wim	37:ce348c002929	1385	//LCD_C_FT1 for PCF21XXC series
wim	37:ce348c002929	1386	//Used code from Suga koubou library for PCF2119
wim	37:ce348c002929	1387	if (((c >= ' ') && (c <= '?')) \|\| ((c >= 'A') && (c <= 'Z')) \|\| ((c >= 'a') && (c <= 'z'))) {
wim	37:ce348c002929	1388	c \|= 0x80;
wim	37:ce348c002929	1389	} else if (c >= 0xf0 && c <= 0xff) {
wim	37:ce348c002929	1390	c &= 0x0f;
wim	37:ce348c002929	1391	}
wim	37:ce348c002929	1392	return c;
wim	37:ce348c002929	1393
wim	37:ce348c002929	1394	//LCD_C_FT2 ...
wim	37:ce348c002929	1395	//@TODO add more, eg cyrillic
wim	37:ce348c002929	1396	//@TODO add method to switch between fonts for controllers that support this
wim	37:ce348c002929	1397	}
wim	37:ce348c002929	1398
wim	14:0c32b66b14b8	1399
wim	34:e5a0dcb43ecc	1400	#if(LCD_PRINTF != 1)
wim	34:e5a0dcb43ecc	1401	/** Write a character to the LCD
wim	34:e5a0dcb43ecc	1402	*
wim	34:e5a0dcb43ecc	1403	* @param c The character to write to the display
wim	34:e5a0dcb43ecc	1404	*/
wim	34:e5a0dcb43ecc	1405	int TextLCD_Base::putc(int c){
wim	34:e5a0dcb43ecc	1406	return _putc(c);
wim	34:e5a0dcb43ecc	1407	}
wim	34:e5a0dcb43ecc	1408
wim	34:e5a0dcb43ecc	1409
wim	34:e5a0dcb43ecc	1410	/** Write a raw string to the LCD
wim	34:e5a0dcb43ecc	1411	*
wim	34:e5a0dcb43ecc	1412	* @param string text, may be followed by variables to emulate formatting the string.
wim	34:e5a0dcb43ecc	1413	* However, printf formatting is NOT supported and variables will be ignored!
wim	34:e5a0dcb43ecc	1414	*/
wim	34:e5a0dcb43ecc	1415	int TextLCD_Base::printf(const char* text, ...) {
wim	34:e5a0dcb43ecc	1416
wim	34:e5a0dcb43ecc	1417	while (*text !=0) {
wim	34:e5a0dcb43ecc	1418	_putc(*text);
wim	34:e5a0dcb43ecc	1419	text++;
wim	34:e5a0dcb43ecc	1420	}
wim	34:e5a0dcb43ecc	1421	return 0;
wim	34:e5a0dcb43ecc	1422	}
wim	34:e5a0dcb43ecc	1423	#endif
wim	34:e5a0dcb43ecc	1424
wim	34:e5a0dcb43ecc	1425
wim	17:652ab113bc2e	1426	// Write a nibble using the 4-bit interface
wim	21:9eb628d9e164	1427	void TextLCD_Base::_writeNibble(int value) {
wim	17:652ab113bc2e	1428
wim	17:652ab113bc2e	1429	// Enable is Low
wim	21:9eb628d9e164	1430	this->_setEnable(true);
wim	38:cbe275b0b647	1431	this->_setData(value); // Low nibble of value on D4..D7
wim	17:652ab113bc2e	1432	wait_us(1); // Data setup time
wim	21:9eb628d9e164	1433	this->_setEnable(false);
wim	17:652ab113bc2e	1434	wait_us(1); // Datahold time
wim	17:652ab113bc2e	1435	// Enable is Low
wim	17:652ab113bc2e	1436	}
wim	17:652ab113bc2e	1437
wim	16:c276b75e6585	1438	// Write a byte using the 4-bit interface
wim	21:9eb628d9e164	1439	void TextLCD_Base::_writeByte(int value) {
wim	15:b70ebfffb258	1440
wim	15:b70ebfffb258	1441	// Enable is Low
wim	21:9eb628d9e164	1442	this->_setEnable(true);
wim	21:9eb628d9e164	1443	this->_setData(value >> 4); // High nibble
wim	15:b70ebfffb258	1444	wait_us(1); // Data setup time
wim	21:9eb628d9e164	1445	this->_setEnable(false);
wim	15:b70ebfffb258	1446	wait_us(1); // Data hold time
wim	15:b70ebfffb258	1447
wim	21:9eb628d9e164	1448	this->_setEnable(true);
wim	37:ce348c002929	1449	this->_setData(value); // Low nibble
wim	15:b70ebfffb258	1450	wait_us(1); // Data setup time
wim	21:9eb628d9e164	1451	this->_setEnable(false);
wim	15:b70ebfffb258	1452	wait_us(1); // Datahold time
wim	15:b70ebfffb258	1453
wim	15:b70ebfffb258	1454	// Enable is Low
simon	1:ac48b187213c	1455	}
simon	1:ac48b187213c	1456
wim	21:9eb628d9e164	1457	// Write a command byte to the LCD controller
wim	21:9eb628d9e164	1458	void TextLCD_Base::_writeCommand(int command) {
wim	15:b70ebfffb258	1459
wim	21:9eb628d9e164	1460	this->_setRS(false);
wim	16:c276b75e6585	1461	wait_us(1); // Data setup time for RS
wim	15:b70ebfffb258	1462
wim	21:9eb628d9e164	1463	this->_writeByte(command);
wim	15:b70ebfffb258	1464	wait_us(40); // most instructions take 40us
simon	1:ac48b187213c	1465	}
simon	1:ac48b187213c	1466
wim	21:9eb628d9e164	1467	// Write a data byte to the LCD controller
wim	21:9eb628d9e164	1468	void TextLCD_Base::_writeData(int data) {
wim	15:b70ebfffb258	1469
wim	21:9eb628d9e164	1470	this->_setRS(true);
wim	16:c276b75e6585	1471	wait_us(1); // Data setup time for RS
wim	15:b70ebfffb258	1472
wim	21:9eb628d9e164	1473	this->_writeByte(data);
wim	15:b70ebfffb258	1474	wait_us(40); // data writes take 40us
simon	1:ac48b187213c	1475	}
simon	1:ac48b187213c	1476
wim	8:03116f75b66e	1477
wim	32:59c4b8f648d4	1478	// This replaces the original _address() method.
wim	8:03116f75b66e	1479	// It is confusing since it returns the memoryaddress or-ed with the set memorycommand 0x80.
wim	8:03116f75b66e	1480	// Left it in here for compatibility with older code. New applications should use getAddress() instead.
wim	21:9eb628d9e164	1481	int TextLCD_Base::_address(int column, int row) {
wim	8:03116f75b66e	1482	return 0x80 \| getAddress(column, row);
wim	8:03116f75b66e	1483	}
wim	8:03116f75b66e	1484
wim	30:033048611c01	1485
wim	30:033048611c01	1486	// This is new method to return the memory address based on row, column and displaytype.
wim	30:033048611c01	1487	//
wim	30:033048611c01	1488	/** Return the memoryaddress of screen column and row location
wim	30:033048611c01	1489	*
wim	30:033048611c01	1490	* @param column The horizontal position from the left, indexed from 0
wim	30:033048611c01	1491	* @param row The vertical position from the top, indexed from 0
wim	36:9f5f86dfd44a	1492	* @return The memoryaddress of screen column and row location
wim	30:033048611c01	1493	*
wim	30:033048611c01	1494	*/
wim	30:033048611c01	1495	int TextLCD_Base::getAddress(int column, int row) {
wim	30:033048611c01	1496
wim	30:033048611c01	1497	switch (_addr_mode) {
wim	30:033048611c01	1498
wim	30:033048611c01	1499	case LCD_T_A:
wim	30:033048611c01	1500	//Default addressing mode for 1, 2 and 4 rows (except 40x4)
wim	30:033048611c01	1501	//The two available rows are split and stacked on top of eachother. Addressing for 3rd and 4th line continues where lines 1 and 2 were split.
wim	30:033048611c01	1502	//Displays top rows when less than four are used.
wim	30:033048611c01	1503	switch (row) {
wim	30:033048611c01	1504	case 0:
wim	30:033048611c01	1505	return 0x00 + column;
wim	30:033048611c01	1506	case 1:
wim	30:033048611c01	1507	return 0x40 + column;
wim	30:033048611c01	1508	case 2:
wim	30:033048611c01	1509	return 0x00 + _nr_cols + column;
wim	30:033048611c01	1510	case 3:
wim	30:033048611c01	1511	return 0x40 + _nr_cols + column;
wim	30:033048611c01	1512	// Should never get here.
wim	30:033048611c01	1513	default:
wim	30:033048611c01	1514	return 0x00;
wim	30:033048611c01	1515	}
wim	30:033048611c01	1516
wim	30:033048611c01	1517	case LCD_T_B:
wim	30:033048611c01	1518	// LCD8x2B is a special layout of LCD16x1
wim	30:033048611c01	1519	if (row==0)
wim	30:033048611c01	1520	return 0x00 + column;
wim	30:033048611c01	1521	else
wim	30:033048611c01	1522	// return _nr_cols + column;
wim	30:033048611c01	1523	return 0x08 + column;
wim	30:033048611c01	1524
wim	30:033048611c01	1525	case LCD_T_C:
wim	30:033048611c01	1526	// LCD16x1C is a special layout of LCD8x2
wim	33:900a94bc7585	1527	// LCD32x1C is a special layout of LCD16x2
wim	33:900a94bc7585	1528	// LCD40x1C is a special layout of LCD20x2
wim	33:900a94bc7585	1529	#if(0)
wim	32:59c4b8f648d4	1530	if (column < 8)
wim	30:033048611c01	1531	return 0x00 + column;
wim	30:033048611c01	1532	else
wim	30:033048611c01	1533	return 0x40 + (column - 8);
wim	32:59c4b8f648d4	1534	#else
wim	32:59c4b8f648d4	1535	if (column < (_nr_cols >> 1))
wim	32:59c4b8f648d4	1536	return 0x00 + column;
wim	32:59c4b8f648d4	1537	else
wim	32:59c4b8f648d4	1538	return 0x40 + (column - (_nr_cols >> 1));
wim	32:59c4b8f648d4	1539	#endif
wim	30:033048611c01	1540
wim	30:033048611c01	1541	// Not sure about this one, seems wrong.
wim	30:033048611c01	1542	// Left in for compatibility with original library
wim	30:033048611c01	1543	// case LCD16x2B:
wim	30:033048611c01	1544	// return 0x00 + (row * 40) + column;
wim	30:033048611c01	1545
wim	30:033048611c01	1546	case LCD_T_D:
wim	36:9f5f86dfd44a	1547	//Alternate addressing mode for 3 and 4 row displays (except 40x4). Used by PCF21XX, KS0073, KS0078, SSD1803
wim	30:033048611c01	1548	//The 4 available rows start at a hardcoded address.
wim	30:033048611c01	1549	//Displays top rows when less than four are used.
wim	30:033048611c01	1550	switch (row) {
wim	30:033048611c01	1551	case 0:
wim	30:033048611c01	1552	return 0x00 + column;
wim	30:033048611c01	1553	case 1:
wim	30:033048611c01	1554	return 0x20 + column;
wim	30:033048611c01	1555	case 2:
wim	30:033048611c01	1556	return 0x40 + column;
wim	30:033048611c01	1557	case 3:
wim	30:033048611c01	1558	return 0x60 + column;
wim	30:033048611c01	1559	// Should never get here.
wim	30:033048611c01	1560	default:
wim	30:033048611c01	1561	return 0x00;
wim	30:033048611c01	1562	}
wim	30:033048611c01	1563
wim	30:033048611c01	1564	case LCD_T_D1:
wim	36:9f5f86dfd44a	1565	//Alternate addressing mode for 3 row displays. Used by PCF21XX, KS0073, KS0078, SSD1803
wim	30:033048611c01	1566	//The 4 available rows start at a hardcoded address.
wim	30:033048611c01	1567	//Skips top row of 4 row display and starts display at row 1
wim	30:033048611c01	1568	switch (row) {
wim	30:033048611c01	1569	case 0:
wim	30:033048611c01	1570	return 0x20 + column;
wim	30:033048611c01	1571	case 1:
wim	30:033048611c01	1572	return 0x40 + column;
wim	30:033048611c01	1573	case 2:
wim	30:033048611c01	1574	return 0x60 + column;
wim	30:033048611c01	1575	// Should never get here.
wim	30:033048611c01	1576	default:
wim	30:033048611c01	1577	return 0x00;
wim	30:033048611c01	1578	}
wim	30:033048611c01	1579
wim	30:033048611c01	1580	case LCD_T_E:
wim	30:033048611c01	1581	// LCD40x4 is a special case since it has 2 controllers.
wim	30:033048611c01	1582	// Each controller is configured as 40x2 (Type A)
wim	30:033048611c01	1583	if (row<2) {
wim	30:033048611c01	1584	// Test to see if we need to switch between controllers
wim	30:033048611c01	1585	if (_ctrl_idx != _LCDCtrl_0) {
wim	30:033048611c01	1586
wim	30:033048611c01	1587	// Second LCD controller Cursor Off
wim	30:033048611c01	1588	_setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
wim	30:033048611c01	1589
wim	30:033048611c01	1590	// Select primary controller
wim	30:033048611c01	1591	_ctrl_idx = _LCDCtrl_0;
wim	30:033048611c01	1592
wim	30:033048611c01	1593	// Restore cursormode on primary LCD controller
wim	30:033048611c01	1594	_setCursorAndDisplayMode(_currentMode, _currentCursor);
wim	30:033048611c01	1595	}
wim	30:033048611c01	1596
wim	30:033048611c01	1597	return 0x00 + (row * 0x40) + column;
wim	30:033048611c01	1598	}
wim	30:033048611c01	1599	else {
wim	30:033048611c01	1600
wim	30:033048611c01	1601	// Test to see if we need to switch between controllers
wim	30:033048611c01	1602	if (_ctrl_idx != _LCDCtrl_1) {
wim	30:033048611c01	1603	// Primary LCD controller Cursor Off
wim	30:033048611c01	1604	_setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
wim	30:033048611c01	1605
wim	30:033048611c01	1606	// Select secondary controller
wim	30:033048611c01	1607	_ctrl_idx = _LCDCtrl_1;
wim	30:033048611c01	1608
wim	30:033048611c01	1609	// Restore cursormode on secondary LCD controller
wim	30:033048611c01	1610	_setCursorAndDisplayMode(_currentMode, _currentCursor);
wim	30:033048611c01	1611	}
wim	30:033048611c01	1612
wim	30:033048611c01	1613	return 0x00 + ((row-2) * 0x40) + column;
wim	30:033048611c01	1614	}
wim	30:033048611c01	1615
wim	32:59c4b8f648d4	1616	case LCD_T_F:
wim	32:59c4b8f648d4	1617	//Alternate addressing mode for 3 row displays.
wim	32:59c4b8f648d4	1618	//The first half of 3rd row continues from 1st row, the second half continues from 2nd row.
wim	32:59c4b8f648d4	1619	switch (row) {
wim	32:59c4b8f648d4	1620	case 0:
wim	32:59c4b8f648d4	1621	return 0x00 + column;
wim	32:59c4b8f648d4	1622	case 1:
wim	32:59c4b8f648d4	1623	return 0x40 + column;
wim	32:59c4b8f648d4	1624	case 2:
wim	32:59c4b8f648d4	1625	if (column < (_nr_cols >> 1)) // check first or second half of line
wim	32:59c4b8f648d4	1626	return (0x00 + _nr_cols + column);
wim	32:59c4b8f648d4	1627	else
wim	32:59c4b8f648d4	1628	return (0x40 + _nr_cols + (column - (_nr_cols >> 1)));
wim	32:59c4b8f648d4	1629	// Should never get here.
wim	32:59c4b8f648d4	1630	default:
wim	32:59c4b8f648d4	1631	return 0x00;
wim	32:59c4b8f648d4	1632	}
wim	32:59c4b8f648d4	1633
wim	32:59c4b8f648d4	1634	case LCD_T_G:
wim	32:59c4b8f648d4	1635	//Alternate addressing mode for 3 row displays. Used by ST7036
wim	32:59c4b8f648d4	1636	switch (row) {
wim	32:59c4b8f648d4	1637	case 0:
wim	32:59c4b8f648d4	1638	return 0x00 + column;
wim	32:59c4b8f648d4	1639	case 1:
wim	32:59c4b8f648d4	1640	return 0x10 + column;
wim	32:59c4b8f648d4	1641	case 2:
wim	32:59c4b8f648d4	1642	return 0x20 + column;
wim	32:59c4b8f648d4	1643	// Should never get here.
wim	32:59c4b8f648d4	1644	default:
wim	32:59c4b8f648d4	1645	return 0x00;
wim	32:59c4b8f648d4	1646	}
wim	32:59c4b8f648d4	1647
wim	30:033048611c01	1648	// Should never get here.
wim	30:033048611c01	1649	default:
wim	30:033048611c01	1650	return 0x00;
wim	32:59c4b8f648d4	1651
wim	32:59c4b8f648d4	1652	} // switch _addr_mode
wim	30:033048611c01	1653	}
wim	30:033048611c01	1654
wim	30:033048611c01	1655
wim	29:a3663151aa65	1656	/** Set the memoryaddress of screen column and row location
wim	29:a3663151aa65	1657	*
wim	29:a3663151aa65	1658	* @param column The horizontal position from the left, indexed from 0
wim	29:a3663151aa65	1659	* @param row The vertical position from the top, indexed from 0
wim	29:a3663151aa65	1660	*/
wim	21:9eb628d9e164	1661	void TextLCD_Base::setAddress(int column, int row) {
wim	15:b70ebfffb258	1662
wim	15:b70ebfffb258	1663	// Sanity Check column
wim	15:b70ebfffb258	1664	if (column < 0) {
wim	15:b70ebfffb258	1665	_column = 0;
wim	15:b70ebfffb258	1666	}
wim	36:9f5f86dfd44a	1667	else if (column >= _nr_cols) {
wim	36:9f5f86dfd44a	1668	_column = _nr_cols - 1;
wim	15:b70ebfffb258	1669	} else _column = column;
wim	8:03116f75b66e	1670
wim	15:b70ebfffb258	1671	// Sanity Check row
wim	15:b70ebfffb258	1672	if (row < 0) {
wim	15:b70ebfffb258	1673	_row = 0;
wim	15:b70ebfffb258	1674	}
wim	36:9f5f86dfd44a	1675	else if (row >= _nr_rows) {
wim	36:9f5f86dfd44a	1676	_row = _nr_rows - 1;
wim	15:b70ebfffb258	1677	} else _row = row;
wim	15:b70ebfffb258	1678
wim	15:b70ebfffb258	1679
wim	15:b70ebfffb258	1680	// Compute the memory address
wim	15:b70ebfffb258	1681	// For LCD40x4: switch controllers if needed
wim	15:b70ebfffb258	1682	// switch cursor if needed
wim	15:b70ebfffb258	1683	int addr = getAddress(_column, _row);
wim	8:03116f75b66e	1684
wim	13:24506ba22480	1685	_writeCommand(0x80 \| addr);
wim	8:03116f75b66e	1686	}
simon	1:ac48b187213c	1687
wim	29:a3663151aa65	1688
wim	29:a3663151aa65	1689	/** Return the number of columns
wim	29:a3663151aa65	1690	*
wim	36:9f5f86dfd44a	1691	* @return The number of columns
wim	30:033048611c01	1692	*
wim	30:033048611c01	1693	* Note: some configurations are commented out because they have not yet been tested due to lack of hardware
wim	29:a3663151aa65	1694	*/
wim	21:9eb628d9e164	1695	int TextLCD_Base::columns() {
wim	30:033048611c01	1696
wim	30:033048611c01	1697	// Columns encoded in b7..b0
wim	30:033048611c01	1698	//return (_type & 0xFF);
wim	31:ef31cd8a00d1	1699	return _nr_cols;
simon	1:ac48b187213c	1700	}
simon	1:ac48b187213c	1701
wim	29:a3663151aa65	1702	/** Return the number of rows
wim	29:a3663151aa65	1703	*
wim	36:9f5f86dfd44a	1704	* @return The number of rows
wim	30:033048611c01	1705	*
wim	30:033048611c01	1706	* Note: some configurations are commented out because they have not yet been tested due to lack of hardware
wim	29:a3663151aa65	1707	*/
wim	21:9eb628d9e164	1708	int TextLCD_Base::rows() {
wim	30:033048611c01	1709
wim	30:033048611c01	1710	// Rows encoded in b15..b8
wim	30:033048611c01	1711	//return ((_type >> 8) & 0xFF);
wim	30:033048611c01	1712	return _nr_rows;
simon	1:ac48b187213c	1713	}
wim	10:dd9b3a696acd	1714
wim	29:a3663151aa65	1715	/** Set the Cursormode
wim	29:a3663151aa65	1716	*
wim	29:a3663151aa65	1717	* @param cursorMode The Cursor mode (CurOff_BlkOff, CurOn_BlkOff, CurOff_BlkOn, CurOn_BlkOn)
wim	29:a3663151aa65	1718	*/
wim	21:9eb628d9e164	1719	void TextLCD_Base::setCursor(LCDCursor cursorMode) {
wim	15:b70ebfffb258	1720
wim	17:652ab113bc2e	1721	// Save new cursor mode, needed when 2 controllers are in use or when display is switched off/on
wim	17:652ab113bc2e	1722	_currentCursor = cursorMode;
wim	10:dd9b3a696acd	1723
wim	17:652ab113bc2e	1724	// Configure only current LCD controller
wim	31:ef31cd8a00d1	1725	_setCursorAndDisplayMode(_currentMode, _currentCursor);
wim	15:b70ebfffb258	1726	}
wim	15:b70ebfffb258	1727
wim	29:a3663151aa65	1728	/** Set the Displaymode
wim	29:a3663151aa65	1729	*
wim	29:a3663151aa65	1730	* @param displayMode The Display mode (DispOff, DispOn)
wim	29:a3663151aa65	1731	*/
wim	21:9eb628d9e164	1732	void TextLCD_Base::setMode(LCDMode displayMode) {
wim	17:652ab113bc2e	1733
wim	17:652ab113bc2e	1734	// Save new displayMode, needed when 2 controllers are in use or when cursor is changed
wim	17:652ab113bc2e	1735	_currentMode = displayMode;
wim	15:b70ebfffb258	1736
wim	17:652ab113bc2e	1737	// Select and configure second LCD controller when needed
wim	17:652ab113bc2e	1738	if(_type==LCD40x4) {
wim	21:9eb628d9e164	1739	if (_ctrl_idx==_LCDCtrl_0) {
wim	17:652ab113bc2e	1740	// Configure primary LCD controller
wim	17:652ab113bc2e	1741	_setCursorAndDisplayMode(_currentMode, _currentCursor);
wim	11:9ec02df863a1	1742
wim	17:652ab113bc2e	1743	// Select 2nd controller
wim	21:9eb628d9e164	1744	_ctrl_idx=_LCDCtrl_1;
wim	17:652ab113bc2e	1745
wim	17:652ab113bc2e	1746	// Configure secondary LCD controller
wim	21:9eb628d9e164	1747	_setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
wim	11:9ec02df863a1	1748
wim	17:652ab113bc2e	1749	// Restore current controller
wim	21:9eb628d9e164	1750	_ctrl_idx=_LCDCtrl_0;
wim	17:652ab113bc2e	1751	}
wim	17:652ab113bc2e	1752	else {
wim	17:652ab113bc2e	1753	// Select primary controller
wim	21:9eb628d9e164	1754	_ctrl_idx=_LCDCtrl_0;
wim	17:652ab113bc2e	1755
wim	17:652ab113bc2e	1756	// Configure primary LCD controller
wim	21:9eb628d9e164	1757	_setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
wim	17:652ab113bc2e	1758
wim	17:652ab113bc2e	1759	// Restore current controller
wim	21:9eb628d9e164	1760	_ctrl_idx=_LCDCtrl_1;
wim	11:9ec02df863a1	1761
wim	17:652ab113bc2e	1762	// Configure secondary LCD controller
wim	17:652ab113bc2e	1763	_setCursorAndDisplayMode(_currentMode, _currentCursor);
wim	10:dd9b3a696acd	1764	}
wim	17:652ab113bc2e	1765	}
wim	17:652ab113bc2e	1766	else {
wim	17:652ab113bc2e	1767	// Configure primary LCD controller
wim	17:652ab113bc2e	1768	_setCursorAndDisplayMode(_currentMode, _currentCursor);
wim	30:033048611c01	1769	}
wim	17:652ab113bc2e	1770	}
wim	17:652ab113bc2e	1771
wim	29:a3663151aa65	1772	/** Low level method to restore the cursortype and display mode for current controller
wim	29:a3663151aa65	1773	*/
wim	36:9f5f86dfd44a	1774	void TextLCD_Base::_setCursorAndDisplayMode(LCDMode displayMode, LCDCursor cursorType) {
wim	36:9f5f86dfd44a	1775
wim	36:9f5f86dfd44a	1776	// Configure current LCD controller
wim	36:9f5f86dfd44a	1777	switch (_ctrl) {
wim	36:9f5f86dfd44a	1778	case ST7070:
wim	36:9f5f86dfd44a	1779	//ST7070 does not support Cursorblink. The P bit selects the font instead !
wim	36:9f5f86dfd44a	1780	_writeCommand(0x08 \| displayMode \| (cursorType & 0x02));
wim	36:9f5f86dfd44a	1781	break;
wim	36:9f5f86dfd44a	1782	default:
wim	36:9f5f86dfd44a	1783	_writeCommand(0x08 \| displayMode \| cursorType);
wim	36:9f5f86dfd44a	1784	break;
wim	36:9f5f86dfd44a	1785	} //switch
wim	10:dd9b3a696acd	1786	}
wim	10:dd9b3a696acd	1787
wim	29:a3663151aa65	1788	/** Set the Backlight mode
wim	29:a3663151aa65	1789	*
wim	29:a3663151aa65	1790	* @param backlightMode The Backlight mode (LightOff, LightOn)
wim	29:a3663151aa65	1791	*/
wim	21:9eb628d9e164	1792	void TextLCD_Base::setBacklight(LCDBacklight backlightMode) {
wim	20:e0da005a777f	1793
wim	35:311be6444a39	1794	#if (BACKLIGHT_INV==0)
wim	35:311be6444a39	1795	// Positive Backlight control pin logic
wim	20:e0da005a777f	1796	if (backlightMode == LightOn) {
wim	35:311be6444a39	1797	this->_setBL(true);
wim	20:e0da005a777f	1798	}
wim	20:e0da005a777f	1799	else {
wim	21:9eb628d9e164	1800	this->_setBL(false);
wim	20:e0da005a777f	1801	}
wim	35:311be6444a39	1802	#else
wim	35:311be6444a39	1803	// Inverted Backlight control pin logic
wim	35:311be6444a39	1804	if (backlightMode == LightOn) {
wim	35:311be6444a39	1805	this->_setBL(false);
wim	35:311be6444a39	1806	}
wim	35:311be6444a39	1807	else {
wim	35:311be6444a39	1808	this->_setBL(true);
wim	35:311be6444a39	1809	}
wim	35:311be6444a39	1810	#endif
wim	20:e0da005a777f	1811	}
wim	20:e0da005a777f	1812
wim	29:a3663151aa65	1813	/** Set User Defined Characters
wim	29:a3663151aa65	1814	*
wim	34:e5a0dcb43ecc	1815	* @param unsigned char c The Index of the UDC (0..7) for HD44780 or clones and (0..15) for some more advanced controllers
wim	34:e5a0dcb43ecc	1816	* @param char *udc_data The bitpatterns for the UDC (8 bytes of 5 significant bits for bitpattern and 3 bits for blinkmode (advanced types))
wim	29:a3663151aa65	1817	*/
wim	21:9eb628d9e164	1818	void TextLCD_Base::setUDC(unsigned char c, char *udc_data) {
wim	15:b70ebfffb258	1819
wim	15:b70ebfffb258	1820	// Select and configure second LCD controller when needed
wim	15:b70ebfffb258	1821	if(_type==LCD40x4) {
wim	19:c747b9e2e7b8	1822	_LCDCtrl_Idx current_ctrl_idx = _ctrl_idx; // Temp save current controller
wim	15:b70ebfffb258	1823
wim	15:b70ebfffb258	1824	// Select primary controller
wim	21:9eb628d9e164	1825	_ctrl_idx=_LCDCtrl_0;
wim	15:b70ebfffb258	1826
wim	15:b70ebfffb258	1827	// Configure primary LCD controller
wim	15:b70ebfffb258	1828	_setUDC(c, udc_data);
wim	15:b70ebfffb258	1829
wim	15:b70ebfffb258	1830	// Select 2nd controller
wim	21:9eb628d9e164	1831	_ctrl_idx=_LCDCtrl_1;
wim	15:b70ebfffb258	1832
wim	15:b70ebfffb258	1833	// Configure secondary LCD controller
wim	15:b70ebfffb258	1834	_setUDC(c, udc_data);
wim	11:9ec02df863a1	1835
wim	15:b70ebfffb258	1836	// Restore current controller
wim	19:c747b9e2e7b8	1837	_ctrl_idx=current_ctrl_idx;
wim	15:b70ebfffb258	1838	}
wim	15:b70ebfffb258	1839	else {
wim	15:b70ebfffb258	1840	// Configure primary LCD controller
wim	15:b70ebfffb258	1841	_setUDC(c, udc_data);
wim	34:e5a0dcb43ecc	1842	}
wim	15:b70ebfffb258	1843	}
wim	15:b70ebfffb258	1844
wim	34:e5a0dcb43ecc	1845	/** Low level method to store user defined characters for current controller
wim	34:e5a0dcb43ecc	1846	*
wim	34:e5a0dcb43ecc	1847	* @param unsigned char c The Index of the UDC (0..7) for HD44780 clones and (0..15) for some more advanced controllers
wim	34:e5a0dcb43ecc	1848	* @param char *udc_data The bitpatterns for the UDC (8 bytes of 5 significant bits for bitpattern and 3 bits for blinkmode (advanced types))
wim	34:e5a0dcb43ecc	1849	*/
wim	34:e5a0dcb43ecc	1850	void TextLCD_Base::_setUDC(unsigned char c, char *udc_data) {
wim	34:e5a0dcb43ecc	1851
wim	34:e5a0dcb43ecc	1852	switch (_ctrl) {
wim	34:e5a0dcb43ecc	1853	case PCF2103_3V3 : // Some UDCs may be used for Icons
wim	34:e5a0dcb43ecc	1854	case PCF2113_3V3 : // Some UDCs may be used for Icons
wim	34:e5a0dcb43ecc	1855	case PCF2116_3V3 :
wim	34:e5a0dcb43ecc	1856	case PCF2116_5V :
wim	34:e5a0dcb43ecc	1857	case PCF2119_3V3 : // Some UDCs may be used for Icons
wim	34:e5a0dcb43ecc	1858	c = c & 0x0F; // mask down to valid range
wim	34:e5a0dcb43ecc	1859	break;
wim	34:e5a0dcb43ecc	1860
wim	34:e5a0dcb43ecc	1861	default:
wim	34:e5a0dcb43ecc	1862	c = c & 0x07; // mask down to valid range
wim	34:e5a0dcb43ecc	1863	break;
wim	34:e5a0dcb43ecc	1864	} //switch _ctrl
wim	34:e5a0dcb43ecc	1865
wim	34:e5a0dcb43ecc	1866	// Select DD RAM for current LCD controller
wim	34:e5a0dcb43ecc	1867	// This is needed to correctly set Bit 6 of the addresspointer for controllers that support 16 UDCs
wim	34:e5a0dcb43ecc	1868	_writeCommand(0x80 \| ((c << 3) & 0x40)) ;
wim	34:e5a0dcb43ecc	1869
wim	34:e5a0dcb43ecc	1870	// Select CG RAM for current LCD controller
wim	34:e5a0dcb43ecc	1871	_writeCommand(0x40 \| ((c << 3) & 0x3F)); //Set CG-RAM address, (note that Bit 6 is retained and can not be set by this command !)
wim	34:e5a0dcb43ecc	1872	//8 sequential locations needed per UDC
wim	34:e5a0dcb43ecc	1873	// Store UDC pattern
wim	34:e5a0dcb43ecc	1874	for (int i=0; i<8; i++) {
wim	34:e5a0dcb43ecc	1875	_writeData(*udc_data++);
wim	34:e5a0dcb43ecc	1876	}
wim	34:e5a0dcb43ecc	1877
wim	34:e5a0dcb43ecc	1878	//Select DD RAM again for current LCD controller and restore the addresspointer
wim	34:e5a0dcb43ecc	1879	int addr = getAddress(_column, _row);
wim	34:e5a0dcb43ecc	1880	_writeCommand(0x80 \| addr);
wim	34:e5a0dcb43ecc	1881	}
wim	32:59c4b8f648d4	1882
wim	36:9f5f86dfd44a	1883	/** Set UDC Blink and Icon blink
wim	33:900a94bc7585	1884	* setUDCBlink method is supported by some compatible devices (eg SSD1803)
wim	33:900a94bc7585	1885	*
wim	33:900a94bc7585	1886	* @param blinkMode The Blink mode (BlinkOff, BlinkOn)
wim	33:900a94bc7585	1887	*/
wim	33:900a94bc7585	1888	void TextLCD_Base::setUDCBlink(LCDBlink blinkMode){
wim	36:9f5f86dfd44a	1889	// Blinking UDCs (and icons) are enabled when a specific controlbit (BE) is set.
wim	36:9f5f86dfd44a	1890	// The blinking pixels in the UDC and icons can be controlled by setting additional bits in the UDC or icon bitpattern.
wim	36:9f5f86dfd44a	1891	// UDCs are defined by an 8 byte bitpattern. The P0..P4 form the character pattern.
wim	33:900a94bc7585	1892	// P7 P6 P5 P4 P3 P2 P1 P0
wim	33:900a94bc7585	1893	// 0 B1 B0 x 0 1 1 1 0
wim	33:900a94bc7585	1894	// 1 B1 B0 x 1 0 0 0 1
wim	33:900a94bc7585	1895	// .............
wim	33:900a94bc7585	1896	// 7 B1 B0 x 1 0 0 0 1
wim	33:900a94bc7585	1897	//
wim	33:900a94bc7585	1898	// Bit 6 and Bit 7 in the pattern will control the blinking mode when Blink is enabled through BE.
wim	33:900a94bc7585	1899	// B1 B0 Mode
wim	33:900a94bc7585	1900	// 0 0 No Blinking in this row of the UDC
wim	33:900a94bc7585	1901	// 0 1 Enabled pixels in P4 will blink
wim	33:900a94bc7585	1902	// 1 x Enabled pixels in P0..P4 will blink
wim	36:9f5f86dfd44a	1903	//
wim	36:9f5f86dfd44a	1904	// Note: the PCF2103 and PCF2113 use UDCs to set Icons
wim	36:9f5f86dfd44a	1905	// 3 x 8 rows x 5 bits = 120 bits Icons for Normal pattern (UDC 0..2) and
wim	36:9f5f86dfd44a	1906	// 3 x 8 rows x 5 bits = 120 bits Icons for Blink pattern (UDC 4..6)
wim	36:9f5f86dfd44a	1907	// Note: the PCF2119 uses UDCs to set Icons
wim	36:9f5f86dfd44a	1908	// 4 x 8 rows x 5 bits = 160 bits Icons for Normal pattern (UDC 0..3) and
wim	36:9f5f86dfd44a	1909	// 4 x 8 rows x 5 bits = 160 bits Icons for Blink pattern (UDC 4..7)
wim	33:900a94bc7585	1910	switch (blinkMode) {
wim	33:900a94bc7585	1911	case BlinkOn:
wim	36:9f5f86dfd44a	1912	// Controllers that support UDC/Icon Blink
wim	33:900a94bc7585	1913	switch (_ctrl) {
wim	36:9f5f86dfd44a	1914	case KS0073 :
wim	33:900a94bc7585	1915	case KS0078 :
wim	36:9f5f86dfd44a	1916	_function_1 \|= 0x02; // Enable UDC/Icon Blink
wim	36:9f5f86dfd44a	1917	_writeCommand(0x20 \| _function_1); // Function set 0 0 1 DL N RE(1) BE 0/LP (Ext Regs)
wim	33:900a94bc7585	1918
wim	33:900a94bc7585	1919	_writeCommand(0x20 \| _function); // Function set 0 0 1 DL N RE(0) DH REV (Std Regs)
wim	36:9f5f86dfd44a	1920	break; // case KS0073, KS0078 Controller
wim	33:900a94bc7585	1921
wim	33:900a94bc7585	1922	case US2066_3V3 :
wim	33:900a94bc7585	1923	case SSD1803_3V3 :
wim	36:9f5f86dfd44a	1924	_function_1 \|= 0x04; // Enable UDC/Icon Blink
wim	33:900a94bc7585	1925	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 DL N BE RE(1) REV
wim	33:900a94bc7585	1926	// Select Ext Instr Set
wim	33:900a94bc7585	1927
wim	33:900a94bc7585	1928	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
wim	33:900a94bc7585	1929	// Select Std Instr set, Select IS=0
wim	33:900a94bc7585	1930	break; // case SSD1803, US2066
wim	36:9f5f86dfd44a	1931
wim	36:9f5f86dfd44a	1932	case PCF2103_3V3 :
wim	36:9f5f86dfd44a	1933	case PCF2113_3V3 :
wim	36:9f5f86dfd44a	1934	case PCF2119_3V3 :
wim	36:9f5f86dfd44a	1935	// Enable Icon Blink
wim	36:9f5f86dfd44a	1936	_writeCommand(0x20 \| _function \| 0x01); // Set function, Select Instr Set = 1
wim	36:9f5f86dfd44a	1937	_writeCommand(0x08 \| 0x02); // ICON Conf 0000 1, IM=0 (Char mode), IB=1 (Icon blink), 0 (Instr. Set 1)
wim	36:9f5f86dfd44a	1938	_writeCommand(0x20 \| _function); // Set function, Select Instr Set = 0
wim	36:9f5f86dfd44a	1939
wim	36:9f5f86dfd44a	1940	break;
wim	33:900a94bc7585	1941
wim	33:900a94bc7585	1942	default:
wim	33:900a94bc7585	1943	//Unsupported feature for other controllers
wim	33:900a94bc7585	1944	break;
wim	33:900a94bc7585	1945	} //switch _ctrl
wim	33:900a94bc7585	1946
wim	36:9f5f86dfd44a	1947	break; // BlinkOn
wim	33:900a94bc7585	1948
wim	33:900a94bc7585	1949	case BlinkOff:
wim	33:900a94bc7585	1950	// Controllers that support UDC Blink
wim	33:900a94bc7585	1951	switch (_ctrl) {
wim	36:9f5f86dfd44a	1952	case KS0073 :
wim	33:900a94bc7585	1953	case KS0078 :
wim	36:9f5f86dfd44a	1954	_function_1 &= ~0x02; // Disable UDC/Icon Blink
wim	36:9f5f86dfd44a	1955	_writeCommand(0x20 \| _function_1); // Function set 0 0 1 DL N RE(1) BE 0/LP (Ext Regs)
wim	33:900a94bc7585	1956
wim	33:900a94bc7585	1957	_writeCommand(0x20 \| _function); // Function set 0 0 1 DL N RE(0) DH REV (Std Regs)
wim	36:9f5f86dfd44a	1958	break; // case KS0073, KS0078 Controller
wim	33:900a94bc7585	1959
wim	33:900a94bc7585	1960	case US2066_3V3 :
wim	33:900a94bc7585	1961	case SSD1803_3V3 :
wim	36:9f5f86dfd44a	1962	_function_1 &= ~0x04; // Disable UDC/Icon Blink
wim	33:900a94bc7585	1963	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 DL N BE RE(1) REV
wim	33:900a94bc7585	1964	// Select Ext Instr Set
wim	33:900a94bc7585	1965
wim	33:900a94bc7585	1966	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
wim	33:900a94bc7585	1967	// Select Std Instr set, Select IS=0
wim	33:900a94bc7585	1968	break; // case SSD1803, US2066
wim	36:9f5f86dfd44a	1969
wim	36:9f5f86dfd44a	1970	case PCF2103_3V3 :
wim	36:9f5f86dfd44a	1971	case PCF2113_3V3 :
wim	36:9f5f86dfd44a	1972	case PCF2119_3V3 :
wim	36:9f5f86dfd44a	1973	// Disable Icon Blink
wim	36:9f5f86dfd44a	1974	_writeCommand(0x20 \| _function \| 0x01); // Set function, Select Instr Set = 1
wim	36:9f5f86dfd44a	1975	_writeCommand(0x08); // ICON Conf 0000 1, IM=0 (Char mode), IB=1 (Icon blink), 0 (Instr. Set 1)
wim	36:9f5f86dfd44a	1976	_writeCommand(0x20 \| _function); // Set function, Select Instr Set = 0
wim	36:9f5f86dfd44a	1977
wim	36:9f5f86dfd44a	1978	break;
wim	33:900a94bc7585	1979
wim	33:900a94bc7585	1980	default:
wim	33:900a94bc7585	1981	//Unsupported feature for other controllers
wim	33:900a94bc7585	1982	break;
wim	33:900a94bc7585	1983	} //switch _ctrl
wim	33:900a94bc7585	1984
wim	36:9f5f86dfd44a	1985	break; //BlinkOff
wim	33:900a94bc7585	1986
wim	33:900a94bc7585	1987	default:
wim	33:900a94bc7585	1988	break;
wim	33:900a94bc7585	1989	} // blinkMode
wim	33:900a94bc7585	1990
wim	33:900a94bc7585	1991	} // setUDCBlink()
wim	33:900a94bc7585	1992
wim	33:900a94bc7585	1993
wim	32:59c4b8f648d4	1994	/** Set Contrast
wim	32:59c4b8f648d4	1995	* setContrast method is supported by some compatible devices (eg ST7032i) that have onboard LCD voltage generation
wim	32:59c4b8f648d4	1996	* Initial code for ST70XX imported from fork by JH1PJL
wim	32:59c4b8f648d4	1997	*
wim	32:59c4b8f648d4	1998	* @param unsigned char c contrast data (6 significant bits, valid range 0..63, Value 0 will disable the Vgen)
wim	32:59c4b8f648d4	1999	* @return none
wim	32:59c4b8f648d4	2000	*/
wim	32:59c4b8f648d4	2001	//@TODO Add support for 40x4 dual controller
wim	32:59c4b8f648d4	2002	void TextLCD_Base::setContrast(unsigned char c) {
wim	32:59c4b8f648d4	2003
wim	32:59c4b8f648d4	2004	// Function set mode stored during Init. Make sure we dont accidentally switch between 1-line and 2-line mode!
wim	32:59c4b8f648d4	2005	// Icon/Booster mode stored during Init. Make sure we dont accidentally change this!
wim	32:59c4b8f648d4	2006
wim	32:59c4b8f648d4	2007	_contrast = c & 0x3F; // Sanity check
wim	32:59c4b8f648d4	2008
wim	33:900a94bc7585	2009	switch (_ctrl) {
wim	32:59c4b8f648d4	2010	case PCF2113_3V3 :
wim	32:59c4b8f648d4	2011	case PCF2119_3V3 :
wim	32:59c4b8f648d4	2012	if (_contrast < 5) _contrast = 0; // See datasheet. Sanity check for PCF2113/PCF2119
wim	32:59c4b8f648d4	2013	if (_contrast > 55) _contrast = 55;
wim	32:59c4b8f648d4	2014
wim	32:59c4b8f648d4	2015	_writeCommand(0x20 \| _function \| 0x01); // Set function, Select Instruction Set = 1
wim	32:59c4b8f648d4	2016	_writeCommand(0x80 \| 0x00 \| (_contrast & 0x3F)); // VLCD_set (Instr. Set 1) V=0, VA=contrast
wim	32:59c4b8f648d4	2017	_writeCommand(0x80 \| 0x40 \| (_contrast & 0x3F)); // VLCD_set (Instr. Set 1) V=1, VB=contrast
wim	32:59c4b8f648d4	2018	_writeCommand(0x20 \| _function); // Select Instruction Set = 0
wim	32:59c4b8f648d4	2019	break;
wim	32:59c4b8f648d4	2020
wim	32:59c4b8f648d4	2021	case ST7032_3V3 :
wim	32:59c4b8f648d4	2022	case ST7032_5V :
wim	32:59c4b8f648d4	2023	case ST7036_3V3 :
wim	32:59c4b8f648d4	2024	// case ST7036_5V :
wim	32:59c4b8f648d4	2025	case SSD1803_3V3 :
wim	32:59c4b8f648d4	2026	_writeCommand(0x20 \| _function \| 0x01); // Select Instruction Set = 1
wim	32:59c4b8f648d4	2027	_writeCommand(0x70 \| (_contrast & 0x0F)); // Contrast Low bits
wim	32:59c4b8f648d4	2028	_writeCommand(0x50 \| _icon_power \| ((_contrast >> 4) & 0x03)); // Contrast High bits
wim	32:59c4b8f648d4	2029	_writeCommand(0x20 \| _function); // Select Instruction Set = 0
wim	32:59c4b8f648d4	2030	break;
wim	32:59c4b8f648d4	2031
wim	33:900a94bc7585	2032	case US2066_3V3 :
wim	33:900a94bc7585	2033	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 DL N BE RE(1) REV
wim	33:900a94bc7585	2034	// Select Extended Instruction Set
wim	33:900a94bc7585	2035
wim	33:900a94bc7585	2036	_writeCommand(0x79); // Function Select OLED: 0 1 1 1 1 0 0 1 (Ext Instr Set)
wim	33:900a94bc7585	2037
wim	33:900a94bc7585	2038	_writeCommand(0x81); // Set Contrast Control: 1 0 0 0 0 0 0 1 (Ext Instr Set, OLED)
wim	33:900a94bc7585	2039	_writeCommand((_contrast << 2) \| 0x03); // Set Contrast Value: 8 bits. Use 6 bits for compatibility
wim	33:900a94bc7585	2040
wim	33:900a94bc7585	2041	_writeCommand(0x78); // Function Disable OLED: 0 1 1 1 1 0 0 0 (Ext Instr Set)
wim	33:900a94bc7585	2042
wim	33:900a94bc7585	2043	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
wim	33:900a94bc7585	2044	// Select Std Instr set, Select IS=0
wim	33:900a94bc7585	2045	break;
wim	33:900a94bc7585	2046
wim	34:e5a0dcb43ecc	2047	//not yet tested on hardware
wim	32:59c4b8f648d4	2048	case PT6314 :
wim	32:59c4b8f648d4	2049	// Only 2 significant bits
wim	32:59c4b8f648d4	2050	// 0x00 = 100%
wim	32:59c4b8f648d4	2051	// 0x01 = 75%
wim	32:59c4b8f648d4	2052	// 0x02 = 50%
wim	32:59c4b8f648d4	2053	// 0x03 = 25%
wim	32:59c4b8f648d4	2054	_writeCommand(0x20 \| _function \| ((~_contrast) >> 4)); // Invert and shift to use 2 MSBs
wim	32:59c4b8f648d4	2055	break;
wim	32:59c4b8f648d4	2056
wim	32:59c4b8f648d4	2057	default:
wim	32:59c4b8f648d4	2058	//Unsupported feature for other controllers
wim	33:900a94bc7585	2059	break;
wim	33:900a94bc7585	2060	} // end switch
wim	33:900a94bc7585	2061	} // end setContrast()
wim	32:59c4b8f648d4	2062
wim	32:59c4b8f648d4	2063
wim	32:59c4b8f648d4	2064	/** Set Power
wim	32:59c4b8f648d4	2065	* setPower method is supported by some compatible devices (eg SSD1803) that have power down modes
wim	32:59c4b8f648d4	2066	*
wim	32:59c4b8f648d4	2067	* @param bool powerOn Power on/off
wim	32:59c4b8f648d4	2068	* @return none
wim	32:59c4b8f648d4	2069	*/
wim	32:59c4b8f648d4	2070	//@TODO Add support for 40x4 dual controller
wim	32:59c4b8f648d4	2071	void TextLCD_Base::setPower(bool powerOn) {
wim	32:59c4b8f648d4	2072
wim	32:59c4b8f648d4	2073	if (powerOn) {
wim	32:59c4b8f648d4	2074	// Switch on
wim	32:59c4b8f648d4	2075	setMode(DispOn);
wim	32:59c4b8f648d4	2076
wim	32:59c4b8f648d4	2077	// Controllers that supports specific Power Down mode
wim	32:59c4b8f648d4	2078	switch (_ctrl) {
wim	32:59c4b8f648d4	2079
wim	32:59c4b8f648d4	2080	// case PCF2113_3V3 :
wim	32:59c4b8f648d4	2081	// case PCF2119_3V3 :
wim	32:59c4b8f648d4	2082	// case ST7032_3V3 :
wim	32:59c4b8f648d4	2083	//@todo
wim	33:900a94bc7585	2084	// enable Booster Bon
wim	33:900a94bc7585	2085
wim	33:900a94bc7585	2086	case WS0010:
wim	33:900a94bc7585	2087	_writeCommand(0x17); // Char mode, DC/DC on
wim	33:900a94bc7585	2088	wait_ms(10); // Wait 10ms to ensure powered up
wim	33:900a94bc7585	2089	break;
wim	33:900a94bc7585	2090
wim	36:9f5f86dfd44a	2091	case KS0073:
wim	33:900a94bc7585	2092	case KS0078:
wim	32:59c4b8f648d4	2093	case SSD1803_3V3 :
wim	32:59c4b8f648d4	2094	// case SSD1803_5V :
wim	33:900a94bc7585	2095	_writeCommand(0x20 \| _function_1); // Select Ext Instr Set
wim	33:900a94bc7585	2096	_writeCommand(0x02); // Power On
wim	32:59c4b8f648d4	2097	_writeCommand(0x20 \| _function); // Select Std Instr Set
wim	32:59c4b8f648d4	2098	break;
wim	32:59c4b8f648d4	2099
wim	32:59c4b8f648d4	2100	default:
wim	32:59c4b8f648d4	2101	//Unsupported feature for other controllers
wim	32:59c4b8f648d4	2102	break;
wim	32:59c4b8f648d4	2103	} // end switch
wim	32:59c4b8f648d4	2104	}
wim	32:59c4b8f648d4	2105	else {
wim	32:59c4b8f648d4	2106	// Switch off
wim	32:59c4b8f648d4	2107	setMode(DispOff);
wim	32:59c4b8f648d4	2108
wim	32:59c4b8f648d4	2109	// Controllers that support specific Power Down mode
wim	32:59c4b8f648d4	2110	switch (_ctrl) {
wim	32:59c4b8f648d4	2111
wim	32:59c4b8f648d4	2112	// case PCF2113_3V3 :
wim	32:59c4b8f648d4	2113	// case PCF2119_3V3 :
wim	32:59c4b8f648d4	2114	// case ST7032_3V3 :
wim	32:59c4b8f648d4	2115	//@todo
wim	33:900a94bc7585	2116	// disable Booster Bon
wim	33:900a94bc7585	2117
wim	33:900a94bc7585	2118	case WS0010:
wim	33:900a94bc7585	2119	_writeCommand(0x13); // Char mode, DC/DC off
wim	33:900a94bc7585	2120	break;
wim	33:900a94bc7585	2121
wim	36:9f5f86dfd44a	2122	case KS0073:
wim	33:900a94bc7585	2123	case KS0078:
wim	32:59c4b8f648d4	2124	case SSD1803_3V3 :
wim	32:59c4b8f648d4	2125	// case SSD1803_5V :
wim	33:900a94bc7585	2126	_writeCommand(0x20 \| _function_1); // Select Ext Instr Set
wim	33:900a94bc7585	2127	_writeCommand(0x03); // Power Down
wim	32:59c4b8f648d4	2128	_writeCommand(0x20 \| _function); // Select Std Instr Set
wim	32:59c4b8f648d4	2129	break;
wim	32:59c4b8f648d4	2130
wim	32:59c4b8f648d4	2131	default:
wim	32:59c4b8f648d4	2132	//Unsupported feature for other controllers
wim	32:59c4b8f648d4	2133	break;
wim	32:59c4b8f648d4	2134	} // end switch
wim	32:59c4b8f648d4	2135	}
wim	33:900a94bc7585	2136	} // end setPower()
wim	33:900a94bc7585	2137
wim	33:900a94bc7585	2138
wim	33:900a94bc7585	2139	/** Set Orient
wim	33:900a94bc7585	2140	* setOrient method is supported by some compatible devices (eg SSD1803, US2066) that have top/bottom view modes
wim	33:900a94bc7585	2141	*
wim	33:900a94bc7585	2142	* @param LCDOrient orient Orientation
wim	33:900a94bc7585	2143	* @return none
wim	33:900a94bc7585	2144	*/
wim	33:900a94bc7585	2145	void TextLCD_Base::setOrient(LCDOrient orient){
wim	33:900a94bc7585	2146
wim	33:900a94bc7585	2147	switch (orient) {
wim	33:900a94bc7585	2148
wim	33:900a94bc7585	2149	case Top:
wim	33:900a94bc7585	2150	switch (_ctrl) {
wim	34:e5a0dcb43ecc	2151	case PCF2103_3V3:
wim	34:e5a0dcb43ecc	2152	case PCF2116_3V3:
wim	34:e5a0dcb43ecc	2153	case PCF2116_5V:
wim	34:e5a0dcb43ecc	2154	case PCF2119_3V3:
wim	34:e5a0dcb43ecc	2155	_writeCommand(0x20 \| _function \| 0x01); // Set function, Select Instr Set = 1
wim	34:e5a0dcb43ecc	2156	_writeCommand(0x05); // Display Conf Set 0000 0, 1, P=0, Q=1 (Instr. Set 1)
wim	34:e5a0dcb43ecc	2157	_writeCommand(0x20 \| _function); // Set function, Select Instr Set = 0
wim	34:e5a0dcb43ecc	2158	break;
wim	34:e5a0dcb43ecc	2159
wim	33:900a94bc7585	2160	case SSD1803_3V3 :
wim	33:900a94bc7585	2161	// case SSD1803_5V :
wim	33:900a94bc7585	2162	case US2066_3V3 :
wim	33:900a94bc7585	2163	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 X N BE RE(1) REV
wim	33:900a94bc7585	2164	// Select Extended Instruction Set
wim	33:900a94bc7585	2165	// _writeCommand(0x06); // Set ext entry mode, 0 0 0 0 0 1 BDC=1 COM1-32, BDS=0 SEG100-1 "Bottom View" (Ext Instr Set)
wim	33:900a94bc7585	2166	_writeCommand(0x05); // Set ext entry mode, 0 0 0 0 0 1 BDC=0 COM32-1, BDS=1 SEG1-100 "Top View" (Ext Instr Set)
wim	33:900a94bc7585	2167
wim	33:900a94bc7585	2168	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
wim	33:900a94bc7585	2169	// Select Std Instr set, Select IS=0
wim	33:900a94bc7585	2170	break;
wim	36:9f5f86dfd44a	2171
wim	36:9f5f86dfd44a	2172	case ST7070:
wim	36:9f5f86dfd44a	2173	_writeCommand(0x20 \| _function \| 0x04); // Set function, 0 0 1 DL, N, EXT=1, x, x (Select Instr Set = 1)
wim	36:9f5f86dfd44a	2174
wim	36:9f5f86dfd44a	2175	_writeCommand(0x40 \| 0x00); // COM/SEG directions 0 1 0 0 C1, C2, S1, S2 (Instr Set 1)
wim	36:9f5f86dfd44a	2176	// C1=1: Com1-8 -> Com8-1; C2=1: Com9-16 -> Com16-9
wim	36:9f5f86dfd44a	2177	// S1=1: Seg1-40 -> Seg40-1; S2=1: Seg41-80 -> Seg80-41
wim	36:9f5f86dfd44a	2178	wait_ms(5); // Wait to ensure completion or ST7070 fails to set Top/Bottom after reset..
wim	36:9f5f86dfd44a	2179
wim	36:9f5f86dfd44a	2180	_writeCommand(0x20 \| _function); // Set function, EXT=0 (Select Instr Set = 0)
wim	36:9f5f86dfd44a	2181
wim	36:9f5f86dfd44a	2182	break; // case ST7070 Controller
wim	33:900a94bc7585	2183
wim	33:900a94bc7585	2184	default:
wim	33:900a94bc7585	2185	//Unsupported feature for other controllers
wim	33:900a94bc7585	2186	break;
wim	33:900a94bc7585	2187
wim	33:900a94bc7585	2188	} // end switch _ctrl
wim	33:900a94bc7585	2189	break; // end Top
wim	33:900a94bc7585	2190
wim	33:900a94bc7585	2191	case Bottom:
wim	33:900a94bc7585	2192	switch (_ctrl) {
wim	34:e5a0dcb43ecc	2193	case PCF2103_3V3:
wim	34:e5a0dcb43ecc	2194	case PCF2116_3V3:
wim	34:e5a0dcb43ecc	2195	case PCF2116_5V:
wim	34:e5a0dcb43ecc	2196	case PCF2119_3V3:
wim	34:e5a0dcb43ecc	2197	_writeCommand(0x20 \| _function \| 0x01); // Set function, Select Instr Set = 1
wim	34:e5a0dcb43ecc	2198	_writeCommand(0x06); // Display Conf Set 0000 0, 1, P=1, Q=0 (Instr. Set 1)
wim	34:e5a0dcb43ecc	2199	_writeCommand(0x20 \| _function); // Set function, Select Instr Set = 0
wim	34:e5a0dcb43ecc	2200	break;
wim	34:e5a0dcb43ecc	2201
wim	33:900a94bc7585	2202	case SSD1803_3V3 :
wim	33:900a94bc7585	2203	// case SSD1803_5V :
wim	33:900a94bc7585	2204	case US2066_3V3 :
wim	33:900a94bc7585	2205	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 X N BE RE(1) REV
wim	33:900a94bc7585	2206	// Select Extended Instruction Set
wim	33:900a94bc7585	2207	_writeCommand(0x06); // Set ext entry mode, 0 0 0 0 0 1 BDC=1 COM1-32, BDS=0 SEG100-1 "Bottom View" (Ext Instr Set)
wim	33:900a94bc7585	2208	// _writeCommand(0x05); // Set ext entry mode, 0 0 0 0 0 1 BDC=0 COM32-1, BDS=1 SEG1-100 "Top View" (Ext Instr Set)
wim	33:900a94bc7585	2209
wim	33:900a94bc7585	2210	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
wim	33:900a94bc7585	2211	// Select Std Instr set, Select IS=0
wim	33:900a94bc7585	2212	break;
wim	36:9f5f86dfd44a	2213
wim	36:9f5f86dfd44a	2214	case ST7070:
wim	36:9f5f86dfd44a	2215	//Note: this does not result in correct top/bottom view.
wim	36:9f5f86dfd44a	2216	//The left and right half of each row are reversed and the addressing of both rows is also incorrect:
wim	36:9f5f86dfd44a	2217	//Top/bottomline when orientation is flipped:
wim	36:9f5f86dfd44a	2218	// 0x48...0x4F 0x40...0x47
wim	36:9f5f86dfd44a	2219	// 0x08...0x0F 0x00...0x07
wim	36:9f5f86dfd44a	2220	_writeCommand(0x20 \| _function \| 0x04); // Set function, 0 0 1 DL N EXT=1 x x (Select Instr Set = 1)
wim	36:9f5f86dfd44a	2221
wim	36:9f5f86dfd44a	2222	_writeCommand(0x40 \| 0x0F); // COM/SEG directions 0 1 0 0 C1, C2, S1, S2 (Instr Set 1)
wim	36:9f5f86dfd44a	2223	// C1=1: Com1-8 -> Com8-1; C2=1: Com9-16 -> Com16-9
wim	36:9f5f86dfd44a	2224	// S1=1: Seg1-40 -> Seg40-1; S2=1: Seg41-80 -> Seg80-41
wim	36:9f5f86dfd44a	2225	wait_ms(5); // Wait to ensure completion or ST7070 fails to set Top/Bottom after reset..
wim	36:9f5f86dfd44a	2226
wim	36:9f5f86dfd44a	2227	_writeCommand(0x20 \| _function); // Set function, EXT=0 (Select Instr Set = 0)
wim	36:9f5f86dfd44a	2228
wim	36:9f5f86dfd44a	2229	break; // case ST7070 Controller
wim	33:900a94bc7585	2230
wim	33:900a94bc7585	2231	default:
wim	33:900a94bc7585	2232	//Unsupported feature for other controllers
wim	33:900a94bc7585	2233	break;
wim	33:900a94bc7585	2234
wim	33:900a94bc7585	2235	} // end switch _ctrl
wim	33:900a94bc7585	2236
wim	33:900a94bc7585	2237	break; // end Bottom
wim	33:900a94bc7585	2238	} // end switch orient
wim	33:900a94bc7585	2239	} // end setOrient()
wim	33:900a94bc7585	2240
wim	34:e5a0dcb43ecc	2241	/** Set Big Font
wim	34:e5a0dcb43ecc	2242	* setBigFont method is supported by some compatible devices (eg SSD1803, US2066)
wim	34:e5a0dcb43ecc	2243	*
wim	34:e5a0dcb43ecc	2244	* @param lines The selected Big Font lines (None, TopLine, CenterLine, BottomLine, TopBottomLine)
wim	34:e5a0dcb43ecc	2245	* Double height characters can be shown on lines 1+2, 2+3, 3+4 or 1+2 and 3+4
wim	34:e5a0dcb43ecc	2246	* Valid double height lines depend on the LCDs number of rows.
wim	34:e5a0dcb43ecc	2247	*/
wim	34:e5a0dcb43ecc	2248	void TextLCD_Base::setBigFont(LCDBigFont lines) {
wim	34:e5a0dcb43ecc	2249
wim	34:e5a0dcb43ecc	2250	switch (lines) {
wim	34:e5a0dcb43ecc	2251	case None:
wim	34:e5a0dcb43ecc	2252	switch (_ctrl) {
wim	34:e5a0dcb43ecc	2253	case SSD1803_3V3 :
wim	34:e5a0dcb43ecc	2254	case US2066_3V3 :
wim	34:e5a0dcb43ecc	2255	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 X N BE RE(1) REV
wim	34:e5a0dcb43ecc	2256	// Select Extended Instruction Set
wim	34:e5a0dcb43ecc	2257	_writeCommand(0x1C); // Double Height, 0 0 0 1 UD2=1, UD1=1, X, DH'=0 (Ext Instr Set)
wim	34:e5a0dcb43ecc	2258	// Default
wim	34:e5a0dcb43ecc	2259	_function = _function & ~0x04; // Set function, 0 0 1 DL N DH=0 RE(0) IS=0 Select Instruction Set 0
wim	34:e5a0dcb43ecc	2260	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
wim	34:e5a0dcb43ecc	2261	// Select Std Instr set, Select IS=0
wim	34:e5a0dcb43ecc	2262	break; // end US2066
wim	34:e5a0dcb43ecc	2263
wim	34:e5a0dcb43ecc	2264	default:
wim	34:e5a0dcb43ecc	2265	break; // end default
wim	34:e5a0dcb43ecc	2266	} // end switch _ctrl
wim	34:e5a0dcb43ecc	2267	break; // end None
wim	34:e5a0dcb43ecc	2268
wim	34:e5a0dcb43ecc	2269	case TopLine:
wim	34:e5a0dcb43ecc	2270	if (_nr_rows < 2) return; //Sanity check
wim	34:e5a0dcb43ecc	2271
wim	34:e5a0dcb43ecc	2272	switch (_ctrl) {
wim	34:e5a0dcb43ecc	2273	case SSD1803_3V3 :
wim	34:e5a0dcb43ecc	2274	case US2066_3V3 :
wim	34:e5a0dcb43ecc	2275	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 X N BE RE(1) REV
wim	34:e5a0dcb43ecc	2276	// Select Extended Instruction Set
wim	34:e5a0dcb43ecc	2277	_writeCommand(0x1C); // Double Height, 0 0 0 1 UD2=1, UD1=1, X, DH'=0 (Ext Instr Set)
wim	34:e5a0dcb43ecc	2278	// Default
wim	34:e5a0dcb43ecc	2279	_function = _function \| 0x04; // Set function, 0 0 1 DL N DH=1 RE(0) IS=0 Select Instruction Set 0
wim	34:e5a0dcb43ecc	2280	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
wim	34:e5a0dcb43ecc	2281	// Select Std Instr set, Select IS=0
wim	34:e5a0dcb43ecc	2282	break; // end US2066, SSD1803
wim	34:e5a0dcb43ecc	2283
wim	34:e5a0dcb43ecc	2284	default:
wim	34:e5a0dcb43ecc	2285	break; // end default
wim	34:e5a0dcb43ecc	2286	} // end switch _ctrl
wim	34:e5a0dcb43ecc	2287	break; // end TopLine
wim	34:e5a0dcb43ecc	2288
wim	34:e5a0dcb43ecc	2289	case CenterLine:
wim	34:e5a0dcb43ecc	2290	if (_nr_rows != 4) return; //Sanity check
wim	34:e5a0dcb43ecc	2291
wim	34:e5a0dcb43ecc	2292	switch (_ctrl) {
wim	34:e5a0dcb43ecc	2293	case SSD1803_3V3 :
wim	34:e5a0dcb43ecc	2294	case US2066_3V3 :
wim	34:e5a0dcb43ecc	2295	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 X N BE RE(1) REV
wim	34:e5a0dcb43ecc	2296	// Select Extended Instruction Set
wim	34:e5a0dcb43ecc	2297	_writeCommand(0x14); // Double Height, 0 0 0 1 UD2=0, UD1=1, X, DH'=0 (Ext Instr Set)
wim	34:e5a0dcb43ecc	2298	// Default
wim	34:e5a0dcb43ecc	2299	_function = _function \| 0x04; // Set function, 0 0 1 DL N DH=1 RE(0) IS=0 Select Instruction Set 0
wim	34:e5a0dcb43ecc	2300	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
wim	34:e5a0dcb43ecc	2301	// Select Std Instr set, Select IS=0
wim	34:e5a0dcb43ecc	2302	break; // end US2066, SSD1803
wim	34:e5a0dcb43ecc	2303
wim	34:e5a0dcb43ecc	2304	default:
wim	34:e5a0dcb43ecc	2305	break; // end default
wim	34:e5a0dcb43ecc	2306	} // end switch _ctrl
wim	34:e5a0dcb43ecc	2307	break; // end CenterLine
wim	34:e5a0dcb43ecc	2308
wim	34:e5a0dcb43ecc	2309	case BottomLine:
wim	34:e5a0dcb43ecc	2310	if (_nr_rows < 3) return; //Sanity check
wim	34:e5a0dcb43ecc	2311
wim	34:e5a0dcb43ecc	2312	switch (_ctrl) {
wim	34:e5a0dcb43ecc	2313	case SSD1803_3V3 :
wim	34:e5a0dcb43ecc	2314	case US2066_3V3 :
wim	34:e5a0dcb43ecc	2315	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 X N BE RE(1) REV
wim	34:e5a0dcb43ecc	2316	// Select Extended Instruction Set
wim	34:e5a0dcb43ecc	2317	if (_nr_rows == 3) {
wim	34:e5a0dcb43ecc	2318	_writeCommand(0x14); // Double Height, 0 0 0 1 UD2=0, UD1=1, X, DH'=0 (Ext Instr Set)
wim	34:e5a0dcb43ecc	2319	}
wim	34:e5a0dcb43ecc	2320	else {
wim	34:e5a0dcb43ecc	2321	_writeCommand(0x10); // Double Height, 0 0 0 1 UD2=0, UD1=0, X, DH'=0 (Ext Instr Set)
wim	34:e5a0dcb43ecc	2322	}
wim	34:e5a0dcb43ecc	2323	_function = _function \| 0x04; // Set function, 0 0 1 DL N DH=1 RE(0) IS=0 Select Instruction Set 0
wim	34:e5a0dcb43ecc	2324	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
wim	34:e5a0dcb43ecc	2325	// Select Std Instr set, Select IS=0
wim	34:e5a0dcb43ecc	2326	break; // end US2066, SSD1803
wim	34:e5a0dcb43ecc	2327
wim	34:e5a0dcb43ecc	2328	default:
wim	34:e5a0dcb43ecc	2329	break; // end default
wim	34:e5a0dcb43ecc	2330	} // end switch _ctrl
wim	34:e5a0dcb43ecc	2331	break; // end BottomLine
wim	34:e5a0dcb43ecc	2332
wim	34:e5a0dcb43ecc	2333	case TopBottomLine:
wim	34:e5a0dcb43ecc	2334	if (_nr_rows != 4) return; //Sanity check
wim	34:e5a0dcb43ecc	2335
wim	34:e5a0dcb43ecc	2336	switch (_ctrl) {
wim	34:e5a0dcb43ecc	2337	case SSD1803_3V3 :
wim	34:e5a0dcb43ecc	2338	case US2066_3V3 :
wim	34:e5a0dcb43ecc	2339	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 X N BE RE(1) REV
wim	34:e5a0dcb43ecc	2340	// Select Extended Instruction Set
wim	34:e5a0dcb43ecc	2341	_writeCommand(0x18); // Double Height, 0 0 0 1 UD2=1, UD1=0, X, DH'=0 (Ext Instr Set)
wim	34:e5a0dcb43ecc	2342	// Default
wim	34:e5a0dcb43ecc	2343	_function = _function \| 0x04; // Set function, 0 0 1 DL N DH=1 RE(0) IS=0 Select Instruction Set 0
wim	34:e5a0dcb43ecc	2344	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
wim	34:e5a0dcb43ecc	2345	// Select Std Instr set, Select IS=0
wim	34:e5a0dcb43ecc	2346	break; // end US2066, SSD1803
wim	34:e5a0dcb43ecc	2347
wim	34:e5a0dcb43ecc	2348	default:
wim	34:e5a0dcb43ecc	2349	break; // end default
wim	34:e5a0dcb43ecc	2350	} // end switch _ctrl
wim	34:e5a0dcb43ecc	2351	break; // end TopBottomLine
wim	34:e5a0dcb43ecc	2352
wim	34:e5a0dcb43ecc	2353	} // end switch lines
wim	34:e5a0dcb43ecc	2354
wim	34:e5a0dcb43ecc	2355	} // end setBigFont()
wim	32:59c4b8f648d4	2356
wim	36:9f5f86dfd44a	2357
wim	36:9f5f86dfd44a	2358	/** Set Icons
wim	36:9f5f86dfd44a	2359	*
wim	36:9f5f86dfd44a	2360	* @param unsigned char idx The Index of the icon pattern (0..15) for KS0073 and similar controllers
wim	36:9f5f86dfd44a	2361	* and Index (0..31) for PCF2103 and similar controllers
wim	36:9f5f86dfd44a	2362	* @param unsigned char data The bitpattern for the icons (6 lsb for KS0073 bitpattern (5 lsb for KS0078) and 2 msb for blinkmode)
wim	36:9f5f86dfd44a	2363	* The bitpattern for the PCF2103 icons is 5 lsb (UDC 0..2) and 5 lsb for blinkmode (UDC 4..6)
wim	36:9f5f86dfd44a	2364	*/
wim	36:9f5f86dfd44a	2365	void TextLCD_Base::setIcon(unsigned char idx, unsigned char data) {
wim	36:9f5f86dfd44a	2366	// Blinking icons are enabled when a specific controlbit (BE) is set.
wim	36:9f5f86dfd44a	2367	// The blinking pixels in the icons can be controlled by setting additional bits in the icon bitpattern.
wim	36:9f5f86dfd44a	2368	// Icons are defined by a byte bitpattern. The P0..P5 form the Icon pattern for KS0073, and P0..P4 for KS0078
wim	36:9f5f86dfd44a	2369	// P7 P6 P5 P4 P3 P2 P1 P0
wim	36:9f5f86dfd44a	2370	// 0 B1 B0 0 0 1 1 1 0
wim	36:9f5f86dfd44a	2371	// 1 B1 B0 1 1 0 0 0 1
wim	36:9f5f86dfd44a	2372	// .............
wim	36:9f5f86dfd44a	2373	// 15 B1 B0 1 1 0 0 0 1
wim	36:9f5f86dfd44a	2374	//
wim	36:9f5f86dfd44a	2375	// Bit 6 and Bit 7 in the pattern will control the blinking mode when Blink is enabled through BE.
wim	36:9f5f86dfd44a	2376	// B1 B0 Mode
wim	36:9f5f86dfd44a	2377	// 0 0 No Blinking for this icon row
wim	36:9f5f86dfd44a	2378	// 0 1 Enabled pixels in P5 will blink
wim	36:9f5f86dfd44a	2379	// 1 x Enabled pixels in P0..P5 will blink
wim	36:9f5f86dfd44a	2380	//
wim	36:9f5f86dfd44a	2381	// Note: the PCF2103 and PCF2113 use UDCs to set Icons
wim	36:9f5f86dfd44a	2382	// 3 x 8 rows x 5 bits = 120 bits Icons for Normal pattern (UDC 0..2) and
wim	36:9f5f86dfd44a	2383	// 3 x 8 rows x 5 bits = 120 bits Icons for Blink pattern (UDC 4..6)
wim	36:9f5f86dfd44a	2384	// Note: the PCF2119 uses UDCs to set Icons
wim	36:9f5f86dfd44a	2385	// 4 x 8 rows x 5 bits = 160 bits Icons for Normal pattern (UDC 0..3) and
wim	36:9f5f86dfd44a	2386	// 4 x 8 rows x 5 bits = 160 bits Icons for Blink pattern (UDC 4..7)
wim	36:9f5f86dfd44a	2387
wim	36:9f5f86dfd44a	2388	switch (_ctrl) {
wim	36:9f5f86dfd44a	2389	case KS0073:
wim	36:9f5f86dfd44a	2390	case KS0078:
wim	36:9f5f86dfd44a	2391	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 DL N RE(1) BE LP
wim	36:9f5f86dfd44a	2392	// Select Extended Instruction Set
wim	36:9f5f86dfd44a	2393	_writeCommand(0x40 \| (idx & 0x0F)); // Set Icon Address, mask Address to valid range (Ext Instr Set)
wim	36:9f5f86dfd44a	2394
wim	36:9f5f86dfd44a	2395	_writeData(data); // Set Icon pattern (Ext Instr Set)
wim	36:9f5f86dfd44a	2396
wim	36:9f5f86dfd44a	2397	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N RE(0) DH REV Select Instruction Set 0
wim	36:9f5f86dfd44a	2398	// Select Std Instr set, Select IS=0
wim	36:9f5f86dfd44a	2399	break; // end KS0073, KS0078
wim	36:9f5f86dfd44a	2400
wim	36:9f5f86dfd44a	2401	case ST7032_3V3:
wim	36:9f5f86dfd44a	2402	case ST7032_5V:
wim	36:9f5f86dfd44a	2403	_writeCommand(0x20 \| _function \| 0x01); // Set function, 0 0 1 DL N F 0 IS=1 Select Instr Set = 1
wim	36:9f5f86dfd44a	2404	_writeCommand(0x40 \| (idx & 0x0F)); // Set Icon Address, mask Address to valid range (Instr Set 1)
wim	36:9f5f86dfd44a	2405
wim	36:9f5f86dfd44a	2406	_writeData(data & 0x1F); // Set Icon pattern, no blink support (Instr Set 1)
wim	36:9f5f86dfd44a	2407
wim	36:9f5f86dfd44a	2408	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N RE(0) DH REV Select Instruction Set 0
wim	36:9f5f86dfd44a	2409	// Select Std Instr set, Select IS=0
wim	36:9f5f86dfd44a	2410	break; // end ST7032
wim	36:9f5f86dfd44a	2411
wim	36:9f5f86dfd44a	2412	case ST7036_3V3:
wim	36:9f5f86dfd44a	2413	case ST7036_5V:
wim	36:9f5f86dfd44a	2414	_writeCommand(0x20 \| _function \| 0x01); // Set function, 0 0 1 DL N DH IS2,IS1 = 01 (Select Instr Set = 1)
wim	36:9f5f86dfd44a	2415	_writeCommand(0x40 \| (idx & 0x0F)); // Set Icon Address, mask Address to valid range (Instr Set 1)
wim	36:9f5f86dfd44a	2416
wim	36:9f5f86dfd44a	2417	_writeData(data & 0x1F); // Set Icon pattern, no blink support (Instr Set 1)
wim	36:9f5f86dfd44a	2418
wim	36:9f5f86dfd44a	2419	_writeCommand(0x20 \| _function); // Set function, IS2,IS1 = 00 (Select Instr Set = 0)
wim	36:9f5f86dfd44a	2420	// Select Std Instr set, Select IS=0
wim	36:9f5f86dfd44a	2421	break; // end ST7036
wim	36:9f5f86dfd44a	2422
wim	36:9f5f86dfd44a	2423	case SSD1803_3V3:
wim	36:9f5f86dfd44a	2424	// case SSD1803_5V:
wim	36:9f5f86dfd44a	2425	_writeCommand(0x20 \| _function \| 0x01); // Set function, 0 0 1 DL N DH RE(0) IS
wim	36:9f5f86dfd44a	2426	// Select Instruction Set 1
wim	36:9f5f86dfd44a	2427	_writeCommand(0x40 \| (idx & 0x0F)); // Set Icon Address, mask Address to valid range (Instr Set = 1)
wim	36:9f5f86dfd44a	2428	_writeData(data); // Set Icon pattern (Instr Set = 1)
wim	36:9f5f86dfd44a	2429
wim	36:9f5f86dfd44a	2430	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N DH RE(0) IS
wim	36:9f5f86dfd44a	2431	// Select IS=0
wim	36:9f5f86dfd44a	2432	break; // end SSD1803
wim	36:9f5f86dfd44a	2433
wim	36:9f5f86dfd44a	2434	case PCF2103_3V3:
wim	36:9f5f86dfd44a	2435	case PCF2113_3V3:
wim	36:9f5f86dfd44a	2436	case PCF2119_3V3:
wim	36:9f5f86dfd44a	2437	// Store UDC/Icon pattern for PCF2103 and PCF2113:
wim	36:9f5f86dfd44a	2438	// 3 x 8 rows x 5 bits = 120 bits for Normal pattern (UDC 0..2) and
wim	36:9f5f86dfd44a	2439	// 3 x 8 rows x 5 bits = 120 bits for Blink pattern (UDC 4..6)
wim	36:9f5f86dfd44a	2440	// Store UDC/Icon pattern for PCF2119:
wim	36:9f5f86dfd44a	2441	// 4 x 8 rows x 5 bits = 160 bits for Normal pattern (UDC 0..3) and
wim	36:9f5f86dfd44a	2442	// 4 x 8 rows x 5 bits = 160 bits for Blink pattern (UDC 4..7)
wim	36:9f5f86dfd44a	2443	_writeCommand(0x40 \| (idx & 0x3F)); //Set CG-RAM address, 8 sequential locations needed per UDC
wim	36:9f5f86dfd44a	2444	_writeData(data); // Set Icon pattern (Instr Set = 1)
wim	36:9f5f86dfd44a	2445	break; // case PCF2103_3V3 Controller
wim	36:9f5f86dfd44a	2446
wim	36:9f5f86dfd44a	2447	default:
wim	36:9f5f86dfd44a	2448	break; // end default
wim	36:9f5f86dfd44a	2449	} // end switch _ctrl
wim	36:9f5f86dfd44a	2450
wim	36:9f5f86dfd44a	2451	//Select DD RAM again for current LCD controller and restore the addresspointer
wim	36:9f5f86dfd44a	2452	int addr = getAddress(_column, _row);
wim	36:9f5f86dfd44a	2453	_writeCommand(0x80 \| addr);
wim	36:9f5f86dfd44a	2454
wim	36:9f5f86dfd44a	2455	} // end setIcon()
wim	36:9f5f86dfd44a	2456
wim	36:9f5f86dfd44a	2457	/** Clear Icons
wim	36:9f5f86dfd44a	2458	*
wim	36:9f5f86dfd44a	2459	* @param none
wim	36:9f5f86dfd44a	2460	* @return none
wim	36:9f5f86dfd44a	2461	*/
wim	36:9f5f86dfd44a	2462	//@TODO Add support for 40x4 dual controller
wim	36:9f5f86dfd44a	2463	void TextLCD_Base::clrIcon() {
wim	36:9f5f86dfd44a	2464	// Icons are defined by a byte bitpattern. The P0..P5 form the Icon pattern for KS0073, and P0..P4 for KS0078
wim	36:9f5f86dfd44a	2465	// P7 P6 P5 P4 P3 P2 P1 P0
wim	36:9f5f86dfd44a	2466	// 0 B1 B0 0 0 0 0 0 0
wim	36:9f5f86dfd44a	2467	// 1 B1 B0 0 0 0 0 0 0
wim	36:9f5f86dfd44a	2468	// .............
wim	36:9f5f86dfd44a	2469	// 15 B1 B0 0 0 0 0 0 0
wim	36:9f5f86dfd44a	2470	//
wim	36:9f5f86dfd44a	2471	// Bit 6 and Bit 7 in the pattern will control the blinking mode when Blink is enabled through BE.
wim	36:9f5f86dfd44a	2472	// B1 B0 Mode
wim	36:9f5f86dfd44a	2473	// 0 0 No Blinking for this icon row
wim	36:9f5f86dfd44a	2474	// 0 1 Enabled pixels in P5 will blink
wim	36:9f5f86dfd44a	2475	// 1 x Enabled pixels in P0..P5 will blink
wim	36:9f5f86dfd44a	2476	//
wim	36:9f5f86dfd44a	2477	// Note: the PCF2103 and PCF2113 use UDCs to set Icons
wim	36:9f5f86dfd44a	2478	// 3 x 8 rows x 5 bits = 120 bits Icons for Normal pattern (UDC 0..2) and
wim	36:9f5f86dfd44a	2479	// 3 x 8 rows x 5 bits = 120 bits Icons for Blink pattern (UDC 4..6)
wim	36:9f5f86dfd44a	2480	// Note: the PCF2119 uses UDCs to set Icons
wim	36:9f5f86dfd44a	2481	// 4 x 8 rows x 5 bits = 160 bits Icons for Normal pattern (UDC 0..3) and
wim	36:9f5f86dfd44a	2482	// 4 x 8 rows x 5 bits = 160 bits Icons for Blink pattern (UDC 4..7)
wim	36:9f5f86dfd44a	2483	int idx;
wim	36:9f5f86dfd44a	2484
wim	36:9f5f86dfd44a	2485	switch (_ctrl) {
wim	36:9f5f86dfd44a	2486	case KS0073:
wim	36:9f5f86dfd44a	2487	case KS0078:
wim	36:9f5f86dfd44a	2488	_writeCommand(0x20 \| _function_1); // Set function, 0 0 1 DL N RE(1) BE LP
wim	36:9f5f86dfd44a	2489	// Select Extended Instruction Set
wim	36:9f5f86dfd44a	2490	for (idx=0; idx<16; idx++) {
wim	36:9f5f86dfd44a	2491	_writeCommand(0x40 \| idx); // Set Icon Address, mask Address to valid range (Ext Instr Set)
wim	36:9f5f86dfd44a	2492	_writeData(0x00); // Clear Icon pattern (Ext Instr Set)
wim	36:9f5f86dfd44a	2493	}
wim	36:9f5f86dfd44a	2494	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N RE(0) DH REV Select Std Instruction Set
wim	36:9f5f86dfd44a	2495	// Select Std Instr set
wim	36:9f5f86dfd44a	2496	break; // end KS0073, KS0078
wim	36:9f5f86dfd44a	2497
wim	36:9f5f86dfd44a	2498	case ST7032_3V3:
wim	36:9f5f86dfd44a	2499	case ST7032_5V:
wim	36:9f5f86dfd44a	2500	_writeCommand(0x20 \| _function \| 0x01); // Set function, 0 0 1 DL N F 0 IS=1 Select Instr Set = 1
wim	36:9f5f86dfd44a	2501
wim	36:9f5f86dfd44a	2502	for (idx=0; idx<16; idx++) {
wim	36:9f5f86dfd44a	2503	_writeCommand(0x40 \| idx); // Set Icon Address, mask Address to valid range (Instr Set 1)
wim	36:9f5f86dfd44a	2504	_writeData(0x00); // Clear Icon pattern (Instr Set 1)
wim	36:9f5f86dfd44a	2505	}
wim	36:9f5f86dfd44a	2506
wim	36:9f5f86dfd44a	2507	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N RE(0) DH REV Select Instruction Set 0
wim	36:9f5f86dfd44a	2508	// Select Std Instr set, Select IS=0
wim	36:9f5f86dfd44a	2509	break; // end ST7032
wim	36:9f5f86dfd44a	2510
wim	36:9f5f86dfd44a	2511	case ST7036_3V3:
wim	36:9f5f86dfd44a	2512	case ST7036_5V:
wim	36:9f5f86dfd44a	2513	_writeCommand(0x20 \| _function \| 0x01); // Set function, 0 0 1 DL N DH IS2,IS1 = 01 (Select Instr Set = 1)
wim	36:9f5f86dfd44a	2514
wim	36:9f5f86dfd44a	2515	for (idx=0; idx<16; idx++) {
wim	36:9f5f86dfd44a	2516	_writeCommand(0x40 \| idx); // Set Icon Address, mask Address to valid range (Instr Set 1)
wim	36:9f5f86dfd44a	2517	_writeData(0x00); // Clear Icon pattern (Instr Set 1)
wim	36:9f5f86dfd44a	2518	}
wim	36:9f5f86dfd44a	2519
wim	36:9f5f86dfd44a	2520	_writeCommand(0x20 \| _function); // Set function, IS2,IS1 = 00 (Select Instr Set = 0)
wim	36:9f5f86dfd44a	2521	// Select Std Instr set, Select IS=0
wim	36:9f5f86dfd44a	2522	break; // end ST7036
wim	36:9f5f86dfd44a	2523
wim	36:9f5f86dfd44a	2524	case SSD1803_3V3:
wim	36:9f5f86dfd44a	2525	// case SSD1803_5V:
wim	36:9f5f86dfd44a	2526	_writeCommand(0x20 \| _function \| 0x01); // Set function, 0 0 1 DL N DH RE(0) IS
wim	36:9f5f86dfd44a	2527	// Select Instruction Set 1
wim	36:9f5f86dfd44a	2528	for (idx=0; idx<16; idx++) {
wim	36:9f5f86dfd44a	2529	_writeCommand(0x40 \| idx); // Set Icon Address, mask Address to valid range (Ext Instr Set)
wim	36:9f5f86dfd44a	2530	_writeData(0x00); // Clear Icon pattern (Ext Instr Set)
wim	36:9f5f86dfd44a	2531	}
wim	36:9f5f86dfd44a	2532	_writeCommand(0x20 \| _function); // Set function, 0 0 1 DL N DH RE(0) IS
wim	36:9f5f86dfd44a	2533	// Select IS=0
wim	36:9f5f86dfd44a	2534	break; // end SSD1803
wim	36:9f5f86dfd44a	2535
wim	36:9f5f86dfd44a	2536	case PCF2103_3V3:
wim	36:9f5f86dfd44a	2537	case PCF2113_3V3:
wim	36:9f5f86dfd44a	2538	// PCF2103 and PCF2113 use part of the UDC RAM to control Icons
wim	36:9f5f86dfd44a	2539	// Select CG RAM
wim	36:9f5f86dfd44a	2540
wim	36:9f5f86dfd44a	2541	_writeCommand(0x40 \| (0 * 8)); //Set CG-RAM address, 8 sequential locations needed per UDC
wim	36:9f5f86dfd44a	2542	// Store UDC/Icon pattern:
wim	36:9f5f86dfd44a	2543	// 3 x 8 rows x 5 bits = 120 bits for Normal pattern (UDC 0..2) and
wim	36:9f5f86dfd44a	2544	for (int i=0; i<(3 * 8); i++) {
wim	36:9f5f86dfd44a	2545	// _writeData(0x1F); // All On
wim	36:9f5f86dfd44a	2546	_writeData(0x00); // All Off
wim	36:9f5f86dfd44a	2547	}
wim	36:9f5f86dfd44a	2548
wim	36:9f5f86dfd44a	2549	_writeCommand(0x40 \| (4 * 8)); //Set CG-RAM address, 8 sequential locations needed per UDC
wim	36:9f5f86dfd44a	2550	// 3 x 8 rows x 5 bits = 120 bits for Blink pattern (UDC 4..6)
wim	36:9f5f86dfd44a	2551	for (int i=0; i<(3 * 8); i++) {
wim	36:9f5f86dfd44a	2552	// _writeData(0x1F); // All On
wim	36:9f5f86dfd44a	2553	_writeData(0x00); // All Off
wim	36:9f5f86dfd44a	2554	}
wim	36:9f5f86dfd44a	2555	break; // case PCF2103_3V3 Controller
wim	36:9f5f86dfd44a	2556
wim	36:9f5f86dfd44a	2557	case PCF2119_3V3:
wim	36:9f5f86dfd44a	2558	// PCF2119 uses part of the UDC RAM to control Icons
wim	36:9f5f86dfd44a	2559	// Select CG RAM
wim	36:9f5f86dfd44a	2560
wim	36:9f5f86dfd44a	2561	_writeCommand(0x40 \| (0 * 8)); //Set CG-RAM address, 8 sequential locations needed per UDC
wim	36:9f5f86dfd44a	2562	// Store UDC/Icon pattern:
wim	36:9f5f86dfd44a	2563	// 4 x 8 rows x 5 bits = 160 bits for Normal pattern (UDC 0..3) and
wim	36:9f5f86dfd44a	2564	for (int i=0; i<(4 * 8); i++) {
wim	36:9f5f86dfd44a	2565	// _writeData(0x1F); // All On
wim	36:9f5f86dfd44a	2566	_writeData(0x00); // All Off
wim	36:9f5f86dfd44a	2567	}
wim	36:9f5f86dfd44a	2568
wim	36:9f5f86dfd44a	2569	_writeCommand(0x40 \| (4 * 8)); //Set CG-RAM address, 8 sequential locations needed per UDC
wim	36:9f5f86dfd44a	2570	// 4 x 8 rows x 5 bits = 160 bits for Blink pattern (UDC 4..7)
wim	36:9f5f86dfd44a	2571	for (int i=0; i<(4 * 8); i++) {
wim	36:9f5f86dfd44a	2572	// _writeData(0x1F); // All On
wim	36:9f5f86dfd44a	2573	_writeData(0x00); // All Off
wim	36:9f5f86dfd44a	2574	}
wim	36:9f5f86dfd44a	2575	break; // case PCF2119_3V3 Controller
wim	36:9f5f86dfd44a	2576
wim	36:9f5f86dfd44a	2577	default:
wim	36:9f5f86dfd44a	2578	break; // end default
wim	36:9f5f86dfd44a	2579	} // end switch _ctrl
wim	36:9f5f86dfd44a	2580
wim	36:9f5f86dfd44a	2581	//Select DD RAM again for current LCD controller and restore the addresspointer
wim	36:9f5f86dfd44a	2582	int addr = getAddress(_column, _row);
wim	36:9f5f86dfd44a	2583	_writeCommand(0x80 \| addr);
wim	36:9f5f86dfd44a	2584	} //end clrIcon()
wim	36:9f5f86dfd44a	2585
wim	36:9f5f86dfd44a	2586
wim	36:9f5f86dfd44a	2587	/** Set Invert
wim	36:9f5f86dfd44a	2588	* setInvert method is supported by some compatible devices (eg KS0073) to swap between black and white
wim	36:9f5f86dfd44a	2589	*
wim	36:9f5f86dfd44a	2590	* @param bool invertOn Invert on/off
wim	36:9f5f86dfd44a	2591	* @return none
wim	36:9f5f86dfd44a	2592	*/
wim	36:9f5f86dfd44a	2593	//@TODO Add support for 40x4 dual controller
wim	36:9f5f86dfd44a	2594	void TextLCD_Base::setInvert(bool invertOn) {
wim	36:9f5f86dfd44a	2595
wim	36:9f5f86dfd44a	2596	if (invertOn) {
wim	36:9f5f86dfd44a	2597	// Controllers that support Invert
wim	36:9f5f86dfd44a	2598	switch (_ctrl) {
wim	36:9f5f86dfd44a	2599	case KS0073:
wim	36:9f5f86dfd44a	2600	case KS0078:
wim	36:9f5f86dfd44a	2601	_function = _function \| 0x01; // Enable Invert
wim	36:9f5f86dfd44a	2602	_writeCommand(0x20 \| _function); // Activate Invert (Std Instr Set)
wim	36:9f5f86dfd44a	2603	break;
wim	36:9f5f86dfd44a	2604	case SSD1803_3V3 :
wim	36:9f5f86dfd44a	2605	// case SSD1803_5V :
wim	36:9f5f86dfd44a	2606	case US2066_3V3:
wim	36:9f5f86dfd44a	2607	// case USS2066_5V:
wim	36:9f5f86dfd44a	2608	_function_1 = _function_1 \| 0x01; // Enable Invert
wim	36:9f5f86dfd44a	2609	// Set function, 0 0 1 DL N BE RE(1) REV (SSD1803)
wim	36:9f5f86dfd44a	2610	// Set function, 0 0 1 X N BE RE(1) REV (US2066)
wim	36:9f5f86dfd44a	2611	_writeCommand(0x20 \| _function_1); // Activate Invert (Ext Instr Set)
wim	36:9f5f86dfd44a	2612	_writeCommand(0x20 \| _function); // Return to Std Instr Set
wim	36:9f5f86dfd44a	2613	break;
wim	36:9f5f86dfd44a	2614	default:
wim	36:9f5f86dfd44a	2615	//Unsupported feature for other controllers
wim	36:9f5f86dfd44a	2616	break;
wim	36:9f5f86dfd44a	2617	} // end switch
wim	36:9f5f86dfd44a	2618	}
wim	36:9f5f86dfd44a	2619	else {
wim	36:9f5f86dfd44a	2620	// Controllers that support Invert
wim	36:9f5f86dfd44a	2621	switch (_ctrl) {
wim	36:9f5f86dfd44a	2622	case KS0073:
wim	36:9f5f86dfd44a	2623	case KS0078:
wim	36:9f5f86dfd44a	2624	_function = _function & ~0x01; // Disable Invert
wim	36:9f5f86dfd44a	2625	_writeCommand(0x20 \| _function); // Disable Invert (Std Instr Set)
wim	36:9f5f86dfd44a	2626	break;
wim	36:9f5f86dfd44a	2627	case SSD1803_3V3 :
wim	36:9f5f86dfd44a	2628	// case SSD1803_5V :
wim	36:9f5f86dfd44a	2629	case US2066_3V3:
wim	36:9f5f86dfd44a	2630	// case USS2066_5V:
wim	36:9f5f86dfd44a	2631	_function_1 = _function_1 & ~0x01; // Disable Invert
wim	36:9f5f86dfd44a	2632	// Set function, 0 0 1 DL N BE RE(1) REV (SSD1803)
wim	36:9f5f86dfd44a	2633	// Set function, 0 0 1 X N BE RE(1) REV (US2066)
wim	36:9f5f86dfd44a	2634	_writeCommand(0x20 \| _function_1); // Activate Invert (Ext Instr Set)
wim	36:9f5f86dfd44a	2635	_writeCommand(0x20 \| _function); // Return to Std Instr Set
wim	36:9f5f86dfd44a	2636	break;
wim	36:9f5f86dfd44a	2637
wim	36:9f5f86dfd44a	2638	default:
wim	36:9f5f86dfd44a	2639	//Unsupported feature for other controllers
wim	36:9f5f86dfd44a	2640	break;
wim	36:9f5f86dfd44a	2641	} // end switch
wim	36:9f5f86dfd44a	2642	}
wim	36:9f5f86dfd44a	2643	} // end setInvert()
wim	36:9f5f86dfd44a	2644
wim	23:d47f226efb24	2645	//--------- End TextLCD_Base -----------
wim	21:9eb628d9e164	2646
wim	22:35742ec80c24	2647
wim	23:d47f226efb24	2648	//--------- Start TextLCD Bus -----------
wim	21:9eb628d9e164	2649
wim	21:9eb628d9e164	2650	/* Create a TextLCD interface for using regular mbed pins
wim	21:9eb628d9e164	2651	*
wim	21:9eb628d9e164	2652	* @param rs Instruction/data control line
wim	21:9eb628d9e164	2653	* @param e Enable line (clock)
wim	21:9eb628d9e164	2654	* @param d4-d7 Data lines for using as a 4-bit interface
wim	21:9eb628d9e164	2655	* @param type Sets the panel size/addressing mode (default = LCD16x2)
wim	21:9eb628d9e164	2656	* @param bl Backlight control line (optional, default = NC)
wim	21:9eb628d9e164	2657	* @param e2 Enable2 line (clock for second controller, LCD40x4 only)
wim	21:9eb628d9e164	2658	* @param ctrl LCD controller (default = HD44780)
wim	21:9eb628d9e164	2659	*/
wim	21:9eb628d9e164	2660	TextLCD::TextLCD(PinName rs, PinName e,
wim	21:9eb628d9e164	2661	PinName d4, PinName d5, PinName d6, PinName d7,
wim	21:9eb628d9e164	2662	LCDType type, PinName bl, PinName e2, LCDCtrl ctrl) :
wim	21:9eb628d9e164	2663	TextLCD_Base(type, ctrl),
wim	22:35742ec80c24	2664	_rs(rs), _e(e), _d(d4, d5, d6, d7) {
wim	22:35742ec80c24	2665
wim	22:35742ec80c24	2666	// The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
wim	22:35742ec80c24	2667	if (bl != NC) {
wim	22:35742ec80c24	2668	_bl = new DigitalOut(bl); //Construct new pin
wim	22:35742ec80c24	2669	_bl->write(0); //Deactivate
wim	22:35742ec80c24	2670	}
wim	22:35742ec80c24	2671	else {
wim	22:35742ec80c24	2672	// No Hardware Backlight pin
wim	22:35742ec80c24	2673	_bl = NULL; //Construct dummy pin
wim	22:35742ec80c24	2674	}
wim	22:35742ec80c24	2675
wim	22:35742ec80c24	2676	// The hardware Enable2 pin is only needed for LCD40x4. Test and make sure whether it exists or not to prevent illegal access.
wim	22:35742ec80c24	2677	if (e2 != NC) {
wim	22:35742ec80c24	2678	_e2 = new DigitalOut(e2); //Construct new pin
wim	22:35742ec80c24	2679	_e2->write(0); //Deactivate
wim	22:35742ec80c24	2680	}
wim	22:35742ec80c24	2681	else {
wim	22:35742ec80c24	2682	// No Hardware Enable pin
wim	22:35742ec80c24	2683	_e2 = NULL; //Construct dummy pin
wim	22:35742ec80c24	2684	}
wim	38:cbe275b0b647	2685
wim	38:cbe275b0b647	2686	_init(_LCD_DL_4); // Set Datalength to 4 bit for mbed bus interfaces
wim	21:9eb628d9e164	2687	}
wim	21:9eb628d9e164	2688
wim	29:a3663151aa65	2689	/** Destruct a TextLCD interface for using regular mbed pins
wim	29:a3663151aa65	2690	*
wim	29:a3663151aa65	2691	* @param none
wim	29:a3663151aa65	2692	* @return none
wim	29:a3663151aa65	2693	*/
wim	29:a3663151aa65	2694	TextLCD::~TextLCD() {
wim	29:a3663151aa65	2695	if (_bl != NULL) {delete _bl;} // BL pin
wim	29:a3663151aa65	2696	if (_e2 != NULL) {delete _e2;} // E2 pin
wim	29:a3663151aa65	2697	}
wim	29:a3663151aa65	2698
wim	22:35742ec80c24	2699	/** Set E pin (or E2 pin)
wim	22:35742ec80c24	2700	* Used for mbed pins, I2C bus expander or SPI shiftregister
wim	22:35742ec80c24	2701	* Default PinName value for E2 is NC, must be used as pointer to avoid issues with mbed lib and DigitalOut pins
wim	22:35742ec80c24	2702	* @param value true or false
wim	22:35742ec80c24	2703	* @return none
wim	22:35742ec80c24	2704	*/
wim	21:9eb628d9e164	2705	void TextLCD::_setEnable(bool value) {
wim	21:9eb628d9e164	2706
wim	22:35742ec80c24	2707	if(_ctrl_idx==_LCDCtrl_0) {
wim	22:35742ec80c24	2708	if (value) {
wim	22:35742ec80c24	2709	_e = 1; // Set E bit
wim	22:35742ec80c24	2710	}
wim	22:35742ec80c24	2711	else {
wim	22:35742ec80c24	2712	_e = 0; // Reset E bit
wim	22:35742ec80c24	2713	}
wim	22:35742ec80c24	2714	}
wim	22:35742ec80c24	2715	else {
wim	22:35742ec80c24	2716	if (value) {
wim	22:35742ec80c24	2717	if (_e2 != NULL) {_e2->write(1);} //Set E2 bit
wim	22:35742ec80c24	2718	}
wim	22:35742ec80c24	2719	else {
wim	22:35742ec80c24	2720	if (_e2 != NULL) {_e2->write(0);} //Reset E2 bit
wim	22:35742ec80c24	2721	}
wim	22:35742ec80c24	2722	}
wim	21:9eb628d9e164	2723	}
wim	21:9eb628d9e164	2724
wim	21:9eb628d9e164	2725	// Set RS pin
wim	21:9eb628d9e164	2726	// Used for mbed pins, I2C bus expander or SPI shiftregister
wim	21:9eb628d9e164	2727	void TextLCD::_setRS(bool value) {
wim	21:9eb628d9e164	2728
wim	22:35742ec80c24	2729	if (value) {
wim	21:9eb628d9e164	2730	_rs = 1; // Set RS bit
wim	22:35742ec80c24	2731	}
wim	22:35742ec80c24	2732	else {
wim	21:9eb628d9e164	2733	_rs = 0; // Reset RS bit
wim	22:35742ec80c24	2734	}
wim	21:9eb628d9e164	2735	}
wim	21:9eb628d9e164	2736
wim	22:35742ec80c24	2737	/** Set BL pin
wim	22:35742ec80c24	2738	* Used for mbed pins, I2C bus expander or SPI shiftregister
wim	22:35742ec80c24	2739	* Default PinName value is NC, must be used as pointer to avoid issues with mbed lib and DigitalOut pins
wim	22:35742ec80c24	2740	* @param value true or false
wim	22:35742ec80c24	2741	* @return none
wim	22:35742ec80c24	2742	*/
wim	21:9eb628d9e164	2743	void TextLCD::_setBL(bool value) {
wim	21:9eb628d9e164	2744
wim	22:35742ec80c24	2745	if (value) {
wim	22:35742ec80c24	2746	if (_bl != NULL) {_bl->write(1);} //Set BL bit
wim	22:35742ec80c24	2747	}
wim	22:35742ec80c24	2748	else {
wim	22:35742ec80c24	2749	if (_bl != NULL) {_bl->write(0);} //Reset BL bit
wim	22:35742ec80c24	2750	}
wim	21:9eb628d9e164	2751	}
wim	21:9eb628d9e164	2752
wim	21:9eb628d9e164	2753	// Place the 4bit data on the databus
wim	21:9eb628d9e164	2754	// Used for mbed pins, I2C bus expander or SPI shifregister
wim	21:9eb628d9e164	2755	void TextLCD::_setData(int value) {
wim	21:9eb628d9e164	2756	_d = value & 0x0F; // Write Databits
wim	21:9eb628d9e164	2757	}
wim	34:e5a0dcb43ecc	2758
wim	23:d47f226efb24	2759	//----------- End TextLCD ---------------
wim	21:9eb628d9e164	2760
wim	21:9eb628d9e164	2761
wim	23:d47f226efb24	2762	//--------- Start TextLCD_I2C -----------
wim	34:e5a0dcb43ecc	2763	#if(LCD_I2C == 1) /* I2C Expander PCF8574/MCP23008 */
wim	26:bd897a001012	2764	/** Create a TextLCD interface using an I2C PC8574 (or PCF8574A) or MCP23008 portexpander
wim	22:35742ec80c24	2765	*
wim	22:35742ec80c24	2766	* @param i2c I2C Bus
wim	26:bd897a001012	2767	* @param deviceAddress I2C slave address (PCF8574, PCF8574A or MCP23008, default = 0x40)
wim	22:35742ec80c24	2768	* @param type Sets the panel size/addressing mode (default = LCD16x2)
wim	22:35742ec80c24	2769	* @param ctrl LCD controller (default = HD44780)
wim	22:35742ec80c24	2770	*/
wim	21:9eb628d9e164	2771	TextLCD_I2C::TextLCD_I2C(I2C *i2c, char deviceAddress, LCDType type, LCDCtrl ctrl) :
wim	21:9eb628d9e164	2772	TextLCD_Base(type, ctrl),
wim	21:9eb628d9e164	2773	_i2c(i2c){
wim	21:9eb628d9e164	2774
wim	22:35742ec80c24	2775	_slaveAddress = deviceAddress & 0xFE;
wim	28:30fa94f7341c	2776
wim	28:30fa94f7341c	2777	// Setup the I2C bus
wim	28:30fa94f7341c	2778	// The max bitrate for PCF8574 is 100kbit, the max bitrate for MCP23008 is 400kbit,
wim	32:59c4b8f648d4	2779	_i2c->frequency(100000);
wim	21:9eb628d9e164	2780
wim	26:bd897a001012	2781	#if (MCP23008==1)
wim	26:bd897a001012	2782	// MCP23008 portexpander Init
wim	37:ce348c002929	2783	_writeRegister(IODIR, 0x00); // All pins are outputs
wim	37:ce348c002929	2784	_writeRegister(IPOL, 0x00); // No reverse polarity on inputs
wim	37:ce348c002929	2785	_writeRegister(GPINTEN, 0x00); // No interrupt on change of input pins
wim	37:ce348c002929	2786	_writeRegister(DEFVAL, 0x00); // Default value to compare against for interrupts
wim	37:ce348c002929	2787	_writeRegister(INTCON, 0x00); // No interrupt on changes, compare against previous pin value
wim	37:ce348c002929	2788	_writeRegister(IOCON, 0x20); // b1=0 - Interrupt polarity active low
wim	37:ce348c002929	2789	// b2=0 - Interrupt pin active driver output
wim	37:ce348c002929	2790	// b4=0 - Slew rate enable on SDA
wim	37:ce348c002929	2791	// b5=0 - Auto-increment on registeraddress
wim	37:ce348c002929	2792	// b5=1 - No auto-increment on registeraddress => needed for performance improved I2C expander mode
wim	37:ce348c002929	2793	_writeRegister(GPPU, 0x00); // No Pullup
wim	37:ce348c002929	2794	// INTF // Interrupt flags read (Read-Only)
wim	37:ce348c002929	2795	// INTCAP // Captured inputpins at time of interrupt (Read-Only)
wim	37:ce348c002929	2796	// _writeRegister(GPIO, 0x00); // Output/Input pins
wim	37:ce348c002929	2797	// _writeRegister(OLAT, 0x00); // Output Latch
wim	26:bd897a001012	2798
wim	21:9eb628d9e164	2799	// Init the portexpander bus
wim	38:cbe275b0b647	2800	_lcd_bus = LCD_BUS_I2C_DEF;
wim	21:9eb628d9e164	2801
wim	21:9eb628d9e164	2802	// write the new data to the portexpander
wim	37:ce348c002929	2803	_writeRegister(GPIO, _lcd_bus);
wim	26:bd897a001012	2804	#else
wim	26:bd897a001012	2805	// PCF8574 of PCF8574A portexpander
wim	26:bd897a001012	2806
wim	26:bd897a001012	2807	// Init the portexpander bus
wim	38:cbe275b0b647	2808	_lcd_bus = LCD_BUS_I2C_DEF;
wim	26:bd897a001012	2809
wim	26:bd897a001012	2810	// write the new data to the portexpander
wim	21:9eb628d9e164	2811	_i2c->write(_slaveAddress, &_lcd_bus, 1);
wim	26:bd897a001012	2812	#endif
wim	21:9eb628d9e164	2813
wim	37:ce348c002929	2814	_init(_LCD_DL_4); // Set Datalength to 4 bit for all serial expander interfaces
wim	21:9eb628d9e164	2815	}
wim	21:9eb628d9e164	2816
wim	37:ce348c002929	2817	// Set E bit (or E2 bit) in the databus shadowvalue
wim	37:ce348c002929	2818	// Used for mbed I2C bus expander
wim	37:ce348c002929	2819	void TextLCD_I2C::_setEnableBit(bool value) {
wim	21:9eb628d9e164	2820
wim	22:35742ec80c24	2821	if(_ctrl_idx==_LCDCtrl_0) {
wim	26:bd897a001012	2822	if (value) {
wim	38:cbe275b0b647	2823	_lcd_bus \|= LCD_BUS_I2C_E; // Set E bit
wim	26:bd897a001012	2824	}
wim	26:bd897a001012	2825	else {
wim	38:cbe275b0b647	2826	_lcd_bus &= ~LCD_BUS_I2C_E; // Reset E bit
wim	26:bd897a001012	2827	}
wim	22:35742ec80c24	2828	}
wim	22:35742ec80c24	2829	else {
wim	26:bd897a001012	2830	if (value) {
wim	38:cbe275b0b647	2831	_lcd_bus \|= LCD_BUS_I2C_E2; // Set E2 bit
wim	26:bd897a001012	2832	}
wim	26:bd897a001012	2833	else {
wim	38:cbe275b0b647	2834	_lcd_bus &= ~LCD_BUS_I2C_E2; // Reset E2bit
wim	26:bd897a001012	2835	}
wim	26:bd897a001012	2836	}
wim	37:ce348c002929	2837	}
wim	37:ce348c002929	2838
wim	37:ce348c002929	2839	// Set E pin (or E2 pin)
wim	37:ce348c002929	2840	// Used for mbed pins, I2C bus expander or SPI shiftregister
wim	37:ce348c002929	2841	void TextLCD_I2C::_setEnable(bool value) {
wim	37:ce348c002929	2842
wim	37:ce348c002929	2843	// Place the E or E2 bit data on the databus shadowvalue
wim	37:ce348c002929	2844	_setEnableBit(value);
wim	26:bd897a001012	2845
wim	26:bd897a001012	2846	#if (MCP23008==1)
wim	26:bd897a001012	2847	// MCP23008 portexpander
wim	26:bd897a001012	2848
wim	26:bd897a001012	2849	// write the new data to the portexpander
wim	37:ce348c002929	2850	_writeRegister(GPIO, _lcd_bus);
wim	26:bd897a001012	2851	#else
wim	26:bd897a001012	2852	// PCF8574 of PCF8574A portexpander
wim	21:9eb628d9e164	2853
wim	22:35742ec80c24	2854	// write the new data to the I2C portexpander
wim	22:35742ec80c24	2855	_i2c->write(_slaveAddress, &_lcd_bus, 1);
wim	26:bd897a001012	2856	#endif
wim	21:9eb628d9e164	2857	}
wim	21:9eb628d9e164	2858
wim	37:ce348c002929	2859
wim	21:9eb628d9e164	2860	// Set RS pin
wim	21:9eb628d9e164	2861	// Used for mbed pins, I2C bus expander or SPI shiftregister
wim	21:9eb628d9e164	2862	void TextLCD_I2C::_setRS(bool value) {
wim	21:9eb628d9e164	2863
wim	26:bd897a001012	2864	if (value) {
wim	38:cbe275b0b647	2865	_lcd_bus \|= LCD_BUS_I2C_RS; // Set RS bit
wim	26:bd897a001012	2866	}
wim	26:bd897a001012	2867	else {
wim	38:cbe275b0b647	2868	_lcd_bus &= ~LCD_BUS_I2C_RS; // Reset RS bit
wim	26:bd897a001012	2869	}
wim	26:bd897a001012	2870
wim	26:bd897a001012	2871	#if (MCP23008==1)
wim	26:bd897a001012	2872	// MCP23008 portexpander
wim	26:bd897a001012	2873
wim	26:bd897a001012	2874	// write the new data to the portexpander
wim	37:ce348c002929	2875	_writeRegister(GPIO, _lcd_bus);
wim	26:bd897a001012	2876	#else
wim	26:bd897a001012	2877	// PCF8574 of PCF8574A portexpander
wim	21:9eb628d9e164	2878
wim	22:35742ec80c24	2879	// write the new data to the I2C portexpander
wim	22:35742ec80c24	2880	_i2c->write(_slaveAddress, &_lcd_bus, 1);
wim	30:033048611c01	2881	#endif
wim	21:9eb628d9e164	2882	}
wim	21:9eb628d9e164	2883
wim	21:9eb628d9e164	2884	// Set BL pin
wim	21:9eb628d9e164	2885	// Used for mbed pins, I2C bus expander or SPI shiftregister
wim	21:9eb628d9e164	2886	void TextLCD_I2C::_setBL(bool value) {
wim	21:9eb628d9e164	2887
wim	26:bd897a001012	2888	if (value) {
wim	38:cbe275b0b647	2889	_lcd_bus \|= LCD_BUS_I2C_BL; // Set BL bit
wim	26:bd897a001012	2890	}
wim	26:bd897a001012	2891	else {
wim	38:cbe275b0b647	2892	_lcd_bus &= ~LCD_BUS_I2C_BL; // Reset BL bit
wim	26:bd897a001012	2893	}
wim	26:bd897a001012	2894
wim	26:bd897a001012	2895	#if (MCP23008==1)
wim	26:bd897a001012	2896	// MCP23008 portexpander
wim	26:bd897a001012	2897
wim	26:bd897a001012	2898	// write the new data to the portexpander
wim	37:ce348c002929	2899	_writeRegister(GPIO, _lcd_bus);
wim	37:ce348c002929	2900	#else
wim	37:ce348c002929	2901	// PCF8574 of PCF8574A portexpander
wim	37:ce348c002929	2902
wim	37:ce348c002929	2903	// write the new data to the I2C portexpander
wim	37:ce348c002929	2904	_i2c->write(_slaveAddress, &_lcd_bus, 1);
wim	37:ce348c002929	2905	#endif
wim	37:ce348c002929	2906	}
wim	37:ce348c002929	2907
wim	38:cbe275b0b647	2908	#if(0)
wim	38:cbe275b0b647	2909	// New optimized v018
wim	38:cbe275b0b647	2910	// Test faster _writeByte 0.11s vs 0.27s for a 20x4 fillscreen (PCF8574), same as v018
wim	38:cbe275b0b647	2911	// Place the 4bit data in the databus shadowvalue
wim	38:cbe275b0b647	2912	// Used for mbed I2C bus expander
wim	38:cbe275b0b647	2913	const char _LCD_DATA_BITS[16] = {
wim	38:cbe275b0b647	2914	0x00,
wim	38:cbe275b0b647	2915	( LCD_BUS_I2C_D4),
wim	38:cbe275b0b647	2916	( LCD_BUS_I2C_D5 ),
wim	38:cbe275b0b647	2917	( LCD_BUS_I2C_D5 \| LCD_BUS_I2C_D4),
wim	38:cbe275b0b647	2918	( LCD_BUS_I2C_D6 ),
wim	38:cbe275b0b647	2919	( LCD_BUS_I2C_D6 \| LCD_BUS_I2C_D4),
wim	38:cbe275b0b647	2920	( LCD_BUS_I2C_D6 \| LCD_BUS_I2C_D5 ),
wim	38:cbe275b0b647	2921	( LCD_BUS_I2C_D6 \| LCD_BUS_I2C_D5 \| LCD_BUS_I2C_D4),
wim	38:cbe275b0b647	2922	(LCD_BUS_I2C_D7 ),
wim	38:cbe275b0b647	2923	(LCD_BUS_I2C_D7 \| LCD_BUS_I2C_D4),
wim	38:cbe275b0b647	2924	(LCD_BUS_I2C_D7 \| LCD_BUS_I2C_D5 ),
wim	38:cbe275b0b647	2925	(LCD_BUS_I2C_D7 \| LCD_BUS_I2C_D5 \| LCD_BUS_I2C_D4),
wim	38:cbe275b0b647	2926	(LCD_BUS_I2C_D7 \| LCD_BUS_I2C_D6 ),
wim	38:cbe275b0b647	2927	(LCD_BUS_I2C_D7 \| LCD_BUS_I2C_D6 \| LCD_BUS_I2C_D4),
wim	38:cbe275b0b647	2928	(LCD_BUS_I2C_D7 \| LCD_BUS_I2C_D6 \| LCD_BUS_I2C_D5 ),
wim	38:cbe275b0b647	2929	(LCD_BUS_I2C_D7 \| LCD_BUS_I2C_D6 \| LCD_BUS_I2C_D5 \| LCD_BUS_I2C_D4)
wim	38:cbe275b0b647	2930	};
wim	38:cbe275b0b647	2931	void TextLCD_I2C::_setDataBits(int value) {
wim	38:cbe275b0b647	2932
wim	38:cbe275b0b647	2933	//Clear all databits
wim	38:cbe275b0b647	2934	_lcd_bus &= ~LCD_BUS_I2C_MSK;
wim	38:cbe275b0b647	2935
wim	38:cbe275b0b647	2936	// Set bit by bit to support any mapping of expander portpins to LCD pins
wim	38:cbe275b0b647	2937	_lcd_bus \|= _LCD_DATA_BITS[value & 0x0F];
wim	38:cbe275b0b647	2938	}
wim	38:cbe275b0b647	2939
wim	38:cbe275b0b647	2940	#else
wim	38:cbe275b0b647	2941	//orig v017
wim	38:cbe275b0b647	2942	// Test faster _writeByte 0.11s vs 0.27s for a 20x4 fillscreen (PCF8574)
wim	37:ce348c002929	2943	// Place the 4bit data in the databus shadowvalue
wim	37:ce348c002929	2944	// Used for mbed I2C bus expander
wim	37:ce348c002929	2945	void TextLCD_I2C::_setDataBits(int value) {
wim	37:ce348c002929	2946
wim	37:ce348c002929	2947	// Set bit by bit to support any mapping of expander portpins to LCD pins
wim	37:ce348c002929	2948	if (value & 0x01){
wim	38:cbe275b0b647	2949	_lcd_bus \|= LCD_BUS_I2C_D4; // Set Databit
wim	37:ce348c002929	2950	}
wim	37:ce348c002929	2951	else {
wim	38:cbe275b0b647	2952	_lcd_bus &= ~LCD_BUS_I2C_D4; // Reset Databit
wim	37:ce348c002929	2953	}
wim	37:ce348c002929	2954
wim	37:ce348c002929	2955	if (value & 0x02){
wim	38:cbe275b0b647	2956	_lcd_bus \|= LCD_BUS_I2C_D5; // Set Databit
wim	37:ce348c002929	2957	}
wim	37:ce348c002929	2958	else {
wim	38:cbe275b0b647	2959	_lcd_bus &= ~LCD_BUS_I2C_D5; // Reset Databit
wim	37:ce348c002929	2960	}
wim	37:ce348c002929	2961
wim	37:ce348c002929	2962	if (value & 0x04) {
wim	38:cbe275b0b647	2963	_lcd_bus \|= LCD_BUS_I2C_D6; // Set Databit
wim	37:ce348c002929	2964	}
wim	37:ce348c002929	2965	else {
wim	38:cbe275b0b647	2966	_lcd_bus &= ~LCD_BUS_I2C_D6; // Reset Databit
wim	37:ce348c002929	2967	}
wim	37:ce348c002929	2968
wim	37:ce348c002929	2969	if (value & 0x08) {
wim	38:cbe275b0b647	2970	_lcd_bus \|= LCD_BUS_I2C_D7; // Set Databit
wim	37:ce348c002929	2971	}
wim	37:ce348c002929	2972	else {
wim	38:cbe275b0b647	2973	_lcd_bus &= ~LCD_BUS_I2C_D7; // Reset Databit
wim	37:ce348c002929	2974	}
wim	37:ce348c002929	2975	}
wim	38:cbe275b0b647	2976	#endif
wim	38:cbe275b0b647	2977
wim	37:ce348c002929	2978
wim	37:ce348c002929	2979	// Place the 4bit data on the databus
wim	37:ce348c002929	2980	// Used for mbed pins, I2C bus expander or SPI shifregister
wim	37:ce348c002929	2981	void TextLCD_I2C::_setData(int value) {
wim	37:ce348c002929	2982
wim	37:ce348c002929	2983	// Place the 4bit data on the databus shadowvalue
wim	37:ce348c002929	2984	_setDataBits(value);
wim	37:ce348c002929	2985
wim	37:ce348c002929	2986	// Place the 4bit data on the databus
wim	37:ce348c002929	2987	#if (MCP23008==1)
wim	37:ce348c002929	2988	// MCP23008 portexpander
wim	37:ce348c002929	2989
wim	37:ce348c002929	2990	// write the new data to the portexpander
wim	37:ce348c002929	2991	_writeRegister(GPIO, _lcd_bus);
wim	26:bd897a001012	2992	#else
wim	26:bd897a001012	2993	// PCF8574 of PCF8574A portexpander
wim	21:9eb628d9e164	2994
wim	21:9eb628d9e164	2995	// write the new data to the I2C portexpander
wim	21:9eb628d9e164	2996	_i2c->write(_slaveAddress, &_lcd_bus, 1);
wim	30:033048611c01	2997	#endif
wim	21:9eb628d9e164	2998	}
wim	21:9eb628d9e164	2999
wim	37:ce348c002929	3000	// Write data to MCP23008 I2C portexpander
wim	37:ce348c002929	3001	// Used for mbed I2C bus expander
wim	37:ce348c002929	3002	void TextLCD_I2C::_writeRegister (int reg, int value) {
wim	37:ce348c002929	3003	char data[] = {reg, value};
wim	37:ce348c002929	3004
wim	37:ce348c002929	3005	_i2c->write(_slaveAddress, data, 2);
wim	37:ce348c002929	3006	}
wim	37:ce348c002929	3007
wim	37:ce348c002929	3008	//New optimized
wim	37:ce348c002929	3009	//Test faster _writeByte 0.11s vs 0.27s for a 20x4 fillscreen (PCF8574)
wim	37:ce348c002929	3010	//Test faster _writeByte 0.14s vs 0.34s for a 20x4 fillscreen (MCP23008)
wim	37:ce348c002929	3011
wim	37:ce348c002929	3012	// Write a byte using I2C
wim	37:ce348c002929	3013	void TextLCD_I2C::_writeByte(int value) {
wim	37:ce348c002929	3014	char data[6];
wim	37:ce348c002929	3015
wim	37:ce348c002929	3016	#if (MCP23008==1)
wim	37:ce348c002929	3017	// MCP23008 portexpander
wim	37:ce348c002929	3018
wim	37:ce348c002929	3019	data[0] = GPIO; // set registeraddres
wim	37:ce348c002929	3020	// Note: auto-increment is disabled so all data will go to GPIO register
wim	37:ce348c002929	3021
wim	37:ce348c002929	3022	_setEnableBit(true); // set E
wim	37:ce348c002929	3023	_setDataBits(value >> 4); // set data high
wim	37:ce348c002929	3024	data[1] = _lcd_bus;
wim	37:ce348c002929	3025
wim	37:ce348c002929	3026	_setEnableBit(false); // clear E
wim	37:ce348c002929	3027	data[2] = _lcd_bus;
wim	37:ce348c002929	3028
wim	37:ce348c002929	3029	_setEnableBit(true); // set E
wim	37:ce348c002929	3030	_setDataBits(value); // set data low
wim	37:ce348c002929	3031	data[3] = _lcd_bus;
wim	37:ce348c002929	3032
wim	37:ce348c002929	3033	_setEnableBit(false); // clear E
wim	37:ce348c002929	3034	data[4] = _lcd_bus;
wim	37:ce348c002929	3035
wim	37:ce348c002929	3036	// write the packed data to the I2C portexpander
wim	37:ce348c002929	3037	_i2c->write(_slaveAddress, data, 5);
wim	37:ce348c002929	3038	#else
wim	37:ce348c002929	3039	// PCF8574 of PCF8574A portexpander
wim	37:ce348c002929	3040
wim	37:ce348c002929	3041	_setEnableBit(true); // set E
wim	37:ce348c002929	3042	_setDataBits(value >> 4); // set data high
wim	37:ce348c002929	3043	data[0] = _lcd_bus;
wim	37:ce348c002929	3044
wim	37:ce348c002929	3045	_setEnableBit(false); // clear E
wim	37:ce348c002929	3046	data[1] = _lcd_bus;
wim	37:ce348c002929	3047
wim	37:ce348c002929	3048	_setEnableBit(true); // set E
wim	37:ce348c002929	3049	_setDataBits(value); // set data low
wim	37:ce348c002929	3050	data[2] = _lcd_bus;
wim	37:ce348c002929	3051
wim	37:ce348c002929	3052	_setEnableBit(false); // clear E
wim	37:ce348c002929	3053	data[3] = _lcd_bus;
wim	37:ce348c002929	3054
wim	37:ce348c002929	3055	// write the packed data to the I2C portexpander
wim	37:ce348c002929	3056	_i2c->write(_slaveAddress, data, 4);
wim	37:ce348c002929	3057	#endif
wim	37:ce348c002929	3058	}
wim	37:ce348c002929	3059
wim	37:ce348c002929	3060	#endif /* I2C Expander PCF8574/MCP23008 */
wim	37:ce348c002929	3061	//---------- End TextLCD_I2C ------------
wim	37:ce348c002929	3062
wim	37:ce348c002929	3063
wim	37:ce348c002929	3064	//--------- Start TextLCD_SPI -----------
wim	37:ce348c002929	3065	#if(LCD_SPI == 1) /* SPI Expander SN74595 */
wim	37:ce348c002929	3066
wim	37:ce348c002929	3067	/** Create a TextLCD interface using an SPI 74595 portexpander
wim	37:ce348c002929	3068	*
wim	37:ce348c002929	3069	* @param spi SPI Bus
wim	37:ce348c002929	3070	* @param cs chip select pin (active low)
wim	37:ce348c002929	3071	* @param type Sets the panel size/addressing mode (default = LCD16x2)
wim	37:ce348c002929	3072	* @param ctrl LCD controller (default = HD44780)
wim	37:ce348c002929	3073	*/
wim	37:ce348c002929	3074	TextLCD_SPI::TextLCD_SPI(SPI *spi, PinName cs, LCDType type, LCDCtrl ctrl) :
wim	37:ce348c002929	3075	TextLCD_Base(type, ctrl),
wim	37:ce348c002929	3076	_spi(spi),
wim	38:cbe275b0b647	3077	_cs(cs) {
wim	37:ce348c002929	3078	// Init cs
wim	37:ce348c002929	3079	_cs = 1;
wim	37:ce348c002929	3080
wim	37:ce348c002929	3081	// Setup the spi for 8 bit data, low steady state clock,
wim	37:ce348c002929	3082	// rising edge capture, with a 500KHz or 1MHz clock rate
wim	37:ce348c002929	3083	_spi->format(8,0);
wim	37:ce348c002929	3084	_spi->frequency(500000);
wim	37:ce348c002929	3085	//_spi.frequency(1000000);
wim	37:ce348c002929	3086
wim	38:cbe275b0b647	3087	wait_ms(100); // Wait 100ms to ensure LCD powered up
wim	38:cbe275b0b647	3088
wim	37:ce348c002929	3089	// Init the portexpander bus
wim	38:cbe275b0b647	3090	_lcd_bus = LCD_BUS_SPI_DEF;
wim	37:ce348c002929	3091
wim	37:ce348c002929	3092	// write the new data to the portexpander
wim	37:ce348c002929	3093	_cs = 0;
wim	37:ce348c002929	3094	_spi->write(_lcd_bus);
wim	37:ce348c002929	3095	_cs = 1;
wim	37:ce348c002929	3096
wim	37:ce348c002929	3097	_init(_LCD_DL_4); // Set Datalength to 4 bit for all serial expander interfaces
wim	37:ce348c002929	3098	}
wim	37:ce348c002929	3099
wim	37:ce348c002929	3100	// Set E pin (or E2 pin)
wim	37:ce348c002929	3101	// Used for mbed pins, I2C bus expander or SPI shiftregister
wim	37:ce348c002929	3102	void TextLCD_SPI::_setEnable(bool value) {
wim	37:ce348c002929	3103
wim	37:ce348c002929	3104	if(_ctrl_idx==_LCDCtrl_0) {
wim	37:ce348c002929	3105	if (value) {
wim	38:cbe275b0b647	3106	_lcd_bus \|= LCD_BUS_SPI_E; // Set E bit
wim	37:ce348c002929	3107	}
wim	37:ce348c002929	3108	else {
wim	38:cbe275b0b647	3109	_lcd_bus &= ~LCD_BUS_SPI_E; // Reset E bit
wim	37:ce348c002929	3110	}
wim	37:ce348c002929	3111	}
wim	37:ce348c002929	3112	else {
wim	37:ce348c002929	3113	if (value) {
wim	38:cbe275b0b647	3114	_lcd_bus \|= LCD_BUS_SPI_E2; // Set E2 bit
wim	37:ce348c002929	3115	}
wim	37:ce348c002929	3116	else {
wim	38:cbe275b0b647	3117	_lcd_bus &= ~LCD_BUS_SPI_E2; // Reset E2 bit
wim	37:ce348c002929	3118	}
wim	37:ce348c002929	3119	}
wim	37:ce348c002929	3120
wim	37:ce348c002929	3121	// write the new data to the SPI portexpander
wim	37:ce348c002929	3122	_cs = 0;
wim	37:ce348c002929	3123	_spi->write(_lcd_bus);
wim	37:ce348c002929	3124	_cs = 1;
wim	37:ce348c002929	3125	}
wim	37:ce348c002929	3126
wim	37:ce348c002929	3127	// Set RS pin
wim	37:ce348c002929	3128	// Used for mbed pins, I2C bus expander or SPI shiftregister and SPI_N
wim	37:ce348c002929	3129	void TextLCD_SPI::_setRS(bool value) {
wim	37:ce348c002929	3130
wim	37:ce348c002929	3131	if (value) {
wim	38:cbe275b0b647	3132	_lcd_bus \|= LCD_BUS_SPI_RS; // Set RS bit
wim	37:ce348c002929	3133	}
wim	37:ce348c002929	3134	else {
wim	38:cbe275b0b647	3135	_lcd_bus &= ~LCD_BUS_SPI_RS; // Reset RS bit
wim	37:ce348c002929	3136	}
wim	37:ce348c002929	3137
wim	37:ce348c002929	3138	// write the new data to the SPI portexpander
wim	37:ce348c002929	3139	_cs = 0;
wim	37:ce348c002929	3140	_spi->write(_lcd_bus);
wim	37:ce348c002929	3141	_cs = 1;
wim	37:ce348c002929	3142	}
wim	37:ce348c002929	3143
wim	37:ce348c002929	3144	// Set BL pin
wim	37:ce348c002929	3145	// Used for mbed pins, I2C bus expander or SPI shiftregister
wim	37:ce348c002929	3146	void TextLCD_SPI::_setBL(bool value) {
wim	37:ce348c002929	3147
wim	37:ce348c002929	3148	if (value) {
wim	38:cbe275b0b647	3149	_lcd_bus \|= LCD_BUS_SPI_BL; // Set BL bit
wim	37:ce348c002929	3150	}
wim	37:ce348c002929	3151	else {
wim	38:cbe275b0b647	3152	_lcd_bus &= ~LCD_BUS_SPI_BL; // Reset BL bit
wim	37:ce348c002929	3153	}
wim	37:ce348c002929	3154
wim	37:ce348c002929	3155	// write the new data to the SPI portexpander
wim	37:ce348c002929	3156	_cs = 0;
wim	37:ce348c002929	3157	_spi->write(_lcd_bus);
wim	37:ce348c002929	3158	_cs = 1;
wim	37:ce348c002929	3159	}
wim	21:9eb628d9e164	3160
wim	21:9eb628d9e164	3161	// Place the 4bit data on the databus
wim	37:ce348c002929	3162	// Used for mbed pins, I2C bus expander or SPI shiftregister
wim	37:ce348c002929	3163	void TextLCD_SPI::_setData(int value) {
wim	22:35742ec80c24	3164
wim	22:35742ec80c24	3165	// Set bit by bit to support any mapping of expander portpins to LCD pins
wim	37:ce348c002929	3166	if (value & 0x01) {
wim	38:cbe275b0b647	3167	_lcd_bus \|= LCD_BUS_SPI_D4; // Set Databit
wim	26:bd897a001012	3168	}
wim	37:ce348c002929	3169	else {
wim	38:cbe275b0b647	3170	_lcd_bus &= ~LCD_BUS_SPI_D4; // Reset Databit
wim	37:ce348c002929	3171	}
wim	37:ce348c002929	3172
wim	37:ce348c002929	3173	if (value & 0x02) {
wim	38:cbe275b0b647	3174	_lcd_bus \|= LCD_BUS_SPI_D5; // Set Databit
wim	26:bd897a001012	3175	}
wim	26:bd897a001012	3176	else {
wim	38:cbe275b0b647	3177	_lcd_bus &= ~LCD_BUS_SPI_D5; // Reset Databit
wim	37:ce348c002929	3178	}
wim	37:ce348c002929	3179
wim	37:ce348c002929	3180	if (value & 0x04) {
wim	38:cbe275b0b647	3181	_lcd_bus \|= LCD_BUS_SPI_D6; // Set Databit
wim	26:bd897a001012	3182	}
wim	37:ce348c002929	3183	else {
wim	38:cbe275b0b647	3184	_lcd_bus &= ~LCD_BUS_SPI_D6; // Reset Databit
wim	37:ce348c002929	3185	}
wim	37:ce348c002929	3186
wim	37:ce348c002929	3187	if (value & 0x08) {
wim	38:cbe275b0b647	3188	_lcd_bus \|= LCD_BUS_SPI_D7; // Set Databit
wim	26:bd897a001012	3189	}
wim	26:bd897a001012	3190	else {
wim	38:cbe275b0b647	3191	_lcd_bus &= ~LCD_BUS_SPI_D7; // Reset Databit
wim	26:bd897a001012	3192	}
wim	21:9eb628d9e164	3193
wim	37:ce348c002929	3194	// write the new data to the SPI portexpander
wim	37:ce348c002929	3195	_cs = 0;
wim	37:ce348c002929	3196	_spi->write(_lcd_bus);
wim	37:ce348c002929	3197	_cs = 1;
wim	22:35742ec80c24	3198	}
wim	21:9eb628d9e164	3199
wim	37:ce348c002929	3200	#endif /* SPI Expander SN74595 */
wim	37:ce348c002929	3201	//---------- End TextLCD_SPI ------------
wim	21:9eb628d9e164	3202
wim	21:9eb628d9e164	3203
wim	28:30fa94f7341c	3204	//--------- Start TextLCD_I2C_N ---------
wim	34:e5a0dcb43ecc	3205	#if(LCD_I2C_N == 1) /* Native I2C */
wim	28:30fa94f7341c	3206
wim	28:30fa94f7341c	3207	/** Create a TextLCD interface using a controller with native I2C interface
wim	28:30fa94f7341c	3208	*
wim	28:30fa94f7341c	3209	* @param i2c I2C Bus
wim	28:30fa94f7341c	3210	* @param deviceAddress I2C slave address (default = 0x7C)
wim	28:30fa94f7341c	3211	* @param type Sets the panel size/addressing mode (default = LCD16x2)
wim	28:30fa94f7341c	3212	* @param bl Backlight control line (optional, default = NC)
wim	28:30fa94f7341c	3213	* @param ctrl LCD controller (default = ST7032_3V3)
wim	28:30fa94f7341c	3214	*/
wim	28:30fa94f7341c	3215	TextLCD_I2C_N::TextLCD_I2C_N(I2C *i2c, char deviceAddress, LCDType type, PinName bl, LCDCtrl ctrl) :
wim	28:30fa94f7341c	3216	TextLCD_Base(type, ctrl),
wim	32:59c4b8f648d4	3217
wim	33:900a94bc7585	3218	_i2c(i2c){
wim	30:033048611c01	3219
wim	28:30fa94f7341c	3220	_slaveAddress = deviceAddress & 0xFE;
wim	28:30fa94f7341c	3221
wim	28:30fa94f7341c	3222	// Setup the I2C bus
wim	29:a3663151aa65	3223	// The max bitrate for ST7032i is 400kbit, lets stick to default here
wim	29:a3663151aa65	3224	_i2c->frequency(100000);
wim	32:59c4b8f648d4	3225
wim	30:033048611c01	3226
wim	28:30fa94f7341c	3227	// The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
wim	28:30fa94f7341c	3228	if (bl != NC) {
wim	28:30fa94f7341c	3229	_bl = new DigitalOut(bl); //Construct new pin
wim	28:30fa94f7341c	3230	_bl->write(0); //Deactivate
wim	28:30fa94f7341c	3231	}
wim	28:30fa94f7341c	3232	else {
wim	28:30fa94f7341c	3233	// No Hardware Backlight pin
wim	28:30fa94f7341c	3234	_bl = NULL; //Construct dummy pin
wim	28:30fa94f7341c	3235	}
wim	28:30fa94f7341c	3236
wim	30:033048611c01	3237	//Sanity check
wim	30:033048611c01	3238	if (_ctrl & LCD_C_I2C) {
wim	36:9f5f86dfd44a	3239	_init(_LCD_DL_8); // Set Datalength to 8 bit for all native serial interfaces
wim	30:033048611c01	3240	}
wim	30:033048611c01	3241	else {
wim	30:033048611c01	3242	error("Error: LCD Controller type does not support native I2C interface\n\r");
wim	30:033048611c01	3243	}
wim	28:30fa94f7341c	3244	}
wim	28:30fa94f7341c	3245
wim	28:30fa94f7341c	3246	TextLCD_I2C_N::~TextLCD_I2C_N() {
wim	28:30fa94f7341c	3247	if (_bl != NULL) {delete _bl;} // BL pin
wim	28:30fa94f7341c	3248	}
wim	28:30fa94f7341c	3249
wim	28:30fa94f7341c	3250	// Not used in this mode
wim	28:30fa94f7341c	3251	void TextLCD_I2C_N::_setEnable(bool value) {
wim	28:30fa94f7341c	3252	}
wim	28:30fa94f7341c	3253
wim	28:30fa94f7341c	3254	// Set RS pin
wim	28:30fa94f7341c	3255	// Used for mbed pins, I2C bus expander or SPI shiftregister and native I2C or SPI
wim	28:30fa94f7341c	3256	void TextLCD_I2C_N::_setRS(bool value) {
wim	30:033048611c01	3257	// The controlbyte defines the meaning of the next byte. This next byte can either be data or command.
wim	30:033048611c01	3258	// Start Slaveaddress+RW b7 b6 b5 b4 b3 b2 b1 b0 b7...........b0 Stop
wim	30:033048611c01	3259	// Co RS RW 0 0 0 0 0 command or data
wim	30:033048611c01	3260	//
wim	30:033048611c01	3261	// C0=1 indicates that another controlbyte will follow after the next data or command byte
wim	30:033048611c01	3262	// RS=1 means that next byte is data, RS=0 means that next byte is command
wim	30:033048611c01	3263	// RW=0 means write to controller. RW=1 means that controller will be read from after the next command.
wim	30:033048611c01	3264	// Many native I2C controllers dont support this option and it is not used by this lib.
wim	30:033048611c01	3265	//
wim	30:033048611c01	3266
wim	28:30fa94f7341c	3267	if (value) {
wim	28:30fa94f7341c	3268	_controlbyte = 0x40; // Next byte is data, No more control bytes will follow
wim	28:30fa94f7341c	3269	}
wim	28:30fa94f7341c	3270	else {
wim	28:30fa94f7341c	3271	_controlbyte = 0x00; // Next byte is command, No more control bytes will follow
wim	28:30fa94f7341c	3272	}
wim	28:30fa94f7341c	3273	}
wim	28:30fa94f7341c	3274
wim	28:30fa94f7341c	3275	// Set BL pin
wim	28:30fa94f7341c	3276	void TextLCD_I2C_N::_setBL(bool value) {
wim	28:30fa94f7341c	3277	if (_bl) {
wim	28:30fa94f7341c	3278	_bl->write(value);
wim	28:30fa94f7341c	3279	}
wim	28:30fa94f7341c	3280	}
wim	29:a3663151aa65	3281
wim	29:a3663151aa65	3282	// Not used in this mode
wim	29:a3663151aa65	3283	void TextLCD_I2C_N::_setData(int value) {
wim	29:a3663151aa65	3284	}
wim	29:a3663151aa65	3285
wim	28:30fa94f7341c	3286	// Write a byte using I2C
wim	28:30fa94f7341c	3287	void TextLCD_I2C_N::_writeByte(int value) {
wim	30:033048611c01	3288	// The controlbyte defines the meaning of the next byte. This next byte can either be data or command.
wim	30:033048611c01	3289	// Start Slaveaddress+RW b7 b6 b5 b4 b3 b2 b1 b0 b7...........b0 Stop
wim	30:033048611c01	3290	// Co RS RW 0 0 0 0 0 command or data
wim	30:033048611c01	3291	//
wim	30:033048611c01	3292	// C0=1 indicates that another controlbyte will follow after the next data or command byte
wim	30:033048611c01	3293	// RS=1 means that next byte is data, RS=0 means that next byte is command
wim	30:033048611c01	3294	// RW=0 means write to controller. RW=1 means that controller will be read from after the next command.
wim	30:033048611c01	3295	// Many native I2C controllers dont support this option and it is not used by this lib.
wim	30:033048611c01	3296	//
wim	28:30fa94f7341c	3297	char data[] = {_controlbyte, value};
wim	28:30fa94f7341c	3298
wim	32:59c4b8f648d4	3299	#if(LCD_I2C_ACK==1)
wim	32:59c4b8f648d4	3300	//Controllers that support ACK
wim	30:033048611c01	3301	_i2c->write(_slaveAddress, data, 2);
wim	32:59c4b8f648d4	3302	#else
wim	32:59c4b8f648d4	3303	//Controllers that dont support ACK
wim	37:ce348c002929	3304	//Note: This may be issue with some mbed platforms that dont fully/correctly support I2C byte operations.
wim	32:59c4b8f648d4	3305	_i2c->start();
wim	32:59c4b8f648d4	3306	_i2c->write(_slaveAddress);
wim	32:59c4b8f648d4	3307	_i2c->write(data[0]);
wim	32:59c4b8f648d4	3308	_i2c->write(data[1]);
wim	32:59c4b8f648d4	3309	_i2c->stop();
wim	32:59c4b8f648d4	3310	#endif
wim	28:30fa94f7341c	3311	}
wim	34:e5a0dcb43ecc	3312	#endif /* Native I2C */
wim	28:30fa94f7341c	3313	//-------- End TextLCD_I2C_N ------------
wim	28:30fa94f7341c	3314
wim	28:30fa94f7341c	3315
wim	25:6162b31128c9	3316	//--------- Start TextLCD_SPI_N ---------
wim	34:e5a0dcb43ecc	3317	#if(LCD_SPI_N == 1) /* Native SPI bus */
wim	30:033048611c01	3318	/** Create a TextLCD interface using a controller with a native SPI4 interface
Sissors	24:fb3399713710	3319	*
Sissors	24:fb3399713710	3320	* @param spi SPI Bus
Sissors	24:fb3399713710	3321	* @param cs chip select pin (active low)
wim	25:6162b31128c9	3322	* @param rs Instruction/data control line
Sissors	24:fb3399713710	3323	* @param type Sets the panel size/addressing mode (default = LCD16x2)
wim	25:6162b31128c9	3324	* @param bl Backlight control line (optional, default = NC)
wim	26:bd897a001012	3325	* @param ctrl LCD controller (default = ST7032_3V3)
wim	25:6162b31128c9	3326	*/
wim	25:6162b31128c9	3327	TextLCD_SPI_N::TextLCD_SPI_N(SPI *spi, PinName cs, PinName rs, LCDType type, PinName bl, LCDCtrl ctrl) :
wim	25:6162b31128c9	3328	TextLCD_Base(type, ctrl),
wim	25:6162b31128c9	3329	_spi(spi),
wim	25:6162b31128c9	3330	_cs(cs),
wim	25:6162b31128c9	3331	_rs(rs) {
Sissors	24:fb3399713710	3332
wim	32:59c4b8f648d4	3333	// Init CS
wim	32:59c4b8f648d4	3334	_cs = 1;
wim	32:59c4b8f648d4	3335
wim	36:9f5f86dfd44a	3336	// Setup the spi for 8 bit data, high steady state clock,
wim	36:9f5f86dfd44a	3337	// rising edge capture, with a 500KHz or 1MHz clock rate
wim	36:9f5f86dfd44a	3338	// _spi->format(8,3);
wim	37:ce348c002929	3339	// _spi->frequency(500000);
wim	36:9f5f86dfd44a	3340	// _spi->frequency(1000000);
wim	36:9f5f86dfd44a	3341
Sissors	24:fb3399713710	3342	// Setup the spi for 8 bit data, low steady state clock,
Sissors	24:fb3399713710	3343	// rising edge capture, with a 500KHz or 1MHz clock rate
Sissors	24:fb3399713710	3344	_spi->format(8,0);
wim	36:9f5f86dfd44a	3345	// _spi->frequency(500000);
Sissors	24:fb3399713710	3346	_spi->frequency(1000000);
wim	36:9f5f86dfd44a	3347
Sissors	24:fb3399713710	3348	// The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
Sissors	24:fb3399713710	3349	if (bl != NC) {
Sissors	24:fb3399713710	3350	_bl = new DigitalOut(bl); //Construct new pin
Sissors	24:fb3399713710	3351	_bl->write(0); //Deactivate
Sissors	24:fb3399713710	3352	}
Sissors	24:fb3399713710	3353	else {
Sissors	24:fb3399713710	3354	// No Hardware Backlight pin
Sissors	24:fb3399713710	3355	_bl = NULL; //Construct dummy pin
Sissors	24:fb3399713710	3356	}
wim	30:033048611c01	3357
wim	30:033048611c01	3358	//Sanity check
wim	30:033048611c01	3359	if (_ctrl & LCD_C_SPI4) {
wim	36:9f5f86dfd44a	3360	_init(_LCD_DL_8); // Set Datalength to 8 bit for all native serial interfaces
wim	36:9f5f86dfd44a	3361	// ST7070 must set datalength to 8 bits!
wim	30:033048611c01	3362	}
wim	30:033048611c01	3363	else {
wim	30:033048611c01	3364	error("Error: LCD Controller type does not support native SPI4 interface\n\r");
wim	30:033048611c01	3365	}
Sissors	24:fb3399713710	3366	}
Sissors	24:fb3399713710	3367
wim	25:6162b31128c9	3368	TextLCD_SPI_N::~TextLCD_SPI_N() {
Sissors	24:fb3399713710	3369	if (_bl != NULL) {delete _bl;} // BL pin
Sissors	24:fb3399713710	3370	}
Sissors	24:fb3399713710	3371
Sissors	24:fb3399713710	3372	// Not used in this mode
wim	25:6162b31128c9	3373	void TextLCD_SPI_N::_setEnable(bool value) {
Sissors	24:fb3399713710	3374	}
Sissors	24:fb3399713710	3375
Sissors	24:fb3399713710	3376	// Set RS pin
wim	36:9f5f86dfd44a	3377	// Used for mbed pins, I2C bus expander or SPI shiftregister, SPI_N
wim	25:6162b31128c9	3378	void TextLCD_SPI_N::_setRS(bool value) {
Sissors	24:fb3399713710	3379	_rs = value;
Sissors	24:fb3399713710	3380	}
Sissors	24:fb3399713710	3381
Sissors	24:fb3399713710	3382	// Set BL pin
wim	25:6162b31128c9	3383	void TextLCD_SPI_N::_setBL(bool value) {
wim	26:bd897a001012	3384	if (_bl) {
Sissors	24:fb3399713710	3385	_bl->write(value);
wim	26:bd897a001012	3386	}
Sissors	24:fb3399713710	3387	}
Sissors	24:fb3399713710	3388
wim	29:a3663151aa65	3389	// Not used in this mode
wim	29:a3663151aa65	3390	void TextLCD_SPI_N::_setData(int value) {
wim	29:a3663151aa65	3391	}
wim	29:a3663151aa65	3392
Sissors	24:fb3399713710	3393	// Write a byte using SPI
wim	25:6162b31128c9	3394	void TextLCD_SPI_N::_writeByte(int value) {
Sissors	24:fb3399713710	3395	_cs = 0;
Sissors	24:fb3399713710	3396	wait_us(1);
Sissors	24:fb3399713710	3397	_spi->write(value);
Sissors	24:fb3399713710	3398	wait_us(1);
Sissors	24:fb3399713710	3399	_cs = 1;
Sissors	24:fb3399713710	3400	}
wim	34:e5a0dcb43ecc	3401	#endif /* Native SPI bus */
wim	25:6162b31128c9	3402	//-------- End TextLCD_SPI_N ------------
wim	21:9eb628d9e164	3403
wim	21:9eb628d9e164	3404
wim	36:9f5f86dfd44a	3405	//-------- Start TextLCD_SPI_N_3_8 --------
wim	36:9f5f86dfd44a	3406	#if(LCD_SPI_N_3_8 == 1) /* Native SPI bus */
wim	36:9f5f86dfd44a	3407
wim	36:9f5f86dfd44a	3408	/** Create a TextLCD interface using a controller with a native SPI3 8 bits interface
wim	36:9f5f86dfd44a	3409	* This mode is supported by ST7070. Note that implementation in TexTLCD is not very efficient due to
wim	36:9f5f86dfd44a	3410	* structure of the TextLCD library: each databyte is written separately and requires a separate 'count command' set to 1 byte.
wim	36:9f5f86dfd44a	3411	*
wim	36:9f5f86dfd44a	3412	* @param spi SPI Bus
wim	36:9f5f86dfd44a	3413	* @param cs chip select pin (active low)
wim	36:9f5f86dfd44a	3414	* @param type Sets the panel size/addressing mode (default = LCD16x2)
wim	36:9f5f86dfd44a	3415	* @param bl Backlight control line (optional, default = NC)
wim	36:9f5f86dfd44a	3416	* @param ctrl LCD controller (default = ST7070)
wim	36:9f5f86dfd44a	3417	*/
wim	36:9f5f86dfd44a	3418	TextLCD_SPI_N_3_8::TextLCD_SPI_N_3_8(SPI *spi, PinName cs, LCDType type, PinName bl, LCDCtrl ctrl) :
wim	36:9f5f86dfd44a	3419	TextLCD_Base(type, ctrl),
wim	36:9f5f86dfd44a	3420	_spi(spi),
wim	36:9f5f86dfd44a	3421	_cs(cs) {
wim	36:9f5f86dfd44a	3422
wim	36:9f5f86dfd44a	3423	// Init CS
wim	36:9f5f86dfd44a	3424	_cs = 1;
wim	36:9f5f86dfd44a	3425
wim	36:9f5f86dfd44a	3426	// Setup the spi for 8 bit data, high steady state clock,
wim	36:9f5f86dfd44a	3427	// rising edge capture, with a 500KHz or 1MHz clock rate
wim	36:9f5f86dfd44a	3428	// _spi->format(8,3);
wim	37:ce348c002929	3429	// _spi->frequency(500000);
wim	36:9f5f86dfd44a	3430	// _spi->frequency(1000000);
wim	36:9f5f86dfd44a	3431
wim	36:9f5f86dfd44a	3432	// Setup the spi for 8 bit data, low steady state clock,
wim	36:9f5f86dfd44a	3433	// rising edge capture, with a 500KHz or 1MHz clock rate
wim	36:9f5f86dfd44a	3434	_spi->format(8,0);
wim	36:9f5f86dfd44a	3435	// _spi->frequency(500000);
wim	36:9f5f86dfd44a	3436	_spi->frequency(1000000);
wim	36:9f5f86dfd44a	3437
wim	36:9f5f86dfd44a	3438
wim	36:9f5f86dfd44a	3439	// The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
wim	36:9f5f86dfd44a	3440	if (bl != NC) {
wim	36:9f5f86dfd44a	3441	_bl = new DigitalOut(bl); //Construct new pin
wim	36:9f5f86dfd44a	3442	_bl->write(0); //Deactivate
wim	36:9f5f86dfd44a	3443	}
wim	36:9f5f86dfd44a	3444	else {
wim	36:9f5f86dfd44a	3445	// No Hardware Backlight pin
wim	36:9f5f86dfd44a	3446	_bl = NULL; //Construct dummy pin
wim	36:9f5f86dfd44a	3447	}
wim	36:9f5f86dfd44a	3448
wim	36:9f5f86dfd44a	3449	//Sanity check
wim	36:9f5f86dfd44a	3450	if (_ctrl & LCD_C_SPI3_8) {
wim	36:9f5f86dfd44a	3451	_init(_LCD_DL_8); // Set Datalength to 8 bit for all native serial interfaces
wim	36:9f5f86dfd44a	3452	}
wim	36:9f5f86dfd44a	3453	else {
wim	36:9f5f86dfd44a	3454	error("Error: LCD Controller type does not support native SPI3 8 bits interface\n\r");
wim	36:9f5f86dfd44a	3455	}
wim	36:9f5f86dfd44a	3456	}
wim	36:9f5f86dfd44a	3457
wim	36:9f5f86dfd44a	3458	TextLCD_SPI_N_3_8::~TextLCD_SPI_N_3_8() {
wim	36:9f5f86dfd44a	3459	if (_bl != NULL) {delete _bl;} // BL pin
wim	36:9f5f86dfd44a	3460	}
wim	36:9f5f86dfd44a	3461
wim	36:9f5f86dfd44a	3462	// Not used in this mode
wim	36:9f5f86dfd44a	3463	void TextLCD_SPI_N_3_8::_setEnable(bool value) {
wim	36:9f5f86dfd44a	3464	}
wim	36:9f5f86dfd44a	3465
wim	36:9f5f86dfd44a	3466	// Used for mbed pins, I2C bus expander or SPI shiftregister, SPI_N
wim	36:9f5f86dfd44a	3467	// RS=1 means that next byte is data, RS=0 means that next byte is command
wim	36:9f5f86dfd44a	3468	void TextLCD_SPI_N_3_8::_setRS(bool value) {
wim	36:9f5f86dfd44a	3469
wim	36:9f5f86dfd44a	3470	if (value) {
wim	36:9f5f86dfd44a	3471	_controlbyte = 0x01; // Next byte is data, No more control bytes will follow
wim	36:9f5f86dfd44a	3472	}
wim	36:9f5f86dfd44a	3473	else {
wim	36:9f5f86dfd44a	3474	_controlbyte = 0x00; // Next byte is command, No more control bytes will follow
wim	36:9f5f86dfd44a	3475	}
wim	36:9f5f86dfd44a	3476	}
wim	36:9f5f86dfd44a	3477
wim	36:9f5f86dfd44a	3478	// Set BL pin
wim	36:9f5f86dfd44a	3479	void TextLCD_SPI_N_3_8::_setBL(bool value) {
wim	36:9f5f86dfd44a	3480	if (_bl) {
wim	36:9f5f86dfd44a	3481	_bl->write(value);
wim	36:9f5f86dfd44a	3482	}
wim	36:9f5f86dfd44a	3483	}
wim	36:9f5f86dfd44a	3484
wim	36:9f5f86dfd44a	3485	// Not used in this mode
wim	36:9f5f86dfd44a	3486	void TextLCD_SPI_N_3_8::_setData(int value) {
wim	36:9f5f86dfd44a	3487	}
wim	36:9f5f86dfd44a	3488
wim	36:9f5f86dfd44a	3489	// Write a byte using SPI3 8 bits mode (ST7070)
wim	36:9f5f86dfd44a	3490	void TextLCD_SPI_N_3_8::_writeByte(int value) {
wim	36:9f5f86dfd44a	3491
wim	36:9f5f86dfd44a	3492	if (_controlbyte == 0x00) { // Byte is command
wim	36:9f5f86dfd44a	3493	_cs = 0;
wim	36:9f5f86dfd44a	3494	wait_us(1);
wim	36:9f5f86dfd44a	3495	_spi->write(value);
wim	36:9f5f86dfd44a	3496	wait_us(1);
wim	36:9f5f86dfd44a	3497	_cs = 1;
wim	36:9f5f86dfd44a	3498	}
wim	36:9f5f86dfd44a	3499	else { // Byte is data
wim	36:9f5f86dfd44a	3500	// Select Extended Instr Set
wim	36:9f5f86dfd44a	3501	_cs = 0;
wim	36:9f5f86dfd44a	3502	wait_us(1);
wim	36:9f5f86dfd44a	3503	_spi->write(0x20 \| _function \| 0x04); // Set function, 0 0 1 DL N EXT=1 x x (Select Instr Set = 1));
wim	36:9f5f86dfd44a	3504	wait_us(1);
wim	36:9f5f86dfd44a	3505	_cs = 1;
wim	36:9f5f86dfd44a	3506
wim	36:9f5f86dfd44a	3507	wait_us(40); // Wait until command has finished...
wim	36:9f5f86dfd44a	3508
wim	36:9f5f86dfd44a	3509	// Set Count to 1 databyte
wim	36:9f5f86dfd44a	3510	_cs = 0;
wim	36:9f5f86dfd44a	3511	wait_us(1);
wim	36:9f5f86dfd44a	3512	_spi->write(0x80); // Set display data length, 1 L6 L5 L4 L3 L2 L1 L0 (Instr Set = 1)
wim	36:9f5f86dfd44a	3513	wait_us(1);
wim	36:9f5f86dfd44a	3514	_cs = 1;
wim	36:9f5f86dfd44a	3515
wim	36:9f5f86dfd44a	3516	wait_us(40);
wim	36:9f5f86dfd44a	3517
wim	36:9f5f86dfd44a	3518	// Write 1 databyte
wim	36:9f5f86dfd44a	3519	_cs = 0;
wim	36:9f5f86dfd44a	3520	wait_us(1);
wim	36:9f5f86dfd44a	3521	_spi->write(value); // Write data (Instr Set = 1)
wim	36:9f5f86dfd44a	3522	wait_us(1);
wim	36:9f5f86dfd44a	3523	_cs = 1;
wim	36:9f5f86dfd44a	3524
wim	36:9f5f86dfd44a	3525	wait_us(40);
wim	36:9f5f86dfd44a	3526
wim	36:9f5f86dfd44a	3527	// Select Standard Instr Set
wim	36:9f5f86dfd44a	3528	_cs = 0;
wim	36:9f5f86dfd44a	3529	wait_us(1);
wim	36:9f5f86dfd44a	3530	_spi->write(0x20 \| _function); // Set function, 0 0 1 DL N EXT=0 x x (Select Instr Set = 0));
wim	36:9f5f86dfd44a	3531	wait_us(1);
wim	36:9f5f86dfd44a	3532	_cs = 1;
wim	36:9f5f86dfd44a	3533	}
wim	36:9f5f86dfd44a	3534	}
wim	36:9f5f86dfd44a	3535	#endif /* Native SPI bus */
wim	36:9f5f86dfd44a	3536	//------- End TextLCD_SPI_N_3_8 -----------
wim	36:9f5f86dfd44a	3537
wim	36:9f5f86dfd44a	3538
wim	30:033048611c01	3539	//-------- Start TextLCD_SPI_N_3_9 --------
wim	34:e5a0dcb43ecc	3540	#if(LCD_SPI_N_3_9 == 1) /* Native SPI bus */
wim	34:e5a0dcb43ecc	3541	//Code checked out on logic analyser. Not yet tested on hardware..
wim	30:033048611c01	3542
wim	30:033048611c01	3543	/** Create a TextLCD interface using a controller with a native SPI3 9 bits interface
wim	30:033048611c01	3544	*
wim	30:033048611c01	3545	* @param spi SPI Bus
wim	30:033048611c01	3546	* @param cs chip select pin (active low)
wim	30:033048611c01	3547	* @param type Sets the panel size/addressing mode (default = LCD16x2)
wim	30:033048611c01	3548	* @param bl Backlight control line (optional, default = NC)
wim	30:033048611c01	3549	* @param ctrl LCD controller (default = AIP31068)
wim	30:033048611c01	3550	*/
wim	30:033048611c01	3551	TextLCD_SPI_N_3_9::TextLCD_SPI_N_3_9(SPI *spi, PinName cs, LCDType type, PinName bl, LCDCtrl ctrl) :
wim	30:033048611c01	3552	TextLCD_Base(type, ctrl),
wim	30:033048611c01	3553	_spi(spi),
wim	33:900a94bc7585	3554	_cs(cs) {
wim	32:59c4b8f648d4	3555
wim	32:59c4b8f648d4	3556	// Init CS
wim	32:59c4b8f648d4	3557	_cs = 1;
wim	32:59c4b8f648d4	3558
wim	34:e5a0dcb43ecc	3559	// Setup the spi for 9 bit data, high steady state clock,
wim	30:033048611c01	3560	// rising edge capture, with a 500KHz or 1MHz clock rate
wim	32:59c4b8f648d4	3561	_spi->format(9,3);
wim	30:033048611c01	3562	_spi->frequency(1000000);
wim	30:033048611c01	3563
wim	30:033048611c01	3564	// The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
wim	30:033048611c01	3565	if (bl != NC) {
wim	30:033048611c01	3566	_bl = new DigitalOut(bl); //Construct new pin
wim	30:033048611c01	3567	_bl->write(0); //Deactivate
wim	30:033048611c01	3568	}
wim	30:033048611c01	3569	else {
wim	30:033048611c01	3570	// No Hardware Backlight pin
wim	30:033048611c01	3571	_bl = NULL; //Construct dummy pin
wim	30:033048611c01	3572	}
wim	30:033048611c01	3573
wim	30:033048611c01	3574	//Sanity check
wim	36:9f5f86dfd44a	3575	if (_ctrl & LCD_C_SPI3_9) {
wim	36:9f5f86dfd44a	3576	_init(_LCD_DL_8); // Set Datalength to 8 bit for all native serial interfaces
wim	30:033048611c01	3577	}
wim	30:033048611c01	3578	else {
wim	30:033048611c01	3579	error("Error: LCD Controller type does not support native SPI3 9 bits interface\n\r");
wim	30:033048611c01	3580	}
wim	30:033048611c01	3581	}
wim	30:033048611c01	3582
wim	30:033048611c01	3583	TextLCD_SPI_N_3_9::~TextLCD_SPI_N_3_9() {
wim	30:033048611c01	3584	if (_bl != NULL) {delete _bl;} // BL pin
wim	30:033048611c01	3585	}
wim	30:033048611c01	3586
wim	30:033048611c01	3587	// Not used in this mode
wim	30:033048611c01	3588	void TextLCD_SPI_N_3_9::_setEnable(bool value) {
wim	30:033048611c01	3589	}
wim	30:033048611c01	3590
wim	30:033048611c01	3591	// Set RS pin
wim	30:033048611c01	3592	// Used for mbed pins, I2C bus expander or SPI shiftregister
wim	30:033048611c01	3593	void TextLCD_SPI_N_3_9::_setRS(bool value) {
wim	30:033048611c01	3594	// The controlbits define the meaning of the next byte. This next byte can either be data or command.
wim	30:033048611c01	3595	// b8 b7...........b0
wim	30:033048611c01	3596	// RS command or data
wim	30:033048611c01	3597	//
wim	30:033048611c01	3598	// RS=1 means that next byte is data, RS=0 means that next byte is command
wim	30:033048611c01	3599	//
wim	30:033048611c01	3600
wim	30:033048611c01	3601	if (value) {
wim	30:033048611c01	3602	_controlbyte = 0x01; // Next byte is data
wim	30:033048611c01	3603	}
wim	30:033048611c01	3604	else {
wim	30:033048611c01	3605	_controlbyte = 0x00; // Next byte is command
wim	34:e5a0dcb43ecc	3606	}
wim	30:033048611c01	3607	}
wim	30:033048611c01	3608
wim	30:033048611c01	3609	// Set BL pin
wim	30:033048611c01	3610	void TextLCD_SPI_N_3_9::_setBL(bool value) {
wim	30:033048611c01	3611	if (_bl) {
wim	30:033048611c01	3612	_bl->write(value);
wim	30:033048611c01	3613	}
wim	30:033048611c01	3614	}
wim	30:033048611c01	3615
wim	30:033048611c01	3616	// Not used in this mode
wim	30:033048611c01	3617	void TextLCD_SPI_N_3_9::_setData(int value) {
wim	30:033048611c01	3618	}
wim	30:033048611c01	3619
wim	30:033048611c01	3620	// Write a byte using SPI3 9 bits mode
wim	30:033048611c01	3621	void TextLCD_SPI_N_3_9::_writeByte(int value) {
wim	30:033048611c01	3622	_cs = 0;
wim	30:033048611c01	3623	wait_us(1);
wim	30:033048611c01	3624	_spi->write( (_controlbyte << 8) \| (value & 0xFF));
wim	30:033048611c01	3625	wait_us(1);
wim	30:033048611c01	3626	_cs = 1;
wim	30:033048611c01	3627	}
wim	34:e5a0dcb43ecc	3628	#endif /* Native SPI bus */
wim	30:033048611c01	3629	//------- End TextLCD_SPI_N_3_9 -----------
wim	34:e5a0dcb43ecc	3630
wim	34:e5a0dcb43ecc	3631
wim	30:033048611c01	3632	//------- Start TextLCD_SPI_N_3_10 --------
wim	34:e5a0dcb43ecc	3633	#if(LCD_SPI_N_3_10 == 1) /* Native SPI bus */
wim	30:033048611c01	3634
wim	30:033048611c01	3635	/** Create a TextLCD interface using a controller with a native SPI3 10 bits interface
wim	30:033048611c01	3636	*
wim	30:033048611c01	3637	* @param spi SPI Bus
wim	30:033048611c01	3638	* @param cs chip select pin (active low)
wim	30:033048611c01	3639	* @param type Sets the panel size/addressing mode (default = LCD16x2)
wim	30:033048611c01	3640	* @param bl Backlight control line (optional, default = NC)
wim	30:033048611c01	3641	* @param ctrl LCD controller (default = AIP31068)
wim	30:033048611c01	3642	*/
wim	30:033048611c01	3643	TextLCD_SPI_N_3_10::TextLCD_SPI_N_3_10(SPI *spi, PinName cs, LCDType type, PinName bl, LCDCtrl ctrl) :
wim	30:033048611c01	3644	TextLCD_Base(type, ctrl),
wim	30:033048611c01	3645	_spi(spi),
wim	30:033048611c01	3646	_cs(cs) {
wim	30:033048611c01	3647
wim	32:59c4b8f648d4	3648	// Init CS
wim	32:59c4b8f648d4	3649	_cs = 1;
wim	32:59c4b8f648d4	3650
wim	30:033048611c01	3651	// Setup the spi for 10 bit data, low steady state clock,
wim	30:033048611c01	3652	// rising edge capture, with a 500KHz or 1MHz clock rate
wim	30:033048611c01	3653	_spi->format(10,0);
wim	30:033048611c01	3654	_spi->frequency(1000000);
wim	30:033048611c01	3655
wim	30:033048611c01	3656	// The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
wim	30:033048611c01	3657	if (bl != NC) {
wim	30:033048611c01	3658	_bl = new DigitalOut(bl); //Construct new pin
wim	30:033048611c01	3659	_bl->write(0); //Deactivate
wim	30:033048611c01	3660	}
wim	30:033048611c01	3661	else {
wim	30:033048611c01	3662	// No Hardware Backlight pin
wim	30:033048611c01	3663	_bl = NULL; //Construct dummy pin
wim	30:033048611c01	3664	}
wim	30:033048611c01	3665
wim	30:033048611c01	3666	//Sanity check
wim	30:033048611c01	3667	if (_ctrl & LCD_C_SPI3_10) {
wim	36:9f5f86dfd44a	3668	_init(_LCD_DL_8); // Set Datalength to 8 bit for all native serial interfaces
wim	30:033048611c01	3669	}
wim	30:033048611c01	3670	else {
wim	30:033048611c01	3671	error("Error: LCD Controller type does not support native SPI3 10 bits interface\n\r");
wim	30:033048611c01	3672	}
wim	30:033048611c01	3673	}
wim	30:033048611c01	3674
wim	30:033048611c01	3675	TextLCD_SPI_N_3_10::~TextLCD_SPI_N_3_10() {
wim	30:033048611c01	3676	if (_bl != NULL) {delete _bl;} // BL pin
wim	30:033048611c01	3677	}
wim	30:033048611c01	3678
wim	30:033048611c01	3679	// Not used in this mode
wim	30:033048611c01	3680	void TextLCD_SPI_N_3_10::_setEnable(bool value) {
wim	30:033048611c01	3681	}
wim	30:033048611c01	3682
wim	30:033048611c01	3683	// Set RS pin
wim	30:033048611c01	3684	// Used for mbed pins, I2C bus expander or SPI shiftregister
wim	30:033048611c01	3685	void TextLCD_SPI_N_3_10::_setRS(bool value) {
wim	30:033048611c01	3686	// The controlbits define the meaning of the next byte. This next byte can either be data or command.
wim	30:033048611c01	3687	// b9 b8 b7...........b0
wim	30:033048611c01	3688	// RS RW command or data
wim	30:033048611c01	3689	//
wim	30:033048611c01	3690	// RS=1 means that next byte is data, RS=0 means that next byte is command
wim	30:033048611c01	3691	// RW=0 means that next byte is writen, RW=1 means that next byte is read (not used in this lib)
wim	30:033048611c01	3692	//
wim	30:033048611c01	3693
wim	30:033048611c01	3694	if (value) {
wim	30:033048611c01	3695	_controlbyte = 0x02; // Next byte is data
wim	30:033048611c01	3696	}
wim	30:033048611c01	3697	else {
wim	30:033048611c01	3698	_controlbyte = 0x00; // Next byte is command
wim	34:e5a0dcb43ecc	3699	}
wim	30:033048611c01	3700	}
wim	30:033048611c01	3701
wim	30:033048611c01	3702	// Set BL pin
wim	30:033048611c01	3703	void TextLCD_SPI_N_3_10::_setBL(bool value) {
wim	30:033048611c01	3704	if (_bl) {
wim	30:033048611c01	3705	_bl->write(value);
wim	30:033048611c01	3706	}
wim	30:033048611c01	3707	}
wim	30:033048611c01	3708
wim	30:033048611c01	3709	// Not used in this mode
wim	30:033048611c01	3710	void TextLCD_SPI_N_3_10::_setData(int value) {
wim	30:033048611c01	3711	}
wim	30:033048611c01	3712
wim	30:033048611c01	3713	// Write a byte using SPI3 10 bits mode
wim	30:033048611c01	3714	void TextLCD_SPI_N_3_10::_writeByte(int value) {
wim	30:033048611c01	3715	_cs = 0;
wim	30:033048611c01	3716	wait_us(1);
wim	30:033048611c01	3717	_spi->write( (_controlbyte << 8) \| (value & 0xFF));
wim	30:033048611c01	3718	wait_us(1);
wim	30:033048611c01	3719	_cs = 1;
wim	30:033048611c01	3720	}
wim	34:e5a0dcb43ecc	3721	#endif /* Native SPI bus */
wim	30:033048611c01	3722	//------- End TextLCD_SPI_N_3_10 ----------
wim	34:e5a0dcb43ecc	3723
wim	32:59c4b8f648d4	3724
wim	32:59c4b8f648d4	3725	//------- Start TextLCD_SPI_N_3_16 --------
wim	34:e5a0dcb43ecc	3726	#if(LCD_SPI_N_3_16 == 1) /* Native SPI bus */
wim	32:59c4b8f648d4	3727
wim	32:59c4b8f648d4	3728	/** Create a TextLCD interface using a controller with a native SPI3 16 bits interface
wim	32:59c4b8f648d4	3729	*
wim	32:59c4b8f648d4	3730	* @param spi SPI Bus
wim	32:59c4b8f648d4	3731	* @param cs chip select pin (active low)
wim	32:59c4b8f648d4	3732	* @param type Sets the panel size/addressing mode (default = LCD16x2)
wim	32:59c4b8f648d4	3733	* @param bl Backlight control line (optional, default = NC)
wim	32:59c4b8f648d4	3734	* @param ctrl LCD controller (default = PT6314)
wim	32:59c4b8f648d4	3735	*/
wim	32:59c4b8f648d4	3736	TextLCD_SPI_N_3_16::TextLCD_SPI_N_3_16(SPI *spi, PinName cs, LCDType type, PinName bl, LCDCtrl ctrl) :
wim	32:59c4b8f648d4	3737	TextLCD_Base(type, ctrl),
wim	32:59c4b8f648d4	3738	_spi(spi),
wim	32:59c4b8f648d4	3739	_cs(cs) {
wim	32:59c4b8f648d4	3740
wim	32:59c4b8f648d4	3741	// Init CS
wim	32:59c4b8f648d4	3742	_cs = 1;
wim	32:59c4b8f648d4	3743
wim	32:59c4b8f648d4	3744	// Setup the spi for 8 bit data, low steady state clock,
wim	32:59c4b8f648d4	3745	// rising edge capture, with a 500KHz or 1MHz clock rate
wim	32:59c4b8f648d4	3746	_spi->format(8,0);
wim	32:59c4b8f648d4	3747	_spi->frequency(1000000);
wim	32:59c4b8f648d4	3748
wim	32:59c4b8f648d4	3749	// The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
wim	32:59c4b8f648d4	3750	if (bl != NC) {
wim	32:59c4b8f648d4	3751	_bl = new DigitalOut(bl); //Construct new pin
wim	32:59c4b8f648d4	3752	_bl->write(0); //Deactivate
wim	32:59c4b8f648d4	3753	}
wim	32:59c4b8f648d4	3754	else {
wim	32:59c4b8f648d4	3755	// No Hardware Backlight pin
wim	32:59c4b8f648d4	3756	_bl = NULL; //Construct dummy pin
wim	32:59c4b8f648d4	3757	}
wim	32:59c4b8f648d4	3758
wim	32:59c4b8f648d4	3759	//Sanity check
wim	32:59c4b8f648d4	3760	if (_ctrl & LCD_C_SPI3_16) {
wim	36:9f5f86dfd44a	3761	_init(_LCD_DL_8); // Set Datalength to 8 bit for all native serial interfaces
wim	32:59c4b8f648d4	3762	}
wim	32:59c4b8f648d4	3763	else {
wim	32:59c4b8f648d4	3764	error("Error: LCD Controller type does not support native SPI3 16 bits interface\n\r");
wim	32:59c4b8f648d4	3765	}
wim	32:59c4b8f648d4	3766	}
wim	32:59c4b8f648d4	3767
wim	32:59c4b8f648d4	3768	TextLCD_SPI_N_3_16::~TextLCD_SPI_N_3_16() {
wim	32:59c4b8f648d4	3769	if (_bl != NULL) {delete _bl;} // BL pin
wim	32:59c4b8f648d4	3770	}
wim	32:59c4b8f648d4	3771
wim	32:59c4b8f648d4	3772	// Not used in this mode
wim	32:59c4b8f648d4	3773	void TextLCD_SPI_N_3_16::_setEnable(bool value) {
wim	32:59c4b8f648d4	3774	}
wim	32:59c4b8f648d4	3775
wim	32:59c4b8f648d4	3776	// Set RS pin
wim	32:59c4b8f648d4	3777	// Used for mbed pins, I2C bus expander or SPI shiftregister
wim	32:59c4b8f648d4	3778	void TextLCD_SPI_N_3_16::_setRS(bool value) {
wim	32:59c4b8f648d4	3779	// The 16bit mode is split in 2 bytes. The first byte is for synchronisation and controlbits. The controlbits define the meaning of the next byte.
wim	32:59c4b8f648d4	3780	// The 8 actual bits represent either a data or a command byte.
wim	32:59c4b8f648d4	3781	// b15 b14 b13 b12 b11 b10 b9 b8 - b7 b6 b5 b4 b3 b2 b1 b0
wim	32:59c4b8f648d4	3782	// 1 1 1 1 1 RW RS 0 d7 d6 d5 d4 d3 d2 d1 d0
wim	32:59c4b8f648d4	3783	//
wim	32:59c4b8f648d4	3784	// RS=1 means that next byte is data, RS=0 means that next byte is command
wim	32:59c4b8f648d4	3785	// RW=0 means that next byte is writen, RW=1 means that next byte is read (not used in this lib)
wim	32:59c4b8f648d4	3786	//
wim	32:59c4b8f648d4	3787
wim	32:59c4b8f648d4	3788	if (value) {
wim	32:59c4b8f648d4	3789	_controlbyte = 0xFA; // Next byte is data
wim	32:59c4b8f648d4	3790	}
wim	32:59c4b8f648d4	3791	else {
wim	32:59c4b8f648d4	3792	_controlbyte = 0xF8; // Next byte is command
wim	32:59c4b8f648d4	3793	}
wim	32:59c4b8f648d4	3794	}
wim	32:59c4b8f648d4	3795
wim	32:59c4b8f648d4	3796	// Set BL pin
wim	32:59c4b8f648d4	3797	void TextLCD_SPI_N_3_16::_setBL(bool value) {
wim	32:59c4b8f648d4	3798	if (_bl) {
wim	32:59c4b8f648d4	3799	_bl->write(value);
wim	32:59c4b8f648d4	3800	}
wim	32:59c4b8f648d4	3801	}
wim	32:59c4b8f648d4	3802
wim	32:59c4b8f648d4	3803	// Not used in this mode
wim	32:59c4b8f648d4	3804	void TextLCD_SPI_N_3_16::_setData(int value) {
wim	32:59c4b8f648d4	3805	}
wim	34:e5a0dcb43ecc	3806
wim	32:59c4b8f648d4	3807	// Write a byte using SPI3 16 bits mode
wim	32:59c4b8f648d4	3808	void TextLCD_SPI_N_3_16::_writeByte(int value) {
wim	32:59c4b8f648d4	3809	_cs = 0;
wim	32:59c4b8f648d4	3810	wait_us(1);
wim	32:59c4b8f648d4	3811
wim	32:59c4b8f648d4	3812	_spi->write(_controlbyte);
wim	32:59c4b8f648d4	3813
wim	32:59c4b8f648d4	3814	_spi->write(value);
wim	32:59c4b8f648d4	3815
wim	32:59c4b8f648d4	3816	wait_us(1);
wim	32:59c4b8f648d4	3817	_cs = 1;
wim	32:59c4b8f648d4	3818	}
wim	34:e5a0dcb43ecc	3819	#endif /* Native SPI bus */
wim	32:59c4b8f648d4	3820	//------- End TextLCD_SPI_N_3_16 ----------
wim	34:e5a0dcb43ecc	3821
wim	34:e5a0dcb43ecc	3822
wim	32:59c4b8f648d4	3823	//------- Start TextLCD_SPI_N_3_24 --------
wim	34:e5a0dcb43ecc	3824	#if(LCD_SPI_N_3_24 == 1) /* Native SPI bus */
wim	32:59c4b8f648d4	3825
wim	32:59c4b8f648d4	3826	/** Create a TextLCD interface using a controller with a native SPI3 24 bits interface
wim	32:59c4b8f648d4	3827	*
wim	32:59c4b8f648d4	3828	* @param spi SPI Bus
wim	32:59c4b8f648d4	3829	* @param cs chip select pin (active low)
wim	32:59c4b8f648d4	3830	* @param type Sets the panel size/addressing mode (default = LCD16x2)
wim	32:59c4b8f648d4	3831	* @param bl Backlight control line (optional, default = NC)
wim	32:59c4b8f648d4	3832	* @param ctrl LCD controller (default = SSD1803)
wim	32:59c4b8f648d4	3833	*/
wim	32:59c4b8f648d4	3834	TextLCD_SPI_N_3_24::TextLCD_SPI_N_3_24(SPI *spi, PinName cs, LCDType type, PinName bl, LCDCtrl ctrl) :
wim	32:59c4b8f648d4	3835	TextLCD_Base(type, ctrl),
wim	32:59c4b8f648d4	3836	_spi(spi),
wim	32:59c4b8f648d4	3837	_cs(cs) {
wim	32:59c4b8f648d4	3838
wim	32:59c4b8f648d4	3839	// Init CS
wim	32:59c4b8f648d4	3840	_cs = 1;
wim	32:59c4b8f648d4	3841
wim	34:e5a0dcb43ecc	3842	// Setup the spi for 8 bit data, high steady state clock,
wim	32:59c4b8f648d4	3843	// rising edge capture, with a 500KHz or 1MHz clock rate
wim	34:e5a0dcb43ecc	3844	_spi->format(8,3);
wim	32:59c4b8f648d4	3845	_spi->frequency(1000000);
wim	32:59c4b8f648d4	3846
wim	32:59c4b8f648d4	3847	// The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
wim	32:59c4b8f648d4	3848	if (bl != NC) {
wim	32:59c4b8f648d4	3849	_bl = new DigitalOut(bl); //Construct new pin
wim	32:59c4b8f648d4	3850	_bl->write(0); //Deactivate
wim	32:59c4b8f648d4	3851	}
wim	32:59c4b8f648d4	3852	else {
wim	32:59c4b8f648d4	3853	// No Hardware Backlight pin
wim	32:59c4b8f648d4	3854	_bl = NULL; //Construct dummy pin
wim	32:59c4b8f648d4	3855	}
wim	32:59c4b8f648d4	3856
wim	32:59c4b8f648d4	3857	//Sanity check
wim	32:59c4b8f648d4	3858	if (_ctrl & LCD_C_SPI3_24) {
wim	36:9f5f86dfd44a	3859	_init(_LCD_DL_8); // Set Datalength to 8 bit for all native serial interfaces
wim	32:59c4b8f648d4	3860	}
wim	32:59c4b8f648d4	3861	else {
wim	32:59c4b8f648d4	3862	error("Error: LCD Controller type does not support native SPI3 24 bits interface\n\r");
wim	32:59c4b8f648d4	3863	}
wim	32:59c4b8f648d4	3864	}
wim	32:59c4b8f648d4	3865
wim	32:59c4b8f648d4	3866	TextLCD_SPI_N_3_24::~TextLCD_SPI_N_3_24() {
wim	32:59c4b8f648d4	3867	if (_bl != NULL) {delete _bl;} // BL pin
wim	32:59c4b8f648d4	3868	}
wim	32:59c4b8f648d4	3869
wim	32:59c4b8f648d4	3870	// Not used in this mode
wim	32:59c4b8f648d4	3871	void TextLCD_SPI_N_3_24::_setEnable(bool value) {
wim	32:59c4b8f648d4	3872	}
wim	32:59c4b8f648d4	3873
wim	32:59c4b8f648d4	3874	// Set RS pin
wim	32:59c4b8f648d4	3875	// Used for mbed pins, I2C bus expander or SPI shiftregister
wim	32:59c4b8f648d4	3876	void TextLCD_SPI_N_3_24::_setRS(bool value) {
wim	32:59c4b8f648d4	3877	// The 24bit mode is split in 3 bytes. The first byte is for synchronisation and controlbits. The controlbits define the meaning of the next two bytes.
wim	32:59c4b8f648d4	3878	// Each byte encodes 4 actual bits. The 8 actual bits represent either a data or a command byte.
wim	32:59c4b8f648d4	3879	// b23 b22 b21 b20 b19 b18 b17 b16 - b15 b14 b13 b12 b11 b10 b9 b8 - b7 b6 b5 b4 b3 b2 b1 b0
wim	32:59c4b8f648d4	3880	// 1 1 1 1 1 RW RS 0 d0 d1 d2 d3 0 0 0 0 d4 d5 d6 d7 0 0 0 0
wim	32:59c4b8f648d4	3881	//
wim	32:59c4b8f648d4	3882	// RS=1 means that next byte is data, RS=0 means that next byte is command
wim	32:59c4b8f648d4	3883	// RW=0 means that next byte is writen, RW=1 means that next byte is read (not used in this lib)
wim	32:59c4b8f648d4	3884	//
wim	32:59c4b8f648d4	3885	// Note: SPI3_24 expects LSB first. This is inconsistent with regular SPI convention (and hardware) that sends MSB first.
wim	32:59c4b8f648d4	3886
wim	32:59c4b8f648d4	3887	if (value) {
wim	32:59c4b8f648d4	3888	_controlbyte = 0xFA; // Next byte is data
wim	32:59c4b8f648d4	3889	}
wim	32:59c4b8f648d4	3890	else {
wim	32:59c4b8f648d4	3891	_controlbyte = 0xF8; // Next byte is command
wim	34:e5a0dcb43ecc	3892	}
wim	32:59c4b8f648d4	3893	}
wim	32:59c4b8f648d4	3894
wim	32:59c4b8f648d4	3895	// Set BL pin
wim	32:59c4b8f648d4	3896	void TextLCD_SPI_N_3_24::_setBL(bool value) {
wim	32:59c4b8f648d4	3897	if (_bl) {
wim	32:59c4b8f648d4	3898	_bl->write(value);
wim	32:59c4b8f648d4	3899	}
wim	32:59c4b8f648d4	3900	}
wim	32:59c4b8f648d4	3901
wim	32:59c4b8f648d4	3902	// Not used in this mode
wim	32:59c4b8f648d4	3903	void TextLCD_SPI_N_3_24::_setData(int value) {
wim	32:59c4b8f648d4	3904	}
wim	32:59c4b8f648d4	3905
wim	32:59c4b8f648d4	3906	//Mapping table to flip the bits around cause SPI3_24 expects LSB first.
wim	32:59c4b8f648d4	3907	const uint8_t map3_24[16] = {0x00, 0x80, 0x40, 0xC0, 0x20, 0xA0, 0x60, 0xE0, 0x10, 0x90, 0x50, 0xD0, 0x30, 0xB0, 0x70, 0xF0};
wim	32:59c4b8f648d4	3908
wim	32:59c4b8f648d4	3909	// Write a byte using SPI3 24 bits mode
wim	32:59c4b8f648d4	3910	void TextLCD_SPI_N_3_24::_writeByte(int value) {
wim	32:59c4b8f648d4	3911	_cs = 0;
wim	32:59c4b8f648d4	3912	wait_us(1);
wim	32:59c4b8f648d4	3913	_spi->write(_controlbyte);
wim	32:59c4b8f648d4	3914
wim	32:59c4b8f648d4	3915	//Map and send the LSB nibble
wim	32:59c4b8f648d4	3916	_spi->write( map3_24[value & 0x0F]);
wim	32:59c4b8f648d4	3917
wim	32:59c4b8f648d4	3918	//Map and send the MSB nibble
wim	32:59c4b8f648d4	3919	_spi->write( map3_24[(value >> 4) & 0x0F]);
wim	32:59c4b8f648d4	3920
wim	32:59c4b8f648d4	3921	wait_us(1);
wim	32:59c4b8f648d4	3922	_cs = 1;
wim	32:59c4b8f648d4	3923	}
wim	34:e5a0dcb43ecc	3924	#endif /* Native SPI bus */
wim	32:59c4b8f648d4	3925	//------- End TextLCD_SPI_N_3_24 ----------

Repository toolbox

Export to desktop IDE

Build repository

Repository details

Type:	Program
Created:	24 Mar 2018
Imports:	19
Forks:	0
Commits:	43
Dependents:	0
Dependencies:	0
Followers:	2

TextLCD.cpp@38:cbe275b0b647, 2015-04-18 (annotated)

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning