C.Dupaty 03-2018 test on NUCLEO STM32-F411RE LCD 2x16, I2C interface Chinese model, adress I2C=0x4E (search on AliExpress for IIC/I2C 1602 Module) Important ! configure in TextLCD_Config.h : Valid only one of the lines : #define DFROBOT 0 // chinese OK #define YWROBOT 0 // chinese 0K #define SYDZ 1 // chinese OK Font is the same as http://www.farnell.com/datasheets/2362518.pdf

Fork of TextLCD by Wim Huiskamp

/* Hello World! for the TextLCD Enhanced Library C.Dupaty 03-2018 test on NUCLEO STM32-F411RE LCD 2x16, I2C interface Chinese model, adress I2C=0x4E (search on AliExpress for IIC/I2C 1602 Module) Important ! configure in TextLCD_Config.h : Valid only one of the lines :

  1. define DFROBOT 0 chinese OK
  2. define YWROBOT 0 chinese 0K
  3. define SYDZ 1 chinese OK Font is the same as http://www.farnell.com/datasheets/2362518.pdf
  • /
Committer:
wim
Date:
Sat Jun 28 14:27:32 2014 +0000
Revision:
30:033048611c01
Parent:
29:a3663151aa65
Child:
31:ef31cd8a00d1
Tested AIP31068 for I2C, tested SPI3_9 and SPI3_10

Who changed what in which revision?

UserRevisionLine numberNew contents of line
simon 1:ac48b187213c 1 /* mbed TextLCD Library, for a 4-bit LCD based on HD44780
simon 6:e4cb7ddee0d3 2 * Copyright (c) 2007-2010, sford, http://mbed.org
wim 14:0c32b66b14b8 3 * 2013, v01: WH, Added LCD types, fixed LCD address issues, added Cursor and UDCs
wim 14:0c32b66b14b8 4 * 2013, v02: WH, Added I2C and SPI bus interfaces
wim 15:b70ebfffb258 5 * 2013, v03: WH, Added support for LCD40x4 which uses 2 controllers
wim 18:bd65dc10f27f 6 * 2013, v04: WH, Added support for Display On/Off, improved 4bit bootprocess
wim 18:bd65dc10f27f 7 * 2013, v05: WH, Added support for 8x2B, added some UDCs
wim 19:c747b9e2e7b8 8 * 2013, v06: WH, Added support for devices that use internal DC/DC converters
wim 20:e0da005a777f 9 * 2013, v07: WH, Added support for backlight and include portdefinitions for LCD2004 Module from DFROBOT
wim 22:35742ec80c24 10 * 2014, v08: WH, Refactored in Base and Derived Classes to deal with mbed lib change regarding 'NC' defined pins
wim 25:6162b31128c9 11 * 2014, v09: WH/EO, Added Class for Native SPI controllers such as ST7032
wim 26:bd897a001012 12 * 2014, v10: WH, Added Class for Native I2C controllers such as ST7032i, Added support for MCP23008 I2C portexpander, Added support for Adafruit module
wim 30:033048611c01 13 * 2014, v11: WH, Added support for native I2C controllers such as PCF21XX, Improved the _initCtrl() method to deal with differences between all supported controllers
simon 1:ac48b187213c 14 *
simon 1:ac48b187213c 15 * Permission is hereby granted, free of charge, to any person obtaining a copy
simon 1:ac48b187213c 16 * of this software and associated documentation files (the "Software"), to deal
simon 1:ac48b187213c 17 * in the Software without restriction, including without limitation the rights
simon 1:ac48b187213c 18 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
simon 1:ac48b187213c 19 * copies of the Software, and to permit persons to whom the Software is
simon 1:ac48b187213c 20 * furnished to do so, subject to the following conditions:
simon 1:ac48b187213c 21 *
simon 1:ac48b187213c 22 * The above copyright notice and this permission notice shall be included in
simon 1:ac48b187213c 23 * all copies or substantial portions of the Software.
simon 1:ac48b187213c 24 *
simon 1:ac48b187213c 25 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
simon 1:ac48b187213c 26 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
simon 1:ac48b187213c 27 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
simon 1:ac48b187213c 28 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
simon 1:ac48b187213c 29 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
simon 1:ac48b187213c 30 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
simon 1:ac48b187213c 31 * THE SOFTWARE.
simon 1:ac48b187213c 32 */
simon 1:ac48b187213c 33
simon 1:ac48b187213c 34 #include "TextLCD.h"
simon 1:ac48b187213c 35 #include "mbed.h"
simon 1:ac48b187213c 36
wim 30:033048611c01 37 //For Testing only
wim 30:033048611c01 38 //DigitalOut led1(LED1);
wim 30:033048611c01 39 //DigitalOut led2(LED2);
wim 30:033048611c01 40 // led2=!led2;
wim 29:a3663151aa65 41
wim 29:a3663151aa65 42
wim 30:033048611c01 43 /** Some sample User Defined Chars 5x7 dots */
wim 30:033048611c01 44 const char udc_ae[] = {0x00, 0x00, 0x1B, 0x05, 0x1F, 0x14, 0x1F, 0x00}; //æ
wim 30:033048611c01 45 const char udc_0e[] = {0x00, 0x00, 0x0E, 0x13, 0x15, 0x19, 0x0E, 0x00}; //ø
wim 30:033048611c01 46 const char udc_ao[] = {0x0E, 0x0A, 0x0E, 0x01, 0x0F, 0x11, 0x0F, 0x00}; //å
wim 30:033048611c01 47 const char udc_AE[] = {0x0F, 0x14, 0x14, 0x1F, 0x14, 0x14, 0x17, 0x00}; //Æ
wim 30:033048611c01 48 const char udc_0E[] = {0x0E, 0x13, 0x15, 0x15, 0x15, 0x19, 0x0E, 0x00}; //Ø
wim 30:033048611c01 49 const char udc_Ao[] = {0x0E, 0x0A, 0x0E, 0x11, 0x1F, 0x11, 0x11, 0x00}; //Å
wim 30:033048611c01 50 const char udc_PO[] = {0x04, 0x0A, 0x0A, 0x1F, 0x1B, 0x1B, 0x1F, 0x00}; //Padlock Open
wim 30:033048611c01 51 const char udc_PC[] = {0x1C, 0x10, 0x08, 0x1F, 0x1B, 0x1B, 0x1F, 0x00}; //Padlock Closed
wim 30:033048611c01 52
wim 30:033048611c01 53 const char udc_0[] = {0x18, 0x14, 0x12, 0x11, 0x12, 0x14, 0x18, 0x00}; // |>
wim 30:033048611c01 54 const char udc_1[] = {0x03, 0x05, 0x09, 0x11, 0x09, 0x05, 0x03, 0x00}; // <|
wim 30:033048611c01 55 const char udc_2[] = {0x10, 0x10, 0x10, 0x10, 0x10, 0x10, 0x10, 0x00}; // |
wim 30:033048611c01 56 const char udc_3[] = {0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x00}; // ||
wim 30:033048611c01 57 const char udc_4[] = {0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x00}; // |||
wim 30:033048611c01 58 const char udc_5[] = {0x00, 0x1f, 0x00, 0x1f, 0x00, 0x1f, 0x00, 0x00}; // =
wim 30:033048611c01 59 const char udc_6[] = {0x15, 0x0a, 0x15, 0x0a, 0x15, 0x0a, 0x15, 0x00}; // checkerboard
wim 30:033048611c01 60 const char udc_7[] = {0x10, 0x08, 0x04, 0x02, 0x01, 0x00, 0x10, 0x00}; // \
wim 30:033048611c01 61
wim 30:033048611c01 62 const char udc_degr[] = {0x06, 0x09, 0x09, 0x06, 0x00, 0x00, 0x00, 0x00}; // Degree symbol
wim 30:033048611c01 63
wim 30:033048611c01 64 const char udc_TM_T[] = {0x1F, 0x04, 0x04, 0x04, 0x00, 0x00, 0x00, 0x00}; // Trademark T
wim 30:033048611c01 65 const char udc_TM_M[] = {0x11, 0x1B, 0x15, 0x11, 0x00, 0x00, 0x00, 0x00}; // Trademark M
wim 30:033048611c01 66
wim 30:033048611c01 67 //const char udc_Bat_Hi[] = {0x0E, 0x1F, 0x1F, 0x1F, 0x1F, 0x1F, 0x1F, 0x00}; // Battery Full
wim 30:033048611c01 68 //const char udc_Bat_Ha[] = {0x0E, 0x11, 0x13, 0x17, 0x1F, 0x1F, 0x1F, 0x00}; // Battery Half
wim 30:033048611c01 69 //const char udc_Bat_Lo[] = {0x0E, 0x11, 0x11, 0x11, 0x11, 0x11, 0x1F, 0x00}; // Battery Low
wim 30:033048611c01 70 const char udc_Bat_Hi[] = {0x0E, 0x1F, 0x1F, 0x1F, 0x1F, 0x1F, 0x1F, 0x00}; // Battery Full
wim 30:033048611c01 71 const char udc_Bat_Ha[] = {0x0E, 0x11, 0x11, 0x1F, 0x1F, 0x1F, 0x1F, 0x00}; // Battery Half
wim 30:033048611c01 72 const char udc_Bat_Lo[] = {0x0E, 0x11, 0x11, 0x11, 0x11, 0x1F, 0x1F, 0x00}; // Battery Low
wim 30:033048611c01 73 const char udc_AC[] = {0x0A, 0x0A, 0x1F, 0x11, 0x0E, 0x04, 0x04, 0x00}; // AC Power
wim 30:033048611c01 74
wim 30:033048611c01 75 //const char udc_smiley[] = {0x00, 0x0A, 0x00, 0x04, 0x11, 0x0E, 0x00, 0x00}; // Smiley
wim 30:033048611c01 76 //const char udc_droopy[] = {0x00, 0x0A, 0x00, 0x04, 0x00, 0x0E, 0x11, 0x00}; // Droopey
wim 30:033048611c01 77 //const char udc_note[] = {0x01, 0x03, 0x05, 0x09, 0x0B, 0x1B, 0x18, 0x00}; // Note
wim 30:033048611c01 78
wim 30:033048611c01 79 //const char udc_bar_1[] = {0x10, 0x10, 0x10, 0x10, 0x10, 0x10, 0x10, 0x00}; // Bar 1
wim 30:033048611c01 80 //const char udc_bar_2[] = {0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x00}; // Bar 11
wim 30:033048611c01 81 //const char udc_bar_3[] = {0x1C, 0x1C, 0x1C, 0x1C, 0x1C, 0x1C, 0x1C, 0x00}; // Bar 111
wim 30:033048611c01 82 //const char udc_bar_4[] = {0x17, 0x17, 0x17, 0x17, 0x17, 0x17, 0x17, 0x00}; // Bar 1111
wim 30:033048611c01 83 //const char udc_bar_5[] = {0x1F, 0x1F, 0x1F, 0x1F, 0x1F, 0x1F, 0x1F, 0x00}; // Bar 11111
wim 30:033048611c01 84
wim 30:033048611c01 85 //const char udc_ch_1[] = {0x1f, 0x00, 0x1f, 0x00, 0x1f, 0x00, 0x1f, 0x00}; // Hor bars 4
wim 30:033048611c01 86 //const char udc_ch_2[] = {0x00, 0x1f, 0x00, 0x1f, 0x00, 0x1f, 0x00, 0x1f}; // Hor bars 4 (inverted)
wim 30:033048611c01 87 //const char udc_ch_3[] = {0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x15}; // Ver bars 3
wim 30:033048611c01 88 //const char udc_ch_4[] = {0x0a, 0x0a, 0x0a, 0x0a, 0x0a, 0x0a, 0x0a, 0x0a}; // Ver bars 3 (inverted)
wim 30:033048611c01 89 //const char udc_ch_yr[] = {0x08, 0x0f, 0x12, 0x0f, 0x0a, 0x1f, 0x02, 0x02}; // Year (kana)
wim 30:033048611c01 90 //const char udc_ch_mo[] = {0x0f, 0x09, 0x0f, 0x09, 0x0f, 0x09, 0x09, 0x13}; // Month (kana)
wim 30:033048611c01 91 //const char udc_ch_dy[] = {0x1f, 0x11, 0x11, 0x1f, 0x11, 0x11, 0x11, 0x1F}; // Day (kana)
wim 30:033048611c01 92 //const char udc_ch_mi[] = {0x0C, 0x0a, 0x11, 0x1f, 0x09, 0x09, 0x09, 0x13}; // minute (kana)
wim 30:033048611c01 93
wim 30:033048611c01 94
wim 21:9eb628d9e164 95 /** Create a TextLCD_Base interface
wim 15:b70ebfffb258 96 *
wim 21:9eb628d9e164 97 * @param type Sets the panel size/addressing mode (default = LCD16x2)
wim 21:9eb628d9e164 98 * @param ctrl LCD controller (default = HD44780)
wim 15:b70ebfffb258 99 */
wim 21:9eb628d9e164 100 TextLCD_Base::TextLCD_Base(LCDType type, LCDCtrl ctrl) : _type(type), _ctrl(ctrl) {
wim 30:033048611c01 101
wim 30:033048611c01 102 // Extract LCDType data
wim 30:033048611c01 103
wim 30:033048611c01 104 // Columns encoded in b7..b0
wim 30:033048611c01 105 _nr_cols = (_type & 0xFF);
wim 30:033048611c01 106
wim 30:033048611c01 107 // Rows encoded in b15..b8
wim 30:033048611c01 108 _nr_rows = ((_type >> 8) & 0xFF);
wim 30:033048611c01 109
wim 30:033048611c01 110 // Addressing mode encoded in b19..b16
wim 30:033048611c01 111 _addr_mode = _type & LCD_T_ADR_MSK;
wim 14:0c32b66b14b8 112 }
wim 14:0c32b66b14b8 113
wim 14:0c32b66b14b8 114
wim 21:9eb628d9e164 115 /** Init the LCD Controller(s)
wim 21:9eb628d9e164 116 * Clear display
wim 21:9eb628d9e164 117 */
wim 21:9eb628d9e164 118 void TextLCD_Base::_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 30:033048611c01 122 _ctrl_idx=_LCDCtrl_1; // Select 2nd controller
wim 30:033048611c01 123 _initCtrl(); // Init 2nd controller
wim 15:b70ebfffb258 124 }
wim 15:b70ebfffb258 125
wim 15:b70ebfffb258 126 // Select and configure primary LCD controller
wim 27:22d5086f6ba6 127 _ctrl_idx=_LCDCtrl_0; // Select primary controller
wim 19:c747b9e2e7b8 128 _initCtrl(); // Init primary controller
wim 28:30fa94f7341c 129
wim 28:30fa94f7341c 130 // Reset Cursor location
wim 28:30fa94f7341c 131 _row=0;
wim 30:033048611c01 132 _column=0;
wim 30:033048611c01 133
wim 15:b70ebfffb258 134 }
wim 15:b70ebfffb258 135
wim 21:9eb628d9e164 136 /** Init the LCD controller
wim 21:9eb628d9e164 137 * 4-bit mode, number of lines, fonttype, no cursor etc
wim 30:033048611c01 138 *
wim 30:033048611c01 139 * Note: some configurations are commented out because they have not yet been tested due to lack of hardware
wim 21:9eb628d9e164 140 */
wim 21:9eb628d9e164 141 void TextLCD_Base::_initCtrl() {
wim 15:b70ebfffb258 142
wim 26:bd897a001012 143 this->_setRS(false); // command mode
wim 13:24506ba22480 144
wim 26:bd897a001012 145 wait_ms(20); // Wait 20ms to ensure powered up
simon 1:ac48b187213c 146
wim 17:652ab113bc2e 147 // send "Display Settings" 3 times (Only top nibble of 0x30 as we've got 4-bit bus)
wim 17:652ab113bc2e 148 for (int i=0; i<3; i++) {
wim 17:652ab113bc2e 149 _writeNibble(0x3);
wim 20:e0da005a777f 150 wait_ms(15); // This command takes 1.64ms, so wait for it
wim 17:652ab113bc2e 151 }
wim 17:652ab113bc2e 152 _writeNibble(0x2); // 4-bit mode
wim 17:652ab113bc2e 153 wait_us(40); // most instructions take 40us
wim 18:bd65dc10f27f 154
wim 18:bd65dc10f27f 155 // Display is now in 4-bit mode
wim 27:22d5086f6ba6 156 // Note: 4 bit mode is ignored for native SPI and I2C devices
wim 25:6162b31128c9 157
wim 29:a3663151aa65 158 // Device specific initialisations: DC/DC converter to generate VLCD or VLED, number of lines etc
wim 19:c747b9e2e7b8 159 switch (_ctrl) {
wim 29:a3663151aa65 160 case KS0078:
wim 29:a3663151aa65 161
wim 29:a3663151aa65 162 // Initialise Display configuration
wim 29:a3663151aa65 163 switch (_type) {
wim 29:a3663151aa65 164 case LCD8x1: //8x1 is a regular 1 line display
wim 29:a3663151aa65 165 case LCD8x2B: //8x2B is a special case of 16x1
wim 29:a3663151aa65 166 // case LCD12x1:
wim 29:a3663151aa65 167 case LCD16x1:
wim 30:033048611c01 168 // case LCD20x1:
wim 29:a3663151aa65 169 case LCD24x1:
wim 30:033048611c01 170 _writeCommand(0x20); // Function set 001 DL N RE(0) DH REV
wim 30:033048611c01 171 // DL=0 (4 bits bus)
wim 30:033048611c01 172 // N=0 (1 line)
wim 30:033048611c01 173 // RE=0 (Dis. Extended Regs, special mode for KS0078)
wim 30:033048611c01 174 // DH=0 (Disp shift=disable, special mode for KS0078)
wim 30:033048611c01 175 // REV=0 (Reverse=Normal, special mode for KS0078)
wim 30:033048611c01 176
wim 30:033048611c01 177
wim 30:033048611c01 178
wim 29:a3663151aa65 179 break;
wim 29:a3663151aa65 180
wim 30:033048611c01 181 // case LCD12x3D: // Special mode for KS0078
wim 30:033048611c01 182 // case LCD12x3D1: // Special mode for KS0078
wim 30:033048611c01 183 // case LCD12x4D: // Special mode for KS0078
wim 30:033048611c01 184 // case LCD16x3D:
wim 30:033048611c01 185 // case LCD16x4D:
wim 30:033048611c01 186 // case LCD24x3D: // Special mode for KS0078
wim 30:033048611c01 187 // case LCD24x3D1: // Special mode for KS0078
wim 30:033048611c01 188 case LCD24x4D: // Special mode for KS0078
wim 30:033048611c01 189
wim 30:033048611c01 190 _writeCommand(0x2A); // Function set 001 DL N RE(0) DH REV
wim 29:a3663151aa65 191 // DL=0 (4 bits bus)
wim 30:033048611c01 192 // N=1 (Dont care for KS0078 in 4-line mode)
wim 29:a3663151aa65 193 // RE=0 (Dis. Extended Regs, special mode for KS0078)
wim 30:033048611c01 194 // DH=1 (Disp shift=enable, special mode for KS0078)
wim 30:033048611c01 195 // REV=0 (Reverse=Normal, special mode for KS0078)
wim 29:a3663151aa65 196
wim 30:033048611c01 197 _writeCommand(0x2E); // Function set 001 DL N RE(1) BE 0
wim 29:a3663151aa65 198 // DL=0 (4 bits bus)
wim 30:033048611c01 199 // N=1 (Dont care for KS0078 in 4-line mode)
wim 29:a3663151aa65 200 // RE=1 (Ena Extended Regs, special mode for KS0078)
wim 30:033048611c01 201 // BE=1 (Blink Enable, CG/SEG RAM, special mode for KS0078)
wim 30:033048611c01 202 // X=0 (Reverse, special mode for KS0078)
wim 29:a3663151aa65 203
wim 29:a3663151aa65 204 _writeCommand(0x09); // Ext Function set 0000 1 FW BW NW
wim 29:a3663151aa65 205 // FW=0 (5-dot font, special mode for KS0078)
wim 29:a3663151aa65 206 // BW=0 (Cur BW invert disable, special mode for KS0078)
wim 29:a3663151aa65 207 // NW=1 (4 Line, special mode for KS0078)
wim 29:a3663151aa65 208
wim 30:033048611c01 209 _writeCommand(0x2A); // Function set 001 DL N RE(0) DH REV
wim 29:a3663151aa65 210 // DL=0 (4 bits bus)
wim 30:033048611c01 211 // N=1 (Dont care for KS0078 in 4 line mode)
wim 29:a3663151aa65 212 // RE=0 (Dis. Extended Regs, special mode for KS0078)
wim 30:033048611c01 213 // DH=1 (Disp shift enable, special mode for KS0078)
wim 30:033048611c01 214 // REV=0 (Reverse normal, special mode for KS0078)
wim 30:033048611c01 215 break;
wim 30:033048611c01 216
wim 29:a3663151aa65 217 default:
wim 30:033048611c01 218 // All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
wim 30:033048611c01 219 _writeCommand(0x28); // Function set 001 DL N RE(0) DH REV
wim 30:033048611c01 220 // DL=0 (4 bits bus)
wim 30:033048611c01 221 // Note: 4 bit mode is ignored for native SPI and I2C devices
wim 30:033048611c01 222 // N=1 (2 lines)
wim 30:033048611c01 223 // RE=0 (Dis. Extended Regs, special mode for KS0078)
wim 30:033048611c01 224 // DH=0 (Disp shift=disable, special mode for KS0078)
wim 30:033048611c01 225 // REV=0 (Reverse=Normal, special mode for KS0078)
wim 30:033048611c01 226
wim 29:a3663151aa65 227 break;
wim 29:a3663151aa65 228 } // switch type
wim 29:a3663151aa65 229
wim 29:a3663151aa65 230 break; // case KS0078 Controller
wim 29:a3663151aa65 231
wim 26:bd897a001012 232 case ST7032_3V3:
wim 26:bd897a001012 233 // ST7032 controller: Initialise Voltage booster for VLCD. VDD=3V3
wim 27:22d5086f6ba6 234
wim 29:a3663151aa65 235 // Initialise Display configuration
wim 29:a3663151aa65 236 switch (_type) {
wim 29:a3663151aa65 237 case LCD8x1: //8x1 is a regular 1 line display
wim 29:a3663151aa65 238 case LCD8x2B: //8x2B is a special case of 16x1
wim 29:a3663151aa65 239 // case LCD12x1:
wim 29:a3663151aa65 240 case LCD16x1:
wim 30:033048611c01 241 // case LCD20x1:
wim 29:a3663151aa65 242 case LCD24x1:
wim 29:a3663151aa65 243 _writeCommand(0x21); //FUNCTION SET 4 bit, N=0 1-line display mode, 5*7dot, Select Instruction Set = 1
wim 29:a3663151aa65 244 //Note: 4 bit mode is ignored for native SPI and I2C devices
wim 29:a3663151aa65 245
wim 29:a3663151aa65 246 _writeCommand(0x1C); //Internal OSC frequency adjustment Framefreq=183HZ, bias will be 1/4
wim 28:30fa94f7341c 247
wim 29:a3663151aa65 248 _writeCommand(0x73); //Contrast control low byte
wim 28:30fa94f7341c 249
wim 29:a3663151aa65 250 _writeCommand(0x57); //booster circuit is turned on. /ICON display off. /Contrast control high byte
wim 29:a3663151aa65 251 wait_ms(10); // Wait 10ms to ensure powered up
wim 29:a3663151aa65 252
wim 29:a3663151aa65 253 _writeCommand(0x6C); //Follower control
wim 29:a3663151aa65 254 wait_ms(10); // Wait 10ms to ensure powered up
wim 28:30fa94f7341c 255
wim 29:a3663151aa65 256 _writeCommand(0x20); //FUNCTION SET 4 bit, N=0 1-line display mode, 5*7dot, Return to Instruction Set = 0
wim 29:a3663151aa65 257 //Note: 4 bit mode is ignored for native SPI and I2C devices
wim 30:033048611c01 258 break;
wim 29:a3663151aa65 259
wim 30:033048611c01 260 case LCD12x3D: // Special mode for PCF2116
wim 30:033048611c01 261 case LCD12x3D1: // Special mode for PCF2116
wim 30:033048611c01 262 case LCD12x4D: // Special mode for PCF2116
wim 30:033048611c01 263 case LCD24x4D: // Special mode for KS0078
wim 30:033048611c01 264 error("Error: LCD Controller type does not support this Display type\n\r");
wim 29:a3663151aa65 265 break;
wim 29:a3663151aa65 266
wim 29:a3663151aa65 267 default:
wim 29:a3663151aa65 268 // All other LCD types are initialised as 2 Line displays
wim 29:a3663151aa65 269 _writeCommand(0x29); //FUNCTION SET 4 bit, N=1 2-line display mode, 5*7dot, Select Instruction Set = 1
wim 29:a3663151aa65 270 //Note: 4 bit mode is ignored for native SPI and I2C devices
wim 29:a3663151aa65 271
wim 29:a3663151aa65 272 _writeCommand(0x1C); //Internal OSC frequency adjustment Framefreq=183HZ, bias will be 1/4
wim 29:a3663151aa65 273
wim 29:a3663151aa65 274 _writeCommand(0x73); //Contrast control low byte
wim 29:a3663151aa65 275
wim 29:a3663151aa65 276 _writeCommand(0x57); //booster circuit is turned on. /ICON display off. /Contrast control high byte
wim 29:a3663151aa65 277 wait_ms(10); // Wait 10ms to ensure powered up
wim 28:30fa94f7341c 278
wim 29:a3663151aa65 279 _writeCommand(0x6C); //Follower control
wim 29:a3663151aa65 280 wait_ms(10); // Wait 10ms to ensure powered up
wim 29:a3663151aa65 281
wim 29:a3663151aa65 282 _writeCommand(0x28); //FUNCTION SET 4 bit, N=1 2-line display mode, 5*7dot, Return to Instruction Set = 0
wim 29:a3663151aa65 283 //Note: 4 bit mode is ignored for native SPI and I2C devices
wim 29:a3663151aa65 284 } // switch type
wim 29:a3663151aa65 285
wim 29:a3663151aa65 286 break; // case ST7032_3V3 Controller
wim 26:bd897a001012 287
wim 26:bd897a001012 288 case ST7032_5V:
wim 26:bd897a001012 289 // ST7032 controller: Disable Voltage booster for VLCD. VDD=5V
wim 29:a3663151aa65 290
wim 29:a3663151aa65 291 // Initialise Display configuration
wim 29:a3663151aa65 292 switch (_type) {
wim 29:a3663151aa65 293 case LCD8x1: //8x1 is a regular 1 line display
wim 29:a3663151aa65 294 case LCD8x2B: //8x2B is a special case of 16x1
wim 29:a3663151aa65 295 // case LCD12x1:
wim 29:a3663151aa65 296 case LCD16x1:
wim 30:033048611c01 297 // case LCD20x1:
wim 29:a3663151aa65 298 case LCD24x1:
wim 29:a3663151aa65 299 _writeCommand(0x21); //FUNCTION SET 4 bit, N=0 1-line display mode, 5*7dot, Select Instruction Set = 1
wim 29:a3663151aa65 300 //Note: 4 bit mode is ignored for native SPI and I2C devices
wim 29:a3663151aa65 301
wim 29:a3663151aa65 302 _writeCommand(0x1C); //Internal OSC frequency adjustment Framefreq=183HZ, bias will be 1/4
wim 29:a3663151aa65 303
wim 29:a3663151aa65 304 _writeCommand(0x73); //Contrast control low byte
wim 28:30fa94f7341c 305
wim 29:a3663151aa65 306 _writeCommand(0x53); //booster circuit is turned off. /ICON display off. /Contrast control high byte
wim 29:a3663151aa65 307 wait_ms(10); // Wait 10ms to ensure powered up
wim 29:a3663151aa65 308
wim 29:a3663151aa65 309 _writeCommand(0x6C); //Follower control
wim 29:a3663151aa65 310 wait_ms(10); // Wait 10ms to ensure powered up
wim 29:a3663151aa65 311
wim 29:a3663151aa65 312 _writeCommand(0x20); //FUNCTION SET 4 bit, N=0 1-line display mode, 5*7dot, Return to Instruction Set = 0
wim 29:a3663151aa65 313 //Note: 4 bit mode is ignored for native SPI and I2C devices
wim 30:033048611c01 314 break;
wim 29:a3663151aa65 315
wim 30:033048611c01 316 case LCD12x3D: // Special mode for PCF2116
wim 30:033048611c01 317 case LCD12x3D1: // Special mode for PCF2116
wim 30:033048611c01 318 case LCD12x4D: // Special mode for PCF2116
wim 30:033048611c01 319 case LCD24x4D: // Special mode for KS0078
wim 30:033048611c01 320 error("Error: LCD Controller type does not support this Display type\n\r");
wim 29:a3663151aa65 321 break;
wim 28:30fa94f7341c 322
wim 29:a3663151aa65 323 default:
wim 29:a3663151aa65 324 // All other LCD types are initialised as 2 Line displays
wim 29:a3663151aa65 325 _writeCommand(0x29); //FUNCTION SET 4 bit, N=1 2-line display mode, 5*7dot, Select Instruction Set = 1
wim 29:a3663151aa65 326 //Note: 4 bit mode is ignored for native SPI and I2C devices
wim 29:a3663151aa65 327
wim 29:a3663151aa65 328 _writeCommand(0x1C); //Internal OSC frequency adjustment Framefreq=183HZ, bias will be 1/4
wim 29:a3663151aa65 329
wim 29:a3663151aa65 330 _writeCommand(0x73); //Contrast control low byte
wim 29:a3663151aa65 331
wim 29:a3663151aa65 332 _writeCommand(0x53); //booster circuit is turned off. /ICON display off. /Contrast control high byte
wim 29:a3663151aa65 333 wait_ms(10); // Wait 10ms to ensure powered up
wim 29:a3663151aa65 334
wim 29:a3663151aa65 335 _writeCommand(0x6C); //Follower control
wim 29:a3663151aa65 336 wait_ms(10); // Wait 10ms to ensure powered up
wim 29:a3663151aa65 337
wim 29:a3663151aa65 338 _writeCommand(0x28); //FUNCTION SET 4 bit, N=1 2-line display mode, 5*7dot, Return to Instruction Set = 0
wim 29:a3663151aa65 339 //Note: 4 bit mode is ignored for native SPI and I2C devices
wim 29:a3663151aa65 340 } // switch type
wim 29:a3663151aa65 341
wim 29:a3663151aa65 342 break; // case ST7032_5V Controller
wim 28:30fa94f7341c 343
wim 29:a3663151aa65 344 case ST7036:
wim 29:a3663151aa65 345 // ST7036 controller: Initialise Voltage booster for VLCD. VDD=5V
wim 29:a3663151aa65 346 // Note: supports 1,2 or 3 lines
wim 28:30fa94f7341c 347
wim 29:a3663151aa65 348 // Initialise Display configuration
wim 29:a3663151aa65 349 switch (_type) {
wim 29:a3663151aa65 350 case LCD8x1: //8x1 is a regular 1 line display
wim 30:033048611c01 351 case LCD8x2B: //8x2D is a special case of 16x1
wim 29:a3663151aa65 352 // case LCD12x1:
wim 29:a3663151aa65 353 case LCD16x1:
wim 29:a3663151aa65 354 case LCD24x1:
wim 29:a3663151aa65 355 _writeCommand(0x21); // 4-bit Databus, N=0 1 Line, DH=0 5x7font, IS2,IS1 = 01 Select Instruction Set = 1
wim 29:a3663151aa65 356 wait_ms(30); // > 26,3ms
wim 29:a3663151aa65 357 _writeCommand(0x14); // Bias: 1/5, 1 or 2-Lines LCD
wim 29:a3663151aa65 358 // _writeCommand(0x15); // Bias: 1/5, 3-Lines LCD
wim 29:a3663151aa65 359 wait_ms(30); // > 26,3ms
wim 29:a3663151aa65 360 _writeCommand(0x55); // Icon off, Booster on, Set Contrast C5, C4
wim 29:a3663151aa65 361 wait_ms(30); // > 26,3ms
wim 29:a3663151aa65 362 _writeCommand(0x6D); // Voltagefollower On, Ampl ratio Rab2, Rab1, Rab0
wim 29:a3663151aa65 363 wait_ms(200); // > 200ms!
wim 29:a3663151aa65 364 _writeCommand(0x78); // Set Contrast C3, C2, C1, C0
wim 29:a3663151aa65 365 wait_ms(30); // > 26,3ms
wim 29:a3663151aa65 366 _writeCommand(0x20); // Return to Instruction Set = 0
wim 29:a3663151aa65 367 wait_ms(50);
wim 29:a3663151aa65 368 break;
wim 29:a3663151aa65 369 #if(0)
wim 29:a3663151aa65 370 // case LCD12x3:
wim 29:a3663151aa65 371 case LCD16x3:
wim 29:a3663151aa65 372 _writeCommand(0x29); // 4-bit Databus, N=1 2 Line, DH=0 5x7font, IS2,IS1 = 01 Select Instruction Set = 1
wim 29:a3663151aa65 373 wait_ms(30); // > 26,3ms
wim 29:a3663151aa65 374 // _writeCommand(0x14); // Bias: 1/5, 1 or 2-Lines LCD
wim 29:a3663151aa65 375 _writeCommand(0x15); // Bias: 1/5, 3-Lines LCD
wim 29:a3663151aa65 376 wait_ms(30); // > 26,3ms
wim 29:a3663151aa65 377 _writeCommand(0x55); // Icon off, Booster on, Set Contrast C5, C4
wim 29:a3663151aa65 378 wait_ms(30); // > 26,3ms
wim 29:a3663151aa65 379 _writeCommand(0x6D); // Voltagefollower On, Ampl ratio Rab2, Rab1, Rab0
wim 29:a3663151aa65 380 wait_ms(200); // > 200ms!
wim 29:a3663151aa65 381 _writeCommand(0x78); // Set Contrast C3, C2, C1, C0
wim 29:a3663151aa65 382 wait_ms(30); // > 26,3ms
wim 29:a3663151aa65 383 _writeCommand(0x28); // Return to Instruction Set = 0
wim 29:a3663151aa65 384 wait_ms(50);
wim 29:a3663151aa65 385 break;
wim 29:a3663151aa65 386 #endif
wim 30:033048611c01 387
wim 30:033048611c01 388 case LCD12x3D: // Special mode for PCF2116
wim 30:033048611c01 389 case LCD12x3D1: // Special mode for PCF2116
wim 30:033048611c01 390 case LCD12x4D: // Special mode for PCF2116
wim 30:033048611c01 391 case LCD24x4D: // Special mode for KS0078
wim 30:033048611c01 392 error("Error: LCD Controller type does not support this Display type\n\r");
wim 30:033048611c01 393 break;
wim 30:033048611c01 394
wim 29:a3663151aa65 395 default:
wim 30:033048611c01 396 // All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
wim 29:a3663151aa65 397 _writeCommand(0x29); // 4-bit Databus, N=1 2 Line, DH=0 5x7font, IS2,IS1 = 01 Select Instruction Set = 1
wim 29:a3663151aa65 398 wait_ms(30); // > 26,3ms
wim 29:a3663151aa65 399 _writeCommand(0x14); // Bias: 1/5, 2-Lines LCD
wim 29:a3663151aa65 400 // _writeCommand(0x15); // Bias: 1/5, 3-Lines LCD
wim 29:a3663151aa65 401 wait_ms(30); // > 26,3ms
wim 29:a3663151aa65 402 _writeCommand(0x55); // Icon off, Booster on, Set Contrast C5, C4
wim 29:a3663151aa65 403 wait_ms(30); // > 26,3ms
wim 29:a3663151aa65 404 _writeCommand(0x6D); // Voltagefollower On, Ampl ratio Rab2, Rab1, Rab0
wim 29:a3663151aa65 405 wait_ms(200); // > 200ms!
wim 29:a3663151aa65 406 _writeCommand(0x78); // Set Contrast C3, C2, C1, C0
wim 29:a3663151aa65 407 wait_ms(30); // > 26,3ms
wim 29:a3663151aa65 408 _writeCommand(0x28); // Return to Instruction Set = 0
wim 29:a3663151aa65 409 wait_ms(50);
wim 29:a3663151aa65 410 } // switch type
wim 29:a3663151aa65 411
wim 29:a3663151aa65 412 break; // case ST7036 Controller
wim 29:a3663151aa65 413
wim 30:033048611c01 414 case PCF2113_3V3:
wim 30:033048611c01 415 // PCF2113 controller: Initialise Voltage booster for VLCD. VDD=3V3
wim 30:033048611c01 416 // Note1: The PCF21XX family of controllers has several types that dont have an onboard voltage generator for V-LCD.
wim 30:033048611c01 417 // You must supply this LCD voltage externally and not enable VGen.
wim 30:033048611c01 418 // Note2: The early versions of PCF2116 controllers (eg PCF2116C) can not generate sufficiently negative voltage for the LCD at a VDD of 3V3.
wim 30:033048611c01 419 // You must supply this voltage externally and not enable VGen or you must use a higher VDD (e.g. 5V) and enable VGen.
wim 30:033048611c01 420 // More recent versions of the controller (eg PCF2116K) have an improved VGen that will work with 3V3.
wim 30:033048611c01 421 // Note3: See datasheet, members of the PCF21XX family support different numbers of rows/columns. Not all can support 3 or 4 rows.
wim 30:033048611c01 422 // Note4: See datasheet, you can also disable VGen by connecting Vo to VDD. VLCD will then be used directly as LCD voltage.
wim 30:033048611c01 423 // Note5: PCF2113 is different wrt to VLCD generator !
wim 30:033048611c01 424 // Note6: See datasheet, the PCF21XX-C and PCF21XX-K use a non-standard character set. This may result is strange text when not corrected..
wim 30:033048611c01 425
wim 29:a3663151aa65 426 // Initialise Display configuration
wim 29:a3663151aa65 427 switch (_type) {
wim 29:a3663151aa65 428 // case LCD12x1:
wim 29:a3663151aa65 429 case LCD24x1:
wim 30:033048611c01 430 _writeCommand(0x21); //FUNCTION SET 4 bit, M=0 1-line/24 chars display mode, extended IS
wim 30:033048611c01 431 //Note: 4 bit mode is ignored for I2C mode
wim 30:033048611c01 432 _writeCommand(0x9F); //Set VLCD A : VGen for Chars and Icons
wim 30:033048611c01 433 _writeCommand(0xDF); //Set VLCD B : VGen for Icons Only
wim 30:033048611c01 434 _writeCommand(0x20); //FUNCTION SET 4 bit, M=0 1-line/24 chars display mode
wim 30:033048611c01 435 // _writeCommand(0x24); //FUNCTION SET 4 bit, M=1 2-line/12 chars display mode, standard IS
wim 30:033048611c01 436
wim 30:033048611c01 437 wait_ms(10); // Wait 10ms to ensure powered up
wim 30:033048611c01 438 break;
wim 30:033048611c01 439
wim 30:033048611c01 440 //Tested OK for PCF2113
wim 30:033048611c01 441 //Note: PCF2113 is different wrt to VLCD generator !
wim 30:033048611c01 442 case LCD12x2:
wim 30:033048611c01 443 _writeCommand(0x21); //FUNCTION SET 4 bit, M=0 1-line/24 chars display mode, extended IS
wim 30:033048611c01 444 //Note: 4 bit mode is ignored for I2C mode
wim 30:033048611c01 445 _writeCommand(0x9F); //Set VLCD A : VGen for Chars and Icons
wim 30:033048611c01 446 _writeCommand(0xDF); //Set VLCD B : VGen for Icons Only
wim 30:033048611c01 447 // _writeCommand(0x20); //FUNCTION SET 4 bit, M=0 1-line/24 chars display mode
wim 30:033048611c01 448 _writeCommand(0x24); //FUNCTION SET 4 bit, M=1 2-line/12 chars display mode, standard IS
wim 30:033048611c01 449
wim 30:033048611c01 450 wait_ms(10); // Wait 10ms to ensure powered up
wim 30:033048611c01 451 break;
wim 30:033048611c01 452
wim 30:033048611c01 453 default:
wim 30:033048611c01 454 error("Error: LCD Controller type does not support this Display type\n\r");
wim 30:033048611c01 455 break;
wim 30:033048611c01 456
wim 30:033048611c01 457 } // switch type
wim 30:033048611c01 458
wim 30:033048611c01 459 break; // case PCF2113_3V3 Controller
wim 30:033048611c01 460
wim 30:033048611c01 461
wim 30:033048611c01 462
wim 30:033048611c01 463 case PCF2116_3V3:
wim 30:033048611c01 464 // PCF2116 controller: Initialise Voltage booster for VLCD. VDD=3V3
wim 30:033048611c01 465 // Note1: The PCF21XX family of controllers has several types that dont have an onboard voltage generator for V-LCD.
wim 30:033048611c01 466 // You must supply this LCD voltage externally and not enable VGen.
wim 30:033048611c01 467 // Note2: The early versions of PCF2116 controllers (eg PCF2116C) can not generate sufficiently negative voltage for the LCD at a VDD of 3V3.
wim 30:033048611c01 468 // You must supply this voltage externally and not enable VGen or you must use a higher VDD (e.g. 5V) and enable VGen.
wim 30:033048611c01 469 // More recent versions of the controller (eg PCF2116K) have an improved VGen that will work with 3V3.
wim 30:033048611c01 470 // Note3: See datasheet, members of the PCF21XX family support different numbers of rows/columns. Not all can support 3 or 4 rows.
wim 30:033048611c01 471 // Note4: See datasheet, you can also disable VGen by connecting Vo to VDD. VLCD will then be used directly as LCD voltage.
wim 30:033048611c01 472 // Note5: PCF2113 is different wrt to VLCD generator !
wim 30:033048611c01 473 // Note6: See datasheet, the PCF21XX-C and PCF21XX-K use a non-standard character set. This may result is strange text when not corrected..
wim 30:033048611c01 474
wim 30:033048611c01 475 // Initialise Display configuration
wim 30:033048611c01 476 switch (_type) {
wim 30:033048611c01 477 // case LCD12x1:
wim 30:033048611c01 478 // case LCD12x2:
wim 30:033048611c01 479 case LCD24x1:
wim 30:033048611c01 480 _writeCommand(0x22); //FUNCTION SET 4 bit, N=0/M=0 1-line/24 chars display mode, G=1 VGen on
wim 29:a3663151aa65 481 //Note: 4 bit mode is ignored for I2C mode
wim 29:a3663151aa65 482 wait_ms(10); // Wait 10ms to ensure powered up
wim 29:a3663151aa65 483 break;
wim 29:a3663151aa65 484
wim 30:033048611c01 485 case LCD12x3D:
wim 30:033048611c01 486 case LCD12x3D1:
wim 30:033048611c01 487 case LCD12x4D:
wim 30:033048611c01 488 _writeCommand(0x2E); //FUNCTION SET 4 bit, N=1/M=1 4-line/12 chars display mode, G=1 VGen on
wim 29:a3663151aa65 489 //Note: 4 bit mode is ignored for I2C mode
wim 29:a3663151aa65 490 wait_ms(10); // Wait 10ms to ensure powered up
wim 29:a3663151aa65 491 break;
wim 30:033048611c01 492
wim 30:033048611c01 493 case LCD24x2:
wim 30:033048611c01 494 _writeCommand(0x2A); //FUNCTION SET 4 bit, N=1/M=0 2-line/24 chars display mode, G=1 VGen on
wim 29:a3663151aa65 495 //Note: 4 bit mode is ignored for I2C mode
wim 30:033048611c01 496 wait_ms(10); // Wait 10ms to ensure powered up
wim 29:a3663151aa65 497
wim 30:033048611c01 498 default:
wim 30:033048611c01 499 error("Error: LCD Controller type does not support this Display type\n\r");
wim 30:033048611c01 500 break;
wim 30:033048611c01 501
wim 29:a3663151aa65 502 } // switch type
wim 29:a3663151aa65 503
wim 30:033048611c01 504 break; // case PCF2116_3V3 Controller
wim 29:a3663151aa65 505
wim 29:a3663151aa65 506 // case PCF21XX_5V:
wim 30:033048611c01 507 // PCF21XX controller: No Voltage generator for VLCD. VDD=5V
wim 30:033048611c01 508 //@TODO
wim 29:a3663151aa65 509
wim 19:c747b9e2e7b8 510 case WS0010:
wim 19:c747b9e2e7b8 511 // WS0010 OLED controller: Initialise DC/DC Voltage converter for LEDs
wim 30:033048611c01 512 // Note1: Identical to RS0010
wim 30:033048611c01 513 // Note2: supports 1 or 2 lines (and 16x100 graphics)
wim 30:033048611c01 514 // supports 4 fonts (English/Japanese (default), Western European-I, English/Russian, Western European-II)
wim 19:c747b9e2e7b8 515 // Cursor/Disp shift set 0001 SC RL 0 0
wim 19:c747b9e2e7b8 516 //
wim 30:033048611c01 517 // Mode and Power set 0001 GC PWR 1 1
wim 19:c747b9e2e7b8 518 // GC = 0 (Graph Mode=1, Char Mode=0)
wim 30:033048611c01 519 // PWR = 1 (DC/DC On/Off)
wim 30:033048611c01 520
wim 30:033048611c01 521 //@Todo: This may be needed to enable a warm reboot
wim 25:6162b31128c9 522 //_writeCommand(0x13); // DC/DC off
wim 30:033048611c01 523 //wait_ms(10); // Wait 10ms to ensure powered down
wim 28:30fa94f7341c 524 _writeCommand(0x17); // DC/DC on
wim 30:033048611c01 525 wait_ms(10); // Wait 10ms to ensure powered up
wim 29:a3663151aa65 526
wim 29:a3663151aa65 527 // Initialise Display configuration
wim 29:a3663151aa65 528 switch (_type) {
wim 29:a3663151aa65 529 case LCD8x1: //8x1 is a regular 1 line display
wim 29:a3663151aa65 530 case LCD8x2B: //8x2B is a special case of 16x1
wim 29:a3663151aa65 531 // case LCD12x1:
wim 29:a3663151aa65 532 case LCD16x1:
wim 30:033048611c01 533 case LCD24x1:
wim 30:033048611c01 534 _writeCommand(0x20); // Function set 001 DL N F FT1 FT0
wim 30:033048611c01 535 // DL=0 (4 bits bus)
wim 30:033048611c01 536 // N=0 (1 line)
wim 30:033048611c01 537 // F=0 (5x7 dots font)
wim 30:033048611c01 538 // FT=00 (00 = Engl/Jap, 01 = WestEur1, 10 = Engl/Russian, 11 = WestEur2
wim 30:033048611c01 539 break;
wim 30:033048611c01 540
wim 30:033048611c01 541 case LCD12x3D: // Special mode for PCF2116
wim 30:033048611c01 542 case LCD12x3D1: // Special mode for PCF2116
wim 30:033048611c01 543 case LCD12x4D: // Special mode for PCF2116
wim 30:033048611c01 544 case LCD24x4D: // Special mode for KS0078
wim 30:033048611c01 545 error("Error: LCD Controller type does not support this Display type\n\r");
wim 29:a3663151aa65 546 break;
wim 29:a3663151aa65 547
wim 29:a3663151aa65 548 default:
wim 30:033048611c01 549 // All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
wim 30:033048611c01 550 _writeCommand(0x28); // Function set 001 DL N F FT1 FT0
wim 30:033048611c01 551 // DL=0 (4 bits bus)
wim 30:033048611c01 552 // N=1 (2 lines)
wim 30:033048611c01 553 // F=0 (5x7 dots font)
wim 30:033048611c01 554 // FT=00 (00 = Engl/Jap, 01 = WestEur1, 10 = Engl/Russian, 11 = WestEur2
wim 30:033048611c01 555
wim 30:033048611c01 556
wim 29:a3663151aa65 557 break;
wim 29:a3663151aa65 558 } // switch type
wim 29:a3663151aa65 559
wim 29:a3663151aa65 560 break; // case WS0100 Controller
wim 29:a3663151aa65 561
wim 19:c747b9e2e7b8 562 default:
wim 29:a3663151aa65 563 // Devices fully compatible to HD44780 that do not use any DC/DC Voltage converters but external VLCD
wim 10:dd9b3a696acd 564
wim 29:a3663151aa65 565 // Initialise Display configuration
wim 29:a3663151aa65 566 switch (_type) {
wim 29:a3663151aa65 567 case LCD8x1: //8x1 is a regular 1 line display
wim 29:a3663151aa65 568 case LCD8x2B: //8x2B is a special case of 16x1
wim 29:a3663151aa65 569 // case LCD12x1:
wim 29:a3663151aa65 570 case LCD16x1:
wim 30:033048611c01 571 // case LCD20x1:
wim 29:a3663151aa65 572 case LCD24x1:
wim 30:033048611c01 573 // case LCD40x1:
wim 29:a3663151aa65 574 _writeCommand(0x20); // Function set 001 DL N F - -
wim 29:a3663151aa65 575 // DL=0 (4 bits bus)
wim 29:a3663151aa65 576 // N=0 (1 line)
wim 29:a3663151aa65 577 // F=0 (5x7 dots font)
wim 29:a3663151aa65 578 break;
wim 29:a3663151aa65 579
wim 30:033048611c01 580
wim 30:033048611c01 581 // case LCD12x3D: // Special mode for PCF2116
wim 30:033048611c01 582 // case LCD12x3D1: // Special mode for PCF2116
wim 30:033048611c01 583 // case LCD12x4D: // Special mode for PCF2116
wim 30:033048611c01 584 // case LCD24x3D: // Special mode for KS0078
wim 30:033048611c01 585 case LCD24x4D: // Special mode for KS0078
wim 30:033048611c01 586 error("Error: LCD Controller type does not support this Display type\n\r");
wim 30:033048611c01 587 break;
wim 30:033048611c01 588
wim 30:033048611c01 589 // All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
wim 29:a3663151aa65 590 default:
wim 29:a3663151aa65 591 _writeCommand(0x28); // Function set 001 DL N F - -
wim 29:a3663151aa65 592 // DL=0 (4 bits bus)
wim 29:a3663151aa65 593 // Note: 4 bit mode is ignored for native SPI and I2C devices
wim 29:a3663151aa65 594 // N=1 (2 lines)
wim 29:a3663151aa65 595 // F=0 (5x7 dots font, only option for 2 line display)
wim 29:a3663151aa65 596 // - (Don't care)
wim 29:a3663151aa65 597
wim 29:a3663151aa65 598 break;
wim 29:a3663151aa65 599 } // switch type
wim 10:dd9b3a696acd 600
wim 29:a3663151aa65 601 break; // case default Controller
wim 29:a3663151aa65 602
wim 29:a3663151aa65 603 } // switch Controller specific initialisations
wim 29:a3663151aa65 604
wim 10:dd9b3a696acd 605
wim 30:033048611c01 606 // Controller general initialisations
wim 28:30fa94f7341c 607 _writeCommand(0x01); // cls, and set cursor to 0
wim 28:30fa94f7341c 608 wait_ms(10); // The CLS command takes 1.64 ms.
wim 28:30fa94f7341c 609 // Since we are not using the Busy flag, Lets be safe and take 10 ms
wim 28:30fa94f7341c 610
wim 28:30fa94f7341c 611 _writeCommand(0x02); // Return Home
wim 28:30fa94f7341c 612 // Cursor Home, DDRAM Address to Origin
wim 28:30fa94f7341c 613
wim 28:30fa94f7341c 614 _writeCommand(0x06); // Entry Mode 0000 0 1 I/D S
wim 13:24506ba22480 615 // Cursor Direction and Display Shift
wim 28:30fa94f7341c 616 // I/D=1 (Cur incr)
wim 28:30fa94f7341c 617 // S=0 (No display shift)
wim 10:dd9b3a696acd 618
wim 29:a3663151aa65 619 _writeCommand(0x14); // Cursor or Display shift 0001 S/C R/L x x
wim 29:a3663151aa65 620 // S/C=0 Cursor moves
wim 29:a3663151aa65 621 // R/L=1 Right
wim 29:a3663151aa65 622 //
wim 29:a3663151aa65 623
wim 13:24506ba22480 624 // _writeCommand(0x0C); // Display Ctrl 0000 1 D C B
wim 17:652ab113bc2e 625 // // Display On, Cursor Off, Blink Off
wim 21:9eb628d9e164 626 setCursor(CurOff_BlkOff);
wim 21:9eb628d9e164 627 setMode(DispOn);
simon 1:ac48b187213c 628 }
simon 1:ac48b187213c 629
wim 8:03116f75b66e 630
wim 21:9eb628d9e164 631 /** Clear the screen, Cursor home.
wim 21:9eb628d9e164 632 */
wim 21:9eb628d9e164 633 void TextLCD_Base::cls() {
wim 15:b70ebfffb258 634
wim 15:b70ebfffb258 635 // Select and configure second LCD controller when needed
wim 15:b70ebfffb258 636 if(_type==LCD40x4) {
wim 21:9eb628d9e164 637 _ctrl_idx=_LCDCtrl_1; // Select 2nd controller
wim 15:b70ebfffb258 638
wim 15:b70ebfffb258 639 // Second LCD controller Cursor always Off
wim 21:9eb628d9e164 640 _setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
wim 15:b70ebfffb258 641
wim 15:b70ebfffb258 642 // Second LCD controller Clearscreen
wim 27:22d5086f6ba6 643 _writeCommand(0x01); // cls, and set cursor to 0
wim 29:a3663151aa65 644 wait_ms(10); // The CLS command takes 1.64 ms.
wim 29:a3663151aa65 645 // Since we are not using the Busy flag, Lets be safe and take 10 ms
wim 15:b70ebfffb258 646
wim 21:9eb628d9e164 647 _ctrl_idx=_LCDCtrl_0; // Select primary controller
wim 15:b70ebfffb258 648 }
wim 15:b70ebfffb258 649
wim 15:b70ebfffb258 650 // Primary LCD controller Clearscreen
wim 27:22d5086f6ba6 651 _writeCommand(0x01); // cls, and set cursor to 0
wim 29:a3663151aa65 652 wait_ms(10); // The CLS command takes 1.64 ms.
wim 29:a3663151aa65 653 // Since we are not using the Busy flag, Lets be safe and take 10 ms
wim 15:b70ebfffb258 654
wim 15:b70ebfffb258 655 // Restore cursormode on primary LCD controller when needed
wim 15:b70ebfffb258 656 if(_type==LCD40x4) {
wim 17:652ab113bc2e 657 _setCursorAndDisplayMode(_currentMode,_currentCursor);
wim 15:b70ebfffb258 658 }
wim 15:b70ebfffb258 659
wim 29:a3663151aa65 660 setAddress(0, 0); // Reset Cursor location
wim 30:033048611c01 661 // Note: this is needed because some displays (eg PCF21XX) don't use line 0 in the '3 Line' mode.
simon 1:ac48b187213c 662 }
simon 1:ac48b187213c 663
wim 29:a3663151aa65 664 /** Locate cursor to a screen column and row
wim 29:a3663151aa65 665 *
wim 29:a3663151aa65 666 * @param column The horizontal position from the left, indexed from 0
wim 29:a3663151aa65 667 * @param row The vertical position from the top, indexed from 0
wim 29:a3663151aa65 668 */
wim 21:9eb628d9e164 669 void TextLCD_Base::locate(int column, int row) {
wim 15:b70ebfffb258 670
wim 15:b70ebfffb258 671 // setAddress() does all the heavy lifting:
wim 15:b70ebfffb258 672 // check column and row sanity,
wim 15:b70ebfffb258 673 // switch controllers for LCD40x4 if needed
wim 15:b70ebfffb258 674 // switch cursor for LCD40x4 if needed
wim 15:b70ebfffb258 675 // set the new memory address to show cursor at correct location
wim 15:b70ebfffb258 676 setAddress(column, row);
wim 15:b70ebfffb258 677
wim 15:b70ebfffb258 678 }
wim 30:033048611c01 679
wim 15:b70ebfffb258 680
wim 21:9eb628d9e164 681 /** Write a single character (Stream implementation)
wim 21:9eb628d9e164 682 */
wim 21:9eb628d9e164 683 int TextLCD_Base::_putc(int value) {
wim 15:b70ebfffb258 684 int addr;
wim 15:b70ebfffb258 685
wim 15:b70ebfffb258 686 if (value == '\n') {
wim 15:b70ebfffb258 687 //No character to write
wim 15:b70ebfffb258 688
wim 15:b70ebfffb258 689 //Update Cursor
wim 15:b70ebfffb258 690 _column = 0;
wim 15:b70ebfffb258 691 _row++;
wim 15:b70ebfffb258 692 if (_row >= rows()) {
wim 15:b70ebfffb258 693 _row = 0;
wim 15:b70ebfffb258 694 }
wim 15:b70ebfffb258 695 }
wim 15:b70ebfffb258 696 else {
wim 15:b70ebfffb258 697 //Character to write
wim 15:b70ebfffb258 698 _writeData(value);
wim 15:b70ebfffb258 699
wim 15:b70ebfffb258 700 //Update Cursor
wim 15:b70ebfffb258 701 _column++;
wim 15:b70ebfffb258 702 if (_column >= columns()) {
wim 15:b70ebfffb258 703 _column = 0;
wim 15:b70ebfffb258 704 _row++;
wim 15:b70ebfffb258 705 if (_row >= rows()) {
wim 15:b70ebfffb258 706 _row = 0;
wim 15:b70ebfffb258 707 }
wim 15:b70ebfffb258 708 }
wim 15:b70ebfffb258 709 } //else
wim 15:b70ebfffb258 710
wim 15:b70ebfffb258 711 //Set next memoryaddress, make sure cursor blinks at next location
wim 15:b70ebfffb258 712 addr = getAddress(_column, _row);
wim 15:b70ebfffb258 713 _writeCommand(0x80 | addr);
wim 15:b70ebfffb258 714
wim 15:b70ebfffb258 715 return value;
wim 15:b70ebfffb258 716 }
wim 15:b70ebfffb258 717
wim 15:b70ebfffb258 718
wim 16:c276b75e6585 719 // get a single character (Stream implementation)
wim 21:9eb628d9e164 720 int TextLCD_Base::_getc() {
simon 1:ac48b187213c 721 return -1;
simon 1:ac48b187213c 722 }
simon 1:ac48b187213c 723
wim 14:0c32b66b14b8 724
wim 17:652ab113bc2e 725 // Write a nibble using the 4-bit interface
wim 21:9eb628d9e164 726 void TextLCD_Base::_writeNibble(int value) {
wim 17:652ab113bc2e 727
wim 17:652ab113bc2e 728 // Enable is Low
wim 21:9eb628d9e164 729 this->_setEnable(true);
wim 21:9eb628d9e164 730 this->_setData(value & 0x0F); // Low nibble
wim 17:652ab113bc2e 731 wait_us(1); // Data setup time
wim 21:9eb628d9e164 732 this->_setEnable(false);
wim 17:652ab113bc2e 733 wait_us(1); // Datahold time
wim 17:652ab113bc2e 734
wim 17:652ab113bc2e 735 // Enable is Low
wim 17:652ab113bc2e 736 }
wim 17:652ab113bc2e 737
wim 17:652ab113bc2e 738
wim 16:c276b75e6585 739 // Write a byte using the 4-bit interface
wim 21:9eb628d9e164 740 void TextLCD_Base::_writeByte(int value) {
wim 15:b70ebfffb258 741
wim 15:b70ebfffb258 742 // Enable is Low
wim 21:9eb628d9e164 743 this->_setEnable(true);
wim 21:9eb628d9e164 744 this->_setData(value >> 4); // High nibble
wim 15:b70ebfffb258 745 wait_us(1); // Data setup time
wim 21:9eb628d9e164 746 this->_setEnable(false);
wim 15:b70ebfffb258 747 wait_us(1); // Data hold time
wim 15:b70ebfffb258 748
wim 21:9eb628d9e164 749 this->_setEnable(true);
wim 21:9eb628d9e164 750 this->_setData(value >> 0); // Low nibble
wim 15:b70ebfffb258 751 wait_us(1); // Data setup time
wim 21:9eb628d9e164 752 this->_setEnable(false);
wim 15:b70ebfffb258 753 wait_us(1); // Datahold time
wim 15:b70ebfffb258 754
wim 15:b70ebfffb258 755 // Enable is Low
wim 15:b70ebfffb258 756
simon 1:ac48b187213c 757 }
simon 1:ac48b187213c 758
wim 21:9eb628d9e164 759 // Write a command byte to the LCD controller
wim 21:9eb628d9e164 760 void TextLCD_Base::_writeCommand(int command) {
wim 15:b70ebfffb258 761
wim 21:9eb628d9e164 762 this->_setRS(false);
wim 16:c276b75e6585 763 wait_us(1); // Data setup time for RS
wim 15:b70ebfffb258 764
wim 21:9eb628d9e164 765 this->_writeByte(command);
wim 15:b70ebfffb258 766 wait_us(40); // most instructions take 40us
simon 1:ac48b187213c 767 }
simon 1:ac48b187213c 768
wim 21:9eb628d9e164 769 // Write a data byte to the LCD controller
wim 21:9eb628d9e164 770 void TextLCD_Base::_writeData(int data) {
wim 15:b70ebfffb258 771
wim 21:9eb628d9e164 772 this->_setRS(true);
wim 16:c276b75e6585 773 wait_us(1); // Data setup time for RS
wim 15:b70ebfffb258 774
wim 21:9eb628d9e164 775 this->_writeByte(data);
wim 15:b70ebfffb258 776 wait_us(40); // data writes take 40us
simon 1:ac48b187213c 777 }
simon 1:ac48b187213c 778
wim 8:03116f75b66e 779
wim 8:03116f75b66e 780 #if (0)
wim 16:c276b75e6585 781 // This is the original _address() method.
wim 8:03116f75b66e 782 // It is confusing since it returns the memoryaddress or-ed with the set memorycommand 0x80.
wim 8:03116f75b66e 783 // Left it in here for compatibility with older code. New applications should use getAddress() instead.
wim 8:03116f75b66e 784 //
wim 21:9eb628d9e164 785 int TextLCD_Base::_address(int column, int row) {
simon 1:ac48b187213c 786 switch (_type) {
simon 1:ac48b187213c 787 case LCD20x4:
simon 1:ac48b187213c 788 switch (row) {
simon 1:ac48b187213c 789 case 0:
simon 1:ac48b187213c 790 return 0x80 + column;
simon 1:ac48b187213c 791 case 1:
simon 1:ac48b187213c 792 return 0xc0 + column;
simon 1:ac48b187213c 793 case 2:
simon 1:ac48b187213c 794 return 0x94 + column;
simon 1:ac48b187213c 795 case 3:
simon 1:ac48b187213c 796 return 0xd4 + column;
simon 1:ac48b187213c 797 }
simon 1:ac48b187213c 798 case LCD16x2B:
simon 4:bf5b706f8d32 799 return 0x80 + (row * 40) + column;
simon 1:ac48b187213c 800 case LCD16x2:
simon 1:ac48b187213c 801 case LCD20x2:
simon 1:ac48b187213c 802 default:
simon 4:bf5b706f8d32 803 return 0x80 + (row * 0x40) + column;
simon 1:ac48b187213c 804 }
simon 1:ac48b187213c 805 }
wim 8:03116f75b66e 806 #endif
wim 8:03116f75b66e 807
wim 8:03116f75b66e 808
wim 16:c276b75e6585 809 // This replaces the original _address() method.
wim 8:03116f75b66e 810 // Left it in here for compatibility with older code. New applications should use getAddress() instead.
wim 21:9eb628d9e164 811 int TextLCD_Base::_address(int column, int row) {
wim 8:03116f75b66e 812 return 0x80 | getAddress(column, row);
wim 8:03116f75b66e 813 }
wim 8:03116f75b66e 814
wim 30:033048611c01 815 #if(0)
wim 8:03116f75b66e 816 // This is new method to return the memory address based on row, column and displaytype.
wim 8:03116f75b66e 817 //
wim 29:a3663151aa65 818 /** Return the memoryaddress of screen column and row location
wim 29:a3663151aa65 819 *
wim 29:a3663151aa65 820 * @param column The horizontal position from the left, indexed from 0
wim 29:a3663151aa65 821 * @param row The vertical position from the top, indexed from 0
wim 29:a3663151aa65 822 * @param return The memoryaddress of screen column and row location
wim 30:033048611c01 823 *
wim 30:033048611c01 824 * Note: some configurations are commented out because they have not yet been tested due to lack of hardware
wim 29:a3663151aa65 825 */
wim 21:9eb628d9e164 826 int TextLCD_Base::getAddress(int column, int row) {
wim 8:03116f75b66e 827
wim 8:03116f75b66e 828 switch (_type) {
wim 8:03116f75b66e 829 case LCD8x1:
wim 30:033048611c01 830 // case LCD12x1:
wim 30:033048611c01 831 // case LCD16x1B:
wim 30:033048611c01 832 // case LCD20x1:
wim 30:033048611c01 833 case LCD24x1:
wim 30:033048611c01 834 // case LCD40x1:
wim 8:03116f75b66e 835 return 0x00 + column;
wim 18:bd65dc10f27f 836
wim 29:a3663151aa65 837 case LCD16x1:
wim 29:a3663151aa65 838 // LCD16x1 is a special layout of LCD8x2
wim 29:a3663151aa65 839 if (column<8)
wim 29:a3663151aa65 840 return 0x00 + column;
wim 29:a3663151aa65 841 else
wim 29:a3663151aa65 842 return 0x40 + (column - 8);
wim 29:a3663151aa65 843
wim 30:033048611c01 844 case LCD8x2D:
wim 18:bd65dc10f27f 845 // LCD8x2B is a special layout of LCD16x1
wim 18:bd65dc10f27f 846 if (row==0)
wim 18:bd65dc10f27f 847 return 0x00 + column;
wim 18:bd65dc10f27f 848 else
wim 18:bd65dc10f27f 849 return 0x08 + column;
wim 18:bd65dc10f27f 850
wim 29:a3663151aa65 851 case LCD8x2:
wim 29:a3663151aa65 852 case LCD12x2:
wim 29:a3663151aa65 853 case LCD16x2:
wim 29:a3663151aa65 854 case LCD20x2:
wim 29:a3663151aa65 855 case LCD24x2:
wim 29:a3663151aa65 856 case LCD40x2:
wim 29:a3663151aa65 857 return 0x00 + (row * 0x40) + column;
wim 13:24506ba22480 858
wim 29:a3663151aa65 859 // Not sure about this one, seems wrong.
wim 29:a3663151aa65 860 // Left in for compatibility with original library
wim 29:a3663151aa65 861 case LCD16x2B:
wim 29:a3663151aa65 862 return 0x00 + (row * 40) + column;
wim 29:a3663151aa65 863
wim 29:a3663151aa65 864
wim 28:30fa94f7341c 865 // Special mode for ST7036
wim 28:30fa94f7341c 866 // case LCD16x3:
wim 28:30fa94f7341c 867
wim 29:a3663151aa65 868 // Special mode for PCF2116
wim 29:a3663151aa65 869 case LCD12x3B:
wim 30:033048611c01 870 //Display bottom three rows of four
wim 29:a3663151aa65 871 switch (row) {
wim 29:a3663151aa65 872 case 0:
wim 29:a3663151aa65 873 return 0x20 + column;
wim 29:a3663151aa65 874 case 1:
wim 29:a3663151aa65 875 return 0x40 + column;
wim 29:a3663151aa65 876 case 2:
wim 29:a3663151aa65 877 return 0x60 + column;
wim 29:a3663151aa65 878 }
wim 29:a3663151aa65 879
wim 30:033048611c01 880 #if(0)
wim 30:033048611c01 881 case LCD12x3C:
wim 30:033048611c01 882 //Display top three rows of four
wim 30:033048611c01 883 switch (row) {
wim 30:033048611c01 884 case 0:
wim 30:033048611c01 885 return 0x00 + column;
wim 30:033048611c01 886 case 1:
wim 30:033048611c01 887 return 0x20 + column;
wim 30:033048611c01 888 case 2:
wim 30:033048611c01 889 return 0x40 + column;
wim 30:033048611c01 890 }
wim 30:033048611c01 891 #endif
wim 30:033048611c01 892
wim 29:a3663151aa65 893 case LCD12x4:
wim 28:30fa94f7341c 894 switch (row) {
wim 28:30fa94f7341c 895 case 0:
wim 28:30fa94f7341c 896 return 0x00 + column;
wim 28:30fa94f7341c 897 case 1:
wim 29:a3663151aa65 898 return 0x40 + column;
wim 28:30fa94f7341c 899 case 2:
wim 29:a3663151aa65 900 return 0x0C + column;
wim 29:a3663151aa65 901 case 3:
wim 29:a3663151aa65 902 return 0x4C + column;
wim 28:30fa94f7341c 903 }
wim 28:30fa94f7341c 904
wim 28:30fa94f7341c 905 // Special mode for PCF2116 (and KS0078)
wim 28:30fa94f7341c 906 case LCD12x4B:
wim 28:30fa94f7341c 907 switch (row) {
wim 28:30fa94f7341c 908 case 0:
wim 28:30fa94f7341c 909 return 0x00 + column;
wim 28:30fa94f7341c 910 case 1:
wim 28:30fa94f7341c 911 return 0x20 + column;
wim 28:30fa94f7341c 912 case 2:
wim 28:30fa94f7341c 913 return 0x40 + column;
wim 28:30fa94f7341c 914 case 3:
wim 28:30fa94f7341c 915 return 0x60 + column;
wim 28:30fa94f7341c 916 }
wim 28:30fa94f7341c 917
wim 8:03116f75b66e 918 case LCD16x4:
wim 8:03116f75b66e 919 switch (row) {
wim 8:03116f75b66e 920 case 0:
wim 8:03116f75b66e 921 return 0x00 + column;
wim 8:03116f75b66e 922 case 1:
wim 8:03116f75b66e 923 return 0x40 + column;
wim 8:03116f75b66e 924 case 2:
wim 8:03116f75b66e 925 return 0x10 + column;
wim 8:03116f75b66e 926 case 3:
wim 8:03116f75b66e 927 return 0x50 + column;
wim 8:03116f75b66e 928 }
wim 8:03116f75b66e 929
wim 8:03116f75b66e 930 case LCD20x4:
wim 8:03116f75b66e 931 switch (row) {
wim 8:03116f75b66e 932 case 0:
wim 8:03116f75b66e 933 return 0x00 + column;
wim 8:03116f75b66e 934 case 1:
wim 8:03116f75b66e 935 return 0x40 + column;
wim 8:03116f75b66e 936 case 2:
wim 8:03116f75b66e 937 return 0x14 + column;
wim 8:03116f75b66e 938 case 3:
wim 8:03116f75b66e 939 return 0x54 + column;
wim 8:03116f75b66e 940 }
wim 8:03116f75b66e 941
wim 10:dd9b3a696acd 942 // Special mode for KS0078
wim 29:a3663151aa65 943 case LCD24x4B:
wim 10:dd9b3a696acd 944 switch (row) {
wim 10:dd9b3a696acd 945 case 0:
wim 10:dd9b3a696acd 946 return 0x00 + column;
wim 10:dd9b3a696acd 947 case 1:
wim 10:dd9b3a696acd 948 return 0x20 + column;
wim 10:dd9b3a696acd 949 case 2:
wim 10:dd9b3a696acd 950 return 0x40 + column;
wim 10:dd9b3a696acd 951 case 3:
wim 10:dd9b3a696acd 952 return 0x60 + column;
wim 10:dd9b3a696acd 953 }
wim 10:dd9b3a696acd 954
wim 15:b70ebfffb258 955 case LCD40x4:
wim 15:b70ebfffb258 956 // LCD40x4 is a special case since it has 2 controllers
wim 15:b70ebfffb258 957 // Each controller is configured as 40x2
wim 15:b70ebfffb258 958 if (row<2) {
wim 15:b70ebfffb258 959 // Test to see if we need to switch between controllers
wim 19:c747b9e2e7b8 960 if (_ctrl_idx != _LCDCtrl_0) {
wim 17:652ab113bc2e 961
wim 15:b70ebfffb258 962 // Second LCD controller Cursor Off
wim 21:9eb628d9e164 963 _setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
wim 15:b70ebfffb258 964
wim 15:b70ebfffb258 965 // Select primary controller
wim 19:c747b9e2e7b8 966 _ctrl_idx = _LCDCtrl_0;
wim 15:b70ebfffb258 967
wim 15:b70ebfffb258 968 // Restore cursormode on primary LCD controller
wim 17:652ab113bc2e 969 _setCursorAndDisplayMode(_currentMode, _currentCursor);
wim 15:b70ebfffb258 970 }
wim 15:b70ebfffb258 971
wim 15:b70ebfffb258 972 return 0x00 + (row * 0x40) + column;
wim 15:b70ebfffb258 973 }
wim 15:b70ebfffb258 974 else {
wim 15:b70ebfffb258 975
wim 15:b70ebfffb258 976 // Test to see if we need to switch between controllers
wim 19:c747b9e2e7b8 977 if (_ctrl_idx != _LCDCtrl_1) {
wim 15:b70ebfffb258 978 // Primary LCD controller Cursor Off
wim 21:9eb628d9e164 979 _setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
wim 15:b70ebfffb258 980
wim 15:b70ebfffb258 981 // Select secondary controller
wim 19:c747b9e2e7b8 982 _ctrl_idx = _LCDCtrl_1;
wim 15:b70ebfffb258 983
wim 15:b70ebfffb258 984 // Restore cursormode on secondary LCD controller
wim 17:652ab113bc2e 985 _setCursorAndDisplayMode(_currentMode, _currentCursor);
wim 15:b70ebfffb258 986 }
wim 15:b70ebfffb258 987
wim 15:b70ebfffb258 988 return 0x00 + ((row-2) * 0x40) + column;
wim 15:b70ebfffb258 989 }
wim 8:03116f75b66e 990
wim 8:03116f75b66e 991 // Should never get here.
wim 8:03116f75b66e 992 default:
wim 8:03116f75b66e 993 return 0x00;
wim 8:03116f75b66e 994 }
wim 8:03116f75b66e 995 }
wim 8:03116f75b66e 996
wim 30:033048611c01 997 #else
wim 30:033048611c01 998
wim 30:033048611c01 999 //Test of Addressing Mode encoded in LCDType
wim 30:033048611c01 1000
wim 30:033048611c01 1001 // This is new method to return the memory address based on row, column and displaytype.
wim 30:033048611c01 1002 //
wim 30:033048611c01 1003 /** Return the memoryaddress of screen column and row location
wim 30:033048611c01 1004 *
wim 30:033048611c01 1005 * @param column The horizontal position from the left, indexed from 0
wim 30:033048611c01 1006 * @param row The vertical position from the top, indexed from 0
wim 30:033048611c01 1007 * @param return The memoryaddress of screen column and row location
wim 30:033048611c01 1008 *
wim 30:033048611c01 1009 * Note: some configurations are commented out because they have not yet been tested due to lack of hardware
wim 30:033048611c01 1010 */
wim 30:033048611c01 1011 int TextLCD_Base::getAddress(int column, int row) {
wim 30:033048611c01 1012
wim 30:033048611c01 1013 switch (_addr_mode) {
wim 30:033048611c01 1014
wim 30:033048611c01 1015 case LCD_T_A:
wim 30:033048611c01 1016 //Default addressing mode for 1, 2 and 4 rows (except 40x4)
wim 30:033048611c01 1017 //The two available rows are split and stacked on top of eachother. Addressing for 3rd and 4th line continues where lines 1 and 2 were split.
wim 30:033048611c01 1018 //Displays top rows when less than four are used.
wim 30:033048611c01 1019 switch (row) {
wim 30:033048611c01 1020 case 0:
wim 30:033048611c01 1021 return 0x00 + column;
wim 30:033048611c01 1022 case 1:
wim 30:033048611c01 1023 return 0x40 + column;
wim 30:033048611c01 1024 case 2:
wim 30:033048611c01 1025 return 0x00 + _nr_cols + column;
wim 30:033048611c01 1026 case 3:
wim 30:033048611c01 1027 return 0x40 + _nr_cols + column;
wim 30:033048611c01 1028 // Should never get here.
wim 30:033048611c01 1029 default:
wim 30:033048611c01 1030 return 0x00;
wim 30:033048611c01 1031 }
wim 30:033048611c01 1032
wim 30:033048611c01 1033 case LCD_T_B:
wim 30:033048611c01 1034 // LCD8x2B is a special layout of LCD16x1
wim 30:033048611c01 1035 if (row==0)
wim 30:033048611c01 1036 return 0x00 + column;
wim 30:033048611c01 1037 else
wim 30:033048611c01 1038 // return _nr_cols + column;
wim 30:033048611c01 1039 return 0x08 + column;
wim 30:033048611c01 1040
wim 30:033048611c01 1041 case LCD_T_C:
wim 30:033048611c01 1042 // LCD16x1C is a special layout of LCD8x2
wim 30:033048611c01 1043 if (column<8)
wim 30:033048611c01 1044 return 0x00 + column;
wim 30:033048611c01 1045 else
wim 30:033048611c01 1046 return 0x40 + (column - 8);
wim 30:033048611c01 1047
wim 30:033048611c01 1048 // Not sure about this one, seems wrong.
wim 30:033048611c01 1049 // Left in for compatibility with original library
wim 30:033048611c01 1050 // case LCD16x2B:
wim 30:033048611c01 1051 // return 0x00 + (row * 40) + column;
wim 30:033048611c01 1052
wim 30:033048611c01 1053
wim 30:033048611c01 1054 case LCD_T_D:
wim 30:033048611c01 1055 //Alternate addressing mode for 3 and 4 row displays (except 40x4). Used by PCF21XX, KS0078
wim 30:033048611c01 1056 //The 4 available rows start at a hardcoded address.
wim 30:033048611c01 1057 //Displays top rows when less than four are used.
wim 30:033048611c01 1058 switch (row) {
wim 30:033048611c01 1059 case 0:
wim 30:033048611c01 1060 return 0x00 + column;
wim 30:033048611c01 1061 case 1:
wim 30:033048611c01 1062 return 0x20 + column;
wim 30:033048611c01 1063 case 2:
wim 30:033048611c01 1064 return 0x40 + column;
wim 30:033048611c01 1065 case 3:
wim 30:033048611c01 1066 return 0x60 + column;
wim 30:033048611c01 1067 // Should never get here.
wim 30:033048611c01 1068 default:
wim 30:033048611c01 1069 return 0x00;
wim 30:033048611c01 1070 }
wim 30:033048611c01 1071
wim 30:033048611c01 1072 case LCD_T_D1:
wim 30:033048611c01 1073 //Alternate addressing mode for 3 row displays. Used by PCF21XX, KS0078
wim 30:033048611c01 1074 //The 4 available rows start at a hardcoded address.
wim 30:033048611c01 1075 //Skips top row of 4 row display and starts display at row 1
wim 30:033048611c01 1076 switch (row) {
wim 30:033048611c01 1077 case 0:
wim 30:033048611c01 1078 return 0x20 + column;
wim 30:033048611c01 1079 case 1:
wim 30:033048611c01 1080 return 0x40 + column;
wim 30:033048611c01 1081 case 2:
wim 30:033048611c01 1082 return 0x60 + column;
wim 30:033048611c01 1083 // Should never get here.
wim 30:033048611c01 1084 default:
wim 30:033048611c01 1085 return 0x00;
wim 30:033048611c01 1086 }
wim 30:033048611c01 1087
wim 30:033048611c01 1088 case LCD_T_E:
wim 30:033048611c01 1089 // LCD40x4 is a special case since it has 2 controllers.
wim 30:033048611c01 1090 // Each controller is configured as 40x2 (Type A)
wim 30:033048611c01 1091 if (row<2) {
wim 30:033048611c01 1092 // Test to see if we need to switch between controllers
wim 30:033048611c01 1093 if (_ctrl_idx != _LCDCtrl_0) {
wim 30:033048611c01 1094
wim 30:033048611c01 1095 // Second LCD controller Cursor Off
wim 30:033048611c01 1096 _setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
wim 30:033048611c01 1097
wim 30:033048611c01 1098 // Select primary controller
wim 30:033048611c01 1099 _ctrl_idx = _LCDCtrl_0;
wim 30:033048611c01 1100
wim 30:033048611c01 1101 // Restore cursormode on primary LCD controller
wim 30:033048611c01 1102 _setCursorAndDisplayMode(_currentMode, _currentCursor);
wim 30:033048611c01 1103 }
wim 30:033048611c01 1104
wim 30:033048611c01 1105 return 0x00 + (row * 0x40) + column;
wim 30:033048611c01 1106 }
wim 30:033048611c01 1107 else {
wim 30:033048611c01 1108
wim 30:033048611c01 1109 // Test to see if we need to switch between controllers
wim 30:033048611c01 1110 if (_ctrl_idx != _LCDCtrl_1) {
wim 30:033048611c01 1111 // Primary LCD controller Cursor Off
wim 30:033048611c01 1112 _setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
wim 30:033048611c01 1113
wim 30:033048611c01 1114 // Select secondary controller
wim 30:033048611c01 1115 _ctrl_idx = _LCDCtrl_1;
wim 30:033048611c01 1116
wim 30:033048611c01 1117 // Restore cursormode on secondary LCD controller
wim 30:033048611c01 1118 _setCursorAndDisplayMode(_currentMode, _currentCursor);
wim 30:033048611c01 1119 }
wim 30:033048611c01 1120
wim 30:033048611c01 1121 return 0x00 + ((row-2) * 0x40) + column;
wim 30:033048611c01 1122 }
wim 30:033048611c01 1123
wim 30:033048611c01 1124 // Should never get here.
wim 30:033048611c01 1125 default:
wim 30:033048611c01 1126 return 0x00;
wim 30:033048611c01 1127 }
wim 30:033048611c01 1128 }
wim 30:033048611c01 1129
wim 30:033048611c01 1130
wim 30:033048611c01 1131 #endif
wim 30:033048611c01 1132
wim 30:033048611c01 1133
wim 8:03116f75b66e 1134
wim 29:a3663151aa65 1135 /** Set the memoryaddress of screen column and row location
wim 29:a3663151aa65 1136 *
wim 29:a3663151aa65 1137 * @param column The horizontal position from the left, indexed from 0
wim 29:a3663151aa65 1138 * @param row The vertical position from the top, indexed from 0
wim 29:a3663151aa65 1139 */
wim 21:9eb628d9e164 1140 void TextLCD_Base::setAddress(int column, int row) {
wim 15:b70ebfffb258 1141
wim 15:b70ebfffb258 1142 // Sanity Check column
wim 15:b70ebfffb258 1143 if (column < 0) {
wim 15:b70ebfffb258 1144 _column = 0;
wim 15:b70ebfffb258 1145 }
wim 15:b70ebfffb258 1146 else if (column >= columns()) {
wim 15:b70ebfffb258 1147 _column = columns() - 1;
wim 15:b70ebfffb258 1148 } else _column = column;
wim 8:03116f75b66e 1149
wim 15:b70ebfffb258 1150 // Sanity Check row
wim 15:b70ebfffb258 1151 if (row < 0) {
wim 15:b70ebfffb258 1152 _row = 0;
wim 15:b70ebfffb258 1153 }
wim 15:b70ebfffb258 1154 else if (row >= rows()) {
wim 15:b70ebfffb258 1155 _row = rows() - 1;
wim 15:b70ebfffb258 1156 } else _row = row;
wim 15:b70ebfffb258 1157
wim 15:b70ebfffb258 1158
wim 15:b70ebfffb258 1159 // Compute the memory address
wim 15:b70ebfffb258 1160 // For LCD40x4: switch controllers if needed
wim 15:b70ebfffb258 1161 // switch cursor if needed
wim 15:b70ebfffb258 1162 int addr = getAddress(_column, _row);
wim 8:03116f75b66e 1163
wim 13:24506ba22480 1164 _writeCommand(0x80 | addr);
wim 8:03116f75b66e 1165 }
simon 1:ac48b187213c 1166
wim 29:a3663151aa65 1167
wim 29:a3663151aa65 1168 /** Return the number of columns
wim 29:a3663151aa65 1169 *
wim 29:a3663151aa65 1170 * @param return The number of columns
wim 30:033048611c01 1171 *
wim 30:033048611c01 1172 * Note: some configurations are commented out because they have not yet been tested due to lack of hardware
wim 29:a3663151aa65 1173 */
wim 21:9eb628d9e164 1174 int TextLCD_Base::columns() {
wim 30:033048611c01 1175
wim 30:033048611c01 1176 // Columns encoded in b7..b0
wim 30:033048611c01 1177 //return (_type & 0xFF);
wim 30:033048611c01 1178 return _nr_cols;
wim 30:033048611c01 1179
wim 30:033048611c01 1180 #if(0)
simon 1:ac48b187213c 1181 switch (_type) {
wim 8:03116f75b66e 1182 case LCD8x1:
wim 8:03116f75b66e 1183 case LCD8x2:
wim 18:bd65dc10f27f 1184 case LCD8x2B:
wim 8:03116f75b66e 1185 return 8;
wim 15:b70ebfffb258 1186
wim 15:b70ebfffb258 1187 case LCD12x2:
wim 29:a3663151aa65 1188 case LCD12x3B:
wim 30:033048611c01 1189 // case LCD12x3C:
wim 15:b70ebfffb258 1190 case LCD12x4:
wim 29:a3663151aa65 1191 case LCD12x4B:
wim 15:b70ebfffb258 1192 return 12;
wim 8:03116f75b66e 1193
wim 13:24506ba22480 1194 case LCD16x1:
simon 1:ac48b187213c 1195 case LCD16x2:
simon 1:ac48b187213c 1196 case LCD16x2B:
wim 28:30fa94f7341c 1197 // case LCD16x3:
wim 8:03116f75b66e 1198 case LCD16x4:
wim 8:03116f75b66e 1199 return 16;
wim 8:03116f75b66e 1200
wim 30:033048611c01 1201 // case LCD20x1:
wim 8:03116f75b66e 1202 case LCD20x2:
wim 8:03116f75b66e 1203 case LCD20x4:
wim 8:03116f75b66e 1204 return 20;
wim 8:03116f75b66e 1205
wim 29:a3663151aa65 1206 case LCD24x1:
wim 8:03116f75b66e 1207 case LCD24x2:
wim 30:033048611c01 1208 // case LCD24x3B:
wim 29:a3663151aa65 1209 case LCD24x4B:
wim 8:03116f75b66e 1210 return 24;
wim 9:0893d986e717 1211
wim 30:033048611c01 1212 // case LCD40x1:
wim 9:0893d986e717 1213 case LCD40x2:
wim 15:b70ebfffb258 1214 case LCD40x4:
wim 9:0893d986e717 1215 return 40;
wim 8:03116f75b66e 1216
wim 8:03116f75b66e 1217 // Should never get here.
simon 1:ac48b187213c 1218 default:
wim 8:03116f75b66e 1219 return 0;
simon 1:ac48b187213c 1220 }
wim 30:033048611c01 1221 #endif
simon 1:ac48b187213c 1222 }
simon 1:ac48b187213c 1223
wim 29:a3663151aa65 1224 /** Return the number of rows
wim 29:a3663151aa65 1225 *
wim 29:a3663151aa65 1226 * @param return The number of rows
wim 30:033048611c01 1227 *
wim 30:033048611c01 1228 * Note: some configurations are commented out because they have not yet been tested due to lack of hardware
wim 29:a3663151aa65 1229 */
wim 21:9eb628d9e164 1230 int TextLCD_Base::rows() {
wim 30:033048611c01 1231
wim 30:033048611c01 1232 // Rows encoded in b15..b8
wim 30:033048611c01 1233 //return ((_type >> 8) & 0xFF);
wim 30:033048611c01 1234 return _nr_rows;
wim 30:033048611c01 1235
wim 30:033048611c01 1236 #if(0)
simon 1:ac48b187213c 1237 switch (_type) {
wim 8:03116f75b66e 1238 case LCD8x1:
wim 13:24506ba22480 1239 case LCD16x1:
wim 30:033048611c01 1240 // case LCD20x1:
wim 29:a3663151aa65 1241 case LCD24x1:
wim 30:033048611c01 1242 // case LCD40x1:
wim 8:03116f75b66e 1243 return 1;
wim 8:03116f75b66e 1244
wim 15:b70ebfffb258 1245 case LCD8x2:
wim 18:bd65dc10f27f 1246 case LCD8x2B:
wim 15:b70ebfffb258 1247 case LCD12x2:
simon 1:ac48b187213c 1248 case LCD16x2:
simon 1:ac48b187213c 1249 case LCD16x2B:
simon 1:ac48b187213c 1250 case LCD20x2:
wim 8:03116f75b66e 1251 case LCD24x2:
wim 9:0893d986e717 1252 case LCD40x2:
wim 8:03116f75b66e 1253 return 2;
wim 28:30fa94f7341c 1254
wim 29:a3663151aa65 1255 case LCD12x3B:
wim 30:033048611c01 1256 // case LCD12x3C:
wim 28:30fa94f7341c 1257 // case LCD16x3:
wim 30:033048611c01 1258 // case LCD24x3B:
wim 29:a3663151aa65 1259 return 3;
wim 8:03116f75b66e 1260
wim 15:b70ebfffb258 1261 case LCD12x4:
wim 29:a3663151aa65 1262 case LCD12x4B:
wim 8:03116f75b66e 1263 case LCD16x4:
wim 8:03116f75b66e 1264 case LCD20x4:
wim 29:a3663151aa65 1265 case LCD24x4B:
wim 15:b70ebfffb258 1266 case LCD40x4:
wim 8:03116f75b66e 1267 return 4;
wim 12:6bf9d9957d31 1268
wim 12:6bf9d9957d31 1269 // Should never get here.
simon 1:ac48b187213c 1270 default:
wim 8:03116f75b66e 1271 return 0;
simon 1:ac48b187213c 1272 }
wim 30:033048611c01 1273 #endif
simon 1:ac48b187213c 1274 }
wim 10:dd9b3a696acd 1275
wim 29:a3663151aa65 1276 /** Set the Cursormode
wim 29:a3663151aa65 1277 *
wim 29:a3663151aa65 1278 * @param cursorMode The Cursor mode (CurOff_BlkOff, CurOn_BlkOff, CurOff_BlkOn, CurOn_BlkOn)
wim 29:a3663151aa65 1279 */
wim 21:9eb628d9e164 1280 void TextLCD_Base::setCursor(LCDCursor cursorMode) {
wim 15:b70ebfffb258 1281
wim 17:652ab113bc2e 1282 // Save new cursor mode, needed when 2 controllers are in use or when display is switched off/on
wim 17:652ab113bc2e 1283 _currentCursor = cursorMode;
wim 10:dd9b3a696acd 1284
wim 17:652ab113bc2e 1285 // Configure only current LCD controller
wim 17:652ab113bc2e 1286 _setCursorAndDisplayMode(_currentMode, _currentCursor);
wim 15:b70ebfffb258 1287
wim 15:b70ebfffb258 1288 }
wim 15:b70ebfffb258 1289
wim 29:a3663151aa65 1290 /** Set the Displaymode
wim 29:a3663151aa65 1291 *
wim 29:a3663151aa65 1292 * @param displayMode The Display mode (DispOff, DispOn)
wim 29:a3663151aa65 1293 */
wim 21:9eb628d9e164 1294 void TextLCD_Base::setMode(LCDMode displayMode) {
wim 17:652ab113bc2e 1295
wim 17:652ab113bc2e 1296 // Save new displayMode, needed when 2 controllers are in use or when cursor is changed
wim 17:652ab113bc2e 1297 _currentMode = displayMode;
wim 15:b70ebfffb258 1298
wim 17:652ab113bc2e 1299 // Select and configure second LCD controller when needed
wim 17:652ab113bc2e 1300 if(_type==LCD40x4) {
wim 21:9eb628d9e164 1301 if (_ctrl_idx==_LCDCtrl_0) {
wim 17:652ab113bc2e 1302 // Configure primary LCD controller
wim 17:652ab113bc2e 1303 _setCursorAndDisplayMode(_currentMode, _currentCursor);
wim 11:9ec02df863a1 1304
wim 17:652ab113bc2e 1305 // Select 2nd controller
wim 21:9eb628d9e164 1306 _ctrl_idx=_LCDCtrl_1;
wim 17:652ab113bc2e 1307
wim 17:652ab113bc2e 1308 // Configure secondary LCD controller
wim 21:9eb628d9e164 1309 _setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
wim 11:9ec02df863a1 1310
wim 17:652ab113bc2e 1311 // Restore current controller
wim 21:9eb628d9e164 1312 _ctrl_idx=_LCDCtrl_0;
wim 17:652ab113bc2e 1313 }
wim 17:652ab113bc2e 1314 else {
wim 17:652ab113bc2e 1315 // Select primary controller
wim 21:9eb628d9e164 1316 _ctrl_idx=_LCDCtrl_0;
wim 17:652ab113bc2e 1317
wim 17:652ab113bc2e 1318 // Configure primary LCD controller
wim 21:9eb628d9e164 1319 _setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
wim 17:652ab113bc2e 1320
wim 17:652ab113bc2e 1321 // Restore current controller
wim 21:9eb628d9e164 1322 _ctrl_idx=_LCDCtrl_1;
wim 11:9ec02df863a1 1323
wim 17:652ab113bc2e 1324 // Configure secondary LCD controller
wim 17:652ab113bc2e 1325 _setCursorAndDisplayMode(_currentMode, _currentCursor);
wim 10:dd9b3a696acd 1326 }
wim 17:652ab113bc2e 1327 }
wim 17:652ab113bc2e 1328 else {
wim 17:652ab113bc2e 1329 // Configure primary LCD controller
wim 17:652ab113bc2e 1330 _setCursorAndDisplayMode(_currentMode, _currentCursor);
wim 30:033048611c01 1331 }
wim 17:652ab113bc2e 1332 }
wim 17:652ab113bc2e 1333
wim 17:652ab113bc2e 1334
wim 29:a3663151aa65 1335 /** Low level method to restore the cursortype and display mode for current controller
wim 29:a3663151aa65 1336 */
wim 21:9eb628d9e164 1337 void TextLCD_Base::_setCursorAndDisplayMode(LCDMode displayMode, LCDCursor cursorType) {
wim 17:652ab113bc2e 1338
wim 17:652ab113bc2e 1339 // Configure current LCD controller
wim 17:652ab113bc2e 1340 _writeCommand(0x08 | displayMode | cursorType);
wim 10:dd9b3a696acd 1341 }
wim 10:dd9b3a696acd 1342
wim 29:a3663151aa65 1343 /** Set the Backlight mode
wim 29:a3663151aa65 1344 *
wim 29:a3663151aa65 1345 * @param backlightMode The Backlight mode (LightOff, LightOn)
wim 29:a3663151aa65 1346 */
wim 21:9eb628d9e164 1347 void TextLCD_Base::setBacklight(LCDBacklight backlightMode) {
wim 20:e0da005a777f 1348
wim 20:e0da005a777f 1349 if (backlightMode == LightOn) {
wim 21:9eb628d9e164 1350 this->_setBL(true);
wim 20:e0da005a777f 1351 }
wim 20:e0da005a777f 1352 else {
wim 21:9eb628d9e164 1353 this->_setBL(false);
wim 20:e0da005a777f 1354 }
wim 20:e0da005a777f 1355 }
wim 20:e0da005a777f 1356
wim 29:a3663151aa65 1357 /** Set User Defined Characters
wim 29:a3663151aa65 1358 *
wim 29:a3663151aa65 1359 * @param unsigned char c The Index of the UDC (0..7)
wim 29:a3663151aa65 1360 * @param char *udc_data The bitpatterns for the UDC (8 bytes of 5 significant bits)
wim 29:a3663151aa65 1361 */
wim 21:9eb628d9e164 1362 void TextLCD_Base::setUDC(unsigned char c, char *udc_data) {
wim 15:b70ebfffb258 1363
wim 15:b70ebfffb258 1364 // Select and configure second LCD controller when needed
wim 15:b70ebfffb258 1365 if(_type==LCD40x4) {
wim 19:c747b9e2e7b8 1366 _LCDCtrl_Idx current_ctrl_idx = _ctrl_idx; // Temp save current controller
wim 15:b70ebfffb258 1367
wim 15:b70ebfffb258 1368 // Select primary controller
wim 21:9eb628d9e164 1369 _ctrl_idx=_LCDCtrl_0;
wim 15:b70ebfffb258 1370
wim 15:b70ebfffb258 1371 // Configure primary LCD controller
wim 15:b70ebfffb258 1372 _setUDC(c, udc_data);
wim 15:b70ebfffb258 1373
wim 15:b70ebfffb258 1374 // Select 2nd controller
wim 21:9eb628d9e164 1375 _ctrl_idx=_LCDCtrl_1;
wim 15:b70ebfffb258 1376
wim 15:b70ebfffb258 1377 // Configure secondary LCD controller
wim 15:b70ebfffb258 1378 _setUDC(c, udc_data);
wim 11:9ec02df863a1 1379
wim 15:b70ebfffb258 1380 // Restore current controller
wim 19:c747b9e2e7b8 1381 _ctrl_idx=current_ctrl_idx;
wim 15:b70ebfffb258 1382 }
wim 15:b70ebfffb258 1383 else {
wim 15:b70ebfffb258 1384 // Configure primary LCD controller
wim 15:b70ebfffb258 1385 _setUDC(c, udc_data);
wim 15:b70ebfffb258 1386 }
wim 15:b70ebfffb258 1387
wim 15:b70ebfffb258 1388 }
wim 15:b70ebfffb258 1389
wim 29:a3663151aa65 1390 /** Low level method to store user defined characters for current controller
wim 29:a3663151aa65 1391 */
wim 21:9eb628d9e164 1392 void TextLCD_Base::_setUDC(unsigned char c, char *udc_data) {
wim 15:b70ebfffb258 1393
wim 15:b70ebfffb258 1394 // Select CG RAM for current LCD controller
wim 15:b70ebfffb258 1395 _writeCommand(0x40 + ((c & 0x07) << 3)); //Set CG-RAM address,
wim 15:b70ebfffb258 1396 //8 sequential locations needed per UDC
wim 15:b70ebfffb258 1397 // Store UDC pattern
wim 11:9ec02df863a1 1398 for (int i=0; i<8; i++) {
wim 13:24506ba22480 1399 _writeData(*udc_data++);
wim 11:9ec02df863a1 1400 }
wim 15:b70ebfffb258 1401
wim 15:b70ebfffb258 1402 //Select DD RAM again for current LCD controller
wim 15:b70ebfffb258 1403 int addr = getAddress(_column, _row);
wim 30:033048611c01 1404 _writeCommand(0x80 | addr);
wim 11:9ec02df863a1 1405 }
wim 21:9eb628d9e164 1406
wim 23:d47f226efb24 1407 //--------- End TextLCD_Base -----------
wim 21:9eb628d9e164 1408
wim 22:35742ec80c24 1409
wim 23:d47f226efb24 1410 //--------- Start TextLCD Bus -----------
wim 21:9eb628d9e164 1411
wim 21:9eb628d9e164 1412 /* Create a TextLCD interface for using regular mbed pins
wim 21:9eb628d9e164 1413 *
wim 21:9eb628d9e164 1414 * @param rs Instruction/data control line
wim 21:9eb628d9e164 1415 * @param e Enable line (clock)
wim 21:9eb628d9e164 1416 * @param d4-d7 Data lines for using as a 4-bit interface
wim 21:9eb628d9e164 1417 * @param type Sets the panel size/addressing mode (default = LCD16x2)
wim 21:9eb628d9e164 1418 * @param bl Backlight control line (optional, default = NC)
wim 21:9eb628d9e164 1419 * @param e2 Enable2 line (clock for second controller, LCD40x4 only)
wim 21:9eb628d9e164 1420 * @param ctrl LCD controller (default = HD44780)
wim 21:9eb628d9e164 1421 */
wim 21:9eb628d9e164 1422 TextLCD::TextLCD(PinName rs, PinName e,
wim 21:9eb628d9e164 1423 PinName d4, PinName d5, PinName d6, PinName d7,
wim 21:9eb628d9e164 1424 LCDType type, PinName bl, PinName e2, LCDCtrl ctrl) :
wim 21:9eb628d9e164 1425 TextLCD_Base(type, ctrl),
wim 22:35742ec80c24 1426 _rs(rs), _e(e), _d(d4, d5, d6, d7) {
wim 22:35742ec80c24 1427
wim 22:35742ec80c24 1428 // The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
wim 22:35742ec80c24 1429 if (bl != NC) {
wim 22:35742ec80c24 1430 _bl = new DigitalOut(bl); //Construct new pin
wim 22:35742ec80c24 1431 _bl->write(0); //Deactivate
wim 22:35742ec80c24 1432 }
wim 22:35742ec80c24 1433 else {
wim 22:35742ec80c24 1434 // No Hardware Backlight pin
wim 22:35742ec80c24 1435 _bl = NULL; //Construct dummy pin
wim 22:35742ec80c24 1436 }
wim 22:35742ec80c24 1437
wim 22:35742ec80c24 1438 // The hardware Enable2 pin is only needed for LCD40x4. Test and make sure whether it exists or not to prevent illegal access.
wim 22:35742ec80c24 1439 if (e2 != NC) {
wim 22:35742ec80c24 1440 _e2 = new DigitalOut(e2); //Construct new pin
wim 22:35742ec80c24 1441 _e2->write(0); //Deactivate
wim 22:35742ec80c24 1442 }
wim 22:35742ec80c24 1443 else {
wim 22:35742ec80c24 1444 // No Hardware Enable pin
wim 22:35742ec80c24 1445 _e2 = NULL; //Construct dummy pin
wim 22:35742ec80c24 1446 }
wim 21:9eb628d9e164 1447
wim 21:9eb628d9e164 1448 _init();
wim 21:9eb628d9e164 1449 }
wim 21:9eb628d9e164 1450
wim 29:a3663151aa65 1451 /** Destruct a TextLCD interface for using regular mbed pins
wim 29:a3663151aa65 1452 *
wim 29:a3663151aa65 1453 * @param none
wim 29:a3663151aa65 1454 * @return none
wim 29:a3663151aa65 1455 */
wim 29:a3663151aa65 1456 TextLCD::~TextLCD() {
wim 29:a3663151aa65 1457 if (_bl != NULL) {delete _bl;} // BL pin
wim 29:a3663151aa65 1458 if (_e2 != NULL) {delete _e2;} // E2 pin
wim 29:a3663151aa65 1459 }
wim 29:a3663151aa65 1460
wim 29:a3663151aa65 1461
wim 22:35742ec80c24 1462 /** Set E pin (or E2 pin)
wim 22:35742ec80c24 1463 * Used for mbed pins, I2C bus expander or SPI shiftregister
wim 22:35742ec80c24 1464 * Default PinName value for E2 is NC, must be used as pointer to avoid issues with mbed lib and DigitalOut pins
wim 22:35742ec80c24 1465 * @param value true or false
wim 22:35742ec80c24 1466 * @return none
wim 22:35742ec80c24 1467 */
wim 21:9eb628d9e164 1468 void TextLCD::_setEnable(bool value) {
wim 21:9eb628d9e164 1469
wim 22:35742ec80c24 1470 if(_ctrl_idx==_LCDCtrl_0) {
wim 22:35742ec80c24 1471 if (value) {
wim 22:35742ec80c24 1472 _e = 1; // Set E bit
wim 22:35742ec80c24 1473 }
wim 22:35742ec80c24 1474 else {
wim 22:35742ec80c24 1475 _e = 0; // Reset E bit
wim 22:35742ec80c24 1476 }
wim 22:35742ec80c24 1477 }
wim 22:35742ec80c24 1478 else {
wim 22:35742ec80c24 1479 if (value) {
wim 22:35742ec80c24 1480 if (_e2 != NULL) {_e2->write(1);} //Set E2 bit
wim 22:35742ec80c24 1481 }
wim 22:35742ec80c24 1482 else {
wim 22:35742ec80c24 1483 if (_e2 != NULL) {_e2->write(0);} //Reset E2 bit
wim 22:35742ec80c24 1484 }
wim 22:35742ec80c24 1485 }
wim 21:9eb628d9e164 1486 }
wim 21:9eb628d9e164 1487
wim 21:9eb628d9e164 1488 // Set RS pin
wim 21:9eb628d9e164 1489 // Used for mbed pins, I2C bus expander or SPI shiftregister
wim 21:9eb628d9e164 1490 void TextLCD::_setRS(bool value) {
wim 21:9eb628d9e164 1491
wim 22:35742ec80c24 1492 if (value) {
wim 21:9eb628d9e164 1493 _rs = 1; // Set RS bit
wim 22:35742ec80c24 1494 }
wim 22:35742ec80c24 1495 else {
wim 21:9eb628d9e164 1496 _rs = 0; // Reset RS bit
wim 22:35742ec80c24 1497 }
wim 21:9eb628d9e164 1498 }
wim 21:9eb628d9e164 1499
wim 22:35742ec80c24 1500 /** Set BL pin
wim 22:35742ec80c24 1501 * Used for mbed pins, I2C bus expander or SPI shiftregister
wim 22:35742ec80c24 1502 * Default PinName value is NC, must be used as pointer to avoid issues with mbed lib and DigitalOut pins
wim 22:35742ec80c24 1503 * @param value true or false
wim 22:35742ec80c24 1504 * @return none
wim 22:35742ec80c24 1505 */
wim 21:9eb628d9e164 1506 void TextLCD::_setBL(bool value) {
wim 21:9eb628d9e164 1507
wim 22:35742ec80c24 1508 if (value) {
wim 22:35742ec80c24 1509 if (_bl != NULL) {_bl->write(1);} //Set BL bit
wim 22:35742ec80c24 1510 }
wim 22:35742ec80c24 1511 else {
wim 22:35742ec80c24 1512 if (_bl != NULL) {_bl->write(0);} //Reset BL bit
wim 22:35742ec80c24 1513 }
wim 21:9eb628d9e164 1514
wim 21:9eb628d9e164 1515 }
wim 21:9eb628d9e164 1516
wim 21:9eb628d9e164 1517 // Place the 4bit data on the databus
wim 21:9eb628d9e164 1518 // Used for mbed pins, I2C bus expander or SPI shifregister
wim 21:9eb628d9e164 1519 void TextLCD::_setData(int value) {
wim 21:9eb628d9e164 1520 _d = value & 0x0F; // Write Databits
wim 21:9eb628d9e164 1521 }
wim 22:35742ec80c24 1522
wim 23:d47f226efb24 1523 //----------- End TextLCD ---------------
wim 21:9eb628d9e164 1524
wim 21:9eb628d9e164 1525
wim 23:d47f226efb24 1526 //--------- Start TextLCD_I2C -----------
wim 22:35742ec80c24 1527
wim 26:bd897a001012 1528 /** Create a TextLCD interface using an I2C PC8574 (or PCF8574A) or MCP23008 portexpander
wim 22:35742ec80c24 1529 *
wim 22:35742ec80c24 1530 * @param i2c I2C Bus
wim 26:bd897a001012 1531 * @param deviceAddress I2C slave address (PCF8574, PCF8574A or MCP23008, default = 0x40)
wim 22:35742ec80c24 1532 * @param type Sets the panel size/addressing mode (default = LCD16x2)
wim 22:35742ec80c24 1533 * @param ctrl LCD controller (default = HD44780)
wim 22:35742ec80c24 1534 */
wim 21:9eb628d9e164 1535 TextLCD_I2C::TextLCD_I2C(I2C *i2c, char deviceAddress, LCDType type, LCDCtrl ctrl) :
wim 21:9eb628d9e164 1536 TextLCD_Base(type, ctrl),
wim 21:9eb628d9e164 1537 _i2c(i2c){
wim 21:9eb628d9e164 1538
wim 22:35742ec80c24 1539 _slaveAddress = deviceAddress & 0xFE;
wim 28:30fa94f7341c 1540
wim 28:30fa94f7341c 1541 // Setup the I2C bus
wim 28:30fa94f7341c 1542 // The max bitrate for PCF8574 is 100kbit, the max bitrate for MCP23008 is 400kbit,
wim 28:30fa94f7341c 1543 // _i2c->frequency(100000);
wim 21:9eb628d9e164 1544
wim 26:bd897a001012 1545 #if (MCP23008==1)
wim 26:bd897a001012 1546 // MCP23008 portexpander Init
wim 27:22d5086f6ba6 1547 _write_register(IODIR, 0x00); // All outputs
wim 27:22d5086f6ba6 1548 _write_register(IPOL, 0x00); // No reverse polarity
wim 27:22d5086f6ba6 1549 _write_register(GPINTEN, 0x00); // No interrupt
wim 27:22d5086f6ba6 1550 _write_register(DEFVAL, 0x00); // Default value to compare against for interrupts
wim 27:22d5086f6ba6 1551 _write_register(INTCON, 0x00); // No interrupt on changes
wim 27:22d5086f6ba6 1552 _write_register(IOCON, 0x00); // Interrupt polarity
wim 27:22d5086f6ba6 1553 _write_register(GPPU, 0x00); // No Pullup
wim 27:22d5086f6ba6 1554 _write_register(INTF, 0x00); //
wim 27:22d5086f6ba6 1555 _write_register(INTCAP, 0x00); //
wim 27:22d5086f6ba6 1556 _write_register(GPIO, 0x00); // Output/Input pins
wim 27:22d5086f6ba6 1557 _write_register(OLAT, 0x00); // Output Latch
wim 26:bd897a001012 1558
wim 21:9eb628d9e164 1559 // Init the portexpander bus
wim 21:9eb628d9e164 1560 _lcd_bus = D_LCD_BUS_DEF;
wim 21:9eb628d9e164 1561
wim 21:9eb628d9e164 1562 // write the new data to the portexpander
wim 26:bd897a001012 1563 _write_register(GPIO, _lcd_bus);
wim 26:bd897a001012 1564 #else
wim 26:bd897a001012 1565 // PCF8574 of PCF8574A portexpander
wim 26:bd897a001012 1566
wim 26:bd897a001012 1567 // Init the portexpander bus
wim 26:bd897a001012 1568 _lcd_bus = D_LCD_BUS_DEF;
wim 26:bd897a001012 1569
wim 26:bd897a001012 1570 // write the new data to the portexpander
wim 21:9eb628d9e164 1571 _i2c->write(_slaveAddress, &_lcd_bus, 1);
wim 26:bd897a001012 1572 #endif
wim 21:9eb628d9e164 1573
wim 30:033048611c01 1574 _init();
wim 21:9eb628d9e164 1575 }
wim 21:9eb628d9e164 1576
wim 21:9eb628d9e164 1577 // Set E pin (or E2 pin)
wim 21:9eb628d9e164 1578 // Used for mbed pins, I2C bus expander or SPI shiftregister
wim 21:9eb628d9e164 1579 void TextLCD_I2C::_setEnable(bool value) {
wim 21:9eb628d9e164 1580
wim 22:35742ec80c24 1581 if(_ctrl_idx==_LCDCtrl_0) {
wim 26:bd897a001012 1582 if (value) {
wim 22:35742ec80c24 1583 _lcd_bus |= D_LCD_E; // Set E bit
wim 26:bd897a001012 1584 }
wim 26:bd897a001012 1585 else {
wim 22:35742ec80c24 1586 _lcd_bus &= ~D_LCD_E; // Reset E bit
wim 26:bd897a001012 1587 }
wim 22:35742ec80c24 1588 }
wim 22:35742ec80c24 1589 else {
wim 26:bd897a001012 1590 if (value) {
wim 22:35742ec80c24 1591 _lcd_bus |= D_LCD_E2; // Set E2 bit
wim 26:bd897a001012 1592 }
wim 26:bd897a001012 1593 else {
wim 22:35742ec80c24 1594 _lcd_bus &= ~D_LCD_E2; // Reset E2bit
wim 26:bd897a001012 1595 }
wim 26:bd897a001012 1596 }
wim 26:bd897a001012 1597
wim 26:bd897a001012 1598 #if (MCP23008==1)
wim 26:bd897a001012 1599 // MCP23008 portexpander
wim 26:bd897a001012 1600
wim 26:bd897a001012 1601 // write the new data to the portexpander
wim 26:bd897a001012 1602 _write_register(GPIO, _lcd_bus);
wim 26:bd897a001012 1603 #else
wim 26:bd897a001012 1604 // PCF8574 of PCF8574A portexpander
wim 21:9eb628d9e164 1605
wim 22:35742ec80c24 1606 // write the new data to the I2C portexpander
wim 22:35742ec80c24 1607 _i2c->write(_slaveAddress, &_lcd_bus, 1);
wim 26:bd897a001012 1608 #endif
wim 21:9eb628d9e164 1609 }
wim 21:9eb628d9e164 1610
wim 21:9eb628d9e164 1611 // Set RS pin
wim 21:9eb628d9e164 1612 // Used for mbed pins, I2C bus expander or SPI shiftregister
wim 21:9eb628d9e164 1613 void TextLCD_I2C::_setRS(bool value) {
wim 21:9eb628d9e164 1614
wim 26:bd897a001012 1615 if (value) {
wim 22:35742ec80c24 1616 _lcd_bus |= D_LCD_RS; // Set RS bit
wim 26:bd897a001012 1617 }
wim 26:bd897a001012 1618 else {
wim 22:35742ec80c24 1619 _lcd_bus &= ~D_LCD_RS; // Reset RS bit
wim 26:bd897a001012 1620 }
wim 26:bd897a001012 1621
wim 26:bd897a001012 1622 #if (MCP23008==1)
wim 26:bd897a001012 1623 // MCP23008 portexpander
wim 26:bd897a001012 1624
wim 26:bd897a001012 1625 // write the new data to the portexpander
wim 26:bd897a001012 1626 _write_register(GPIO, _lcd_bus);
wim 26:bd897a001012 1627 #else
wim 26:bd897a001012 1628 // PCF8574 of PCF8574A portexpander
wim 21:9eb628d9e164 1629
wim 22:35742ec80c24 1630 // write the new data to the I2C portexpander
wim 22:35742ec80c24 1631 _i2c->write(_slaveAddress, &_lcd_bus, 1);
wim 30:033048611c01 1632 #endif
wim 21:9eb628d9e164 1633 }
wim 21:9eb628d9e164 1634
wim 21:9eb628d9e164 1635 // Set BL pin
wim 21:9eb628d9e164 1636 // Used for mbed pins, I2C bus expander or SPI shiftregister
wim 21:9eb628d9e164 1637 void TextLCD_I2C::_setBL(bool value) {
wim 21:9eb628d9e164 1638
wim 26:bd897a001012 1639 if (value) {
wim 21:9eb628d9e164 1640 _lcd_bus |= D_LCD_BL; // Set BL bit
wim 26:bd897a001012 1641 }
wim 26:bd897a001012 1642 else {
wim 21:9eb628d9e164 1643 _lcd_bus &= ~D_LCD_BL; // Reset BL bit
wim 26:bd897a001012 1644 }
wim 26:bd897a001012 1645
wim 26:bd897a001012 1646 #if (MCP23008==1)
wim 26:bd897a001012 1647 // MCP23008 portexpander
wim 26:bd897a001012 1648
wim 26:bd897a001012 1649 // write the new data to the portexpander
wim 26:bd897a001012 1650 _write_register(GPIO, _lcd_bus);
wim 26:bd897a001012 1651 #else
wim 26:bd897a001012 1652 // PCF8574 of PCF8574A portexpander
wim 21:9eb628d9e164 1653
wim 21:9eb628d9e164 1654 // write the new data to the I2C portexpander
wim 21:9eb628d9e164 1655 _i2c->write(_slaveAddress, &_lcd_bus, 1);
wim 30:033048611c01 1656 #endif
wim 21:9eb628d9e164 1657 }
wim 21:9eb628d9e164 1658
wim 21:9eb628d9e164 1659
wim 21:9eb628d9e164 1660 // Place the 4bit data on the databus
wim 21:9eb628d9e164 1661 // Used for mbed pins, I2C bus expander or SPI shifregister
wim 21:9eb628d9e164 1662 void TextLCD_I2C::_setData(int value) {
wim 21:9eb628d9e164 1663 int data;
wim 22:35742ec80c24 1664
wim 22:35742ec80c24 1665 // Set bit by bit to support any mapping of expander portpins to LCD pins
wim 21:9eb628d9e164 1666
wim 22:35742ec80c24 1667 data = value & 0x0F;
wim 26:bd897a001012 1668 if (data & 0x01){
wim 22:35742ec80c24 1669 _lcd_bus |= D_LCD_D4; // Set Databit
wim 26:bd897a001012 1670 }
wim 26:bd897a001012 1671 else {
wim 26:bd897a001012 1672 _lcd_bus &= ~D_LCD_D4; // Reset Databit
wim 26:bd897a001012 1673 }
wim 21:9eb628d9e164 1674
wim 26:bd897a001012 1675 if (data & 0x02){
wim 22:35742ec80c24 1676 _lcd_bus |= D_LCD_D5; // Set Databit
wim 26:bd897a001012 1677 }
wim 26:bd897a001012 1678 else {
wim 26:bd897a001012 1679 _lcd_bus &= ~D_LCD_D5; // Reset Databit
wim 26:bd897a001012 1680 }
wim 21:9eb628d9e164 1681
wim 26:bd897a001012 1682 if (data & 0x04) {
wim 22:35742ec80c24 1683 _lcd_bus |= D_LCD_D6; // Set Databit
wim 26:bd897a001012 1684 }
wim 26:bd897a001012 1685 else {
wim 26:bd897a001012 1686 _lcd_bus &= ~D_LCD_D6; // Reset Databit
wim 26:bd897a001012 1687 }
wim 21:9eb628d9e164 1688
wim 26:bd897a001012 1689 if (data & 0x08) {
wim 22:35742ec80c24 1690 _lcd_bus |= D_LCD_D7; // Set Databit
wim 26:bd897a001012 1691 }
wim 26:bd897a001012 1692 else {
wim 26:bd897a001012 1693 _lcd_bus &= ~D_LCD_D7; // Reset Databit
wim 26:bd897a001012 1694 }
wim 21:9eb628d9e164 1695
wim 26:bd897a001012 1696 #if (MCP23008==1)
wim 26:bd897a001012 1697 // MCP23008 portexpander
wim 26:bd897a001012 1698
wim 26:bd897a001012 1699 // write the new data to the portexpander
wim 26:bd897a001012 1700 _write_register(GPIO, _lcd_bus);
wim 26:bd897a001012 1701 #else
wim 26:bd897a001012 1702 // PCF8574 of PCF8574A portexpander
wim 26:bd897a001012 1703
wim 22:35742ec80c24 1704 // write the new data to the I2C portexpander
wim 26:bd897a001012 1705 _i2c->write(_slaveAddress, &_lcd_bus, 1);
wim 26:bd897a001012 1706 #endif
wim 22:35742ec80c24 1707
wim 22:35742ec80c24 1708 }
wim 21:9eb628d9e164 1709
wim 26:bd897a001012 1710 // Write data to MCP23008 I2C portexpander
wim 26:bd897a001012 1711 void TextLCD_I2C::_write_register (int reg, int value) {
wim 26:bd897a001012 1712 char data[] = {reg, value};
wim 26:bd897a001012 1713
wim 30:033048611c01 1714 _i2c->write(_slaveAddress, data, 2);
wim 26:bd897a001012 1715 }
wim 26:bd897a001012 1716
wim 23:d47f226efb24 1717 //---------- End TextLCD_I2C ------------
wim 21:9eb628d9e164 1718
wim 21:9eb628d9e164 1719
wim 28:30fa94f7341c 1720 //--------- Start TextLCD_I2C_N ---------
wim 28:30fa94f7341c 1721
wim 28:30fa94f7341c 1722 /** Create a TextLCD interface using a controller with native I2C interface
wim 28:30fa94f7341c 1723 *
wim 28:30fa94f7341c 1724 * @param i2c I2C Bus
wim 28:30fa94f7341c 1725 * @param deviceAddress I2C slave address (default = 0x7C)
wim 28:30fa94f7341c 1726 * @param type Sets the panel size/addressing mode (default = LCD16x2)
wim 28:30fa94f7341c 1727 * @param bl Backlight control line (optional, default = NC)
wim 28:30fa94f7341c 1728 * @param ctrl LCD controller (default = ST7032_3V3)
wim 28:30fa94f7341c 1729 */
wim 28:30fa94f7341c 1730 TextLCD_I2C_N::TextLCD_I2C_N(I2C *i2c, char deviceAddress, LCDType type, PinName bl, LCDCtrl ctrl) :
wim 28:30fa94f7341c 1731 TextLCD_Base(type, ctrl),
wim 28:30fa94f7341c 1732 _i2c(i2c){
wim 30:033048611c01 1733
wim 28:30fa94f7341c 1734 _slaveAddress = deviceAddress & 0xFE;
wim 28:30fa94f7341c 1735
wim 28:30fa94f7341c 1736 // Setup the I2C bus
wim 29:a3663151aa65 1737 // The max bitrate for ST7032i is 400kbit, lets stick to default here
wim 29:a3663151aa65 1738 _i2c->frequency(100000);
wim 29:a3663151aa65 1739 // _i2c->frequency(50000);
wim 30:033048611c01 1740
wim 28:30fa94f7341c 1741 // The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
wim 28:30fa94f7341c 1742 if (bl != NC) {
wim 28:30fa94f7341c 1743 _bl = new DigitalOut(bl); //Construct new pin
wim 28:30fa94f7341c 1744 _bl->write(0); //Deactivate
wim 28:30fa94f7341c 1745 }
wim 28:30fa94f7341c 1746 else {
wim 28:30fa94f7341c 1747 // No Hardware Backlight pin
wim 28:30fa94f7341c 1748 _bl = NULL; //Construct dummy pin
wim 28:30fa94f7341c 1749 }
wim 28:30fa94f7341c 1750
wim 30:033048611c01 1751 #if(0)
wim 30:033048611c01 1752 //Sanity check
wim 30:033048611c01 1753 switch (_ctrl) {
wim 30:033048611c01 1754 case ST7032_3V3:
wim 30:033048611c01 1755 case ST7032_5V:
wim 30:033048611c01 1756 case PCF21XX_3V3:
wim 30:033048611c01 1757 // case PCF21XX_5V:
wim 30:033048611c01 1758 _init();
wim 30:033048611c01 1759 break;
wim 30:033048611c01 1760
wim 30:033048611c01 1761 default:
wim 30:033048611c01 1762 error("Error: LCD Controller type does not support native I2C interface\n\r");
wim 30:033048611c01 1763 }
wim 30:033048611c01 1764 #endif
wim 30:033048611c01 1765
wim 30:033048611c01 1766 //Sanity check
wim 30:033048611c01 1767 if (_ctrl & LCD_C_I2C) {
wim 30:033048611c01 1768 _init();
wim 30:033048611c01 1769 }
wim 30:033048611c01 1770 else {
wim 30:033048611c01 1771 error("Error: LCD Controller type does not support native I2C interface\n\r");
wim 30:033048611c01 1772 }
wim 30:033048611c01 1773
wim 28:30fa94f7341c 1774 }
wim 28:30fa94f7341c 1775
wim 28:30fa94f7341c 1776 TextLCD_I2C_N::~TextLCD_I2C_N() {
wim 28:30fa94f7341c 1777 if (_bl != NULL) {delete _bl;} // BL pin
wim 28:30fa94f7341c 1778 }
wim 28:30fa94f7341c 1779
wim 28:30fa94f7341c 1780 // Not used in this mode
wim 28:30fa94f7341c 1781 void TextLCD_I2C_N::_setEnable(bool value) {
wim 28:30fa94f7341c 1782 }
wim 28:30fa94f7341c 1783
wim 28:30fa94f7341c 1784 // Set RS pin
wim 28:30fa94f7341c 1785 // Used for mbed pins, I2C bus expander or SPI shiftregister and native I2C or SPI
wim 28:30fa94f7341c 1786 void TextLCD_I2C_N::_setRS(bool value) {
wim 30:033048611c01 1787 // The controlbyte defines the meaning of the next byte. This next byte can either be data or command.
wim 30:033048611c01 1788 // Start Slaveaddress+RW b7 b6 b5 b4 b3 b2 b1 b0 b7...........b0 Stop
wim 30:033048611c01 1789 // Co RS RW 0 0 0 0 0 command or data
wim 30:033048611c01 1790 //
wim 30:033048611c01 1791 // C0=1 indicates that another controlbyte will follow after the next data or command byte
wim 30:033048611c01 1792 // RS=1 means that next byte is data, RS=0 means that next byte is command
wim 30:033048611c01 1793 // RW=0 means write to controller. RW=1 means that controller will be read from after the next command.
wim 30:033048611c01 1794 // Many native I2C controllers dont support this option and it is not used by this lib.
wim 30:033048611c01 1795 //
wim 30:033048611c01 1796
wim 28:30fa94f7341c 1797 if (value) {
wim 28:30fa94f7341c 1798 _controlbyte = 0x40; // Next byte is data, No more control bytes will follow
wim 28:30fa94f7341c 1799 }
wim 28:30fa94f7341c 1800 else {
wim 28:30fa94f7341c 1801 _controlbyte = 0x00; // Next byte is command, No more control bytes will follow
wim 28:30fa94f7341c 1802 }
wim 28:30fa94f7341c 1803 }
wim 28:30fa94f7341c 1804
wim 28:30fa94f7341c 1805 // Set BL pin
wim 28:30fa94f7341c 1806 void TextLCD_I2C_N::_setBL(bool value) {
wim 28:30fa94f7341c 1807 if (_bl) {
wim 28:30fa94f7341c 1808 _bl->write(value);
wim 28:30fa94f7341c 1809 }
wim 28:30fa94f7341c 1810 }
wim 29:a3663151aa65 1811
wim 29:a3663151aa65 1812 // Not used in this mode
wim 29:a3663151aa65 1813 void TextLCD_I2C_N::_setData(int value) {
wim 29:a3663151aa65 1814 }
wim 29:a3663151aa65 1815
wim 28:30fa94f7341c 1816 // Write a byte using I2C
wim 28:30fa94f7341c 1817 void TextLCD_I2C_N::_writeByte(int value) {
wim 30:033048611c01 1818 // The controlbyte defines the meaning of the next byte. This next byte can either be data or command.
wim 30:033048611c01 1819 // Start Slaveaddress+RW b7 b6 b5 b4 b3 b2 b1 b0 b7...........b0 Stop
wim 30:033048611c01 1820 // Co RS RW 0 0 0 0 0 command or data
wim 30:033048611c01 1821 //
wim 30:033048611c01 1822 // C0=1 indicates that another controlbyte will follow after the next data or command byte
wim 30:033048611c01 1823 // RS=1 means that next byte is data, RS=0 means that next byte is command
wim 30:033048611c01 1824 // RW=0 means write to controller. RW=1 means that controller will be read from after the next command.
wim 30:033048611c01 1825 // Many native I2C controllers dont support this option and it is not used by this lib.
wim 30:033048611c01 1826 //
wim 28:30fa94f7341c 1827 char data[] = {_controlbyte, value};
wim 28:30fa94f7341c 1828
wim 30:033048611c01 1829 _i2c->write(_slaveAddress, data, 2);
wim 28:30fa94f7341c 1830 }
wim 28:30fa94f7341c 1831
wim 28:30fa94f7341c 1832 //-------- End TextLCD_I2C_N ------------
wim 28:30fa94f7341c 1833
wim 28:30fa94f7341c 1834
wim 23:d47f226efb24 1835 //--------- Start TextLCD_SPI -----------
wim 21:9eb628d9e164 1836
wim 22:35742ec80c24 1837 /** Create a TextLCD interface using an SPI 74595 portexpander
wim 22:35742ec80c24 1838 *
wim 22:35742ec80c24 1839 * @param spi SPI Bus
wim 22:35742ec80c24 1840 * @param cs chip select pin (active low)
wim 22:35742ec80c24 1841 * @param type Sets the panel size/addressing mode (default = LCD16x2)
wim 22:35742ec80c24 1842 * @param ctrl LCD controller (default = HD44780)
wim 22:35742ec80c24 1843 */
wim 21:9eb628d9e164 1844 TextLCD_SPI::TextLCD_SPI(SPI *spi, PinName cs, LCDType type, LCDCtrl ctrl) :
wim 21:9eb628d9e164 1845 TextLCD_Base(type, ctrl),
wim 21:9eb628d9e164 1846 _spi(spi),
wim 21:9eb628d9e164 1847 _cs(cs) {
wim 21:9eb628d9e164 1848
wim 21:9eb628d9e164 1849 // Setup the spi for 8 bit data, low steady state clock,
wim 21:9eb628d9e164 1850 // rising edge capture, with a 500KHz or 1MHz clock rate
wim 21:9eb628d9e164 1851 _spi->format(8,0);
wim 21:9eb628d9e164 1852 _spi->frequency(500000);
wim 21:9eb628d9e164 1853 //_spi.frequency(1000000);
wim 21:9eb628d9e164 1854
wim 21:9eb628d9e164 1855 // Init the portexpander bus
wim 21:9eb628d9e164 1856 _lcd_bus = D_LCD_BUS_DEF;
wim 21:9eb628d9e164 1857
wim 21:9eb628d9e164 1858 // write the new data to the portexpander
wim 21:9eb628d9e164 1859 _setCS(false);
wim 21:9eb628d9e164 1860 _spi->write(_lcd_bus);
wim 21:9eb628d9e164 1861 _setCS(true);
wim 30:033048611c01 1862
wim 30:033048611c01 1863 _init();
wim 21:9eb628d9e164 1864 }
wim 21:9eb628d9e164 1865
wim 21:9eb628d9e164 1866 // Set E pin (or E2 pin)
wim 21:9eb628d9e164 1867 // Used for mbed pins, I2C bus expander or SPI shiftregister
wim 21:9eb628d9e164 1868 void TextLCD_SPI::_setEnable(bool value) {
wim 21:9eb628d9e164 1869
wim 22:35742ec80c24 1870 if(_ctrl_idx==_LCDCtrl_0) {
wim 26:bd897a001012 1871 if (value) {
wim 22:35742ec80c24 1872 _lcd_bus |= D_LCD_E; // Set E bit
wim 26:bd897a001012 1873 }
wim 26:bd897a001012 1874 else {
wim 22:35742ec80c24 1875 _lcd_bus &= ~D_LCD_E; // Reset E bit
wim 26:bd897a001012 1876 }
wim 22:35742ec80c24 1877 }
wim 22:35742ec80c24 1878 else {
wim 26:bd897a001012 1879 if (value) {
wim 22:35742ec80c24 1880 _lcd_bus |= D_LCD_E2; // Set E2 bit
wim 26:bd897a001012 1881 }
wim 26:bd897a001012 1882 else {
wim 22:35742ec80c24 1883 _lcd_bus &= ~D_LCD_E2; // Reset E2 bit
wim 26:bd897a001012 1884 }
wim 22:35742ec80c24 1885 }
wim 21:9eb628d9e164 1886
wim 22:35742ec80c24 1887 // write the new data to the SPI portexpander
wim 22:35742ec80c24 1888 _setCS(false);
wim 22:35742ec80c24 1889 _spi->write(_lcd_bus);
wim 30:033048611c01 1890 _setCS(true);
wim 21:9eb628d9e164 1891 }
wim 21:9eb628d9e164 1892
wim 21:9eb628d9e164 1893 // Set RS pin
wim 21:9eb628d9e164 1894 // Used for mbed pins, I2C bus expander or SPI shiftregister
wim 21:9eb628d9e164 1895 void TextLCD_SPI::_setRS(bool value) {
wim 21:9eb628d9e164 1896
wim 22:35742ec80c24 1897 if (value) {
wim 21:9eb628d9e164 1898 _lcd_bus |= D_LCD_RS; // Set RS bit
wim 22:35742ec80c24 1899 }
wim 22:35742ec80c24 1900 else {
wim 21:9eb628d9e164 1901 _lcd_bus &= ~D_LCD_RS; // Reset RS bit
wim 22:35742ec80c24 1902 }
wim 21:9eb628d9e164 1903
wim 21:9eb628d9e164 1904 // write the new data to the SPI portexpander
wim 21:9eb628d9e164 1905 _setCS(false);
wim 21:9eb628d9e164 1906 _spi->write(_lcd_bus);
wim 21:9eb628d9e164 1907 _setCS(true);
wim 21:9eb628d9e164 1908 }
wim 21:9eb628d9e164 1909
wim 21:9eb628d9e164 1910 // Set BL pin
wim 21:9eb628d9e164 1911 // Used for mbed pins, I2C bus expander or SPI shiftregister
wim 21:9eb628d9e164 1912 void TextLCD_SPI::_setBL(bool value) {
wim 21:9eb628d9e164 1913
wim 22:35742ec80c24 1914 if (value) {
wim 21:9eb628d9e164 1915 _lcd_bus |= D_LCD_BL; // Set BL bit
wim 22:35742ec80c24 1916 }
wim 22:35742ec80c24 1917 else {
wim 21:9eb628d9e164 1918 _lcd_bus &= ~D_LCD_BL; // Reset BL bit
wim 22:35742ec80c24 1919 }
wim 21:9eb628d9e164 1920
wim 21:9eb628d9e164 1921 // write the new data to the SPI portexpander
wim 21:9eb628d9e164 1922 _setCS(false);
wim 21:9eb628d9e164 1923 _spi->write(_lcd_bus);
wim 30:033048611c01 1924 _setCS(true);
wim 21:9eb628d9e164 1925 }
wim 21:9eb628d9e164 1926
wim 21:9eb628d9e164 1927 // Place the 4bit data on the databus
wim 21:9eb628d9e164 1928 // Used for mbed pins, I2C bus expander or SPI shiftregister
wim 21:9eb628d9e164 1929 void TextLCD_SPI::_setData(int value) {
wim 21:9eb628d9e164 1930 int data;
wim 21:9eb628d9e164 1931
wim 22:35742ec80c24 1932 // Set bit by bit to support any mapping of expander portpins to LCD pins
wim 22:35742ec80c24 1933
wim 22:35742ec80c24 1934 data = value & 0x0F;
wim 26:bd897a001012 1935 if (data & 0x01) {
wim 22:35742ec80c24 1936 _lcd_bus |= D_LCD_D4; // Set Databit
wim 26:bd897a001012 1937 }
wim 26:bd897a001012 1938 else {
wim 22:35742ec80c24 1939 _lcd_bus &= ~D_LCD_D4; // Reset Databit
wim 26:bd897a001012 1940 }
wim 26:bd897a001012 1941
wim 26:bd897a001012 1942 if (data & 0x02) {
wim 22:35742ec80c24 1943 _lcd_bus |= D_LCD_D5; // Set Databit
wim 26:bd897a001012 1944 }
wim 26:bd897a001012 1945 else {
wim 22:35742ec80c24 1946 _lcd_bus &= ~D_LCD_D5; // Reset Databit
wim 26:bd897a001012 1947 }
wim 26:bd897a001012 1948
wim 26:bd897a001012 1949 if (data & 0x04) {
wim 22:35742ec80c24 1950 _lcd_bus |= D_LCD_D6; // Set Databit
wim 26:bd897a001012 1951 }
wim 26:bd897a001012 1952 else {
wim 22:35742ec80c24 1953 _lcd_bus &= ~D_LCD_D6; // Reset Databit
wim 26:bd897a001012 1954 }
wim 26:bd897a001012 1955
wim 26:bd897a001012 1956 if (data & 0x08) {
wim 22:35742ec80c24 1957 _lcd_bus |= D_LCD_D7; // Set Databit
wim 26:bd897a001012 1958 }
wim 26:bd897a001012 1959 else {
wim 26:bd897a001012 1960 _lcd_bus &= ~D_LCD_D7; // Reset Databit
wim 26:bd897a001012 1961 }
wim 21:9eb628d9e164 1962
wim 22:35742ec80c24 1963 // write the new data to the SPI portexpander
wim 22:35742ec80c24 1964 _setCS(false);
wim 22:35742ec80c24 1965 _spi->write(_lcd_bus);
wim 30:033048611c01 1966 _setCS(true);
wim 21:9eb628d9e164 1967 }
wim 21:9eb628d9e164 1968
wim 21:9eb628d9e164 1969 // Set CS line.
wim 21:9eb628d9e164 1970 // Only used for SPI bus
wim 21:9eb628d9e164 1971 void TextLCD_SPI::_setCS(bool value) {
wim 21:9eb628d9e164 1972
wim 21:9eb628d9e164 1973 if (value) {
wim 21:9eb628d9e164 1974 _cs = 1; // Set CS pin
wim 21:9eb628d9e164 1975 }
wim 22:35742ec80c24 1976 else {
wim 21:9eb628d9e164 1977 _cs = 0; // Reset CS pin
wim 22:35742ec80c24 1978 }
wim 21:9eb628d9e164 1979 }
wim 21:9eb628d9e164 1980
wim 23:d47f226efb24 1981 //---------- End TextLCD_SPI ------------
wim 22:35742ec80c24 1982
wim 22:35742ec80c24 1983
wim 25:6162b31128c9 1984 //--------- Start TextLCD_SPI_N ---------
Sissors 24:fb3399713710 1985
wim 30:033048611c01 1986 /** Create a TextLCD interface using a controller with a native SPI4 interface
Sissors 24:fb3399713710 1987 *
Sissors 24:fb3399713710 1988 * @param spi SPI Bus
Sissors 24:fb3399713710 1989 * @param cs chip select pin (active low)
wim 25:6162b31128c9 1990 * @param rs Instruction/data control line
Sissors 24:fb3399713710 1991 * @param type Sets the panel size/addressing mode (default = LCD16x2)
wim 25:6162b31128c9 1992 * @param bl Backlight control line (optional, default = NC)
wim 26:bd897a001012 1993 * @param ctrl LCD controller (default = ST7032_3V3)
wim 25:6162b31128c9 1994 */
wim 25:6162b31128c9 1995 TextLCD_SPI_N::TextLCD_SPI_N(SPI *spi, PinName cs, PinName rs, LCDType type, PinName bl, LCDCtrl ctrl) :
wim 25:6162b31128c9 1996 TextLCD_Base(type, ctrl),
wim 25:6162b31128c9 1997 _spi(spi),
wim 25:6162b31128c9 1998 _cs(cs),
wim 25:6162b31128c9 1999 _rs(rs) {
Sissors 24:fb3399713710 2000
Sissors 24:fb3399713710 2001 // Setup the spi for 8 bit data, low steady state clock,
Sissors 24:fb3399713710 2002 // rising edge capture, with a 500KHz or 1MHz clock rate
Sissors 24:fb3399713710 2003 _spi->format(8,0);
Sissors 24:fb3399713710 2004 _spi->frequency(1000000);
Sissors 24:fb3399713710 2005
Sissors 24:fb3399713710 2006 // The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
Sissors 24:fb3399713710 2007 if (bl != NC) {
Sissors 24:fb3399713710 2008 _bl = new DigitalOut(bl); //Construct new pin
Sissors 24:fb3399713710 2009 _bl->write(0); //Deactivate
Sissors 24:fb3399713710 2010 }
Sissors 24:fb3399713710 2011 else {
Sissors 24:fb3399713710 2012 // No Hardware Backlight pin
Sissors 24:fb3399713710 2013 _bl = NULL; //Construct dummy pin
Sissors 24:fb3399713710 2014 }
wim 30:033048611c01 2015
wim 30:033048611c01 2016 #if(0)
wim 30:033048611c01 2017 //Sanity check
wim 30:033048611c01 2018 switch (_ctrl) {
wim 30:033048611c01 2019 case ST7032_3V3:
wim 30:033048611c01 2020 case ST7032_5V:
wim 30:033048611c01 2021 case WS0010:
wim 30:033048611c01 2022 _init();
wim 30:033048611c01 2023 break;
wim 30:033048611c01 2024
wim 30:033048611c01 2025 default:
wim 30:033048611c01 2026 error("Error: LCD Controller type does not support native SPI4 interface\n\r");
wim 30:033048611c01 2027 }
wim 30:033048611c01 2028 #endif
wim 30:033048611c01 2029
wim 30:033048611c01 2030 //Sanity check
wim 30:033048611c01 2031 if (_ctrl & LCD_C_SPI4) {
wim 30:033048611c01 2032 _init();
wim 30:033048611c01 2033 }
wim 30:033048611c01 2034 else {
wim 30:033048611c01 2035 error("Error: LCD Controller type does not support native SPI4 interface\n\r");
wim 30:033048611c01 2036 }
Sissors 24:fb3399713710 2037 }
Sissors 24:fb3399713710 2038
wim 25:6162b31128c9 2039 TextLCD_SPI_N::~TextLCD_SPI_N() {
Sissors 24:fb3399713710 2040 if (_bl != NULL) {delete _bl;} // BL pin
Sissors 24:fb3399713710 2041 }
Sissors 24:fb3399713710 2042
Sissors 24:fb3399713710 2043 // Not used in this mode
wim 25:6162b31128c9 2044 void TextLCD_SPI_N::_setEnable(bool value) {
Sissors 24:fb3399713710 2045 }
Sissors 24:fb3399713710 2046
Sissors 24:fb3399713710 2047 // Set RS pin
Sissors 24:fb3399713710 2048 // Used for mbed pins, I2C bus expander or SPI shiftregister
wim 25:6162b31128c9 2049 void TextLCD_SPI_N::_setRS(bool value) {
Sissors 24:fb3399713710 2050 _rs = value;
Sissors 24:fb3399713710 2051 }
Sissors 24:fb3399713710 2052
Sissors 24:fb3399713710 2053 // Set BL pin
wim 25:6162b31128c9 2054 void TextLCD_SPI_N::_setBL(bool value) {
wim 26:bd897a001012 2055 if (_bl) {
Sissors 24:fb3399713710 2056 _bl->write(value);
wim 26:bd897a001012 2057 }
Sissors 24:fb3399713710 2058 }
Sissors 24:fb3399713710 2059
wim 29:a3663151aa65 2060 // Not used in this mode
wim 29:a3663151aa65 2061 void TextLCD_SPI_N::_setData(int value) {
wim 29:a3663151aa65 2062 }
wim 29:a3663151aa65 2063
Sissors 24:fb3399713710 2064 // Write a byte using SPI
wim 25:6162b31128c9 2065 void TextLCD_SPI_N::_writeByte(int value) {
Sissors 24:fb3399713710 2066 _cs = 0;
Sissors 24:fb3399713710 2067 wait_us(1);
Sissors 24:fb3399713710 2068 _spi->write(value);
Sissors 24:fb3399713710 2069 wait_us(1);
Sissors 24:fb3399713710 2070 _cs = 1;
Sissors 24:fb3399713710 2071 }
wim 30:033048611c01 2072
wim 25:6162b31128c9 2073 //-------- End TextLCD_SPI_N ------------
wim 21:9eb628d9e164 2074
wim 21:9eb628d9e164 2075
wim 21:9eb628d9e164 2076
wim 30:033048611c01 2077 #if(0)
wim 30:033048611c01 2078 //Code checked out on logic analyser. Not yet tested on hardware..
wim 30:033048611c01 2079
wim 30:033048611c01 2080 //-------- Start TextLCD_SPI_N_3_9 --------
wim 30:033048611c01 2081
wim 30:033048611c01 2082 /** Create a TextLCD interface using a controller with a native SPI3 9 bits interface
wim 30:033048611c01 2083 *
wim 30:033048611c01 2084 * @param spi SPI Bus
wim 30:033048611c01 2085 * @param cs chip select pin (active low)
wim 30:033048611c01 2086 * @param type Sets the panel size/addressing mode (default = LCD16x2)
wim 30:033048611c01 2087 * @param bl Backlight control line (optional, default = NC)
wim 30:033048611c01 2088 * @param ctrl LCD controller (default = AIP31068)
wim 30:033048611c01 2089 */
wim 30:033048611c01 2090 TextLCD_SPI_N_3_9::TextLCD_SPI_N_3_9(SPI *spi, PinName cs, LCDType type, PinName bl, LCDCtrl ctrl) :
wim 30:033048611c01 2091 TextLCD_Base(type, ctrl),
wim 30:033048611c01 2092 _spi(spi),
wim 30:033048611c01 2093 _cs(cs) {
wim 30:033048611c01 2094
wim 30:033048611c01 2095 // Setup the spi for 9 bit data, low steady state clock,
wim 30:033048611c01 2096 // rising edge capture, with a 500KHz or 1MHz clock rate
wim 30:033048611c01 2097 _spi->format(9,0);
wim 30:033048611c01 2098 _spi->frequency(1000000);
wim 30:033048611c01 2099
wim 30:033048611c01 2100 // The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
wim 30:033048611c01 2101 if (bl != NC) {
wim 30:033048611c01 2102 _bl = new DigitalOut(bl); //Construct new pin
wim 30:033048611c01 2103 _bl->write(0); //Deactivate
wim 30:033048611c01 2104 }
wim 30:033048611c01 2105 else {
wim 30:033048611c01 2106 // No Hardware Backlight pin
wim 30:033048611c01 2107 _bl = NULL; //Construct dummy pin
wim 30:033048611c01 2108 }
wim 30:033048611c01 2109
wim 30:033048611c01 2110 //Sanity check
wim 30:033048611c01 2111 if (_ctrl & LCD_C_SPI3_9) {
wim 30:033048611c01 2112 _init();
wim 30:033048611c01 2113 }
wim 30:033048611c01 2114 else {
wim 30:033048611c01 2115 error("Error: LCD Controller type does not support native SPI3 9 bits interface\n\r");
wim 30:033048611c01 2116 }
wim 30:033048611c01 2117 }
wim 30:033048611c01 2118
wim 30:033048611c01 2119 TextLCD_SPI_N_3_9::~TextLCD_SPI_N_3_9() {
wim 30:033048611c01 2120 if (_bl != NULL) {delete _bl;} // BL pin
wim 30:033048611c01 2121 }
wim 30:033048611c01 2122
wim 30:033048611c01 2123 // Not used in this mode
wim 30:033048611c01 2124 void TextLCD_SPI_N_3_9::_setEnable(bool value) {
wim 30:033048611c01 2125 }
wim 30:033048611c01 2126
wim 30:033048611c01 2127 // Set RS pin
wim 30:033048611c01 2128 // Used for mbed pins, I2C bus expander or SPI shiftregister
wim 30:033048611c01 2129 void TextLCD_SPI_N_3_9::_setRS(bool value) {
wim 30:033048611c01 2130 // The controlbits define the meaning of the next byte. This next byte can either be data or command.
wim 30:033048611c01 2131 // b8 b7...........b0
wim 30:033048611c01 2132 // RS command or data
wim 30:033048611c01 2133 //
wim 30:033048611c01 2134 // RS=1 means that next byte is data, RS=0 means that next byte is command
wim 30:033048611c01 2135 //
wim 30:033048611c01 2136
wim 30:033048611c01 2137 if (value) {
wim 30:033048611c01 2138 _controlbyte = 0x01; // Next byte is data
wim 30:033048611c01 2139 }
wim 30:033048611c01 2140 else {
wim 30:033048611c01 2141 _controlbyte = 0x00; // Next byte is command
wim 30:033048611c01 2142 }
wim 30:033048611c01 2143
wim 30:033048611c01 2144 }
wim 30:033048611c01 2145
wim 30:033048611c01 2146 // Set BL pin
wim 30:033048611c01 2147 void TextLCD_SPI_N_3_9::_setBL(bool value) {
wim 30:033048611c01 2148 if (_bl) {
wim 30:033048611c01 2149 _bl->write(value);
wim 30:033048611c01 2150 }
wim 30:033048611c01 2151 }
wim 30:033048611c01 2152
wim 30:033048611c01 2153 // Not used in this mode
wim 30:033048611c01 2154 void TextLCD_SPI_N_3_9::_setData(int value) {
wim 30:033048611c01 2155 }
wim 30:033048611c01 2156
wim 30:033048611c01 2157 // Write a byte using SPI3 9 bits mode
wim 30:033048611c01 2158 void TextLCD_SPI_N_3_9::_writeByte(int value) {
wim 30:033048611c01 2159 _cs = 0;
wim 30:033048611c01 2160 wait_us(1);
wim 30:033048611c01 2161 _spi->write( (_controlbyte << 8) | (value & 0xFF));
wim 30:033048611c01 2162 wait_us(1);
wim 30:033048611c01 2163 _cs = 1;
wim 30:033048611c01 2164 }
wim 30:033048611c01 2165
wim 30:033048611c01 2166 //------- End TextLCD_SPI_N_3_9 -----------
wim 30:033048611c01 2167 #endif
wim 21:9eb628d9e164 2168
wim 21:9eb628d9e164 2169
wim 30:033048611c01 2170 #if(0)
wim 30:033048611c01 2171 //Code checked out on logic analyser. Not yet tested on hardware..
wim 30:033048611c01 2172
wim 30:033048611c01 2173 //------- Start TextLCD_SPI_N_3_10 --------
wim 30:033048611c01 2174
wim 30:033048611c01 2175 /** Create a TextLCD interface using a controller with a native SPI3 10 bits interface
wim 30:033048611c01 2176 *
wim 30:033048611c01 2177 * @param spi SPI Bus
wim 30:033048611c01 2178 * @param cs chip select pin (active low)
wim 30:033048611c01 2179 * @param type Sets the panel size/addressing mode (default = LCD16x2)
wim 30:033048611c01 2180 * @param bl Backlight control line (optional, default = NC)
wim 30:033048611c01 2181 * @param ctrl LCD controller (default = AIP31068)
wim 30:033048611c01 2182 */
wim 30:033048611c01 2183 TextLCD_SPI_N_3_10::TextLCD_SPI_N_3_10(SPI *spi, PinName cs, LCDType type, PinName bl, LCDCtrl ctrl) :
wim 30:033048611c01 2184 TextLCD_Base(type, ctrl),
wim 30:033048611c01 2185 _spi(spi),
wim 30:033048611c01 2186 _cs(cs) {
wim 30:033048611c01 2187
wim 30:033048611c01 2188 // Setup the spi for 10 bit data, low steady state clock,
wim 30:033048611c01 2189 // rising edge capture, with a 500KHz or 1MHz clock rate
wim 30:033048611c01 2190 _spi->format(10,0);
wim 30:033048611c01 2191 _spi->frequency(1000000);
wim 30:033048611c01 2192
wim 30:033048611c01 2193 // The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
wim 30:033048611c01 2194 if (bl != NC) {
wim 30:033048611c01 2195 _bl = new DigitalOut(bl); //Construct new pin
wim 30:033048611c01 2196 _bl->write(0); //Deactivate
wim 30:033048611c01 2197 }
wim 30:033048611c01 2198 else {
wim 30:033048611c01 2199 // No Hardware Backlight pin
wim 30:033048611c01 2200 _bl = NULL; //Construct dummy pin
wim 30:033048611c01 2201 }
wim 30:033048611c01 2202
wim 30:033048611c01 2203 //Sanity check
wim 30:033048611c01 2204 if (_ctrl & LCD_C_SPI3_10) {
wim 30:033048611c01 2205 _init();
wim 30:033048611c01 2206 }
wim 30:033048611c01 2207 else {
wim 30:033048611c01 2208 error("Error: LCD Controller type does not support native SPI3 10 bits interface\n\r");
wim 30:033048611c01 2209 }
wim 30:033048611c01 2210 }
wim 30:033048611c01 2211
wim 30:033048611c01 2212 TextLCD_SPI_N_3_10::~TextLCD_SPI_N_3_10() {
wim 30:033048611c01 2213 if (_bl != NULL) {delete _bl;} // BL pin
wim 30:033048611c01 2214 }
wim 30:033048611c01 2215
wim 30:033048611c01 2216 // Not used in this mode
wim 30:033048611c01 2217 void TextLCD_SPI_N_3_10::_setEnable(bool value) {
wim 30:033048611c01 2218 }
wim 30:033048611c01 2219
wim 30:033048611c01 2220 // Set RS pin
wim 30:033048611c01 2221 // Used for mbed pins, I2C bus expander or SPI shiftregister
wim 30:033048611c01 2222 void TextLCD_SPI_N_3_10::_setRS(bool value) {
wim 30:033048611c01 2223 // The controlbits define the meaning of the next byte. This next byte can either be data or command.
wim 30:033048611c01 2224 // b9 b8 b7...........b0
wim 30:033048611c01 2225 // RS RW command or data
wim 30:033048611c01 2226 //
wim 30:033048611c01 2227 // RS=1 means that next byte is data, RS=0 means that next byte is command
wim 30:033048611c01 2228 // RW=0 means that next byte is writen, RW=1 means that next byte is read (not used in this lib)
wim 30:033048611c01 2229 //
wim 30:033048611c01 2230
wim 30:033048611c01 2231 if (value) {
wim 30:033048611c01 2232 _controlbyte = 0x02; // Next byte is data
wim 30:033048611c01 2233 }
wim 30:033048611c01 2234 else {
wim 30:033048611c01 2235 _controlbyte = 0x00; // Next byte is command
wim 30:033048611c01 2236 }
wim 30:033048611c01 2237
wim 30:033048611c01 2238 }
wim 30:033048611c01 2239
wim 30:033048611c01 2240 // Set BL pin
wim 30:033048611c01 2241 void TextLCD_SPI_N_3_10::_setBL(bool value) {
wim 30:033048611c01 2242 if (_bl) {
wim 30:033048611c01 2243 _bl->write(value);
wim 30:033048611c01 2244 }
wim 30:033048611c01 2245 }
wim 30:033048611c01 2246
wim 30:033048611c01 2247 // Not used in this mode
wim 30:033048611c01 2248 void TextLCD_SPI_N_3_10::_setData(int value) {
wim 30:033048611c01 2249 }
wim 30:033048611c01 2250
wim 30:033048611c01 2251 // Write a byte using SPI3 10 bits mode
wim 30:033048611c01 2252 void TextLCD_SPI_N_3_10::_writeByte(int value) {
wim 30:033048611c01 2253 _cs = 0;
wim 30:033048611c01 2254 wait_us(1);
wim 30:033048611c01 2255 _spi->write( (_controlbyte << 8) | (value & 0xFF));
wim 30:033048611c01 2256 wait_us(1);
wim 30:033048611c01 2257 _cs = 1;
wim 30:033048611c01 2258 }
wim 30:033048611c01 2259
wim 30:033048611c01 2260 //------- End TextLCD_SPI_N_3_10 ----------
wim 30:033048611c01 2261 #endif