Revision 9:58b328831d0a, committed 2012-12-07

Comitter:

ttodorov

Date:

Fri Dec 07 16:14:13 2012 +0000

Parent:

8:7a4791dbb065

Child:

10:69571adcfad5

Commit message:

- reverted changes for 262K colors, will branch out later; - added ST7735 LCD driver

Changed in this revision

--- a/hx8340bs.cpp	Thu Dec 06 02:18:22 2012 +0000
+++ b/hx8340bs.cpp	Fri Dec 07 16:14:13 2012 +0000
@@ -28,7 +28,7 @@
     if ( BL != NC ) _lcd_pin_bl = new DigitalOut( BL );
     else _lcd_pin_bl = 0;
 }
- 
+
 void HX8340S_LCD::Initialize( orientation_t orientation )
 {
     _orientation = orientation;

--- a/lcd_base.cpp	Thu Dec 06 02:18:22 2012 +0000
+++ b/lcd_base.cpp	Fri Dec 07 16:14:13 2012 +0000
@@ -31,13 +31,13 @@
 }
 
 inline
-void LCD::SetForeground( unsigned int color )
+void LCD::SetForeground( unsigned short color )
 {
     _foreground = color;
 }
 
 inline
-void LCD::SetBackground( unsigned int color )
+void LCD::SetBackground( unsigned short color )
 {
     _background = color;
 }
@@ -67,7 +67,7 @@
 
 void LCD::FillScreen( int color )
 {
-    unsigned int rgb = color == -1 ? _background : color == -2 ? _foreground : ( unsigned int ) color;
+    unsigned short rgb = color == -1 ? _background : color == -2 ? _foreground : ( unsigned short ) color;
     Activate();
     ClearXY();
     for ( int i = 0; i < ( ( _disp_width ) * ( _disp_height ) ); i++ )
@@ -120,7 +120,7 @@
     }
     else
     {
-        unsigned int usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned int ) color;
+        unsigned short usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned short ) color;
         Activate();
         if ( abs( x2 - x1 ) > abs( y2 - y1 ) )
         {
@@ -261,7 +261,7 @@
     int ddF_y = -2 * radius;
     int x1 = 0;
     int y1 = radius;
-    unsigned int usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned int ) color;
+    unsigned short usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned short ) color;
 
     Activate();
     SetXY( x, y + radius, x, y + radius );
@@ -306,7 +306,7 @@
 
 void LCD::FillCircle( unsigned short x, unsigned short y, unsigned short radius, int color )
 {
-    unsigned int usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned int ) color;
+    unsigned short usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned short ) color;
     Activate();
     for ( int y1 = -radius; y1 <= radius; y1++ )
         for ( int x1 = -radius; x1 <= radius; x1++ )
@@ -491,7 +491,7 @@
 
 void LCD::DrawHLine( unsigned short x, unsigned short y, unsigned short len, int color )
 {
-    unsigned int usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned int ) color;
+    unsigned short usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned short ) color;
     
     Activate();
     SetXY( x, y, x + len, y );
@@ -502,7 +502,7 @@
 
 void LCD::DrawVLine( unsigned short x, unsigned short y, unsigned short len, int color )
 {
-    unsigned int usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned int ) color;
+    unsigned short usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned short ) color;
     
     Activate();
     SetXY( x, y, x, y + len );
@@ -516,8 +516,8 @@
     uint8_t i, ch;
     uint16_t j;
     uint16_t temp;
-    unsigned int usedColorFG = fgColor == -1 ? _background : fgColor == -2 ? _foreground : ( unsigned int ) fgColor;
-    unsigned int usedColorBG = bgColor == -1 ? _background : bgColor == -2 ? _foreground : ( unsigned int ) bgColor;
+    unsigned short usedColorFG = fgColor == -1 ? _background : fgColor == -2 ? _foreground : ( unsigned short ) fgColor;
+    unsigned short usedColorBG = bgColor == -1 ? _background : bgColor == -2 ? _foreground : ( unsigned short ) bgColor;
 
     Activate();
 
@@ -571,8 +571,8 @@
     double radian;
     radian = deg * 0.0175;
     
-    unsigned int usedColorFG = fgColor == -1 ? _background : fgColor == -2 ? _foreground : ( unsigned int ) fgColor;
-    unsigned int usedColorBG = bgColor == -1 ? _background : bgColor == -2 ? _foreground : ( unsigned int ) bgColor;
+    unsigned short usedColorFG = fgColor == -1 ? _background : fgColor == -2 ? _foreground : ( unsigned short ) fgColor;
+    unsigned short usedColorBG = bgColor == -1 ? _background : bgColor == -2 ? _foreground : ( unsigned short ) bgColor;
 
     Activate();
 

--- a/lcd_base.h	Thu Dec 06 02:18:22 2012 +0000
+++ b/lcd_base.h	Fri Dec 07 16:14:13 2012 +0000
@@ -161,11 +161,10 @@
      * in place, the new setting will be used for that single operation only and
      * will not change this value.
      *
-     * \param color The color to be used. Use the RGB macro to create the correct
-     *              color for the used LCD driver.
+     * \param color The color to be used. The value must be in RGB-565 format.
      * \sa #RGB(r,g,b)
      */
-    virtual void SetForeground( unsigned int color = COLOR_WHITE );
+    virtual void SetForeground( unsigned short color = COLOR_WHITE );
     
     /** Set the background color for painting.
      *
@@ -174,11 +173,10 @@
      * when the function is called, the new value will be used only for this
      * single call and will not change this setting.
      *
-     * \param color The background color. Use the RGB macro to create the correct
-     *              color for the used LCD driver.
+     * \param color The background color as RGB-565 value.
      * \sa #RGB(r,g,b)
      */
-    virtual void SetBackground( unsigned int color = COLOR_BLACK );
+    virtual void SetBackground( unsigned short color = COLOR_BLACK );
     
     /** Sets the font to be used for painting of text on the screen.
      * \param font A pointer to the font data.
@@ -197,10 +195,9 @@
     unsigned short GetHeight( void );
     
     /** Fills the whole screen with a single color.
-     * \param color The color to be used. Use the RGB macro to create the correct
-     *              color for the used LCD driver.
-     * \remarks The special values -1 and -2 signify the preset background and
-     *          foreground colors, respectively. The backround color is the default.
+     * \param color The color to be used. The value must be in RGB-565 format.
+     * \remarks The special values -1 and -2 signify the preset background and foreground colors, respectively.
+     *          The backround color is the default.
      */
     virtual void FillScreen( int color = -1 );
     
@@ -217,8 +214,7 @@
      *
      * \param x The horizontal offset of the pixel from the upper left corner of the screen.
      * \param y The vertical offset of the pixel from the upper left corner of the screen.
-     * \param color The color to be used. Use the RGB macro for custom color to produce the
-     *              correct format, or -1 for background and -2 for foreground color.
+     * \param color The color to be used. Must be in RGB-565 format, or -1 for background and -2 for foreground color.
      */
     virtual void DrawPixel( unsigned short x, unsigned short y, int color = -2 );
     
@@ -228,8 +224,7 @@
      * \param y1 Vertical offset of the beginning point of the line.
      * \param x2 Horizontal offset of the end point of the line.
      * \param y2 Verical offset of the end point of the line.
-     * \param color The color to use for painting; use -1 for background, or -2 for foreground,
-     *              or the RGB macro for custom colors.
+     * \param color The color to use for painting, in RGB-565 format, or -1 for background, or -2 for foreground.
      */
     virtual void DrawLine( unsigned short x1, unsigned short y1, unsigned short x2, unsigned short y2, int color = -2 );
     
@@ -239,7 +234,7 @@
      * \param y1 The vertical offset of the beginning point of one of the rectangle's diagonals.
      * \param x2 The horizontal offset of the end point of the same of the rectangle's diagonals.
      * \param y2 The vertical offset of the end point of the same of the rectangle's diagonals.
-     * \param color The color to use for painting. -1 indicated background, -2 foreground, or use the RGB macro for custom color.
+     * \param color The color to use for painting. -1 indicated background, -2 foreground, or custom color in RGB-565 format.
      */
     virtual void DrawRect( unsigned short x1, unsigned short y1, unsigned short x2, unsigned short y2, int color = -2 );
     
@@ -249,7 +244,7 @@
      * \param y1 The vertical offset of the beginning point of one of the rectangle's diagonals.
      * \param x2 The horizontal offset of the end point of the same of the rectangle's diagonals.
      * \param y2 The vertical offset of the end point of the same of the rectangle's diagonals.
-     * \param color The color to use for painting. -1 indicated background, -2 foreground, or use the RGB macro for custom color.
+     * \param color The color to use for painting. -1 indicated background, -2 foreground, or custom color in RGB-565 format.
      */
     virtual void DrawRoundRect( unsigned short x1, unsigned short y1, unsigned short x2, unsigned short y2, int color = -2 );
     
@@ -259,7 +254,7 @@
      * \param y1 The vertical offset of the beginning point of one of the rectangle's diagonals.
      * \param x2 The horizontal offset of the end point of the same of the rectangle's diagonals.
      * \param y2 The vertical offset of the end point of the same of the rectangle's diagonals.
-     * \param color The color to use for painting. -1 indicated background, -2 foreground, or use the RGB macro for custom color.
+     * \param color The color to use for painting. -1 indicated background, -2 foreground, or custom color in RGB-565 format.
      */
     virtual void FillRect( unsigned short x1, unsigned short y1, unsigned short x2, unsigned short y2, int color = -2 );
     
@@ -269,7 +264,7 @@
      * \param y1 The vertical offset of the beginning point of one of the rectangle's diagonals.
      * \param x2 The horizontal offset of the end point of the same of the rectangle's diagonals.
      * \param y2 The vertical offset of the end point of the same of the rectangle's diagonals.
-     * \param color The color to use for painting. -1 indicated background, -2 foreground, or use the RGB macro for custom color.
+     * \param color The color to use for painting. -1 indicated background, -2 foreground, or custom color in RGB-565 format.
      */
     virtual void FillRoundRect( unsigned short x1, unsigned short y1, unsigned short x2, unsigned short y2, int color = -2 );
     
@@ -278,7 +273,7 @@
      * \param x The offset of the circle's center from the left edge of the screen.
      * \param y The offset of the circle's center from the top edge of the screen.
      * \param radius The circle's radius.
-     * \param color The color to use for painting. -1 indicated background, -2 foreground, or use the RGB macro for custom color.
+     * \param color The color to use for painting. -1 indicated background, -2 foreground, or custom color in RGB-565 format.
      */
     virtual void DrawCircle( unsigned short x, unsigned short y, unsigned short radius, int color = -2 );
     
@@ -287,7 +282,7 @@
      * \param x The offset of the circle's center from the left edge of the screen.
      * \param y The offset of the circle's center from the top edge of the screen.
      * \param radius The circle's radius.
-     * \param color The color to use for painting. -1 indicated background, -2 foreground, or use the RGB macro for custom color.
+     * \param color The color to use for painting. -1 indicated background, -2 foreground, or custom color in RGB-565 format.
      */
     virtual void FillCircle( unsigned short x, unsigned short y, unsigned short radius, int color = -2 );
     
@@ -419,7 +414,7 @@
      * \param y Y coordinate of the starting point of the line.
      * \param len Length of the line.
      * \param color The color to use to draw the line. By default the global foreground color is used ( -2 ),
-     *              -1 switches to the default background color, or use the RGB macro for custom color.
+     *              -1 switches to the default background color, or any other RGB-565 color can be used.
      */
     virtual void DrawHLine( unsigned short x, unsigned short y, unsigned short len, int color = -2 );
     
@@ -432,7 +427,7 @@
      * \param y Y coordinate of the starting point of the line.
      * \param len Height of the line.
      * \param color The color to use to draw the line. By default the global foreground color is used ( -2 ),
-     *              -1 switches to the default background color, or use the RGB macro for custom color.
+     *              -1 switches to the default background color, or any other RGB-565 color can be used.
      */
     virtual void DrawVLine( unsigned short x, unsigned short y, unsigned short len, int color = -2 );
     
@@ -442,9 +437,9 @@
      * \param x X coordinate of the character position.
      * \param y Y coordinate of the character position.
      * \param fgColor Foreground color for drawing. By default the global foreground color is used ( -2 ),
-     *                -1 switches to the default background color, or use the RGB macro for custom color.
+     *                -1 switches to the default background color, or any other RGB-565 color can be used.
      * \param bgColor Background color for drawing. By default the global background color is used ( -1 ),
-     *                -2 switches to the default foreground color, or use the RGB macro for custom color.
+     *                -2 switches to the default foreground color, or any other RGB-565 color can be used.
      */
     virtual void PrintChar( char c, unsigned short x, unsigned short y, int fgColor = -2, int bgColor = -1 );
     
@@ -455,9 +450,9 @@
      * \param y Y coordinate of the character position.
      * \param pos Position of the character in the string from which it originates (used to rotate a whole string).
      * \param fgColor Foreground color for drawing. By default the global foreground color is used ( -2 ),
-     *                -1 switches to the default background color, or use the RGB macro for custom color.
+     *                -1 switches to the default background color, or any other RGB-565 color can be used.
      * \param bgColor Background color for drawing. By default the global background color is used ( -1 ),
-     *                -2 switches to the default foreground color, or use the RGB macro for custom color.
+     *                -2 switches to the default foreground color, or any other RGB-565 color can be used.
      * \param deg The angle at which to rotate. 
      */
     virtual void RotateChar( char c, unsigned short x, unsigned short y, int pos, int fgColor = -2, int bgColor = -1, unsigned short deg = 0 );
@@ -466,7 +461,7 @@
     unsigned short  _disp_width, _disp_height;
     DigitalOut      _lcd_pin_cs, _lcd_pin_rs, _lcd_pin_reset;
     orientation_t   _orientation;
-    unsigned int    _foreground, _background;
+    unsigned short  _foreground, _background;
     font_metrics_t  _font;
 };
 

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/st7735.cpp	Fri Dec 07 16:14:13 2012 +0000
@@ -0,0 +1,228 @@
+/*
+ * Copyright (C)2010-2012 Henning Karlsen. All right reserved.
+ * Copyright (C)2012 Todor Todorov.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to:
+ *
+ * Free Software Foundation, Inc.
+ * 51 Franklin St, 5th Floor, Boston, MA 02110-1301, USA
+ *
+ *********************************************************************/
+#include "st7735.h"
+#include "helpers.h"
+
+ST7735_LCD::ST7735_LCD( PinName CS, PinName RESET, PinName RS, PinName SCL, PinName SDA, PinName BL )
+    : LCD( 128, 160, CS, RS, RESET ), _lcd_pin_scl( SCL ), _lcd_pin_sda( SDA )
+{
+    if ( BL != NC ) _lcd_pin_bl = new DigitalOut( BL );
+    else _lcd_pin_bl = 0;
+}
+
+void ST7735_LCD::Initialize( orientation_t orientation )
+{
+    _orientation = orientation;
+    
+    wait_ms( 100 );
+    _lcd_pin_reset = HIGH;
+    wait_ms( 5 );
+    _lcd_pin_reset = LOW;
+    wait_ms( 15 );
+    _lcd_pin_reset = HIGH;
+    _lcd_pin_cs = HIGH;
+    _lcd_pin_rs = HIGH;
+    _lcd_pin_scl = HIGH;
+    _lcd_pin_sda = HIGH;
+    if ( _lcd_pin_bl != 0 )
+        *_lcd_pin_bl = HIGH;
+    wait_ms( 55 );
+    
+    Activate();
+    WriteCmd( 0x01 ); // SW reset
+    wait_ms( 120 );
+    
+    WriteCmd( 0x11 ); // sleep out
+    wait_ms( 120 );
+    
+    WriteCmd( 0xB1 ); // frame control 1
+    WriteByteData( 0x01 );
+    WriteByteData( 0x2C );
+    WriteByteData( 0x2D );
+    WriteCmd( 0xB2 ); // frame control 2
+    WriteByteData( 0x01 );
+    WriteByteData( 0x2C );
+    WriteByteData( 0x2D );
+    WriteCmd( 0xB3 ); // frame control 3
+    WriteByteData( 0x01 );
+    WriteByteData( 0x2C );
+    WriteByteData( 0x2D );
+    WriteByteData( 0x01 );
+    WriteByteData( 0x2C );
+    WriteByteData( 0x2D );
+    
+    WriteCmd( 0xB4 ); // column inversion
+    WriteByteData( 0x07 );
+
+    // ST7735R Power Sequence
+    WriteCmd( 0xC0 ); // power control 1
+    WriteByteData( 0xA2 );
+    WriteByteData( 0x02 );
+    WriteByteData( 0x84 );
+    WriteCmd( 0xC1 ); // power control 2
+    WriteByteData( 0xC5 );
+    WriteCmd( 0xC2 ); // power control 3
+    WriteByteData( 0x0A );
+    WriteByteData( 0x00 );
+    WriteCmd( 0xC3 ); // power control 4
+    WriteByteData( 0x8A );
+    WriteByteData( 0x2A );
+    WriteCmd( 0xC4 ); // power control 5
+    WriteByteData( 0x8A );
+    WriteByteData( 0xEE );
+    
+    WriteCmd( 0xC5 ); // voltage control 1
+    WriteByteData( 0x0E );
+
+    WriteCmd( 0x36 ); //MX, MY, RGB mode
+    WriteByteData( 0xC8 );
+
+    // ST7735R Gamma Sequence
+    WriteCmd( 0xE0 ); // gamma positive
+    WriteByteData( 0x0F );
+    WriteByteData( 0x1A );
+    WriteByteData( 0x0F );
+    WriteByteData( 0x18 );
+    WriteByteData( 0x2F );
+    WriteByteData( 0x28 );
+    WriteByteData( 0x20 );
+    WriteByteData( 0x22 );
+    WriteByteData( 0x1F );
+    WriteByteData( 0x1B );
+    WriteByteData( 0x23 );
+    WriteByteData( 0x37 );
+    WriteByteData( 0x00 );
+    WriteByteData( 0x07 );
+    WriteByteData( 0x02 );
+    WriteByteData( 0x10 );
+    WriteCmd( 0xE1 ); // gamma negative
+    WriteByteData( 0x0F );
+    WriteByteData( 0x1B );
+    WriteByteData( 0x0F );
+    WriteByteData( 0x17 );
+    WriteByteData( 0x33 );
+    WriteByteData( 0x2C );
+    WriteByteData( 0x29 );
+    WriteByteData( 0x2E );
+    WriteByteData( 0x30 );
+    WriteByteData( 0x30 );
+    WriteByteData( 0x39 );
+    WriteByteData( 0x3F );
+    WriteByteData( 0x00 );
+    WriteByteData( 0x07 );
+    WriteByteData( 0x03 );
+    WriteByteData( 0x10 );
+
+    WriteCmd( 0x2A ); // set column address
+    WriteByteData( 0x00 );
+    WriteByteData( 0x00 );
+    WriteByteData( 0x00 );
+    WriteByteData( 0x7F );
+    WriteCmd( 0x2B ); // set row address
+    WriteByteData( 0x00 );
+    WriteByteData( 0x00 );
+    WriteByteData( 0x00 );
+    WriteByteData( 0x9F );
+
+    WriteCmd( 0xF0 ); // enable extensions command
+    WriteByteData( 0x01 );
+    WriteCmd( 0xF6 ); // disable ram power save mode
+    WriteByteData( 0x00 );
+
+    WriteCmd( 0x3A ); // interface pixel format (color mode)
+    WriteByteData( 0x05 ); // 65k mode
+    WriteCmd( 0x29 ); // display on
+
+    Deactivate();
+}
+
+void ST7735_LCD::Sleep( void )
+{
+    Activate();
+    WriteCmd( 0x28 );
+    wait_ms( 10 );
+    WriteCmd( 0x10 );
+    wait_ms( 125 );
+    if ( _lcd_pin_bl != 0 )
+        *_lcd_pin_bl = LOW;
+    Deactivate();
+}
+
+void ST7735_LCD::WakeUp( void )
+{
+    Activate();
+    WriteCmd( 0x29 );
+    wait_ms( 10 );
+    WriteCmd( 0x11 );
+    wait_ms( 125 );
+    if ( _lcd_pin_bl != 0 )
+        *_lcd_pin_bl = HIGH;
+    Deactivate();
+}
+
+void ST7735_LCD::WriteCmd( unsigned short cmd )
+{
+    _lcd_pin_rs = LOW;
+    serializeByte( cmd & 0xFF );
+}
+
+void ST7735_LCD::WriteData( unsigned short data )
+{
+    _lcd_pin_rs = HIGH;
+    serializeByte( ( data >> 8 ) & 0xFF );
+    serializeByte( data & 0xFF );
+}
+
+void ST7735_LCD::WriteByteData( unsigned char data )
+{
+    _lcd_pin_rs = HIGH;
+    serializeByte( data );
+}
+
+void ST7735_LCD::SetXY( uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2 )
+{
+    if ( _orientation == LANDSCAPE )
+    {
+        swap( uint16_t, x1, y1 )
+        swap( uint16_t, x2, y2 )
+        y1 = _disp_height - y1;
+        y2 = _disp_height - y2;
+        swap( uint16_t, y1, y2 )
+    }
+
+    WriteCmdData( 0x2a, x1 );
+    WriteData( x2 );
+    WriteCmdData( 0x2b, y1 );
+    WriteData( y2 );
+    WriteCmd( 0x2c );
+}
+
+void ST7735_LCD::serializeByte( unsigned char data )
+{
+    for ( int i = 0; i < 8; i++ )
+    {
+        if ( data & 0x80 ) _lcd_pin_sda = HIGH;
+        else _lcd_pin_sda = LOW;
+        pulseLow( _lcd_pin_scl );
+        data = data << 1;
+    }
+}

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/st7735.h	Fri Dec 07 16:14:13 2012 +0000
@@ -0,0 +1,183 @@
+/** \file st7735.h
+ *  \brief mbed TFT LCD controller for displays with the ST7735 IC.
+ *  \copyright GNU Public License, v2. or later
+ *
+ * A known display with this type of controller chip is the ITDB02-1.8SP
+ * from http://imall.iteadstudio.com
+ *
+ * This library is based on the Arduino/chipKIT UTFT library by Henning
+ * Karlsen, http://henningkarlsen.com/electronics/library.php?id=52
+ *
+ * Copyright (C)2010-2012 Henning Karlsen. All right reserved.
+ *
+ * Copyright (C)2012 Todor Todorov.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to:
+ *
+ * Free Software Foundation, Inc.
+ * 51 Franklin St, 5th Floor, Boston, MA 02110-1301, USA
+ *
+ *********************************************************************/
+#ifndef TFTLCD_ST7735_H
+#define TFTLCD_ST7735_H
+
+#include "lcd_base.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/** Represents a LCD instance.
+ *
+ * This is the utility class, through which the display can be manipulated
+ * and graphics objects can be shown to the user.  A known display, which
+ * works with this library is the ITDB02-1.8SP from iTeadStudio - a RGB TFT
+ * with 128x160 pixels resolution and 262K colors, using serail interface.
+ *
+ * The display needs 5 or 6 pins to work with mbed, uses +3.3V for backlight,
+ * power and logic, thus can be interfaced directly to the mbed kit without
+ * the need of shields or level shifters as with Arduino.
+ *
+ * How to use:
+ * \code
+ * // include the library, this will also pull in the header for the provided fonts
+ * #include "st7735.h"
+ * 
+ * // create the lcd instance
+ * ST7735_LCD lcd( p14, p13, p12, p11, p10 ); // control pins
+ *
+ * int main()
+ * {
+ *     // initialize display - place it in standard portrait mode and set background to black and
+ *     //                      foreground to white color.
+ *     lcd.Initialize();
+ *     // set current font to the smallest 8x12 pixels font.
+ *     lcd.SetFont( Font8x12 );
+ *     // print something on the screen
+ *     lcd.Print( "Hello, World!", CENTER, 25 ); // align text to center horizontally and use starndard colors
+ *
+ *     while ( 1 ) { }
+ * }
+ *
+ * \endcode
+ * \version 0.1
+ * \author Todor Todorov
+ */
+class ST7735_LCD : public LCD
+{
+public:
+    /** Creates a new instance of the class.
+     *
+     * \param CS Pin for the ChipSelect signal.
+     * \param RESET Pin for the RESET line.
+     * \param RS Pin for the RS signal.
+     * \param SCL Pin for the serial clock line.
+     * \param SDA Pin for the serial data line.
+     * \param BL Pin for controlling the backlight. By default not used.
+     */
+    ST7735_LCD( PinName CS, PinName RESET, PinName RS, PinName SCL, PinName SDA, PinName BL = NC );
+    
+    /** Initialize display.
+     *
+     * Wakes up the display from sleep, initializes power parameters.
+     * This function must be called first, befor any painting on the
+     * display is done, otherwise the positioning of graphical elements
+     * will not work properly and any paynt operation will not be visible
+     * or produce garbage.
+     *
+     * \param oritentation The display orientation, landscape is default.
+     */
+    virtual void Initialize( orientation_t orientation = LANDSCAPE );
+    
+    /** Puts the display to sleep.
+     *
+     * When the display is in sleep mode, its power consumption is
+     * minimized.  Before new pixel data can be written to the display
+     * memory, the controller needs to be brought out of sleep mode.
+     * \sa #WakeUp( void );
+     * \remarks The result of this operation might not be exactly as
+     *          expected. Putting the display to sleep will cause the
+     *          controller to switch to the standard color of the LCD,
+     *          so depending on whether the display is normally white,
+     *          or normally dark, the screen might or might not go
+     *          dark.  Additional power saving can be achieved, if
+     *          the backlight of the used display is not hardwired on
+     *          the PCB and can be controlled via the BL pin.
+     */
+    virtual void Sleep( void );
+    
+    /** Wakes up the display from sleep mode.
+     *
+     * This function needs to be called before any other, when the
+     * display has been put into sleep mode by a previois call to
+     * #Sleep( void ).
+     */
+    virtual void WakeUp( void );
+    
+protected:
+    /** Sends a command to the display.
+     *
+     * \param cmd The display command.
+     * \remarks Commands are controller-specific and this function needs to
+     *          be implemented separately for each available controller.
+     */
+    virtual void WriteCmd( unsigned short cmd );
+    
+    /** Sends pixel data to the display.
+     *
+     * \param data The display data.
+     * \remarks Sendin data is controller-specific and this function needs to
+     *          be implemented separately for each available controller.
+     */
+    virtual void WriteData( unsigned short data );
+    
+    /** Writes a single byte of pixel data to the display.
+     *
+     * \param data The data to be written.
+     * \remarks Sendin data is controller-specific and this function needs to
+     *          be implemented separately for each available controller.
+     */
+    virtual void WriteByteData( unsigned char data );
+    
+    /** Assigns a chunk of the display memory to receive data.
+     *
+     * When data is sent to the display after this function completes, the opertion will
+     * start from the begining of the assigned address (pixel position) and the pointer
+     * will be automatically incremented so that the next data write operation will continue
+     * with the next pixel from the memory block.  If more data is written than available
+     * pixels, at the end of the block the pointer will jump back to its beginning and
+     * commence again, until the next address change command is sent to the display.
+     *
+     * \param x1 The X coordinate of the pixel at the beginning of the block.
+     * \param y1 The Y coordinate of the pixel at the beginning of the block.
+     * \param x2 The X coordinate of the pixel at the end of the block.
+     * \param y2 The Y coordinate of the pixel at the end of the block.
+     * \remarks Addressing commands are controller-specific and this function needs to be
+     *          implemented separately for each available controller.
+     */
+    virtual void SetXY( uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2 );
+    
+private:
+    void serializeByte( unsigned char data );
+    
+private:
+    DigitalOut  _lcd_pin_scl, _lcd_pin_sda;
+    DigitalOut* _lcd_pin_bl;
+};
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* TFTLCD_ST7735_H */