TextLCD - Wim Huiskamp / TextLCD

Users » tohatsp » Code » TextLCD

Wim Huiskamp / TextLCD

Dependents: Projeto_CCM_Maquinas_MotorPasso Projeto_CCM_Maquinas_MotorDC

TextLCD.cpp@39:e9c2319de9c5, 2015-05-19 (annotated)

Committer:: wim
Date:: Tue May 19 18:13:00 2015 +0000
Revision:: 39:e9c2319de9c5
Parent:: 38:cbe275b0b647
Child:: 40:d3496c3ea301

Working version PCF2119

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

Repository toolbox

Export to desktop IDE

Repository details

Type:	Library
Created:	29 Nov 2018
Imports:	97
Forks:	0
Commits:	43
Dependents:	2
Dependencies:	0
Followers:	3

TextLCD.cpp@39:e9c2319de9c5, 2015-05-19 (annotated)

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning