Juan Lipari / TextLCD

LCD Text

Fork of TextLCD by Wim Huiskamp

TextLCD.cpp@18:bd65dc10f27f, 2013-03-09 (annotated)

Committer:
wim
Date:
Sat Mar 09 19:39:53 2013 +0000
Revision:
18:bd65dc10f27f
Parent:
17:652ab113bc2e
Child:
19:c747b9e2e7b8
Added some UDCs, Updated documentation.

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
simon 1:ac48b187213c 8 *
simon 1:ac48b187213c 9 * Permission is hereby granted, free of charge, to any person obtaining a copy
simon 1:ac48b187213c 10 * of this software and associated documentation files (the "Software"), to deal
simon 1:ac48b187213c 11 * in the Software without restriction, including without limitation the rights
simon 1:ac48b187213c 12 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
simon 1:ac48b187213c 13 * copies of the Software, and to permit persons to whom the Software is
simon 1:ac48b187213c 14 * furnished to do so, subject to the following conditions:
simon 1:ac48b187213c 15 *
simon 1:ac48b187213c 16 * The above copyright notice and this permission notice shall be included in
simon 1:ac48b187213c 17 * all copies or substantial portions of the Software.
simon 1:ac48b187213c 18 *
simon 1:ac48b187213c 19 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
simon 1:ac48b187213c 20 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
simon 1:ac48b187213c 21 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
simon 1:ac48b187213c 22 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
simon 1:ac48b187213c 23 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
simon 1:ac48b187213c 24 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
simon 1:ac48b187213c 25 * THE SOFTWARE.
simon 1:ac48b187213c 26 */
simon 1:ac48b187213c 27
simon 1:ac48b187213c 28 #include "TextLCD.h"
simon 1:ac48b187213c 29 #include "mbed.h"
simon 1:ac48b187213c 30
wim 15:b70ebfffb258 31
wim 15:b70ebfffb258 32 /* Create a TextLCD interface for using regular mbed pins
wim 15:b70ebfffb258 33 *
wim 15:b70ebfffb258 34 * @param rs Instruction/data control line
wim 15:b70ebfffb258 35 * @param e Enable line (clock)
wim 15:b70ebfffb258 36 * @param d4-d7 Data lines for using as a 4-bit interface
wim 15:b70ebfffb258 37 * @param type Sets the panel size/addressing mode (default = LCD16x2)
wim 15:b70ebfffb258 38 * @param e2 Enable2 line (clock for second controller, LCD40x4 only)
wim 15:b70ebfffb258 39 */
wim 13:24506ba22480 40 TextLCD::TextLCD(PinName rs, PinName e,
wim 13:24506ba22480 41 PinName d4, PinName d5, PinName d6, PinName d7,
wim 15:b70ebfffb258 42 LCDType type, PinName e2) : _rs(rs), _e(e), _e2(e2),
wim 15:b70ebfffb258 43 _d(d4, d5, d6, d7),
wim 15:b70ebfffb258 44 _cs(NC),
wim 15:b70ebfffb258 45 _type(type) {
wim 13:24506ba22480 46
wim 13:24506ba22480 47 _busType = _PinBus;
wim 13:24506ba22480 48
wim 13:24506ba22480 49 _init();
wim 13:24506ba22480 50
wim 13:24506ba22480 51 }
wim 13:24506ba22480 52
wim 15:b70ebfffb258 53 /* Create a TextLCD interface using an I2C PC8574 portexpander
wim 15:b70ebfffb258 54 *
wim 15:b70ebfffb258 55 * @param i2c I2C Bus
wim 15:b70ebfffb258 56 * @param deviceAddress I2C slave address (PCF8574)
wim 15:b70ebfffb258 57 * @param type Sets the panel size/addressing mode (default = LCD16x2)
wim 15:b70ebfffb258 58 */
wim 13:24506ba22480 59 TextLCD::TextLCD(I2C *i2c, char deviceAddress, LCDType type) :
wim 15:b70ebfffb258 60 _rs(NC), _e(NC), _e2(NC),
wim 15:b70ebfffb258 61 _d(NC),
wim 15:b70ebfffb258 62 _i2c(i2c),
wim 15:b70ebfffb258 63 _cs(NC),
simon 1:ac48b187213c 64 _type(type) {
wim 15:b70ebfffb258 65
wim 13:24506ba22480 66 _slaveAddress = deviceAddress;
wim 13:24506ba22480 67 _busType = _I2CBus;
simon 1:ac48b187213c 68
wim 13:24506ba22480 69
wim 13:24506ba22480 70 // Init the portexpander bus
wim 15:b70ebfffb258 71 _lcd_bus = D_LCD_BUS_DEF;
wim 13:24506ba22480 72
wim 13:24506ba22480 73 // write the new data to the portexpander
wim 13:24506ba22480 74 _i2c->write(_slaveAddress, &_lcd_bus, 1);
wim 13:24506ba22480 75
wim 13:24506ba22480 76 _init();
wim 13:24506ba22480 77
wim 13:24506ba22480 78 }
simon 1:ac48b187213c 79
wim 15:b70ebfffb258 80 /* Create a TextLCD interface using an SPI 74595 portexpander
wim 15:b70ebfffb258 81 *
wim 15:b70ebfffb258 82 * @param spi SPI Bus
wim 15:b70ebfffb258 83 * @param cs chip select pin (active low)
wim 15:b70ebfffb258 84 * @param type Sets the panel size/addressing mode (default = LCD16x2)
wim 15:b70ebfffb258 85 */
wim 14:0c32b66b14b8 86 TextLCD::TextLCD(SPI *spi, PinName cs, LCDType type) :
wim 15:b70ebfffb258 87 _rs(NC), _e(NC), _e2(NC),
wim 15:b70ebfffb258 88 _d(NC),
wim 15:b70ebfffb258 89 _spi(spi),
wim 15:b70ebfffb258 90 _cs(cs),
wim 14:0c32b66b14b8 91 _type(type) {
wim 14:0c32b66b14b8 92
wim 14:0c32b66b14b8 93 _busType = _SPIBus;
wim 14:0c32b66b14b8 94
wim 14:0c32b66b14b8 95 // Setup the spi for 8 bit data, low steady state clock,
wim 14:0c32b66b14b8 96 // rising edge capture, with a 500KHz or 1MHz clock rate
wim 14:0c32b66b14b8 97 _spi->format(8,0);
wim 14:0c32b66b14b8 98 _spi->frequency(500000);
wim 14:0c32b66b14b8 99 //_spi.frequency(1000000);
wim 14:0c32b66b14b8 100
wim 14:0c32b66b14b8 101
wim 14:0c32b66b14b8 102 // Init the portexpander bus
wim 15:b70ebfffb258 103 _lcd_bus = D_LCD_BUS_DEF;
wim 14:0c32b66b14b8 104
wim 14:0c32b66b14b8 105 // write the new data to the portexpander
wim 14:0c32b66b14b8 106 _setCS(false);
wim 14:0c32b66b14b8 107 _spi->write(_lcd_bus);
wim 14:0c32b66b14b8 108 _setCS(true);
wim 14:0c32b66b14b8 109
wim 14:0c32b66b14b8 110 _init();
wim 14:0c32b66b14b8 111
wim 14:0c32b66b14b8 112 }
wim 14:0c32b66b14b8 113
wim 14:0c32b66b14b8 114
wim 15:b70ebfffb258 115 /* Init the LCD Controller(s)
wim 13:24506ba22480 116 * Clear display
wim 13:24506ba22480 117 */
wim 13:24506ba22480 118 void TextLCD::_init() {
wim 15:b70ebfffb258 119
wim 15:b70ebfffb258 120 // Select and configure second LCD controller when needed
wim 15:b70ebfffb258 121 if(_type==LCD40x4) {
wim 15:b70ebfffb258 122 _ctrl=TextLCD::_LCDCtrl_1; // Select 2nd controller
wim 15:b70ebfffb258 123
wim 15:b70ebfffb258 124 _initCtrl(); // Init 2nd controller
wim 15:b70ebfffb258 125
wim 15:b70ebfffb258 126 // Secondary LCD controller Clearscreen
wim 15:b70ebfffb258 127 _writeCommand(0x01); // cls, and set cursor to 0
wim 15:b70ebfffb258 128 wait_ms(10); // The CLS command takes 1.64 ms.
wim 15:b70ebfffb258 129 // Since we are not using the Busy flag, Lets be safe and take 10 ms
wim 15:b70ebfffb258 130
wim 15:b70ebfffb258 131 }
wim 15:b70ebfffb258 132
wim 15:b70ebfffb258 133 // Select and configure primary LCD controller
wim 15:b70ebfffb258 134 _ctrl=TextLCD::_LCDCtrl_0; // Select primary controller
wim 13:24506ba22480 135
wim 15:b70ebfffb258 136 _initCtrl(); // Init primary controller
wim 15:b70ebfffb258 137
wim 15:b70ebfffb258 138 // Primary LCD controller Clearscreen
wim 15:b70ebfffb258 139 _writeCommand(0x01); // cls, and set cursor to 0
wim 15:b70ebfffb258 140
wim 15:b70ebfffb258 141 wait_ms(10); // The CLS command takes 1.64 ms.
wim 15:b70ebfffb258 142 // Since we are not using the Busy flag, Lets be safe and take 10 ms
wim 15:b70ebfffb258 143
wim 15:b70ebfffb258 144 }
wim 15:b70ebfffb258 145
wim 15:b70ebfffb258 146 /* Init the LCD controller
wim 15:b70ebfffb258 147 * 4-bit mode, number of lines, fonttype, no cursor etc
wim 15:b70ebfffb258 148 *
wim 15:b70ebfffb258 149 */
wim 15:b70ebfffb258 150 void TextLCD::_initCtrl() {
wim 15:b70ebfffb258 151
wim 13:24506ba22480 152 _setRS(false); // command mode
wim 13:24506ba22480 153
wim 15:b70ebfffb258 154 wait_ms(20); // Wait 20ms to ensure powered up
simon 1:ac48b187213c 155
wim 17:652ab113bc2e 156 #if(1)
wim 17:652ab113bc2e 157 // send "Display Settings" 3 times (Only top nibble of 0x30 as we've got 4-bit bus)
wim 17:652ab113bc2e 158 for (int i=0; i<3; i++) {
wim 17:652ab113bc2e 159 _writeNibble(0x3);
wim 17:652ab113bc2e 160 wait_ms(15); // this command takes 1.64ms, so wait for it
wim 17:652ab113bc2e 161 }
wim 17:652ab113bc2e 162 _writeNibble(0x2); // 4-bit mode
wim 17:652ab113bc2e 163 wait_us(40); // most instructions take 40us
wim 17:652ab113bc2e 164 #else
wim 17:652ab113bc2e 165 //Original code. Does not comply with specification and causes problems
wim 17:652ab113bc2e 166 //unless used right after power-on.
wim 17:652ab113bc2e 167
simon 1:ac48b187213c 168 // send "Display Settings" 3 times (Only top nibble of 0x30 as we've got 4-bit bus)
simon 1:ac48b187213c 169 for (int i=0; i<3; i++) {
wim 13:24506ba22480 170 _writeByte(0x3);
wim 15:b70ebfffb258 171 wait_ms(15); // this command takes 1.64ms, so wait for it
simon 1:ac48b187213c 172 }
wim 13:24506ba22480 173 _writeByte(0x2); // 4-bit mode
wim 14:0c32b66b14b8 174 wait_us(40); // most instructions take 40us
wim 17:652ab113bc2e 175 #endif
wim 18:bd65dc10f27f 176
wim 18:bd65dc10f27f 177 // Display is now in 4-bit mode
wim 18:bd65dc10f27f 178
wim 18:bd65dc10f27f 179 #if(0)
wim 18:bd65dc10f27f 180 // ST7036 controller: Initialise Voltage booster for VLCD. VDD=5V
wim 18:bd65dc10f27f 181 // Note: supports 1,2 or 3 lines
wim 18:bd65dc10f27f 182 _writeByte( 0x29 ); // 4-bit Databus, 2 Lines, Select Instruction table 1
wim 18:bd65dc10f27f 183 wait_us(27); // > 26,3ms
wim 18:bd65dc10f27f 184 _writeByte( 0x14 ); // Bias: 1/5, 2-Lines LCD
wim 18:bd65dc10f27f 185 wait_us(30); // > 26,3ms
wim 18:bd65dc10f27f 186 _writeByte( 0x55 ); // Icon off, Booster on, Set Contrast C5, C4
wim 18:bd65dc10f27f 187 wait_us(30); // > 26,3ms
wim 18:bd65dc10f27f 188 _writeByte( 0x6d ); // Voltagefollower On, Ampl ratio Rab2, Rab1, Rab0
wim 18:bd65dc10f27f 189 wait_ms(200); // > 200ms!
wim 18:bd65dc10f27f 190 _writeByte( 0x78 ); // Set Contrast C3, C2, C1, C0
wim 18:bd65dc10f27f 191 wait_us(30); // > 26,3ms
wim 18:bd65dc10f27f 192 _writeByte( 0x28 ); // Return to Instruction table 0
wim 18:bd65dc10f27f 193 wait_ms(50);
wim 18:bd65dc10f27f 194 #endif
wim 14:0c32b66b14b8 195
wim 18:bd65dc10f27f 196 // Initialise Display configuration
wim 10:dd9b3a696acd 197 switch (_type) {
wim 10:dd9b3a696acd 198 case LCD8x1:
wim 18:bd65dc10f27f 199 case LCD8x2B:
wim 18:bd65dc10f27f 200 //8x1 is a regular 1 line display
wim 18:bd65dc10f27f 201 //8x2B is a special case of 16x1
wim 15:b70ebfffb258 202 _writeCommand(0x20); // Function set 001 DL N F - -
wim 15:b70ebfffb258 203 // DL=0 (4 bits bus)
wim 13:24506ba22480 204 // N=0 (1 line)
wim 13:24506ba22480 205 // F=0 (5x7 dots font)
wim 10:dd9b3a696acd 206 break;
wim 10:dd9b3a696acd 207
wim 10:dd9b3a696acd 208 case LCD24x4:
wim 10:dd9b3a696acd 209 // Special mode for KS0078
wim 15:b70ebfffb258 210 _writeCommand(0x2A); // Function set 001 DL N RE DH REV
wim 15:b70ebfffb258 211 // DL=0 (4 bits bus)
wim 13:24506ba22480 212 // N=1 (Dont care for KS0078)
wim 13:24506ba22480 213 // RE=0 (Extended Regs, special mode for KS0078)
wim 13:24506ba22480 214 // DH=1 (Disp shift, special mode for KS0078)
wim 13:24506ba22480 215 // REV=0 (Reverse, special mode for KS0078)
wim 10:dd9b3a696acd 216
wim 15:b70ebfffb258 217 _writeCommand(0x2E); // Function set 001 DL N RE DH REV
wim 15:b70ebfffb258 218 // DL=0 (4 bits bus)
wim 13:24506ba22480 219 // N=1 (Dont care for KS0078)
wim 13:24506ba22480 220 // RE=1 (Ena Extended Regs, special mode for KS0078)
wim 13:24506ba22480 221 // DH=1 (Disp shift, special mode for KS0078)
wim 13:24506ba22480 222 // REV=0 (Reverse, special mode for KS0078)
wim 10:dd9b3a696acd 223
wim 13:24506ba22480 224 _writeCommand(0x09); // Ext Function set 0000 1 FW BW NW
wim 13:24506ba22480 225 // FW=0 (5-dot font, special mode for KS0078)
wim 13:24506ba22480 226 // BW=0 (Cur BW invert disable, special mode for KS0078)
wim 13:24506ba22480 227 // NW=1 (4 Line, special mode for KS0078)
wim 10:dd9b3a696acd 228
wim 15:b70ebfffb258 229 _writeCommand(0x2A); // Function set 001 DL N RE DH REV
wim 15:b70ebfffb258 230 // DL=0 (4 bits bus)
wim 13:24506ba22480 231 // N=1 (Dont care for KS0078)
wim 13:24506ba22480 232 // RE=0 (Dis. Extended Regs, special mode for KS0078)
wim 13:24506ba22480 233 // DH=1 (Disp shift, special mode for KS0078)
wim 13:24506ba22480 234 // REV=0 (Reverse, special mode for KS0078)
wim 10:dd9b3a696acd 235 break;
wim 10:dd9b3a696acd 236
wim 15:b70ebfffb258 237 // All other LCD types are initialised as 2 Line displays (including LCD40x4)
wim 10:dd9b3a696acd 238 default:
wim 15:b70ebfffb258 239 _writeCommand(0x28); // Function set 001 DL N F - -
wim 15:b70ebfffb258 240 // DL=0 (4 bits bus)
wim 13:24506ba22480 241 // N=1 (2 lines)
wim 15:b70ebfffb258 242 // F=0 (5x7 dots font, only option for 2 line display)
wim 13:24506ba22480 243 // - (Don't care)
wim 10:dd9b3a696acd 244
wim 10:dd9b3a696acd 245 break;
wim 10:dd9b3a696acd 246 }
wim 10:dd9b3a696acd 247
wim 13:24506ba22480 248 _writeCommand(0x06); // Entry Mode 0000 01 CD S
wim 13:24506ba22480 249 // Cursor Direction and Display Shift
wim 13:24506ba22480 250 // CD=1 (Cur incr)
wim 13:24506ba22480 251 // S=0 (No display shift)
wim 10:dd9b3a696acd 252
wim 13:24506ba22480 253 // _writeCommand(0x0C); // Display Ctrl 0000 1 D C B
wim 17:652ab113bc2e 254 // // Display On, Cursor Off, Blink Off
wim 15:b70ebfffb258 255 setCursor(TextLCD::CurOff_BlkOff);
wim 17:652ab113bc2e 256 setMode(TextLCD::DispOn);
simon 1:ac48b187213c 257 }
simon 1:ac48b187213c 258
wim 8:03116f75b66e 259
wim 16:c276b75e6585 260 // Clear the screen, Cursor home.
wim 15:b70ebfffb258 261 void TextLCD::cls() {
wim 15:b70ebfffb258 262
wim 15:b70ebfffb258 263 // Select and configure second LCD controller when needed
wim 15:b70ebfffb258 264 if(_type==LCD40x4) {
wim 15:b70ebfffb258 265 _ctrl=TextLCD::_LCDCtrl_1; // Select 2nd controller
wim 15:b70ebfffb258 266
wim 15:b70ebfffb258 267 // Second LCD controller Cursor always Off
wim 17:652ab113bc2e 268 _setCursorAndDisplayMode(_currentMode, TextLCD::CurOff_BlkOff);
wim 15:b70ebfffb258 269
wim 15:b70ebfffb258 270 // Second LCD controller Clearscreen
wim 15:b70ebfffb258 271 _writeCommand(0x01); // cls, and set cursor to 0
wim 15:b70ebfffb258 272
wim 15:b70ebfffb258 273 wait_ms(10); // The CLS command takes 1.64 ms.
wim 15:b70ebfffb258 274 // Since we are not using the Busy flag, Lets be safe and take 10 ms
wim 15:b70ebfffb258 275
wim 15:b70ebfffb258 276
wim 15:b70ebfffb258 277 _ctrl=TextLCD::_LCDCtrl_0; // Select primary controller
wim 15:b70ebfffb258 278 }
wim 15:b70ebfffb258 279
wim 15:b70ebfffb258 280 // Primary LCD controller Clearscreen
wim 15:b70ebfffb258 281 _writeCommand(0x01); // cls, and set cursor to 0
wim 15:b70ebfffb258 282
wim 15:b70ebfffb258 283 wait_ms(10); // The CLS command takes 1.64 ms.
wim 15:b70ebfffb258 284 // Since we are not using the Busy flag, Lets be safe and take 10 ms
wim 15:b70ebfffb258 285
wim 15:b70ebfffb258 286 // Restore cursormode on primary LCD controller when needed
wim 15:b70ebfffb258 287 if(_type==LCD40x4) {
wim 17:652ab113bc2e 288 _setCursorAndDisplayMode(_currentMode,_currentCursor);
wim 15:b70ebfffb258 289 }
wim 15:b70ebfffb258 290
wim 15:b70ebfffb258 291 _row=0; // Reset Cursor location
wim 15:b70ebfffb258 292 _column=0;
simon 1:ac48b187213c 293 }
simon 1:ac48b187213c 294
wim 16:c276b75e6585 295 // Move cursor to selected row and column
simon 1:ac48b187213c 296 void TextLCD::locate(int column, int row) {
wim 15:b70ebfffb258 297
wim 15:b70ebfffb258 298 // setAddress() does all the heavy lifting:
wim 15:b70ebfffb258 299 // check column and row sanity,
wim 15:b70ebfffb258 300 // switch controllers for LCD40x4 if needed
wim 15:b70ebfffb258 301 // switch cursor for LCD40x4 if needed
wim 15:b70ebfffb258 302 // set the new memory address to show cursor at correct location
wim 15:b70ebfffb258 303 setAddress(column, row);
wim 15:b70ebfffb258 304
wim 15:b70ebfffb258 305 }
wim 15:b70ebfffb258 306
wim 15:b70ebfffb258 307
wim 16:c276b75e6585 308 // Write a single character (Stream implementation)
wim 15:b70ebfffb258 309 int TextLCD::_putc(int value) {
wim 15:b70ebfffb258 310 int addr;
wim 15:b70ebfffb258 311
wim 15:b70ebfffb258 312 if (value == '\n') {
wim 15:b70ebfffb258 313 //No character to write
wim 15:b70ebfffb258 314
wim 15:b70ebfffb258 315 //Update Cursor
wim 15:b70ebfffb258 316 _column = 0;
wim 15:b70ebfffb258 317 _row++;
wim 15:b70ebfffb258 318 if (_row >= rows()) {
wim 15:b70ebfffb258 319 _row = 0;
wim 15:b70ebfffb258 320 }
wim 15:b70ebfffb258 321 }
wim 15:b70ebfffb258 322 else {
wim 15:b70ebfffb258 323 //Character to write
wim 15:b70ebfffb258 324 _writeData(value);
wim 15:b70ebfffb258 325
wim 15:b70ebfffb258 326 //Update Cursor
wim 15:b70ebfffb258 327 _column++;
wim 15:b70ebfffb258 328 if (_column >= columns()) {
wim 15:b70ebfffb258 329 _column = 0;
wim 15:b70ebfffb258 330 _row++;
wim 15:b70ebfffb258 331 if (_row >= rows()) {
wim 15:b70ebfffb258 332 _row = 0;
wim 15:b70ebfffb258 333 }
wim 15:b70ebfffb258 334 }
wim 15:b70ebfffb258 335 } //else
wim 15:b70ebfffb258 336
wim 15:b70ebfffb258 337 //Set next memoryaddress, make sure cursor blinks at next location
wim 15:b70ebfffb258 338 addr = getAddress(_column, _row);
wim 15:b70ebfffb258 339 _writeCommand(0x80 | addr);
wim 15:b70ebfffb258 340
wim 15:b70ebfffb258 341 return value;
wim 15:b70ebfffb258 342 }
wim 15:b70ebfffb258 343
wim 15:b70ebfffb258 344
wim 16:c276b75e6585 345 // get a single character (Stream implementation)
simon 1:ac48b187213c 346 int TextLCD::_getc() {
simon 1:ac48b187213c 347 return -1;
simon 1:ac48b187213c 348 }
simon 1:ac48b187213c 349
wim 16:c276b75e6585 350 // Set E pin (or E2 pin)
wim 16:c276b75e6585 351 // Used for mbed pins, I2C bus expander or SPI shifregister
wim 13:24506ba22480 352 void TextLCD::_setEnable(bool value) {
wim 13:24506ba22480 353
wim 13:24506ba22480 354 switch(_busType) {
wim 13:24506ba22480 355 case _PinBus :
wim 15:b70ebfffb258 356 if(_ctrl==TextLCD::_LCDCtrl_0) {
wim 15:b70ebfffb258 357 if (value)
wim 15:b70ebfffb258 358 _e = 1; // Set E bit
wim 15:b70ebfffb258 359 else
wim 15:b70ebfffb258 360 _e = 0; // Reset E bit
wim 15:b70ebfffb258 361 }
wim 15:b70ebfffb258 362 else {
wim 15:b70ebfffb258 363 if (value)
wim 15:b70ebfffb258 364 _e2 = 1; // Set E2 bit
wim 15:b70ebfffb258 365 else
wim 15:b70ebfffb258 366 _e2 = 0; // Reset E2 bit
wim 15:b70ebfffb258 367 }
wim 15:b70ebfffb258 368
wim 13:24506ba22480 369 break;
wim 13:24506ba22480 370
wim 13:24506ba22480 371 case _I2CBus :
wim 15:b70ebfffb258 372
wim 15:b70ebfffb258 373 if(_ctrl==TextLCD::_LCDCtrl_0) {
wim 15:b70ebfffb258 374 if (value)
wim 15:b70ebfffb258 375 _lcd_bus |= D_LCD_E; // Set E bit
wim 15:b70ebfffb258 376 else
wim 15:b70ebfffb258 377 _lcd_bus &= ~D_LCD_E; // Reset E bit
wim 15:b70ebfffb258 378 }
wim 15:b70ebfffb258 379 else {
wim 15:b70ebfffb258 380 if (value)
wim 15:b70ebfffb258 381 _lcd_bus |= D_LCD_E2; // Set E2 bit
wim 15:b70ebfffb258 382 else
wim 15:b70ebfffb258 383 _lcd_bus &= ~D_LCD_E2; // Reset E2bit
wim 15:b70ebfffb258 384 }
wim 15:b70ebfffb258 385
wim 15:b70ebfffb258 386 // write the new data to the I2C portexpander
wim 14:0c32b66b14b8 387 _i2c->write(_slaveAddress, &_lcd_bus, 1);
wim 15:b70ebfffb258 388
wim 13:24506ba22480 389 break;
wim 13:24506ba22480 390
wim 13:24506ba22480 391 case _SPIBus :
wim 15:b70ebfffb258 392 if(_ctrl==TextLCD::_LCDCtrl_0) {
wim 15:b70ebfffb258 393 if (value)
wim 15:b70ebfffb258 394 _lcd_bus |= D_LCD_E; // Set E bit
wim 15:b70ebfffb258 395 else
wim 15:b70ebfffb258 396 _lcd_bus &= ~D_LCD_E; // Reset E bit
wim 15:b70ebfffb258 397 }
wim 15:b70ebfffb258 398 else {
wim 15:b70ebfffb258 399 if (value)
wim 15:b70ebfffb258 400 _lcd_bus |= D_LCD_E2; // Set E2 bit
wim 15:b70ebfffb258 401 else
wim 15:b70ebfffb258 402 _lcd_bus &= ~D_LCD_E2; // Reset E2 bit
wim 15:b70ebfffb258 403 }
wim 15:b70ebfffb258 404
wim 15:b70ebfffb258 405 // write the new data to the SPI portexpander
wim 14:0c32b66b14b8 406 _setCS(false);
wim 14:0c32b66b14b8 407 _spi->write(_lcd_bus);
wim 14:0c32b66b14b8 408 _setCS(true);
wim 14:0c32b66b14b8 409
wim 13:24506ba22480 410 break;
wim 13:24506ba22480 411 }
wim 13:24506ba22480 412 }
wim 13:24506ba22480 413
wim 16:c276b75e6585 414 // Set RS pin
wim 16:c276b75e6585 415 // Used for mbed pins, I2C bus expander or SPI shifregister
wim 13:24506ba22480 416 void TextLCD::_setRS(bool value) {
wim 13:24506ba22480 417
wim 13:24506ba22480 418 switch(_busType) {
wim 13:24506ba22480 419 case _PinBus :
wim 13:24506ba22480 420 if (value)
wim 13:24506ba22480 421 _rs = 1; // Set RS bit
wim 13:24506ba22480 422 else
wim 13:24506ba22480 423 _rs = 0; // Reset RS bit
wim 13:24506ba22480 424
wim 13:24506ba22480 425 break;
wim 13:24506ba22480 426
wim 13:24506ba22480 427 case _I2CBus :
wim 14:0c32b66b14b8 428 if (value)
wim 14:0c32b66b14b8 429 _lcd_bus |= D_LCD_RS; // Set RS bit
wim 14:0c32b66b14b8 430 else
wim 14:0c32b66b14b8 431 _lcd_bus &= ~D_LCD_RS; // Reset RS bit
wim 13:24506ba22480 432
wim 15:b70ebfffb258 433 // write the new data to the I2C portexpander
wim 14:0c32b66b14b8 434 _i2c->write(_slaveAddress, &_lcd_bus, 1);
wim 13:24506ba22480 435
wim 13:24506ba22480 436 break;
wim 13:24506ba22480 437
wim 13:24506ba22480 438 case _SPIBus :
wim 14:0c32b66b14b8 439 if (value)
wim 14:0c32b66b14b8 440 _lcd_bus |= D_LCD_RS; // Set RS bit
wim 14:0c32b66b14b8 441 else
wim 14:0c32b66b14b8 442 _lcd_bus &= ~D_LCD_RS; // Reset RS bit
wim 14:0c32b66b14b8 443
wim 15:b70ebfffb258 444 // write the new data to the SPI portexpander
wim 14:0c32b66b14b8 445 _setCS(false);
wim 14:0c32b66b14b8 446 _spi->write(_lcd_bus);
wim 14:0c32b66b14b8 447 _setCS(true);
wim 14:0c32b66b14b8 448
wim 13:24506ba22480 449 break;
wim 13:24506ba22480 450 }
wim 13:24506ba22480 451
wim 13:24506ba22480 452 }
wim 13:24506ba22480 453
wim 16:c276b75e6585 454 // Place the 4bit data on the databus
wim 16:c276b75e6585 455 // Used for mbed pins, I2C bus expander or SPI shifregister
wim 13:24506ba22480 456 void TextLCD::_setData(int value) {
wim 13:24506ba22480 457 int data;
wim 13:24506ba22480 458
wim 13:24506ba22480 459 switch(_busType) {
wim 13:24506ba22480 460 case _PinBus :
wim 13:24506ba22480 461 _d = value & 0x0F; // Write Databits
wim 13:24506ba22480 462
wim 13:24506ba22480 463 break;
wim 13:24506ba22480 464
wim 13:24506ba22480 465 case _I2CBus :
wim 13:24506ba22480 466 data = value & 0x0F;
wim 13:24506ba22480 467 if (data & 0x01)
wim 13:24506ba22480 468 _lcd_bus |= D_LCD_D4; // Set Databit
wim 13:24506ba22480 469 else
wim 13:24506ba22480 470 _lcd_bus &= ~D_LCD_D4; // Reset Databit
wim 13:24506ba22480 471
wim 13:24506ba22480 472 if (data & 0x02)
wim 13:24506ba22480 473 _lcd_bus |= D_LCD_D5; // Set Databit
wim 13:24506ba22480 474 else
wim 13:24506ba22480 475 _lcd_bus &= ~D_LCD_D5; // Reset Databit
wim 13:24506ba22480 476
wim 13:24506ba22480 477 if (data & 0x04)
wim 13:24506ba22480 478 _lcd_bus |= D_LCD_D6; // Set Databit
wim 13:24506ba22480 479 else
wim 13:24506ba22480 480 _lcd_bus &= ~D_LCD_D6; // Reset Databit
wim 13:24506ba22480 481
wim 13:24506ba22480 482 if (data & 0x08)
wim 13:24506ba22480 483 _lcd_bus |= D_LCD_D7; // Set Databit
wim 13:24506ba22480 484 else
wim 13:24506ba22480 485 _lcd_bus &= ~D_LCD_D7; // Reset Databit
wim 13:24506ba22480 486
wim 15:b70ebfffb258 487 // write the new data to the I2C portexpander
wim 13:24506ba22480 488 _i2c->write(_slaveAddress, &_lcd_bus, 1);
wim 13:24506ba22480 489
wim 13:24506ba22480 490 break;
wim 13:24506ba22480 491
wim 13:24506ba22480 492 case _SPIBus :
wim 14:0c32b66b14b8 493
wim 14:0c32b66b14b8 494 data = value & 0x0F;
wim 14:0c32b66b14b8 495 if (data & 0x01)
wim 14:0c32b66b14b8 496 _lcd_bus |= D_LCD_D4; // Set Databit
wim 14:0c32b66b14b8 497 else
wim 14:0c32b66b14b8 498 _lcd_bus &= ~D_LCD_D4; // Reset Databit
wim 14:0c32b66b14b8 499
wim 14:0c32b66b14b8 500 if (data & 0x02)
wim 14:0c32b66b14b8 501 _lcd_bus |= D_LCD_D5; // Set Databit
wim 14:0c32b66b14b8 502 else
wim 14:0c32b66b14b8 503 _lcd_bus &= ~D_LCD_D5; // Reset Databit
wim 14:0c32b66b14b8 504
wim 14:0c32b66b14b8 505 if (data & 0x04)
wim 14:0c32b66b14b8 506 _lcd_bus |= D_LCD_D6; // Set Databit
wim 14:0c32b66b14b8 507 else
wim 14:0c32b66b14b8 508 _lcd_bus &= ~D_LCD_D6; // Reset Databit
wim 14:0c32b66b14b8 509
wim 14:0c32b66b14b8 510 if (data & 0x08)
wim 14:0c32b66b14b8 511 _lcd_bus |= D_LCD_D7; // Set Databit
wim 14:0c32b66b14b8 512 else
wim 14:0c32b66b14b8 513 _lcd_bus &= ~D_LCD_D7; // Reset Databit
wim 14:0c32b66b14b8 514
wim 15:b70ebfffb258 515 // write the new data to the SPI portexpander
wim 14:0c32b66b14b8 516 _setCS(false);
wim 14:0c32b66b14b8 517 _spi->write(_lcd_bus);
wim 14:0c32b66b14b8 518 _setCS(true);
wim 14:0c32b66b14b8 519
wim 14:0c32b66b14b8 520 break;
wim 13:24506ba22480 521 }
wim 13:24506ba22480 522
wim 13:24506ba22480 523 }
wim 13:24506ba22480 524
wim 13:24506ba22480 525
wim 16:c276b75e6585 526 // Set CS line.
wim 16:c276b75e6585 527 // Only used for SPI bus
wim 14:0c32b66b14b8 528 void TextLCD::_setCS(bool value) {
wim 14:0c32b66b14b8 529
wim 15:b70ebfffb258 530 if (value) {
wim 14:0c32b66b14b8 531 _cs = 1; // Set CS pin
wim 15:b70ebfffb258 532 }
wim 14:0c32b66b14b8 533 else
wim 14:0c32b66b14b8 534 _cs = 0; // Reset CS pin
wim 15:b70ebfffb258 535
wim 14:0c32b66b14b8 536 }
wim 14:0c32b66b14b8 537
wim 14:0c32b66b14b8 538
wim 17:652ab113bc2e 539 // Write a nibble using the 4-bit interface
wim 17:652ab113bc2e 540 // Used for mbed pins, I2C bus expander or SPI shifregister
wim 17:652ab113bc2e 541 void TextLCD::_writeNibble(int value) {
wim 17:652ab113bc2e 542
wim 17:652ab113bc2e 543 // Enable is Low
wim 17:652ab113bc2e 544 _setEnable(true);
wim 17:652ab113bc2e 545 _setData(value & 0x0F); // Low nibble
wim 17:652ab113bc2e 546 wait_us(1); // Data setup time
wim 17:652ab113bc2e 547 _setEnable(false);
wim 17:652ab113bc2e 548 wait_us(1); // Datahold time
wim 17:652ab113bc2e 549
wim 17:652ab113bc2e 550 // Enable is Low
wim 17:652ab113bc2e 551
wim 17:652ab113bc2e 552 }
wim 17:652ab113bc2e 553
wim 17:652ab113bc2e 554
wim 16:c276b75e6585 555 // Write a byte using the 4-bit interface
wim 16:c276b75e6585 556 // Used for mbed pins, I2C bus expander or SPI shifregister
wim 13:24506ba22480 557 void TextLCD::_writeByte(int value) {
wim 15:b70ebfffb258 558
wim 15:b70ebfffb258 559 // Enable is Low
wim 15:b70ebfffb258 560 _setEnable(true);
wim 16:c276b75e6585 561 _setData(value >> 4); // High nibble
wim 15:b70ebfffb258 562 wait_us(1); // Data setup time
wim 15:b70ebfffb258 563 _setEnable(false);
wim 15:b70ebfffb258 564 wait_us(1); // Data hold time
wim 15:b70ebfffb258 565
wim 13:24506ba22480 566 _setEnable(true);
wim 16:c276b75e6585 567 _setData(value >> 0); // Low nibble
wim 15:b70ebfffb258 568 wait_us(1); // Data setup time
wim 13:24506ba22480 569 _setEnable(false);
wim 15:b70ebfffb258 570 wait_us(1); // Datahold time
wim 15:b70ebfffb258 571
wim 15:b70ebfffb258 572 // Enable is Low
wim 15:b70ebfffb258 573
simon 1:ac48b187213c 574 }
simon 1:ac48b187213c 575
wim 13:24506ba22480 576 void TextLCD::_writeCommand(int command) {
wim 15:b70ebfffb258 577
wim 13:24506ba22480 578 _setRS(false);
wim 16:c276b75e6585 579 wait_us(1); // Data setup time for RS
wim 15:b70ebfffb258 580
wim 15:b70ebfffb258 581 _writeByte(command);
wim 15:b70ebfffb258 582 wait_us(40); // most instructions take 40us
simon 1:ac48b187213c 583 }
simon 1:ac48b187213c 584
wim 13:24506ba22480 585 void TextLCD::_writeData(int data) {
wim 15:b70ebfffb258 586
wim 13:24506ba22480 587 _setRS(true);
wim 16:c276b75e6585 588 wait_us(1); // Data setup time for RS
wim 15:b70ebfffb258 589
wim 13:24506ba22480 590 _writeByte(data);
wim 15:b70ebfffb258 591 wait_us(40); // data writes take 40us
simon 1:ac48b187213c 592 }
simon 1:ac48b187213c 593
wim 8:03116f75b66e 594
wim 8:03116f75b66e 595 #if (0)
wim 16:c276b75e6585 596 // This is the original _address() method.
wim 8:03116f75b66e 597 // It is confusing since it returns the memoryaddress or-ed with the set memorycommand 0x80.
wim 8:03116f75b66e 598 // Left it in here for compatibility with older code. New applications should use getAddress() instead.
wim 8:03116f75b66e 599 //
wim 13:24506ba22480 600 int TextLCD::_address(int column, int row) {
simon 1:ac48b187213c 601 switch (_type) {
simon 1:ac48b187213c 602 case LCD20x4:
simon 1:ac48b187213c 603 switch (row) {
simon 1:ac48b187213c 604 case 0:
simon 1:ac48b187213c 605 return 0x80 + column;
simon 1:ac48b187213c 606 case 1:
simon 1:ac48b187213c 607 return 0xc0 + column;
simon 1:ac48b187213c 608 case 2:
simon 1:ac48b187213c 609 return 0x94 + column;
simon 1:ac48b187213c 610 case 3:
simon 1:ac48b187213c 611 return 0xd4 + column;
simon 1:ac48b187213c 612 }
simon 1:ac48b187213c 613 case LCD16x2B:
simon 4:bf5b706f8d32 614 return 0x80 + (row * 40) + column;
simon 1:ac48b187213c 615 case LCD16x2:
simon 1:ac48b187213c 616 case LCD20x2:
simon 1:ac48b187213c 617 default:
simon 4:bf5b706f8d32 618 return 0x80 + (row * 0x40) + column;
simon 1:ac48b187213c 619 }
simon 1:ac48b187213c 620 }
wim 8:03116f75b66e 621 #endif
wim 8:03116f75b66e 622
wim 8:03116f75b66e 623
wim 16:c276b75e6585 624 // This replaces the original _address() method.
wim 8:03116f75b66e 625 // Left it in here for compatibility with older code. New applications should use getAddress() instead.
wim 13:24506ba22480 626 int TextLCD::_address(int column, int row) {
wim 8:03116f75b66e 627 return 0x80 | getAddress(column, row);
wim 8:03116f75b66e 628 }
wim 8:03116f75b66e 629
wim 8:03116f75b66e 630 // This is new method to return the memory address based on row, column and displaytype.
wim 8:03116f75b66e 631 //
wim 8:03116f75b66e 632 int TextLCD::getAddress(int column, int row) {
wim 8:03116f75b66e 633
wim 8:03116f75b66e 634 switch (_type) {
wim 8:03116f75b66e 635 case LCD8x1:
wim 8:03116f75b66e 636 return 0x00 + column;
wim 18:bd65dc10f27f 637
wim 18:bd65dc10f27f 638 case LCD8x2B:
wim 18:bd65dc10f27f 639 // LCD8x2B is a special layout of LCD16x1
wim 18:bd65dc10f27f 640 if (row==0)
wim 18:bd65dc10f27f 641 return 0x00 + column;
wim 18:bd65dc10f27f 642 else
wim 18:bd65dc10f27f 643 return 0x08 + column;
wim 18:bd65dc10f27f 644
wim 18:bd65dc10f27f 645
wim 13:24506ba22480 646 case LCD16x1:
wim 13:24506ba22480 647 // LCD16x1 is a special layout of LCD8x2
wim 13:24506ba22480 648 if (column<8)
wim 13:24506ba22480 649 return 0x00 + column;
wim 13:24506ba22480 650 else
wim 13:24506ba22480 651 return 0x40 + (column - 8);
wim 13:24506ba22480 652
wim 15:b70ebfffb258 653 case LCD12x4:
wim 15:b70ebfffb258 654 switch (row) {
wim 15:b70ebfffb258 655 case 0:
wim 15:b70ebfffb258 656 return 0x00 + column;
wim 15:b70ebfffb258 657 case 1:
wim 15:b70ebfffb258 658 return 0x40 + column;
wim 15:b70ebfffb258 659 case 2:
wim 15:b70ebfffb258 660 return 0x0C + column;
wim 15:b70ebfffb258 661 case 3:
wim 15:b70ebfffb258 662 return 0x4C + column;
wim 15:b70ebfffb258 663 }
wim 15:b70ebfffb258 664
wim 8:03116f75b66e 665 case LCD16x4:
wim 8:03116f75b66e 666 switch (row) {
wim 8:03116f75b66e 667 case 0:
wim 8:03116f75b66e 668 return 0x00 + column;
wim 8:03116f75b66e 669 case 1:
wim 8:03116f75b66e 670 return 0x40 + column;
wim 8:03116f75b66e 671 case 2:
wim 8:03116f75b66e 672 return 0x10 + column;
wim 8:03116f75b66e 673 case 3:
wim 8:03116f75b66e 674 return 0x50 + column;
wim 8:03116f75b66e 675 }
wim 8:03116f75b66e 676
wim 8:03116f75b66e 677 case LCD20x4:
wim 8:03116f75b66e 678 switch (row) {
wim 8:03116f75b66e 679 case 0:
wim 8:03116f75b66e 680 return 0x00 + column;
wim 8:03116f75b66e 681 case 1:
wim 8:03116f75b66e 682 return 0x40 + column;
wim 8:03116f75b66e 683 case 2:
wim 8:03116f75b66e 684 return 0x14 + column;
wim 8:03116f75b66e 685 case 3:
wim 8:03116f75b66e 686 return 0x54 + column;
wim 8:03116f75b66e 687 }
wim 8:03116f75b66e 688
wim 10:dd9b3a696acd 689 // Special mode for KS0078
wim 10:dd9b3a696acd 690 case LCD24x4:
wim 10:dd9b3a696acd 691 switch (row) {
wim 10:dd9b3a696acd 692 case 0:
wim 10:dd9b3a696acd 693 return 0x00 + column;
wim 10:dd9b3a696acd 694 case 1:
wim 10:dd9b3a696acd 695 return 0x20 + column;
wim 10:dd9b3a696acd 696 case 2:
wim 10:dd9b3a696acd 697 return 0x40 + column;
wim 10:dd9b3a696acd 698 case 3:
wim 10:dd9b3a696acd 699 return 0x60 + column;
wim 10:dd9b3a696acd 700 }
wim 10:dd9b3a696acd 701
wim 8:03116f75b66e 702 // Not sure about this one, seems wrong.
wim 8:03116f75b66e 703 case LCD16x2B:
wim 8:03116f75b66e 704 return 0x00 + (row * 40) + column;
wim 8:03116f75b66e 705
wim 18:bd65dc10f27f 706 case LCD8x2:
wim 15:b70ebfffb258 707 case LCD12x2:
wim 8:03116f75b66e 708 case LCD16x2:
wim 8:03116f75b66e 709 case LCD20x2:
wim 8:03116f75b66e 710 case LCD24x2:
wim 9:0893d986e717 711 case LCD40x2:
wim 8:03116f75b66e 712 return 0x00 + (row * 0x40) + column;
wim 15:b70ebfffb258 713
wim 15:b70ebfffb258 714 case LCD40x4:
wim 15:b70ebfffb258 715 // LCD40x4 is a special case since it has 2 controllers
wim 15:b70ebfffb258 716 // Each controller is configured as 40x2
wim 15:b70ebfffb258 717 if (row<2) {
wim 15:b70ebfffb258 718 // Test to see if we need to switch between controllers
wim 15:b70ebfffb258 719 if (_ctrl != _LCDCtrl_0) {
wim 17:652ab113bc2e 720
wim 15:b70ebfffb258 721 // Second LCD controller Cursor Off
wim 17:652ab113bc2e 722 _setCursorAndDisplayMode(_currentMode, TextLCD::CurOff_BlkOff);
wim 15:b70ebfffb258 723
wim 15:b70ebfffb258 724 // Select primary controller
wim 15:b70ebfffb258 725 _ctrl = _LCDCtrl_0;
wim 15:b70ebfffb258 726
wim 15:b70ebfffb258 727 // Restore cursormode on primary LCD controller
wim 17:652ab113bc2e 728 _setCursorAndDisplayMode(_currentMode, _currentCursor);
wim 15:b70ebfffb258 729 }
wim 15:b70ebfffb258 730
wim 15:b70ebfffb258 731 return 0x00 + (row * 0x40) + column;
wim 15:b70ebfffb258 732 }
wim 15:b70ebfffb258 733 else {
wim 15:b70ebfffb258 734
wim 15:b70ebfffb258 735 // Test to see if we need to switch between controllers
wim 15:b70ebfffb258 736 if (_ctrl != _LCDCtrl_1) {
wim 15:b70ebfffb258 737 // Primary LCD controller Cursor Off
wim 17:652ab113bc2e 738 _setCursorAndDisplayMode(_currentMode, TextLCD::CurOff_BlkOff);
wim 15:b70ebfffb258 739
wim 15:b70ebfffb258 740 // Select secondary controller
wim 15:b70ebfffb258 741 _ctrl = _LCDCtrl_1;
wim 15:b70ebfffb258 742
wim 15:b70ebfffb258 743 // Restore cursormode on secondary LCD controller
wim 17:652ab113bc2e 744 _setCursorAndDisplayMode(_currentMode, _currentCursor);
wim 15:b70ebfffb258 745 }
wim 15:b70ebfffb258 746
wim 15:b70ebfffb258 747 return 0x00 + ((row-2) * 0x40) + column;
wim 15:b70ebfffb258 748 }
wim 8:03116f75b66e 749
wim 8:03116f75b66e 750 // Should never get here.
wim 8:03116f75b66e 751 default:
wim 8:03116f75b66e 752 return 0x00;
wim 8:03116f75b66e 753 }
wim 8:03116f75b66e 754 }
wim 8:03116f75b66e 755
wim 8:03116f75b66e 756
wim 15:b70ebfffb258 757 // Set row, column and update memoryaddress.
wim 8:03116f75b66e 758 //
wim 8:03116f75b66e 759 void TextLCD::setAddress(int column, int row) {
wim 15:b70ebfffb258 760
wim 15:b70ebfffb258 761 // Sanity Check column
wim 15:b70ebfffb258 762 if (column < 0) {
wim 15:b70ebfffb258 763 _column = 0;
wim 15:b70ebfffb258 764 }
wim 15:b70ebfffb258 765 else if (column >= columns()) {
wim 15:b70ebfffb258 766 _column = columns() - 1;
wim 15:b70ebfffb258 767 } else _column = column;
wim 8:03116f75b66e 768
wim 15:b70ebfffb258 769 // Sanity Check row
wim 15:b70ebfffb258 770 if (row < 0) {
wim 15:b70ebfffb258 771 _row = 0;
wim 15:b70ebfffb258 772 }
wim 15:b70ebfffb258 773 else if (row >= rows()) {
wim 15:b70ebfffb258 774 _row = rows() - 1;
wim 15:b70ebfffb258 775 } else _row = row;
wim 15:b70ebfffb258 776
wim 15:b70ebfffb258 777
wim 15:b70ebfffb258 778 // Compute the memory address
wim 15:b70ebfffb258 779 // For LCD40x4: switch controllers if needed
wim 15:b70ebfffb258 780 // switch cursor if needed
wim 15:b70ebfffb258 781 int addr = getAddress(_column, _row);
wim 8:03116f75b66e 782
wim 13:24506ba22480 783 _writeCommand(0x80 | addr);
wim 8:03116f75b66e 784 }
simon 1:ac48b187213c 785
simon 1:ac48b187213c 786 int TextLCD::columns() {
simon 1:ac48b187213c 787 switch (_type) {
wim 8:03116f75b66e 788 case LCD8x1:
wim 8:03116f75b66e 789 case LCD8x2:
wim 18:bd65dc10f27f 790 case LCD8x2B:
wim 8:03116f75b66e 791 return 8;
wim 15:b70ebfffb258 792
wim 15:b70ebfffb258 793 case LCD12x2:
wim 15:b70ebfffb258 794 case LCD12x4:
wim 15:b70ebfffb258 795 return 12;
wim 8:03116f75b66e 796
wim 13:24506ba22480 797 case LCD16x1:
simon 1:ac48b187213c 798 case LCD16x2:
simon 1:ac48b187213c 799 case LCD16x2B:
wim 8:03116f75b66e 800 case LCD16x4:
wim 8:03116f75b66e 801 return 16;
wim 8:03116f75b66e 802
wim 8:03116f75b66e 803 case LCD20x2:
wim 8:03116f75b66e 804 case LCD20x4:
wim 8:03116f75b66e 805 return 20;
wim 8:03116f75b66e 806
wim 8:03116f75b66e 807 case LCD24x2:
wim 10:dd9b3a696acd 808 case LCD24x4:
wim 8:03116f75b66e 809 return 24;
wim 9:0893d986e717 810
wim 9:0893d986e717 811 case LCD40x2:
wim 15:b70ebfffb258 812 case LCD40x4:
wim 9:0893d986e717 813 return 40;
wim 8:03116f75b66e 814
wim 8:03116f75b66e 815 // Should never get here.
simon 1:ac48b187213c 816 default:
wim 8:03116f75b66e 817 return 0;
simon 1:ac48b187213c 818 }
simon 1:ac48b187213c 819 }
simon 1:ac48b187213c 820
simon 1:ac48b187213c 821 int TextLCD::rows() {
simon 1:ac48b187213c 822 switch (_type) {
wim 8:03116f75b66e 823 case LCD8x1:
wim 13:24506ba22480 824 case LCD16x1:
wim 8:03116f75b66e 825 return 1;
wim 8:03116f75b66e 826
wim 15:b70ebfffb258 827 case LCD8x2:
wim 18:bd65dc10f27f 828 case LCD8x2B:
wim 15:b70ebfffb258 829 case LCD12x2:
simon 1:ac48b187213c 830 case LCD16x2:
simon 1:ac48b187213c 831 case LCD16x2B:
simon 1:ac48b187213c 832 case LCD20x2:
wim 8:03116f75b66e 833 case LCD24x2:
wim 9:0893d986e717 834 case LCD40x2:
wim 8:03116f75b66e 835 return 2;
wim 8:03116f75b66e 836
wim 15:b70ebfffb258 837 case LCD12x4:
wim 8:03116f75b66e 838 case LCD16x4:
wim 8:03116f75b66e 839 case LCD20x4:
wim 10:dd9b3a696acd 840 case LCD24x4:
wim 15:b70ebfffb258 841 case LCD40x4:
wim 8:03116f75b66e 842 return 4;
wim 12:6bf9d9957d31 843
wim 12:6bf9d9957d31 844 // Should never get here.
simon 1:ac48b187213c 845 default:
wim 8:03116f75b66e 846 return 0;
simon 1:ac48b187213c 847 }
simon 1:ac48b187213c 848 }
wim 10:dd9b3a696acd 849
wim 10:dd9b3a696acd 850
wim 17:652ab113bc2e 851 // Set the Cursor Mode (Cursor Off & Blink Off, Cursor On & Blink Off, Cursor Off & Blink On, Cursor On & Blink On
wim 17:652ab113bc2e 852 void TextLCD::setCursor(TextLCD::LCDCursor cursorMode) {
wim 15:b70ebfffb258 853
wim 17:652ab113bc2e 854 // Save new cursor mode, needed when 2 controllers are in use or when display is switched off/on
wim 17:652ab113bc2e 855 _currentCursor = cursorMode;
wim 10:dd9b3a696acd 856
wim 17:652ab113bc2e 857 // Configure only current LCD controller
wim 17:652ab113bc2e 858 _setCursorAndDisplayMode(_currentMode, _currentCursor);
wim 15:b70ebfffb258 859
wim 15:b70ebfffb258 860 }
wim 15:b70ebfffb258 861
wim 17:652ab113bc2e 862 // Set the Displaymode (On/Off)
wim 17:652ab113bc2e 863 void TextLCD::setMode(TextLCD::LCDMode displayMode) {
wim 17:652ab113bc2e 864
wim 17:652ab113bc2e 865 // Save new displayMode, needed when 2 controllers are in use or when cursor is changed
wim 17:652ab113bc2e 866 _currentMode = displayMode;
wim 15:b70ebfffb258 867
wim 17:652ab113bc2e 868 // Select and configure second LCD controller when needed
wim 17:652ab113bc2e 869 if(_type==LCD40x4) {
wim 17:652ab113bc2e 870 if (_ctrl==TextLCD::_LCDCtrl_0) {
wim 17:652ab113bc2e 871 // Configure primary LCD controller
wim 17:652ab113bc2e 872 _setCursorAndDisplayMode(_currentMode, _currentCursor);
wim 11:9ec02df863a1 873
wim 17:652ab113bc2e 874 // Select 2nd controller
wim 17:652ab113bc2e 875 _ctrl=TextLCD::_LCDCtrl_1;
wim 17:652ab113bc2e 876
wim 17:652ab113bc2e 877 // Configure secondary LCD controller
wim 17:652ab113bc2e 878 _setCursorAndDisplayMode(_currentMode, TextLCD::CurOff_BlkOff);
wim 11:9ec02df863a1 879
wim 17:652ab113bc2e 880 // Restore current controller
wim 17:652ab113bc2e 881 _ctrl=TextLCD::_LCDCtrl_0;
wim 17:652ab113bc2e 882 }
wim 17:652ab113bc2e 883 else {
wim 17:652ab113bc2e 884 // Select primary controller
wim 17:652ab113bc2e 885 _ctrl=TextLCD::_LCDCtrl_0;
wim 17:652ab113bc2e 886
wim 17:652ab113bc2e 887 // Configure primary LCD controller
wim 17:652ab113bc2e 888 _setCursorAndDisplayMode(_currentMode, TextLCD::CurOff_BlkOff);
wim 17:652ab113bc2e 889
wim 17:652ab113bc2e 890 // Restore current controller
wim 17:652ab113bc2e 891 _ctrl=TextLCD::_LCDCtrl_1;
wim 11:9ec02df863a1 892
wim 17:652ab113bc2e 893 // Configure secondary LCD controller
wim 17:652ab113bc2e 894 _setCursorAndDisplayMode(_currentMode, _currentCursor);
wim 11:9ec02df863a1 895
wim 10:dd9b3a696acd 896 }
wim 17:652ab113bc2e 897 }
wim 17:652ab113bc2e 898 else {
wim 17:652ab113bc2e 899 // Configure primary LCD controller
wim 17:652ab113bc2e 900 _setCursorAndDisplayMode(_currentMode, _currentCursor);
wim 17:652ab113bc2e 901 }
wim 17:652ab113bc2e 902
wim 17:652ab113bc2e 903 }
wim 17:652ab113bc2e 904
wim 17:652ab113bc2e 905
wim 17:652ab113bc2e 906 // Set the Displaymode (On/Off) and Cursortype for current controller
wim 17:652ab113bc2e 907 void TextLCD::_setCursorAndDisplayMode(TextLCD::LCDMode displayMode, TextLCD::LCDCursor cursorType) {
wim 17:652ab113bc2e 908
wim 17:652ab113bc2e 909 // Configure current LCD controller
wim 17:652ab113bc2e 910 _writeCommand(0x08 | displayMode | cursorType);
wim 10:dd9b3a696acd 911 }
wim 10:dd9b3a696acd 912
wim 10:dd9b3a696acd 913
wim 11:9ec02df863a1 914 void TextLCD::setUDC(unsigned char c, char *udc_data) {
wim 15:b70ebfffb258 915
wim 15:b70ebfffb258 916 // Select and configure second LCD controller when needed
wim 15:b70ebfffb258 917 if(_type==LCD40x4) {
wim 15:b70ebfffb258 918 _LCDCtrl current_ctrl = _ctrl; // Temp save current controller
wim 15:b70ebfffb258 919
wim 15:b70ebfffb258 920 // Select primary controller
wim 15:b70ebfffb258 921 _ctrl=TextLCD::_LCDCtrl_0;
wim 15:b70ebfffb258 922
wim 15:b70ebfffb258 923 // Configure primary LCD controller
wim 15:b70ebfffb258 924 _setUDC(c, udc_data);
wim 15:b70ebfffb258 925
wim 15:b70ebfffb258 926 // Select 2nd controller
wim 15:b70ebfffb258 927 _ctrl=TextLCD::_LCDCtrl_1;
wim 15:b70ebfffb258 928
wim 15:b70ebfffb258 929 // Configure secondary LCD controller
wim 15:b70ebfffb258 930 _setUDC(c, udc_data);
wim 11:9ec02df863a1 931
wim 15:b70ebfffb258 932 // Restore current controller
wim 15:b70ebfffb258 933 _ctrl=current_ctrl;
wim 15:b70ebfffb258 934 }
wim 15:b70ebfffb258 935 else {
wim 15:b70ebfffb258 936 // Configure primary LCD controller
wim 15:b70ebfffb258 937 _setUDC(c, udc_data);
wim 15:b70ebfffb258 938 }
wim 15:b70ebfffb258 939
wim 15:b70ebfffb258 940 }
wim 15:b70ebfffb258 941
wim 15:b70ebfffb258 942 void TextLCD::_setUDC(unsigned char c, char *udc_data) {
wim 15:b70ebfffb258 943
wim 15:b70ebfffb258 944 // Select CG RAM for current LCD controller
wim 15:b70ebfffb258 945 _writeCommand(0x40 + ((c & 0x07) << 3)); //Set CG-RAM address,
wim 15:b70ebfffb258 946 //8 sequential locations needed per UDC
wim 15:b70ebfffb258 947 // Store UDC pattern
wim 11:9ec02df863a1 948 for (int i=0; i<8; i++) {
wim 13:24506ba22480 949 _writeData(*udc_data++);
wim 11:9ec02df863a1 950 }
wim 15:b70ebfffb258 951
wim 15:b70ebfffb258 952 //Select DD RAM again for current LCD controller
wim 15:b70ebfffb258 953 int addr = getAddress(_column, _row);
wim 15:b70ebfffb258 954 _writeCommand(0x80 | addr);
wim 15:b70ebfffb258 955
wim 11:9ec02df863a1 956 }