Gabriel Ligeiro / Projeto_Mecat_Pingos

Projeto Mecatronicos do grupo Pingos nos I's

TextLCD.cpp@0:ebea19a646c3, 2019-06-13 (annotated)

Committer:
ligeiro13
Date:
Thu Jun 13 16:15:40 2019 +0000
Revision:
0:ebea19a646c3
ihm

Who changed what in which revision?

UserRevisionLine numberNew contents of line
ligeiro13 0:ebea19a646c3 1 /* mbed TextLCD Library, for LCDs based on HD44780 controllers
ligeiro13 0:ebea19a646c3 2 * Copyright (c) 2007-2010, sford, http://mbed.org
ligeiro13 0:ebea19a646c3 3 * 2013, v01: WH, Added LCD types, fixed LCD address issues, added Cursor and UDCs
ligeiro13 0:ebea19a646c3 4 * 2013, v02: WH, Added I2C and SPI bus interfaces
ligeiro13 0:ebea19a646c3 5 * 2013, v03: WH, Added support for LCD40x4 which uses 2 controllers
ligeiro13 0:ebea19a646c3 6 * 2013, v04: WH, Added support for Display On/Off, improved 4bit bootprocess
ligeiro13 0:ebea19a646c3 7 * 2013, v05: WH, Added support for 8x2B, added some UDCs
ligeiro13 0:ebea19a646c3 8 * 2013, v06: WH, Added support for devices that use internal DC/DC converters
ligeiro13 0:ebea19a646c3 9 * 2013, v07: WH, Added support for backlight and include portdefinitions for LCD2004 Module from DFROBOT
ligeiro13 0:ebea19a646c3 10 * 2014, v08: WH, Refactored in Base and Derived Classes to deal with mbed lib change regarding 'NC' defined pins
ligeiro13 0:ebea19a646c3 11 * 2014, v09: WH/EO, Added Class for Native SPI controllers such as ST7032
ligeiro13 0:ebea19a646c3 12 * 2014, v10: WH, Added Class for Native I2C controllers such as ST7032i, Added support for MCP23008 I2C portexpander, Added support for Adafruit module
ligeiro13 0:ebea19a646c3 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
ligeiro13 0:ebea19a646c3 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)
ligeiro13 0:ebea19a646c3 15 * 2014, v13: WH, Added support for controllers US2066/SSD1311 (OLED), added setUDCBlink() method for supported devices (eg SSD1803), fixed issue in setPower()
ligeiro13 0:ebea19a646c3 16 * 2014, v14: WH, Added support for PT6314 (VFD), added setOrient() method for supported devices (eg SSD1803, US2066), added Double Height lines for supported devices,
ligeiro13 0:ebea19a646c3 17 * added 16 UDCs for supported devices (eg PCF2103), moved UDC defines to TextLCD_UDC file, added TextLCD_Config.h for feature and footprint settings.
ligeiro13 0:ebea19a646c3 18 * 2014, v15: WH, Added AC780 support, added I2C expander modules, fixed setBacklight() for inverted logic modules. Fixed bug in LCD_SPI_N define
ligeiro13 0:ebea19a646c3 19 * 2014, v16: WH, Added ST7070 and KS0073 support, added setIcon(), clrIcon() and setInvert() method for supported devices
ligeiro13 0:ebea19a646c3 20 * 2015, v17: WH, Clean up low-level _writeCommand() and _writeData(), Added support for alternative fonttables (eg PCF21XX), Added ST7066_ACM controller for ACM1602 module
ligeiro13 0:ebea19a646c3 21 * 2015, v18: WH, Performance improvement I2C portexpander
ligeiro13 0:ebea19a646c3 22 * 2015, v19: WH, Fixed Adafruit I2C/SPI portexpander pinmappings, fixed SYDZ Backlight
ligeiro13 0:ebea19a646c3 23 * 2015, v20: WH, Fixed occasional Init fail caused by insufficient wait time after ReturnHome command (0x02), Added defines to reduce memory footprint (eg LCD_ICON),
ligeiro13 0:ebea19a646c3 24 * Fixed and Added more fonttable support for PCF2119R_3V3, Added HD66712 controller.
ligeiro13 0:ebea19a646c3 25 * 2015, v21: WH, Added LCD32x2 defines and code, Fixed KS0073 DL=1 init for SPI, Added defines to reduce memory footprint (LCD_TWO_CTRL, LCD_CONTRAST, LCD_UTF8_FONT)
ligeiro13 0:ebea19a646c3 26 * Added SPLC792A controller, Added UTF8_2_LCD decode for Cyrilic font (By Andriy Ribalko). Added setFont()
ligeiro13 0:ebea19a646c3 27 *
ligeiro13 0:ebea19a646c3 28 * Permission is hereby granted, free of charge, to any person obtaining a copy
ligeiro13 0:ebea19a646c3 29 * of this software and associated documentation files (the "Software"), to deal
ligeiro13 0:ebea19a646c3 30 * in the Software without restriction, including without limitation the rights
ligeiro13 0:ebea19a646c3 31 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
ligeiro13 0:ebea19a646c3 32 * copies of the Software, and to permit persons to whom the Software is
ligeiro13 0:ebea19a646c3 33 * furnished to do so, subject to the following conditions:
ligeiro13 0:ebea19a646c3 34 *
ligeiro13 0:ebea19a646c3 35 * The above copyright notice and this permission notice shall be included in
ligeiro13 0:ebea19a646c3 36 * all copies or substantial portions of the Software.
ligeiro13 0:ebea19a646c3 37 *
ligeiro13 0:ebea19a646c3 38 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
ligeiro13 0:ebea19a646c3 39 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
ligeiro13 0:ebea19a646c3 40 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
ligeiro13 0:ebea19a646c3 41 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
ligeiro13 0:ebea19a646c3 42 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
ligeiro13 0:ebea19a646c3 43 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
ligeiro13 0:ebea19a646c3 44 * THE SOFTWARE.
ligeiro13 0:ebea19a646c3 45 */
ligeiro13 0:ebea19a646c3 46 #include "mbed.h"
ligeiro13 0:ebea19a646c3 47 #include "TextLCD.h"
ligeiro13 0:ebea19a646c3 48 #include "TextLCD_UDC.inc"
ligeiro13 0:ebea19a646c3 49 #include "TextLCD_UTF8.inc"
ligeiro13 0:ebea19a646c3 50
ligeiro13 0:ebea19a646c3 51 /** Create a TextLCD_Base interface
ligeiro13 0:ebea19a646c3 52 *
ligeiro13 0:ebea19a646c3 53 * @param type Sets the panel size/addressing mode (default = LCD16x2)
ligeiro13 0:ebea19a646c3 54 * @param ctrl LCD controller (default = HD44780)
ligeiro13 0:ebea19a646c3 55 */
ligeiro13 0:ebea19a646c3 56 TextLCD_Base::TextLCD_Base(LCDType type, LCDCtrl ctrl) : _type(type), _ctrl(ctrl) {
ligeiro13 0:ebea19a646c3 57
ligeiro13 0:ebea19a646c3 58 // Extract LCDType data
ligeiro13 0:ebea19a646c3 59
ligeiro13 0:ebea19a646c3 60 // Columns encoded in b15..b8
ligeiro13 0:ebea19a646c3 61 _nr_cols = (_type & LCD_T_COL_MSK) >> LCD_T_COL_SHFT;
ligeiro13 0:ebea19a646c3 62
ligeiro13 0:ebea19a646c3 63 // Rows encoded in b23..b16
ligeiro13 0:ebea19a646c3 64 _nr_rows = (_type & LCD_T_ROW_MSK) >> LCD_T_ROW_SHFT;
ligeiro13 0:ebea19a646c3 65
ligeiro13 0:ebea19a646c3 66 // Addressing mode encoded in b27..b24
ligeiro13 0:ebea19a646c3 67 _addr_mode = _type & LCD_T_ADR_MSK;
ligeiro13 0:ebea19a646c3 68
ligeiro13 0:ebea19a646c3 69 // Font table, encoded in LCDCtrl
ligeiro13 0:ebea19a646c3 70 _font = _ctrl & LCD_C_FNT_MSK;
ligeiro13 0:ebea19a646c3 71 }
ligeiro13 0:ebea19a646c3 72
ligeiro13 0:ebea19a646c3 73 /** Init the LCD Controller(s)
ligeiro13 0:ebea19a646c3 74 * Clear display
ligeiro13 0:ebea19a646c3 75 * @param _LCDDatalength dl sets the datalength of data/commands
ligeiro13 0:ebea19a646c3 76 * @return none
ligeiro13 0:ebea19a646c3 77 */
ligeiro13 0:ebea19a646c3 78 void TextLCD_Base::_init(_LCDDatalength dl) {
ligeiro13 0:ebea19a646c3 79
ligeiro13 0:ebea19a646c3 80 wait_ms(100); // Wait 100ms to ensure powered up
ligeiro13 0:ebea19a646c3 81
ligeiro13 0:ebea19a646c3 82 #if (LCD_TWO_CTRL == 1)
ligeiro13 0:ebea19a646c3 83 // Select and configure second LCD controller when needed
ligeiro13 0:ebea19a646c3 84 if(_type==LCD40x4) {
ligeiro13 0:ebea19a646c3 85 _ctrl_idx=_LCDCtrl_1; // Select 2nd controller
ligeiro13 0:ebea19a646c3 86 _initCtrl(dl); // Init 2nd controller
ligeiro13 0:ebea19a646c3 87 }
ligeiro13 0:ebea19a646c3 88 #endif
ligeiro13 0:ebea19a646c3 89
ligeiro13 0:ebea19a646c3 90 // Select and configure primary LCD controller
ligeiro13 0:ebea19a646c3 91 _ctrl_idx=_LCDCtrl_0; // Select primary controller
ligeiro13 0:ebea19a646c3 92 _initCtrl(dl); // Init primary controller
ligeiro13 0:ebea19a646c3 93
ligeiro13 0:ebea19a646c3 94 // Clear whole display and Reset Cursor location
ligeiro13 0:ebea19a646c3 95 // Note: This will make sure that some 3-line displays that skip topline of a 4-line configuration
ligeiro13 0:ebea19a646c3 96 // are cleared and init cursor correctly.
ligeiro13 0:ebea19a646c3 97 cls();
ligeiro13 0:ebea19a646c3 98 }
ligeiro13 0:ebea19a646c3 99
ligeiro13 0:ebea19a646c3 100 /** Init the LCD controller
ligeiro13 0:ebea19a646c3 101 * Set number of lines, fonttype, no cursor etc
ligeiro13 0:ebea19a646c3 102 * The controller is accessed in 4-bit parallel mode either directly via mbed pins or through I2C or SPI expander.
ligeiro13 0:ebea19a646c3 103 * Some controllers also support native I2C or SPI interfaces.
ligeiro13 0:ebea19a646c3 104 *
ligeiro13 0:ebea19a646c3 105 * @param _LCDDatalength dl sets the 4 or 8 bit datalength of data/commands. Required for some native serial modes that dont work when DL=0.
ligeiro13 0:ebea19a646c3 106 * @return none
ligeiro13 0:ebea19a646c3 107 *
ligeiro13 0:ebea19a646c3 108 * Note: some configurations are commented out because they have not yet been tested due to lack of hardware
ligeiro13 0:ebea19a646c3 109 */
ligeiro13 0:ebea19a646c3 110 void TextLCD_Base::_initCtrl(_LCDDatalength dl) {
ligeiro13 0:ebea19a646c3 111 int _bias_lines=0; // Set Bias and lines (Instr Set 1), temporary variable.
ligeiro13 0:ebea19a646c3 112 int _lines=0; // Set lines (Ext Instr Set), temporary variable.
ligeiro13 0:ebea19a646c3 113
ligeiro13 0:ebea19a646c3 114 this->_setRS(false); // command mode
ligeiro13 0:ebea19a646c3 115
ligeiro13 0:ebea19a646c3 116 if (dl == _LCD_DL_4) {
ligeiro13 0:ebea19a646c3 117 // The Controller could be in 8 bit mode (power-on reset) or in 4 bit mode (warm reboot) at this point.
ligeiro13 0:ebea19a646c3 118 // Follow this procedure to make sure the Controller enters the correct state. The hardware interface
ligeiro13 0:ebea19a646c3 119 // between the uP and the LCD can only write the 4 most significant bits (Most Significant Nibble, MSN).
ligeiro13 0:ebea19a646c3 120 // In 4 bit mode the LCD expects the MSN first, followed by the LSN.
ligeiro13 0:ebea19a646c3 121 //
ligeiro13 0:ebea19a646c3 122 // Current state: 8 bit mode | 4 bit mode, MSN is next | 4 bit mode, LSN is next
ligeiro13 0:ebea19a646c3 123 //-------------------------------------------------------------------------------------------------
ligeiro13 0:ebea19a646c3 124 _writeNibble(0x3); // set 8 bit mode (MSN) and dummy LSN, | set 8 bit mode (MSN), | set dummy LSN,
ligeiro13 0:ebea19a646c3 125 // remains in 8 bit mode | remains in 4 bit mode | remains in 4 bit mode
ligeiro13 0:ebea19a646c3 126 wait_ms(15); //
ligeiro13 0:ebea19a646c3 127
ligeiro13 0:ebea19a646c3 128 _writeNibble(0x3); // set 8 bit mode (MSN) and dummy LSN, | set dummy LSN, | set 8bit mode (MSN),
ligeiro13 0:ebea19a646c3 129 // remains in 8 bit mode | change to 8 bit mode | remains in 4 bit mode
ligeiro13 0:ebea19a646c3 130 wait_ms(15); //
ligeiro13 0:ebea19a646c3 131
ligeiro13 0:ebea19a646c3 132 _writeNibble(0x3); // set 8 bit mode (MSN) and dummy LSN, | set 8 bit mode (MSN) and dummy LSN, | set dummy LSN,
ligeiro13 0:ebea19a646c3 133 // remains in 8 bit mode | remains in 8 bit mode | change to 8 bit mode
ligeiro13 0:ebea19a646c3 134 wait_ms(15); //
ligeiro13 0:ebea19a646c3 135
ligeiro13 0:ebea19a646c3 136 // Controller is now in 8 bit mode
ligeiro13 0:ebea19a646c3 137
ligeiro13 0:ebea19a646c3 138 _writeNibble(0x2); // Change to 4-bit mode (MSN), the LSN is undefined dummy
ligeiro13 0:ebea19a646c3 139 wait_us(40); // most instructions take 40us
ligeiro13 0:ebea19a646c3 140
ligeiro13 0:ebea19a646c3 141 // Controller is now in 4-bit mode
ligeiro13 0:ebea19a646c3 142 // Note: 4/8 bit mode is ignored for most native SPI and I2C devices. They dont use the parallel bus.
ligeiro13 0:ebea19a646c3 143 // However, _writeNibble() method is void anyway for native SPI and I2C devices.
ligeiro13 0:ebea19a646c3 144 }
ligeiro13 0:ebea19a646c3 145 else {
ligeiro13 0:ebea19a646c3 146 // Reset in 8 bit mode, final Function set will follow
ligeiro13 0:ebea19a646c3 147 _writeCommand(0x30); // Function set 0 0 1 DL=1 N F x x
ligeiro13 0:ebea19a646c3 148 wait_ms(1); // most instructions take 40us
ligeiro13 0:ebea19a646c3 149 }
ligeiro13 0:ebea19a646c3 150
ligeiro13 0:ebea19a646c3 151 // Device specific initialisations: DC/DC converter to generate VLCD or VLED, number of lines etc
ligeiro13 0:ebea19a646c3 152 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 153
ligeiro13 0:ebea19a646c3 154 case KS0073:
ligeiro13 0:ebea19a646c3 155 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 156 switch (_type) {
ligeiro13 0:ebea19a646c3 157 // case LCD6x1:
ligeiro13 0:ebea19a646c3 158 case LCD8x1: //8x1 is a regular 1 line display
ligeiro13 0:ebea19a646c3 159 // case LCD8x2B: //8x1 is a 16x1 line display
ligeiro13 0:ebea19a646c3 160 case LCD12x1:
ligeiro13 0:ebea19a646c3 161 case LCD16x1:
ligeiro13 0:ebea19a646c3 162 case LCD20x1:
ligeiro13 0:ebea19a646c3 163 case LCD24x1:
ligeiro13 0:ebea19a646c3 164 // case LCD32x1: // EXT pin is High, extension driver needed
ligeiro13 0:ebea19a646c3 165 // case LCD40x1: // EXT pin is High, extension driver needed
ligeiro13 0:ebea19a646c3 166 // case LCD52x1: // EXT pin is High, extension driver needed
ligeiro13 0:ebea19a646c3 167 _function = dl | 0x02; // Set function, 0 0 1 DL, N, RE(0), DH, REV
ligeiro13 0:ebea19a646c3 168 // Note: 4 bit mode is NOT ignored for native SPI !
ligeiro13 0:ebea19a646c3 169 // DL=1 (8 bits bus), DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 170 // N=0 (1-line mode), N=1 (2-line mode), dont care for 4 line mode
ligeiro13 0:ebea19a646c3 171 // RE=0 (Dis. Extended Regs, special mode for KS0073)
ligeiro13 0:ebea19a646c3 172 // DH=1 (Disp shift enable, special mode for KS0073)
ligeiro13 0:ebea19a646c3 173 // REV=0 (Reverse normal, special mode for KS0073)
ligeiro13 0:ebea19a646c3 174
ligeiro13 0:ebea19a646c3 175 _function_1 = dl | 0x04; // Set function, 0 0 1 DL, N, RE(1), BE, LP (Ext Regs)
ligeiro13 0:ebea19a646c3 176 // Note: 4 bit mode is NOT ignored for native SPI !
ligeiro13 0:ebea19a646c3 177 // DL=1 (8 bits bus), DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 178 // N=0 (1-line mode), N=1 (2-line mode), dont care for 4 line mode
ligeiro13 0:ebea19a646c3 179 // RE=1 (Ena Extended Regs, special mode for KS0073)
ligeiro13 0:ebea19a646c3 180 // BE=0 (Blink Enable, CG/SEG RAM, special mode for KS0073)
ligeiro13 0:ebea19a646c3 181 // LP=0 (LP=1 Low power mode, LP=0 Normal)
ligeiro13 0:ebea19a646c3 182
ligeiro13 0:ebea19a646c3 183 _function_x = 0x00; // Ext Function set 0000 1 FW BW NW (Ext Regs)
ligeiro13 0:ebea19a646c3 184 // NW=0 (1,2 line), NW=1 (4 Line, special mode for KS0073)
ligeiro13 0:ebea19a646c3 185 break;
ligeiro13 0:ebea19a646c3 186
ligeiro13 0:ebea19a646c3 187 // case LCD12x3D: // Special mode for KS0073, KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 188 // case LCD12x3D1: // Special mode for KS0073, KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 189 case LCD12x4D: // Special mode for KS0073, KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 190 // case LCD16x3D: // Special mode for KS0073, KS0078
ligeiro13 0:ebea19a646c3 191 // case LCD16x3D1: // Special mode for KS0073, KS0078
ligeiro13 0:ebea19a646c3 192 // case LCD16x4D: // Special mode for KS0073, KS0078
ligeiro13 0:ebea19a646c3 193 case LCD20x4D: // Special mode for KS0073, KS0078
ligeiro13 0:ebea19a646c3 194 _function = dl | 0x02; // Set function, 0 0 1 DL, N, RE(0), DH, REV
ligeiro13 0:ebea19a646c3 195 // Note: 4 bit mode is NOT ignored for native SPI !
ligeiro13 0:ebea19a646c3 196 // DL=1 (8 bits bus), DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 197 // N=0 (1-line mode), N=1 (2-line mode), dont care for 4 line mode
ligeiro13 0:ebea19a646c3 198 // RE=0 (Dis. Extended Regs, special mode for KS0073)
ligeiro13 0:ebea19a646c3 199 // DH=1 (Disp shift enable, special mode for KS0073)
ligeiro13 0:ebea19a646c3 200 // REV=0 (Reverse normal, special mode for KS0073)
ligeiro13 0:ebea19a646c3 201
ligeiro13 0:ebea19a646c3 202 _function_1 = dl | 0x04; // Set function, 0 0 1 DL, N, RE(1), BE, LP (Ext Regs)
ligeiro13 0:ebea19a646c3 203 // Note: 4 bit mode is NOT ignored for native SPI !
ligeiro13 0:ebea19a646c3 204 // DL=1 (8 bits bus), DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 205 // N=0 (1-line mode), N=1 (2-line mode), dont care for 4 line mode
ligeiro13 0:ebea19a646c3 206 // RE=1 (Ena Extended Regs, special mode for KS0073)
ligeiro13 0:ebea19a646c3 207 // BE=0 (Blink Enable, CG/SEG RAM, special mode for KS0073)
ligeiro13 0:ebea19a646c3 208 // LP=0 (LP=1 Low power mode, LP=0 Normal)
ligeiro13 0:ebea19a646c3 209
ligeiro13 0:ebea19a646c3 210 _function_x = 0x01; // Ext Function set 0000 1 FW BW NW (Ext Regs)
ligeiro13 0:ebea19a646c3 211 // NW=0 (1,2 line), NW=1 (4 Line, special mode for KS0073)
ligeiro13 0:ebea19a646c3 212 break;
ligeiro13 0:ebea19a646c3 213
ligeiro13 0:ebea19a646c3 214 // case LCD6x2:
ligeiro13 0:ebea19a646c3 215 case LCD8x2:
ligeiro13 0:ebea19a646c3 216 case LCD16x2:
ligeiro13 0:ebea19a646c3 217 // case LCD16x1C:
ligeiro13 0:ebea19a646c3 218 case LCD20x2:
ligeiro13 0:ebea19a646c3 219 case LCD24x2:
ligeiro13 0:ebea19a646c3 220 case LCD32x2:
ligeiro13 0:ebea19a646c3 221 // All other LCD types are initialised as 2 Line displays
ligeiro13 0:ebea19a646c3 222 _function = dl | 0x0A; // Set function, 0 0 1 DL, N, RE(0), DH, REV
ligeiro13 0:ebea19a646c3 223 // Note: 4 bit mode is NOT ignored for native SPI !
ligeiro13 0:ebea19a646c3 224 // DL=1 (8 bits bus), DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 225 // N=1 (2-line mode), N=0 (1-line mode)
ligeiro13 0:ebea19a646c3 226 // RE=0 (Dis. Extended Regs, special mode for KS0073)
ligeiro13 0:ebea19a646c3 227 // DH=1 (Disp shift enable, special mode for KS0073)
ligeiro13 0:ebea19a646c3 228 // REV=0 (Reverse normal, special mode for KS0073)
ligeiro13 0:ebea19a646c3 229
ligeiro13 0:ebea19a646c3 230 _function_1 = dl | 0x0C; // Set function, 0 0 1 DL, N, RE(1), BE, LP (Ext Regs)
ligeiro13 0:ebea19a646c3 231 // Note: 4 bit mode is NOT ignored for native SPI !
ligeiro13 0:ebea19a646c3 232 // DL=1 (8 bits bus), DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 233 // N=1 (2 line mode), N=0 (1-line mode)
ligeiro13 0:ebea19a646c3 234 // RE=1 (Ena Extended Regs, special mode for KS0073)
ligeiro13 0:ebea19a646c3 235 // BE=0 (Blink Enable, CG/SEG RAM, special mode for KS0073)
ligeiro13 0:ebea19a646c3 236 // LP=0 (LP=1 Low power mode, LP=0 Normal)
ligeiro13 0:ebea19a646c3 237
ligeiro13 0:ebea19a646c3 238 _function_x = 0x00; // Ext Function set 0000 1 FW BW NW (Ext Regs)
ligeiro13 0:ebea19a646c3 239 // NW=0 (1,2 line), NW=1 (4 Line, special mode for KS0073)
ligeiro13 0:ebea19a646c3 240 break;
ligeiro13 0:ebea19a646c3 241
ligeiro13 0:ebea19a646c3 242 default:
ligeiro13 0:ebea19a646c3 243 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 244 break;
ligeiro13 0:ebea19a646c3 245 } // switch type
ligeiro13 0:ebea19a646c3 246
ligeiro13 0:ebea19a646c3 247 // init special features
ligeiro13 0:ebea19a646c3 248 _writeCommand(0x20 | _function_1);// Function set 001 DL N RE(1) BE LP (Ext Regs)
ligeiro13 0:ebea19a646c3 249 // DL=0 (4 bits bus), DL=1 (8 bits mode)
ligeiro13 0:ebea19a646c3 250 // N=0 (1 line mode), N=1 (2 line mode)
ligeiro13 0:ebea19a646c3 251 // RE=1 (Ena Extended Regs, special mode for KS0073)
ligeiro13 0:ebea19a646c3 252 // BE=0 (Blink Enable/Disable, CG/SEG RAM, special mode for KS0073)
ligeiro13 0:ebea19a646c3 253 // LP=0 (LP=1 Low power mode, LP=0 Normal)
ligeiro13 0:ebea19a646c3 254
ligeiro13 0:ebea19a646c3 255 _writeCommand(0x08 | _function_x); // Ext Function set 0000 1 FW BW NW (Ext Regs)
ligeiro13 0:ebea19a646c3 256 // FW=0 (5-dot font, special mode for KS0073)
ligeiro13 0:ebea19a646c3 257 // BW=0 (Cur BW invert disable, special mode for KS0073)
ligeiro13 0:ebea19a646c3 258 // NW=0 (1,2 Line), NW=1 (4 line, special mode for KS0073)
ligeiro13 0:ebea19a646c3 259
ligeiro13 0:ebea19a646c3 260 _writeCommand(0x10); // Scroll/Shift set 0001 DS/HS4 DS/HS3 DS/HS2 DS/HS1 (Ext Regs)
ligeiro13 0:ebea19a646c3 261 // Dotscroll/Display shift enable (Special mode for KS0073)
ligeiro13 0:ebea19a646c3 262
ligeiro13 0:ebea19a646c3 263 _writeCommand(0x80); // Scroll Quantity set 1 0 SQ5 SQ4 SQ3 SQ2 SQ1 SQ0 (Ext Regs)
ligeiro13 0:ebea19a646c3 264 // Scroll quantity (Special mode for KS0073)
ligeiro13 0:ebea19a646c3 265
ligeiro13 0:ebea19a646c3 266 _writeCommand(0x20 | _function); // Function set 001 DL N RE(0) DH REV (Std Regs)
ligeiro13 0:ebea19a646c3 267 // DL=0 (4 bits bus), DL=1 (8 bits mode)
ligeiro13 0:ebea19a646c3 268 // N=0 (1 line mode), N=1 (2 line mode)
ligeiro13 0:ebea19a646c3 269 // RE=0 (Dis. Extended Regs, special mode for KS0073)
ligeiro13 0:ebea19a646c3 270 // DH=1 (Disp shift enable/disable, special mode for KS0073)
ligeiro13 0:ebea19a646c3 271 // REV=0 (Reverse/Normal, special mode for KS0073)
ligeiro13 0:ebea19a646c3 272 break; // case KS0073 Controller
ligeiro13 0:ebea19a646c3 273
ligeiro13 0:ebea19a646c3 274
ligeiro13 0:ebea19a646c3 275 case KS0078:
ligeiro13 0:ebea19a646c3 276 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 277 switch (_type) {
ligeiro13 0:ebea19a646c3 278 case LCD8x1: //8x1 is a regular 1 line display
ligeiro13 0:ebea19a646c3 279 case LCD8x2B: //8x2B is a special case of 16x1
ligeiro13 0:ebea19a646c3 280 // case LCD12x1:
ligeiro13 0:ebea19a646c3 281 case LCD16x1:
ligeiro13 0:ebea19a646c3 282 // case LCD20x1:
ligeiro13 0:ebea19a646c3 283 case LCD24x1:
ligeiro13 0:ebea19a646c3 284 _function = dl | 0x02; // Function set 001 DL N RE(0) DH REV (Std Regs)
ligeiro13 0:ebea19a646c3 285 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 286 // N=0 (1 line mode), N=1 (2 line mode)
ligeiro13 0:ebea19a646c3 287 // RE=0 (Dis. Extended Regs, special mode for KS0078)
ligeiro13 0:ebea19a646c3 288 // DH=1 (Disp shift enable, special mode for KS0078)
ligeiro13 0:ebea19a646c3 289 // REV=0 (Reverse normal, special mode for KS0078)
ligeiro13 0:ebea19a646c3 290
ligeiro13 0:ebea19a646c3 291 _function_1 = dl | 0x04; // Function set 001 DL N RE(1) BE 0 (Ext Regs)
ligeiro13 0:ebea19a646c3 292 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 293 // N=0 (1 line mode), N=1 (2 line mode)
ligeiro13 0:ebea19a646c3 294 // RE=1 (Ena Extended Regs, special mode for KS0078)
ligeiro13 0:ebea19a646c3 295 // BE=0 (Blink Enable, CG/SEG RAM, special mode for KS0078)
ligeiro13 0:ebea19a646c3 296 // 0
ligeiro13 0:ebea19a646c3 297
ligeiro13 0:ebea19a646c3 298 _function_x = 0x00; // Ext Function set 0000 1 FW BW NW (Ext Regs)
ligeiro13 0:ebea19a646c3 299 // NW=0 (1,2 line), NW=1 (4 Line, special mode for KS0078)
ligeiro13 0:ebea19a646c3 300 break;
ligeiro13 0:ebea19a646c3 301
ligeiro13 0:ebea19a646c3 302 // case LCD12x3D: // Special mode for KS0073, KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 303 // case LCD12x3D1: // Special mode for KS0073, KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 304 // case LCD12x4D: // Special mode for KS0073, KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 305 // case LCD16x3D: // Special mode for KS0073, KS0078
ligeiro13 0:ebea19a646c3 306 // case LCD16x4D: // Special mode for KS0073, KS0078
ligeiro13 0:ebea19a646c3 307 // case LCD20x4D: // Special mode for KS0073, KS0078
ligeiro13 0:ebea19a646c3 308 // case LCD24x3D: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 309 // case LCD24x3D1: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 310 case LCD24x4D: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 311 _function = dl | 0x02; // Function set 001 DL N RE(0) DH REV (Std Regs)
ligeiro13 0:ebea19a646c3 312 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 313 // N=0 (dont care for 4 line mode)
ligeiro13 0:ebea19a646c3 314 // RE=0 (Dis. Extended Regs, special mode for KS0078)
ligeiro13 0:ebea19a646c3 315 // DH=1 (Disp shift enable, special mode for KS0078)
ligeiro13 0:ebea19a646c3 316 // REV=0 (Reverse normal, special mode for KS0078)
ligeiro13 0:ebea19a646c3 317
ligeiro13 0:ebea19a646c3 318 _function_1 = dl | 0x04; // Function set 001 DL N RE(1) BE 0 (Ext Regs)
ligeiro13 0:ebea19a646c3 319 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 320 // N=0 (1 line mode), N=1 (2 line mode)
ligeiro13 0:ebea19a646c3 321 // RE=1 (Ena Extended Regs, special mode for KS0078)
ligeiro13 0:ebea19a646c3 322 // BE=0 (Blink Enable, CG/SEG RAM, special mode for KS0078)
ligeiro13 0:ebea19a646c3 323 // 0
ligeiro13 0:ebea19a646c3 324
ligeiro13 0:ebea19a646c3 325 _function_x = 0x01; // Ext Function set 0000 1 FW BW NW (Ext Regs)
ligeiro13 0:ebea19a646c3 326 // NW=0 (1,2 line), NW=1 (4 Line, special mode for KS0078)
ligeiro13 0:ebea19a646c3 327 break;
ligeiro13 0:ebea19a646c3 328
ligeiro13 0:ebea19a646c3 329 // case LCD6x2:
ligeiro13 0:ebea19a646c3 330 case LCD8x2:
ligeiro13 0:ebea19a646c3 331 case LCD16x2:
ligeiro13 0:ebea19a646c3 332 // case LCD16x1C:
ligeiro13 0:ebea19a646c3 333 case LCD20x2:
ligeiro13 0:ebea19a646c3 334 case LCD24x2:
ligeiro13 0:ebea19a646c3 335 case LCD32x2:
ligeiro13 0:ebea19a646c3 336 case LCD40x2:
ligeiro13 0:ebea19a646c3 337 // All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
ligeiro13 0:ebea19a646c3 338 _function = dl | 0x0A; // Function set 001 DL N RE(0) DH REV (Std Regs)
ligeiro13 0:ebea19a646c3 339 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 340 // N=1 (1 line mode), N=1 (2 line mode)
ligeiro13 0:ebea19a646c3 341 // RE=0 (Dis. Extended Regs, special mode for KS0078)
ligeiro13 0:ebea19a646c3 342 // DH=1 (Disp shift enable, special mode for KS0078)
ligeiro13 0:ebea19a646c3 343 // REV=0 (Reverse normal, special mode for KS0078)
ligeiro13 0:ebea19a646c3 344
ligeiro13 0:ebea19a646c3 345 _function_1 = dl | 0x0C; // Function set 001 DL N RE(1) BE 0 (Ext Regs)
ligeiro13 0:ebea19a646c3 346 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 347 // N=1 (1 line mode), N=1 (2 line mode)
ligeiro13 0:ebea19a646c3 348 // RE=1 (Ena Extended Regs, special mode for KS0078)
ligeiro13 0:ebea19a646c3 349 // BE=0 (Blink Enable, CG/SEG RAM, special mode for KS0078)
ligeiro13 0:ebea19a646c3 350 // 0
ligeiro13 0:ebea19a646c3 351
ligeiro13 0:ebea19a646c3 352 _function_x = 0x00; // Ext Function set 0000 1 FW BW NW (Ext Regs)
ligeiro13 0:ebea19a646c3 353 // NW=0 (1,2 line), NW=1 (4 Line, special mode for KS0078)
ligeiro13 0:ebea19a646c3 354 break;
ligeiro13 0:ebea19a646c3 355
ligeiro13 0:ebea19a646c3 356 default:
ligeiro13 0:ebea19a646c3 357 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 358 break;
ligeiro13 0:ebea19a646c3 359 } // switch type
ligeiro13 0:ebea19a646c3 360
ligeiro13 0:ebea19a646c3 361 // init special features
ligeiro13 0:ebea19a646c3 362 _writeCommand(0x20 | _function_1);// Function set 001 DL N RE(1) BE 0 (Ext Regs)
ligeiro13 0:ebea19a646c3 363 // DL=0 (4 bits bus), DL=1 (8 bits mode)
ligeiro13 0:ebea19a646c3 364 // N=0 (1 line mode), N=1 (2 line mode)
ligeiro13 0:ebea19a646c3 365 // RE=1 (Ena Extended Regs, special mode for KS0078)
ligeiro13 0:ebea19a646c3 366 // BE=0 (Blink Enable/Disable, CG/SEG RAM, special mode for KS0078)
ligeiro13 0:ebea19a646c3 367 // 0
ligeiro13 0:ebea19a646c3 368
ligeiro13 0:ebea19a646c3 369 _writeCommand(0x08 | _function_x); // Ext Function set 0000 1 FW BW NW (Ext Regs)
ligeiro13 0:ebea19a646c3 370 // FW=0 (5-dot font, special mode for KS0078)
ligeiro13 0:ebea19a646c3 371 // BW=0 (Cur BW invert disable, special mode for KS0078)
ligeiro13 0:ebea19a646c3 372 // NW=0 (1,2 Line), NW=1 (4 line, special mode for KS0078)
ligeiro13 0:ebea19a646c3 373
ligeiro13 0:ebea19a646c3 374 _writeCommand(0x10); // Scroll/Shift set 0001 DS/HS4 DS/HS3 DS/HS2 DS/HS1 (Ext Regs)
ligeiro13 0:ebea19a646c3 375 // Dotscroll/Display shift enable (Special mode for KS0078)
ligeiro13 0:ebea19a646c3 376
ligeiro13 0:ebea19a646c3 377 _writeCommand(0x80); // Scroll Quantity set 1 0 SQ5 SQ4 SQ3 SQ2 SQ1 SQ0 (Ext Regs)
ligeiro13 0:ebea19a646c3 378 // Scroll quantity (Special mode for KS0078)
ligeiro13 0:ebea19a646c3 379
ligeiro13 0:ebea19a646c3 380 _writeCommand(0x20 | _function); // Function set 001 DL N RE(0) DH REV (Std Regs)
ligeiro13 0:ebea19a646c3 381 // DL=0 (4 bits bus), DL=1 (8 bits mode)
ligeiro13 0:ebea19a646c3 382 // N=0 (1 line mode), N=1 (2 line mode)
ligeiro13 0:ebea19a646c3 383 // RE=0 (Dis. Extended Regs, special mode for KS0078)
ligeiro13 0:ebea19a646c3 384 // DH=1 (Disp shift enable/disable, special mode for KS0078)
ligeiro13 0:ebea19a646c3 385 // REV=0 (Reverse/Normal, special mode for KS0078)
ligeiro13 0:ebea19a646c3 386 break; // case KS0078 Controller
ligeiro13 0:ebea19a646c3 387
ligeiro13 0:ebea19a646c3 388 case ST7032_3V3:
ligeiro13 0:ebea19a646c3 389 // ST7032 controller: Initialise Voltage booster for VLCD. VDD=3V3
ligeiro13 0:ebea19a646c3 390 // Note: very similar to SPLC792A
ligeiro13 0:ebea19a646c3 391 case ST7032_5V:
ligeiro13 0:ebea19a646c3 392 // ST7032 controller: Disable Voltage booster for VLCD. VDD=5V
ligeiro13 0:ebea19a646c3 393
ligeiro13 0:ebea19a646c3 394 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 395 switch (_type) {
ligeiro13 0:ebea19a646c3 396 case LCD8x1: //8x1 is a regular 1 line display
ligeiro13 0:ebea19a646c3 397 case LCD8x2B: //8x2B is a special case of 16x1
ligeiro13 0:ebea19a646c3 398 // case LCD12x1:
ligeiro13 0:ebea19a646c3 399 case LCD16x1:
ligeiro13 0:ebea19a646c3 400 // case LCD20x1:
ligeiro13 0:ebea19a646c3 401 case LCD24x1:
ligeiro13 0:ebea19a646c3 402 _function = 0x00; // FUNCTION SET 0 0 1 DL=0 (4 bit), N=0 (1-line display mode), F=0 (5*7dot), 0, IS
ligeiro13 0:ebea19a646c3 403 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 404 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 405 break;
ligeiro13 0:ebea19a646c3 406
ligeiro13 0:ebea19a646c3 407 case LCD12x3D: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 408 case LCD12x3D1: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 409 case LCD12x4D: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 410 case LCD16x3G: // Special mode for ST7036
ligeiro13 0:ebea19a646c3 411 case LCD24x4D: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 412 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 413 break;
ligeiro13 0:ebea19a646c3 414
ligeiro13 0:ebea19a646c3 415 default:
ligeiro13 0:ebea19a646c3 416 // All other LCD types are initialised as 2 Line displays
ligeiro13 0:ebea19a646c3 417 _function = 0x08; // FUNCTION SET 0 0 1 DL=0 (4 bit), N=1 (2-line display mode), F=0 (5*7dot), 0, IS
ligeiro13 0:ebea19a646c3 418 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 419 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 420 break;
ligeiro13 0:ebea19a646c3 421 } // switch type
ligeiro13 0:ebea19a646c3 422
ligeiro13 0:ebea19a646c3 423 // init special features
ligeiro13 0:ebea19a646c3 424 _writeCommand(0x20 | _function | 0x01); // Set function, 0 0 1 DL N F 0 IS=1 Select Instr Set = 1
ligeiro13 0:ebea19a646c3 425
ligeiro13 0:ebea19a646c3 426 _writeCommand(0x1C); // Internal OSC frequency adjustment Framefreq=183HZ, Bias will be 1/4 (Instr Set=1)
ligeiro13 0:ebea19a646c3 427 // Note: Bias and Osc register not available on SPLC792A
ligeiro13 0:ebea19a646c3 428
ligeiro13 0:ebea19a646c3 429 _contrast = LCD_ST7032_CONTRAST;
ligeiro13 0:ebea19a646c3 430 _writeCommand(0x70 | (_contrast & 0x0F)); // Set Contrast Low bits, 0 1 1 1 C3 C2 C1 C0 (IS=1)
ligeiro13 0:ebea19a646c3 431
ligeiro13 0:ebea19a646c3 432
ligeiro13 0:ebea19a646c3 433 if (_ctrl == ST7032_3V3) {
ligeiro13 0:ebea19a646c3 434 // _icon_power = 0x04; // Icon display off (Bit3=0), Booster circuit is turned on (Bit2=1) (IS=1)
ligeiro13 0:ebea19a646c3 435 _icon_power = 0x0C; // Icon display on (Bit3=1), Booster circuit is turned on (Bit2=1) (IS=1)
ligeiro13 0:ebea19a646c3 436 // Note: Booster circuit always on for SPLC792A, Bit2 is dont care
ligeiro13 0:ebea19a646c3 437 // Saved to allow contrast change at later time
ligeiro13 0:ebea19a646c3 438 }
ligeiro13 0:ebea19a646c3 439 else {
ligeiro13 0:ebea19a646c3 440 // _icon_power = 0x00; // Icon display off, Booster circuit is turned off (IS=1)
ligeiro13 0:ebea19a646c3 441 _icon_power = 0x08; // Icon display on, Booster circuit is turned off (IS=1)
ligeiro13 0:ebea19a646c3 442 // Saved to allow contrast change at later time
ligeiro13 0:ebea19a646c3 443 }
ligeiro13 0:ebea19a646c3 444 _writeCommand(0x50 | _icon_power | ((_contrast >> 4) & 0x03)); // Set Icon, Booster and Contrast High bits, 0 1 0 1 Ion Bon C5 C4 (IS=1)
ligeiro13 0:ebea19a646c3 445 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 446
ligeiro13 0:ebea19a646c3 447 _writeCommand(0x68 | (LCD_ST7032_RAB & 0x07)); // Voltage follower, 0 1 1 0 FOn=1, Ampl ratio Rab2=1, Rab1=0, Rab0=0 (IS=1)
ligeiro13 0:ebea19a646c3 448 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 449
ligeiro13 0:ebea19a646c3 450 _writeCommand(0x20 | _function); // Select Instruction Set = 0
ligeiro13 0:ebea19a646c3 451
ligeiro13 0:ebea19a646c3 452 break; // case ST7032_3V3 Controller
ligeiro13 0:ebea19a646c3 453 // case ST7032_5V Controller
ligeiro13 0:ebea19a646c3 454
ligeiro13 0:ebea19a646c3 455 case ST7036_3V3:
ligeiro13 0:ebea19a646c3 456 // ST7036 controller: Initialise Voltage booster for VLCD. VDD=3V3
ligeiro13 0:ebea19a646c3 457 // Note: supports 1,2 (LCD_T_A) or 3 lines (LCD_T_G)
ligeiro13 0:ebea19a646c3 458 case ST7036_5V:
ligeiro13 0:ebea19a646c3 459 // ST7036 controller: Disable Voltage booster for VLCD. VDD=5V
ligeiro13 0:ebea19a646c3 460 // Note: supports 1,2 (LCD_T_A) or 3 lines (LCD_T_G)
ligeiro13 0:ebea19a646c3 461
ligeiro13 0:ebea19a646c3 462 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 463 switch (_type) {
ligeiro13 0:ebea19a646c3 464 case LCD8x1: //8x1 is a regular 1 line display
ligeiro13 0:ebea19a646c3 465 case LCD8x2B: //8x2D is a special case of 16x1
ligeiro13 0:ebea19a646c3 466 // case LCD12x1:
ligeiro13 0:ebea19a646c3 467 case LCD16x1:
ligeiro13 0:ebea19a646c3 468 case LCD24x1:
ligeiro13 0:ebea19a646c3 469 _function = 0x00; // Set function, 0 0 1 DL=0 (4-bit Databus), N=0 (1 Line), DH=0 (5x7font), IS2, IS1 (Select Instruction Set)
ligeiro13 0:ebea19a646c3 470 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 471 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 472
ligeiro13 0:ebea19a646c3 473 _bias_lines = 0x04; // Bias: 1/5, 1 or 2-Lines LCD
ligeiro13 0:ebea19a646c3 474 break;
ligeiro13 0:ebea19a646c3 475
ligeiro13 0:ebea19a646c3 476 // case LCD12x3G: // Special mode for ST7036
ligeiro13 0:ebea19a646c3 477 case LCD16x3G: // Special mode for ST7036
ligeiro13 0:ebea19a646c3 478 _function = 0x08; // Set function, 0 0 1 DL=0 (4-bit Databus), N=1 (2 Line), DH=0 (5x7font), IS2,IS1 (Select Instruction Set)
ligeiro13 0:ebea19a646c3 479 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 480 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 481
ligeiro13 0:ebea19a646c3 482 _bias_lines = 0x05; // Bias: 1/5, 3-Lines LCD
ligeiro13 0:ebea19a646c3 483 break;
ligeiro13 0:ebea19a646c3 484
ligeiro13 0:ebea19a646c3 485 // case LCD12x3D1: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 486 // case LCD16x3D1: // Special mode for SSD1803
ligeiro13 0:ebea19a646c3 487 case LCD12x4D: // Special mode for PCF2116
ligeiro13 0:ebea19a646c3 488 case LCD24x4D: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 489 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 490 break;
ligeiro13 0:ebea19a646c3 491
ligeiro13 0:ebea19a646c3 492 default:
ligeiro13 0:ebea19a646c3 493 // All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
ligeiro13 0:ebea19a646c3 494 _function = 0x08; // Set function, 0 0 1 DL=0 (4-bit Databus), N=1 (2 Line), DH=0 (5x7font), IS2,IS1 (Select Instruction Set)
ligeiro13 0:ebea19a646c3 495 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 496 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 497
ligeiro13 0:ebea19a646c3 498 _bias_lines = 0x04; // Bias: 1/5, 1 or 2-Lines LCD
ligeiro13 0:ebea19a646c3 499 break;
ligeiro13 0:ebea19a646c3 500 } // switch type
ligeiro13 0:ebea19a646c3 501
ligeiro13 0:ebea19a646c3 502
ligeiro13 0:ebea19a646c3 503 // init special features
ligeiro13 0:ebea19a646c3 504 _writeCommand(0x20 | _function | 0x01); // Set function, IS2,IS1 = 01 (Select Instr Set = 1)
ligeiro13 0:ebea19a646c3 505 _writeCommand(0x10 | _bias_lines); // Set Bias and 1,2 or 3 lines (Instr Set 1)
ligeiro13 0:ebea19a646c3 506
ligeiro13 0:ebea19a646c3 507 _contrast = LCD_ST7036_CONTRAST;
ligeiro13 0:ebea19a646c3 508 _writeCommand(0x70 | (_contrast & 0x0F)); // Set Contrast, 0 1 1 1 C3 C2 C1 C0 (Instr Set 1)
ligeiro13 0:ebea19a646c3 509
ligeiro13 0:ebea19a646c3 510 if (_ctrl == ST7036_3V3) {
ligeiro13 0:ebea19a646c3 511 _icon_power = 0x0C; // Set Icon, Booster, Contrast High bits, 0 1 0 1 Ion=1 Bon=1 C5 C4 (Instr Set 1)
ligeiro13 0:ebea19a646c3 512 // _icon_power = 0x04; // Set Icon, Booster, Contrast High bits, 0 1 0 1 Ion=0 Bon=1 C5 C4 (Instr Set 1)
ligeiro13 0:ebea19a646c3 513 // Saved to allow contrast change at later time
ligeiro13 0:ebea19a646c3 514 }
ligeiro13 0:ebea19a646c3 515 else {
ligeiro13 0:ebea19a646c3 516 _icon_power = 0x08; // Set Icon, Booster, Contrast High bits, 0 1 0 1 Ion=1 Bon=0 C5 C4 (Instr Set 1)
ligeiro13 0:ebea19a646c3 517 // _icon_power = 0x00; // Set Icon, Booster, Contrast High bits, 0 1 0 1 Ion=0 Bon=0 C5 C4 (Instr Set 1)
ligeiro13 0:ebea19a646c3 518 }
ligeiro13 0:ebea19a646c3 519
ligeiro13 0:ebea19a646c3 520 _writeCommand(0x50 | _icon_power | ((_contrast >> 4) & 0x03)); // Set Contrast C5, C4 (Instr Set 1)
ligeiro13 0:ebea19a646c3 521 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 522
ligeiro13 0:ebea19a646c3 523 _writeCommand(0x68 | (LCD_ST7036_RAB & 0x07)); // Voltagefollower On = 1, Ampl ratio Rab2, Rab1, Rab0 = 1 0 1 (Instr Set 1)
ligeiro13 0:ebea19a646c3 524 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 525
ligeiro13 0:ebea19a646c3 526 _writeCommand(0x20 | _function); // Set function, IS2,IS1 = 00 (Select Instruction Set = 0)
ligeiro13 0:ebea19a646c3 527
ligeiro13 0:ebea19a646c3 528 break; // case ST7036_3V3 Controller
ligeiro13 0:ebea19a646c3 529 // case ST7036_5V Controller
ligeiro13 0:ebea19a646c3 530
ligeiro13 0:ebea19a646c3 531 case ST7070:
ligeiro13 0:ebea19a646c3 532 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 533 switch (_type) {
ligeiro13 0:ebea19a646c3 534 case LCD8x1: //8x1 is a regular 1 line display
ligeiro13 0:ebea19a646c3 535 case LCD8x2B: //8x2D is a special case of 16x1
ligeiro13 0:ebea19a646c3 536 // case LCD12x1:
ligeiro13 0:ebea19a646c3 537 case LCD16x1:
ligeiro13 0:ebea19a646c3 538 case LCD24x1:
ligeiro13 0:ebea19a646c3 539 _function = dl | 0x00; // Set function, 0 0 1 DL=0 (4-bit Databus), N=0 (1 Line), EXT=0, x, x
ligeiro13 0:ebea19a646c3 540 // Note: 4 bit mode is NOT ignored for native SPI !
ligeiro13 0:ebea19a646c3 541 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 542 break;
ligeiro13 0:ebea19a646c3 543
ligeiro13 0:ebea19a646c3 544 // case LCD12x3D1: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 545 // case LCD16x3D1: // Special mode for SSD1803
ligeiro13 0:ebea19a646c3 546 case LCD12x4D: // Special mode for PCF2116
ligeiro13 0:ebea19a646c3 547 case LCD24x4D: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 548 // case LCD12x3G: // Special mode for ST7036
ligeiro13 0:ebea19a646c3 549 case LCD16x3G: // Special mode for ST7036
ligeiro13 0:ebea19a646c3 550 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 551 break;
ligeiro13 0:ebea19a646c3 552
ligeiro13 0:ebea19a646c3 553 default:
ligeiro13 0:ebea19a646c3 554 // All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
ligeiro13 0:ebea19a646c3 555 _function = dl | 0x08; // Set function, 0 0 1 DL, N=1 (2 Line), EXT=0, x, x
ligeiro13 0:ebea19a646c3 556 // Note: 4 bit mode is NOT ignored for native SPI !
ligeiro13 0:ebea19a646c3 557 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 558 break;
ligeiro13 0:ebea19a646c3 559 } // switch type
ligeiro13 0:ebea19a646c3 560
ligeiro13 0:ebea19a646c3 561 // _writeCommand(0x00); // NOP, make sure to sync SPI
ligeiro13 0:ebea19a646c3 562
ligeiro13 0:ebea19a646c3 563 // init special features
ligeiro13 0:ebea19a646c3 564 _writeCommand(0x20 | _function | 0x04); // Set function, 0 0 1 DL N EXT=1 x x (Select Instr Set = 1)
ligeiro13 0:ebea19a646c3 565
ligeiro13 0:ebea19a646c3 566 _writeCommand(0x04 | 0x00); // Set Bias resistors 0 0 0 0 0 1 Rb1,Rb0= 0 0 (Extern Res) (Instr Set 1)
ligeiro13 0:ebea19a646c3 567
ligeiro13 0:ebea19a646c3 568 _writeCommand(0x40 | 0x00); // COM/SEG directions 0 1 0 0 C1, C2, S1, S2 (Instr Set 1)
ligeiro13 0:ebea19a646c3 569 // C1=1: Com1-8 -> Com8-1; C2=1: Com9-16 -> Com16-9
ligeiro13 0:ebea19a646c3 570 // S1=1: Seg1-40 -> Seg40-1; S2=1: Seg41-80 -> Seg80-41
ligeiro13 0:ebea19a646c3 571
ligeiro13 0:ebea19a646c3 572 _writeCommand(0x20 | _function); // Set function, EXT=0 (Select Instr Set = 0)
ligeiro13 0:ebea19a646c3 573
ligeiro13 0:ebea19a646c3 574 break; // case ST7070 Controller
ligeiro13 0:ebea19a646c3 575
ligeiro13 0:ebea19a646c3 576 case SSD1803_3V3:
ligeiro13 0:ebea19a646c3 577 // SSD1803 controller: Initialise Voltage booster for VLCD. VDD=3V3
ligeiro13 0:ebea19a646c3 578 // Note: supports 1,2, 3 or 4 lines
ligeiro13 0:ebea19a646c3 579 // case SSD1803_5V:
ligeiro13 0:ebea19a646c3 580 // SSD1803 controller: No Voltage booster for VLCD. VDD=5V
ligeiro13 0:ebea19a646c3 581
ligeiro13 0:ebea19a646c3 582 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 583 switch (_type) {
ligeiro13 0:ebea19a646c3 584 case LCD8x1: //8x1 is a regular 1 line display
ligeiro13 0:ebea19a646c3 585 case LCD8x2B: //8x2D is a special case of 16x1
ligeiro13 0:ebea19a646c3 586 // case LCD12x1:
ligeiro13 0:ebea19a646c3 587 case LCD16x1:
ligeiro13 0:ebea19a646c3 588 case LCD24x1:
ligeiro13 0:ebea19a646c3 589 _function = 0x00; // Set function 0 0 1 DL N DH RE(0) IS
ligeiro13 0:ebea19a646c3 590 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 591 // DL=0 4-bit Databus,
ligeiro13 0:ebea19a646c3 592 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 593 // N=0 1 Line / 3 Line
ligeiro13 0:ebea19a646c3 594 // DH=0 Double Height disable
ligeiro13 0:ebea19a646c3 595 // IS=0
ligeiro13 0:ebea19a646c3 596
ligeiro13 0:ebea19a646c3 597 _function_1 = 0x02; // Set function, 0 0 1 DL N BE RE(1) REV
ligeiro13 0:ebea19a646c3 598 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 599 // DL=0 4-bit Databus,
ligeiro13 0:ebea19a646c3 600 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 601 // N=0 1 Line / 3 Line
ligeiro13 0:ebea19a646c3 602 // BE=0 Blink Enable off, special feature of SSD1803
ligeiro13 0:ebea19a646c3 603 // REV=0 Reverse off, special feature of SSD1803
ligeiro13 0:ebea19a646c3 604
ligeiro13 0:ebea19a646c3 605 _lines = 0x00; // Ext function set 0 0 0 0 1 FW BW NW
ligeiro13 0:ebea19a646c3 606 // NW=0 1-Line LCD (N=0)
ligeiro13 0:ebea19a646c3 607 break;
ligeiro13 0:ebea19a646c3 608
ligeiro13 0:ebea19a646c3 609 case LCD12x3D: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 610 // case LCD12x3D1: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 611 case LCD16x3D: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 612 // case LCD16x3D1: // Special mode for SSD1803
ligeiro13 0:ebea19a646c3 613 // case LCD20x3D: // Special mode for SSD1803
ligeiro13 0:ebea19a646c3 614 _function = 0x00; // Set function 0 0 1 DL N DH RE(0) IS
ligeiro13 0:ebea19a646c3 615 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 616 // DL=0 4-bit Databus,
ligeiro13 0:ebea19a646c3 617 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 618 // N=0 1 Line / 3 Line
ligeiro13 0:ebea19a646c3 619 // DH=0 Double Height disable
ligeiro13 0:ebea19a646c3 620 // IS=0
ligeiro13 0:ebea19a646c3 621
ligeiro13 0:ebea19a646c3 622 _function_1 = 0x02; // Set function, 0 0 1 DL N BE RE(1) REV
ligeiro13 0:ebea19a646c3 623 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 624 // DL=0 4-bit Databus,
ligeiro13 0:ebea19a646c3 625 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 626 // N=0 1 Line / 3 Line
ligeiro13 0:ebea19a646c3 627 // BE=0 Blink Enable off, special feature of SSD1803
ligeiro13 0:ebea19a646c3 628 // REV=0 Reverse off, special feature of SSD1803
ligeiro13 0:ebea19a646c3 629
ligeiro13 0:ebea19a646c3 630 _lines = 0x00; // Ext function set 0 0 0 0 1 FW BW NW
ligeiro13 0:ebea19a646c3 631 // NW=1 3-Line LCD (N=0)
ligeiro13 0:ebea19a646c3 632 break;
ligeiro13 0:ebea19a646c3 633
ligeiro13 0:ebea19a646c3 634 // case LCD10x2D: // Special mode for SSD1803, 4-line mode but switch to double height font
ligeiro13 0:ebea19a646c3 635 case LCD10x4D: // Special mode for SSD1803
ligeiro13 0:ebea19a646c3 636 case LCD20x4D: // Special mode for SSD1803
ligeiro13 0:ebea19a646c3 637 _function = 0x08; // Set function 0 0 1 DL N DH RE(0) IS
ligeiro13 0:ebea19a646c3 638 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 639 // DL=0 4-bit Databus,
ligeiro13 0:ebea19a646c3 640 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 641 // N=1 4 Line
ligeiro13 0:ebea19a646c3 642 // DH=0 Double Height disable
ligeiro13 0:ebea19a646c3 643 // IS=0
ligeiro13 0:ebea19a646c3 644
ligeiro13 0:ebea19a646c3 645 _function_1 = 0x0A; // Set function, 0 0 1 DL N BE RE(1) REV
ligeiro13 0:ebea19a646c3 646 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 647 // DL=0 4-bit Databus,
ligeiro13 0:ebea19a646c3 648 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 649 // N=1 4 Line
ligeiro13 0:ebea19a646c3 650 // BE=0 Blink Enable off, special feature of SSD1803
ligeiro13 0:ebea19a646c3 651 // REV=0 Reverse off, special feature of SSD1803
ligeiro13 0:ebea19a646c3 652
ligeiro13 0:ebea19a646c3 653 _lines = 0x01; // Ext function set 0 0 0 0 1 FW BW NW
ligeiro13 0:ebea19a646c3 654 // NW=1 4-Line LCD (N=1)
ligeiro13 0:ebea19a646c3 655 break;
ligeiro13 0:ebea19a646c3 656
ligeiro13 0:ebea19a646c3 657 case LCD16x3G: // Special mode for ST7036
ligeiro13 0:ebea19a646c3 658 case LCD24x4D: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 659 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 660 break;
ligeiro13 0:ebea19a646c3 661
ligeiro13 0:ebea19a646c3 662 default:
ligeiro13 0:ebea19a646c3 663 // All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
ligeiro13 0:ebea19a646c3 664 _function = 0x08; // Set function 0 0 1 DL N DH RE(0) IS
ligeiro13 0:ebea19a646c3 665 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 666 // DL=0 4-bit Databus,
ligeiro13 0:ebea19a646c3 667 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 668 // N=1 2 line / 4 Line
ligeiro13 0:ebea19a646c3 669 // DH=0 Double Height disable
ligeiro13 0:ebea19a646c3 670 // RE=0
ligeiro13 0:ebea19a646c3 671 // IS=0
ligeiro13 0:ebea19a646c3 672
ligeiro13 0:ebea19a646c3 673 _function_1 = 0x0A; // Set function, 0 0 1 DL N BE RE(1) REV
ligeiro13 0:ebea19a646c3 674 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 675 // DL=0 4-bit Databus,
ligeiro13 0:ebea19a646c3 676 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 677 // N=1 2 line / 4 Line
ligeiro13 0:ebea19a646c3 678 // BE=0 Blink Enable off, special feature of SSD1803
ligeiro13 0:ebea19a646c3 679 // RE=1
ligeiro13 0:ebea19a646c3 680 // REV=0 Reverse off, special feature of SSD1803
ligeiro13 0:ebea19a646c3 681
ligeiro13 0:ebea19a646c3 682 _lines = 0x00; // Ext function set 0 0 0 0 1 FW BW NW
ligeiro13 0:ebea19a646c3 683 // NW=0 2-Line LCD (N=1)
ligeiro13 0:ebea19a646c3 684 break;
ligeiro13 0:ebea19a646c3 685 } // switch type
ligeiro13 0:ebea19a646c3 686
ligeiro13 0:ebea19a646c3 687
ligeiro13 0:ebea19a646c3 688 // init special features
ligeiro13 0:ebea19a646c3 689 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 DL N BE RE(1) REV
ligeiro13 0:ebea19a646c3 690 // Select Extended Instruction Set
ligeiro13 0:ebea19a646c3 691
ligeiro13 0:ebea19a646c3 692 _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)
ligeiro13 0:ebea19a646c3 693 // _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)
ligeiro13 0:ebea19a646c3 694 wait_ms(5); // Wait to ensure completion or SSD1803 fails to set Top/Bottom after reset..
ligeiro13 0:ebea19a646c3 695
ligeiro13 0:ebea19a646c3 696 _writeCommand(0x08 | _lines); // Set ext function 0 0 0 0 1 FW BW NW 1,2,3 or 4 lines (Ext Instr Set)
ligeiro13 0:ebea19a646c3 697
ligeiro13 0:ebea19a646c3 698 _writeCommand(0x10); // Double Height and Bias, 0 0 0 1 UD2=0, UD1=0, BS1=0 Bias 1/5, DH=0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 699
ligeiro13 0:ebea19a646c3 700 // _writeCommand(0x76); // Set TC Control, 0 1 1 1 0 1 1 0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 701 // _writeData(0x02); // Set TC data, 0 0 0 0 0 TC2,TC1,TC0 = 0 1 0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 702
ligeiro13 0:ebea19a646c3 703 _writeCommand(0x20 | _function | 0x01); // Set function, 0 0 1 DL N DH RE(0) IS=1 Select Instruction Set 1
ligeiro13 0:ebea19a646c3 704 // Select Std Instr set, Select IS=1
ligeiro13 0:ebea19a646c3 705
ligeiro13 0:ebea19a646c3 706 _contrast = LCD_SSD1_CONTRAST;
ligeiro13 0:ebea19a646c3 707 _writeCommand(0x70 | (_contrast & 0x0F)); // Set Contrast 0 1 1 1 C3, C2, C1, C0 (Instr Set 1)
ligeiro13 0:ebea19a646c3 708
ligeiro13 0:ebea19a646c3 709 // _icon_power = 0x04; // Icon off, Booster on (Instr Set 1)
ligeiro13 0:ebea19a646c3 710 _icon_power = 0x0C; // Icon on, Booster on (Instr Set 1)
ligeiro13 0:ebea19a646c3 711 // Saved to allow contrast change at later time
ligeiro13 0:ebea19a646c3 712 _writeCommand(0x50 | _icon_power | ((_contrast >> 4) & 0x03)); // Set Power, Icon and Contrast, 0 1 0 1 Ion Bon C5 C4 (Instr Set 1)
ligeiro13 0:ebea19a646c3 713 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 714
ligeiro13 0:ebea19a646c3 715 _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)
ligeiro13 0:ebea19a646c3 716 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 717
ligeiro13 0:ebea19a646c3 718 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 DL N BE RE(1) REV
ligeiro13 0:ebea19a646c3 719 // Select Extended Instruction Set 1
ligeiro13 0:ebea19a646c3 720 _writeCommand(0x10); // Shift/Scroll enable, 0 0 0 1 DS4/HS4 DS3/HS3 DS2/HS2 DS1/HS1 (Ext Instr Set 1)
ligeiro13 0:ebea19a646c3 721
ligeiro13 0:ebea19a646c3 722
ligeiro13 0:ebea19a646c3 723 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 724 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 725
ligeiro13 0:ebea19a646c3 726 break; // case SSD1803 Controller
ligeiro13 0:ebea19a646c3 727
ligeiro13 0:ebea19a646c3 728
ligeiro13 0:ebea19a646c3 729 // Note1: The PCF21XX family of controllers has several types that dont have an onboard voltage generator for V-LCD.
ligeiro13 0:ebea19a646c3 730 // You must supply this LCD voltage externally and not try to enable VGen.
ligeiro13 0:ebea19a646c3 731 // Note2: The early versions of PCF2116 controllers (eg PCF2116C) can not generate sufficiently negative voltage for the LCD at a VDD of 3V3.
ligeiro13 0:ebea19a646c3 732 // You must supply this voltage externally and not enable VGen or you must use a higher VDD (e.g. 5V) and enable VGen.
ligeiro13 0:ebea19a646c3 733 // More recent versions of the controller (eg PCF2116K) have an improved VGen that will work with 3V3.
ligeiro13 0:ebea19a646c3 734 // 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
ligeiro13 0:ebea19a646c3 735 // contrast control similar to that of pin 3 on the standard 14pin LCD module connector.
ligeiro13 0:ebea19a646c3 736 // You can disable VGen by connecting Vo to VDD. VLCD will then be used directly as LCD voltage.
ligeiro13 0:ebea19a646c3 737 // 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.
ligeiro13 0:ebea19a646c3 738 // 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.
ligeiro13 0:ebea19a646c3 739 // Note5: See datasheet, members of the PCF21XX family support different numbers of rows/columns. Not all can support 3 or 4 rows.
ligeiro13 0:ebea19a646c3 740 // 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..
ligeiro13 0:ebea19a646c3 741
ligeiro13 0:ebea19a646c3 742 case PCF2103_3V3:
ligeiro13 0:ebea19a646c3 743 // PCF2103 controller: No Voltage generator for VLCD, VDD=3V3..5V, VLCD input controls contrast voltage.
ligeiro13 0:ebea19a646c3 744 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 745 switch (_type) {
ligeiro13 0:ebea19a646c3 746 case LCD24x1:
ligeiro13 0:ebea19a646c3 747 _function = 0x00; //FUNCTION SET 0 0 1 DL=0 4-bit, 0, M=0 1-line/24 chars display mode, 0, H=0
ligeiro13 0:ebea19a646c3 748 //Note: 4 bit mode is ignored for I2C mode
ligeiro13 0:ebea19a646c3 749 break;
ligeiro13 0:ebea19a646c3 750
ligeiro13 0:ebea19a646c3 751 // case LCD12x1D: //Special mode for PCF21XX, Only top line used
ligeiro13 0:ebea19a646c3 752 case LCD12x2:
ligeiro13 0:ebea19a646c3 753 _function = 0x04; //FUNCTION SET 0 0 1 DL=0 4-bit, 0, M=1 2-line/12 chars display mode, 0, H=0
ligeiro13 0:ebea19a646c3 754 //Note: 4 bit mode is ignored for I2C mode
ligeiro13 0:ebea19a646c3 755 break;
ligeiro13 0:ebea19a646c3 756
ligeiro13 0:ebea19a646c3 757 default:
ligeiro13 0:ebea19a646c3 758 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 759 break;
ligeiro13 0:ebea19a646c3 760
ligeiro13 0:ebea19a646c3 761 } // switch type
ligeiro13 0:ebea19a646c3 762
ligeiro13 0:ebea19a646c3 763 _writeCommand(0x20 | _function | 0x01); // Set function, Select Instr Set = 1
ligeiro13 0:ebea19a646c3 764 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 765
ligeiro13 0:ebea19a646c3 766 // Note: Display from GA628 shows 12 chars. This is actually the right half of a 24x1 display. The commons have been connected in reverse order.
ligeiro13 0:ebea19a646c3 767 _writeCommand(0x05); // Display Conf Set 0000 0, 1, P=0, Q=1 (Instr. Set 1)
ligeiro13 0:ebea19a646c3 768
ligeiro13 0:ebea19a646c3 769 _writeCommand(0x02); // Screen Config 0000 001, L=0 (Instr. Set 1)
ligeiro13 0:ebea19a646c3 770 _writeCommand(0x08); // ICON Conf 0000 1, IM=0 (Char mode), IB=0 (no Icon blink), 0 (Instr. Set 1)
ligeiro13 0:ebea19a646c3 771
ligeiro13 0:ebea19a646c3 772 _writeCommand(0x20 | _function); // Set function, Select Instr Set = 0
ligeiro13 0:ebea19a646c3 773
ligeiro13 0:ebea19a646c3 774 #if(0)
ligeiro13 0:ebea19a646c3 775 // Select CG RAM
ligeiro13 0:ebea19a646c3 776 _writeCommand(0x40); //Set CG-RAM address, 8 sequential locations needed per UDC
ligeiro13 0:ebea19a646c3 777 // Store UDC/Icon pattern:
ligeiro13 0:ebea19a646c3 778 // 3 x 8 rows x 5 bits = 120 bits for Normal pattern (UDC 0..2) and
ligeiro13 0:ebea19a646c3 779 // 3 x 8 rows x 5 bits = 120 bits for Blink pattern (UDC 4..6)
ligeiro13 0:ebea19a646c3 780 for (int i=0; i<(8 * 8); i++) {
ligeiro13 0:ebea19a646c3 781 // _writeData(0x1F); // All On
ligeiro13 0:ebea19a646c3 782 _writeData(0x00); // All Off
ligeiro13 0:ebea19a646c3 783 }
ligeiro13 0:ebea19a646c3 784 #endif
ligeiro13 0:ebea19a646c3 785 break; // case PCF2103_3V3 Controller
ligeiro13 0:ebea19a646c3 786
ligeiro13 0:ebea19a646c3 787 case PCF2113_3V3:
ligeiro13 0:ebea19a646c3 788 // PCF2113 controller: Initialise Voltage booster for VLCD. VDD=3V3. VA and VB control contrast.
ligeiro13 0:ebea19a646c3 789 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 790 switch (_type) {
ligeiro13 0:ebea19a646c3 791 // case LCD12x1:
ligeiro13 0:ebea19a646c3 792 // _function = 0x02; // FUNCTION SET 0 0 1 DL=0 4 bit, 0, M=0 1-line/12 chars display mode, SL=1, IS=0
ligeiro13 0:ebea19a646c3 793 // Note: 4 bit mode is ignored for I2C mode
ligeiro13 0:ebea19a646c3 794 case LCD24x1:
ligeiro13 0:ebea19a646c3 795 _function = 0x00; // FUNCTION SET 0 0 1 DL=0 4 bit, 0, M=0 1-line/24 chars display mode, SL=0, IS=0
ligeiro13 0:ebea19a646c3 796 // Note: 4 bit mode is ignored for I2C mode
ligeiro13 0:ebea19a646c3 797 break;
ligeiro13 0:ebea19a646c3 798
ligeiro13 0:ebea19a646c3 799 case LCD12x2:
ligeiro13 0:ebea19a646c3 800 _function = 0x04; // FUNCTION SET 0 0 1 DL=0 4 bit, 0, M=1 2-line/12 chars display mode, SL=0, IS=0
ligeiro13 0:ebea19a646c3 801 break;
ligeiro13 0:ebea19a646c3 802
ligeiro13 0:ebea19a646c3 803 default:
ligeiro13 0:ebea19a646c3 804 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 805 break;
ligeiro13 0:ebea19a646c3 806
ligeiro13 0:ebea19a646c3 807 } // switch type
ligeiro13 0:ebea19a646c3 808
ligeiro13 0:ebea19a646c3 809 // Init special features
ligeiro13 0:ebea19a646c3 810 _writeCommand(0x20 | _function | 0x01); // Set function, Select Instr Set = 1
ligeiro13 0:ebea19a646c3 811
ligeiro13 0:ebea19a646c3 812 _writeCommand(0x04); // Display Conf Set 0000 0, 1, P=0, Q=0 (Instr. Set 1)
ligeiro13 0:ebea19a646c3 813 _writeCommand(0x10); // Temp Compensation Set 0001 0, 0, TC1=0, TC2=0 (Instr. Set 1)
ligeiro13 0:ebea19a646c3 814 // _writeCommand(0x42); // HV GEN 0100 S1=1, S2=0 (2x multiplier) (Instr. Set 1)
ligeiro13 0:ebea19a646c3 815 _writeCommand(0x40 | (LCD_PCF2_S12 & 0x03)); // HV Gen 0100 S1=1, S2=0 (2x multiplier) (Instr. Set 1)
ligeiro13 0:ebea19a646c3 816
ligeiro13 0:ebea19a646c3 817 _contrast = LCD_PCF2_CONTRAST;
ligeiro13 0:ebea19a646c3 818 _writeCommand(0x80 | 0x00 | (_contrast & 0x3F)); // VLCD_set (Instr. Set 1) 1, V=0, VA=contrast
ligeiro13 0:ebea19a646c3 819 _writeCommand(0x80 | 0x40 | (_contrast & 0x3F)); // VLCD_set (Instr. Set 1) 1, V=1, VB=contrast
ligeiro13 0:ebea19a646c3 820 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 821
ligeiro13 0:ebea19a646c3 822 _writeCommand(0x02); // Screen Config 0000 001, L=0 (Instr. Set 1)
ligeiro13 0:ebea19a646c3 823 _writeCommand(0x08); // ICON Conf 0000 1, IM=0 (Char mode), IB=0 (no icon blink) DM=0 (no direct mode) (Instr. Set 1)
ligeiro13 0:ebea19a646c3 824
ligeiro13 0:ebea19a646c3 825 _writeCommand(0x20 | _function); // Set function, Select Instr Set = 0
ligeiro13 0:ebea19a646c3 826
ligeiro13 0:ebea19a646c3 827 break; // case PCF2113_3V3 Controller
ligeiro13 0:ebea19a646c3 828
ligeiro13 0:ebea19a646c3 829
ligeiro13 0:ebea19a646c3 830 // case PCF2113_5V:
ligeiro13 0:ebea19a646c3 831 // PCF2113 controller: No Voltage generator for VLCD. VDD=5V. Contrast voltage controlled by VA or VB.
ligeiro13 0:ebea19a646c3 832 //@TODO
ligeiro13 0:ebea19a646c3 833
ligeiro13 0:ebea19a646c3 834
ligeiro13 0:ebea19a646c3 835 case PCF2116_3V3:
ligeiro13 0:ebea19a646c3 836 // PCF2116 controller: Voltage generator for VLCD. VDD=5V. V0 controls contrast voltage.
ligeiro13 0:ebea19a646c3 837 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 838 switch (_type) {
ligeiro13 0:ebea19a646c3 839 // case LCD12x1:
ligeiro13 0:ebea19a646c3 840 // case LCD12x2:
ligeiro13 0:ebea19a646c3 841 case LCD24x1:
ligeiro13 0:ebea19a646c3 842 _writeCommand(0x22); //FUNCTION SET 0 0 1 DL=0 4-bit, N=0/M=0 1-line/24 chars display mode, G=1 Vgen on, 0
ligeiro13 0:ebea19a646c3 843 //Note: 4 bit mode is ignored for I2C mode
ligeiro13 0:ebea19a646c3 844 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 845 break;
ligeiro13 0:ebea19a646c3 846
ligeiro13 0:ebea19a646c3 847 case LCD12x3D: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 848 case LCD12x3D1: // Special mode for PCF21XX
ligeiro13 0:ebea19a646c3 849 case LCD12x4D: // Special mode for PCF21XX:
ligeiro13 0:ebea19a646c3 850 _writeCommand(0x2E); //FUNCTION SET 0 0 1 DL=0 4-bit, N=1/M=1 4-line/12 chars display mode, G=1 VGen on, 0
ligeiro13 0:ebea19a646c3 851 //Note: 4 bit mode is ignored for I2C mode
ligeiro13 0:ebea19a646c3 852 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 853 break;
ligeiro13 0:ebea19a646c3 854
ligeiro13 0:ebea19a646c3 855 case LCD24x2:
ligeiro13 0:ebea19a646c3 856 _writeCommand(0x2A); //FUNCTION SET 0 0 1 DL=0 4-bit, N=1/M=0 2-line/24 chars display mode, G=1 VGen on, 0
ligeiro13 0:ebea19a646c3 857 //Note: 4 bit mode is ignored for I2C mode
ligeiro13 0:ebea19a646c3 858 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 859 break;
ligeiro13 0:ebea19a646c3 860
ligeiro13 0:ebea19a646c3 861 default:
ligeiro13 0:ebea19a646c3 862 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 863 break;
ligeiro13 0:ebea19a646c3 864
ligeiro13 0:ebea19a646c3 865 } // switch type
ligeiro13 0:ebea19a646c3 866
ligeiro13 0:ebea19a646c3 867 break; // case PCF2116_3V3 Controller
ligeiro13 0:ebea19a646c3 868
ligeiro13 0:ebea19a646c3 869
ligeiro13 0:ebea19a646c3 870 //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
ligeiro13 0:ebea19a646c3 871 //@TODO
ligeiro13 0:ebea19a646c3 872 case PCF2116_5V:
ligeiro13 0:ebea19a646c3 873 // PCF2116 controller: No Voltage generator for VLCD. VDD=5V. V0 controls contrast voltage.
ligeiro13 0:ebea19a646c3 874 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 875 switch (_type) {
ligeiro13 0:ebea19a646c3 876 // case LCD12x1:
ligeiro13 0:ebea19a646c3 877 // case LCD12x2:
ligeiro13 0:ebea19a646c3 878 // case LCD24x1:
ligeiro13 0:ebea19a646c3 879 // _writeCommand(0x20); //FUNCTION SET 0 0 1 DL=0 4-bit, N=0/M=0 1-line/24 chars display mode, G=0 no Vgen, 0
ligeiro13 0:ebea19a646c3 880 //Note: 4 bit mode is ignored for I2C mode
ligeiro13 0:ebea19a646c3 881 // wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 882 // break;
ligeiro13 0:ebea19a646c3 883
ligeiro13 0:ebea19a646c3 884 case LCD12x3D: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 885 case LCD12x3D1: // Special mode for PCF21XX
ligeiro13 0:ebea19a646c3 886 case LCD12x4D: // Special mode for PCF21XX:
ligeiro13 0:ebea19a646c3 887 // _writeCommand(0x34); //FUNCTION SET 8 bit, N=0/M=1 4-line/12 chars display mode OK
ligeiro13 0:ebea19a646c3 888 // _writeCommand(0x24); //FUNCTION SET 4 bit, N=0/M=1 4-line/12 chars display mode OK
ligeiro13 0:ebea19a646c3 889 _writeCommand(0x2C); //FUNCTION SET 0 0 1 DL=0 4-bit, N=1/M=1 4-line/12 chars display mode, G=0 no Vgen, 0 OK
ligeiro13 0:ebea19a646c3 890 //Note: 4 bit mode is ignored for I2C mode
ligeiro13 0:ebea19a646c3 891 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 892 break;
ligeiro13 0:ebea19a646c3 893
ligeiro13 0:ebea19a646c3 894 // case LCD24x2:
ligeiro13 0:ebea19a646c3 895 // _writeCommand(0x28); //FUNCTION SET 4 bit, N=1/M=0 2-line/24 chars display mode
ligeiro13 0:ebea19a646c3 896 //Note: 4 bit mode is ignored for I2C mode
ligeiro13 0:ebea19a646c3 897 // wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 898 // break;
ligeiro13 0:ebea19a646c3 899
ligeiro13 0:ebea19a646c3 900 default:
ligeiro13 0:ebea19a646c3 901 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 902 break;
ligeiro13 0:ebea19a646c3 903
ligeiro13 0:ebea19a646c3 904 } // switch type
ligeiro13 0:ebea19a646c3 905
ligeiro13 0:ebea19a646c3 906 break; // case PCF2116_5V Controller
ligeiro13 0:ebea19a646c3 907
ligeiro13 0:ebea19a646c3 908 case PCF2119_3V3:
ligeiro13 0:ebea19a646c3 909 case PCF2119R_3V3:
ligeiro13 0:ebea19a646c3 910 // PCF2119 controller: Initialise Voltage booster for VLCD. VDD=3V3. VA and VB control contrast.
ligeiro13 0:ebea19a646c3 911 // Note1: See datasheet, the PCF2119 supports icons and provides separate constrast control for Icons and characters.
ligeiro13 0:ebea19a646c3 912 // Note2: Vgen is switched off when the contrast voltage VA or VB is set to 0x00.
ligeiro13 0:ebea19a646c3 913
ligeiro13 0:ebea19a646c3 914 //POR or Hardware Reset should be applied
ligeiro13 0:ebea19a646c3 915 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 916
ligeiro13 0:ebea19a646c3 917 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 918 switch (_type) {
ligeiro13 0:ebea19a646c3 919 case LCD8x1:
ligeiro13 0:ebea19a646c3 920 // case LCD12x1:
ligeiro13 0:ebea19a646c3 921 case LCD16x1:
ligeiro13 0:ebea19a646c3 922 _function = 0x02; // FUNCTION SET 0 0 1 DL=0 4-bit, 0 , M=0 1-line/16 chars display mode, SL=1
ligeiro13 0:ebea19a646c3 923 // Note: 4 bit mode is ignored for I2C mode
ligeiro13 0:ebea19a646c3 924 break;
ligeiro13 0:ebea19a646c3 925
ligeiro13 0:ebea19a646c3 926 case LCD24x1:
ligeiro13 0:ebea19a646c3 927 // case LCD32x1:
ligeiro13 0:ebea19a646c3 928 _function = 0x00; // FUNCTION SET 0 0 1 DL=0 4-bit, 0 , M=0 1-line/32 chars display mode, SL=0
ligeiro13 0:ebea19a646c3 929 // Note: 4 bit mode is ignored for I2C mode
ligeiro13 0:ebea19a646c3 930 break;
ligeiro13 0:ebea19a646c3 931
ligeiro13 0:ebea19a646c3 932 case LCD8x2:
ligeiro13 0:ebea19a646c3 933 // case LCD12x2:
ligeiro13 0:ebea19a646c3 934 case LCD16x2:
ligeiro13 0:ebea19a646c3 935 _function = 0x04; // FUNCTION SET 0 0 1 DL=0 4-bit, 0, M=1 2-line/16 chars display mode, SL=0
ligeiro13 0:ebea19a646c3 936 // Note: 4 bit mode is ignored for I2C mode
ligeiro13 0:ebea19a646c3 937 break;
ligeiro13 0:ebea19a646c3 938
ligeiro13 0:ebea19a646c3 939 default:
ligeiro13 0:ebea19a646c3 940 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 941 break;
ligeiro13 0:ebea19a646c3 942
ligeiro13 0:ebea19a646c3 943 } // switch type
ligeiro13 0:ebea19a646c3 944
ligeiro13 0:ebea19a646c3 945 // Init special features
ligeiro13 0:ebea19a646c3 946 _writeCommand(0x20 | _function | 0x01); // Set function, Select Instruction Set = 1
ligeiro13 0:ebea19a646c3 947
ligeiro13 0:ebea19a646c3 948 // _writeCommand(0x04); // DISP CONF SET (Instr. Set 1) 0000, 0, 1, P=0, Q=0 (IC at Bottom)
ligeiro13 0:ebea19a646c3 949 // _writeCommand(0x05); // Display Conf Set 0000, 0, 1, P=0, Q=1
ligeiro13 0:ebea19a646c3 950 // _writeCommand(0x06); // Display Conf Set 0000, 0, 1, P=1, Q=0
ligeiro13 0:ebea19a646c3 951 _writeCommand(0x07); // Display Conf Set 0000, 0, 1, P=1, Q=1 (IC at Top)
ligeiro13 0:ebea19a646c3 952
ligeiro13 0:ebea19a646c3 953 _writeCommand(0x10); // TEMP CTRL SET (Instr. Set 1) 0001, 0, 0, TC1=0, TC2=0
ligeiro13 0:ebea19a646c3 954 // _writeCommand(0x42); // HV GEN (Instr. Set 1) 0100, 0, 0, S1=1, S2=0 (2x multiplier)
ligeiro13 0:ebea19a646c3 955 _writeCommand(0x40 | (LCD_PCF2_S12 & 0x03)); // HV GEN (Instr. Set 1) 0100, 0, 0, S1=1, S2=0 (2x multiplier)
ligeiro13 0:ebea19a646c3 956
ligeiro13 0:ebea19a646c3 957 _contrast = LCD_PCF2_CONTRAST;
ligeiro13 0:ebea19a646c3 958 _writeCommand(0x80 | 0x00 | (_contrast & 0x3F)); // VLCD_set (Instr. Set 1) V=0, VA=contrast
ligeiro13 0:ebea19a646c3 959 _writeCommand(0x80 | 0x40 | (_contrast & 0x3F)); // VLCD_set (Instr. Set 1) V=1, VB=contrast
ligeiro13 0:ebea19a646c3 960 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 961
ligeiro13 0:ebea19a646c3 962 _writeCommand(0x02); // SCRN CONF (Instr. Set 1) L=0
ligeiro13 0:ebea19a646c3 963 _writeCommand(0x08); // ICON CONF (Instr. Set 1) IM=0 (Char mode) IB=0 (no icon blink) DM=0 (no direct mode)
ligeiro13 0:ebea19a646c3 964
ligeiro13 0:ebea19a646c3 965 _writeCommand(0x20 | _function); // Select Instruction Set = 0
ligeiro13 0:ebea19a646c3 966
ligeiro13 0:ebea19a646c3 967 break; // case PCF2119_3V3 Controller
ligeiro13 0:ebea19a646c3 968
ligeiro13 0:ebea19a646c3 969 // case PCF2119_5V:
ligeiro13 0:ebea19a646c3 970 // PCF2119 controller: No Voltage booster for VLCD. VDD=3V3. VA and VB control contrast.
ligeiro13 0:ebea19a646c3 971 // Note1: See datasheet, the PCF2119 supports icons and provides separate constrast control for Icons and characters.
ligeiro13 0:ebea19a646c3 972 // Note2: Vgen is switched off when the contrast voltage VA or VB is set to 0x00.
ligeiro13 0:ebea19a646c3 973 //@TODO
ligeiro13 0:ebea19a646c3 974
ligeiro13 0:ebea19a646c3 975 case WS0010:
ligeiro13 0:ebea19a646c3 976 // WS0010 OLED controller: Initialise DC/DC Voltage converter for LEDs
ligeiro13 0:ebea19a646c3 977 // Note1: Identical to RS0010
ligeiro13 0:ebea19a646c3 978 // Note2: supports 1 or 2 lines (and 16x100 graphics)
ligeiro13 0:ebea19a646c3 979 // supports 4 fonts (English/Japanese (default), Western European-I, English/Russian, Western European-II)
ligeiro13 0:ebea19a646c3 980 // Cursor/Disp shift set 0001 SC RL 0 0
ligeiro13 0:ebea19a646c3 981 //
ligeiro13 0:ebea19a646c3 982 // Mode and Power set 0001 GC PWR 1 1
ligeiro13 0:ebea19a646c3 983 // GC = 0 (Graph Mode=1, Char Mode=0)
ligeiro13 0:ebea19a646c3 984 // PWR = 1 (DC/DC On/Off)
ligeiro13 0:ebea19a646c3 985
ligeiro13 0:ebea19a646c3 986 //@Todo: This may be needed to enable a warm reboot
ligeiro13 0:ebea19a646c3 987 //_writeCommand(0x13); // Char mode, DC/DC off
ligeiro13 0:ebea19a646c3 988 //wait_ms(10); // Wait 10ms to ensure powered down
ligeiro13 0:ebea19a646c3 989 _writeCommand(0x17); // Char mode, DC/DC on
ligeiro13 0:ebea19a646c3 990 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 991
ligeiro13 0:ebea19a646c3 992 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 993 switch (_type) {
ligeiro13 0:ebea19a646c3 994 case LCD8x1: //8x1 is a regular 1 line display
ligeiro13 0:ebea19a646c3 995 case LCD8x2B: //8x2B is a special case of 16x1
ligeiro13 0:ebea19a646c3 996 // case LCD12x1:
ligeiro13 0:ebea19a646c3 997 case LCD16x1:
ligeiro13 0:ebea19a646c3 998 case LCD24x1:
ligeiro13 0:ebea19a646c3 999 _writeCommand(0x20); // Function set 001 DL N F FT1 FT0
ligeiro13 0:ebea19a646c3 1000 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 1001 // N=0 (1 line)
ligeiro13 0:ebea19a646c3 1002 // F=0 (5x7 dots font)
ligeiro13 0:ebea19a646c3 1003 // FT=00 (00 = Engl/Jap, 01 = WestEur1, 10 = Engl/Russian, 11 = WestEur2
ligeiro13 0:ebea19a646c3 1004 break;
ligeiro13 0:ebea19a646c3 1005
ligeiro13 0:ebea19a646c3 1006 case LCD12x3D: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 1007 case LCD12x3D1: // Special mode for PCF21XX
ligeiro13 0:ebea19a646c3 1008 case LCD12x4D: // Special mode for PCF21XX:
ligeiro13 0:ebea19a646c3 1009 case LCD16x3G: // Special mode for ST7036
ligeiro13 0:ebea19a646c3 1010 case LCD24x4D: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 1011 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 1012 break;
ligeiro13 0:ebea19a646c3 1013
ligeiro13 0:ebea19a646c3 1014 default:
ligeiro13 0:ebea19a646c3 1015 // All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
ligeiro13 0:ebea19a646c3 1016 _writeCommand(0x28); // Function set 001 DL N F FT1 FT0
ligeiro13 0:ebea19a646c3 1017 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 1018 // N=1 (2 lines)
ligeiro13 0:ebea19a646c3 1019 // F=0 (5x7 dots font)
ligeiro13 0:ebea19a646c3 1020 // FT=00 (00 = Engl/Jap, 01 = WestEur1, 10 = Engl/Russian, 11 = WestEur2
ligeiro13 0:ebea19a646c3 1021
ligeiro13 0:ebea19a646c3 1022 break;
ligeiro13 0:ebea19a646c3 1023 } // switch type
ligeiro13 0:ebea19a646c3 1024
ligeiro13 0:ebea19a646c3 1025 break; // case WS0010 Controller
ligeiro13 0:ebea19a646c3 1026
ligeiro13 0:ebea19a646c3 1027
ligeiro13 0:ebea19a646c3 1028 case US2066_3V3:
ligeiro13 0:ebea19a646c3 1029 // US2066/SSD1311 OLED controller, Initialise for VDD=3V3
ligeiro13 0:ebea19a646c3 1030 // Note: supports 1,2, 3 or 4 lines
ligeiro13 0:ebea19a646c3 1031 // case USS2066_5V:
ligeiro13 0:ebea19a646c3 1032 // US2066 controller, VDD=5V
ligeiro13 0:ebea19a646c3 1033
ligeiro13 0:ebea19a646c3 1034 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 1035 switch (_type) {
ligeiro13 0:ebea19a646c3 1036 case LCD8x1: //8x1 is a regular 1 line display
ligeiro13 0:ebea19a646c3 1037 case LCD8x2B: //8x2D is a special case of 16x1
ligeiro13 0:ebea19a646c3 1038 // case LCD12x1:
ligeiro13 0:ebea19a646c3 1039 case LCD16x1:
ligeiro13 0:ebea19a646c3 1040 // case LCD20x1:
ligeiro13 0:ebea19a646c3 1041 _function = 0x00; // Set function 0 0 1 X N DH RE(0) IS
ligeiro13 0:ebea19a646c3 1042 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 1043 // DL=X bit is ignored for US2066. Uses hardwired pins instead
ligeiro13 0:ebea19a646c3 1044 // N=0 1 Line / 3 Line
ligeiro13 0:ebea19a646c3 1045 // DH=0 Double Height disable
ligeiro13 0:ebea19a646c3 1046 // IS=0
ligeiro13 0:ebea19a646c3 1047
ligeiro13 0:ebea19a646c3 1048 _function_1 = 0x02; // Set function, 0 0 1 X N BE RE(1) REV
ligeiro13 0:ebea19a646c3 1049 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 1050 // DL=X bit is ignored for US2066. Uses hardwired pins instead
ligeiro13 0:ebea19a646c3 1051 // N=0 1 Line / 3 Line
ligeiro13 0:ebea19a646c3 1052 // BE=0 Blink Enable off, special feature of SSD1803, US2066
ligeiro13 0:ebea19a646c3 1053 // REV=0 Reverse off, special feature of SSD1803, US2066
ligeiro13 0:ebea19a646c3 1054
ligeiro13 0:ebea19a646c3 1055 _lines = 0x00; // Ext function set 0 0 0 0 1 FW BW NW
ligeiro13 0:ebea19a646c3 1056 // NW=0 1-Line LCD (N=0)
ligeiro13 0:ebea19a646c3 1057 break;
ligeiro13 0:ebea19a646c3 1058
ligeiro13 0:ebea19a646c3 1059 case LCD16x1C:
ligeiro13 0:ebea19a646c3 1060 case LCD8x2:
ligeiro13 0:ebea19a646c3 1061 case LCD16x2:
ligeiro13 0:ebea19a646c3 1062 case LCD20x2:
ligeiro13 0:ebea19a646c3 1063 _function = 0x08; // Set function 0 0 1 X N DH RE(0) IS
ligeiro13 0:ebea19a646c3 1064 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 1065 // DL=X bit is ignored for US2066. Uses hardwired pins instead
ligeiro13 0:ebea19a646c3 1066 // N=1 2 line / 4 Line
ligeiro13 0:ebea19a646c3 1067 // DH=0 Double Height disable
ligeiro13 0:ebea19a646c3 1068 // IS=0
ligeiro13 0:ebea19a646c3 1069
ligeiro13 0:ebea19a646c3 1070 _function_1 = 0x0A; // Set function, 0 0 1 X N BE RE(1) REV
ligeiro13 0:ebea19a646c3 1071 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 1072 // DL=X bit is ignored for US2066. Uses hardwired pins instead
ligeiro13 0:ebea19a646c3 1073 // N=1 2 line / 4 Line
ligeiro13 0:ebea19a646c3 1074 // BE=0 Blink Enable off, special feature of SSD1803, US2066
ligeiro13 0:ebea19a646c3 1075 // REV=0 Reverse off, special feature of SSD1803, US2066
ligeiro13 0:ebea19a646c3 1076
ligeiro13 0:ebea19a646c3 1077 _lines = 0x00; // Ext function set 0 0 0 0 1 FW BW NW
ligeiro13 0:ebea19a646c3 1078 // NW=0 2-Line LCD (N=1)
ligeiro13 0:ebea19a646c3 1079 break;
ligeiro13 0:ebea19a646c3 1080
ligeiro13 0:ebea19a646c3 1081 case LCD12x3D: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 1082 // case LCD12x3D1: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 1083 case LCD16x3D: // Special mode for KS0078, SSD1803 and US2066
ligeiro13 0:ebea19a646c3 1084 // case LCD16x3D1: // Special mode for SSD1803, US2066
ligeiro13 0:ebea19a646c3 1085 // case LCD20x3D: // Special mode for SSD1803, US2066
ligeiro13 0:ebea19a646c3 1086 _function = 0x00; // Set function 0 0 1 X N DH RE(0) IS
ligeiro13 0:ebea19a646c3 1087 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 1088 // DL=X bit is ignored for US2066. Uses hardwired pins instead
ligeiro13 0:ebea19a646c3 1089 // N=0 1 Line / 3 Line
ligeiro13 0:ebea19a646c3 1090 // DH=0 Double Height disable
ligeiro13 0:ebea19a646c3 1091 // IS=0
ligeiro13 0:ebea19a646c3 1092
ligeiro13 0:ebea19a646c3 1093 _function_1 = 0x02; // Set function, 0 0 1 X N BE RE(1) REV
ligeiro13 0:ebea19a646c3 1094 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 1095 // DL=X bit is ignored for US2066. Uses hardwired pins instead
ligeiro13 0:ebea19a646c3 1096 // N=0 1 Line / 3 Line
ligeiro13 0:ebea19a646c3 1097 // BE=0 Blink Enable off, special feature of SSD1803, US2066
ligeiro13 0:ebea19a646c3 1098 // REV=0 Reverse off, special feature of SSD1803, US2066
ligeiro13 0:ebea19a646c3 1099
ligeiro13 0:ebea19a646c3 1100 _lines = 0x00; // Ext function set 0 0 0 0 1 FW BW NW
ligeiro13 0:ebea19a646c3 1101 // NW=1 3-Line LCD (N=0)
ligeiro13 0:ebea19a646c3 1102 break;
ligeiro13 0:ebea19a646c3 1103
ligeiro13 0:ebea19a646c3 1104 case LCD20x4D: // Special mode for SSD1803, US2066
ligeiro13 0:ebea19a646c3 1105 _function = 0x08; // Set function 0 0 1 X N DH RE(0) IS
ligeiro13 0:ebea19a646c3 1106 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 1107 // DL=X bit is ignored for US2066. Uses hardwired pins instead
ligeiro13 0:ebea19a646c3 1108 // N=1 2 line / 4 Line
ligeiro13 0:ebea19a646c3 1109 // DH=0 Double Height disable
ligeiro13 0:ebea19a646c3 1110 // IS=0
ligeiro13 0:ebea19a646c3 1111
ligeiro13 0:ebea19a646c3 1112 _function_1 = 0x0A; // Set function, 0 0 1 DL N BE RE(1) REV
ligeiro13 0:ebea19a646c3 1113 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 1114 // DL=0 bit is ignored for US2066. Uses hardwired pins instead
ligeiro13 0:ebea19a646c3 1115 // N=1 2 line / 4 Line
ligeiro13 0:ebea19a646c3 1116 // BE=0 Blink Enable off, special feature of SSD1803, US2066
ligeiro13 0:ebea19a646c3 1117 // REV=0 Reverse off, special feature of SSD1803, US2066
ligeiro13 0:ebea19a646c3 1118
ligeiro13 0:ebea19a646c3 1119 _lines = 0x01; // Ext function set 0 0 0 0 1 FW BW NW
ligeiro13 0:ebea19a646c3 1120 // NW=1 4-Line LCD (N=1)
ligeiro13 0:ebea19a646c3 1121 break;
ligeiro13 0:ebea19a646c3 1122
ligeiro13 0:ebea19a646c3 1123 // case LCD24x1:
ligeiro13 0:ebea19a646c3 1124 // case LCD16x3G: // Special mode for ST7036
ligeiro13 0:ebea19a646c3 1125 // case LCD24x4D: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 1126 default:
ligeiro13 0:ebea19a646c3 1127 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 1128 break;
ligeiro13 0:ebea19a646c3 1129
ligeiro13 0:ebea19a646c3 1130 } // switch type
ligeiro13 0:ebea19a646c3 1131
ligeiro13 0:ebea19a646c3 1132 _writeCommand(0x00); // NOP, make sure to sync SPI
ligeiro13 0:ebea19a646c3 1133
ligeiro13 0:ebea19a646c3 1134 // init special features
ligeiro13 0:ebea19a646c3 1135 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 X N BE RE(1) REV
ligeiro13 0:ebea19a646c3 1136 // Select Extended Instruction Set
ligeiro13 0:ebea19a646c3 1137
ligeiro13 0:ebea19a646c3 1138 _writeCommand(0x71); // Function Select A: 0 1 1 1 0 0 0 1 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 1139 _writeData(0x00); // Disable Internal VDD
ligeiro13 0:ebea19a646c3 1140
ligeiro13 0:ebea19a646c3 1141 _writeCommand(0x79); // Function Select OLED: 0 1 1 1 1 0 0 1 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 1142
ligeiro13 0:ebea19a646c3 1143 _writeCommand(0xD5); // Display Clock Divide Ratio: 1 1 0 1 0 1 0 1 (Ext Instr Set, OLED Instr Set)
ligeiro13 0:ebea19a646c3 1144 _writeCommand(0x70); // Display Clock Divide Ratio value: 0 1 1 1 0 0 0 0 (Ext Instr Set, OLED Instr Set)
ligeiro13 0:ebea19a646c3 1145
ligeiro13 0:ebea19a646c3 1146 _writeCommand(0x78); // Function Disable OLED: 0 1 1 1 1 0 0 0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 1147
ligeiro13 0:ebea19a646c3 1148 // _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)
ligeiro13 0:ebea19a646c3 1149 _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)
ligeiro13 0:ebea19a646c3 1150
ligeiro13 0:ebea19a646c3 1151 _writeCommand(0x08 | _lines); // Set ext function 0 0 0 0 1 FW BW NW 1,2,3 or 4 lines (Ext Instr Set)
ligeiro13 0:ebea19a646c3 1152
ligeiro13 0:ebea19a646c3 1153 // _writeCommand(0x1C); // Double Height, 0 0 0 1 UD2=1, UD1=1, X, DH'=0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 1154 // // Default
ligeiro13 0:ebea19a646c3 1155
ligeiro13 0:ebea19a646c3 1156 _writeCommand(0x72); // Function Select B: 0 1 1 1 0 0 1 0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 1157 _writeData(0x01); // Select ROM A (CGRAM 8, CGROM 248)
ligeiro13 0:ebea19a646c3 1158
ligeiro13 0:ebea19a646c3 1159 _writeCommand(0x79); // Function Select OLED: 0 1 1 1 1 0 0 1 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 1160
ligeiro13 0:ebea19a646c3 1161 _writeCommand(0xDA); // Set Segm Pins Config: 1 1 0 1 1 0 1 0 (Ext Instr Set, OLED)
ligeiro13 0:ebea19a646c3 1162 _writeCommand(0x10); // Set Segm Pins Config value: Altern Odd/Even, Disable Remap (Ext Instr Set, OLED)
ligeiro13 0:ebea19a646c3 1163
ligeiro13 0:ebea19a646c3 1164 _writeCommand(0xDC); // Function Select C: 1 1 0 1 1 1 0 0 (Ext Instr Set, OLED)
ligeiro13 0:ebea19a646c3 1165 // _writeCommand(0x00); // Set internal VSL, GPIO pin HiZ (always read low)
ligeiro13 0:ebea19a646c3 1166 _writeCommand(0x80); // Set external VSL, GPIO pin HiZ (always read low)
ligeiro13 0:ebea19a646c3 1167
ligeiro13 0:ebea19a646c3 1168 _contrast = LCD_US20_CONTRAST;
ligeiro13 0:ebea19a646c3 1169 _writeCommand(0x81); // Set Contrast Control: 1 0 0 0 0 0 0 1 (Ext Instr Set, OLED)
ligeiro13 0:ebea19a646c3 1170 _writeCommand((_contrast << 2) | 0x03); // Set Contrast Value: 8 bits, use 6 bits for compatibility
ligeiro13 0:ebea19a646c3 1171
ligeiro13 0:ebea19a646c3 1172 _writeCommand(0xD9); // Set Phase Length: 1 1 0 1 1 0 0 1 (Ext Instr Set, OLED)
ligeiro13 0:ebea19a646c3 1173 _writeCommand(0xF1); // Set Phase Length Value:
ligeiro13 0:ebea19a646c3 1174
ligeiro13 0:ebea19a646c3 1175 _writeCommand(0xDB); // Set VCOMH Deselect Lvl: 1 1 0 1 1 0 1 1 (Ext Instr Set, OLED)
ligeiro13 0:ebea19a646c3 1176 _writeCommand(0x30); // Set VCOMH Deselect Value: 0.83 x VCC
ligeiro13 0:ebea19a646c3 1177
ligeiro13 0:ebea19a646c3 1178 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 1179
ligeiro13 0:ebea19a646c3 1180 //Test Fade/Blinking. Hard Blink on/off, No fade in/out ??
ligeiro13 0:ebea19a646c3 1181 // _writeCommand(0x23); // Set (Ext Instr Set, OLED)
ligeiro13 0:ebea19a646c3 1182 // _writeCommand(0x3F); // Set interval 128 frames
ligeiro13 0:ebea19a646c3 1183 //End Test Blinking
ligeiro13 0:ebea19a646c3 1184
ligeiro13 0:ebea19a646c3 1185 _writeCommand(0x78); // Function Disable OLED: 0 1 1 1 1 0 0 0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 1186
ligeiro13 0:ebea19a646c3 1187 _writeCommand(0x20 | _function | 0x01); // Set function, 0 0 1 X N DH RE(0) IS=1 Select Instruction Set 1
ligeiro13 0:ebea19a646c3 1188 // Select Std Instr set, Select IS=1
ligeiro13 0:ebea19a646c3 1189
ligeiro13 0:ebea19a646c3 1190 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 X N BE RE(1) REV
ligeiro13 0:ebea19a646c3 1191 // Select Ext Instr Set, IS=1
ligeiro13 0:ebea19a646c3 1192 _writeCommand(0x10); // Shift/Scroll enable, 0 0 0 1 DS4/HS4 DS3/HS3 DS2/HS2 DS1/HS1 (Ext Instr Set, IS=1)
ligeiro13 0:ebea19a646c3 1193
ligeiro13 0:ebea19a646c3 1194 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 1195 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 1196 break; // case US2066/SSD1311 Controller
ligeiro13 0:ebea19a646c3 1197
ligeiro13 0:ebea19a646c3 1198 //not yet tested on hardware
ligeiro13 0:ebea19a646c3 1199 case PT6314 :
ligeiro13 0:ebea19a646c3 1200 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 1201 switch (_type) {
ligeiro13 0:ebea19a646c3 1202 case LCD8x1: //8x1 is a regular 1 line display
ligeiro13 0:ebea19a646c3 1203 case LCD8x2B: //8x2B is a special case of 16x1
ligeiro13 0:ebea19a646c3 1204 // case LCD12x1:
ligeiro13 0:ebea19a646c3 1205 case LCD16x1:
ligeiro13 0:ebea19a646c3 1206 case LCD20x1:
ligeiro13 0:ebea19a646c3 1207 case LCD24x1:
ligeiro13 0:ebea19a646c3 1208 _function = 0x00; // Function set 001 DL N X BR1 BR0
ligeiro13 0:ebea19a646c3 1209 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 1210 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 1211 // N=0 (1 line)
ligeiro13 0:ebea19a646c3 1212 // X
ligeiro13 0:ebea19a646c3 1213 // BR1=0 (2 significant bits for brightness
ligeiro13 0:ebea19a646c3 1214 // BR0=0
ligeiro13 0:ebea19a646c3 1215 // 0x0 = 100%
ligeiro13 0:ebea19a646c3 1216 // 0x1 = 75%
ligeiro13 0:ebea19a646c3 1217 // 0x2 = 50%
ligeiro13 0:ebea19a646c3 1218 // 0x3 = 25%
ligeiro13 0:ebea19a646c3 1219
ligeiro13 0:ebea19a646c3 1220 break;
ligeiro13 0:ebea19a646c3 1221
ligeiro13 0:ebea19a646c3 1222 // All other valid LCD types are initialised as 2 Line displays
ligeiro13 0:ebea19a646c3 1223 case LCD8x2:
ligeiro13 0:ebea19a646c3 1224 case LCD16x2:
ligeiro13 0:ebea19a646c3 1225 case LCD20x2:
ligeiro13 0:ebea19a646c3 1226 case LCD24x2:
ligeiro13 0:ebea19a646c3 1227 _function = 0x08; // Function set 001 DL N X BR1 BR2
ligeiro13 0:ebea19a646c3 1228 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 1229 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 1230 // N=1 (2 lines)
ligeiro13 0:ebea19a646c3 1231 // X
ligeiro13 0:ebea19a646c3 1232 // BR1=0 (2 significant bits for brightness
ligeiro13 0:ebea19a646c3 1233 // BR0=0
ligeiro13 0:ebea19a646c3 1234 break;
ligeiro13 0:ebea19a646c3 1235
ligeiro13 0:ebea19a646c3 1236 default:
ligeiro13 0:ebea19a646c3 1237 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 1238 break;
ligeiro13 0:ebea19a646c3 1239 } // switch type
ligeiro13 0:ebea19a646c3 1240
ligeiro13 0:ebea19a646c3 1241 _contrast = LCD_PT63_CONTRAST;
ligeiro13 0:ebea19a646c3 1242 _writeCommand(0x20 | _function | ((~_contrast) >> 4)); // Invert and shift to use 2 MSBs
ligeiro13 0:ebea19a646c3 1243 break; // case PT6314 Controller (VFD)
ligeiro13 0:ebea19a646c3 1244
ligeiro13 0:ebea19a646c3 1245
ligeiro13 0:ebea19a646c3 1246 case HD66712:
ligeiro13 0:ebea19a646c3 1247 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 1248 switch (_type) {
ligeiro13 0:ebea19a646c3 1249 case LCD8x1: //8x1 is a regular 1 line display
ligeiro13 0:ebea19a646c3 1250 case LCD12x1:
ligeiro13 0:ebea19a646c3 1251 case LCD16x1:
ligeiro13 0:ebea19a646c3 1252 case LCD20x1:
ligeiro13 0:ebea19a646c3 1253 case LCD24x1:
ligeiro13 0:ebea19a646c3 1254 // case LCD32x1: // EXT pin is High, extension driver needed
ligeiro13 0:ebea19a646c3 1255 _function = 0x02; // Function set 001 DL N RE(0) - - (Std Regs)
ligeiro13 0:ebea19a646c3 1256 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 1257 // N=0 (1-line mode, N=1 2-line mode)
ligeiro13 0:ebea19a646c3 1258 // RE=0 (Dis. Extended Regs, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1259 //
ligeiro13 0:ebea19a646c3 1260
ligeiro13 0:ebea19a646c3 1261 _function_1 = 0x04; // Function set 001 DL N RE(1) BE LP (Ext Regs)
ligeiro13 0:ebea19a646c3 1262 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 1263 // N=0 (1-line mode, N=1 2-line mode)
ligeiro13 0:ebea19a646c3 1264 // RE=1 (Ena Extended Regs; special mode for HD66712)
ligeiro13 0:ebea19a646c3 1265 // BE=0 (Blink Enable, CG/SEG RAM; special mode for HD66712)
ligeiro13 0:ebea19a646c3 1266 // LP=0 (LP=1 Low power mode, LP=0 Normal; special mode for HD66712)
ligeiro13 0:ebea19a646c3 1267
ligeiro13 0:ebea19a646c3 1268 _function_x = 0x00; // Ext Function set 0000 1 FW BW NW (Ext Regs)
ligeiro13 0:ebea19a646c3 1269 // NW=0 (1,2 line), NW=1 (4 Line, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1270 break;
ligeiro13 0:ebea19a646c3 1271
ligeiro13 0:ebea19a646c3 1272 // case LCD12x3D: // Special mode for KS0073, KS0078, PCF21XX and HD66712
ligeiro13 0:ebea19a646c3 1273 // case LCD12x3D1: // Special mode for KS0073, KS0078, PCF21XX and HD66712
ligeiro13 0:ebea19a646c3 1274 case LCD12x4D: // Special mode for KS0073, KS0078, PCF21XX and HD66712
ligeiro13 0:ebea19a646c3 1275 // case LCD16x3D: // Special mode for KS0073, KS0078 and HD66712
ligeiro13 0:ebea19a646c3 1276 // case LCD16x4D: // Special mode for KS0073, KS0078 and HD66712
ligeiro13 0:ebea19a646c3 1277 case LCD20x4D: // Special mode for KS0073, KS0078 and HD66712
ligeiro13 0:ebea19a646c3 1278 _function = 0x02; // Function set 001 DL N RE(0) - - (Std Regs)
ligeiro13 0:ebea19a646c3 1279 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 1280 // N=0 (1-line mode, N=1 2-line mode)
ligeiro13 0:ebea19a646c3 1281 // RE=0 (Dis. Extended Regs, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1282 //
ligeiro13 0:ebea19a646c3 1283
ligeiro13 0:ebea19a646c3 1284 _function_1 = 0x04; // Function set 001 DL N RE(1) BE LP (Ext Regs)
ligeiro13 0:ebea19a646c3 1285 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 1286 // N=0 (1-line mode, N=1 2-line mode)
ligeiro13 0:ebea19a646c3 1287 // RE=1 (Ena Extended Regs; special mode for HD66712)
ligeiro13 0:ebea19a646c3 1288 // BE=0 (Blink Enable, CG/SEG RAM; special mode for HD66712)
ligeiro13 0:ebea19a646c3 1289 // LP=0 (LP=1 Low power mode, LP=0 Normal; special mode for HD66712)
ligeiro13 0:ebea19a646c3 1290
ligeiro13 0:ebea19a646c3 1291 _function_x = 0x01; // Ext Function set 0000 1 FW BW NW (Ext Regs)
ligeiro13 0:ebea19a646c3 1292 // NW=0 (1,2 line), NW=1 (4 Line, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1293 break;
ligeiro13 0:ebea19a646c3 1294
ligeiro13 0:ebea19a646c3 1295 case LCD16x3G: // Special mode for ST7036
ligeiro13 0:ebea19a646c3 1296 // case LCD24x3D: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 1297 // case LCD24x3D1: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 1298 case LCD24x4D: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 1299 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 1300 break;
ligeiro13 0:ebea19a646c3 1301
ligeiro13 0:ebea19a646c3 1302 default:
ligeiro13 0:ebea19a646c3 1303 // All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
ligeiro13 0:ebea19a646c3 1304 _function = 0x0A; // Function set 001 DL N RE(0) - - (Std Regs)
ligeiro13 0:ebea19a646c3 1305 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 1306 // N=1 (2-line mode), N=0 (1-line mode)
ligeiro13 0:ebea19a646c3 1307 // RE=0 (Dis. Extended Regs, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1308
ligeiro13 0:ebea19a646c3 1309 _function_1 = 0x0C; // Function set 001 DL N RE(1) BE LP (Ext Regs)
ligeiro13 0:ebea19a646c3 1310 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 1311 // N=1 (2 line mode), N=0 (1-line mode)
ligeiro13 0:ebea19a646c3 1312 // RE=1 (Ena Extended Regs, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1313 // BE=0 (Blink Enable, CG/SEG RAM, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1314 // LP=0 (LP=1 Low power mode, LP=0 Normal)
ligeiro13 0:ebea19a646c3 1315
ligeiro13 0:ebea19a646c3 1316 _function_x = 0x00; // Ext Function set 0000 1 FW BW NW (Ext Regs)
ligeiro13 0:ebea19a646c3 1317 // NW=0 (1,2 line), NW=1 (4 Line, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1318 break;
ligeiro13 0:ebea19a646c3 1319 } // switch type
ligeiro13 0:ebea19a646c3 1320
ligeiro13 0:ebea19a646c3 1321 // init special features
ligeiro13 0:ebea19a646c3 1322 _writeCommand(0x20 | _function_1);// Function set 001 DL N RE(1) BE LP (Ext Regs)
ligeiro13 0:ebea19a646c3 1323 // DL=0 (4 bits bus), DL=1 (8 bits mode)
ligeiro13 0:ebea19a646c3 1324 // N=0 (1 line mode), N=1 (2 line mode)
ligeiro13 0:ebea19a646c3 1325 // RE=1 (Ena Extended Regs, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1326 // BE=0 (Blink Enable/Disable, CG/SEG RAM, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1327 // LP=0 (LP=1 Low power mode, LP=0 Normal)
ligeiro13 0:ebea19a646c3 1328
ligeiro13 0:ebea19a646c3 1329 _writeCommand(0x08 | _function_x); // Ext Function set 0000 1 FW BW NW (Ext Regs)
ligeiro13 0:ebea19a646c3 1330 // FW=0 (5-dot font, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1331 // BW=0 (Cur BW invert disable, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1332 // NW=0 (1,2 Line), NW=1 (4 line, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1333
ligeiro13 0:ebea19a646c3 1334 _writeCommand(0x10); // Scroll/Shift set 0001 HS4 HS3 HS2 HS1 (Ext Regs)
ligeiro13 0:ebea19a646c3 1335 // Dotscroll/Display shift enable (Special mode for HD66712)
ligeiro13 0:ebea19a646c3 1336
ligeiro13 0:ebea19a646c3 1337 _writeCommand(0x80); // Scroll Quantity set 1 0 HDS5 HDS4 HDS3 HDS2 HDS1 HDS0 (Ext Regs)
ligeiro13 0:ebea19a646c3 1338 // Scroll quantity (Special mode for HD66712)
ligeiro13 0:ebea19a646c3 1339
ligeiro13 0:ebea19a646c3 1340 _writeCommand(0x20 | _function); // Function set 001 DL N RE(0) DH REV (Std Regs)
ligeiro13 0:ebea19a646c3 1341 // DL=0 (4 bits bus), DL=1 (8 bits mode)
ligeiro13 0:ebea19a646c3 1342 // N=0 (1 line mode), N=1 (2 line mode)
ligeiro13 0:ebea19a646c3 1343 // RE=0 (Dis. Extended Regs, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1344 // DH=1 (Disp shift enable/disable, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1345 // REV=0 (Reverse/Normal, special mode for HD66712)
ligeiro13 0:ebea19a646c3 1346 break; // case HD66712 Controller
ligeiro13 0:ebea19a646c3 1347
ligeiro13 0:ebea19a646c3 1348 case SPLC792A_3V3:
ligeiro13 0:ebea19a646c3 1349 // SPLC792A controller: Initialise Voltage booster for VLCD. VDD=3V3
ligeiro13 0:ebea19a646c3 1350 // Note very similar to ST7032
ligeiro13 0:ebea19a646c3 1351
ligeiro13 0:ebea19a646c3 1352 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 1353 switch (_type) {
ligeiro13 0:ebea19a646c3 1354 case LCD8x1: //8x1 is a regular 1 line display
ligeiro13 0:ebea19a646c3 1355 case LCD8x2B: //8x2B is a special case of 16x1
ligeiro13 0:ebea19a646c3 1356 // case LCD12x1:
ligeiro13 0:ebea19a646c3 1357 case LCD16x1:
ligeiro13 0:ebea19a646c3 1358 // case LCD20x1:
ligeiro13 0:ebea19a646c3 1359 case LCD24x1:
ligeiro13 0:ebea19a646c3 1360 _function = 0x00; // FUNCTION SET 0 0 1 DL=0 (4 bit), N=0 (1-line display mode), F=0 (5*7dot), 0, IS
ligeiro13 0:ebea19a646c3 1361 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 1362 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 1363 break;
ligeiro13 0:ebea19a646c3 1364
ligeiro13 0:ebea19a646c3 1365 case LCD12x3D: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 1366 case LCD12x3D1: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 1367 case LCD12x4D: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 1368 case LCD16x3G: // Special mode for ST7036
ligeiro13 0:ebea19a646c3 1369 case LCD24x4D: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 1370 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 1371 break;
ligeiro13 0:ebea19a646c3 1372
ligeiro13 0:ebea19a646c3 1373 default:
ligeiro13 0:ebea19a646c3 1374 // All other LCD types are initialised as 2 Line displays
ligeiro13 0:ebea19a646c3 1375 _function = 0x08; // FUNCTION SET 0 0 1 DL=0 (4 bit), N=1 (2-line display mode), F=0 (5*7dot), 0, IS
ligeiro13 0:ebea19a646c3 1376 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 1377 // Saved to allow switch between Instruction sets at later time
ligeiro13 0:ebea19a646c3 1378 break;
ligeiro13 0:ebea19a646c3 1379 } // switch type
ligeiro13 0:ebea19a646c3 1380
ligeiro13 0:ebea19a646c3 1381 // init special features
ligeiro13 0:ebea19a646c3 1382 _writeCommand(0x20 | _function | 0x01); // Set function, 0 0 1 DL N F 0 IS=1 Select Instr Set = 1
ligeiro13 0:ebea19a646c3 1383
ligeiro13 0:ebea19a646c3 1384 //SPLC792A Does not support Bias and Internal Osc register
ligeiro13 0:ebea19a646c3 1385 // _writeCommand(0x1C); // Internal OSC frequency adjustment Framefreq=183HZ, Bias will be 1/4 (Instr Set=1)
ligeiro13 0:ebea19a646c3 1386
ligeiro13 0:ebea19a646c3 1387 _contrast = LCD_SPLC792A_CONTRAST;
ligeiro13 0:ebea19a646c3 1388 _writeCommand(0x70 | (_contrast & 0x0F)); // Set Contrast Low bits, 0 1 1 1 C3 C2 C1 C0 (IS=1)
ligeiro13 0:ebea19a646c3 1389
ligeiro13 0:ebea19a646c3 1390
ligeiro13 0:ebea19a646c3 1391 // _icon_power = 0x04; // Icon display off (Bit3=0), Booster circuit is turned on (Bit2=1) (IS=1)
ligeiro13 0:ebea19a646c3 1392 _icon_power = 0x0C; // Icon display on (Bit3=1), Booster circuit is turned on (Bit2=1) (IS=1)
ligeiro13 0:ebea19a646c3 1393 // Note: Booster circuit always on for SPLC792A, Bit2 is dont care
ligeiro13 0:ebea19a646c3 1394 // Saved to allow contrast change at later time
ligeiro13 0:ebea19a646c3 1395
ligeiro13 0:ebea19a646c3 1396 _writeCommand(0x50 | _icon_power | ((_contrast >> 4) & 0x03)); // Set Icon, Booster and Contrast High bits, 0 1 0 1 Ion Bon C5 C4 (IS=1)
ligeiro13 0:ebea19a646c3 1397 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 1398
ligeiro13 0:ebea19a646c3 1399 _writeCommand(0x68 | (LCD_SPLC792A_RAB & 0x07)); // Voltage follower, 0 1 1 0 FOn=1, Ampl ratio Rab2=1, Rab1=0, Rab0=0 (IS=1)
ligeiro13 0:ebea19a646c3 1400 // Note: Follower circuit always on for SPLC792A, Bit3 is dont care
ligeiro13 0:ebea19a646c3 1401 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 1402
ligeiro13 0:ebea19a646c3 1403 _writeCommand(0x20 | _function); // Select Instruction Set = 0
ligeiro13 0:ebea19a646c3 1404
ligeiro13 0:ebea19a646c3 1405 break; // case SPLC792A_3V3 Controller
ligeiro13 0:ebea19a646c3 1406
ligeiro13 0:ebea19a646c3 1407 case ST7066_ACM: // ST7066 4/8 bit, I2C on ACM1602 using a PIC
ligeiro13 0:ebea19a646c3 1408 default:
ligeiro13 0:ebea19a646c3 1409 // Devices fully compatible to HD44780 that do not use any DC/DC Voltage converters but external VLCD, no icons etc
ligeiro13 0:ebea19a646c3 1410
ligeiro13 0:ebea19a646c3 1411 // Initialise Display configuration
ligeiro13 0:ebea19a646c3 1412 switch (_type) {
ligeiro13 0:ebea19a646c3 1413 case LCD8x1: //8x1 is a regular 1 line display
ligeiro13 0:ebea19a646c3 1414 case LCD8x2B: //8x2B is a special case of 16x1
ligeiro13 0:ebea19a646c3 1415 // case LCD12x1:
ligeiro13 0:ebea19a646c3 1416 case LCD16x1:
ligeiro13 0:ebea19a646c3 1417 // case LCD20x1:
ligeiro13 0:ebea19a646c3 1418 case LCD24x1:
ligeiro13 0:ebea19a646c3 1419 // case LCD40x1:
ligeiro13 0:ebea19a646c3 1420 _function = 0x00; // Function set 001 DL N F - -
ligeiro13 0:ebea19a646c3 1421 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 1422 // N=0 (1 line)
ligeiro13 0:ebea19a646c3 1423 // F=0 (5x7 dots font)
ligeiro13 0:ebea19a646c3 1424 break;
ligeiro13 0:ebea19a646c3 1425
ligeiro13 0:ebea19a646c3 1426 case LCD12x3D: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 1427 case LCD12x3D1: // Special mode for KS0078 and PCF21XX
ligeiro13 0:ebea19a646c3 1428 case LCD12x4D: // Special mode for KS0078 and PCF21XX:
ligeiro13 0:ebea19a646c3 1429 case LCD16x3D: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 1430 // case LCD16x3D1: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 1431 // case LCD24x3D: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 1432 // case LCD24x3D1: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 1433 case LCD24x4D: // Special mode for KS0078
ligeiro13 0:ebea19a646c3 1434 error("Error: LCD Controller type does not support this Display type\n\r");
ligeiro13 0:ebea19a646c3 1435 break;
ligeiro13 0:ebea19a646c3 1436
ligeiro13 0:ebea19a646c3 1437 // All other LCD types are initialised as 2 Line displays (including LCD16x1C and LCD40x4)
ligeiro13 0:ebea19a646c3 1438 default:
ligeiro13 0:ebea19a646c3 1439 _function = 0x08; // Function set 001 DL N F - -
ligeiro13 0:ebea19a646c3 1440 // DL=0 (4 bits bus)
ligeiro13 0:ebea19a646c3 1441 // Note: 4 bit mode is ignored for native SPI and I2C devices
ligeiro13 0:ebea19a646c3 1442 // N=1 (2 lines)
ligeiro13 0:ebea19a646c3 1443 // F=0 (5x7 dots font, only option for 2 line display)
ligeiro13 0:ebea19a646c3 1444 // - (Don't care)
ligeiro13 0:ebea19a646c3 1445 break;
ligeiro13 0:ebea19a646c3 1446 } // switch type
ligeiro13 0:ebea19a646c3 1447
ligeiro13 0:ebea19a646c3 1448 _writeCommand(0x20 | _function);
ligeiro13 0:ebea19a646c3 1449 break; // case default Controller
ligeiro13 0:ebea19a646c3 1450
ligeiro13 0:ebea19a646c3 1451 } // switch Controller specific initialisations
ligeiro13 0:ebea19a646c3 1452
ligeiro13 0:ebea19a646c3 1453 // Controller general initialisations
ligeiro13 0:ebea19a646c3 1454 // _writeCommand(0x01); // Clear Display and set cursor to 0
ligeiro13 0:ebea19a646c3 1455 // wait_ms(10); // The CLS command takes 1.64 ms.
ligeiro13 0:ebea19a646c3 1456 // // Since we are not using the Busy flag, Lets be safe and take 10 ms
ligeiro13 0:ebea19a646c3 1457
ligeiro13 0:ebea19a646c3 1458 _writeCommand(0x02); // Cursor Home, DDRAM Address to Origin
ligeiro13 0:ebea19a646c3 1459 wait_ms(10); // The Return Home command takes 1.64 ms.
ligeiro13 0:ebea19a646c3 1460 // Since we are not using the Busy flag, Lets be safe and take 10 ms
ligeiro13 0:ebea19a646c3 1461
ligeiro13 0:ebea19a646c3 1462 _writeCommand(0x06); // Entry Mode 0000 0 1 I/D S
ligeiro13 0:ebea19a646c3 1463 // Cursor Direction and Display Shift
ligeiro13 0:ebea19a646c3 1464 // I/D=1 (Cur incr)
ligeiro13 0:ebea19a646c3 1465 // S=0 (No display shift)
ligeiro13 0:ebea19a646c3 1466
ligeiro13 0:ebea19a646c3 1467 _writeCommand(0x14); // Cursor or Display shift 0001 S/C R/L x x
ligeiro13 0:ebea19a646c3 1468 // S/C=0 Cursor moves
ligeiro13 0:ebea19a646c3 1469 // R/L=1 Right
ligeiro13 0:ebea19a646c3 1470 //
ligeiro13 0:ebea19a646c3 1471
ligeiro13 0:ebea19a646c3 1472 // _writeCommand(0x0C); // Display Ctrl 0000 1 D C B
ligeiro13 0:ebea19a646c3 1473 // // Display On, Cursor Off, Blink Off
ligeiro13 0:ebea19a646c3 1474
ligeiro13 0:ebea19a646c3 1475 // setCursor(CurOff_BlkOff);
ligeiro13 0:ebea19a646c3 1476 setCursor(CurOn_BlkOff);
ligeiro13 0:ebea19a646c3 1477 setMode(DispOn);
ligeiro13 0:ebea19a646c3 1478 }
ligeiro13 0:ebea19a646c3 1479
ligeiro13 0:ebea19a646c3 1480
ligeiro13 0:ebea19a646c3 1481 /** Clear the screen, Cursor home.
ligeiro13 0:ebea19a646c3 1482 * Note: The whole display is initialised to charcode 0x20, which may not be a 'space' on some controllers with a
ligeiro13 0:ebea19a646c3 1483 * different fontset such as the PCF2116C or PCF2119R. In this case you should fill the display with 'spaces'.
ligeiro13 0:ebea19a646c3 1484 */
ligeiro13 0:ebea19a646c3 1485 void TextLCD_Base::cls() {
ligeiro13 0:ebea19a646c3 1486
ligeiro13 0:ebea19a646c3 1487 #if (LCD_TWO_CTRL == 1)
ligeiro13 0:ebea19a646c3 1488 // Select and configure second LCD controller when needed
ligeiro13 0:ebea19a646c3 1489 if(_type==LCD40x4) {
ligeiro13 0:ebea19a646c3 1490 _ctrl_idx=_LCDCtrl_1; // Select 2nd controller
ligeiro13 0:ebea19a646c3 1491
ligeiro13 0:ebea19a646c3 1492 // Second LCD controller Cursor always Off
ligeiro13 0:ebea19a646c3 1493 _setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
ligeiro13 0:ebea19a646c3 1494
ligeiro13 0:ebea19a646c3 1495 // Second LCD controller Clearscreen
ligeiro13 0:ebea19a646c3 1496 _writeCommand(0x01); // cls, and set cursor to 0
ligeiro13 0:ebea19a646c3 1497 wait_ms(20); // The CLS command takes 1.64 ms.
ligeiro13 0:ebea19a646c3 1498 // Since we are not using the Busy flag, Lets be safe and take 10 ms
ligeiro13 0:ebea19a646c3 1499
ligeiro13 0:ebea19a646c3 1500 _ctrl_idx=_LCDCtrl_0; // Select primary controller
ligeiro13 0:ebea19a646c3 1501 }
ligeiro13 0:ebea19a646c3 1502
ligeiro13 0:ebea19a646c3 1503
ligeiro13 0:ebea19a646c3 1504 // Primary LCD controller Clearscreen
ligeiro13 0:ebea19a646c3 1505 _writeCommand(0x01); // cls, and set cursor to 0
ligeiro13 0:ebea19a646c3 1506 wait_ms(20); // The CLS command takes 1.64 ms.
ligeiro13 0:ebea19a646c3 1507 // Since we are not using the Busy flag, Lets be safe and take 10 ms
ligeiro13 0:ebea19a646c3 1508
ligeiro13 0:ebea19a646c3 1509 // Restore cursormode on primary LCD controller when needed
ligeiro13 0:ebea19a646c3 1510 if(_type==LCD40x4) {
ligeiro13 0:ebea19a646c3 1511 _setCursorAndDisplayMode(_currentMode,_currentCursor);
ligeiro13 0:ebea19a646c3 1512 }
ligeiro13 0:ebea19a646c3 1513
ligeiro13 0:ebea19a646c3 1514 #else
ligeiro13 0:ebea19a646c3 1515 // Support only one LCD controller
ligeiro13 0:ebea19a646c3 1516 _writeCommand(0x01); // cls, and set cursor to 0
ligeiro13 0:ebea19a646c3 1517 wait_ms(20); // The CLS command takes 1.64 ms.
ligeiro13 0:ebea19a646c3 1518 // Since we are not using the Busy flag, Lets be safe and take 10 ms
ligeiro13 0:ebea19a646c3 1519 #endif
ligeiro13 0:ebea19a646c3 1520
ligeiro13 0:ebea19a646c3 1521 setAddress(0, 0); // Reset Cursor location
ligeiro13 0:ebea19a646c3 1522 // Note: This is needed because some displays (eg PCF21XX) don't use line 0 in the '3 Line' mode.
ligeiro13 0:ebea19a646c3 1523 }
ligeiro13 0:ebea19a646c3 1524
ligeiro13 0:ebea19a646c3 1525 /** Locate cursor to a screen column and row
ligeiro13 0:ebea19a646c3 1526 *
ligeiro13 0:ebea19a646c3 1527 * @param column The horizontal position from the left, indexed from 0
ligeiro13 0:ebea19a646c3 1528 * @param row The vertical position from the top, indexed from 0
ligeiro13 0:ebea19a646c3 1529 */
ligeiro13 0:ebea19a646c3 1530 void TextLCD_Base::locate(int column, int row) {
ligeiro13 0:ebea19a646c3 1531
ligeiro13 0:ebea19a646c3 1532 // setAddress() does all the heavy lifting:
ligeiro13 0:ebea19a646c3 1533 // check column and row sanity,
ligeiro13 0:ebea19a646c3 1534 // switch controllers for LCD40x4 if needed
ligeiro13 0:ebea19a646c3 1535 // switch cursor for LCD40x4 if needed
ligeiro13 0:ebea19a646c3 1536 // set the new memory address to show cursor at correct location
ligeiro13 0:ebea19a646c3 1537 setAddress(column, row);
ligeiro13 0:ebea19a646c3 1538 }
ligeiro13 0:ebea19a646c3 1539
ligeiro13 0:ebea19a646c3 1540
ligeiro13 0:ebea19a646c3 1541 /** Write a single character (Stream implementation)
ligeiro13 0:ebea19a646c3 1542 */
ligeiro13 0:ebea19a646c3 1543 int TextLCD_Base::_putc(int value) {
ligeiro13 0:ebea19a646c3 1544 int addr;
ligeiro13 0:ebea19a646c3 1545
ligeiro13 0:ebea19a646c3 1546 if (value == '\n') {
ligeiro13 0:ebea19a646c3 1547 //No character to write
ligeiro13 0:ebea19a646c3 1548
ligeiro13 0:ebea19a646c3 1549 //Update Cursor
ligeiro13 0:ebea19a646c3 1550 _column = 0;
ligeiro13 0:ebea19a646c3 1551 _row++;
ligeiro13 0:ebea19a646c3 1552 if (_row >= rows()) {
ligeiro13 0:ebea19a646c3 1553 _row = 0;
ligeiro13 0:ebea19a646c3 1554 }
ligeiro13 0:ebea19a646c3 1555 }
ligeiro13 0:ebea19a646c3 1556 else {
ligeiro13 0:ebea19a646c3 1557 //Character to write
ligeiro13 0:ebea19a646c3 1558
ligeiro13 0:ebea19a646c3 1559 #if (LCD_DEF_FONT == 1) //Default HD44780 font
ligeiro13 0:ebea19a646c3 1560 _writeData(value);
ligeiro13 0:ebea19a646c3 1561 #elif (LCD_C_FONT == 1) || (LCD_R_FONT == 1) //PCF21xxC or PCF21xxR font
ligeiro13 0:ebea19a646c3 1562 _writeData(ASCII_2_LCD(value));
ligeiro13 0:ebea19a646c3 1563 #elif (LCD_UTF8_FONT == 1) // UTF8 2 byte font (eg Cyrillic)
ligeiro13 0:ebea19a646c3 1564 // value = UTF_2_LCD(value, utf_seq_rec_first_cyr, utf_seq_recode_cyr, &utf_rnd_recode_cyr[0][0]);
ligeiro13 0:ebea19a646c3 1565 value = UTF_2_LCD(value);
ligeiro13 0:ebea19a646c3 1566 if (value >= 0) {
ligeiro13 0:ebea19a646c3 1567 _writeData(value);
ligeiro13 0:ebea19a646c3 1568
ligeiro13 0:ebea19a646c3 1569 // Only increment cursor when there is something to write
ligeiro13 0:ebea19a646c3 1570 // Continue below to closing bracket...
ligeiro13 0:ebea19a646c3 1571 #else
ligeiro13 0:ebea19a646c3 1572 _writeData('?'); //Oops, no font defined
ligeiro13 0:ebea19a646c3 1573 #endif
ligeiro13 0:ebea19a646c3 1574
ligeiro13 0:ebea19a646c3 1575 //Update Cursor
ligeiro13 0:ebea19a646c3 1576 _column++;
ligeiro13 0:ebea19a646c3 1577 if (_column >= columns()) {
ligeiro13 0:ebea19a646c3 1578 _column = 0;
ligeiro13 0:ebea19a646c3 1579 _row++;
ligeiro13 0:ebea19a646c3 1580 if (_row >= rows()) {
ligeiro13 0:ebea19a646c3 1581 _row = 0;
ligeiro13 0:ebea19a646c3 1582 }
ligeiro13 0:ebea19a646c3 1583 }
ligeiro13 0:ebea19a646c3 1584
ligeiro13 0:ebea19a646c3 1585 #if (LCD_DEF_FONT == 1) //Default HD44780 font
ligeiro13 0:ebea19a646c3 1586
ligeiro13 0:ebea19a646c3 1587 #elif (LCD_C_FONT == 1) || (LCD_R_FONT == 1) //PCF21xxC or PCF21xxR font
ligeiro13 0:ebea19a646c3 1588
ligeiro13 0:ebea19a646c3 1589 #elif (LCD_UTF8_FONT == 1) //UTF8 2 byte font (eg Cyrillic)
ligeiro13 0:ebea19a646c3 1590 // Continue code above to close bracket...
ligeiro13 0:ebea19a646c3 1591 } // if (value >= 0) {..
ligeiro13 0:ebea19a646c3 1592 #else
ligeiro13 0:ebea19a646c3 1593
ligeiro13 0:ebea19a646c3 1594 #endif
ligeiro13 0:ebea19a646c3 1595
ligeiro13 0:ebea19a646c3 1596 } //else
ligeiro13 0:ebea19a646c3 1597
ligeiro13 0:ebea19a646c3 1598 //Set next memoryaddress, make sure cursor blinks at next location
ligeiro13 0:ebea19a646c3 1599 addr = getAddress(_column, _row);
ligeiro13 0:ebea19a646c3 1600 _writeCommand(0x80 | addr);
ligeiro13 0:ebea19a646c3 1601
ligeiro13 0:ebea19a646c3 1602 return value;
ligeiro13 0:ebea19a646c3 1603 }
ligeiro13 0:ebea19a646c3 1604
ligeiro13 0:ebea19a646c3 1605
ligeiro13 0:ebea19a646c3 1606 // get a single character (Stream implementation)
ligeiro13 0:ebea19a646c3 1607 int TextLCD_Base::_getc() {
ligeiro13 0:ebea19a646c3 1608 return -1;
ligeiro13 0:ebea19a646c3 1609 }
ligeiro13 0:ebea19a646c3 1610
ligeiro13 0:ebea19a646c3 1611
ligeiro13 0:ebea19a646c3 1612 #if ((LCD_C_FONT == 1) || (LCD_R_FONT == 1)) //PCF21xxC or PCF21xxR font
ligeiro13 0:ebea19a646c3 1613 /** Convert ASCII character code to the LCD fonttable code
ligeiro13 0:ebea19a646c3 1614 *
ligeiro13 0:ebea19a646c3 1615 * @param c The character to write to the display
ligeiro13 0:ebea19a646c3 1616 * @return The character code for the specific fonttable of the controller
ligeiro13 0:ebea19a646c3 1617 */
ligeiro13 0:ebea19a646c3 1618 int TextLCD_Base::ASCII_2_LCD (int c) {
ligeiro13 0:ebea19a646c3 1619
ligeiro13 0:ebea19a646c3 1620 //LCD_C_F0 is default for HD44780 and compatible series
ligeiro13 0:ebea19a646c3 1621 // if (_font == LCD_C_F0) return c;
ligeiro13 0:ebea19a646c3 1622
ligeiro13 0:ebea19a646c3 1623 //LCD_C_FC for PCF21XXC series
ligeiro13 0:ebea19a646c3 1624 //LCD_C_FR for PCF21XXR series
ligeiro13 0:ebea19a646c3 1625 //Used code from Suga koubou library for PCF2119K and PCF2119R
ligeiro13 0:ebea19a646c3 1626 if (((c >= ' ') && (c <= '?')) || ((c >= 'A') && (c <= 'Z')) || ((c >= 'a') && (c <= 'z'))) {
ligeiro13 0:ebea19a646c3 1627 c |= 0x80;
ligeiro13 0:ebea19a646c3 1628 } else if (c >= 0xF0 && c <= 0xFF) {
ligeiro13 0:ebea19a646c3 1629 c &= 0x0F;
ligeiro13 0:ebea19a646c3 1630 }
ligeiro13 0:ebea19a646c3 1631 return c;
ligeiro13 0:ebea19a646c3 1632 }
ligeiro13 0:ebea19a646c3 1633 #endif
ligeiro13 0:ebea19a646c3 1634
ligeiro13 0:ebea19a646c3 1635 #if(LCD_UTF8_FONT == 1)
ligeiro13 0:ebea19a646c3 1636
ligeiro13 0:ebea19a646c3 1637 /** Convert UTF8 2-byte character code to the LCD fonttable code
ligeiro13 0:ebea19a646c3 1638 * @param c The character to write to the display
ligeiro13 0:ebea19a646c3 1639 * @return character code for the specific fonttable of the controller or -1 if UTF8 code is not yet complete or incorrect
ligeiro13 0:ebea19a646c3 1640 *
ligeiro13 0:ebea19a646c3 1641 * Orig by Andriy, Modified by WH
ligeiro13 0:ebea19a646c3 1642 *
ligeiro13 0:ebea19a646c3 1643 * Note: The UTF8 decoding table for a specific controller is defined and selected in file TextLCD_UTF8.inc
ligeiro13 0:ebea19a646c3 1644 * The table is accessed in this UTF_2_LCD() method through
ligeiro13 0:ebea19a646c3 1645 * #define UTF_FIRST, UTF_LAST, UTF_SEQ_REC_FIRST, UTF_SEQ_REC_LAST and
ligeiro13 0:ebea19a646c3 1646 * #define UTF_SEQ_RECODE and UTF_RND_RECODE
ligeiro13 0:ebea19a646c3 1647 */
ligeiro13 0:ebea19a646c3 1648 int TextLCD_Base::UTF_2_LCD (int c) {
ligeiro13 0:ebea19a646c3 1649 int utf_code;
ligeiro13 0:ebea19a646c3 1650 int utf_low_byte; // Low byte UTF8
ligeiro13 0:ebea19a646c3 1651 static int utf_hi_byte = 0; // High byte UTF8
ligeiro13 0:ebea19a646c3 1652
ligeiro13 0:ebea19a646c3 1653 if (c < 0x80) { // Regular ASCII code, no need to convert
ligeiro13 0:ebea19a646c3 1654 return c;
ligeiro13 0:ebea19a646c3 1655 }
ligeiro13 0:ebea19a646c3 1656 else { // UTF8 handling, See wikipedia.org/wiki/UTF-8 and www.utf8-chartable.de
ligeiro13 0:ebea19a646c3 1657 // printf("0x%X ", c);
ligeiro13 0:ebea19a646c3 1658
ligeiro13 0:ebea19a646c3 1659 if (c >= 0xC0) { // First UTF8 byte should be formatted as 110b bbaa, Do sanity check
ligeiro13 0:ebea19a646c3 1660 utf_hi_byte = c & 0x1F; // Mask out significant bits (0x1F) and save high byte
ligeiro13 0:ebea19a646c3 1661 return -1; // Nothing to display as yet, wait for second UTF8 byte
ligeiro13 0:ebea19a646c3 1662 }
ligeiro13 0:ebea19a646c3 1663
ligeiro13 0:ebea19a646c3 1664 if (c <= 0xBF) { // Second UTF8 byte should be formatted as 10aa aaaa, Do sanity check
ligeiro13 0:ebea19a646c3 1665 utf_low_byte = c & 0x3F; // Mask out significant bits (0x3F)
ligeiro13 0:ebea19a646c3 1666
ligeiro13 0:ebea19a646c3 1667 // Compose UTF character code from UTF8 bytes. The UTF codes will be between U+0080 and U+07FF
ligeiro13 0:ebea19a646c3 1668 utf_code = (utf_hi_byte << 6) | utf_low_byte; // 00000bbb aaaaaaaa
ligeiro13 0:ebea19a646c3 1669 // printf("0x%4X ", utf_code);
ligeiro13 0:ebea19a646c3 1670
ligeiro13 0:ebea19a646c3 1671 // Sanity check on UTF codes
ligeiro13 0:ebea19a646c3 1672 // For example Cyrillic characters are UTF encoded between 0x0400 and 0x04FF
ligeiro13 0:ebea19a646c3 1673 if ((utf_code < UTF_FIRST) || (utf_code > UTF_LAST)) {
ligeiro13 0:ebea19a646c3 1674 return -1; // Invalid UTF8 code
ligeiro13 0:ebea19a646c3 1675 };
ligeiro13 0:ebea19a646c3 1676
ligeiro13 0:ebea19a646c3 1677 //Map some specific UTF codes on a character in LCD fonttable using a special correcting lookup table
ligeiro13 0:ebea19a646c3 1678 for (char i=0; UTF_RND_RECODE[i][0]; i++) { // Step through table until endvalue 0 is found or until a match is found
ligeiro13 0:ebea19a646c3 1679 if (utf_code == UTF_RND_RECODE[i][0]) { // UTF8 code match is found
ligeiro13 0:ebea19a646c3 1680 c = UTF_RND_RECODE[1][1];
ligeiro13 0:ebea19a646c3 1681 return c; // found match in correcting random table
ligeiro13 0:ebea19a646c3 1682 }
ligeiro13 0:ebea19a646c3 1683 }
ligeiro13 0:ebea19a646c3 1684
ligeiro13 0:ebea19a646c3 1685 //Sanity check on table idx range
ligeiro13 0:ebea19a646c3 1686 if ((utf_code < UTF_SEQ_REC_FIRST) || (utf_code > UTF_SEQ_REC_LAST)) {
ligeiro13 0:ebea19a646c3 1687 return -1; // Invalid UTF8 code
ligeiro13 0:ebea19a646c3 1688 };
ligeiro13 0:ebea19a646c3 1689
ligeiro13 0:ebea19a646c3 1690 //Map all other UTF codes on a character in LCD fonttable using a sequential lookup table
ligeiro13 0:ebea19a646c3 1691 c = UTF_SEQ_RECODE[utf_code - UTF_SEQ_REC_FIRST];
ligeiro13 0:ebea19a646c3 1692 return c; // entry in sequential table
ligeiro13 0:ebea19a646c3 1693 }
ligeiro13 0:ebea19a646c3 1694 else {
ligeiro13 0:ebea19a646c3 1695 return -1; // Invalid UTF8 code for second byte
ligeiro13 0:ebea19a646c3 1696 }
ligeiro13 0:ebea19a646c3 1697 } // End UTF8 handling
ligeiro13 0:ebea19a646c3 1698 }
ligeiro13 0:ebea19a646c3 1699
ligeiro13 0:ebea19a646c3 1700 #endif
ligeiro13 0:ebea19a646c3 1701
ligeiro13 0:ebea19a646c3 1702
ligeiro13 0:ebea19a646c3 1703 #if(LCD_PRINTF != 1)
ligeiro13 0:ebea19a646c3 1704 /** Write a character to the LCD
ligeiro13 0:ebea19a646c3 1705 *
ligeiro13 0:ebea19a646c3 1706 * @param c The character to write to the display
ligeiro13 0:ebea19a646c3 1707 */
ligeiro13 0:ebea19a646c3 1708 int TextLCD_Base::putc(int c){
ligeiro13 0:ebea19a646c3 1709 return _putc(c);
ligeiro13 0:ebea19a646c3 1710 }
ligeiro13 0:ebea19a646c3 1711
ligeiro13 0:ebea19a646c3 1712
ligeiro13 0:ebea19a646c3 1713 /** Write a raw string to the LCD
ligeiro13 0:ebea19a646c3 1714 *
ligeiro13 0:ebea19a646c3 1715 * @param string text, may be followed by variables to emulate formatting the string.
ligeiro13 0:ebea19a646c3 1716 * However, printf formatting is NOT supported and variables will be ignored!
ligeiro13 0:ebea19a646c3 1717 */
ligeiro13 0:ebea19a646c3 1718 int TextLCD_Base::printf(const char* text, ...) {
ligeiro13 0:ebea19a646c3 1719
ligeiro13 0:ebea19a646c3 1720 while (*text !=0) {
ligeiro13 0:ebea19a646c3 1721 _putc(*text);
ligeiro13 0:ebea19a646c3 1722 text++;
ligeiro13 0:ebea19a646c3 1723 }
ligeiro13 0:ebea19a646c3 1724 return 0;
ligeiro13 0:ebea19a646c3 1725 }
ligeiro13 0:ebea19a646c3 1726 #endif
ligeiro13 0:ebea19a646c3 1727
ligeiro13 0:ebea19a646c3 1728
ligeiro13 0:ebea19a646c3 1729 // Write a nibble using the 4-bit interface
ligeiro13 0:ebea19a646c3 1730 void TextLCD_Base::_writeNibble(int value) {
ligeiro13 0:ebea19a646c3 1731
ligeiro13 0:ebea19a646c3 1732 // Enable is Low
ligeiro13 0:ebea19a646c3 1733 this->_setEnable(true);
ligeiro13 0:ebea19a646c3 1734 this->_setData(value); // Low nibble of value on D4..D7
ligeiro13 0:ebea19a646c3 1735 wait_us(1); // Data setup time
ligeiro13 0:ebea19a646c3 1736 this->_setEnable(false);
ligeiro13 0:ebea19a646c3 1737 wait_us(1); // Datahold time
ligeiro13 0:ebea19a646c3 1738 // Enable is Low
ligeiro13 0:ebea19a646c3 1739 }
ligeiro13 0:ebea19a646c3 1740
ligeiro13 0:ebea19a646c3 1741 // Write a byte using the 4-bit interface
ligeiro13 0:ebea19a646c3 1742 void TextLCD_Base::_writeByte(int value) {
ligeiro13 0:ebea19a646c3 1743
ligeiro13 0:ebea19a646c3 1744 // Enable is Low
ligeiro13 0:ebea19a646c3 1745 this->_setEnable(true);
ligeiro13 0:ebea19a646c3 1746 this->_setData(value >> 4); // High nibble
ligeiro13 0:ebea19a646c3 1747 wait_us(1); // Data setup time
ligeiro13 0:ebea19a646c3 1748 this->_setEnable(false);
ligeiro13 0:ebea19a646c3 1749 wait_us(1); // Data hold time
ligeiro13 0:ebea19a646c3 1750
ligeiro13 0:ebea19a646c3 1751 this->_setEnable(true);
ligeiro13 0:ebea19a646c3 1752 this->_setData(value); // Low nibble
ligeiro13 0:ebea19a646c3 1753 wait_us(1); // Data setup time
ligeiro13 0:ebea19a646c3 1754 this->_setEnable(false);
ligeiro13 0:ebea19a646c3 1755 wait_us(1); // Datahold time
ligeiro13 0:ebea19a646c3 1756
ligeiro13 0:ebea19a646c3 1757 // Enable is Low
ligeiro13 0:ebea19a646c3 1758 }
ligeiro13 0:ebea19a646c3 1759
ligeiro13 0:ebea19a646c3 1760 // Write a command byte to the LCD controller
ligeiro13 0:ebea19a646c3 1761 void TextLCD_Base::_writeCommand(int command) {
ligeiro13 0:ebea19a646c3 1762
ligeiro13 0:ebea19a646c3 1763 this->_setRS(false);
ligeiro13 0:ebea19a646c3 1764 wait_us(1); // Data setup time for RS
ligeiro13 0:ebea19a646c3 1765
ligeiro13 0:ebea19a646c3 1766 this->_writeByte(command);
ligeiro13 0:ebea19a646c3 1767 wait_us(40); // most instructions take 40us
ligeiro13 0:ebea19a646c3 1768 }
ligeiro13 0:ebea19a646c3 1769
ligeiro13 0:ebea19a646c3 1770 // Write a data byte to the LCD controller
ligeiro13 0:ebea19a646c3 1771 void TextLCD_Base::_writeData(int data) {
ligeiro13 0:ebea19a646c3 1772
ligeiro13 0:ebea19a646c3 1773 this->_setRS(true);
ligeiro13 0:ebea19a646c3 1774 wait_us(1); // Data setup time for RS
ligeiro13 0:ebea19a646c3 1775
ligeiro13 0:ebea19a646c3 1776 this->_writeByte(data);
ligeiro13 0:ebea19a646c3 1777 wait_us(40); // data writes take 40us
ligeiro13 0:ebea19a646c3 1778 }
ligeiro13 0:ebea19a646c3 1779
ligeiro13 0:ebea19a646c3 1780
ligeiro13 0:ebea19a646c3 1781 // This replaces the original _address() method.
ligeiro13 0:ebea19a646c3 1782 // It is confusing since it returns the memoryaddress or-ed with the set memorycommand 0x80.
ligeiro13 0:ebea19a646c3 1783 // Left it in here for compatibility with older code. New applications should use getAddress() instead.
ligeiro13 0:ebea19a646c3 1784 int TextLCD_Base::_address(int column, int row) {
ligeiro13 0:ebea19a646c3 1785 return 0x80 | getAddress(column, row);
ligeiro13 0:ebea19a646c3 1786 }
ligeiro13 0:ebea19a646c3 1787
ligeiro13 0:ebea19a646c3 1788
ligeiro13 0:ebea19a646c3 1789 // This is new method to return the memory address based on row, column and displaytype.
ligeiro13 0:ebea19a646c3 1790 //
ligeiro13 0:ebea19a646c3 1791 /** Return the memoryaddress of screen column and row location
ligeiro13 0:ebea19a646c3 1792 *
ligeiro13 0:ebea19a646c3 1793 * @param column The horizontal position from the left, indexed from 0
ligeiro13 0:ebea19a646c3 1794 * @param row The vertical position from the top, indexed from 0
ligeiro13 0:ebea19a646c3 1795 * @return The memoryaddress of screen column and row location
ligeiro13 0:ebea19a646c3 1796 *
ligeiro13 0:ebea19a646c3 1797 */
ligeiro13 0:ebea19a646c3 1798 int TextLCD_Base::getAddress(int column, int row) {
ligeiro13 0:ebea19a646c3 1799
ligeiro13 0:ebea19a646c3 1800 switch (_addr_mode) {
ligeiro13 0:ebea19a646c3 1801
ligeiro13 0:ebea19a646c3 1802 case LCD_T_A:
ligeiro13 0:ebea19a646c3 1803 //Default addressing mode for 1, 2 and 4 rows (except 40x4)
ligeiro13 0:ebea19a646c3 1804 //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.
ligeiro13 0:ebea19a646c3 1805 //Displays top rows when less than four are used.
ligeiro13 0:ebea19a646c3 1806 switch (row) {
ligeiro13 0:ebea19a646c3 1807 case 0:
ligeiro13 0:ebea19a646c3 1808 return 0x00 + column;
ligeiro13 0:ebea19a646c3 1809 case 1:
ligeiro13 0:ebea19a646c3 1810 return 0x40 + column;
ligeiro13 0:ebea19a646c3 1811 case 2:
ligeiro13 0:ebea19a646c3 1812 return 0x00 + _nr_cols + column;
ligeiro13 0:ebea19a646c3 1813 case 3:
ligeiro13 0:ebea19a646c3 1814 return 0x40 + _nr_cols + column;
ligeiro13 0:ebea19a646c3 1815 // Should never get here.
ligeiro13 0:ebea19a646c3 1816 // default:
ligeiro13 0:ebea19a646c3 1817 // return 0x00;
ligeiro13 0:ebea19a646c3 1818 }
ligeiro13 0:ebea19a646c3 1819
ligeiro13 0:ebea19a646c3 1820 case LCD_T_B:
ligeiro13 0:ebea19a646c3 1821 // LCD8x2B is a special layout of LCD16x1
ligeiro13 0:ebea19a646c3 1822 if (row==0)
ligeiro13 0:ebea19a646c3 1823 return 0x00 + column;
ligeiro13 0:ebea19a646c3 1824 else
ligeiro13 0:ebea19a646c3 1825 // return _nr_cols + column;
ligeiro13 0:ebea19a646c3 1826 return 0x08 + column;
ligeiro13 0:ebea19a646c3 1827
ligeiro13 0:ebea19a646c3 1828 case LCD_T_C:
ligeiro13 0:ebea19a646c3 1829 // LCD16x1C is a special layout of LCD8x2
ligeiro13 0:ebea19a646c3 1830 // LCD32x1C is a special layout of LCD16x2
ligeiro13 0:ebea19a646c3 1831 // LCD40x1C is a special layout of LCD20x2
ligeiro13 0:ebea19a646c3 1832 #if(0)
ligeiro13 0:ebea19a646c3 1833 if (column < 8)
ligeiro13 0:ebea19a646c3 1834 return 0x00 + column;
ligeiro13 0:ebea19a646c3 1835 else
ligeiro13 0:ebea19a646c3 1836 return 0x40 + (column - 8);
ligeiro13 0:ebea19a646c3 1837 #else
ligeiro13 0:ebea19a646c3 1838 if (column < (_nr_cols >> 1))
ligeiro13 0:ebea19a646c3 1839 return 0x00 + column;
ligeiro13 0:ebea19a646c3 1840 else
ligeiro13 0:ebea19a646c3 1841 return 0x40 + (column - (_nr_cols >> 1));
ligeiro13 0:ebea19a646c3 1842 #endif
ligeiro13 0:ebea19a646c3 1843
ligeiro13 0:ebea19a646c3 1844 case LCD_T_D:
ligeiro13 0:ebea19a646c3 1845 //Alternate addressing mode for 3 and 4 row displays (except 40x4). Used by PCF21XX, KS0073, KS0078, SSD1803
ligeiro13 0:ebea19a646c3 1846 //The 4 available rows start at a hardcoded address.
ligeiro13 0:ebea19a646c3 1847 //Displays top rows when less than four are used.
ligeiro13 0:ebea19a646c3 1848 switch (row) {
ligeiro13 0:ebea19a646c3 1849 case 0:
ligeiro13 0:ebea19a646c3 1850 return 0x00 + column;
ligeiro13 0:ebea19a646c3 1851 case 1:
ligeiro13 0:ebea19a646c3 1852 return 0x20 + column;
ligeiro13 0:ebea19a646c3 1853 case 2:
ligeiro13 0:ebea19a646c3 1854 return 0x40 + column;
ligeiro13 0:ebea19a646c3 1855 case 3:
ligeiro13 0:ebea19a646c3 1856 return 0x60 + column;
ligeiro13 0:ebea19a646c3 1857 // Should never get here.
ligeiro13 0:ebea19a646c3 1858 // default:
ligeiro13 0:ebea19a646c3 1859 // return 0x00;
ligeiro13 0:ebea19a646c3 1860 }
ligeiro13 0:ebea19a646c3 1861
ligeiro13 0:ebea19a646c3 1862 case LCD_T_D1:
ligeiro13 0:ebea19a646c3 1863 //Alternate addressing mode for 3 row displays. Used by PCF21XX, KS0073, KS0078, SSD1803
ligeiro13 0:ebea19a646c3 1864 //The 4 available rows start at a hardcoded address.
ligeiro13 0:ebea19a646c3 1865 //Skips top row of 4 row display and starts display at row 1
ligeiro13 0:ebea19a646c3 1866 switch (row) {
ligeiro13 0:ebea19a646c3 1867 case 0:
ligeiro13 0:ebea19a646c3 1868 return 0x20 + column;
ligeiro13 0:ebea19a646c3 1869 case 1:
ligeiro13 0:ebea19a646c3 1870 return 0x40 + column;
ligeiro13 0:ebea19a646c3 1871 case 2:
ligeiro13 0:ebea19a646c3 1872 return 0x60 + column;
ligeiro13 0:ebea19a646c3 1873 // Should never get here.
ligeiro13 0:ebea19a646c3 1874 // default:
ligeiro13 0:ebea19a646c3 1875 // return 0x00;
ligeiro13 0:ebea19a646c3 1876 }
ligeiro13 0:ebea19a646c3 1877
ligeiro13 0:ebea19a646c3 1878 case LCD_T_E:
ligeiro13 0:ebea19a646c3 1879 // LCD40x4 is a special case since it has 2 controllers.
ligeiro13 0:ebea19a646c3 1880 // Each controller is configured as 40x2 (Type A)
ligeiro13 0:ebea19a646c3 1881 if (row<2) {
ligeiro13 0:ebea19a646c3 1882 // Test to see if we need to switch between controllers
ligeiro13 0:ebea19a646c3 1883 if (_ctrl_idx != _LCDCtrl_0) {
ligeiro13 0:ebea19a646c3 1884
ligeiro13 0:ebea19a646c3 1885 // Second LCD controller Cursor Off
ligeiro13 0:ebea19a646c3 1886 _setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
ligeiro13 0:ebea19a646c3 1887
ligeiro13 0:ebea19a646c3 1888 // Select primary controller
ligeiro13 0:ebea19a646c3 1889 _ctrl_idx = _LCDCtrl_0;
ligeiro13 0:ebea19a646c3 1890
ligeiro13 0:ebea19a646c3 1891 // Restore cursormode on primary LCD controller
ligeiro13 0:ebea19a646c3 1892 _setCursorAndDisplayMode(_currentMode, _currentCursor);
ligeiro13 0:ebea19a646c3 1893 }
ligeiro13 0:ebea19a646c3 1894
ligeiro13 0:ebea19a646c3 1895 return 0x00 + (row * 0x40) + column;
ligeiro13 0:ebea19a646c3 1896 }
ligeiro13 0:ebea19a646c3 1897 else {
ligeiro13 0:ebea19a646c3 1898
ligeiro13 0:ebea19a646c3 1899 // Test to see if we need to switch between controllers
ligeiro13 0:ebea19a646c3 1900 if (_ctrl_idx != _LCDCtrl_1) {
ligeiro13 0:ebea19a646c3 1901 // Primary LCD controller Cursor Off
ligeiro13 0:ebea19a646c3 1902 _setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
ligeiro13 0:ebea19a646c3 1903
ligeiro13 0:ebea19a646c3 1904 // Select secondary controller
ligeiro13 0:ebea19a646c3 1905 _ctrl_idx = _LCDCtrl_1;
ligeiro13 0:ebea19a646c3 1906
ligeiro13 0:ebea19a646c3 1907 // Restore cursormode on secondary LCD controller
ligeiro13 0:ebea19a646c3 1908 _setCursorAndDisplayMode(_currentMode, _currentCursor);
ligeiro13 0:ebea19a646c3 1909 }
ligeiro13 0:ebea19a646c3 1910
ligeiro13 0:ebea19a646c3 1911 return 0x00 + ((row-2) * 0x40) + column;
ligeiro13 0:ebea19a646c3 1912 }
ligeiro13 0:ebea19a646c3 1913
ligeiro13 0:ebea19a646c3 1914 case LCD_T_F:
ligeiro13 0:ebea19a646c3 1915 //Alternate addressing mode for 3 row displays.
ligeiro13 0:ebea19a646c3 1916 //The first half of 3rd row continues from 1st row, the second half continues from 2nd row.
ligeiro13 0:ebea19a646c3 1917 switch (row) {
ligeiro13 0:ebea19a646c3 1918 case 0:
ligeiro13 0:ebea19a646c3 1919 return 0x00 + column;
ligeiro13 0:ebea19a646c3 1920 case 1:
ligeiro13 0:ebea19a646c3 1921 return 0x40 + column;
ligeiro13 0:ebea19a646c3 1922 case 2:
ligeiro13 0:ebea19a646c3 1923 if (column < (_nr_cols >> 1)) // check first or second half of line
ligeiro13 0:ebea19a646c3 1924 return (0x00 + _nr_cols + column);
ligeiro13 0:ebea19a646c3 1925 else
ligeiro13 0:ebea19a646c3 1926 return (0x40 + _nr_cols + (column - (_nr_cols >> 1)));
ligeiro13 0:ebea19a646c3 1927 // Should never get here.
ligeiro13 0:ebea19a646c3 1928 // default:
ligeiro13 0:ebea19a646c3 1929 // return 0x00;
ligeiro13 0:ebea19a646c3 1930 }
ligeiro13 0:ebea19a646c3 1931
ligeiro13 0:ebea19a646c3 1932 case LCD_T_G:
ligeiro13 0:ebea19a646c3 1933 //Alternate addressing mode for 3 row displays. Used by ST7036
ligeiro13 0:ebea19a646c3 1934 switch (row) {
ligeiro13 0:ebea19a646c3 1935 case 0:
ligeiro13 0:ebea19a646c3 1936 return 0x00 + column;
ligeiro13 0:ebea19a646c3 1937 case 1:
ligeiro13 0:ebea19a646c3 1938 return 0x10 + column;
ligeiro13 0:ebea19a646c3 1939 case 2:
ligeiro13 0:ebea19a646c3 1940 return 0x20 + column;
ligeiro13 0:ebea19a646c3 1941 // Should never get here.
ligeiro13 0:ebea19a646c3 1942 // default:
ligeiro13 0:ebea19a646c3 1943 // return 0x00;
ligeiro13 0:ebea19a646c3 1944 }
ligeiro13 0:ebea19a646c3 1945
ligeiro13 0:ebea19a646c3 1946 // Should never get here.
ligeiro13 0:ebea19a646c3 1947 default:
ligeiro13 0:ebea19a646c3 1948 return 0x00;
ligeiro13 0:ebea19a646c3 1949
ligeiro13 0:ebea19a646c3 1950 } // switch _addr_mode
ligeiro13 0:ebea19a646c3 1951 }
ligeiro13 0:ebea19a646c3 1952
ligeiro13 0:ebea19a646c3 1953
ligeiro13 0:ebea19a646c3 1954 /** Set the memoryaddress of screen column and row location
ligeiro13 0:ebea19a646c3 1955 *
ligeiro13 0:ebea19a646c3 1956 * @param column The horizontal position from the left, indexed from 0
ligeiro13 0:ebea19a646c3 1957 * @param row The vertical position from the top, indexed from 0
ligeiro13 0:ebea19a646c3 1958 */
ligeiro13 0:ebea19a646c3 1959 void TextLCD_Base::setAddress(int column, int row) {
ligeiro13 0:ebea19a646c3 1960
ligeiro13 0:ebea19a646c3 1961 // Sanity Check column
ligeiro13 0:ebea19a646c3 1962 if (column < 0) {
ligeiro13 0:ebea19a646c3 1963 _column = 0;
ligeiro13 0:ebea19a646c3 1964 }
ligeiro13 0:ebea19a646c3 1965 else if (column >= _nr_cols) {
ligeiro13 0:ebea19a646c3 1966 _column = _nr_cols - 1;
ligeiro13 0:ebea19a646c3 1967 } else _column = column;
ligeiro13 0:ebea19a646c3 1968
ligeiro13 0:ebea19a646c3 1969 // Sanity Check row
ligeiro13 0:ebea19a646c3 1970 if (row < 0) {
ligeiro13 0:ebea19a646c3 1971 _row = 0;
ligeiro13 0:ebea19a646c3 1972 }
ligeiro13 0:ebea19a646c3 1973 else if (row >= _nr_rows) {
ligeiro13 0:ebea19a646c3 1974 _row = _nr_rows - 1;
ligeiro13 0:ebea19a646c3 1975 } else _row = row;
ligeiro13 0:ebea19a646c3 1976
ligeiro13 0:ebea19a646c3 1977
ligeiro13 0:ebea19a646c3 1978 // Compute the memory address
ligeiro13 0:ebea19a646c3 1979 // For LCD40x4: switch controllers if needed
ligeiro13 0:ebea19a646c3 1980 // switch cursor if needed
ligeiro13 0:ebea19a646c3 1981 int addr = getAddress(_column, _row);
ligeiro13 0:ebea19a646c3 1982
ligeiro13 0:ebea19a646c3 1983 _writeCommand(0x80 | addr);
ligeiro13 0:ebea19a646c3 1984 }
ligeiro13 0:ebea19a646c3 1985
ligeiro13 0:ebea19a646c3 1986
ligeiro13 0:ebea19a646c3 1987 /** Return the number of columns
ligeiro13 0:ebea19a646c3 1988 *
ligeiro13 0:ebea19a646c3 1989 * @return The number of columns
ligeiro13 0:ebea19a646c3 1990 *
ligeiro13 0:ebea19a646c3 1991 * Note: some configurations are commented out because they have not yet been tested due to lack of hardware
ligeiro13 0:ebea19a646c3 1992 */
ligeiro13 0:ebea19a646c3 1993 int TextLCD_Base::columns() {
ligeiro13 0:ebea19a646c3 1994
ligeiro13 0:ebea19a646c3 1995 // Columns encoded in b7..b0
ligeiro13 0:ebea19a646c3 1996 //return (_type & 0xFF);
ligeiro13 0:ebea19a646c3 1997 return _nr_cols;
ligeiro13 0:ebea19a646c3 1998 }
ligeiro13 0:ebea19a646c3 1999
ligeiro13 0:ebea19a646c3 2000 /** Return the number of rows
ligeiro13 0:ebea19a646c3 2001 *
ligeiro13 0:ebea19a646c3 2002 * @return The number of rows
ligeiro13 0:ebea19a646c3 2003 *
ligeiro13 0:ebea19a646c3 2004 * Note: some configurations are commented out because they have not yet been tested due to lack of hardware
ligeiro13 0:ebea19a646c3 2005 */
ligeiro13 0:ebea19a646c3 2006 int TextLCD_Base::rows() {
ligeiro13 0:ebea19a646c3 2007
ligeiro13 0:ebea19a646c3 2008 // Rows encoded in b15..b8
ligeiro13 0:ebea19a646c3 2009 //return ((_type >> 8) & 0xFF);
ligeiro13 0:ebea19a646c3 2010 return _nr_rows;
ligeiro13 0:ebea19a646c3 2011 }
ligeiro13 0:ebea19a646c3 2012
ligeiro13 0:ebea19a646c3 2013 /** Set the Cursormode
ligeiro13 0:ebea19a646c3 2014 *
ligeiro13 0:ebea19a646c3 2015 * @param cursorMode The Cursor mode (CurOff_BlkOff, CurOn_BlkOff, CurOff_BlkOn, CurOn_BlkOn)
ligeiro13 0:ebea19a646c3 2016 */
ligeiro13 0:ebea19a646c3 2017 void TextLCD_Base::setCursor(LCDCursor cursorMode) {
ligeiro13 0:ebea19a646c3 2018
ligeiro13 0:ebea19a646c3 2019 // Save new cursor mode, needed when 2 controllers are in use or when display is switched off/on
ligeiro13 0:ebea19a646c3 2020 _currentCursor = cursorMode;
ligeiro13 0:ebea19a646c3 2021
ligeiro13 0:ebea19a646c3 2022 // Configure only current LCD controller
ligeiro13 0:ebea19a646c3 2023 _setCursorAndDisplayMode(_currentMode, _currentCursor);
ligeiro13 0:ebea19a646c3 2024 }
ligeiro13 0:ebea19a646c3 2025
ligeiro13 0:ebea19a646c3 2026 /** Set the Displaymode
ligeiro13 0:ebea19a646c3 2027 *
ligeiro13 0:ebea19a646c3 2028 * @param displayMode The Display mode (DispOff, DispOn)
ligeiro13 0:ebea19a646c3 2029 */
ligeiro13 0:ebea19a646c3 2030 void TextLCD_Base::setMode(LCDMode displayMode) {
ligeiro13 0:ebea19a646c3 2031
ligeiro13 0:ebea19a646c3 2032 // Save new displayMode, needed when 2 controllers are in use or when cursor is changed
ligeiro13 0:ebea19a646c3 2033 _currentMode = displayMode;
ligeiro13 0:ebea19a646c3 2034
ligeiro13 0:ebea19a646c3 2035 #if (LCD_TWO_CTRL == 1)
ligeiro13 0:ebea19a646c3 2036 // Select and configure second LCD controller when needed
ligeiro13 0:ebea19a646c3 2037 if(_type==LCD40x4) {
ligeiro13 0:ebea19a646c3 2038 if (_ctrl_idx==_LCDCtrl_0) {
ligeiro13 0:ebea19a646c3 2039 // Configure primary LCD controller
ligeiro13 0:ebea19a646c3 2040 _setCursorAndDisplayMode(_currentMode, _currentCursor);
ligeiro13 0:ebea19a646c3 2041
ligeiro13 0:ebea19a646c3 2042 // Select 2nd controller
ligeiro13 0:ebea19a646c3 2043 _ctrl_idx=_LCDCtrl_1;
ligeiro13 0:ebea19a646c3 2044
ligeiro13 0:ebea19a646c3 2045 // Configure secondary LCD controller
ligeiro13 0:ebea19a646c3 2046 _setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
ligeiro13 0:ebea19a646c3 2047
ligeiro13 0:ebea19a646c3 2048 // Restore current controller
ligeiro13 0:ebea19a646c3 2049 _ctrl_idx=_LCDCtrl_0;
ligeiro13 0:ebea19a646c3 2050 }
ligeiro13 0:ebea19a646c3 2051 else {
ligeiro13 0:ebea19a646c3 2052 // Select primary controller
ligeiro13 0:ebea19a646c3 2053 _ctrl_idx=_LCDCtrl_0;
ligeiro13 0:ebea19a646c3 2054
ligeiro13 0:ebea19a646c3 2055 // Configure primary LCD controller
ligeiro13 0:ebea19a646c3 2056 _setCursorAndDisplayMode(_currentMode, CurOff_BlkOff);
ligeiro13 0:ebea19a646c3 2057
ligeiro13 0:ebea19a646c3 2058 // Restore current controller
ligeiro13 0:ebea19a646c3 2059 _ctrl_idx=_LCDCtrl_1;
ligeiro13 0:ebea19a646c3 2060
ligeiro13 0:ebea19a646c3 2061 // Configure secondary LCD controller
ligeiro13 0:ebea19a646c3 2062 _setCursorAndDisplayMode(_currentMode, _currentCursor);
ligeiro13 0:ebea19a646c3 2063 }
ligeiro13 0:ebea19a646c3 2064 }
ligeiro13 0:ebea19a646c3 2065 else {
ligeiro13 0:ebea19a646c3 2066 // Configure primary LCD controller
ligeiro13 0:ebea19a646c3 2067 _setCursorAndDisplayMode(_currentMode, _currentCursor);
ligeiro13 0:ebea19a646c3 2068 }
ligeiro13 0:ebea19a646c3 2069 #else
ligeiro13 0:ebea19a646c3 2070 // Support only one LCD controller
ligeiro13 0:ebea19a646c3 2071 _setCursorAndDisplayMode(_currentMode, _currentCursor);
ligeiro13 0:ebea19a646c3 2072
ligeiro13 0:ebea19a646c3 2073 #endif
ligeiro13 0:ebea19a646c3 2074 }
ligeiro13 0:ebea19a646c3 2075
ligeiro13 0:ebea19a646c3 2076 /** Low level method to restore the cursortype and display mode for current controller
ligeiro13 0:ebea19a646c3 2077 */
ligeiro13 0:ebea19a646c3 2078 void TextLCD_Base::_setCursorAndDisplayMode(LCDMode displayMode, LCDCursor cursorType) {
ligeiro13 0:ebea19a646c3 2079
ligeiro13 0:ebea19a646c3 2080 // Configure current LCD controller
ligeiro13 0:ebea19a646c3 2081 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2082 case ST7070:
ligeiro13 0:ebea19a646c3 2083 //ST7070 does not support Cursorblink. The P bit selects the font instead !
ligeiro13 0:ebea19a646c3 2084 _writeCommand(0x08 | displayMode | (cursorType & 0x02));
ligeiro13 0:ebea19a646c3 2085 break;
ligeiro13 0:ebea19a646c3 2086 default:
ligeiro13 0:ebea19a646c3 2087 _writeCommand(0x08 | displayMode | cursorType);
ligeiro13 0:ebea19a646c3 2088 break;
ligeiro13 0:ebea19a646c3 2089 } //switch
ligeiro13 0:ebea19a646c3 2090 }
ligeiro13 0:ebea19a646c3 2091
ligeiro13 0:ebea19a646c3 2092 /** Set the Backlight mode
ligeiro13 0:ebea19a646c3 2093 *
ligeiro13 0:ebea19a646c3 2094 * @param backlightMode The Backlight mode (LightOff, LightOn)
ligeiro13 0:ebea19a646c3 2095 */
ligeiro13 0:ebea19a646c3 2096 void TextLCD_Base::setBacklight(LCDBacklight backlightMode) {
ligeiro13 0:ebea19a646c3 2097
ligeiro13 0:ebea19a646c3 2098 #if (BACKLIGHT_INV==0)
ligeiro13 0:ebea19a646c3 2099 // Positive Backlight control pin logic
ligeiro13 0:ebea19a646c3 2100 if (backlightMode == LightOn) {
ligeiro13 0:ebea19a646c3 2101 this->_setBL(true);
ligeiro13 0:ebea19a646c3 2102 }
ligeiro13 0:ebea19a646c3 2103 else {
ligeiro13 0:ebea19a646c3 2104 this->_setBL(false);
ligeiro13 0:ebea19a646c3 2105 }
ligeiro13 0:ebea19a646c3 2106 #else
ligeiro13 0:ebea19a646c3 2107 // Inverted Backlight control pin logic
ligeiro13 0:ebea19a646c3 2108 if (backlightMode == LightOn) {
ligeiro13 0:ebea19a646c3 2109 this->_setBL(false);
ligeiro13 0:ebea19a646c3 2110 }
ligeiro13 0:ebea19a646c3 2111 else {
ligeiro13 0:ebea19a646c3 2112 this->_setBL(true);
ligeiro13 0:ebea19a646c3 2113 }
ligeiro13 0:ebea19a646c3 2114 #endif
ligeiro13 0:ebea19a646c3 2115 }
ligeiro13 0:ebea19a646c3 2116
ligeiro13 0:ebea19a646c3 2117 /** Set User Defined Characters
ligeiro13 0:ebea19a646c3 2118 *
ligeiro13 0:ebea19a646c3 2119 * @param unsigned char c The Index of the UDC (0..7) for HD44780 or clones and (0..15) for some more advanced controllers
ligeiro13 0:ebea19a646c3 2120 * @param char *udc_data The bitpatterns for the UDC (8 bytes of 5 significant bits for bitpattern and 3 bits for blinkmode (advanced types))
ligeiro13 0:ebea19a646c3 2121 */
ligeiro13 0:ebea19a646c3 2122 void TextLCD_Base::setUDC(unsigned char c, char *udc_data) {
ligeiro13 0:ebea19a646c3 2123
ligeiro13 0:ebea19a646c3 2124 #if (LCD_TWO_CTRL == 1)
ligeiro13 0:ebea19a646c3 2125 // Select and configure second LCD controller when needed
ligeiro13 0:ebea19a646c3 2126 if(_type==LCD40x4) {
ligeiro13 0:ebea19a646c3 2127 _LCDCtrl_Idx current_ctrl_idx = _ctrl_idx; // Temp save current controller
ligeiro13 0:ebea19a646c3 2128
ligeiro13 0:ebea19a646c3 2129 // Select primary controller
ligeiro13 0:ebea19a646c3 2130 _ctrl_idx=_LCDCtrl_0;
ligeiro13 0:ebea19a646c3 2131
ligeiro13 0:ebea19a646c3 2132 // Configure primary LCD controller
ligeiro13 0:ebea19a646c3 2133 _setUDC(c, udc_data);
ligeiro13 0:ebea19a646c3 2134
ligeiro13 0:ebea19a646c3 2135 // Select 2nd controller
ligeiro13 0:ebea19a646c3 2136 _ctrl_idx=_LCDCtrl_1;
ligeiro13 0:ebea19a646c3 2137
ligeiro13 0:ebea19a646c3 2138 // Configure secondary LCD controller
ligeiro13 0:ebea19a646c3 2139 _setUDC(c, udc_data);
ligeiro13 0:ebea19a646c3 2140
ligeiro13 0:ebea19a646c3 2141 // Restore current controller
ligeiro13 0:ebea19a646c3 2142 _ctrl_idx=current_ctrl_idx;
ligeiro13 0:ebea19a646c3 2143 }
ligeiro13 0:ebea19a646c3 2144 else {
ligeiro13 0:ebea19a646c3 2145 // Configure primary LCD controller
ligeiro13 0:ebea19a646c3 2146 _setUDC(c, udc_data);
ligeiro13 0:ebea19a646c3 2147 }
ligeiro13 0:ebea19a646c3 2148 #else
ligeiro13 0:ebea19a646c3 2149 // Support only one LCD controller
ligeiro13 0:ebea19a646c3 2150 _setUDC(c, udc_data);
ligeiro13 0:ebea19a646c3 2151 #endif
ligeiro13 0:ebea19a646c3 2152 }
ligeiro13 0:ebea19a646c3 2153
ligeiro13 0:ebea19a646c3 2154 /** Low level method to store user defined characters for current controller
ligeiro13 0:ebea19a646c3 2155 *
ligeiro13 0:ebea19a646c3 2156 * @param unsigned char c The Index of the UDC (0..7) for HD44780 clones and (0..15) for some more advanced controllers
ligeiro13 0:ebea19a646c3 2157 * @param char *udc_data The bitpatterns for the UDC (8 bytes of 5 significant bits for bitpattern and 3 bits for blinkmode (advanced types))
ligeiro13 0:ebea19a646c3 2158 */
ligeiro13 0:ebea19a646c3 2159 void TextLCD_Base::_setUDC(unsigned char c, char *udc_data) {
ligeiro13 0:ebea19a646c3 2160
ligeiro13 0:ebea19a646c3 2161 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2162 case PCF2103_3V3 : // Some UDCs may be used for Icons
ligeiro13 0:ebea19a646c3 2163 case PCF2113_3V3 : // Some UDCs may be used for Icons
ligeiro13 0:ebea19a646c3 2164 case PCF2116_3V3 :
ligeiro13 0:ebea19a646c3 2165 case PCF2116_5V :
ligeiro13 0:ebea19a646c3 2166 case PCF2119_3V3 : // Some UDCs may be used for Icons
ligeiro13 0:ebea19a646c3 2167 case PCF2119R_3V3: // Some UDCs may be used for Icons
ligeiro13 0:ebea19a646c3 2168 c = c & 0x0F; // mask down to valid range
ligeiro13 0:ebea19a646c3 2169 break;
ligeiro13 0:ebea19a646c3 2170
ligeiro13 0:ebea19a646c3 2171 default:
ligeiro13 0:ebea19a646c3 2172 c = c & 0x07; // mask down to valid range
ligeiro13 0:ebea19a646c3 2173 break;
ligeiro13 0:ebea19a646c3 2174 } //switch _ctrl
ligeiro13 0:ebea19a646c3 2175
ligeiro13 0:ebea19a646c3 2176 // Select DD RAM for current LCD controller
ligeiro13 0:ebea19a646c3 2177 // This is needed to correctly set Bit 6 of the addresspointer for controllers that support 16 UDCs
ligeiro13 0:ebea19a646c3 2178 _writeCommand(0x80 | ((c << 3) & 0x40)) ;
ligeiro13 0:ebea19a646c3 2179
ligeiro13 0:ebea19a646c3 2180 // Select CG RAM for current LCD controller
ligeiro13 0:ebea19a646c3 2181 _writeCommand(0x40 | ((c << 3) & 0x3F)); //Set CG-RAM address, (note that Bit 6 is retained and can not be set by this command !)
ligeiro13 0:ebea19a646c3 2182 //8 sequential locations needed per UDC
ligeiro13 0:ebea19a646c3 2183 // Store UDC pattern
ligeiro13 0:ebea19a646c3 2184 for (int i=0; i<8; i++) {
ligeiro13 0:ebea19a646c3 2185 _writeData(*udc_data++);
ligeiro13 0:ebea19a646c3 2186 }
ligeiro13 0:ebea19a646c3 2187
ligeiro13 0:ebea19a646c3 2188 //Select DD RAM again for current LCD controller and restore the addresspointer
ligeiro13 0:ebea19a646c3 2189 int addr = getAddress(_column, _row);
ligeiro13 0:ebea19a646c3 2190 _writeCommand(0x80 | addr);
ligeiro13 0:ebea19a646c3 2191 }
ligeiro13 0:ebea19a646c3 2192
ligeiro13 0:ebea19a646c3 2193 #if(LCD_BLINK == 1)
ligeiro13 0:ebea19a646c3 2194 /** Set UDC Blink and Icon blink
ligeiro13 0:ebea19a646c3 2195 * setUDCBlink method is supported by some compatible devices (eg SSD1803)
ligeiro13 0:ebea19a646c3 2196 *
ligeiro13 0:ebea19a646c3 2197 * @param blinkMode The Blink mode (BlinkOff, BlinkOn)
ligeiro13 0:ebea19a646c3 2198 */
ligeiro13 0:ebea19a646c3 2199 void TextLCD_Base::setUDCBlink(LCDBlink blinkMode){
ligeiro13 0:ebea19a646c3 2200 // Blinking UDCs (and icons) are enabled when a specific controlbit (BE) is set.
ligeiro13 0:ebea19a646c3 2201 // The blinking pixels in the UDC and icons can be controlled by setting additional bits in the UDC or icon bitpattern.
ligeiro13 0:ebea19a646c3 2202 // UDCs are defined by an 8 byte bitpattern. The P0..P4 form the character pattern.
ligeiro13 0:ebea19a646c3 2203 // P7 P6 P5 P4 P3 P2 P1 P0
ligeiro13 0:ebea19a646c3 2204 // 0 B1 B0 x 0 1 1 1 0
ligeiro13 0:ebea19a646c3 2205 // 1 B1 B0 x 1 0 0 0 1
ligeiro13 0:ebea19a646c3 2206 // .............
ligeiro13 0:ebea19a646c3 2207 // 7 B1 B0 x 1 0 0 0 1
ligeiro13 0:ebea19a646c3 2208 //
ligeiro13 0:ebea19a646c3 2209 // Bit 6 and Bit 7 in the pattern will control the blinking mode when Blink is enabled through BE.
ligeiro13 0:ebea19a646c3 2210 // B1 B0 Mode
ligeiro13 0:ebea19a646c3 2211 // 0 0 No Blinking in this row of the UDC
ligeiro13 0:ebea19a646c3 2212 // 0 1 Enabled pixels in P4 will blink
ligeiro13 0:ebea19a646c3 2213 // 1 x Enabled pixels in P0..P4 will blink
ligeiro13 0:ebea19a646c3 2214 //
ligeiro13 0:ebea19a646c3 2215 // Note: the PCF2103 and PCF2113 use UDCs to set Icons
ligeiro13 0:ebea19a646c3 2216 // 3 x 8 rows x 5 bits = 120 bits Icons for Normal pattern (UDC 0..2) and
ligeiro13 0:ebea19a646c3 2217 // 3 x 8 rows x 5 bits = 120 bits Icons for Blink pattern (UDC 4..6)
ligeiro13 0:ebea19a646c3 2218 // Note: the PCF2119 uses UDCs to set Icons
ligeiro13 0:ebea19a646c3 2219 // 4 x 8 rows x 5 bits = 160 bits Icons for Normal pattern (UDC 0..3) and
ligeiro13 0:ebea19a646c3 2220 // 4 x 8 rows x 5 bits = 160 bits Icons for Blink pattern (UDC 4..7)
ligeiro13 0:ebea19a646c3 2221 switch (blinkMode) {
ligeiro13 0:ebea19a646c3 2222 case BlinkOn:
ligeiro13 0:ebea19a646c3 2223 // Controllers that support UDC/Icon Blink
ligeiro13 0:ebea19a646c3 2224 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2225 case KS0073 :
ligeiro13 0:ebea19a646c3 2226 case KS0078 :
ligeiro13 0:ebea19a646c3 2227 case HD66712 :
ligeiro13 0:ebea19a646c3 2228 _function_1 |= 0x02; // Enable UDC/Icon Blink
ligeiro13 0:ebea19a646c3 2229 _writeCommand(0x20 | _function_1); // Function set 0 0 1 DL N RE(1) BE 0/LP (Ext Regs)
ligeiro13 0:ebea19a646c3 2230
ligeiro13 0:ebea19a646c3 2231 _writeCommand(0x20 | _function); // Function set 0 0 1 DL N RE(0) DH REV (Std Regs)
ligeiro13 0:ebea19a646c3 2232 break; // case KS0073, KS0078, HD66712 Controller
ligeiro13 0:ebea19a646c3 2233
ligeiro13 0:ebea19a646c3 2234 case US2066_3V3 :
ligeiro13 0:ebea19a646c3 2235 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 2236 _function_1 |= 0x04; // Enable UDC/Icon Blink
ligeiro13 0:ebea19a646c3 2237 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 DL N BE RE(1) REV
ligeiro13 0:ebea19a646c3 2238 // Select Ext Instr Set
ligeiro13 0:ebea19a646c3 2239
ligeiro13 0:ebea19a646c3 2240 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2241 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 2242 break; // case SSD1803, US2066
ligeiro13 0:ebea19a646c3 2243
ligeiro13 0:ebea19a646c3 2244 case PCF2103_3V3 :
ligeiro13 0:ebea19a646c3 2245 case PCF2113_3V3 :
ligeiro13 0:ebea19a646c3 2246 case PCF2119_3V3 :
ligeiro13 0:ebea19a646c3 2247 case PCF2119R_3V3 :
ligeiro13 0:ebea19a646c3 2248 // Enable Icon Blink
ligeiro13 0:ebea19a646c3 2249 _writeCommand(0x20 | _function | 0x01); // Set function, Select Instr Set = 1
ligeiro13 0:ebea19a646c3 2250 _writeCommand(0x08 | 0x02); // ICON Conf 0000 1, IM=0 (Char mode), IB=1 (Icon blink), 0 (Instr. Set 1)
ligeiro13 0:ebea19a646c3 2251 _writeCommand(0x20 | _function); // Set function, Select Instr Set = 0
ligeiro13 0:ebea19a646c3 2252
ligeiro13 0:ebea19a646c3 2253 break;
ligeiro13 0:ebea19a646c3 2254
ligeiro13 0:ebea19a646c3 2255 default:
ligeiro13 0:ebea19a646c3 2256 //Unsupported feature for other controllers
ligeiro13 0:ebea19a646c3 2257 break;
ligeiro13 0:ebea19a646c3 2258 } //switch _ctrl
ligeiro13 0:ebea19a646c3 2259
ligeiro13 0:ebea19a646c3 2260 break; // BlinkOn
ligeiro13 0:ebea19a646c3 2261
ligeiro13 0:ebea19a646c3 2262 case BlinkOff:
ligeiro13 0:ebea19a646c3 2263 // Controllers that support UDC Blink
ligeiro13 0:ebea19a646c3 2264 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2265 case KS0073 :
ligeiro13 0:ebea19a646c3 2266 case KS0078 :
ligeiro13 0:ebea19a646c3 2267 case HD66712:
ligeiro13 0:ebea19a646c3 2268 _function_1 &= ~0x02; // Disable UDC/Icon Blink
ligeiro13 0:ebea19a646c3 2269 _writeCommand(0x20 | _function_1); // Function set 0 0 1 DL N RE(1) BE 0/LP (Ext Regs)
ligeiro13 0:ebea19a646c3 2270
ligeiro13 0:ebea19a646c3 2271 _writeCommand(0x20 | _function); // Function set 0 0 1 DL N RE(0) DH REV (Std Regs)
ligeiro13 0:ebea19a646c3 2272 break; // case KS0073, KS0078, HD66712 Controller
ligeiro13 0:ebea19a646c3 2273
ligeiro13 0:ebea19a646c3 2274 case US2066_3V3 :
ligeiro13 0:ebea19a646c3 2275 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 2276 _function_1 &= ~0x04; // Disable UDC/Icon Blink
ligeiro13 0:ebea19a646c3 2277 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 DL N BE RE(1) REV
ligeiro13 0:ebea19a646c3 2278 // Select Ext Instr Set
ligeiro13 0:ebea19a646c3 2279
ligeiro13 0:ebea19a646c3 2280 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2281 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 2282 break; // case SSD1803, US2066
ligeiro13 0:ebea19a646c3 2283
ligeiro13 0:ebea19a646c3 2284 case PCF2103_3V3 :
ligeiro13 0:ebea19a646c3 2285 case PCF2113_3V3 :
ligeiro13 0:ebea19a646c3 2286 case PCF2119_3V3 :
ligeiro13 0:ebea19a646c3 2287 case PCF2119R_3V3 :
ligeiro13 0:ebea19a646c3 2288 // Disable Icon Blink
ligeiro13 0:ebea19a646c3 2289 _writeCommand(0x20 | _function | 0x01); // Set function, Select Instr Set = 1
ligeiro13 0:ebea19a646c3 2290 _writeCommand(0x08); // ICON Conf 0000 1, IM=0 (Char mode), IB=1 (Icon blink), 0 (Instr. Set 1)
ligeiro13 0:ebea19a646c3 2291 _writeCommand(0x20 | _function); // Set function, Select Instr Set = 0
ligeiro13 0:ebea19a646c3 2292
ligeiro13 0:ebea19a646c3 2293 break;
ligeiro13 0:ebea19a646c3 2294
ligeiro13 0:ebea19a646c3 2295 default:
ligeiro13 0:ebea19a646c3 2296 //Unsupported feature for other controllers
ligeiro13 0:ebea19a646c3 2297 break;
ligeiro13 0:ebea19a646c3 2298 } //switch _ctrl
ligeiro13 0:ebea19a646c3 2299
ligeiro13 0:ebea19a646c3 2300 break; //BlinkOff
ligeiro13 0:ebea19a646c3 2301
ligeiro13 0:ebea19a646c3 2302 default:
ligeiro13 0:ebea19a646c3 2303 break;
ligeiro13 0:ebea19a646c3 2304 } // blinkMode
ligeiro13 0:ebea19a646c3 2305
ligeiro13 0:ebea19a646c3 2306 } // setUDCBlink()
ligeiro13 0:ebea19a646c3 2307 #endif
ligeiro13 0:ebea19a646c3 2308
ligeiro13 0:ebea19a646c3 2309 #if(LCD_CONTRAST == 1)
ligeiro13 0:ebea19a646c3 2310 /** Set Contrast
ligeiro13 0:ebea19a646c3 2311 * setContrast method is supported by some compatible devices (eg ST7032i) that have onboard LCD voltage generation
ligeiro13 0:ebea19a646c3 2312 * Initial code for ST70XX imported from fork by JH1PJL
ligeiro13 0:ebea19a646c3 2313 *
ligeiro13 0:ebea19a646c3 2314 * @param unsigned char c contrast data (6 significant bits, valid range 0..63, Value 0 will disable the Vgen)
ligeiro13 0:ebea19a646c3 2315 * @return none
ligeiro13 0:ebea19a646c3 2316 */
ligeiro13 0:ebea19a646c3 2317 //@TODO Add support for 40x4 dual controller
ligeiro13 0:ebea19a646c3 2318 void TextLCD_Base::setContrast(unsigned char c) {
ligeiro13 0:ebea19a646c3 2319
ligeiro13 0:ebea19a646c3 2320 // Function set mode stored during Init. Make sure we dont accidentally switch between 1-line and 2-line mode!
ligeiro13 0:ebea19a646c3 2321 // Icon/Booster mode stored during Init. Make sure we dont accidentally change this!
ligeiro13 0:ebea19a646c3 2322
ligeiro13 0:ebea19a646c3 2323 _contrast = c & 0x3F; // Sanity check
ligeiro13 0:ebea19a646c3 2324
ligeiro13 0:ebea19a646c3 2325 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2326 case PCF2113_3V3 :
ligeiro13 0:ebea19a646c3 2327 case PCF2119_3V3 :
ligeiro13 0:ebea19a646c3 2328 case PCF2119R_3V3 :
ligeiro13 0:ebea19a646c3 2329 if (_contrast < 5) _contrast = 0; // See datasheet. Sanity check for PCF2113/PCF2119
ligeiro13 0:ebea19a646c3 2330 if (_contrast > 55) _contrast = 55;
ligeiro13 0:ebea19a646c3 2331
ligeiro13 0:ebea19a646c3 2332 _writeCommand(0x20 | _function | 0x01); // Set function, Select Instruction Set = 1
ligeiro13 0:ebea19a646c3 2333 _writeCommand(0x80 | 0x00 | (_contrast & 0x3F)); // VLCD_set (Instr. Set 1) V=0, VA=contrast
ligeiro13 0:ebea19a646c3 2334 _writeCommand(0x80 | 0x40 | (_contrast & 0x3F)); // VLCD_set (Instr. Set 1) V=1, VB=contrast
ligeiro13 0:ebea19a646c3 2335 _writeCommand(0x20 | _function); // Select Instruction Set = 0
ligeiro13 0:ebea19a646c3 2336 break;
ligeiro13 0:ebea19a646c3 2337
ligeiro13 0:ebea19a646c3 2338 case ST7032_3V3 :
ligeiro13 0:ebea19a646c3 2339 case ST7032_5V :
ligeiro13 0:ebea19a646c3 2340 case ST7036_3V3 :
ligeiro13 0:ebea19a646c3 2341 // case ST7036_5V :
ligeiro13 0:ebea19a646c3 2342 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 2343 case SPLC792A_3V3 :
ligeiro13 0:ebea19a646c3 2344 _writeCommand(0x20 | _function | 0x01); // Select Instruction Set = 1
ligeiro13 0:ebea19a646c3 2345 _writeCommand(0x70 | (_contrast & 0x0F)); // Contrast Low bits
ligeiro13 0:ebea19a646c3 2346 _writeCommand(0x50 | _icon_power | ((_contrast >> 4) & 0x03)); // Contrast High bits
ligeiro13 0:ebea19a646c3 2347 _writeCommand(0x20 | _function); // Select Instruction Set = 0
ligeiro13 0:ebea19a646c3 2348 break;
ligeiro13 0:ebea19a646c3 2349
ligeiro13 0:ebea19a646c3 2350 case US2066_3V3 :
ligeiro13 0:ebea19a646c3 2351 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 DL N BE RE(1) REV
ligeiro13 0:ebea19a646c3 2352 // Select Extended Instruction Set
ligeiro13 0:ebea19a646c3 2353
ligeiro13 0:ebea19a646c3 2354 _writeCommand(0x79); // Function Select OLED: 0 1 1 1 1 0 0 1 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2355
ligeiro13 0:ebea19a646c3 2356 _writeCommand(0x81); // Set Contrast Control: 1 0 0 0 0 0 0 1 (Ext Instr Set, OLED)
ligeiro13 0:ebea19a646c3 2357 _writeCommand((_contrast << 2) | 0x03); // Set Contrast Value: 8 bits. Use 6 bits for compatibility
ligeiro13 0:ebea19a646c3 2358
ligeiro13 0:ebea19a646c3 2359 _writeCommand(0x78); // Function Disable OLED: 0 1 1 1 1 0 0 0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2360
ligeiro13 0:ebea19a646c3 2361 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2362 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 2363 break;
ligeiro13 0:ebea19a646c3 2364
ligeiro13 0:ebea19a646c3 2365 //not yet tested on hardware
ligeiro13 0:ebea19a646c3 2366 case PT6314 :
ligeiro13 0:ebea19a646c3 2367 // Only 2 significant bits
ligeiro13 0:ebea19a646c3 2368 // 0x00 = 100%
ligeiro13 0:ebea19a646c3 2369 // 0x01 = 75%
ligeiro13 0:ebea19a646c3 2370 // 0x02 = 50%
ligeiro13 0:ebea19a646c3 2371 // 0x03 = 25%
ligeiro13 0:ebea19a646c3 2372 _writeCommand(0x20 | _function | ((~_contrast) >> 4)); // Invert and shift to use 2 MSBs
ligeiro13 0:ebea19a646c3 2373 break;
ligeiro13 0:ebea19a646c3 2374
ligeiro13 0:ebea19a646c3 2375 default:
ligeiro13 0:ebea19a646c3 2376 //Unsupported feature for other controllers
ligeiro13 0:ebea19a646c3 2377 break;
ligeiro13 0:ebea19a646c3 2378 } // end switch
ligeiro13 0:ebea19a646c3 2379 } // end setContrast()
ligeiro13 0:ebea19a646c3 2380 #endif
ligeiro13 0:ebea19a646c3 2381
ligeiro13 0:ebea19a646c3 2382 #if(LCD_POWER == 1)
ligeiro13 0:ebea19a646c3 2383 /** Set Power
ligeiro13 0:ebea19a646c3 2384 * setPower method is supported by some compatible devices (eg SSD1803) that have power down modes
ligeiro13 0:ebea19a646c3 2385 *
ligeiro13 0:ebea19a646c3 2386 * @param bool powerOn Power on/off
ligeiro13 0:ebea19a646c3 2387 * @return none
ligeiro13 0:ebea19a646c3 2388 */
ligeiro13 0:ebea19a646c3 2389 //@TODO Add support for 40x4 dual controller
ligeiro13 0:ebea19a646c3 2390 void TextLCD_Base::setPower(bool powerOn) {
ligeiro13 0:ebea19a646c3 2391
ligeiro13 0:ebea19a646c3 2392 if (powerOn) {
ligeiro13 0:ebea19a646c3 2393 // Switch on
ligeiro13 0:ebea19a646c3 2394 setMode(DispOn);
ligeiro13 0:ebea19a646c3 2395
ligeiro13 0:ebea19a646c3 2396 // Controllers that supports specific Power Down mode
ligeiro13 0:ebea19a646c3 2397 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2398
ligeiro13 0:ebea19a646c3 2399 // case PCF2113_3V3 :
ligeiro13 0:ebea19a646c3 2400 // case PCF2119_3V3 :
ligeiro13 0:ebea19a646c3 2401 // case PCF2119R_3V3 :
ligeiro13 0:ebea19a646c3 2402 // case ST7032_3V3 :
ligeiro13 0:ebea19a646c3 2403 //@todo
ligeiro13 0:ebea19a646c3 2404 // enable Booster Bon
ligeiro13 0:ebea19a646c3 2405
ligeiro13 0:ebea19a646c3 2406 case WS0010:
ligeiro13 0:ebea19a646c3 2407 _writeCommand(0x17); // Char mode, DC/DC on
ligeiro13 0:ebea19a646c3 2408 wait_ms(10); // Wait 10ms to ensure powered up
ligeiro13 0:ebea19a646c3 2409 break;
ligeiro13 0:ebea19a646c3 2410
ligeiro13 0:ebea19a646c3 2411 case KS0073:
ligeiro13 0:ebea19a646c3 2412 case KS0078:
ligeiro13 0:ebea19a646c3 2413 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 2414 // case SSD1803_5V :
ligeiro13 0:ebea19a646c3 2415 _writeCommand(0x20 | _function_1); // Select Ext Instr Set
ligeiro13 0:ebea19a646c3 2416 _writeCommand(0x02); // Power On
ligeiro13 0:ebea19a646c3 2417 _writeCommand(0x20 | _function); // Select Std Instr Set
ligeiro13 0:ebea19a646c3 2418 break;
ligeiro13 0:ebea19a646c3 2419
ligeiro13 0:ebea19a646c3 2420 default:
ligeiro13 0:ebea19a646c3 2421 //Unsupported feature for other controllers
ligeiro13 0:ebea19a646c3 2422 break;
ligeiro13 0:ebea19a646c3 2423 } // end switch
ligeiro13 0:ebea19a646c3 2424 }
ligeiro13 0:ebea19a646c3 2425 else {
ligeiro13 0:ebea19a646c3 2426 // Switch off
ligeiro13 0:ebea19a646c3 2427 setMode(DispOff);
ligeiro13 0:ebea19a646c3 2428
ligeiro13 0:ebea19a646c3 2429 // Controllers that support specific Power Down mode
ligeiro13 0:ebea19a646c3 2430 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2431
ligeiro13 0:ebea19a646c3 2432 // case PCF2113_3V3 :
ligeiro13 0:ebea19a646c3 2433 // case PCF2119_3V3 :
ligeiro13 0:ebea19a646c3 2434 // case PCF2119R_3V3 :
ligeiro13 0:ebea19a646c3 2435 // case ST7032_3V3 :
ligeiro13 0:ebea19a646c3 2436 //@todo
ligeiro13 0:ebea19a646c3 2437 // disable Booster Bon
ligeiro13 0:ebea19a646c3 2438
ligeiro13 0:ebea19a646c3 2439 case WS0010:
ligeiro13 0:ebea19a646c3 2440 _writeCommand(0x13); // Char mode, DC/DC off
ligeiro13 0:ebea19a646c3 2441 break;
ligeiro13 0:ebea19a646c3 2442
ligeiro13 0:ebea19a646c3 2443 case KS0073:
ligeiro13 0:ebea19a646c3 2444 case KS0078:
ligeiro13 0:ebea19a646c3 2445 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 2446 // case SSD1803_5V :
ligeiro13 0:ebea19a646c3 2447 _writeCommand(0x20 | _function_1); // Select Ext Instr Set
ligeiro13 0:ebea19a646c3 2448 _writeCommand(0x03); // Power Down
ligeiro13 0:ebea19a646c3 2449 _writeCommand(0x20 | _function); // Select Std Instr Set
ligeiro13 0:ebea19a646c3 2450 break;
ligeiro13 0:ebea19a646c3 2451
ligeiro13 0:ebea19a646c3 2452 default:
ligeiro13 0:ebea19a646c3 2453 //Unsupported feature for other controllers
ligeiro13 0:ebea19a646c3 2454 break;
ligeiro13 0:ebea19a646c3 2455 } // end switch
ligeiro13 0:ebea19a646c3 2456 }
ligeiro13 0:ebea19a646c3 2457 } // end setPower()
ligeiro13 0:ebea19a646c3 2458 #endif
ligeiro13 0:ebea19a646c3 2459
ligeiro13 0:ebea19a646c3 2460 #if(LCD_ORIENT == 1)
ligeiro13 0:ebea19a646c3 2461 /** Set Orient
ligeiro13 0:ebea19a646c3 2462 * setOrient method is supported by some compatible devices (eg SSD1803, US2066) that have top/bottom view modes
ligeiro13 0:ebea19a646c3 2463 *
ligeiro13 0:ebea19a646c3 2464 * @param LCDOrient orient Orientation
ligeiro13 0:ebea19a646c3 2465 * @return none
ligeiro13 0:ebea19a646c3 2466 */
ligeiro13 0:ebea19a646c3 2467 void TextLCD_Base::setOrient(LCDOrient orient){
ligeiro13 0:ebea19a646c3 2468
ligeiro13 0:ebea19a646c3 2469 switch (orient) {
ligeiro13 0:ebea19a646c3 2470
ligeiro13 0:ebea19a646c3 2471 case Top:
ligeiro13 0:ebea19a646c3 2472 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2473 case PCF2103_3V3:
ligeiro13 0:ebea19a646c3 2474 case PCF2116_3V3:
ligeiro13 0:ebea19a646c3 2475 case PCF2116_5V:
ligeiro13 0:ebea19a646c3 2476 _writeCommand(0x20 | _function | 0x01); // Set function, Select Instr Set = 1
ligeiro13 0:ebea19a646c3 2477 _writeCommand(0x05); // Display Conf Set 0000 0, 1, P=0, Q=1 (Instr. Set 1)
ligeiro13 0:ebea19a646c3 2478 _writeCommand(0x20 | _function); // Set function, Select Instr Set = 0
ligeiro13 0:ebea19a646c3 2479 break;
ligeiro13 0:ebea19a646c3 2480
ligeiro13 0:ebea19a646c3 2481 case PCF2119_3V3:
ligeiro13 0:ebea19a646c3 2482 case PCF2119R_3V3:
ligeiro13 0:ebea19a646c3 2483 _writeCommand(0x20 | _function | 0x01); // Set function, Select Instr Set = 1
ligeiro13 0:ebea19a646c3 2484 _writeCommand(0x07); // Display Conf Set 0000 0, 1, P=1, Q=1 (Instr. Set 1)
ligeiro13 0:ebea19a646c3 2485 _writeCommand(0x20 | _function); // Set function, Select Instr Set = 0
ligeiro13 0:ebea19a646c3 2486 break;
ligeiro13 0:ebea19a646c3 2487
ligeiro13 0:ebea19a646c3 2488 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 2489 // case SSD1803_5V :
ligeiro13 0:ebea19a646c3 2490 case US2066_3V3 :
ligeiro13 0:ebea19a646c3 2491 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 X N BE RE(1) REV
ligeiro13 0:ebea19a646c3 2492 // Select Extended Instruction Set
ligeiro13 0:ebea19a646c3 2493 // _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)
ligeiro13 0:ebea19a646c3 2494 _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)
ligeiro13 0:ebea19a646c3 2495
ligeiro13 0:ebea19a646c3 2496 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2497 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 2498 break;
ligeiro13 0:ebea19a646c3 2499
ligeiro13 0:ebea19a646c3 2500 case ST7070:
ligeiro13 0:ebea19a646c3 2501 _writeCommand(0x20 | _function | 0x04); // Set function, 0 0 1 DL, N, EXT=1, x, x (Select Instr Set = 1)
ligeiro13 0:ebea19a646c3 2502
ligeiro13 0:ebea19a646c3 2503 _writeCommand(0x40 | 0x00); // COM/SEG directions 0 1 0 0 C1, C2, S1, S2 (Instr Set 1)
ligeiro13 0:ebea19a646c3 2504 // C1=1: Com1-8 -> Com8-1; C2=1: Com9-16 -> Com16-9
ligeiro13 0:ebea19a646c3 2505 // S1=1: Seg1-40 -> Seg40-1; S2=1: Seg41-80 -> Seg80-41
ligeiro13 0:ebea19a646c3 2506 wait_ms(5); // Wait to ensure completion or ST7070 fails to set Top/Bottom after reset..
ligeiro13 0:ebea19a646c3 2507
ligeiro13 0:ebea19a646c3 2508 _writeCommand(0x20 | _function); // Set function, EXT=0 (Select Instr Set = 0)
ligeiro13 0:ebea19a646c3 2509
ligeiro13 0:ebea19a646c3 2510 break; // case ST7070 Controller
ligeiro13 0:ebea19a646c3 2511
ligeiro13 0:ebea19a646c3 2512 default:
ligeiro13 0:ebea19a646c3 2513 //Unsupported feature for other controllers
ligeiro13 0:ebea19a646c3 2514 break;
ligeiro13 0:ebea19a646c3 2515
ligeiro13 0:ebea19a646c3 2516 } // end switch _ctrl
ligeiro13 0:ebea19a646c3 2517 break; // end Top
ligeiro13 0:ebea19a646c3 2518
ligeiro13 0:ebea19a646c3 2519 case Bottom:
ligeiro13 0:ebea19a646c3 2520 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2521 case PCF2103_3V3:
ligeiro13 0:ebea19a646c3 2522 case PCF2116_3V3:
ligeiro13 0:ebea19a646c3 2523 case PCF2116_5V:
ligeiro13 0:ebea19a646c3 2524 _writeCommand(0x20 | _function | 0x01); // Set function, Select Instr Set = 1
ligeiro13 0:ebea19a646c3 2525 _writeCommand(0x06); // Display Conf Set 0000 0, 1, P=1, Q=0 (Instr. Set 1)
ligeiro13 0:ebea19a646c3 2526 _writeCommand(0x20 | _function); // Set function, Select Instr Set = 0
ligeiro13 0:ebea19a646c3 2527 break;
ligeiro13 0:ebea19a646c3 2528
ligeiro13 0:ebea19a646c3 2529 case PCF2119_3V3:
ligeiro13 0:ebea19a646c3 2530 case PCF2119R_3V3 :
ligeiro13 0:ebea19a646c3 2531 _writeCommand(0x20 | _function | 0x01); // Set function, Select Instr Set = 1
ligeiro13 0:ebea19a646c3 2532 _writeCommand(0x04); // Display Conf Set 0000 0, 1, P=0, Q=0 (Instr. Set 1)
ligeiro13 0:ebea19a646c3 2533 _writeCommand(0x20 | _function); // Set function, Select Instr Set = 0
ligeiro13 0:ebea19a646c3 2534 break;
ligeiro13 0:ebea19a646c3 2535
ligeiro13 0:ebea19a646c3 2536 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 2537 // case SSD1803_5V :
ligeiro13 0:ebea19a646c3 2538 case US2066_3V3 :
ligeiro13 0:ebea19a646c3 2539 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 X N BE RE(1) REV
ligeiro13 0:ebea19a646c3 2540 // Select Extended Instruction Set
ligeiro13 0:ebea19a646c3 2541 _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)
ligeiro13 0:ebea19a646c3 2542 // _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)
ligeiro13 0:ebea19a646c3 2543
ligeiro13 0:ebea19a646c3 2544 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2545 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 2546 break;
ligeiro13 0:ebea19a646c3 2547
ligeiro13 0:ebea19a646c3 2548 case ST7070:
ligeiro13 0:ebea19a646c3 2549 //Note: this does not result in correct top/bottom view.
ligeiro13 0:ebea19a646c3 2550 //The left and right half of each row are reversed and the addressing of both rows is also incorrect:
ligeiro13 0:ebea19a646c3 2551 //Top/bottomline when orientation is flipped:
ligeiro13 0:ebea19a646c3 2552 // 0x48...0x4F 0x40...0x47
ligeiro13 0:ebea19a646c3 2553 // 0x08...0x0F 0x00...0x07
ligeiro13 0:ebea19a646c3 2554 _writeCommand(0x20 | _function | 0x04); // Set function, 0 0 1 DL N EXT=1 x x (Select Instr Set = 1)
ligeiro13 0:ebea19a646c3 2555
ligeiro13 0:ebea19a646c3 2556 _writeCommand(0x40 | 0x0F); // COM/SEG directions 0 1 0 0 C1, C2, S1, S2 (Instr Set 1)
ligeiro13 0:ebea19a646c3 2557 // C1=1: Com1-8 -> Com8-1; C2=1: Com9-16 -> Com16-9
ligeiro13 0:ebea19a646c3 2558 // S1=1: Seg1-40 -> Seg40-1; S2=1: Seg41-80 -> Seg80-41
ligeiro13 0:ebea19a646c3 2559 wait_ms(5); // Wait to ensure completion or ST7070 fails to set Top/Bottom after reset..
ligeiro13 0:ebea19a646c3 2560
ligeiro13 0:ebea19a646c3 2561 _writeCommand(0x20 | _function); // Set function, EXT=0 (Select Instr Set = 0)
ligeiro13 0:ebea19a646c3 2562
ligeiro13 0:ebea19a646c3 2563 break; // case ST7070 Controller
ligeiro13 0:ebea19a646c3 2564
ligeiro13 0:ebea19a646c3 2565 default:
ligeiro13 0:ebea19a646c3 2566 //Unsupported feature for other controllers
ligeiro13 0:ebea19a646c3 2567 break;
ligeiro13 0:ebea19a646c3 2568
ligeiro13 0:ebea19a646c3 2569 } // end switch _ctrl
ligeiro13 0:ebea19a646c3 2570
ligeiro13 0:ebea19a646c3 2571 break; // end Bottom
ligeiro13 0:ebea19a646c3 2572 } // end switch orient
ligeiro13 0:ebea19a646c3 2573 } // end setOrient()
ligeiro13 0:ebea19a646c3 2574 #endif
ligeiro13 0:ebea19a646c3 2575
ligeiro13 0:ebea19a646c3 2576 #if(LCD_BIGFONT == 1)
ligeiro13 0:ebea19a646c3 2577 /** Set Big Font
ligeiro13 0:ebea19a646c3 2578 * setBigFont method is supported by some compatible devices (eg SSD1803, US2066)
ligeiro13 0:ebea19a646c3 2579 *
ligeiro13 0:ebea19a646c3 2580 * @param lines The selected Big Font lines (None, TopLine, CenterLine, BottomLine, TopBottomLine)
ligeiro13 0:ebea19a646c3 2581 * Double height characters can be shown on lines 1+2, 2+3, 3+4 or 1+2 and 3+4
ligeiro13 0:ebea19a646c3 2582 * Valid double height lines depend on the LCDs number of rows.
ligeiro13 0:ebea19a646c3 2583 */
ligeiro13 0:ebea19a646c3 2584 void TextLCD_Base::setBigFont(LCDBigFont lines) {
ligeiro13 0:ebea19a646c3 2585
ligeiro13 0:ebea19a646c3 2586 switch (lines) {
ligeiro13 0:ebea19a646c3 2587 case None:
ligeiro13 0:ebea19a646c3 2588 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2589 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 2590 case US2066_3V3 :
ligeiro13 0:ebea19a646c3 2591 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 X N BE RE(1) REV
ligeiro13 0:ebea19a646c3 2592 // Select Extended Instruction Set
ligeiro13 0:ebea19a646c3 2593 _writeCommand(0x1C); // Double Height, 0 0 0 1 UD2=1, UD1=1, X, DH'=0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2594 // Default
ligeiro13 0:ebea19a646c3 2595 _function = _function & ~0x04; // Set function, 0 0 1 DL N DH=0 RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2596 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2597 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 2598 break; // end US2066
ligeiro13 0:ebea19a646c3 2599
ligeiro13 0:ebea19a646c3 2600 default:
ligeiro13 0:ebea19a646c3 2601 break; // end default
ligeiro13 0:ebea19a646c3 2602 } // end switch _ctrl
ligeiro13 0:ebea19a646c3 2603 break; // end None
ligeiro13 0:ebea19a646c3 2604
ligeiro13 0:ebea19a646c3 2605 case TopLine:
ligeiro13 0:ebea19a646c3 2606 if (_nr_rows < 2) return; //Sanity check
ligeiro13 0:ebea19a646c3 2607
ligeiro13 0:ebea19a646c3 2608 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2609 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 2610 case US2066_3V3 :
ligeiro13 0:ebea19a646c3 2611 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 X N BE RE(1) REV
ligeiro13 0:ebea19a646c3 2612 // Select Extended Instruction Set
ligeiro13 0:ebea19a646c3 2613 _writeCommand(0x1C); // Double Height, 0 0 0 1 UD2=1, UD1=1, X, DH'=0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2614 // Default
ligeiro13 0:ebea19a646c3 2615 _function = _function | 0x04; // Set function, 0 0 1 DL N DH=1 RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2616 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2617 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 2618 break; // end US2066, SSD1803
ligeiro13 0:ebea19a646c3 2619
ligeiro13 0:ebea19a646c3 2620 default:
ligeiro13 0:ebea19a646c3 2621 break; // end default
ligeiro13 0:ebea19a646c3 2622 } // end switch _ctrl
ligeiro13 0:ebea19a646c3 2623 break; // end TopLine
ligeiro13 0:ebea19a646c3 2624
ligeiro13 0:ebea19a646c3 2625 case CenterLine:
ligeiro13 0:ebea19a646c3 2626 if (_nr_rows != 4) return; //Sanity check
ligeiro13 0:ebea19a646c3 2627
ligeiro13 0:ebea19a646c3 2628 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2629 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 2630 case US2066_3V3 :
ligeiro13 0:ebea19a646c3 2631 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 X N BE RE(1) REV
ligeiro13 0:ebea19a646c3 2632 // Select Extended Instruction Set
ligeiro13 0:ebea19a646c3 2633 _writeCommand(0x14); // Double Height, 0 0 0 1 UD2=0, UD1=1, X, DH'=0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2634 // Default
ligeiro13 0:ebea19a646c3 2635 _function = _function | 0x04; // Set function, 0 0 1 DL N DH=1 RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2636 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2637 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 2638 break; // end US2066, SSD1803
ligeiro13 0:ebea19a646c3 2639
ligeiro13 0:ebea19a646c3 2640 default:
ligeiro13 0:ebea19a646c3 2641 break; // end default
ligeiro13 0:ebea19a646c3 2642 } // end switch _ctrl
ligeiro13 0:ebea19a646c3 2643 break; // end CenterLine
ligeiro13 0:ebea19a646c3 2644
ligeiro13 0:ebea19a646c3 2645 case BottomLine:
ligeiro13 0:ebea19a646c3 2646 if (_nr_rows < 3) return; //Sanity check
ligeiro13 0:ebea19a646c3 2647
ligeiro13 0:ebea19a646c3 2648 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2649 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 2650 case US2066_3V3 :
ligeiro13 0:ebea19a646c3 2651 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 X N BE RE(1) REV
ligeiro13 0:ebea19a646c3 2652 // Select Extended Instruction Set
ligeiro13 0:ebea19a646c3 2653 if (_nr_rows == 3) {
ligeiro13 0:ebea19a646c3 2654 _writeCommand(0x14); // Double Height, 0 0 0 1 UD2=0, UD1=1, X, DH'=0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2655 }
ligeiro13 0:ebea19a646c3 2656 else {
ligeiro13 0:ebea19a646c3 2657 _writeCommand(0x10); // Double Height, 0 0 0 1 UD2=0, UD1=0, X, DH'=0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2658 }
ligeiro13 0:ebea19a646c3 2659 _function = _function | 0x04; // Set function, 0 0 1 DL N DH=1 RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2660 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2661 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 2662 break; // end US2066, SSD1803
ligeiro13 0:ebea19a646c3 2663
ligeiro13 0:ebea19a646c3 2664 default:
ligeiro13 0:ebea19a646c3 2665 break; // end default
ligeiro13 0:ebea19a646c3 2666 } // end switch _ctrl
ligeiro13 0:ebea19a646c3 2667 break; // end BottomLine
ligeiro13 0:ebea19a646c3 2668
ligeiro13 0:ebea19a646c3 2669 case TopBottomLine:
ligeiro13 0:ebea19a646c3 2670 if (_nr_rows != 4) return; //Sanity check
ligeiro13 0:ebea19a646c3 2671
ligeiro13 0:ebea19a646c3 2672 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2673 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 2674 case US2066_3V3 :
ligeiro13 0:ebea19a646c3 2675 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 X N BE RE(1) REV
ligeiro13 0:ebea19a646c3 2676 // Select Extended Instruction Set
ligeiro13 0:ebea19a646c3 2677 _writeCommand(0x18); // Double Height, 0 0 0 1 UD2=1, UD1=0, X, DH'=0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2678 // Default
ligeiro13 0:ebea19a646c3 2679 _function = _function | 0x04; // Set function, 0 0 1 DL N DH=1 RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2680 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS=0 Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2681 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 2682 break; // end US2066, SSD1803
ligeiro13 0:ebea19a646c3 2683
ligeiro13 0:ebea19a646c3 2684 default:
ligeiro13 0:ebea19a646c3 2685 break; // end default
ligeiro13 0:ebea19a646c3 2686 } // end switch _ctrl
ligeiro13 0:ebea19a646c3 2687 break; // end TopBottomLine
ligeiro13 0:ebea19a646c3 2688
ligeiro13 0:ebea19a646c3 2689 } // end switch lines
ligeiro13 0:ebea19a646c3 2690
ligeiro13 0:ebea19a646c3 2691 } // end setBigFont()
ligeiro13 0:ebea19a646c3 2692 #endif
ligeiro13 0:ebea19a646c3 2693
ligeiro13 0:ebea19a646c3 2694
ligeiro13 0:ebea19a646c3 2695 #if (LCD_FONTSEL == 1)
ligeiro13 0:ebea19a646c3 2696 /** Set Font
ligeiro13 0:ebea19a646c3 2697 * setFont method is supported by some compatible devices (eg SSD1803, US2066, ST7070)
ligeiro13 0:ebea19a646c3 2698 *
ligeiro13 0:ebea19a646c3 2699 * @param LCDFont font The selected Font
ligeiro13 0:ebea19a646c3 2700 * @return none
ligeiro13 0:ebea19a646c3 2701 *
ligeiro13 0:ebea19a646c3 2702 * Note: most controllers support only one font and the hardware specific
ligeiro13 0:ebea19a646c3 2703 * fonttable is encoded as part of the controller type number (eg PCF21XXC or PCF21XXR).
ligeiro13 0:ebea19a646c3 2704 * Some controllers support multiple tables that can only be selected by logic levels on a few pins.
ligeiro13 0:ebea19a646c3 2705 * Some controllers also support runtime fontable switching through a specific instruction
ligeiro13 0:ebea19a646c3 2706 */
ligeiro13 0:ebea19a646c3 2707 void TextLCD_Base::setFont(LCDFont font) {
ligeiro13 0:ebea19a646c3 2708
ligeiro13 0:ebea19a646c3 2709 switch (font) {
ligeiro13 0:ebea19a646c3 2710 case Font_RA: // UK/EU
ligeiro13 0:ebea19a646c3 2711 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2712 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 2713 case US2066_3V3 :
ligeiro13 0:ebea19a646c3 2714 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 X N BE RE(1) REV
ligeiro13 0:ebea19a646c3 2715 // Select Extended Instruction Set
ligeiro13 0:ebea19a646c3 2716 _writeCommand(0x72); // ROM Select command, 0 1 1 1 0 0 1 0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2717 _writeData(0x00); // ROM_0 Select data, 0 0 0 0 ROM2 ROM1 0 0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2718
ligeiro13 0:ebea19a646c3 2719 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS (Std Instr Set)
ligeiro13 0:ebea19a646c3 2720
ligeiro13 0:ebea19a646c3 2721 _font = font; // Save active font
ligeiro13 0:ebea19a646c3 2722 break; // end SSD1803, US2066
ligeiro13 0:ebea19a646c3 2723
ligeiro13 0:ebea19a646c3 2724 case ST7070:
ligeiro13 0:ebea19a646c3 2725 //ST7070 does not support Cursorblink. The P bit selects the font instead !
ligeiro13 0:ebea19a646c3 2726 _writeCommand(0x08 | _currentMode | (_currentCursor & 0x02));
ligeiro13 0:ebea19a646c3 2727
ligeiro13 0:ebea19a646c3 2728 _font = font; // Save active font
ligeiro13 0:ebea19a646c3 2729 break; // end ST7070
ligeiro13 0:ebea19a646c3 2730
ligeiro13 0:ebea19a646c3 2731 default:
ligeiro13 0:ebea19a646c3 2732 break; // end default
ligeiro13 0:ebea19a646c3 2733 } // end switch _ctrl
ligeiro13 0:ebea19a646c3 2734 break; // end Font_RA
ligeiro13 0:ebea19a646c3 2735
ligeiro13 0:ebea19a646c3 2736 case Font_RB: // UK/CYR
ligeiro13 0:ebea19a646c3 2737 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2738 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 2739 case US2066_3V3 :
ligeiro13 0:ebea19a646c3 2740 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 X N BE RE(1) REV
ligeiro13 0:ebea19a646c3 2741 // Select Extended Instruction Set
ligeiro13 0:ebea19a646c3 2742 _writeCommand(0x72); // ROM Select command, 0 1 1 1 0 0 1 0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2743 _writeData(0x04); // ROM_0 Select data, 0 0 0 0 ROM2 ROM1 0 0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2744
ligeiro13 0:ebea19a646c3 2745 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS (Std Instr Set)
ligeiro13 0:ebea19a646c3 2746
ligeiro13 0:ebea19a646c3 2747 _font = font; // Save active font
ligeiro13 0:ebea19a646c3 2748 break; // end SSD1803, US2066
ligeiro13 0:ebea19a646c3 2749
ligeiro13 0:ebea19a646c3 2750 case ST7070:
ligeiro13 0:ebea19a646c3 2751 //ST7070 does not support Cursorblink. The P bit selects the font instead !
ligeiro13 0:ebea19a646c3 2752 _writeCommand(0x08 | _currentMode | (_currentCursor & 0x02) | 0x01);
ligeiro13 0:ebea19a646c3 2753
ligeiro13 0:ebea19a646c3 2754 _font = font; // Save active font
ligeiro13 0:ebea19a646c3 2755 break; // end ST7070
ligeiro13 0:ebea19a646c3 2756
ligeiro13 0:ebea19a646c3 2757 default:
ligeiro13 0:ebea19a646c3 2758 break; // end default
ligeiro13 0:ebea19a646c3 2759 } // end switch _ctrl
ligeiro13 0:ebea19a646c3 2760 break; // end Font_RB
ligeiro13 0:ebea19a646c3 2761
ligeiro13 0:ebea19a646c3 2762 case Font_0: //Font_O is pretty similar to ROM_C
ligeiro13 0:ebea19a646c3 2763 case Font_RC: // UK/JAP
ligeiro13 0:ebea19a646c3 2764 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2765 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 2766 case US2066_3V3 :
ligeiro13 0:ebea19a646c3 2767 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 X N BE RE(1) REV
ligeiro13 0:ebea19a646c3 2768 // Select Extended Instruction Set
ligeiro13 0:ebea19a646c3 2769 _writeCommand(0x72); // ROM Select command, 0 1 1 1 0 0 1 0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2770 _writeData(0x08); // ROM_0 Select data, 0 0 0 0 ROM2 ROM1 0 0 (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2771
ligeiro13 0:ebea19a646c3 2772 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS (Std Instr Set)
ligeiro13 0:ebea19a646c3 2773
ligeiro13 0:ebea19a646c3 2774 _font = font; // Save active font
ligeiro13 0:ebea19a646c3 2775 break; // end SSD1803, US2066
ligeiro13 0:ebea19a646c3 2776
ligeiro13 0:ebea19a646c3 2777 default:
ligeiro13 0:ebea19a646c3 2778 break; // end default
ligeiro13 0:ebea19a646c3 2779 } // end switch _ctrl
ligeiro13 0:ebea19a646c3 2780 break; // end Font_RC
ligeiro13 0:ebea19a646c3 2781 } // end switch font
ligeiro13 0:ebea19a646c3 2782
ligeiro13 0:ebea19a646c3 2783 //SSD1803 seems to screw up cursor position after selecting new font. Restore to make sure...
ligeiro13 0:ebea19a646c3 2784 //Set next memoryaddress, make sure cursor blinks at next location
ligeiro13 0:ebea19a646c3 2785 int addr = getAddress(_column, _row);
ligeiro13 0:ebea19a646c3 2786 _writeCommand(0x80 | addr);
ligeiro13 0:ebea19a646c3 2787
ligeiro13 0:ebea19a646c3 2788 }
ligeiro13 0:ebea19a646c3 2789 #endif
ligeiro13 0:ebea19a646c3 2790
ligeiro13 0:ebea19a646c3 2791
ligeiro13 0:ebea19a646c3 2792 #if(LCD_ICON==1)
ligeiro13 0:ebea19a646c3 2793 /** Set Icons
ligeiro13 0:ebea19a646c3 2794 *
ligeiro13 0:ebea19a646c3 2795 * @param unsigned char idx The Index of the icon pattern (0..15) for KS0073 and similar controllers
ligeiro13 0:ebea19a646c3 2796 * and Index (0..31) for PCF2103 and similar controllers
ligeiro13 0:ebea19a646c3 2797 * @param unsigned char data The bitpattern for the icons (6 lsb for KS0073 bitpattern (5 lsb for KS0078) and 2 msb for blinkmode)
ligeiro13 0:ebea19a646c3 2798 * The bitpattern for the PCF2103 icons is 5 lsb (UDC 0..2) and 5 lsb for blinkmode (UDC 4..6)
ligeiro13 0:ebea19a646c3 2799 */
ligeiro13 0:ebea19a646c3 2800 void TextLCD_Base::setIcon(unsigned char idx, unsigned char data) {
ligeiro13 0:ebea19a646c3 2801 // Blinking icons are enabled when a specific controlbit (BE) is set.
ligeiro13 0:ebea19a646c3 2802 // The blinking pixels in the icons can be controlled by setting additional bits in the icon bitpattern.
ligeiro13 0:ebea19a646c3 2803 // Icons are defined by a byte bitpattern. The P0..P5 form the Icon pattern for KS0073, and P0..P4 for KS0078
ligeiro13 0:ebea19a646c3 2804 // P7 P6 P5 P4 P3 P2 P1 P0
ligeiro13 0:ebea19a646c3 2805 // 0 B1 B0 0 0 1 1 1 0
ligeiro13 0:ebea19a646c3 2806 // 1 B1 B0 1 1 0 0 0 1
ligeiro13 0:ebea19a646c3 2807 // .............
ligeiro13 0:ebea19a646c3 2808 // 15 B1 B0 1 1 0 0 0 1
ligeiro13 0:ebea19a646c3 2809 //
ligeiro13 0:ebea19a646c3 2810 // Bit 6 and Bit 7 in the pattern will control the blinking mode when Blink is enabled through BE.
ligeiro13 0:ebea19a646c3 2811 // B1 B0 Mode
ligeiro13 0:ebea19a646c3 2812 // 0 0 No Blinking for this icon row
ligeiro13 0:ebea19a646c3 2813 // 0 1 Enabled pixels in P5 will blink
ligeiro13 0:ebea19a646c3 2814 // 1 x Enabled pixels in P0..P5 will blink
ligeiro13 0:ebea19a646c3 2815 //
ligeiro13 0:ebea19a646c3 2816 // Note: the PCF2103 and PCF2113 use UDCs to set Icons
ligeiro13 0:ebea19a646c3 2817 // 3 x 8 rows x 5 bits = 120 bits Icons for Normal pattern (UDC 0..2) and
ligeiro13 0:ebea19a646c3 2818 // 3 x 8 rows x 5 bits = 120 bits Icons for Blink pattern (UDC 4..6)
ligeiro13 0:ebea19a646c3 2819 // Note: the PCF2119 uses UDCs to set Icons
ligeiro13 0:ebea19a646c3 2820 // 4 x 8 rows x 5 bits = 160 bits Icons for Normal pattern (UDC 0..3) and
ligeiro13 0:ebea19a646c3 2821 // 4 x 8 rows x 5 bits = 160 bits Icons for Blink pattern (UDC 4..7)
ligeiro13 0:ebea19a646c3 2822
ligeiro13 0:ebea19a646c3 2823 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2824 case KS0073:
ligeiro13 0:ebea19a646c3 2825 case KS0078:
ligeiro13 0:ebea19a646c3 2826 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 DL N RE(1) BE LP
ligeiro13 0:ebea19a646c3 2827 // Select Extended Instruction Set
ligeiro13 0:ebea19a646c3 2828 _writeCommand(0x40 | (idx & 0x0F)); // Set Icon Address, mask Address to valid range (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2829
ligeiro13 0:ebea19a646c3 2830 _writeData(data); // Set Icon pattern (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2831
ligeiro13 0:ebea19a646c3 2832 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N RE(0) DH REV Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2833 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 2834 break; // end KS0073, KS0078
ligeiro13 0:ebea19a646c3 2835
ligeiro13 0:ebea19a646c3 2836 case ST7032_3V3:
ligeiro13 0:ebea19a646c3 2837 case ST7032_5V:
ligeiro13 0:ebea19a646c3 2838 case SPLC792A_3V3:
ligeiro13 0:ebea19a646c3 2839 _writeCommand(0x20 | _function | 0x01); // Set function, 0 0 1 DL N F 0 IS=1 Select Instr Set = 1
ligeiro13 0:ebea19a646c3 2840 _writeCommand(0x40 | (idx & 0x0F)); // Set Icon Address, mask Address to valid range (Instr Set 1)
ligeiro13 0:ebea19a646c3 2841
ligeiro13 0:ebea19a646c3 2842 _writeData(data & 0x1F); // Set Icon pattern, no blink support (Instr Set 1)
ligeiro13 0:ebea19a646c3 2843
ligeiro13 0:ebea19a646c3 2844 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N RE(0) DH REV Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2845 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 2846 break; // end ST7032
ligeiro13 0:ebea19a646c3 2847
ligeiro13 0:ebea19a646c3 2848 case ST7036_3V3:
ligeiro13 0:ebea19a646c3 2849 case ST7036_5V:
ligeiro13 0:ebea19a646c3 2850 _writeCommand(0x20 | _function | 0x01); // Set function, 0 0 1 DL N DH IS2,IS1 = 01 (Select Instr Set = 1)
ligeiro13 0:ebea19a646c3 2851 _writeCommand(0x40 | (idx & 0x0F)); // Set Icon Address, mask Address to valid range (Instr Set 1)
ligeiro13 0:ebea19a646c3 2852
ligeiro13 0:ebea19a646c3 2853 _writeData(data & 0x1F); // Set Icon pattern, no blink support (Instr Set 1)
ligeiro13 0:ebea19a646c3 2854
ligeiro13 0:ebea19a646c3 2855 _writeCommand(0x20 | _function); // Set function, IS2,IS1 = 00 (Select Instr Set = 0)
ligeiro13 0:ebea19a646c3 2856 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 2857 break; // end ST7036
ligeiro13 0:ebea19a646c3 2858
ligeiro13 0:ebea19a646c3 2859 case SSD1803_3V3:
ligeiro13 0:ebea19a646c3 2860 // case SSD1803_5V:
ligeiro13 0:ebea19a646c3 2861 _writeCommand(0x20 | _function | 0x01); // Set function, 0 0 1 DL N DH RE(0) IS
ligeiro13 0:ebea19a646c3 2862 // Select Instruction Set 1
ligeiro13 0:ebea19a646c3 2863 _writeCommand(0x40 | (idx & 0x0F)); // Set Icon Address, mask Address to valid range (Instr Set = 1)
ligeiro13 0:ebea19a646c3 2864 _writeData(data); // Set Icon pattern (Instr Set = 1)
ligeiro13 0:ebea19a646c3 2865
ligeiro13 0:ebea19a646c3 2866 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS
ligeiro13 0:ebea19a646c3 2867 // Select IS=0
ligeiro13 0:ebea19a646c3 2868 break; // end SSD1803
ligeiro13 0:ebea19a646c3 2869
ligeiro13 0:ebea19a646c3 2870 case PCF2103_3V3:
ligeiro13 0:ebea19a646c3 2871 case PCF2113_3V3:
ligeiro13 0:ebea19a646c3 2872 case PCF2119_3V3:
ligeiro13 0:ebea19a646c3 2873 case PCF2119R_3V3:
ligeiro13 0:ebea19a646c3 2874 // Store UDC/Icon pattern for PCF2103 and PCF2113:
ligeiro13 0:ebea19a646c3 2875 // 3 x 8 rows x 5 bits = 120 bits for Normal pattern (UDC 0..2) and
ligeiro13 0:ebea19a646c3 2876 // 3 x 8 rows x 5 bits = 120 bits for Blink pattern (UDC 4..6)
ligeiro13 0:ebea19a646c3 2877 // Store UDC/Icon pattern for PCF2119:
ligeiro13 0:ebea19a646c3 2878 // 4 x 8 rows x 5 bits = 160 bits for Normal pattern (UDC 0..3) and
ligeiro13 0:ebea19a646c3 2879 // 4 x 8 rows x 5 bits = 160 bits for Blink pattern (UDC 4..7)
ligeiro13 0:ebea19a646c3 2880 _writeCommand(0x40 | (idx & 0x3F)); //Set CG-RAM address, 8 sequential locations needed per UDC
ligeiro13 0:ebea19a646c3 2881 _writeData(data); // Set Icon pattern (Instr Set = 1)
ligeiro13 0:ebea19a646c3 2882 break; // case PCF2103_3V3 Controller
ligeiro13 0:ebea19a646c3 2883
ligeiro13 0:ebea19a646c3 2884 default:
ligeiro13 0:ebea19a646c3 2885 break; // end default
ligeiro13 0:ebea19a646c3 2886 } // end switch _ctrl
ligeiro13 0:ebea19a646c3 2887
ligeiro13 0:ebea19a646c3 2888 //Select DD RAM again for current LCD controller and restore the addresspointer
ligeiro13 0:ebea19a646c3 2889 int addr = getAddress(_column, _row);
ligeiro13 0:ebea19a646c3 2890 _writeCommand(0x80 | addr);
ligeiro13 0:ebea19a646c3 2891
ligeiro13 0:ebea19a646c3 2892 } // end setIcon()
ligeiro13 0:ebea19a646c3 2893
ligeiro13 0:ebea19a646c3 2894 /** Clear Icons
ligeiro13 0:ebea19a646c3 2895 *
ligeiro13 0:ebea19a646c3 2896 * @param none
ligeiro13 0:ebea19a646c3 2897 * @return none
ligeiro13 0:ebea19a646c3 2898 */
ligeiro13 0:ebea19a646c3 2899 //@TODO Add support for 40x4 dual controller
ligeiro13 0:ebea19a646c3 2900 void TextLCD_Base::clrIcon() {
ligeiro13 0:ebea19a646c3 2901 // Icons are defined by a byte bitpattern. The P0..P5 form the Icon pattern for KS0073, and P0..P4 for KS0078
ligeiro13 0:ebea19a646c3 2902 // P7 P6 P5 P4 P3 P2 P1 P0
ligeiro13 0:ebea19a646c3 2903 // 0 B1 B0 0 0 0 0 0 0
ligeiro13 0:ebea19a646c3 2904 // 1 B1 B0 0 0 0 0 0 0
ligeiro13 0:ebea19a646c3 2905 // .............
ligeiro13 0:ebea19a646c3 2906 // 15 B1 B0 0 0 0 0 0 0
ligeiro13 0:ebea19a646c3 2907 //
ligeiro13 0:ebea19a646c3 2908 // Bit 6 and Bit 7 in the pattern will control the blinking mode when Blink is enabled through BE.
ligeiro13 0:ebea19a646c3 2909 // B1 B0 Mode
ligeiro13 0:ebea19a646c3 2910 // 0 0 No Blinking for this icon row
ligeiro13 0:ebea19a646c3 2911 // 0 1 Enabled pixels in P5 will blink
ligeiro13 0:ebea19a646c3 2912 // 1 x Enabled pixels in P0..P5 will blink
ligeiro13 0:ebea19a646c3 2913 //
ligeiro13 0:ebea19a646c3 2914 // Note: the PCF2103 and PCF2113 use UDCs to set Icons
ligeiro13 0:ebea19a646c3 2915 // 3 x 8 rows x 5 bits = 120 bits Icons for Normal pattern (UDC 0..2) and
ligeiro13 0:ebea19a646c3 2916 // 3 x 8 rows x 5 bits = 120 bits Icons for Blink pattern (UDC 4..6)
ligeiro13 0:ebea19a646c3 2917 // Note: the PCF2119 uses UDCs to set Icons
ligeiro13 0:ebea19a646c3 2918 // 4 x 8 rows x 5 bits = 160 bits Icons for Normal pattern (UDC 0..3) and
ligeiro13 0:ebea19a646c3 2919 // 4 x 8 rows x 5 bits = 160 bits Icons for Blink pattern (UDC 4..7)
ligeiro13 0:ebea19a646c3 2920 int idx;
ligeiro13 0:ebea19a646c3 2921
ligeiro13 0:ebea19a646c3 2922 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 2923 case KS0073:
ligeiro13 0:ebea19a646c3 2924 case KS0078:
ligeiro13 0:ebea19a646c3 2925 _writeCommand(0x20 | _function_1); // Set function, 0 0 1 DL N RE(1) BE LP
ligeiro13 0:ebea19a646c3 2926 // Select Extended Instruction Set
ligeiro13 0:ebea19a646c3 2927 for (idx=0; idx<16; idx++) {
ligeiro13 0:ebea19a646c3 2928 _writeCommand(0x40 | idx); // Set Icon Address, mask Address to valid range (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2929 _writeData(0x00); // Clear Icon pattern (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2930 }
ligeiro13 0:ebea19a646c3 2931 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N RE(0) DH REV Select Std Instruction Set
ligeiro13 0:ebea19a646c3 2932 // Select Std Instr set
ligeiro13 0:ebea19a646c3 2933 break; // end KS0073, KS0078
ligeiro13 0:ebea19a646c3 2934
ligeiro13 0:ebea19a646c3 2935 case ST7032_3V3:
ligeiro13 0:ebea19a646c3 2936 case ST7032_5V:
ligeiro13 0:ebea19a646c3 2937 case SPLC792A_3V3:
ligeiro13 0:ebea19a646c3 2938 _writeCommand(0x20 | _function | 0x01); // Set function, 0 0 1 DL N F 0 IS=1 Select Instr Set = 1
ligeiro13 0:ebea19a646c3 2939
ligeiro13 0:ebea19a646c3 2940 for (idx=0; idx<16; idx++) {
ligeiro13 0:ebea19a646c3 2941 _writeCommand(0x40 | idx); // Set Icon Address, mask Address to valid range (Instr Set 1)
ligeiro13 0:ebea19a646c3 2942 _writeData(0x00); // Clear Icon pattern (Instr Set 1)
ligeiro13 0:ebea19a646c3 2943 }
ligeiro13 0:ebea19a646c3 2944
ligeiro13 0:ebea19a646c3 2945 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N RE(0) DH REV Select Instruction Set 0
ligeiro13 0:ebea19a646c3 2946 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 2947 break; // end ST7032
ligeiro13 0:ebea19a646c3 2948
ligeiro13 0:ebea19a646c3 2949 case ST7036_3V3:
ligeiro13 0:ebea19a646c3 2950 case ST7036_5V:
ligeiro13 0:ebea19a646c3 2951 _writeCommand(0x20 | _function | 0x01); // Set function, 0 0 1 DL N DH IS2,IS1 = 01 (Select Instr Set = 1)
ligeiro13 0:ebea19a646c3 2952
ligeiro13 0:ebea19a646c3 2953 for (idx=0; idx<16; idx++) {
ligeiro13 0:ebea19a646c3 2954 _writeCommand(0x40 | idx); // Set Icon Address, mask Address to valid range (Instr Set 1)
ligeiro13 0:ebea19a646c3 2955 _writeData(0x00); // Clear Icon pattern (Instr Set 1)
ligeiro13 0:ebea19a646c3 2956 }
ligeiro13 0:ebea19a646c3 2957
ligeiro13 0:ebea19a646c3 2958 _writeCommand(0x20 | _function); // Set function, IS2,IS1 = 00 (Select Instr Set = 0)
ligeiro13 0:ebea19a646c3 2959 // Select Std Instr set, Select IS=0
ligeiro13 0:ebea19a646c3 2960 break; // end ST7036
ligeiro13 0:ebea19a646c3 2961
ligeiro13 0:ebea19a646c3 2962 case SSD1803_3V3:
ligeiro13 0:ebea19a646c3 2963 // case SSD1803_5V:
ligeiro13 0:ebea19a646c3 2964 _writeCommand(0x20 | _function | 0x01); // Set function, 0 0 1 DL N DH RE(0) IS
ligeiro13 0:ebea19a646c3 2965 // Select Instruction Set 1
ligeiro13 0:ebea19a646c3 2966 for (idx=0; idx<16; idx++) {
ligeiro13 0:ebea19a646c3 2967 _writeCommand(0x40 | idx); // Set Icon Address, mask Address to valid range (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2968 _writeData(0x00); // Clear Icon pattern (Ext Instr Set)
ligeiro13 0:ebea19a646c3 2969 }
ligeiro13 0:ebea19a646c3 2970 _writeCommand(0x20 | _function); // Set function, 0 0 1 DL N DH RE(0) IS
ligeiro13 0:ebea19a646c3 2971 // Select IS=0
ligeiro13 0:ebea19a646c3 2972 break; // end SSD1803
ligeiro13 0:ebea19a646c3 2973
ligeiro13 0:ebea19a646c3 2974 case PCF2103_3V3:
ligeiro13 0:ebea19a646c3 2975 case PCF2113_3V3:
ligeiro13 0:ebea19a646c3 2976 // PCF2103 and PCF2113 use part of the UDC RAM to control Icons
ligeiro13 0:ebea19a646c3 2977 // Select CG RAM
ligeiro13 0:ebea19a646c3 2978
ligeiro13 0:ebea19a646c3 2979 _writeCommand(0x40 | (0 * 8)); //Set CG-RAM address, 8 sequential locations needed per UDC
ligeiro13 0:ebea19a646c3 2980 // Store UDC/Icon pattern:
ligeiro13 0:ebea19a646c3 2981 // 3 x 8 rows x 5 bits = 120 bits for Normal pattern (UDC 0..2) and
ligeiro13 0:ebea19a646c3 2982 for (int i=0; i<(3 * 8); i++) {
ligeiro13 0:ebea19a646c3 2983 // _writeData(0x1F); // All On
ligeiro13 0:ebea19a646c3 2984 _writeData(0x00); // All Off
ligeiro13 0:ebea19a646c3 2985 }
ligeiro13 0:ebea19a646c3 2986
ligeiro13 0:ebea19a646c3 2987 _writeCommand(0x40 | (4 * 8)); //Set CG-RAM address, 8 sequential locations needed per UDC
ligeiro13 0:ebea19a646c3 2988 // 3 x 8 rows x 5 bits = 120 bits for Blink pattern (UDC 4..6)
ligeiro13 0:ebea19a646c3 2989 for (int i=0; i<(3 * 8); i++) {
ligeiro13 0:ebea19a646c3 2990 // _writeData(0x1F); // All On
ligeiro13 0:ebea19a646c3 2991 _writeData(0x00); // All Off
ligeiro13 0:ebea19a646c3 2992 }
ligeiro13 0:ebea19a646c3 2993 break; // case PCF2103_3V3 Controller
ligeiro13 0:ebea19a646c3 2994
ligeiro13 0:ebea19a646c3 2995 case PCF2119_3V3:
ligeiro13 0:ebea19a646c3 2996 case PCF2119R_3V3:
ligeiro13 0:ebea19a646c3 2997 // PCF2119 uses part of the UDC RAM to control Icons
ligeiro13 0:ebea19a646c3 2998 // Select CG RAM
ligeiro13 0:ebea19a646c3 2999
ligeiro13 0:ebea19a646c3 3000 _writeCommand(0x40 | (0 * 8)); //Set CG-RAM address, 8 sequential locations needed per UDC
ligeiro13 0:ebea19a646c3 3001 // Store UDC/Icon pattern:
ligeiro13 0:ebea19a646c3 3002 // 4 x 8 rows x 5 bits = 160 bits for Normal pattern (UDC 0..3) and
ligeiro13 0:ebea19a646c3 3003 for (int i=0; i<(4 * 8); i++) {
ligeiro13 0:ebea19a646c3 3004 // _writeData(0x1F); // All On
ligeiro13 0:ebea19a646c3 3005 _writeData(0x00); // All Off
ligeiro13 0:ebea19a646c3 3006 }
ligeiro13 0:ebea19a646c3 3007
ligeiro13 0:ebea19a646c3 3008 _writeCommand(0x40 | (4 * 8)); //Set CG-RAM address, 8 sequential locations needed per UDC
ligeiro13 0:ebea19a646c3 3009 // 4 x 8 rows x 5 bits = 160 bits for Blink pattern (UDC 4..7)
ligeiro13 0:ebea19a646c3 3010 for (int i=0; i<(4 * 8); i++) {
ligeiro13 0:ebea19a646c3 3011 // _writeData(0x1F); // All On
ligeiro13 0:ebea19a646c3 3012 _writeData(0x00); // All Off
ligeiro13 0:ebea19a646c3 3013 }
ligeiro13 0:ebea19a646c3 3014 break; // case PCF2119_3V3 Controller
ligeiro13 0:ebea19a646c3 3015
ligeiro13 0:ebea19a646c3 3016 default:
ligeiro13 0:ebea19a646c3 3017 break; // end default
ligeiro13 0:ebea19a646c3 3018 } // end switch _ctrl
ligeiro13 0:ebea19a646c3 3019
ligeiro13 0:ebea19a646c3 3020 //Select DD RAM again for current LCD controller and restore the addresspointer
ligeiro13 0:ebea19a646c3 3021 int addr = getAddress(_column, _row);
ligeiro13 0:ebea19a646c3 3022 _writeCommand(0x80 | addr);
ligeiro13 0:ebea19a646c3 3023 } //end clrIcon()
ligeiro13 0:ebea19a646c3 3024 #endif
ligeiro13 0:ebea19a646c3 3025
ligeiro13 0:ebea19a646c3 3026 #if(LCD_INVERT == 1)
ligeiro13 0:ebea19a646c3 3027 /** Set Invert
ligeiro13 0:ebea19a646c3 3028 * setInvert method is supported by some compatible devices (eg KS0073) to swap between black and white
ligeiro13 0:ebea19a646c3 3029 *
ligeiro13 0:ebea19a646c3 3030 * @param bool invertOn Invert on/off
ligeiro13 0:ebea19a646c3 3031 * @return none
ligeiro13 0:ebea19a646c3 3032 */
ligeiro13 0:ebea19a646c3 3033 //@TODO Add support for 40x4 dual controller
ligeiro13 0:ebea19a646c3 3034 void TextLCD_Base::setInvert(bool invertOn) {
ligeiro13 0:ebea19a646c3 3035
ligeiro13 0:ebea19a646c3 3036 if (invertOn) {
ligeiro13 0:ebea19a646c3 3037 // Controllers that support Invert
ligeiro13 0:ebea19a646c3 3038 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 3039 case KS0073:
ligeiro13 0:ebea19a646c3 3040 case KS0078:
ligeiro13 0:ebea19a646c3 3041 _function = _function | 0x01; // Enable Invert
ligeiro13 0:ebea19a646c3 3042 _writeCommand(0x20 | _function); // Activate Invert (Std Instr Set)
ligeiro13 0:ebea19a646c3 3043 break;
ligeiro13 0:ebea19a646c3 3044 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 3045 // case SSD1803_5V :
ligeiro13 0:ebea19a646c3 3046 case US2066_3V3:
ligeiro13 0:ebea19a646c3 3047 // case USS2066_5V:
ligeiro13 0:ebea19a646c3 3048 _function_1 = _function_1 | 0x01; // Enable Invert
ligeiro13 0:ebea19a646c3 3049 // Set function, 0 0 1 DL N BE RE(1) REV (SSD1803)
ligeiro13 0:ebea19a646c3 3050 // Set function, 0 0 1 X N BE RE(1) REV (US2066)
ligeiro13 0:ebea19a646c3 3051 _writeCommand(0x20 | _function_1); // Activate Invert (Ext Instr Set)
ligeiro13 0:ebea19a646c3 3052 _writeCommand(0x20 | _function); // Return to Std Instr Set
ligeiro13 0:ebea19a646c3 3053 break;
ligeiro13 0:ebea19a646c3 3054 default:
ligeiro13 0:ebea19a646c3 3055 //Unsupported feature for other controllers
ligeiro13 0:ebea19a646c3 3056 break;
ligeiro13 0:ebea19a646c3 3057 } // end switch
ligeiro13 0:ebea19a646c3 3058 }
ligeiro13 0:ebea19a646c3 3059 else {
ligeiro13 0:ebea19a646c3 3060 // Controllers that support Invert
ligeiro13 0:ebea19a646c3 3061 switch (_ctrl) {
ligeiro13 0:ebea19a646c3 3062 case KS0073:
ligeiro13 0:ebea19a646c3 3063 case KS0078:
ligeiro13 0:ebea19a646c3 3064 _function = _function & ~0x01; // Disable Invert
ligeiro13 0:ebea19a646c3 3065 _writeCommand(0x20 | _function); // Disable Invert (Std Instr Set)
ligeiro13 0:ebea19a646c3 3066 break;
ligeiro13 0:ebea19a646c3 3067 case SSD1803_3V3 :
ligeiro13 0:ebea19a646c3 3068 // case SSD1803_5V :
ligeiro13 0:ebea19a646c3 3069 case US2066_3V3:
ligeiro13 0:ebea19a646c3 3070 // case USS2066_5V:
ligeiro13 0:ebea19a646c3 3071 _function_1 = _function_1 & ~0x01; // Disable Invert
ligeiro13 0:ebea19a646c3 3072 // Set function, 0 0 1 DL N BE RE(1) REV (SSD1803)
ligeiro13 0:ebea19a646c3 3073 // Set function, 0 0 1 X N BE RE(1) REV (US2066)
ligeiro13 0:ebea19a646c3 3074 _writeCommand(0x20 | _function_1); // Activate Invert (Ext Instr Set)
ligeiro13 0:ebea19a646c3 3075 _writeCommand(0x20 | _function); // Return to Std Instr Set
ligeiro13 0:ebea19a646c3 3076 break;
ligeiro13 0:ebea19a646c3 3077
ligeiro13 0:ebea19a646c3 3078 default:
ligeiro13 0:ebea19a646c3 3079 //Unsupported feature for other controllers
ligeiro13 0:ebea19a646c3 3080 break;
ligeiro13 0:ebea19a646c3 3081 } // end switch
ligeiro13 0:ebea19a646c3 3082 }
ligeiro13 0:ebea19a646c3 3083 } // end setInvert()
ligeiro13 0:ebea19a646c3 3084 #endif
ligeiro13 0:ebea19a646c3 3085
ligeiro13 0:ebea19a646c3 3086 //--------- End TextLCD_Base -----------
ligeiro13 0:ebea19a646c3 3087
ligeiro13 0:ebea19a646c3 3088
ligeiro13 0:ebea19a646c3 3089 //--------- Start TextLCD Bus -----------
ligeiro13 0:ebea19a646c3 3090
ligeiro13 0:ebea19a646c3 3091 /* Create a TextLCD interface for using regular mbed pins
ligeiro13 0:ebea19a646c3 3092 *
ligeiro13 0:ebea19a646c3 3093 * @param rs Instruction/data control line
ligeiro13 0:ebea19a646c3 3094 * @param e Enable line (clock)
ligeiro13 0:ebea19a646c3 3095 * @param d4-d7 Data lines for using as a 4-bit interface
ligeiro13 0:ebea19a646c3 3096 * @param type Sets the panel size/addressing mode (default = LCD16x2)
ligeiro13 0:ebea19a646c3 3097 * @param bl Backlight control line (optional, default = NC)
ligeiro13 0:ebea19a646c3 3098 * @param e2 Enable2 line (clock for second controller, LCD40x4 only)
ligeiro13 0:ebea19a646c3 3099 * @param ctrl LCD controller (default = HD44780)
ligeiro13 0:ebea19a646c3 3100 */
ligeiro13 0:ebea19a646c3 3101 TextLCD::TextLCD(PinName rs, PinName e,
ligeiro13 0:ebea19a646c3 3102 PinName d4, PinName d5, PinName d6, PinName d7,
ligeiro13 0:ebea19a646c3 3103 LCDType type, PinName bl, PinName e2, LCDCtrl ctrl) :
ligeiro13 0:ebea19a646c3 3104 TextLCD_Base(type, ctrl),
ligeiro13 0:ebea19a646c3 3105 _rs(rs), _e(e), _d(d4, d5, d6, d7) {
ligeiro13 0:ebea19a646c3 3106
ligeiro13 0:ebea19a646c3 3107 // The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
ligeiro13 0:ebea19a646c3 3108 if (bl != NC) {
ligeiro13 0:ebea19a646c3 3109 _bl = new DigitalOut(bl); //Construct new pin
ligeiro13 0:ebea19a646c3 3110 _bl->write(0); //Deactivate
ligeiro13 0:ebea19a646c3 3111 }
ligeiro13 0:ebea19a646c3 3112 else {
ligeiro13 0:ebea19a646c3 3113 // No Hardware Backlight pin
ligeiro13 0:ebea19a646c3 3114 _bl = NULL; //Construct dummy pin
ligeiro13 0:ebea19a646c3 3115 }
ligeiro13 0:ebea19a646c3 3116
ligeiro13 0:ebea19a646c3 3117 // The hardware Enable2 pin is only needed for LCD40x4. Test and make sure whether it exists or not to prevent illegal access.
ligeiro13 0:ebea19a646c3 3118 if (e2 != NC) {
ligeiro13 0:ebea19a646c3 3119 _e2 = new DigitalOut(e2); //Construct new pin
ligeiro13 0:ebea19a646c3 3120 _e2->write(0); //Deactivate
ligeiro13 0:ebea19a646c3 3121 }
ligeiro13 0:ebea19a646c3 3122 else {
ligeiro13 0:ebea19a646c3 3123 // No Hardware Enable pin
ligeiro13 0:ebea19a646c3 3124 _e2 = NULL; //Construct dummy pin
ligeiro13 0:ebea19a646c3 3125 }
ligeiro13 0:ebea19a646c3 3126
ligeiro13 0:ebea19a646c3 3127 _init(_LCD_DL_4); // Set Datalength to 4 bit for mbed bus interfaces
ligeiro13 0:ebea19a646c3 3128 }
ligeiro13 0:ebea19a646c3 3129
ligeiro13 0:ebea19a646c3 3130 /** Destruct a TextLCD interface for using regular mbed pins
ligeiro13 0:ebea19a646c3 3131 *
ligeiro13 0:ebea19a646c3 3132 * @param none
ligeiro13 0:ebea19a646c3 3133 * @return none
ligeiro13 0:ebea19a646c3 3134 */
ligeiro13 0:ebea19a646c3 3135 TextLCD::~TextLCD() {
ligeiro13 0:ebea19a646c3 3136 if (_bl != NULL) {delete _bl;} // BL pin
ligeiro13 0:ebea19a646c3 3137 if (_e2 != NULL) {delete _e2;} // E2 pin
ligeiro13 0:ebea19a646c3 3138 }
ligeiro13 0:ebea19a646c3 3139
ligeiro13 0:ebea19a646c3 3140 /** Set E pin (or E2 pin)
ligeiro13 0:ebea19a646c3 3141 * Used for mbed pins, I2C bus expander or SPI shiftregister
ligeiro13 0:ebea19a646c3 3142 * Default PinName value for E2 is NC, must be used as pointer to avoid issues with mbed lib and DigitalOut pins
ligeiro13 0:ebea19a646c3 3143 * @param value true or false
ligeiro13 0:ebea19a646c3 3144 * @return none
ligeiro13 0:ebea19a646c3 3145 */
ligeiro13 0:ebea19a646c3 3146 void TextLCD::_setEnable(bool value) {
ligeiro13 0:ebea19a646c3 3147
ligeiro13 0:ebea19a646c3 3148 if(_ctrl_idx==_LCDCtrl_0) {
ligeiro13 0:ebea19a646c3 3149 if (value) {
ligeiro13 0:ebea19a646c3 3150 _e = 1; // Set E bit
ligeiro13 0:ebea19a646c3 3151 }
ligeiro13 0:ebea19a646c3 3152 else {
ligeiro13 0:ebea19a646c3 3153 _e = 0; // Reset E bit
ligeiro13 0:ebea19a646c3 3154 }
ligeiro13 0:ebea19a646c3 3155 }
ligeiro13 0:ebea19a646c3 3156 else {
ligeiro13 0:ebea19a646c3 3157 if (value) {
ligeiro13 0:ebea19a646c3 3158 if (_e2 != NULL) {_e2->write(1);} //Set E2 bit
ligeiro13 0:ebea19a646c3 3159 }
ligeiro13 0:ebea19a646c3 3160 else {
ligeiro13 0:ebea19a646c3 3161 if (_e2 != NULL) {_e2->write(0);} //Reset E2 bit
ligeiro13 0:ebea19a646c3 3162 }
ligeiro13 0:ebea19a646c3 3163 }
ligeiro13 0:ebea19a646c3 3164 }
ligeiro13 0:ebea19a646c3 3165
ligeiro13 0:ebea19a646c3 3166 // Set RS pin
ligeiro13 0:ebea19a646c3 3167 // Used for mbed pins, I2C bus expander or SPI shiftregister
ligeiro13 0:ebea19a646c3 3168 void TextLCD::_setRS(bool value) {
ligeiro13 0:ebea19a646c3 3169
ligeiro13 0:ebea19a646c3 3170 if (value) {
ligeiro13 0:ebea19a646c3 3171 _rs = 1; // Set RS bit
ligeiro13 0:ebea19a646c3 3172 }
ligeiro13 0:ebea19a646c3 3173 else {
ligeiro13 0:ebea19a646c3 3174 _rs = 0; // Reset RS bit
ligeiro13 0:ebea19a646c3 3175 }
ligeiro13 0:ebea19a646c3 3176 }
ligeiro13 0:ebea19a646c3 3177
ligeiro13 0:ebea19a646c3 3178 /** Set BL pin
ligeiro13 0:ebea19a646c3 3179 * Used for mbed pins, I2C bus expander or SPI shiftregister
ligeiro13 0:ebea19a646c3 3180 * Default PinName value is NC, must be used as pointer to avoid issues with mbed lib and DigitalOut pins
ligeiro13 0:ebea19a646c3 3181 * @param value true or false
ligeiro13 0:ebea19a646c3 3182 * @return none
ligeiro13 0:ebea19a646c3 3183 */
ligeiro13 0:ebea19a646c3 3184 void TextLCD::_setBL(bool value) {
ligeiro13 0:ebea19a646c3 3185
ligeiro13 0:ebea19a646c3 3186 if (value) {
ligeiro13 0:ebea19a646c3 3187 if (_bl != NULL) {_bl->write(1);} //Set BL bit
ligeiro13 0:ebea19a646c3 3188 }
ligeiro13 0:ebea19a646c3 3189 else {
ligeiro13 0:ebea19a646c3 3190 if (_bl != NULL) {_bl->write(0);} //Reset BL bit
ligeiro13 0:ebea19a646c3 3191 }
ligeiro13 0:ebea19a646c3 3192 }
ligeiro13 0:ebea19a646c3 3193
ligeiro13 0:ebea19a646c3 3194 // Place the 4bit data on the databus
ligeiro13 0:ebea19a646c3 3195 // Used for mbed pins, I2C bus expander or SPI shifregister
ligeiro13 0:ebea19a646c3 3196 void TextLCD::_setData(int value) {
ligeiro13 0:ebea19a646c3 3197 _d = value & 0x0F; // Write Databits
ligeiro13 0:ebea19a646c3 3198 }
ligeiro13 0:ebea19a646c3 3199
ligeiro13 0:ebea19a646c3 3200 //----------- End TextLCD ---------------
ligeiro13 0:ebea19a646c3 3201
ligeiro13 0:ebea19a646c3 3202
ligeiro13 0:ebea19a646c3 3203 //--------- Start TextLCD_I2C -----------
ligeiro13 0:ebea19a646c3 3204 #if(LCD_I2C == 1) /* I2C Expander PCF8574/MCP23008 */
ligeiro13 0:ebea19a646c3 3205 /** Create a TextLCD interface using an I2C PC8574 (or PCF8574A) or MCP23008 portexpander
ligeiro13 0:ebea19a646c3 3206 *
ligeiro13 0:ebea19a646c3 3207 * @param i2c I2C Bus
ligeiro13 0:ebea19a646c3 3208 * @param deviceAddress I2C slave address (PCF8574, PCF8574A or MCP23008, default = 0x40)
ligeiro13 0:ebea19a646c3 3209 * @param type Sets the panel size/addressing mode (default = LCD16x2)
ligeiro13 0:ebea19a646c3 3210 * @param ctrl LCD controller (default = HD44780)
ligeiro13 0:ebea19a646c3 3211 */
ligeiro13 0:ebea19a646c3 3212 TextLCD_I2C::TextLCD_I2C(I2C *i2c, char deviceAddress, LCDType type, LCDCtrl ctrl) :
ligeiro13 0:ebea19a646c3 3213 TextLCD_Base(type, ctrl),
ligeiro13 0:ebea19a646c3 3214 _i2c(i2c){
ligeiro13 0:ebea19a646c3 3215
ligeiro13 0:ebea19a646c3 3216 _slaveAddress = deviceAddress & 0xFE;
ligeiro13 0:ebea19a646c3 3217
ligeiro13 0:ebea19a646c3 3218 // Setup the I2C bus
ligeiro13 0:ebea19a646c3 3219 // The max bitrate for PCF8574 is 100kbit, the max bitrate for MCP23008 is 400kbit,
ligeiro13 0:ebea19a646c3 3220 _i2c->frequency(100000);
ligeiro13 0:ebea19a646c3 3221
ligeiro13 0:ebea19a646c3 3222 #if (MCP23008==1)
ligeiro13 0:ebea19a646c3 3223 // MCP23008 portexpander Init
ligeiro13 0:ebea19a646c3 3224 _writeRegister(IODIR, 0x00); // All pins are outputs
ligeiro13 0:ebea19a646c3 3225 _writeRegister(IPOL, 0x00); // No reverse polarity on inputs
ligeiro13 0:ebea19a646c3 3226 _writeRegister(GPINTEN, 0x00); // No interrupt on change of input pins
ligeiro13 0:ebea19a646c3 3227 _writeRegister(DEFVAL, 0x00); // Default value to compare against for interrupts
ligeiro13 0:ebea19a646c3 3228 _writeRegister(INTCON, 0x00); // No interrupt on changes, compare against previous pin value
ligeiro13 0:ebea19a646c3 3229 _writeRegister(IOCON, 0x20); // b1=0 - Interrupt polarity active low
ligeiro13 0:ebea19a646c3 3230 // b2=0 - Interrupt pin active driver output
ligeiro13 0:ebea19a646c3 3231 // b4=0 - Slew rate enable on SDA
ligeiro13 0:ebea19a646c3 3232 // b5=0 - Auto-increment on registeraddress
ligeiro13 0:ebea19a646c3 3233 // b5=1 - No auto-increment on registeraddress => needed for performance improved I2C expander mode
ligeiro13 0:ebea19a646c3 3234 _writeRegister(GPPU, 0x00); // No Pullup
ligeiro13 0:ebea19a646c3 3235 // INTF // Interrupt flags read (Read-Only)
ligeiro13 0:ebea19a646c3 3236 // INTCAP // Captured inputpins at time of interrupt (Read-Only)
ligeiro13 0:ebea19a646c3 3237 // _writeRegister(GPIO, 0x00); // Output/Input pins
ligeiro13 0:ebea19a646c3 3238 // _writeRegister(OLAT, 0x00); // Output Latch
ligeiro13 0:ebea19a646c3 3239
ligeiro13 0:ebea19a646c3 3240 // Init the portexpander bus
ligeiro13 0:ebea19a646c3 3241 _lcd_bus = LCD_BUS_I2C_DEF;
ligeiro13 0:ebea19a646c3 3242
ligeiro13 0:ebea19a646c3 3243 // write the new data to the portexpander
ligeiro13 0:ebea19a646c3 3244 _writeRegister(GPIO, _lcd_bus);
ligeiro13 0:ebea19a646c3 3245 #else
ligeiro13 0:ebea19a646c3 3246 // PCF8574 of PCF8574A portexpander
ligeiro13 0:ebea19a646c3 3247
ligeiro13 0:ebea19a646c3 3248 // Init the portexpander bus
ligeiro13 0:ebea19a646c3 3249 _lcd_bus = LCD_BUS_I2C_DEF;
ligeiro13 0:ebea19a646c3 3250
ligeiro13 0:ebea19a646c3 3251 // write the new data to the portexpander
ligeiro13 0:ebea19a646c3 3252 _i2c->write(_slaveAddress, &_lcd_bus, 1);
ligeiro13 0:ebea19a646c3 3253 #endif
ligeiro13 0:ebea19a646c3 3254
ligeiro13 0:ebea19a646c3 3255 _init(_LCD_DL_4); // Set Datalength to 4 bit for all serial expander interfaces
ligeiro13 0:ebea19a646c3 3256 }
ligeiro13 0:ebea19a646c3 3257
ligeiro13 0:ebea19a646c3 3258 // Set E bit (or E2 bit) in the databus shadowvalue
ligeiro13 0:ebea19a646c3 3259 // Used for mbed I2C bus expander
ligeiro13 0:ebea19a646c3 3260 void TextLCD_I2C::_setEnableBit(bool value) {
ligeiro13 0:ebea19a646c3 3261
ligeiro13 0:ebea19a646c3 3262 #if (LCD_TWO_CTRL == 1)
ligeiro13 0:ebea19a646c3 3263 if(_ctrl_idx==_LCDCtrl_0) {
ligeiro13 0:ebea19a646c3 3264 if (value) {
ligeiro13 0:ebea19a646c3 3265 _lcd_bus |= LCD_BUS_I2C_E; // Set E bit
ligeiro13 0:ebea19a646c3 3266 }
ligeiro13 0:ebea19a646c3 3267 else {
ligeiro13 0:ebea19a646c3 3268 _lcd_bus &= ~LCD_BUS_I2C_E; // Reset E bit
ligeiro13 0:ebea19a646c3 3269 }
ligeiro13 0:ebea19a646c3 3270 }
ligeiro13 0:ebea19a646c3 3271 else {
ligeiro13 0:ebea19a646c3 3272 if (value) {
ligeiro13 0:ebea19a646c3 3273 _lcd_bus |= LCD_BUS_I2C_E2; // Set E2 bit
ligeiro13 0:ebea19a646c3 3274 }
ligeiro13 0:ebea19a646c3 3275 else {
ligeiro13 0:ebea19a646c3 3276 _lcd_bus &= ~LCD_BUS_I2C_E2; // Reset E2bit
ligeiro13 0:ebea19a646c3 3277 }
ligeiro13 0:ebea19a646c3 3278 }
ligeiro13 0:ebea19a646c3 3279 #else
ligeiro13 0:ebea19a646c3 3280 // Support only one controller
ligeiro13 0:ebea19a646c3 3281 if (value) {
ligeiro13 0:ebea19a646c3 3282 _lcd_bus |= LCD_BUS_I2C_E; // Set E bit
ligeiro13 0:ebea19a646c3 3283 }
ligeiro13 0:ebea19a646c3 3284 else {
ligeiro13 0:ebea19a646c3 3285 _lcd_bus &= ~LCD_BUS_I2C_E; // Reset E bit
ligeiro13 0:ebea19a646c3 3286 }
ligeiro13 0:ebea19a646c3 3287
ligeiro13 0:ebea19a646c3 3288 #endif
ligeiro13 0:ebea19a646c3 3289 }
ligeiro13 0:ebea19a646c3 3290
ligeiro13 0:ebea19a646c3 3291 // Set E pin (or E2 pin)
ligeiro13 0:ebea19a646c3 3292 // Used for mbed pins, I2C bus expander or SPI shiftregister
ligeiro13 0:ebea19a646c3 3293 void TextLCD_I2C::_setEnable(bool value) {
ligeiro13 0:ebea19a646c3 3294
ligeiro13 0:ebea19a646c3 3295 // Place the E or E2 bit data on the databus shadowvalue
ligeiro13 0:ebea19a646c3 3296 _setEnableBit(value);
ligeiro13 0:ebea19a646c3 3297
ligeiro13 0:ebea19a646c3 3298 #if (MCP23008==1)
ligeiro13 0:ebea19a646c3 3299 // MCP23008 portexpander
ligeiro13 0:ebea19a646c3 3300
ligeiro13 0:ebea19a646c3 3301 // write the new data to the portexpander
ligeiro13 0:ebea19a646c3 3302 _writeRegister(GPIO, _lcd_bus);
ligeiro13 0:ebea19a646c3 3303 #else
ligeiro13 0:ebea19a646c3 3304 // PCF8574 of PCF8574A portexpander
ligeiro13 0:ebea19a646c3 3305
ligeiro13 0:ebea19a646c3 3306 // write the new data to the I2C portexpander
ligeiro13 0:ebea19a646c3 3307 _i2c->write(_slaveAddress, &_lcd_bus, 1);
ligeiro13 0:ebea19a646c3 3308 #endif
ligeiro13 0:ebea19a646c3 3309 }
ligeiro13 0:ebea19a646c3 3310
ligeiro13 0:ebea19a646c3 3311
ligeiro13 0:ebea19a646c3 3312 // Set RS pin
ligeiro13 0:ebea19a646c3 3313 // Used for mbed pins, I2C bus expander or SPI shiftregister
ligeiro13 0:ebea19a646c3 3314 void TextLCD_I2C::_setRS(bool value) {
ligeiro13 0:ebea19a646c3 3315
ligeiro13 0:ebea19a646c3 3316 if (value) {
ligeiro13 0:ebea19a646c3 3317 _lcd_bus |= LCD_BUS_I2C_RS; // Set RS bit
ligeiro13 0:ebea19a646c3 3318 }
ligeiro13 0:ebea19a646c3 3319 else {
ligeiro13 0:ebea19a646c3 3320 _lcd_bus &= ~LCD_BUS_I2C_RS; // Reset RS bit
ligeiro13 0:ebea19a646c3 3321 }
ligeiro13 0:ebea19a646c3 3322
ligeiro13 0:ebea19a646c3 3323 #if (MCP23008==1)
ligeiro13 0:ebea19a646c3 3324 // MCP23008 portexpander
ligeiro13 0:ebea19a646c3 3325
ligeiro13 0:ebea19a646c3 3326 // write the new data to the portexpander
ligeiro13 0:ebea19a646c3 3327 _writeRegister(GPIO, _lcd_bus);
ligeiro13 0:ebea19a646c3 3328 #else
ligeiro13 0:ebea19a646c3 3329 // PCF8574 of PCF8574A portexpander
ligeiro13 0:ebea19a646c3 3330
ligeiro13 0:ebea19a646c3 3331 // write the new data to the I2C portexpander
ligeiro13 0:ebea19a646c3 3332 _i2c->write(_slaveAddress, &_lcd_bus, 1);
ligeiro13 0:ebea19a646c3 3333 #endif
ligeiro13 0:ebea19a646c3 3334 }
ligeiro13 0:ebea19a646c3 3335
ligeiro13 0:ebea19a646c3 3336 // Set BL pin
ligeiro13 0:ebea19a646c3 3337 // Used for mbed pins, I2C bus expander or SPI shiftregister
ligeiro13 0:ebea19a646c3 3338 void TextLCD_I2C::_setBL(bool value) {
ligeiro13 0:ebea19a646c3 3339
ligeiro13 0:ebea19a646c3 3340 if (value) {
ligeiro13 0:ebea19a646c3 3341 _lcd_bus |= LCD_BUS_I2C_BL; // Set BL bit
ligeiro13 0:ebea19a646c3 3342 }
ligeiro13 0:ebea19a646c3 3343 else {
ligeiro13 0:ebea19a646c3 3344 _lcd_bus &= ~LCD_BUS_I2C_BL; // Reset BL bit
ligeiro13 0:ebea19a646c3 3345 }
ligeiro13 0:ebea19a646c3 3346
ligeiro13 0:ebea19a646c3 3347 #if (MCP23008==1)
ligeiro13 0:ebea19a646c3 3348 // MCP23008 portexpander
ligeiro13 0:ebea19a646c3 3349
ligeiro13 0:ebea19a646c3 3350 // write the new data to the portexpander
ligeiro13 0:ebea19a646c3 3351 _writeRegister(GPIO, _lcd_bus);
ligeiro13 0:ebea19a646c3 3352 #else
ligeiro13 0:ebea19a646c3 3353 // PCF8574 of PCF8574A portexpander
ligeiro13 0:ebea19a646c3 3354
ligeiro13 0:ebea19a646c3 3355 // write the new data to the I2C portexpander
ligeiro13 0:ebea19a646c3 3356 _i2c->write(_slaveAddress, &_lcd_bus, 1);
ligeiro13 0:ebea19a646c3 3357 #endif
ligeiro13 0:ebea19a646c3 3358 }
ligeiro13 0:ebea19a646c3 3359
ligeiro13 0:ebea19a646c3 3360 #if(0)
ligeiro13 0:ebea19a646c3 3361 // New optimized v018
ligeiro13 0:ebea19a646c3 3362 // Test faster _writeByte 0.11s vs 0.27s for a 20x4 fillscreen (PCF8574), same as v018
ligeiro13 0:ebea19a646c3 3363 // Place the 4bit data in the databus shadowvalue
ligeiro13 0:ebea19a646c3 3364 // Used for mbed I2C bus expander
ligeiro13 0:ebea19a646c3 3365 const char _LCD_DATA_BITS[16] = {
ligeiro13 0:ebea19a646c3 3366 0x00,
ligeiro13 0:ebea19a646c3 3367 ( LCD_BUS_I2C_D4),
ligeiro13 0:ebea19a646c3 3368 ( LCD_BUS_I2C_D5 ),
ligeiro13 0:ebea19a646c3 3369 ( LCD_BUS_I2C_D5 | LCD_BUS_I2C_D4),
ligeiro13 0:ebea19a646c3 3370 ( LCD_BUS_I2C_D6 ),
ligeiro13 0:ebea19a646c3 3371 ( LCD_BUS_I2C_D6 | LCD_BUS_I2C_D4),
ligeiro13 0:ebea19a646c3 3372 ( LCD_BUS_I2C_D6 | LCD_BUS_I2C_D5 ),
ligeiro13 0:ebea19a646c3 3373 ( LCD_BUS_I2C_D6 | LCD_BUS_I2C_D5 | LCD_BUS_I2C_D4),
ligeiro13 0:ebea19a646c3 3374 (LCD_BUS_I2C_D7 ),
ligeiro13 0:ebea19a646c3 3375 (LCD_BUS_I2C_D7 | LCD_BUS_I2C_D4),
ligeiro13 0:ebea19a646c3 3376 (LCD_BUS_I2C_D7 | LCD_BUS_I2C_D5 ),
ligeiro13 0:ebea19a646c3 3377 (LCD_BUS_I2C_D7 | LCD_BUS_I2C_D5 | LCD_BUS_I2C_D4),
ligeiro13 0:ebea19a646c3 3378 (LCD_BUS_I2C_D7 | LCD_BUS_I2C_D6 ),
ligeiro13 0:ebea19a646c3 3379 (LCD_BUS_I2C_D7 | LCD_BUS_I2C_D6 | LCD_BUS_I2C_D4),
ligeiro13 0:ebea19a646c3 3380 (LCD_BUS_I2C_D7 | LCD_BUS_I2C_D6 | LCD_BUS_I2C_D5 ),
ligeiro13 0:ebea19a646c3 3381 (LCD_BUS_I2C_D7 | LCD_BUS_I2C_D6 | LCD_BUS_I2C_D5 | LCD_BUS_I2C_D4)
ligeiro13 0:ebea19a646c3 3382 };
ligeiro13 0:ebea19a646c3 3383 void TextLCD_I2C::_setDataBits(int value) {
ligeiro13 0:ebea19a646c3 3384
ligeiro13 0:ebea19a646c3 3385 //Clear all databits
ligeiro13 0:ebea19a646c3 3386 _lcd_bus &= ~LCD_BUS_I2C_MSK;
ligeiro13 0:ebea19a646c3 3387
ligeiro13 0:ebea19a646c3 3388 // Set bit by bit to support any mapping of expander portpins to LCD pins
ligeiro13 0:ebea19a646c3 3389 _lcd_bus |= _LCD_DATA_BITS[value & 0x0F];
ligeiro13 0:ebea19a646c3 3390 }
ligeiro13 0:ebea19a646c3 3391 #endif
ligeiro13 0:ebea19a646c3 3392
ligeiro13 0:ebea19a646c3 3393 // Test faster _writeByte 0.11s vs 0.27s for a 20x4 fillscreen (PCF8574)
ligeiro13 0:ebea19a646c3 3394 // Place the 4bit data in the databus shadowvalue
ligeiro13 0:ebea19a646c3 3395 // Used for mbed I2C bus expander
ligeiro13 0:ebea19a646c3 3396 void TextLCD_I2C::_setDataBits(int value) {
ligeiro13 0:ebea19a646c3 3397
ligeiro13 0:ebea19a646c3 3398 //Clear all databits
ligeiro13 0:ebea19a646c3 3399 _lcd_bus &= ~LCD_BUS_I2C_MSK;
ligeiro13 0:ebea19a646c3 3400
ligeiro13 0:ebea19a646c3 3401 // Set bit by bit to support any mapping of expander portpins to LCD pins
ligeiro13 0:ebea19a646c3 3402 if (value & 0x01){
ligeiro13 0:ebea19a646c3 3403 _lcd_bus |= LCD_BUS_I2C_D4; // Set Databit
ligeiro13 0:ebea19a646c3 3404 }
ligeiro13 0:ebea19a646c3 3405
ligeiro13 0:ebea19a646c3 3406 if (value & 0x02){
ligeiro13 0:ebea19a646c3 3407 _lcd_bus |= LCD_BUS_I2C_D5; // Set Databit
ligeiro13 0:ebea19a646c3 3408 }
ligeiro13 0:ebea19a646c3 3409
ligeiro13 0:ebea19a646c3 3410 if (value & 0x04) {
ligeiro13 0:ebea19a646c3 3411 _lcd_bus |= LCD_BUS_I2C_D6; // Set Databit
ligeiro13 0:ebea19a646c3 3412 }
ligeiro13 0:ebea19a646c3 3413
ligeiro13 0:ebea19a646c3 3414 if (value & 0x08) {
ligeiro13 0:ebea19a646c3 3415 _lcd_bus |= LCD_BUS_I2C_D7; // Set Databit
ligeiro13 0:ebea19a646c3 3416 }
ligeiro13 0:ebea19a646c3 3417 }
ligeiro13 0:ebea19a646c3 3418
ligeiro13 0:ebea19a646c3 3419
ligeiro13 0:ebea19a646c3 3420 // Place the 4bit data on the databus
ligeiro13 0:ebea19a646c3 3421 // Used for mbed pins, I2C bus expander or SPI shifregister
ligeiro13 0:ebea19a646c3 3422 void TextLCD_I2C::_setData(int value) {
ligeiro13 0:ebea19a646c3 3423
ligeiro13 0:ebea19a646c3 3424 // Place the 4bit data on the databus shadowvalue
ligeiro13 0:ebea19a646c3 3425 _setDataBits(value);
ligeiro13 0:ebea19a646c3 3426
ligeiro13 0:ebea19a646c3 3427 // Place the 4bit data on the databus
ligeiro13 0:ebea19a646c3 3428 #if (MCP23008==1)
ligeiro13 0:ebea19a646c3 3429 // MCP23008 portexpander
ligeiro13 0:ebea19a646c3 3430
ligeiro13 0:ebea19a646c3 3431 // write the new data to the portexpander
ligeiro13 0:ebea19a646c3 3432 _writeRegister(GPIO, _lcd_bus);
ligeiro13 0:ebea19a646c3 3433 #else
ligeiro13 0:ebea19a646c3 3434 // PCF8574 of PCF8574A portexpander
ligeiro13 0:ebea19a646c3 3435
ligeiro13 0:ebea19a646c3 3436 // write the new data to the I2C portexpander
ligeiro13 0:ebea19a646c3 3437 _i2c->write(_slaveAddress, &_lcd_bus, 1);
ligeiro13 0:ebea19a646c3 3438 #endif
ligeiro13 0:ebea19a646c3 3439 }
ligeiro13 0:ebea19a646c3 3440
ligeiro13 0:ebea19a646c3 3441 // Write data to MCP23008 I2C portexpander
ligeiro13 0:ebea19a646c3 3442 // Used for mbed I2C bus expander
ligeiro13 0:ebea19a646c3 3443 void TextLCD_I2C::_writeRegister (int reg, int value) {
ligeiro13 0:ebea19a646c3 3444 char data[] = {reg, value};
ligeiro13 0:ebea19a646c3 3445
ligeiro13 0:ebea19a646c3 3446 _i2c->write(_slaveAddress, data, 2);
ligeiro13 0:ebea19a646c3 3447 }
ligeiro13 0:ebea19a646c3 3448
ligeiro13 0:ebea19a646c3 3449 //New optimized
ligeiro13 0:ebea19a646c3 3450 //Test faster _writeByte 0.11s vs 0.27s for a 20x4 fillscreen (PCF8574)
ligeiro13 0:ebea19a646c3 3451 //Test faster _writeByte 0.14s vs 0.34s for a 20x4 fillscreen (MCP23008)
ligeiro13 0:ebea19a646c3 3452
ligeiro13 0:ebea19a646c3 3453 // Write a byte using I2C
ligeiro13 0:ebea19a646c3 3454 void TextLCD_I2C::_writeByte(int value) {
ligeiro13 0:ebea19a646c3 3455 char data[6];
ligeiro13 0:ebea19a646c3 3456
ligeiro13 0:ebea19a646c3 3457 #if (MCP23008==1)
ligeiro13 0:ebea19a646c3 3458 // MCP23008 portexpander
ligeiro13 0:ebea19a646c3 3459
ligeiro13 0:ebea19a646c3 3460 data[0] = GPIO; // set registeraddres
ligeiro13 0:ebea19a646c3 3461 // Note: auto-increment is disabled so all data will go to GPIO register
ligeiro13 0:ebea19a646c3 3462
ligeiro13 0:ebea19a646c3 3463 _setEnableBit(true); // set E
ligeiro13 0:ebea19a646c3 3464 _setDataBits(value >> 4); // set data high
ligeiro13 0:ebea19a646c3 3465 data[1] = _lcd_bus;
ligeiro13 0:ebea19a646c3 3466
ligeiro13 0:ebea19a646c3 3467 _setEnableBit(false); // clear E
ligeiro13 0:ebea19a646c3 3468 data[2] = _lcd_bus;
ligeiro13 0:ebea19a646c3 3469
ligeiro13 0:ebea19a646c3 3470 _setEnableBit(true); // set E
ligeiro13 0:ebea19a646c3 3471 _setDataBits(value); // set data low
ligeiro13 0:ebea19a646c3 3472 data[3] = _lcd_bus;
ligeiro13 0:ebea19a646c3 3473
ligeiro13 0:ebea19a646c3 3474 _setEnableBit(false); // clear E
ligeiro13 0:ebea19a646c3 3475 data[4] = _lcd_bus;
ligeiro13 0:ebea19a646c3 3476
ligeiro13 0:ebea19a646c3 3477 // write the packed data to the I2C portexpander
ligeiro13 0:ebea19a646c3 3478 _i2c->write(_slaveAddress, data, 5);
ligeiro13 0:ebea19a646c3 3479 #else
ligeiro13 0:ebea19a646c3 3480 // PCF8574 of PCF8574A portexpander
ligeiro13 0:ebea19a646c3 3481
ligeiro13 0:ebea19a646c3 3482 _setEnableBit(true); // set E
ligeiro13 0:ebea19a646c3 3483 _setDataBits(value >> 4); // set data high
ligeiro13 0:ebea19a646c3 3484 data[0] = _lcd_bus;
ligeiro13 0:ebea19a646c3 3485
ligeiro13 0:ebea19a646c3 3486 _setEnableBit(false); // clear E
ligeiro13 0:ebea19a646c3 3487 data[1] = _lcd_bus;
ligeiro13 0:ebea19a646c3 3488
ligeiro13 0:ebea19a646c3 3489 _setEnableBit(true); // set E
ligeiro13 0:ebea19a646c3 3490 _setDataBits(value); // set data low
ligeiro13 0:ebea19a646c3 3491 data[2] = _lcd_bus;
ligeiro13 0:ebea19a646c3 3492
ligeiro13 0:ebea19a646c3 3493 _setEnableBit(false); // clear E
ligeiro13 0:ebea19a646c3 3494 data[3] = _lcd_bus;
ligeiro13 0:ebea19a646c3 3495
ligeiro13 0:ebea19a646c3 3496 // write the packed data to the I2C portexpander
ligeiro13 0:ebea19a646c3 3497 _i2c->write(_slaveAddress, data, 4);
ligeiro13 0:ebea19a646c3 3498 #endif
ligeiro13 0:ebea19a646c3 3499 }
ligeiro13 0:ebea19a646c3 3500
ligeiro13 0:ebea19a646c3 3501 #endif /* I2C Expander PCF8574/MCP23008 */
ligeiro13 0:ebea19a646c3 3502 //---------- End TextLCD_I2C ------------
ligeiro13 0:ebea19a646c3 3503
ligeiro13 0:ebea19a646c3 3504
ligeiro13 0:ebea19a646c3 3505 //--------- Start TextLCD_SPI -----------
ligeiro13 0:ebea19a646c3 3506 #if(LCD_SPI == 1) /* SPI Expander SN74595 */
ligeiro13 0:ebea19a646c3 3507
ligeiro13 0:ebea19a646c3 3508 /** Create a TextLCD interface using an SPI 74595 portexpander
ligeiro13 0:ebea19a646c3 3509 *
ligeiro13 0:ebea19a646c3 3510 * @param spi SPI Bus
ligeiro13 0:ebea19a646c3 3511 * @param cs chip select pin (active low)
ligeiro13 0:ebea19a646c3 3512 * @param type Sets the panel size/addressing mode (default = LCD16x2)
ligeiro13 0:ebea19a646c3 3513 * @param ctrl LCD controller (default = HD44780)
ligeiro13 0:ebea19a646c3 3514 */
ligeiro13 0:ebea19a646c3 3515 TextLCD_SPI::TextLCD_SPI(SPI *spi, PinName cs, LCDType type, LCDCtrl ctrl) :
ligeiro13 0:ebea19a646c3 3516 TextLCD_Base(type, ctrl),
ligeiro13 0:ebea19a646c3 3517 _spi(spi),
ligeiro13 0:ebea19a646c3 3518 _cs(cs) {
ligeiro13 0:ebea19a646c3 3519 // Init cs
ligeiro13 0:ebea19a646c3 3520 _cs = 1;
ligeiro13 0:ebea19a646c3 3521
ligeiro13 0:ebea19a646c3 3522 // Setup the spi for 8 bit data, low steady state clock,
ligeiro13 0:ebea19a646c3 3523 // rising edge capture, with a 500KHz or 1MHz clock rate
ligeiro13 0:ebea19a646c3 3524 _spi->format(8,0);
ligeiro13 0:ebea19a646c3 3525 _spi->frequency(500000);
ligeiro13 0:ebea19a646c3 3526 //_spi.frequency(1000000);
ligeiro13 0:ebea19a646c3 3527
ligeiro13 0:ebea19a646c3 3528 wait_ms(100); // Wait 100ms to ensure LCD powered up
ligeiro13 0:ebea19a646c3 3529
ligeiro13 0:ebea19a646c3 3530 // Init the portexpander bus
ligeiro13 0:ebea19a646c3 3531 _lcd_bus = LCD_BUS_SPI_DEF;
ligeiro13 0:ebea19a646c3 3532
ligeiro13 0:ebea19a646c3 3533 // write the new data to the portexpander
ligeiro13 0:ebea19a646c3 3534 _cs = 0;
ligeiro13 0:ebea19a646c3 3535 _spi->write(_lcd_bus);
ligeiro13 0:ebea19a646c3 3536 _cs = 1;
ligeiro13 0:ebea19a646c3 3537
ligeiro13 0:ebea19a646c3 3538 _init(_LCD_DL_4); // Set Datalength to 4 bit for all serial expander interfaces
ligeiro13 0:ebea19a646c3 3539 }
ligeiro13 0:ebea19a646c3 3540
ligeiro13 0:ebea19a646c3 3541 // Set E pin (or E2 pin)
ligeiro13 0:ebea19a646c3 3542 // Used for mbed pins, I2C bus expander or SPI shiftregister
ligeiro13 0:ebea19a646c3 3543 void TextLCD_SPI::_setEnable(bool value) {
ligeiro13 0:ebea19a646c3 3544
ligeiro13 0:ebea19a646c3 3545 if(_ctrl_idx==_LCDCtrl_0) {
ligeiro13 0:ebea19a646c3 3546 if (value) {
ligeiro13 0:ebea19a646c3 3547 _lcd_bus |= LCD_BUS_SPI_E; // Set E bit
ligeiro13 0:ebea19a646c3 3548 }
ligeiro13 0:ebea19a646c3 3549 else {
ligeiro13 0:ebea19a646c3 3550 _lcd_bus &= ~LCD_BUS_SPI_E; // Reset E bit
ligeiro13 0:ebea19a646c3 3551 }
ligeiro13 0:ebea19a646c3 3552 }
ligeiro13 0:ebea19a646c3 3553 else {
ligeiro13 0:ebea19a646c3 3554 if (value) {
ligeiro13 0:ebea19a646c3 3555 _lcd_bus |= LCD_BUS_SPI_E2; // Set E2 bit
ligeiro13 0:ebea19a646c3 3556 }
ligeiro13 0:ebea19a646c3 3557 else {
ligeiro13 0:ebea19a646c3 3558 _lcd_bus &= ~LCD_BUS_SPI_E2; // Reset E2 bit
ligeiro13 0:ebea19a646c3 3559 }
ligeiro13 0:ebea19a646c3 3560 }
ligeiro13 0:ebea19a646c3 3561
ligeiro13 0:ebea19a646c3 3562 // write the new data to the SPI portexpander
ligeiro13 0:ebea19a646c3 3563 _cs = 0;
ligeiro13 0:ebea19a646c3 3564 _spi->write(_lcd_bus);
ligeiro13 0:ebea19a646c3 3565 _cs = 1;
ligeiro13 0:ebea19a646c3 3566 }
ligeiro13 0:ebea19a646c3 3567
ligeiro13 0:ebea19a646c3 3568 // Set RS pin
ligeiro13 0:ebea19a646c3 3569 // Used for mbed pins, I2C bus expander or SPI shiftregister and SPI_N
ligeiro13 0:ebea19a646c3 3570 void TextLCD_SPI::_setRS(bool value) {
ligeiro13 0:ebea19a646c3 3571
ligeiro13 0:ebea19a646c3 3572 if (value) {
ligeiro13 0:ebea19a646c3 3573 _lcd_bus |= LCD_BUS_SPI_RS; // Set RS bit
ligeiro13 0:ebea19a646c3 3574 }
ligeiro13 0:ebea19a646c3 3575 else {
ligeiro13 0:ebea19a646c3 3576 _lcd_bus &= ~LCD_BUS_SPI_RS; // Reset RS bit
ligeiro13 0:ebea19a646c3 3577 }
ligeiro13 0:ebea19a646c3 3578
ligeiro13 0:ebea19a646c3 3579 // write the new data to the SPI portexpander
ligeiro13 0:ebea19a646c3 3580 _cs = 0;
ligeiro13 0:ebea19a646c3 3581 _spi->write(_lcd_bus);
ligeiro13 0:ebea19a646c3 3582 _cs = 1;
ligeiro13 0:ebea19a646c3 3583 }
ligeiro13 0:ebea19a646c3 3584
ligeiro13 0:ebea19a646c3 3585 // Set BL pin
ligeiro13 0:ebea19a646c3 3586 // Used for mbed pins, I2C bus expander or SPI shiftregister
ligeiro13 0:ebea19a646c3 3587 void TextLCD_SPI::_setBL(bool value) {
ligeiro13 0:ebea19a646c3 3588
ligeiro13 0:ebea19a646c3 3589 if (value) {
ligeiro13 0:ebea19a646c3 3590 _lcd_bus |= LCD_BUS_SPI_BL; // Set BL bit
ligeiro13 0:ebea19a646c3 3591 }
ligeiro13 0:ebea19a646c3 3592 else {
ligeiro13 0:ebea19a646c3 3593 _lcd_bus &= ~LCD_BUS_SPI_BL; // Reset BL bit
ligeiro13 0:ebea19a646c3 3594 }
ligeiro13 0:ebea19a646c3 3595
ligeiro13 0:ebea19a646c3 3596 // write the new data to the SPI portexpander
ligeiro13 0:ebea19a646c3 3597 _cs = 0;
ligeiro13 0:ebea19a646c3 3598 _spi->write(_lcd_bus);
ligeiro13 0:ebea19a646c3 3599 _cs = 1;
ligeiro13 0:ebea19a646c3 3600 }
ligeiro13 0:ebea19a646c3 3601
ligeiro13 0:ebea19a646c3 3602 // Place the 4bit data on the databus
ligeiro13 0:ebea19a646c3 3603 // Used for mbed pins, I2C bus expander or SPI shiftregister
ligeiro13 0:ebea19a646c3 3604 void TextLCD_SPI::_setData(int value) {
ligeiro13 0:ebea19a646c3 3605
ligeiro13 0:ebea19a646c3 3606 // Set bit by bit to support any mapping of expander portpins to LCD pins
ligeiro13 0:ebea19a646c3 3607 if (value & 0x01) {
ligeiro13 0:ebea19a646c3 3608 _lcd_bus |= LCD_BUS_SPI_D4; // Set Databit
ligeiro13 0:ebea19a646c3 3609 }
ligeiro13 0:ebea19a646c3 3610 else {
ligeiro13 0:ebea19a646c3 3611 _lcd_bus &= ~LCD_BUS_SPI_D4; // Reset Databit
ligeiro13 0:ebea19a646c3 3612 }
ligeiro13 0:ebea19a646c3 3613
ligeiro13 0:ebea19a646c3 3614 if (value & 0x02) {
ligeiro13 0:ebea19a646c3 3615 _lcd_bus |= LCD_BUS_SPI_D5; // Set Databit
ligeiro13 0:ebea19a646c3 3616 }
ligeiro13 0:ebea19a646c3 3617 else {
ligeiro13 0:ebea19a646c3 3618 _lcd_bus &= ~LCD_BUS_SPI_D5; // Reset Databit
ligeiro13 0:ebea19a646c3 3619 }
ligeiro13 0:ebea19a646c3 3620
ligeiro13 0:ebea19a646c3 3621 if (value & 0x04) {
ligeiro13 0:ebea19a646c3 3622 _lcd_bus |= LCD_BUS_SPI_D6; // Set Databit
ligeiro13 0:ebea19a646c3 3623 }
ligeiro13 0:ebea19a646c3 3624 else {
ligeiro13 0:ebea19a646c3 3625 _lcd_bus &= ~LCD_BUS_SPI_D6; // Reset Databit
ligeiro13 0:ebea19a646c3 3626 }
ligeiro13 0:ebea19a646c3 3627
ligeiro13 0:ebea19a646c3 3628 if (value & 0x08) {
ligeiro13 0:ebea19a646c3 3629 _lcd_bus |= LCD_BUS_SPI_D7; // Set Databit
ligeiro13 0:ebea19a646c3 3630 }
ligeiro13 0:ebea19a646c3 3631 else {
ligeiro13 0:ebea19a646c3 3632 _lcd_bus &= ~LCD_BUS_SPI_D7; // Reset Databit
ligeiro13 0:ebea19a646c3 3633 }
ligeiro13 0:ebea19a646c3 3634
ligeiro13 0:ebea19a646c3 3635 // write the new data to the SPI portexpander
ligeiro13 0:ebea19a646c3 3636 _cs = 0;
ligeiro13 0:ebea19a646c3 3637 _spi->write(_lcd_bus);
ligeiro13 0:ebea19a646c3 3638 _cs = 1;
ligeiro13 0:ebea19a646c3 3639 }
ligeiro13 0:ebea19a646c3 3640
ligeiro13 0:ebea19a646c3 3641 #endif /* SPI Expander SN74595 */
ligeiro13 0:ebea19a646c3 3642 //---------- End TextLCD_SPI ------------
ligeiro13 0:ebea19a646c3 3643
ligeiro13 0:ebea19a646c3 3644
ligeiro13 0:ebea19a646c3 3645 //--------- Start TextLCD_I2C_N ---------
ligeiro13 0:ebea19a646c3 3646 #if(LCD_I2C_N == 1) /* Native I2C */
ligeiro13 0:ebea19a646c3 3647
ligeiro13 0:ebea19a646c3 3648 /** Create a TextLCD interface using a controller with native I2C interface
ligeiro13 0:ebea19a646c3 3649 *
ligeiro13 0:ebea19a646c3 3650 * @param i2c I2C Bus
ligeiro13 0:ebea19a646c3 3651 * @param deviceAddress I2C slave address (default = 0x7C)
ligeiro13 0:ebea19a646c3 3652 * @param type Sets the panel size/addressing mode (default = LCD16x2)
ligeiro13 0:ebea19a646c3 3653 * @param bl Backlight control line (optional, default = NC)
ligeiro13 0:ebea19a646c3 3654 * @param ctrl LCD controller (default = ST7032_3V3)
ligeiro13 0:ebea19a646c3 3655 */
ligeiro13 0:ebea19a646c3 3656 TextLCD_I2C_N::TextLCD_I2C_N(I2C *i2c, char deviceAddress, LCDType type, PinName bl, LCDCtrl ctrl) :
ligeiro13 0:ebea19a646c3 3657 TextLCD_Base(type, ctrl),
ligeiro13 0:ebea19a646c3 3658
ligeiro13 0:ebea19a646c3 3659 _i2c(i2c){
ligeiro13 0:ebea19a646c3 3660
ligeiro13 0:ebea19a646c3 3661 _slaveAddress = deviceAddress & 0xFE;
ligeiro13 0:ebea19a646c3 3662
ligeiro13 0:ebea19a646c3 3663 // Setup the I2C bus
ligeiro13 0:ebea19a646c3 3664 // The max bitrate for ST7032i is 400kbit, lets stick to default here
ligeiro13 0:ebea19a646c3 3665 _i2c->frequency(100000);
ligeiro13 0:ebea19a646c3 3666
ligeiro13 0:ebea19a646c3 3667
ligeiro13 0:ebea19a646c3 3668 // The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
ligeiro13 0:ebea19a646c3 3669 if (bl != NC) {
ligeiro13 0:ebea19a646c3 3670 _bl = new DigitalOut(bl); //Construct new pin
ligeiro13 0:ebea19a646c3 3671 _bl->write(0); //Deactivate
ligeiro13 0:ebea19a646c3 3672 }
ligeiro13 0:ebea19a646c3 3673 else {
ligeiro13 0:ebea19a646c3 3674 // No Hardware Backlight pin
ligeiro13 0:ebea19a646c3 3675 _bl = NULL; //Construct dummy pin
ligeiro13 0:ebea19a646c3 3676 }
ligeiro13 0:ebea19a646c3 3677
ligeiro13 0:ebea19a646c3 3678 //Sanity check
ligeiro13 0:ebea19a646c3 3679 if (_ctrl & LCD_C_I2C) {
ligeiro13 0:ebea19a646c3 3680 _init(_LCD_DL_8); // Set Datalength to 8 bit for all native serial interfaces
ligeiro13 0:ebea19a646c3 3681 }
ligeiro13 0:ebea19a646c3 3682 else {
ligeiro13 0:ebea19a646c3 3683 error("Error: LCD Controller type does not support native I2C interface\n\r");
ligeiro13 0:ebea19a646c3 3684 }
ligeiro13 0:ebea19a646c3 3685 }
ligeiro13 0:ebea19a646c3 3686
ligeiro13 0:ebea19a646c3 3687 TextLCD_I2C_N::~TextLCD_I2C_N() {
ligeiro13 0:ebea19a646c3 3688 if (_bl != NULL) {delete _bl;} // BL pin
ligeiro13 0:ebea19a646c3 3689 }
ligeiro13 0:ebea19a646c3 3690
ligeiro13 0:ebea19a646c3 3691 // Not used in this mode
ligeiro13 0:ebea19a646c3 3692 void TextLCD_I2C_N::_setEnable(bool value) {
ligeiro13 0:ebea19a646c3 3693 }
ligeiro13 0:ebea19a646c3 3694
ligeiro13 0:ebea19a646c3 3695 // Set RS pin
ligeiro13 0:ebea19a646c3 3696 // Used for mbed pins, I2C bus expander or SPI shiftregister and native I2C or SPI
ligeiro13 0:ebea19a646c3 3697 void TextLCD_I2C_N::_setRS(bool value) {
ligeiro13 0:ebea19a646c3 3698 // The controlbyte defines the meaning of the next byte. This next byte can either be data or command.
ligeiro13 0:ebea19a646c3 3699 // Start Slaveaddress+RW b7 b6 b5 b4 b3 b2 b1 b0 b7...........b0 Stop
ligeiro13 0:ebea19a646c3 3700 // Co RS RW 0 0 0 0 0 command or data
ligeiro13 0:ebea19a646c3 3701 //
ligeiro13 0:ebea19a646c3 3702 // C0=1 indicates that another controlbyte will follow after the next data or command byte
ligeiro13 0:ebea19a646c3 3703 // RS=1 means that next byte is data, RS=0 means that next byte is command
ligeiro13 0:ebea19a646c3 3704 // RW=0 means write to controller. RW=1 means that controller will be read from after the next command.
ligeiro13 0:ebea19a646c3 3705 // Many native I2C controllers dont support this option and it is not used by this lib.
ligeiro13 0:ebea19a646c3 3706 //
ligeiro13 0:ebea19a646c3 3707
ligeiro13 0:ebea19a646c3 3708 if (value) {
ligeiro13 0:ebea19a646c3 3709 _controlbyte = 0x40; // Next byte is data, No more control bytes will follow
ligeiro13 0:ebea19a646c3 3710 }
ligeiro13 0:ebea19a646c3 3711 else {
ligeiro13 0:ebea19a646c3 3712 _controlbyte = 0x00; // Next byte is command, No more control bytes will follow
ligeiro13 0:ebea19a646c3 3713 }
ligeiro13 0:ebea19a646c3 3714 }
ligeiro13 0:ebea19a646c3 3715
ligeiro13 0:ebea19a646c3 3716 // Set BL pin
ligeiro13 0:ebea19a646c3 3717 void TextLCD_I2C_N::_setBL(bool value) {
ligeiro13 0:ebea19a646c3 3718 if (_bl) {
ligeiro13 0:ebea19a646c3 3719 _bl->write(value);
ligeiro13 0:ebea19a646c3 3720 }
ligeiro13 0:ebea19a646c3 3721 }
ligeiro13 0:ebea19a646c3 3722
ligeiro13 0:ebea19a646c3 3723 // Not used in this mode
ligeiro13 0:ebea19a646c3 3724 void TextLCD_I2C_N::_setData(int value) {
ligeiro13 0:ebea19a646c3 3725 }
ligeiro13 0:ebea19a646c3 3726
ligeiro13 0:ebea19a646c3 3727 // Write a byte using I2C
ligeiro13 0:ebea19a646c3 3728 void TextLCD_I2C_N::_writeByte(int value) {
ligeiro13 0:ebea19a646c3 3729 // The controlbyte defines the meaning of the next byte. This next byte can either be data or command.
ligeiro13 0:ebea19a646c3 3730 // Start Slaveaddress+RW b7 b6 b5 b4 b3 b2 b1 b0 b7...........b0 Stop
ligeiro13 0:ebea19a646c3 3731 // Co RS RW 0 0 0 0 0 command or data
ligeiro13 0:ebea19a646c3 3732 //
ligeiro13 0:ebea19a646c3 3733 // C0=1 indicates that another controlbyte will follow after the next data or command byte
ligeiro13 0:ebea19a646c3 3734 // RS=1 means that next byte is data, RS=0 means that next byte is command
ligeiro13 0:ebea19a646c3 3735 // RW=0 means write to controller. RW=1 means that controller will be read from after the next command.
ligeiro13 0:ebea19a646c3 3736 // Many native I2C controllers dont support this option and it is not used by this lib.
ligeiro13 0:ebea19a646c3 3737 //
ligeiro13 0:ebea19a646c3 3738 char data[] = {_controlbyte, value};
ligeiro13 0:ebea19a646c3 3739
ligeiro13 0:ebea19a646c3 3740 #if(LCD_I2C_ACK==1)
ligeiro13 0:ebea19a646c3 3741 //Controllers that support ACK
ligeiro13 0:ebea19a646c3 3742 _i2c->write(_slaveAddress, data, 2);
ligeiro13 0:ebea19a646c3 3743 #else
ligeiro13 0:ebea19a646c3 3744 //Controllers that dont support ACK
ligeiro13 0:ebea19a646c3 3745 //Note: This may be issue with some mbed platforms that dont fully/correctly support I2C byte operations.
ligeiro13 0:ebea19a646c3 3746 _i2c->start();
ligeiro13 0:ebea19a646c3 3747 _i2c->write(_slaveAddress);
ligeiro13 0:ebea19a646c3 3748 _i2c->write(data[0]);
ligeiro13 0:ebea19a646c3 3749 _i2c->write(data[1]);
ligeiro13 0:ebea19a646c3 3750 _i2c->stop();
ligeiro13 0:ebea19a646c3 3751 #endif
ligeiro13 0:ebea19a646c3 3752 }
ligeiro13 0:ebea19a646c3 3753 #endif /* Native I2C */
ligeiro13 0:ebea19a646c3 3754 //-------- End TextLCD_I2C_N ------------
ligeiro13 0:ebea19a646c3 3755
ligeiro13 0:ebea19a646c3 3756
ligeiro13 0:ebea19a646c3 3757 //--------- Start TextLCD_SPI_N ---------
ligeiro13 0:ebea19a646c3 3758 #if(LCD_SPI_N == 1) /* Native SPI bus */
ligeiro13 0:ebea19a646c3 3759 /** Create a TextLCD interface using a controller with a native SPI4 interface
ligeiro13 0:ebea19a646c3 3760 *
ligeiro13 0:ebea19a646c3 3761 * @param spi SPI Bus
ligeiro13 0:ebea19a646c3 3762 * @param cs chip select pin (active low)
ligeiro13 0:ebea19a646c3 3763 * @param rs Instruction/data control line
ligeiro13 0:ebea19a646c3 3764 * @param type Sets the panel size/addressing mode (default = LCD16x2)
ligeiro13 0:ebea19a646c3 3765 * @param bl Backlight control line (optional, default = NC)
ligeiro13 0:ebea19a646c3 3766 * @param ctrl LCD controller (default = ST7032_3V3)
ligeiro13 0:ebea19a646c3 3767 */
ligeiro13 0:ebea19a646c3 3768 TextLCD_SPI_N::TextLCD_SPI_N(SPI *spi, PinName cs, PinName rs, LCDType type, PinName bl, LCDCtrl ctrl) :
ligeiro13 0:ebea19a646c3 3769 TextLCD_Base(type, ctrl),
ligeiro13 0:ebea19a646c3 3770 _spi(spi),
ligeiro13 0:ebea19a646c3 3771 _cs(cs),
ligeiro13 0:ebea19a646c3 3772 _rs(rs) {
ligeiro13 0:ebea19a646c3 3773
ligeiro13 0:ebea19a646c3 3774 // Init CS
ligeiro13 0:ebea19a646c3 3775 _cs = 1;
ligeiro13 0:ebea19a646c3 3776
ligeiro13 0:ebea19a646c3 3777 // Setup the spi for 8 bit data, high steady state clock,
ligeiro13 0:ebea19a646c3 3778 // rising edge capture, with a 500KHz or 1MHz clock rate
ligeiro13 0:ebea19a646c3 3779 // _spi->format(8,3);
ligeiro13 0:ebea19a646c3 3780 // _spi->frequency(500000);
ligeiro13 0:ebea19a646c3 3781 // _spi->frequency(1000000);
ligeiro13 0:ebea19a646c3 3782
ligeiro13 0:ebea19a646c3 3783 // Setup the spi for 8 bit data, low steady state clock,
ligeiro13 0:ebea19a646c3 3784 // rising edge capture, with a 500KHz or 1MHz clock rate
ligeiro13 0:ebea19a646c3 3785 _spi->format(8,0);
ligeiro13 0:ebea19a646c3 3786 // _spi->frequency(500000);
ligeiro13 0:ebea19a646c3 3787 _spi->frequency(1000000);
ligeiro13 0:ebea19a646c3 3788
ligeiro13 0:ebea19a646c3 3789 // The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
ligeiro13 0:ebea19a646c3 3790 if (bl != NC) {
ligeiro13 0:ebea19a646c3 3791 _bl = new DigitalOut(bl); //Construct new pin
ligeiro13 0:ebea19a646c3 3792 _bl->write(0); //Deactivate
ligeiro13 0:ebea19a646c3 3793 }
ligeiro13 0:ebea19a646c3 3794 else {
ligeiro13 0:ebea19a646c3 3795 // No Hardware Backlight pin
ligeiro13 0:ebea19a646c3 3796 _bl = NULL; //Construct dummy pin
ligeiro13 0:ebea19a646c3 3797 }
ligeiro13 0:ebea19a646c3 3798
ligeiro13 0:ebea19a646c3 3799 //Sanity check
ligeiro13 0:ebea19a646c3 3800 if (_ctrl & LCD_C_SPI4) {
ligeiro13 0:ebea19a646c3 3801 _init(_LCD_DL_8); // Set Datalength to 8 bit for all native serial interfaces
ligeiro13 0:ebea19a646c3 3802 // ST7070 must set datalength to 8 bits!
ligeiro13 0:ebea19a646c3 3803 }
ligeiro13 0:ebea19a646c3 3804 else {
ligeiro13 0:ebea19a646c3 3805 error("Error: LCD Controller type does not support native SPI4 interface\n\r");
ligeiro13 0:ebea19a646c3 3806 }
ligeiro13 0:ebea19a646c3 3807 }
ligeiro13 0:ebea19a646c3 3808
ligeiro13 0:ebea19a646c3 3809 TextLCD_SPI_N::~TextLCD_SPI_N() {
ligeiro13 0:ebea19a646c3 3810 if (_bl != NULL) {delete _bl;} // BL pin
ligeiro13 0:ebea19a646c3 3811 }
ligeiro13 0:ebea19a646c3 3812
ligeiro13 0:ebea19a646c3 3813 // Not used in this mode
ligeiro13 0:ebea19a646c3 3814 void TextLCD_SPI_N::_setEnable(bool value) {
ligeiro13 0:ebea19a646c3 3815 }
ligeiro13 0:ebea19a646c3 3816
ligeiro13 0:ebea19a646c3 3817 // Set RS pin
ligeiro13 0:ebea19a646c3 3818 // Used for mbed pins, I2C bus expander or SPI shiftregister, SPI_N
ligeiro13 0:ebea19a646c3 3819 void TextLCD_SPI_N::_setRS(bool value) {
ligeiro13 0:ebea19a646c3 3820 _rs = value;
ligeiro13 0:ebea19a646c3 3821 }
ligeiro13 0:ebea19a646c3 3822
ligeiro13 0:ebea19a646c3 3823 // Set BL pin
ligeiro13 0:ebea19a646c3 3824 void TextLCD_SPI_N::_setBL(bool value) {
ligeiro13 0:ebea19a646c3 3825 if (_bl) {
ligeiro13 0:ebea19a646c3 3826 _bl->write(value);
ligeiro13 0:ebea19a646c3 3827 }
ligeiro13 0:ebea19a646c3 3828 }
ligeiro13 0:ebea19a646c3 3829
ligeiro13 0:ebea19a646c3 3830 // Not used in this mode
ligeiro13 0:ebea19a646c3 3831 void TextLCD_SPI_N::_setData(int value) {
ligeiro13 0:ebea19a646c3 3832 }
ligeiro13 0:ebea19a646c3 3833
ligeiro13 0:ebea19a646c3 3834 // Write a byte using SPI
ligeiro13 0:ebea19a646c3 3835 void TextLCD_SPI_N::_writeByte(int value) {
ligeiro13 0:ebea19a646c3 3836 _cs = 0;
ligeiro13 0:ebea19a646c3 3837 wait_us(1);
ligeiro13 0:ebea19a646c3 3838 _spi->write(value);
ligeiro13 0:ebea19a646c3 3839 wait_us(1);
ligeiro13 0:ebea19a646c3 3840 _cs = 1;
ligeiro13 0:ebea19a646c3 3841 }
ligeiro13 0:ebea19a646c3 3842 #endif /* Native SPI bus */
ligeiro13 0:ebea19a646c3 3843 //-------- End TextLCD_SPI_N ------------
ligeiro13 0:ebea19a646c3 3844
ligeiro13 0:ebea19a646c3 3845
ligeiro13 0:ebea19a646c3 3846 //-------- Start TextLCD_SPI_N_3_8 --------
ligeiro13 0:ebea19a646c3 3847 #if(LCD_SPI_N_3_8 == 1) /* Native SPI bus */
ligeiro13 0:ebea19a646c3 3848
ligeiro13 0:ebea19a646c3 3849 /** Create a TextLCD interface using a controller with a native SPI3 8 bits interface
ligeiro13 0:ebea19a646c3 3850 * This mode is supported by ST7070. Note that implementation in TexTLCD is not very efficient due to
ligeiro13 0:ebea19a646c3 3851 * structure of the TextLCD library: each databyte is written separately and requires a separate 'count command' set to 1 byte.
ligeiro13 0:ebea19a646c3 3852 *
ligeiro13 0:ebea19a646c3 3853 * @param spi SPI Bus
ligeiro13 0:ebea19a646c3 3854 * @param cs chip select pin (active low)
ligeiro13 0:ebea19a646c3 3855 * @param type Sets the panel size/addressing mode (default = LCD16x2)
ligeiro13 0:ebea19a646c3 3856 * @param bl Backlight control line (optional, default = NC)
ligeiro13 0:ebea19a646c3 3857 * @param ctrl LCD controller (default = ST7070)
ligeiro13 0:ebea19a646c3 3858 */
ligeiro13 0:ebea19a646c3 3859 TextLCD_SPI_N_3_8::TextLCD_SPI_N_3_8(SPI *spi, PinName cs, LCDType type, PinName bl, LCDCtrl ctrl) :
ligeiro13 0:ebea19a646c3 3860 TextLCD_Base(type, ctrl),
ligeiro13 0:ebea19a646c3 3861 _spi(spi),
ligeiro13 0:ebea19a646c3 3862 _cs(cs) {
ligeiro13 0:ebea19a646c3 3863
ligeiro13 0:ebea19a646c3 3864 // Init CS
ligeiro13 0:ebea19a646c3 3865 _cs = 1;
ligeiro13 0:ebea19a646c3 3866
ligeiro13 0:ebea19a646c3 3867 // Setup the spi for 8 bit data, high steady state clock,
ligeiro13 0:ebea19a646c3 3868 // rising edge capture, with a 500KHz or 1MHz clock rate
ligeiro13 0:ebea19a646c3 3869 // _spi->format(8,3);
ligeiro13 0:ebea19a646c3 3870 // _spi->frequency(500000);
ligeiro13 0:ebea19a646c3 3871 // _spi->frequency(1000000);
ligeiro13 0:ebea19a646c3 3872
ligeiro13 0:ebea19a646c3 3873 // Setup the spi for 8 bit data, low steady state clock,
ligeiro13 0:ebea19a646c3 3874 // rising edge capture, with a 500KHz or 1MHz clock rate
ligeiro13 0:ebea19a646c3 3875 _spi->format(8,0);
ligeiro13 0:ebea19a646c3 3876 // _spi->frequency(500000);
ligeiro13 0:ebea19a646c3 3877 _spi->frequency(1000000);
ligeiro13 0:ebea19a646c3 3878
ligeiro13 0:ebea19a646c3 3879
ligeiro13 0:ebea19a646c3 3880 // The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
ligeiro13 0:ebea19a646c3 3881 if (bl != NC) {
ligeiro13 0:ebea19a646c3 3882 _bl = new DigitalOut(bl); //Construct new pin
ligeiro13 0:ebea19a646c3 3883 _bl->write(0); //Deactivate
ligeiro13 0:ebea19a646c3 3884 }
ligeiro13 0:ebea19a646c3 3885 else {
ligeiro13 0:ebea19a646c3 3886 // No Hardware Backlight pin
ligeiro13 0:ebea19a646c3 3887 _bl = NULL; //Construct dummy pin
ligeiro13 0:ebea19a646c3 3888 }
ligeiro13 0:ebea19a646c3 3889
ligeiro13 0:ebea19a646c3 3890 //Sanity check
ligeiro13 0:ebea19a646c3 3891 if (_ctrl & LCD_C_SPI3_8) {
ligeiro13 0:ebea19a646c3 3892 _init(_LCD_DL_8); // Set Datalength to 8 bit for all native serial interfaces
ligeiro13 0:ebea19a646c3 3893 }
ligeiro13 0:ebea19a646c3 3894 else {
ligeiro13 0:ebea19a646c3 3895 error("Error: LCD Controller type does not support native SPI3 8 bits interface\n\r");
ligeiro13 0:ebea19a646c3 3896 }
ligeiro13 0:ebea19a646c3 3897 }
ligeiro13 0:ebea19a646c3 3898
ligeiro13 0:ebea19a646c3 3899 TextLCD_SPI_N_3_8::~TextLCD_SPI_N_3_8() {
ligeiro13 0:ebea19a646c3 3900 if (_bl != NULL) {delete _bl;} // BL pin
ligeiro13 0:ebea19a646c3 3901 }
ligeiro13 0:ebea19a646c3 3902
ligeiro13 0:ebea19a646c3 3903 // Not used in this mode
ligeiro13 0:ebea19a646c3 3904 void TextLCD_SPI_N_3_8::_setEnable(bool value) {
ligeiro13 0:ebea19a646c3 3905 }
ligeiro13 0:ebea19a646c3 3906
ligeiro13 0:ebea19a646c3 3907 // Used for mbed pins, I2C bus expander or SPI shiftregister, SPI_N
ligeiro13 0:ebea19a646c3 3908 // RS=1 means that next byte is data, RS=0 means that next byte is command
ligeiro13 0:ebea19a646c3 3909 void TextLCD_SPI_N_3_8::_setRS(bool value) {
ligeiro13 0:ebea19a646c3 3910
ligeiro13 0:ebea19a646c3 3911 if (value) {
ligeiro13 0:ebea19a646c3 3912 _controlbyte = 0x01; // Next byte is data, No more control bytes will follow
ligeiro13 0:ebea19a646c3 3913 }
ligeiro13 0:ebea19a646c3 3914 else {
ligeiro13 0:ebea19a646c3 3915 _controlbyte = 0x00; // Next byte is command, No more control bytes will follow
ligeiro13 0:ebea19a646c3 3916 }
ligeiro13 0:ebea19a646c3 3917 }
ligeiro13 0:ebea19a646c3 3918
ligeiro13 0:ebea19a646c3 3919 // Set BL pin
ligeiro13 0:ebea19a646c3 3920 void TextLCD_SPI_N_3_8::_setBL(bool value) {
ligeiro13 0:ebea19a646c3 3921 if (_bl) {
ligeiro13 0:ebea19a646c3 3922 _bl->write(value);
ligeiro13 0:ebea19a646c3 3923 }
ligeiro13 0:ebea19a646c3 3924 }
ligeiro13 0:ebea19a646c3 3925
ligeiro13 0:ebea19a646c3 3926 // Not used in this mode
ligeiro13 0:ebea19a646c3 3927 void TextLCD_SPI_N_3_8::_setData(int value) {
ligeiro13 0:ebea19a646c3 3928 }
ligeiro13 0:ebea19a646c3 3929
ligeiro13 0:ebea19a646c3 3930 // Write a byte using SPI3 8 bits mode (ST7070)
ligeiro13 0:ebea19a646c3 3931 void TextLCD_SPI_N_3_8::_writeByte(int value) {
ligeiro13 0:ebea19a646c3 3932
ligeiro13 0:ebea19a646c3 3933 if (_controlbyte == 0x00) { // Byte is command
ligeiro13 0:ebea19a646c3 3934 _cs = 0;
ligeiro13 0:ebea19a646c3 3935 wait_us(1);
ligeiro13 0:ebea19a646c3 3936 _spi->write(value);
ligeiro13 0:ebea19a646c3 3937 wait_us(1);
ligeiro13 0:ebea19a646c3 3938 _cs = 1;
ligeiro13 0:ebea19a646c3 3939 }
ligeiro13 0:ebea19a646c3 3940 else { // Byte is data
ligeiro13 0:ebea19a646c3 3941 // Select Extended Instr Set
ligeiro13 0:ebea19a646c3 3942 _cs = 0;
ligeiro13 0:ebea19a646c3 3943 wait_us(1);
ligeiro13 0:ebea19a646c3 3944 _spi->write(0x20 | _function | 0x04); // Set function, 0 0 1 DL N EXT=1 x x (Select Instr Set = 1));
ligeiro13 0:ebea19a646c3 3945 wait_us(1);
ligeiro13 0:ebea19a646c3 3946 _cs = 1;
ligeiro13 0:ebea19a646c3 3947
ligeiro13 0:ebea19a646c3 3948 wait_us(40); // Wait until command has finished...
ligeiro13 0:ebea19a646c3 3949
ligeiro13 0:ebea19a646c3 3950 // Set Count to 1 databyte
ligeiro13 0:ebea19a646c3 3951 _cs = 0;
ligeiro13 0:ebea19a646c3 3952 wait_us(1);
ligeiro13 0:ebea19a646c3 3953 _spi->write(0x80); // Set display data length, 1 L6 L5 L4 L3 L2 L1 L0 (Instr Set = 1)
ligeiro13 0:ebea19a646c3 3954 wait_us(1);
ligeiro13 0:ebea19a646c3 3955 _cs = 1;
ligeiro13 0:ebea19a646c3 3956
ligeiro13 0:ebea19a646c3 3957 wait_us(40);
ligeiro13 0:ebea19a646c3 3958
ligeiro13 0:ebea19a646c3 3959 // Write 1 databyte
ligeiro13 0:ebea19a646c3 3960 _cs = 0;
ligeiro13 0:ebea19a646c3 3961 wait_us(1);
ligeiro13 0:ebea19a646c3 3962 _spi->write(value); // Write data (Instr Set = 1)
ligeiro13 0:ebea19a646c3 3963 wait_us(1);
ligeiro13 0:ebea19a646c3 3964 _cs = 1;
ligeiro13 0:ebea19a646c3 3965
ligeiro13 0:ebea19a646c3 3966 wait_us(40);
ligeiro13 0:ebea19a646c3 3967
ligeiro13 0:ebea19a646c3 3968 // Select Standard Instr Set
ligeiro13 0:ebea19a646c3 3969 _cs = 0;
ligeiro13 0:ebea19a646c3 3970 wait_us(1);
ligeiro13 0:ebea19a646c3 3971 _spi->write(0x20 | _function); // Set function, 0 0 1 DL N EXT=0 x x (Select Instr Set = 0));
ligeiro13 0:ebea19a646c3 3972 wait_us(1);
ligeiro13 0:ebea19a646c3 3973 _cs = 1;
ligeiro13 0:ebea19a646c3 3974 }
ligeiro13 0:ebea19a646c3 3975 }
ligeiro13 0:ebea19a646c3 3976 #endif /* Native SPI bus */
ligeiro13 0:ebea19a646c3 3977 //------- End TextLCD_SPI_N_3_8 -----------
ligeiro13 0:ebea19a646c3 3978
ligeiro13 0:ebea19a646c3 3979
ligeiro13 0:ebea19a646c3 3980 //-------- Start TextLCD_SPI_N_3_9 --------
ligeiro13 0:ebea19a646c3 3981 #if(LCD_SPI_N_3_9 == 1) /* Native SPI bus */
ligeiro13 0:ebea19a646c3 3982 //Code checked out on logic analyser. Not yet tested on hardware..
ligeiro13 0:ebea19a646c3 3983
ligeiro13 0:ebea19a646c3 3984 /** Create a TextLCD interface using a controller with a native SPI3 9 bits interface
ligeiro13 0:ebea19a646c3 3985 *
ligeiro13 0:ebea19a646c3 3986 * @param spi SPI Bus
ligeiro13 0:ebea19a646c3 3987 * @param cs chip select pin (active low)
ligeiro13 0:ebea19a646c3 3988 * @param type Sets the panel size/addressing mode (default = LCD16x2)
ligeiro13 0:ebea19a646c3 3989 * @param bl Backlight control line (optional, default = NC)
ligeiro13 0:ebea19a646c3 3990 * @param ctrl LCD controller (default = AIP31068)
ligeiro13 0:ebea19a646c3 3991 */
ligeiro13 0:ebea19a646c3 3992 TextLCD_SPI_N_3_9::TextLCD_SPI_N_3_9(SPI *spi, PinName cs, LCDType type, PinName bl, LCDCtrl ctrl) :
ligeiro13 0:ebea19a646c3 3993 TextLCD_Base(type, ctrl),
ligeiro13 0:ebea19a646c3 3994 _spi(spi),
ligeiro13 0:ebea19a646c3 3995 _cs(cs) {
ligeiro13 0:ebea19a646c3 3996
ligeiro13 0:ebea19a646c3 3997 // Init CS
ligeiro13 0:ebea19a646c3 3998 _cs = 1;
ligeiro13 0:ebea19a646c3 3999
ligeiro13 0:ebea19a646c3 4000 // Setup the spi for 9 bit data, high steady state clock,
ligeiro13 0:ebea19a646c3 4001 // rising edge capture, with a 500KHz or 1MHz clock rate
ligeiro13 0:ebea19a646c3 4002 _spi->format(9,3);
ligeiro13 0:ebea19a646c3 4003 _spi->frequency(1000000);
ligeiro13 0:ebea19a646c3 4004
ligeiro13 0:ebea19a646c3 4005 // The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
ligeiro13 0:ebea19a646c3 4006 if (bl != NC) {
ligeiro13 0:ebea19a646c3 4007 _bl = new DigitalOut(bl); //Construct new pin
ligeiro13 0:ebea19a646c3 4008 _bl->write(0); //Deactivate
ligeiro13 0:ebea19a646c3 4009 }
ligeiro13 0:ebea19a646c3 4010 else {
ligeiro13 0:ebea19a646c3 4011 // No Hardware Backlight pin
ligeiro13 0:ebea19a646c3 4012 _bl = NULL; //Construct dummy pin
ligeiro13 0:ebea19a646c3 4013 }
ligeiro13 0:ebea19a646c3 4014
ligeiro13 0:ebea19a646c3 4015 //Sanity check
ligeiro13 0:ebea19a646c3 4016 if (_ctrl & LCD_C_SPI3_9) {
ligeiro13 0:ebea19a646c3 4017 _init(_LCD_DL_8); // Set Datalength to 8 bit for all native serial interfaces
ligeiro13 0:ebea19a646c3 4018 }
ligeiro13 0:ebea19a646c3 4019 else {
ligeiro13 0:ebea19a646c3 4020 error("Error: LCD Controller type does not support native SPI3 9 bits interface\n\r");
ligeiro13 0:ebea19a646c3 4021 }
ligeiro13 0:ebea19a646c3 4022 }
ligeiro13 0:ebea19a646c3 4023
ligeiro13 0:ebea19a646c3 4024 TextLCD_SPI_N_3_9::~TextLCD_SPI_N_3_9() {
ligeiro13 0:ebea19a646c3 4025 if (_bl != NULL) {delete _bl;} // BL pin
ligeiro13 0:ebea19a646c3 4026 }
ligeiro13 0:ebea19a646c3 4027
ligeiro13 0:ebea19a646c3 4028 // Not used in this mode
ligeiro13 0:ebea19a646c3 4029 void TextLCD_SPI_N_3_9::_setEnable(bool value) {
ligeiro13 0:ebea19a646c3 4030 }
ligeiro13 0:ebea19a646c3 4031
ligeiro13 0:ebea19a646c3 4032 // Set RS pin
ligeiro13 0:ebea19a646c3 4033 // Used for mbed pins, I2C bus expander or SPI shiftregister
ligeiro13 0:ebea19a646c3 4034 void TextLCD_SPI_N_3_9::_setRS(bool value) {
ligeiro13 0:ebea19a646c3 4035 // The controlbits define the meaning of the next byte. This next byte can either be data or command.
ligeiro13 0:ebea19a646c3 4036 // b8 b7...........b0
ligeiro13 0:ebea19a646c3 4037 // RS command or data
ligeiro13 0:ebea19a646c3 4038 //
ligeiro13 0:ebea19a646c3 4039 // RS=1 means that next byte is data, RS=0 means that next byte is command
ligeiro13 0:ebea19a646c3 4040 //
ligeiro13 0:ebea19a646c3 4041
ligeiro13 0:ebea19a646c3 4042 if (value) {
ligeiro13 0:ebea19a646c3 4043 _controlbyte = 0x01; // Next byte is data
ligeiro13 0:ebea19a646c3 4044 }
ligeiro13 0:ebea19a646c3 4045 else {
ligeiro13 0:ebea19a646c3 4046 _controlbyte = 0x00; // Next byte is command
ligeiro13 0:ebea19a646c3 4047 }
ligeiro13 0:ebea19a646c3 4048 }
ligeiro13 0:ebea19a646c3 4049
ligeiro13 0:ebea19a646c3 4050 // Set BL pin
ligeiro13 0:ebea19a646c3 4051 void TextLCD_SPI_N_3_9::_setBL(bool value) {
ligeiro13 0:ebea19a646c3 4052 if (_bl) {
ligeiro13 0:ebea19a646c3 4053 _bl->write(value);
ligeiro13 0:ebea19a646c3 4054 }
ligeiro13 0:ebea19a646c3 4055 }
ligeiro13 0:ebea19a646c3 4056
ligeiro13 0:ebea19a646c3 4057 // Not used in this mode
ligeiro13 0:ebea19a646c3 4058 void TextLCD_SPI_N_3_9::_setData(int value) {
ligeiro13 0:ebea19a646c3 4059 }
ligeiro13 0:ebea19a646c3 4060
ligeiro13 0:ebea19a646c3 4061 // Write a byte using SPI3 9 bits mode
ligeiro13 0:ebea19a646c3 4062 void TextLCD_SPI_N_3_9::_writeByte(int value) {
ligeiro13 0:ebea19a646c3 4063 _cs = 0;
ligeiro13 0:ebea19a646c3 4064 wait_us(1);
ligeiro13 0:ebea19a646c3 4065 _spi->write( (_controlbyte << 8) | (value & 0xFF));
ligeiro13 0:ebea19a646c3 4066 wait_us(1);
ligeiro13 0:ebea19a646c3 4067 _cs = 1;
ligeiro13 0:ebea19a646c3 4068 }
ligeiro13 0:ebea19a646c3 4069 #endif /* Native SPI bus */
ligeiro13 0:ebea19a646c3 4070 //------- End TextLCD_SPI_N_3_9 -----------
ligeiro13 0:ebea19a646c3 4071
ligeiro13 0:ebea19a646c3 4072
ligeiro13 0:ebea19a646c3 4073 //------- Start TextLCD_SPI_N_3_10 --------
ligeiro13 0:ebea19a646c3 4074 #if(LCD_SPI_N_3_10 == 1) /* Native SPI bus */
ligeiro13 0:ebea19a646c3 4075
ligeiro13 0:ebea19a646c3 4076 /** Create a TextLCD interface using a controller with a native SPI3 10 bits interface
ligeiro13 0:ebea19a646c3 4077 *
ligeiro13 0:ebea19a646c3 4078 * @param spi SPI Bus
ligeiro13 0:ebea19a646c3 4079 * @param cs chip select pin (active low)
ligeiro13 0:ebea19a646c3 4080 * @param type Sets the panel size/addressing mode (default = LCD16x2)
ligeiro13 0:ebea19a646c3 4081 * @param bl Backlight control line (optional, default = NC)
ligeiro13 0:ebea19a646c3 4082 * @param ctrl LCD controller (default = AIP31068)
ligeiro13 0:ebea19a646c3 4083 */
ligeiro13 0:ebea19a646c3 4084 TextLCD_SPI_N_3_10::TextLCD_SPI_N_3_10(SPI *spi, PinName cs, LCDType type, PinName bl, LCDCtrl ctrl) :
ligeiro13 0:ebea19a646c3 4085 TextLCD_Base(type, ctrl),
ligeiro13 0:ebea19a646c3 4086 _spi(spi),
ligeiro13 0:ebea19a646c3 4087 _cs(cs) {
ligeiro13 0:ebea19a646c3 4088
ligeiro13 0:ebea19a646c3 4089 // Init CS
ligeiro13 0:ebea19a646c3 4090 _cs = 1;
ligeiro13 0:ebea19a646c3 4091
ligeiro13 0:ebea19a646c3 4092 // Setup the spi for 10 bit data, low steady state clock,
ligeiro13 0:ebea19a646c3 4093 // rising edge capture, with a 500KHz or 1MHz clock rate
ligeiro13 0:ebea19a646c3 4094 _spi->format(10,0);
ligeiro13 0:ebea19a646c3 4095 _spi->frequency(1000000);
ligeiro13 0:ebea19a646c3 4096
ligeiro13 0:ebea19a646c3 4097 // The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
ligeiro13 0:ebea19a646c3 4098 if (bl != NC) {
ligeiro13 0:ebea19a646c3 4099 _bl = new DigitalOut(bl); //Construct new pin
ligeiro13 0:ebea19a646c3 4100 _bl->write(0); //Deactivate
ligeiro13 0:ebea19a646c3 4101 }
ligeiro13 0:ebea19a646c3 4102 else {
ligeiro13 0:ebea19a646c3 4103 // No Hardware Backlight pin
ligeiro13 0:ebea19a646c3 4104 _bl = NULL; //Construct dummy pin
ligeiro13 0:ebea19a646c3 4105 }
ligeiro13 0:ebea19a646c3 4106
ligeiro13 0:ebea19a646c3 4107 //Sanity check
ligeiro13 0:ebea19a646c3 4108 if (_ctrl & LCD_C_SPI3_10) {
ligeiro13 0:ebea19a646c3 4109 _init(_LCD_DL_8); // Set Datalength to 8 bit for all native serial interfaces
ligeiro13 0:ebea19a646c3 4110 }
ligeiro13 0:ebea19a646c3 4111 else {
ligeiro13 0:ebea19a646c3 4112 error("Error: LCD Controller type does not support native SPI3 10 bits interface\n\r");
ligeiro13 0:ebea19a646c3 4113 }
ligeiro13 0:ebea19a646c3 4114 }
ligeiro13 0:ebea19a646c3 4115
ligeiro13 0:ebea19a646c3 4116 TextLCD_SPI_N_3_10::~TextLCD_SPI_N_3_10() {
ligeiro13 0:ebea19a646c3 4117 if (_bl != NULL) {delete _bl;} // BL pin
ligeiro13 0:ebea19a646c3 4118 }
ligeiro13 0:ebea19a646c3 4119
ligeiro13 0:ebea19a646c3 4120 // Not used in this mode
ligeiro13 0:ebea19a646c3 4121 void TextLCD_SPI_N_3_10::_setEnable(bool value) {
ligeiro13 0:ebea19a646c3 4122 }
ligeiro13 0:ebea19a646c3 4123
ligeiro13 0:ebea19a646c3 4124 // Set RS pin
ligeiro13 0:ebea19a646c3 4125 // Used for mbed pins, I2C bus expander or SPI shiftregister
ligeiro13 0:ebea19a646c3 4126 void TextLCD_SPI_N_3_10::_setRS(bool value) {
ligeiro13 0:ebea19a646c3 4127 // The controlbits define the meaning of the next byte. This next byte can either be data or command.
ligeiro13 0:ebea19a646c3 4128 // b9 b8 b7...........b0
ligeiro13 0:ebea19a646c3 4129 // RS RW command or data
ligeiro13 0:ebea19a646c3 4130 //
ligeiro13 0:ebea19a646c3 4131 // RS=1 means that next byte is data, RS=0 means that next byte is command
ligeiro13 0:ebea19a646c3 4132 // RW=0 means that next byte is writen, RW=1 means that next byte is read (not used in this lib)
ligeiro13 0:ebea19a646c3 4133 //
ligeiro13 0:ebea19a646c3 4134
ligeiro13 0:ebea19a646c3 4135 if (value) {
ligeiro13 0:ebea19a646c3 4136 _controlbyte = 0x02; // Next byte is data
ligeiro13 0:ebea19a646c3 4137 }
ligeiro13 0:ebea19a646c3 4138 else {
ligeiro13 0:ebea19a646c3 4139 _controlbyte = 0x00; // Next byte is command
ligeiro13 0:ebea19a646c3 4140 }
ligeiro13 0:ebea19a646c3 4141 }
ligeiro13 0:ebea19a646c3 4142
ligeiro13 0:ebea19a646c3 4143 // Set BL pin
ligeiro13 0:ebea19a646c3 4144 void TextLCD_SPI_N_3_10::_setBL(bool value) {
ligeiro13 0:ebea19a646c3 4145 if (_bl) {
ligeiro13 0:ebea19a646c3 4146 _bl->write(value);
ligeiro13 0:ebea19a646c3 4147 }
ligeiro13 0:ebea19a646c3 4148 }
ligeiro13 0:ebea19a646c3 4149
ligeiro13 0:ebea19a646c3 4150 // Not used in this mode
ligeiro13 0:ebea19a646c3 4151 void TextLCD_SPI_N_3_10::_setData(int value) {
ligeiro13 0:ebea19a646c3 4152 }
ligeiro13 0:ebea19a646c3 4153
ligeiro13 0:ebea19a646c3 4154 // Write a byte using SPI3 10 bits mode
ligeiro13 0:ebea19a646c3 4155 void TextLCD_SPI_N_3_10::_writeByte(int value) {
ligeiro13 0:ebea19a646c3 4156 _cs = 0;
ligeiro13 0:ebea19a646c3 4157 wait_us(1);
ligeiro13 0:ebea19a646c3 4158 _spi->write( (_controlbyte << 8) | (value & 0xFF));
ligeiro13 0:ebea19a646c3 4159 wait_us(1);
ligeiro13 0:ebea19a646c3 4160 _cs = 1;
ligeiro13 0:ebea19a646c3 4161 }
ligeiro13 0:ebea19a646c3 4162 #endif /* Native SPI bus */
ligeiro13 0:ebea19a646c3 4163 //------- End TextLCD_SPI_N_3_10 ----------
ligeiro13 0:ebea19a646c3 4164
ligeiro13 0:ebea19a646c3 4165
ligeiro13 0:ebea19a646c3 4166 //------- Start TextLCD_SPI_N_3_16 --------
ligeiro13 0:ebea19a646c3 4167 #if(LCD_SPI_N_3_16 == 1) /* Native SPI bus */
ligeiro13 0:ebea19a646c3 4168
ligeiro13 0:ebea19a646c3 4169 /** Create a TextLCD interface using a controller with a native SPI3 16 bits interface
ligeiro13 0:ebea19a646c3 4170 *
ligeiro13 0:ebea19a646c3 4171 * @param spi SPI Bus
ligeiro13 0:ebea19a646c3 4172 * @param cs chip select pin (active low)
ligeiro13 0:ebea19a646c3 4173 * @param type Sets the panel size/addressing mode (default = LCD16x2)
ligeiro13 0:ebea19a646c3 4174 * @param bl Backlight control line (optional, default = NC)
ligeiro13 0:ebea19a646c3 4175 * @param ctrl LCD controller (default = PT6314)
ligeiro13 0:ebea19a646c3 4176 */
ligeiro13 0:ebea19a646c3 4177 TextLCD_SPI_N_3_16::TextLCD_SPI_N_3_16(SPI *spi, PinName cs, LCDType type, PinName bl, LCDCtrl ctrl) :
ligeiro13 0:ebea19a646c3 4178 TextLCD_Base(type, ctrl),
ligeiro13 0:ebea19a646c3 4179 _spi(spi),
ligeiro13 0:ebea19a646c3 4180 _cs(cs) {
ligeiro13 0:ebea19a646c3 4181
ligeiro13 0:ebea19a646c3 4182 // Init CS
ligeiro13 0:ebea19a646c3 4183 _cs = 1;
ligeiro13 0:ebea19a646c3 4184
ligeiro13 0:ebea19a646c3 4185 // Setup the spi for 8 bit data, low steady state clock,
ligeiro13 0:ebea19a646c3 4186 // rising edge capture, with a 500KHz or 1MHz clock rate
ligeiro13 0:ebea19a646c3 4187 _spi->format(8,0);
ligeiro13 0:ebea19a646c3 4188 _spi->frequency(1000000);
ligeiro13 0:ebea19a646c3 4189
ligeiro13 0:ebea19a646c3 4190 // The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
ligeiro13 0:ebea19a646c3 4191 if (bl != NC) {
ligeiro13 0:ebea19a646c3 4192 _bl = new DigitalOut(bl); //Construct new pin
ligeiro13 0:ebea19a646c3 4193 _bl->write(0); //Deactivate
ligeiro13 0:ebea19a646c3 4194 }
ligeiro13 0:ebea19a646c3 4195 else {
ligeiro13 0:ebea19a646c3 4196 // No Hardware Backlight pin
ligeiro13 0:ebea19a646c3 4197 _bl = NULL; //Construct dummy pin
ligeiro13 0:ebea19a646c3 4198 }
ligeiro13 0:ebea19a646c3 4199
ligeiro13 0:ebea19a646c3 4200 //Sanity check
ligeiro13 0:ebea19a646c3 4201 if (_ctrl & LCD_C_SPI3_16) {
ligeiro13 0:ebea19a646c3 4202 _init(_LCD_DL_8); // Set Datalength to 8 bit for all native serial interfaces
ligeiro13 0:ebea19a646c3 4203 }
ligeiro13 0:ebea19a646c3 4204 else {
ligeiro13 0:ebea19a646c3 4205 error("Error: LCD Controller type does not support native SPI3 16 bits interface\n\r");
ligeiro13 0:ebea19a646c3 4206 }
ligeiro13 0:ebea19a646c3 4207 }
ligeiro13 0:ebea19a646c3 4208
ligeiro13 0:ebea19a646c3 4209 TextLCD_SPI_N_3_16::~TextLCD_SPI_N_3_16() {
ligeiro13 0:ebea19a646c3 4210 if (_bl != NULL) {delete _bl;} // BL pin
ligeiro13 0:ebea19a646c3 4211 }
ligeiro13 0:ebea19a646c3 4212
ligeiro13 0:ebea19a646c3 4213 // Not used in this mode
ligeiro13 0:ebea19a646c3 4214 void TextLCD_SPI_N_3_16::_setEnable(bool value) {
ligeiro13 0:ebea19a646c3 4215 }
ligeiro13 0:ebea19a646c3 4216
ligeiro13 0:ebea19a646c3 4217 // Set RS pin
ligeiro13 0:ebea19a646c3 4218 // Used for mbed pins, I2C bus expander or SPI shiftregister
ligeiro13 0:ebea19a646c3 4219 void TextLCD_SPI_N_3_16::_setRS(bool value) {
ligeiro13 0:ebea19a646c3 4220 // The 16bit mode is split in 2 bytes. The first byte is for synchronisation and controlbits. The controlbits define the meaning of the next byte.
ligeiro13 0:ebea19a646c3 4221 // The 8 actual bits represent either a data or a command byte.
ligeiro13 0:ebea19a646c3 4222 // b15 b14 b13 b12 b11 b10 b9 b8 - b7 b6 b5 b4 b3 b2 b1 b0
ligeiro13 0:ebea19a646c3 4223 // 1 1 1 1 1 RW RS 0 d7 d6 d5 d4 d3 d2 d1 d0
ligeiro13 0:ebea19a646c3 4224 //
ligeiro13 0:ebea19a646c3 4225 // RS=1 means that next byte is data, RS=0 means that next byte is command
ligeiro13 0:ebea19a646c3 4226 // RW=0 means that next byte is writen, RW=1 means that next byte is read (not used in this lib)
ligeiro13 0:ebea19a646c3 4227 //
ligeiro13 0:ebea19a646c3 4228
ligeiro13 0:ebea19a646c3 4229 if (value) {
ligeiro13 0:ebea19a646c3 4230 _controlbyte = 0xFA; // Next byte is data
ligeiro13 0:ebea19a646c3 4231 }
ligeiro13 0:ebea19a646c3 4232 else {
ligeiro13 0:ebea19a646c3 4233 _controlbyte = 0xF8; // Next byte is command
ligeiro13 0:ebea19a646c3 4234 }
ligeiro13 0:ebea19a646c3 4235 }
ligeiro13 0:ebea19a646c3 4236
ligeiro13 0:ebea19a646c3 4237 // Set BL pin
ligeiro13 0:ebea19a646c3 4238 void TextLCD_SPI_N_3_16::_setBL(bool value) {
ligeiro13 0:ebea19a646c3 4239 if (_bl) {
ligeiro13 0:ebea19a646c3 4240 _bl->write(value);
ligeiro13 0:ebea19a646c3 4241 }
ligeiro13 0:ebea19a646c3 4242 }
ligeiro13 0:ebea19a646c3 4243
ligeiro13 0:ebea19a646c3 4244 // Not used in this mode
ligeiro13 0:ebea19a646c3 4245 void TextLCD_SPI_N_3_16::_setData(int value) {
ligeiro13 0:ebea19a646c3 4246 }
ligeiro13 0:ebea19a646c3 4247
ligeiro13 0:ebea19a646c3 4248 // Write a byte using SPI3 16 bits mode
ligeiro13 0:ebea19a646c3 4249 void TextLCD_SPI_N_3_16::_writeByte(int value) {
ligeiro13 0:ebea19a646c3 4250 _cs = 0;
ligeiro13 0:ebea19a646c3 4251 wait_us(1);
ligeiro13 0:ebea19a646c3 4252
ligeiro13 0:ebea19a646c3 4253 _spi->write(_controlbyte);
ligeiro13 0:ebea19a646c3 4254
ligeiro13 0:ebea19a646c3 4255 _spi->write(value);
ligeiro13 0:ebea19a646c3 4256
ligeiro13 0:ebea19a646c3 4257 wait_us(1);
ligeiro13 0:ebea19a646c3 4258 _cs = 1;
ligeiro13 0:ebea19a646c3 4259 }
ligeiro13 0:ebea19a646c3 4260 #endif /* Native SPI bus */
ligeiro13 0:ebea19a646c3 4261 //------- End TextLCD_SPI_N_3_16 ----------
ligeiro13 0:ebea19a646c3 4262
ligeiro13 0:ebea19a646c3 4263
ligeiro13 0:ebea19a646c3 4264 //------- Start TextLCD_SPI_N_3_24 --------
ligeiro13 0:ebea19a646c3 4265 #if(LCD_SPI_N_3_24 == 1) /* Native SPI bus */
ligeiro13 0:ebea19a646c3 4266
ligeiro13 0:ebea19a646c3 4267 /** Create a TextLCD interface using a controller with a native SPI3 24 bits interface
ligeiro13 0:ebea19a646c3 4268 *
ligeiro13 0:ebea19a646c3 4269 * @param spi SPI Bus
ligeiro13 0:ebea19a646c3 4270 * @param cs chip select pin (active low)
ligeiro13 0:ebea19a646c3 4271 * @param type Sets the panel size/addressing mode (default = LCD16x2)
ligeiro13 0:ebea19a646c3 4272 * @param bl Backlight control line (optional, default = NC)
ligeiro13 0:ebea19a646c3 4273 * @param ctrl LCD controller (default = SSD1803)
ligeiro13 0:ebea19a646c3 4274 */
ligeiro13 0:ebea19a646c3 4275 TextLCD_SPI_N_3_24::TextLCD_SPI_N_3_24(SPI *spi, PinName cs, LCDType type, PinName bl, LCDCtrl ctrl) :
ligeiro13 0:ebea19a646c3 4276 TextLCD_Base(type, ctrl),
ligeiro13 0:ebea19a646c3 4277 _spi(spi),
ligeiro13 0:ebea19a646c3 4278 _cs(cs) {
ligeiro13 0:ebea19a646c3 4279
ligeiro13 0:ebea19a646c3 4280 // Init CS
ligeiro13 0:ebea19a646c3 4281 _cs = 1;
ligeiro13 0:ebea19a646c3 4282
ligeiro13 0:ebea19a646c3 4283 // Setup the spi for 8 bit data, high steady state clock,
ligeiro13 0:ebea19a646c3 4284 // rising edge capture, with a 500KHz or 1MHz clock rate
ligeiro13 0:ebea19a646c3 4285 _spi->format(8,3);
ligeiro13 0:ebea19a646c3 4286 _spi->frequency(1000000);
ligeiro13 0:ebea19a646c3 4287
ligeiro13 0:ebea19a646c3 4288 // The hardware Backlight pin is optional. Test and make sure whether it exists or not to prevent illegal access.
ligeiro13 0:ebea19a646c3 4289 if (bl != NC) {
ligeiro13 0:ebea19a646c3 4290 _bl = new DigitalOut(bl); //Construct new pin
ligeiro13 0:ebea19a646c3 4291 _bl->write(0); //Deactivate
ligeiro13 0:ebea19a646c3 4292 }
ligeiro13 0:ebea19a646c3 4293 else {
ligeiro13 0:ebea19a646c3 4294 // No Hardware Backlight pin
ligeiro13 0:ebea19a646c3 4295 _bl = NULL; //Construct dummy pin
ligeiro13 0:ebea19a646c3 4296 }
ligeiro13 0:ebea19a646c3 4297
ligeiro13 0:ebea19a646c3 4298 //Sanity check
ligeiro13 0:ebea19a646c3 4299 if (_ctrl & LCD_C_SPI3_24) {
ligeiro13 0:ebea19a646c3 4300 _init(_LCD_DL_8); // Set Datalength to 8 bit for all native serial interfaces
ligeiro13 0:ebea19a646c3 4301 }
ligeiro13 0:ebea19a646c3 4302 else {
ligeiro13 0:ebea19a646c3 4303 error("Error: LCD Controller type does not support native SPI3 24 bits interface\n\r");
ligeiro13 0:ebea19a646c3 4304 }
ligeiro13 0:ebea19a646c3 4305 }
ligeiro13 0:ebea19a646c3 4306
ligeiro13 0:ebea19a646c3 4307 TextLCD_SPI_N_3_24::~TextLCD_SPI_N_3_24() {
ligeiro13 0:ebea19a646c3 4308 if (_bl != NULL) {delete _bl;} // BL pin
ligeiro13 0:ebea19a646c3 4309 }
ligeiro13 0:ebea19a646c3 4310
ligeiro13 0:ebea19a646c3 4311 // Not used in this mode
ligeiro13 0:ebea19a646c3 4312 void TextLCD_SPI_N_3_24::_setEnable(bool value) {
ligeiro13 0:ebea19a646c3 4313 }
ligeiro13 0:ebea19a646c3 4314
ligeiro13 0:ebea19a646c3 4315 // Set RS pin
ligeiro13 0:ebea19a646c3 4316 // Used for mbed pins, I2C bus expander or SPI shiftregister
ligeiro13 0:ebea19a646c3 4317 void TextLCD_SPI_N_3_24::_setRS(bool value) {
ligeiro13 0:ebea19a646c3 4318 // The 24bit mode is split in 3 bytes. The first byte is for synchronisation and controlbits. The controlbits define the meaning of the next two bytes.
ligeiro13 0:ebea19a646c3 4319 // Each byte encodes 4 actual bits. The 8 actual bits represent either a data or a command byte.
ligeiro13 0:ebea19a646c3 4320 // b23 b22 b21 b20 b19 b18 b17 b16 - b15 b14 b13 b12 b11 b10 b9 b8 - b7 b6 b5 b4 b3 b2 b1 b0
ligeiro13 0:ebea19a646c3 4321 // 1 1 1 1 1 RW RS 0 d0 d1 d2 d3 0 0 0 0 d4 d5 d6 d7 0 0 0 0
ligeiro13 0:ebea19a646c3 4322 //
ligeiro13 0:ebea19a646c3 4323 // RS=1 means that next byte is data, RS=0 means that next byte is command
ligeiro13 0:ebea19a646c3 4324 // RW=0 means that next byte is writen, RW=1 means that next byte is read (not used in this lib)
ligeiro13 0:ebea19a646c3 4325 //
ligeiro13 0:ebea19a646c3 4326 // Note: SPI3_24 expects LSB first. This is inconsistent with regular SPI convention (and hardware) that sends MSB first.
ligeiro13 0:ebea19a646c3 4327
ligeiro13 0:ebea19a646c3 4328 if (value) {
ligeiro13 0:ebea19a646c3 4329 _controlbyte = 0xFA; // Next byte is data
ligeiro13 0:ebea19a646c3 4330 }
ligeiro13 0:ebea19a646c3 4331 else {
ligeiro13 0:ebea19a646c3 4332 _controlbyte = 0xF8; // Next byte is command
ligeiro13 0:ebea19a646c3 4333 }
ligeiro13 0:ebea19a646c3 4334 }
ligeiro13 0:ebea19a646c3 4335
ligeiro13 0:ebea19a646c3 4336 // Set BL pin
ligeiro13 0:ebea19a646c3 4337 void TextLCD_SPI_N_3_24::_setBL(bool value) {
ligeiro13 0:ebea19a646c3 4338 if (_bl) {
ligeiro13 0:ebea19a646c3 4339 _bl->write(value);
ligeiro13 0:ebea19a646c3 4340 }
ligeiro13 0:ebea19a646c3 4341 }
ligeiro13 0:ebea19a646c3 4342
ligeiro13 0:ebea19a646c3 4343 // Not used in this mode
ligeiro13 0:ebea19a646c3 4344 void TextLCD_SPI_N_3_24::_setData(int value) {
ligeiro13 0:ebea19a646c3 4345 }
ligeiro13 0:ebea19a646c3 4346
ligeiro13 0:ebea19a646c3 4347 //Mapping table to flip the bits around cause SPI3_24 expects LSB first.
ligeiro13 0:ebea19a646c3 4348 const uint8_t map3_24[16] = {0x00, 0x80, 0x40, 0xC0, 0x20, 0xA0, 0x60, 0xE0, 0x10, 0x90, 0x50, 0xD0, 0x30, 0xB0, 0x70, 0xF0};
ligeiro13 0:ebea19a646c3 4349
ligeiro13 0:ebea19a646c3 4350 // Write a byte using SPI3 24 bits mode
ligeiro13 0:ebea19a646c3 4351 void TextLCD_SPI_N_3_24::_writeByte(int value) {
ligeiro13 0:ebea19a646c3 4352 _cs = 0;
ligeiro13 0:ebea19a646c3 4353 wait_us(1);
ligeiro13 0:ebea19a646c3 4354 _spi->write(_controlbyte);
ligeiro13 0:ebea19a646c3 4355
ligeiro13 0:ebea19a646c3 4356 //Map and send the LSB nibble
ligeiro13 0:ebea19a646c3 4357 _spi->write( map3_24[value & 0x0F]);
ligeiro13 0:ebea19a646c3 4358
ligeiro13 0:ebea19a646c3 4359 //Map and send the MSB nibble
ligeiro13 0:ebea19a646c3 4360 _spi->write( map3_24[(value >> 4) & 0x0F]);
ligeiro13 0:ebea19a646c3 4361
ligeiro13 0:ebea19a646c3 4362 wait_us(1);
ligeiro13 0:ebea19a646c3 4363 _cs = 1;
ligeiro13 0:ebea19a646c3 4364 }
ligeiro13 0:ebea19a646c3 4365 #endif /* Native SPI bus */
ligeiro13 0:ebea19a646c3 4366 //------- End TextLCD_SPI_N_3_24 ----------