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