Steffen Arntz / TFTLCD

This is a port of Henning Kralsen's UTFT library for Arduino/chipKIT to mbed, refactored to make full use of C inheritance and access control, in order to reduce work when implementing new drivers and at the same time make the code more readable and easier to maintain. As of now supported are SSD1289 (16-bit interface), HX8340-B (serial interface) and ST7735 (serial interface). Drivers for other controllers will be added as time and resources to acquire the displays to test the code permit.

Dependents:   UTFT_SSD1289

Fork of TFTLCD by Todor Todorov

st7735.cpp@28:89a1399409ff, 2016-02-16 (annotated)

Committer:
DooMMasteR
Date:
Tue Feb 16 19:09:15 2016 +0000
Revision:
28:89a1399409ff
Parent:
22:4c169297f374 
make size of the ST7735 variable, while not breaking old functionality;

Who changed what in which revision?

UserRevisionLine numberNew contents of line
ttodorov 9:58b328831d0a 1 /*
ttodorov 9:58b328831d0a 2 * Copyright (C)2010-2012 Henning Karlsen. All right reserved.
ttodorov 9:58b328831d0a 3 * Copyright (C)2012 Todor Todorov.
ttodorov 9:58b328831d0a 4 *
ttodorov 9:58b328831d0a 5 * This library is free software; you can redistribute it and/or
ttodorov 9:58b328831d0a 6 * modify it under the terms of the GNU Lesser General Public
ttodorov 9:58b328831d0a 7 * License as published by the Free Software Foundation; either
ttodorov 9:58b328831d0a 8 * version 2.1 of the License, or (at your option) any later version.
ttodorov 9:58b328831d0a 9 *
ttodorov 9:58b328831d0a 10 * This library is distributed in the hope that it will be useful,
ttodorov 9:58b328831d0a 11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
ttodorov 9:58b328831d0a 12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
ttodorov 9:58b328831d0a 13 * Lesser General Public License for more details.
ttodorov 9:58b328831d0a 14 *
ttodorov 9:58b328831d0a 15 * You should have received a copy of the GNU Lesser General Public
ttodorov 9:58b328831d0a 16 * License along with this library; if not, write to:
ttodorov 9:58b328831d0a 17 *
ttodorov 9:58b328831d0a 18 * Free Software Foundation, Inc.
ttodorov 9:58b328831d0a 19 * 51 Franklin St, 5th Floor, Boston, MA 02110-1301, USA
ttodorov 9:58b328831d0a 20 *
ttodorov 9:58b328831d0a 21 *********************************************************************/
ttodorov 9:58b328831d0a 22 #include "st7735.h"
ttodorov 9:58b328831d0a 23 #include "helpers.h"
ttodorov 9:58b328831d0a 24
DooMMasteR 28:89a1399409ff 25 ST7735_LCD::ST7735_LCD( PinName CS, PinName RESET, PinName RS, PinName SCL, PinName SDA, PinName BL, backlight_t blType, float defaultBackLightLevel, int width, int height)
DooMMasteR 28:89a1399409ff 26 : LCD( width, height, CS, RS, RESET, BL, blType, defaultBackLightLevel ), _lcd_pin_scl( SCL ), _lcd_pin_sda( SDA )
ttodorov 9:58b328831d0a 27 {
ttodorov 9:58b328831d0a 28 }
ttodorov 9:58b328831d0a 29
ttodorov 12:d0978272a340 30 void ST7735_LCD::Initialize( orientation_t orientation, colordepth_t colors )
ttodorov 9:58b328831d0a 31 {
ttodorov 9:58b328831d0a 32 _orientation = orientation;
ttodorov 12:d0978272a340 33 _colorDepth = colors;
ttodorov 9:58b328831d0a 34
ttodorov 9:58b328831d0a 35 wait_ms( 100 );
ttodorov 9:58b328831d0a 36 _lcd_pin_reset = HIGH;
ttodorov 9:58b328831d0a 37 wait_ms( 5 );
ttodorov 9:58b328831d0a 38 _lcd_pin_reset = LOW;
ttodorov 9:58b328831d0a 39 wait_ms( 15 );
ttodorov 9:58b328831d0a 40 _lcd_pin_reset = HIGH;
ttodorov 9:58b328831d0a 41 _lcd_pin_cs = HIGH;
ttodorov 9:58b328831d0a 42 _lcd_pin_rs = HIGH;
ttodorov 9:58b328831d0a 43 _lcd_pin_scl = HIGH;
ttodorov 9:58b328831d0a 44 _lcd_pin_sda = HIGH;
ttodorov 9:58b328831d0a 45 if ( _lcd_pin_bl != 0 )
ttodorov 9:58b328831d0a 46 *_lcd_pin_bl = HIGH;
ttodorov 22:4c169297f374 47 else if ( _bl_pwm != 0 )
ttodorov 22:4c169297f374 48 *_bl_pwm = _bl_pwm_default;
ttodorov 9:58b328831d0a 49 wait_ms( 55 );
ttodorov 9:58b328831d0a 50
ttodorov 9:58b328831d0a 51 Activate();
ttodorov 9:58b328831d0a 52 WriteCmd( 0x01 ); // SW reset
ttodorov 9:58b328831d0a 53 wait_ms( 120 );
ttodorov 9:58b328831d0a 54
ttodorov 9:58b328831d0a 55 WriteCmd( 0x11 ); // sleep out
ttodorov 9:58b328831d0a 56 wait_ms( 120 );
ttodorov 9:58b328831d0a 57
ttodorov 9:58b328831d0a 58 WriteCmd( 0xB1 ); // frame control 1
ttodorov 9:58b328831d0a 59 WriteByteData( 0x01 );
ttodorov 9:58b328831d0a 60 WriteByteData( 0x2C );
ttodorov 9:58b328831d0a 61 WriteByteData( 0x2D );
ttodorov 14:8efbe7361dae 62
ttodorov 9:58b328831d0a 63 WriteCmd( 0xB2 ); // frame control 2
ttodorov 9:58b328831d0a 64 WriteByteData( 0x01 );
ttodorov 9:58b328831d0a 65 WriteByteData( 0x2C );
ttodorov 9:58b328831d0a 66 WriteByteData( 0x2D );
ttodorov 14:8efbe7361dae 67
ttodorov 9:58b328831d0a 68 WriteCmd( 0xB3 ); // frame control 3
ttodorov 9:58b328831d0a 69 WriteByteData( 0x01 );
ttodorov 9:58b328831d0a 70 WriteByteData( 0x2C );
ttodorov 9:58b328831d0a 71 WriteByteData( 0x2D );
ttodorov 9:58b328831d0a 72 WriteByteData( 0x01 );
ttodorov 9:58b328831d0a 73 WriteByteData( 0x2C );
ttodorov 9:58b328831d0a 74 WriteByteData( 0x2D );
ttodorov 9:58b328831d0a 75
ttodorov 9:58b328831d0a 76 WriteCmd( 0xB4 ); // column inversion
ttodorov 14:8efbe7361dae 77 //WriteByteData( 0x07 );
ttodorov 14:8efbe7361dae 78 WriteByteData( 0x00 );
ttodorov 9:58b328831d0a 79
ttodorov 9:58b328831d0a 80 // ST7735R Power Sequence
ttodorov 9:58b328831d0a 81 WriteCmd( 0xC0 ); // power control 1
ttodorov 9:58b328831d0a 82 WriteByteData( 0xA2 );
ttodorov 9:58b328831d0a 83 WriteByteData( 0x02 );
ttodorov 9:58b328831d0a 84 WriteByteData( 0x84 );
ttodorov 14:8efbe7361dae 85
ttodorov 9:58b328831d0a 86 WriteCmd( 0xC1 ); // power control 2
ttodorov 9:58b328831d0a 87 WriteByteData( 0xC5 );
ttodorov 14:8efbe7361dae 88
ttodorov 9:58b328831d0a 89 WriteCmd( 0xC2 ); // power control 3
ttodorov 9:58b328831d0a 90 WriteByteData( 0x0A );
ttodorov 9:58b328831d0a 91 WriteByteData( 0x00 );
ttodorov 14:8efbe7361dae 92
ttodorov 9:58b328831d0a 93 WriteCmd( 0xC3 ); // power control 4
ttodorov 9:58b328831d0a 94 WriteByteData( 0x8A );
ttodorov 9:58b328831d0a 95 WriteByteData( 0x2A );
ttodorov 14:8efbe7361dae 96
ttodorov 9:58b328831d0a 97 WriteCmd( 0xC4 ); // power control 5
ttodorov 9:58b328831d0a 98 WriteByteData( 0x8A );
ttodorov 9:58b328831d0a 99 WriteByteData( 0xEE );
ttodorov 9:58b328831d0a 100
ttodorov 9:58b328831d0a 101 WriteCmd( 0xC5 ); // voltage control 1
ttodorov 9:58b328831d0a 102 WriteByteData( 0x0E );
ttodorov 9:58b328831d0a 103
ttodorov 9:58b328831d0a 104 // ST7735R Gamma Sequence
ttodorov 9:58b328831d0a 105 WriteCmd( 0xE0 ); // gamma positive
ttodorov 9:58b328831d0a 106 WriteByteData( 0x0F );
ttodorov 9:58b328831d0a 107 WriteByteData( 0x1A );
ttodorov 9:58b328831d0a 108 WriteByteData( 0x0F );
ttodorov 9:58b328831d0a 109 WriteByteData( 0x18 );
ttodorov 9:58b328831d0a 110 WriteByteData( 0x2F );
ttodorov 9:58b328831d0a 111 WriteByteData( 0x28 );
ttodorov 9:58b328831d0a 112 WriteByteData( 0x20 );
ttodorov 9:58b328831d0a 113 WriteByteData( 0x22 );
ttodorov 9:58b328831d0a 114 WriteByteData( 0x1F );
ttodorov 9:58b328831d0a 115 WriteByteData( 0x1B );
ttodorov 9:58b328831d0a 116 WriteByteData( 0x23 );
ttodorov 9:58b328831d0a 117 WriteByteData( 0x37 );
ttodorov 9:58b328831d0a 118 WriteByteData( 0x00 );
ttodorov 9:58b328831d0a 119 WriteByteData( 0x07 );
ttodorov 9:58b328831d0a 120 WriteByteData( 0x02 );
ttodorov 9:58b328831d0a 121 WriteByteData( 0x10 );
ttodorov 14:8efbe7361dae 122
ttodorov 9:58b328831d0a 123 WriteCmd( 0xE1 ); // gamma negative
ttodorov 9:58b328831d0a 124 WriteByteData( 0x0F );
ttodorov 9:58b328831d0a 125 WriteByteData( 0x1B );
ttodorov 9:58b328831d0a 126 WriteByteData( 0x0F );
ttodorov 9:58b328831d0a 127 WriteByteData( 0x17 );
ttodorov 9:58b328831d0a 128 WriteByteData( 0x33 );
ttodorov 9:58b328831d0a 129 WriteByteData( 0x2C );
ttodorov 9:58b328831d0a 130 WriteByteData( 0x29 );
ttodorov 9:58b328831d0a 131 WriteByteData( 0x2E );
ttodorov 9:58b328831d0a 132 WriteByteData( 0x30 );
ttodorov 9:58b328831d0a 133 WriteByteData( 0x30 );
ttodorov 9:58b328831d0a 134 WriteByteData( 0x39 );
ttodorov 9:58b328831d0a 135 WriteByteData( 0x3F );
ttodorov 9:58b328831d0a 136 WriteByteData( 0x00 );
ttodorov 9:58b328831d0a 137 WriteByteData( 0x07 );
ttodorov 9:58b328831d0a 138 WriteByteData( 0x03 );
ttodorov 9:58b328831d0a 139 WriteByteData( 0x10 );
ttodorov 9:58b328831d0a 140
ttodorov 9:58b328831d0a 141 WriteCmd( 0x2A ); // set column address
ttodorov 9:58b328831d0a 142 WriteByteData( 0x00 );
ttodorov 9:58b328831d0a 143 WriteByteData( 0x00 );
ttodorov 9:58b328831d0a 144 WriteByteData( 0x00 );
ttodorov 9:58b328831d0a 145 WriteByteData( 0x7F );
ttodorov 14:8efbe7361dae 146
ttodorov 9:58b328831d0a 147 WriteCmd( 0x2B ); // set row address
ttodorov 9:58b328831d0a 148 WriteByteData( 0x00 );
ttodorov 9:58b328831d0a 149 WriteByteData( 0x00 );
ttodorov 9:58b328831d0a 150 WriteByteData( 0x00 );
ttodorov 9:58b328831d0a 151 WriteByteData( 0x9F );
ttodorov 9:58b328831d0a 152
ttodorov 9:58b328831d0a 153 WriteCmd( 0xF0 ); // enable extensions command
ttodorov 9:58b328831d0a 154 WriteByteData( 0x01 );
ttodorov 14:8efbe7361dae 155
ttodorov 9:58b328831d0a 156 WriteCmd( 0xF6 ); // disable ram power save mode
ttodorov 9:58b328831d0a 157 WriteByteData( 0x00 );
ttodorov 9:58b328831d0a 158
ttodorov 12:d0978272a340 159 WriteCmd( 0x3A ); // interface pixel format (color mode): 0x05 => RGB16, 0x06 => RGB18
ttodorov 12:d0978272a340 160 WriteByteData( _colorDepth == RGB16 ? 0x05 : 0x06 );
ttodorov 14:8efbe7361dae 161
ttodorov 14:8efbe7361dae 162 WriteCmd( 0x36 ); //MX, MY, RGB mode
ttodorov 14:8efbe7361dae 163 switch ( _orientation )
ttodorov 14:8efbe7361dae 164 {
ttodorov 20:4bdca8d8dadc 165 case LANDSCAPE: WriteByteData( 0x6C ); break;
ttodorov 14:8efbe7361dae 166 case PORTRAIT_REV: WriteByteData( 0xDC ); break;
ttodorov 20:4bdca8d8dadc 167 case LANDSCAPE_REV: WriteByteData( 0xB8 ); break;
ttodorov 14:8efbe7361dae 168 case PORTRAIT:
ttodorov 14:8efbe7361dae 169 default: WriteByteData( 0x08 ); break;
ttodorov 14:8efbe7361dae 170 }
ttodorov 14:8efbe7361dae 171
ttodorov 9:58b328831d0a 172 WriteCmd( 0x29 ); // display on
ttodorov 9:58b328831d0a 173
ttodorov 9:58b328831d0a 174 Deactivate();
ttodorov 9:58b328831d0a 175 }
ttodorov 9:58b328831d0a 176
ttodorov 9:58b328831d0a 177 void ST7735_LCD::Sleep( void )
ttodorov 9:58b328831d0a 178 {
ttodorov 9:58b328831d0a 179 Activate();
ttodorov 9:58b328831d0a 180 WriteCmd( 0x28 );
ttodorov 9:58b328831d0a 181 wait_ms( 10 );
ttodorov 9:58b328831d0a 182 WriteCmd( 0x10 );
ttodorov 9:58b328831d0a 183 wait_ms( 125 );
ttodorov 22:4c169297f374 184 LCD::Sleep();
ttodorov 9:58b328831d0a 185 Deactivate();
ttodorov 9:58b328831d0a 186 }
ttodorov 9:58b328831d0a 187
ttodorov 9:58b328831d0a 188 void ST7735_LCD::WakeUp( void )
ttodorov 9:58b328831d0a 189 {
ttodorov 9:58b328831d0a 190 Activate();
ttodorov 9:58b328831d0a 191 WriteCmd( 0x29 );
ttodorov 9:58b328831d0a 192 wait_ms( 10 );
ttodorov 9:58b328831d0a 193 WriteCmd( 0x11 );
ttodorov 9:58b328831d0a 194 wait_ms( 125 );
ttodorov 22:4c169297f374 195 LCD::WakeUp();
ttodorov 9:58b328831d0a 196 Deactivate();
ttodorov 9:58b328831d0a 197 }
ttodorov 9:58b328831d0a 198
ttodorov 9:58b328831d0a 199 void ST7735_LCD::WriteCmd( unsigned short cmd )
ttodorov 9:58b328831d0a 200 {
ttodorov 9:58b328831d0a 201 _lcd_pin_rs = LOW;
ttodorov 9:58b328831d0a 202 serializeByte( cmd & 0xFF );
ttodorov 9:58b328831d0a 203 }
ttodorov 9:58b328831d0a 204
ttodorov 9:58b328831d0a 205 void ST7735_LCD::WriteData( unsigned short data )
ttodorov 9:58b328831d0a 206 {
ttodorov 9:58b328831d0a 207 _lcd_pin_rs = HIGH;
ttodorov 9:58b328831d0a 208 serializeByte( ( data >> 8 ) & 0xFF );
ttodorov 9:58b328831d0a 209 serializeByte( data & 0xFF );
ttodorov 9:58b328831d0a 210 }
ttodorov 9:58b328831d0a 211
ttodorov 9:58b328831d0a 212 void ST7735_LCD::WriteByteData( unsigned char data )
ttodorov 9:58b328831d0a 213 {
ttodorov 9:58b328831d0a 214 _lcd_pin_rs = HIGH;
ttodorov 9:58b328831d0a 215 serializeByte( data );
ttodorov 9:58b328831d0a 216 }
ttodorov 9:58b328831d0a 217
ttodorov 20:4bdca8d8dadc 218 void ST7735_LCD::SetXY( unsigned short x1, unsigned short y1, unsigned short x2, unsigned short y2 )
ttodorov 9:58b328831d0a 219 {
ttodorov 9:58b328831d0a 220 WriteCmdData( 0x2a, x1 );
ttodorov 9:58b328831d0a 221 WriteData( x2 );
ttodorov 9:58b328831d0a 222 WriteCmdData( 0x2b, y1 );
ttodorov 9:58b328831d0a 223 WriteData( y2 );
ttodorov 9:58b328831d0a 224 WriteCmd( 0x2c );
ttodorov 9:58b328831d0a 225 }
ttodorov 9:58b328831d0a 226
ttodorov 20:4bdca8d8dadc 227 void ST7735_LCD::SetPixelColor( unsigned int color, colordepth_t mode )
ttodorov 10:69571adcfad5 228 {
ttodorov 20:4bdca8d8dadc 229 unsigned char r = 0, g = 0, b = 0;
ttodorov 20:4bdca8d8dadc 230 unsigned short clr;
ttodorov 12:d0978272a340 231 if ( _colorDepth == RGB16 )
ttodorov 12:d0978272a340 232 {
ttodorov 20:4bdca8d8dadc 233 switch ( mode )
ttodorov 20:4bdca8d8dadc 234 {
ttodorov 20:4bdca8d8dadc 235 case RGB16:
ttodorov 20:4bdca8d8dadc 236 WriteData( color & 0xFFFF );
ttodorov 20:4bdca8d8dadc 237 break;
ttodorov 20:4bdca8d8dadc 238 case RGB18:
ttodorov 20:4bdca8d8dadc 239 r = ( color >> 10 ) & 0xF8;
ttodorov 20:4bdca8d8dadc 240 g = ( color >> 4 ) & 0xFC;
ttodorov 20:4bdca8d8dadc 241 b = ( color >> 1 ) & 0x1F;
ttodorov 20:4bdca8d8dadc 242 clr = ( ( r | ( g >> 5 ) ) << 8 ) | ( ( g << 3 ) | b );
ttodorov 20:4bdca8d8dadc 243 WriteData( clr );
ttodorov 20:4bdca8d8dadc 244 break;
ttodorov 20:4bdca8d8dadc 245 case RGB24:
ttodorov 20:4bdca8d8dadc 246 r = ( color >> 16 ) & 0xF8;
ttodorov 20:4bdca8d8dadc 247 g = ( color >> 8 ) & 0xFC;
ttodorov 20:4bdca8d8dadc 248 b = color & 0xF8;
ttodorov 20:4bdca8d8dadc 249 clr = ( ( r | ( g >> 5 ) ) << 8 ) | ( ( g << 3 ) | ( b >> 3 ) );
ttodorov 20:4bdca8d8dadc 250 WriteData( clr );
ttodorov 20:4bdca8d8dadc 251 break;
ttodorov 20:4bdca8d8dadc 252 }
ttodorov 12:d0978272a340 253 }
ttodorov 15:af3cd35886fb 254 else if ( _colorDepth == RGB18 )
ttodorov 12:d0978272a340 255 {
ttodorov 20:4bdca8d8dadc 256 switch ( mode )
ttodorov 20:4bdca8d8dadc 257 {
ttodorov 20:4bdca8d8dadc 258 case RGB16:
ttodorov 20:4bdca8d8dadc 259 r = ( ( color >> 8 ) & 0xF8 ) | ( ( color & 0x8000 ) >> 13 );
ttodorov 20:4bdca8d8dadc 260 g = ( color >> 3 ) & 0xFC;
ttodorov 20:4bdca8d8dadc 261 b = ( ( color << 3 ) & 0xFC ) | ( ( color >> 3 ) & 0x01 );
ttodorov 20:4bdca8d8dadc 262 break;
ttodorov 20:4bdca8d8dadc 263 case RGB18:
ttodorov 20:4bdca8d8dadc 264 b = ( color << 2 ) & 0xFC;
ttodorov 20:4bdca8d8dadc 265 g = ( color >> 4 ) & 0xFC;
ttodorov 20:4bdca8d8dadc 266 r = ( color >> 10 ) & 0xFC;
ttodorov 20:4bdca8d8dadc 267 break;
ttodorov 20:4bdca8d8dadc 268 case RGB24:
ttodorov 20:4bdca8d8dadc 269 r = ( color >> 16 ) & 0xFC;
ttodorov 20:4bdca8d8dadc 270 g = ( color >> 8 ) & 0xFC;
ttodorov 20:4bdca8d8dadc 271 b = color & 0xFC;
ttodorov 20:4bdca8d8dadc 272 break;
ttodorov 20:4bdca8d8dadc 273 }
ttodorov 20:4bdca8d8dadc 274 WriteByteData( r );
ttodorov 20:4bdca8d8dadc 275 WriteByteData( g );
ttodorov 20:4bdca8d8dadc 276 WriteByteData( b );
ttodorov 12:d0978272a340 277 }
ttodorov 10:69571adcfad5 278 }
ttodorov 10:69571adcfad5 279
ttodorov 9:58b328831d0a 280 void ST7735_LCD::serializeByte( unsigned char data )
ttodorov 9:58b328831d0a 281 {
ttodorov 9:58b328831d0a 282 for ( int i = 0; i < 8; i++ )
ttodorov 9:58b328831d0a 283 {
ttodorov 9:58b328831d0a 284 if ( data & 0x80 ) _lcd_pin_sda = HIGH;
ttodorov 9:58b328831d0a 285 else _lcd_pin_sda = LOW;
ttodorov 9:58b328831d0a 286 pulseLow( _lcd_pin_scl );
ttodorov 9:58b328831d0a 287 data = data << 1;
ttodorov 9:58b328831d0a 288 }
ttodorov 9:58b328831d0a 289 }