fixed compiler warnings

Fork of TextLCD by Wim Huiskamp

Committer:
wim
Date:
Sat Sep 27 12:38:27 2014 +0000
Revision:
34:e5a0dcb43ecc
Parent:
33:900a94bc7585
Child:
35:311be6444a39
Added support for PT6314 (VFD), added setOrient() method for supported devices (eg SSD1803, US2066), added Double Height lines and 16 UDCs for supported devices. Added separate files for UDC defines and feature/footprint configuration.

Who changed what in which revision?

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