address modified to run with my LCD

Dependents:   DS1302_test_with_STM32_and_LCD16x2

Committer:
wim
Date:
Thu Aug 28 15:44:08 2014 +0000
Revision:
33:900a94bc7585
Parent:
32:59c4b8f648d4
Child:
34:e5a0dcb43ecc
Added support for controllers US2066/SSD1311 (OLED), added setUDCBlink method for supported devices (eg SSD1803), fixed issue in setPower()

Who changed what in which revision?

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