TextLCD - Fork for Seoul Hackathon

Users » Daniel_Lee » Code » TextLCD

Fork for Seoul Hackathon

TextLCD.cpp@37:ce348c002929, 2015-03-29 (annotated)

Committer:: wim
Date:: Sun Mar 29 13:08:03 2015 +0000
Revision:: 37:ce348c002929
Parent:: 36:9f5f86dfd44a
Child:: 38:cbe275b0b647

Cleaned up low level command and data write operations to improve speed of I2C expander versions (PCF8574 and MCP23008). Added initial support for controllers with alternative fonttables.

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

Repository toolbox

Export to desktop IDE

Repository details

Type:	Library
Created:	24 Dec 2019
Imports:	37
Forks:	0
Commits:	43
Dependents:	2
Dependencies:	0
Followers:	2

The code in this repository is Apache licensed.

TextLCD.cpp@37:ce348c002929, 2015-03-29 (annotated)

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning