EasyRad
Programme de test pour lcd ITDB02
Fork of
TFTLCD
by 
Todor Todorov
Revision 4:3ac4239f6c9c, committed 2012-12-02
- Comitter:
- ttodorov
- Date:
- Sun Dec 02 05:44:52 2012 +0000
- Parent:
- 3:64a5b67d5b51
- Child:
- 5:09b6d228ceea
- Commit message:
- - renamed SSD1289 implementation; - refactored base class functions and removed redundant addressing; - added sleep and wake functions; - added HX8340B serial implementation; - fixed test case
Changed in this revision
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/hx8340bs.cpp Sun Dec 02 05:44:52 2012 +0000
@@ -0,0 +1,198 @@
+/*
+ * 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 "hx8340bs.h"
+#include "helpers.h"
+
+HX8340S_LCD::HX8340S_LCD( PinName CS, PinName RESET, PinName SCL, PinName SDI, PinName BL )
+ : LCD( 176, 220, CS, NC, RESET ), _lcd_pin_scl( SCL ), _lcd_pin_sdi( SDI )
+{
+ if ( BL != NC ) _lcd_pin_bl = new DigitalOut( BL );
+ else _lcd_pin_bl = 0;
+}
+
+void HX8340S_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_scl = HIGH;
+ _lcd_pin_sdi = HIGH;
+ if ( _lcd_pin_bl != 0 )
+ *_lcd_pin_bl = HIGH;
+ wait_ms( 55 );
+
+ Activate();
+ WriteCmd( 0xC1 );
+ WriteByteData( 0xFF );
+ WriteByteData( 0x83 );
+ WriteByteData( 0x40 );
+ WriteCmd( 0x11 );
+ wait_ms( 160 );
+ WriteCmd( 0xCA );
+ WriteByteData( 0x70 );
+ WriteByteData( 0x00 );
+ WriteByteData( 0xD9 );
+ WriteCmd( 0xB0 );
+ WriteByteData( 0x01 );
+ WriteByteData( 0x11 );
+
+ WriteCmd( 0xC9 );
+ WriteByteData( 0x90 );
+ WriteByteData( 0x49 );
+ WriteByteData( 0x10 );
+ WriteByteData( 0x28 );
+ WriteByteData( 0x28 );
+ WriteByteData( 0x10 );
+ WriteByteData( 0x00 );
+ WriteByteData( 0x06 );
+ wait_ms( 20 );
+ WriteCmd( 0xC2 );
+ WriteByteData( 0x60 );
+ WriteByteData( 0x71 );
+ WriteByteData( 0x01 );
+ WriteByteData( 0x0E );
+ WriteByteData( 0x05 );
+ WriteByteData( 0x02 );
+ WriteByteData( 0x09 );
+ WriteByteData( 0x31 );
+ WriteByteData( 0x0A );
+
+ WriteCmd( 0xc3 );
+ WriteByteData( 0x67 );
+ WriteByteData( 0x30 );
+ WriteByteData( 0x61 );
+ WriteByteData( 0x17 );
+ WriteByteData( 0x48 );
+ WriteByteData( 0x07 );
+ WriteByteData( 0x05 );
+ WriteByteData( 0x33 );
+ wait_ms( 10 );
+ WriteCmd( 0xB5 );
+ WriteByteData( 0x35 );
+ WriteByteData( 0x20 );
+ WriteByteData( 0x45 );
+
+ WriteCmd( 0xB4 );
+ WriteByteData( 0x33 );
+ WriteByteData( 0x25 );
+ WriteByteData( 0x4c );
+ wait_ms( 10 );
+ WriteCmd( 0x3a );
+ WriteByteData( 0x05 );
+ WriteCmd( 0x29 );
+ wait_ms( 10 );
+ WriteCmd( 0x2a );
+ WriteByteData( 0x00 );
+ WriteByteData( 0x00 );
+ WriteByteData( 0x00 );
+ WriteByteData( 0xaf );
+ WriteCmd( 0x2b );
+ WriteByteData( 0x00 );
+ WriteByteData( 0x00 );
+ WriteByteData( 0x00 );
+ WriteByteData( 0xdb );
+ WriteCmd( 0x2c );
+ Deactivate();
+}
+
+void HX8340S_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 HX8340S_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 HX8340S_LCD::WriteCmd( unsigned short cmd )
+{
+ _lcd_pin_sdi = LOW;
+ pulseLow( _lcd_pin_scl );
+ serializeByte( cmd & 0xFF );
+}
+
+void HX8340S_LCD::WriteData( unsigned short data )
+{
+ _lcd_pin_sdi = HIGH;
+ pulseLow( _lcd_pin_scl );
+ serializeByte( ( data >> 8 ) & 0xFF );
+ _lcd_pin_sdi = HIGH;
+ pulseLow( _lcd_pin_scl );
+ serializeByte( data & 0xFF );
+}
+
+void HX8340S_LCD::WriteByteData( unsigned char data )
+{
+ _lcd_pin_sdi = HIGH;
+ pulseLow( _lcd_pin_scl );
+ serializeByte( data );
+}
+
+void HX8340S_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 HX8340S_LCD::serializeByte( unsigned char data )
+{
+ for ( int i = 0; i < 8; i++ )
+ {
+ if ( data & 0x80 ) _lcd_pin_sdi = HIGH;
+ else _lcd_pin_sdi = LOW;
+ pulseLow( _lcd_pin_scl );
+ data = data << 1;
+ }
+}
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/hx8340bs.h Sun Dec 02 05:44:52 2012 +0000
@@ -0,0 +1,173 @@
+/** \file hx8340b.h
+ * \brief mbed TFT LCD controller for displays with the HX8340-B IC (serial interface).
+ * \copyright GNU Public License, v2. or later
+ *
+ * A known display with this type of controller chip is the ITDB02-2.2SP
+ * 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_HX8340B_H
+#define TFTLCD_HX8340B_H
+
+#include "lcd_base.h"
+
+/** 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-2.2SP from iTeadStudio - a RGB TFT
+ * with 176x220 pixels resolution and 65K/256K colors, using serial interface.
+ *
+ * The display needs 4 or 5 pins to work with mbed. As it uses +3.3V for power
+ * and logic, as well as the backlight, interfacing could happen directly
+ * to the mbed 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 "hx8340bs.h"
+ *
+ * // create the lcd instance
+ * HX8340S_LCD lcd( p14, p13, p12, p11 ); // 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 HX8340S_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 SCL Pin for the serial clock signal.
+ * \param SDI Pin for the serial data signal.
+ * \param BL Pin for controlling the backlight. By default not used.
+ */
+ HX8340S_LCD( PinName CS, PinName RESET, PinName SCL, PinName SDI, 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_sdi;
+ DigitalOut* _lcd_pin_bl;
+};
+
+#endif /* TFTLCD_HX8340B_H */
--- a/lcd_base.cpp Sun Dec 02 01:44:23 2012 +0000
+++ b/lcd_base.cpp Sun Dec 02 05:44:52 2012 +0000
@@ -22,9 +22,13 @@
#include "lcd_base.h"
#include "helpers.h"
-LCD::LCD( unsigned short width, unsigned short height ,PinName CS, PinName RS )
- : _disp_width( width ), _disp_height( height ), _lcd_pin_cs( CS ), _lcd_pin_rs( RS )
-{}
+LCD::LCD( unsigned short width, unsigned short height ,PinName CS, PinName RS, PinName RESET )
+ : _disp_width( width ), _disp_height( height ), _lcd_pin_cs( CS ), _lcd_pin_rs( RS ), _lcd_pin_reset( RESET )
+{
+ SetForeground();
+ SetBackground();
+ _font.font = 0;
+}
inline
void LCD::SetForeground( unsigned short color )
@@ -64,12 +68,11 @@
void LCD::FillScreen( int color )
{
unsigned short rgb = color == -1 ? _background : color == -2 ? _foreground : ( unsigned short ) color;
- _lcd_pin_cs = LOW;
+ Activate();
ClearXY();
- _lcd_pin_rs = HIGH;
for ( int i = 0; i < ( ( _disp_width ) * ( _disp_height ) ); i++ )
WriteData( rgb );
- _lcd_pin_cs = HIGH;
+ Deactivate();
}
inline
@@ -80,12 +83,11 @@
void LCD::DrawPixel( unsigned short x, unsigned short y, int color )
{
- _lcd_pin_cs = LOW;
+ Activate();
SetXY( x, y, x, y );
WriteData( color == -1 ? _background :
color == -2 ? _foreground : color );
- _lcd_pin_cs = HIGH;
- ClearXY();
+ Deactivate();
}
void LCD::DrawLine( unsigned short x1, unsigned short y1, unsigned short x2, unsigned short y2, int color )
@@ -116,60 +118,58 @@
swap( ushort, y1, y2 )
DrawVLine( x1, y1, y2 - y1, color );
}
- else if ( abs( x2 - x1 ) > abs( y2 - y1 ) )
+ else
{
unsigned short usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned short ) color;
- _lcd_pin_cs = LOW;
- delta = ( double( y2 - y1 ) / double( x2 - x1 ) );
- ty = double( y1 );
- if ( x1 > x2 )
+ Activate();
+ if ( abs( x2 - x1 ) > abs( y2 - y1 ) )
{
- for ( int i = x1; i >= x2; i-- )
+ delta = ( double( y2 - y1 ) / double( x2 - x1 ) );
+ ty = double( y1 );
+ if ( x1 > x2 )
{
- SetXY( i, int( ty + 0.5 ), i, int( ty + 0.5 ) );
- WriteData( usedColor );
- ty = ty - delta;
+ for ( int i = x1; i >= x2; i-- )
+ {
+ SetXY( i, int( ty + 0.5 ), i, int( ty + 0.5 ) );
+ WriteData( usedColor );
+ ty = ty - delta;
+ }
+ }
+ else
+ {
+ for ( int i = x1; i <= x2; i++ )
+ {
+ SetXY( i, int( ty + 0.5 ), i, int( ty + 0.5 ) );
+ WriteData( usedColor );
+ ty = ty + delta;
+ }
}
}
else
{
- for ( int i = x1; i <= x2; i++ )
+ delta = ( float( x2 - x1 ) / float( y2 - y1 ) );
+ tx = float( x1 );
+ if ( y1 > y2 )
{
- SetXY( i, int( ty + 0.5 ), i, int( ty + 0.5 ) );
- WriteData( usedColor );
- ty = ty + delta;
+ for ( int i = y2 + 1; i > y1; i-- )
+ {
+ SetXY( int( tx + 0.5 ), i, int( tx + 0.5 ), i );
+ WriteData( usedColor );
+ tx = tx + delta;
+ }
+ }
+ else
+ {
+ for ( int i = y1; i < y2 + 1; i++ )
+ {
+ SetXY( int( tx + 0.5 ), i, int( tx + 0.5 ), i );
+ WriteData( usedColor );
+ tx = tx + delta;
+ }
}
}
- _lcd_pin_cs = HIGH;
+ Deactivate();
}
- else
- {
- unsigned short usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned short ) color;
- _lcd_pin_cs = LOW;
- delta = ( float( x2 - x1 ) / float( y2 - y1 ) );
- tx = float( x1 );
- if ( y1 > y2 )
- {
- for ( int i = y2 + 1; i > y1; i-- )
- {
- SetXY( int( tx + 0.5 ), i, int( tx + 0.5 ), i );
- WriteData( usedColor );
- tx = tx + delta;
- }
- }
- else
- {
- for ( int i = y1; i < y2 + 1; i++ )
- {
- SetXY( int( tx + 0.5 ), i, int( tx + 0.5 ), i );
- WriteData( usedColor );
- tx = tx + delta;
- }
- }
- _lcd_pin_cs = HIGH;
- }
-
- ClearXY();
}
void LCD::DrawRect( unsigned short x1, unsigned short y1, unsigned short x2, unsigned short y2, int color )
@@ -263,7 +263,7 @@
int y1 = radius;
unsigned short usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned short ) color;
- _lcd_pin_cs = LOW;
+ Activate();
SetXY( x, y + radius, x, y + radius );
WriteData( usedColor );
SetXY( x, y - radius, x, y - radius );
@@ -301,14 +301,13 @@
SetXY( x - y1, y - x1, x - y1, y - x1 );
WriteData( usedColor );
}
- _lcd_pin_cs = HIGH;
- ClearXY();
+ Deactivate();
}
void LCD::FillCircle( unsigned short x, unsigned short y, unsigned short radius, int color )
{
unsigned short usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned short ) color;
- _lcd_pin_cs = LOW;
+ Activate();
for ( int y1 = -radius; y1 <= radius; y1++ )
for ( int x1 = -radius; x1 <= radius; x1++ )
if ( x1 * x1 + y1 * y1 <= radius * radius )
@@ -316,8 +315,7 @@
SetXY( x + x1, y + y1, x + x1, y + y1 );
WriteData( usedColor );
}
- _lcd_pin_cs = HIGH;
- ClearXY();
+ Deactivate();
}
void LCD::Print( const char *str, unsigned short x, unsigned short y, int fgColor, int bgColor, unsigned short deg )
@@ -352,33 +350,29 @@
{
int tx, ty, tc, tsx, tsy;
+ Activate();
if ( scale == 1 )
{
if ( _orientation == PORTRAIT )
{
- _lcd_pin_cs = LOW;
SetXY( x, y, x + sx - 1, y + sy - 1 );
for ( tc = 0; tc < ( sx * sy ); tc++ )
WriteData( data[ tc ] );
- _lcd_pin_cs = HIGH;
}
else
{
- _lcd_pin_cs = LOW;
for ( ty = 0; ty < sy; ty++ )
{
SetXY( x, y + ty, x + sx - 1, y + ty );
for ( tx = sx; tx >= 0; tx-- )
WriteData( data[ ( ty * sx ) + tx ] );
}
- _lcd_pin_cs = HIGH;
}
}
else
{
if ( _orientation == PORTRAIT )
{
- _lcd_pin_cs = LOW;
for ( ty = 0; ty < sy; ty++ )
{
SetXY( x, y + ( ty * scale ), x + ( ( sx * scale ) - 1 ), y + ( ty * scale ) + scale );
@@ -387,11 +381,9 @@
for ( tsx = 0; tsx < scale; tsx++ )
WriteData( data[ ( ty * sx ) + tx ] );
}
- _lcd_pin_cs = HIGH;
}
else
{
- _lcd_pin_cs = LOW;
for ( ty = 0; ty < sy; ty++ )
{
for ( tsy = 0; tsy < scale; tsy++ )
@@ -402,10 +394,9 @@
WriteData( data[ ( ty * sx ) + tx ] );
}
}
- _lcd_pin_cs = HIGH;
}
}
- ClearXY();
+ Deactivate();
}
void LCD::DrawBitmap( unsigned short x, unsigned short y, unsigned short sx, unsigned short sy, bitmap_t data, unsigned short deg, unsigned short rox, unsigned short roy )
@@ -418,7 +409,7 @@
DrawBitmap( x, y, sx, sy, data );
else
{
- _lcd_pin_cs = LOW;
+ Activate();
for ( ty = 0; ty < sy; ty++ )
for ( tx = 0; tx < sx; tx++ )
{
@@ -428,30 +419,37 @@
SetXY( newx, newy, newx, newy );
WriteData( data[ ( ty * sx ) + tx ] );
}
- _lcd_pin_cs = HIGH;
+ Deactivate();
}
- ClearXY();
+}
+
+inline
+void LCD::Activate( void )
+{
+ _lcd_pin_cs = LOW;
+}
+
+inline
+void LCD::Deactivate( void )
+{
+ _lcd_pin_cs = HIGH;
}
/*
-void LCD::writeCmd( unsigned short cmd )
+void LCD::WriteCmd( unsigned short cmd )
{
_lcd_pin_rs = LOW;
- _lcd_pin_cs = LOW;
_lcd_port->write( cmd );
pulseLow( _lcd_pin_wr );
- _lcd_pin_cs = HIGH;
}
*/
/*
-void LCD::writeData( unsigned short data )
+void LCD::WriteData( unsigned short data )
{
_lcd_pin_rs = HIGH;
- _lcd_pin_cs = LOW;
_lcd_port->write( data );
pulseLow( _lcd_pin_wr );
- _lcd_pin_cs = HIGH;
}
*/
@@ -463,7 +461,7 @@
}
/*
-void LCD::setXY( uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2 )
+void LCD::SetXY( uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2 )
{
if ( _orientation == LANDSCAPE )
{
@@ -474,12 +472,12 @@
swap( uint16_t, y1, y2 )
}
- writeCmdData( 0x44, ( x2 << 8 ) + x1 );
- writeCmdData( 0x45, y1 );
- writeCmdData( 0x46, y2 );
- writeCmdData( 0x4e, x1 );
- writeCmdData( 0x4f, y1 );
- writeCmd( 0x22 );
+ WriteCmdData( 0x44, ( x2 << 8 ) + x1 );
+ WriteCmdData( 0x45, y1 );
+ WriteCmdData( 0x46, y2 );
+ WriteCmdData( 0x4e, x1 );
+ WriteCmdData( 0x4f, y1 );
+ WriteCmd( 0x22 );
}
*/
@@ -495,24 +493,22 @@
{
unsigned short usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned short ) color;
- _lcd_pin_cs = LOW;
+ Activate();
SetXY( x, y, x + len, y );
for ( int i = 0; i < len + 1; i++ )
WriteData( usedColor );
- _lcd_pin_cs = HIGH;
- ClearXY();
+ Deactivate();
}
void LCD::DrawVLine( unsigned short x, unsigned short y, unsigned short len, int color )
{
unsigned short usedColor = color == -1 ? _background : color == -2 ? _foreground : ( unsigned short ) color;
- _lcd_pin_cs = LOW;
+ Activate();
SetXY( x, y, x, y + len );
for ( int i = 0; i < len; i++ )
WriteData( usedColor );
- _lcd_pin_cs = HIGH;
- ClearXY();
+ Deactivate();
}
void LCD::PrintChar( char c, unsigned short x, unsigned short y, int fgColor, int bgColor )
@@ -523,7 +519,7 @@
unsigned short usedColorFG = fgColor == -1 ? _background : fgColor == -2 ? _foreground : ( unsigned short ) fgColor;
unsigned short usedColorBG = bgColor == -1 ? _background : bgColor == -2 ? _foreground : ( unsigned short ) bgColor;
- _lcd_pin_cs = LOW;
+ Activate();
if ( _orientation == PORTRAIT )
{
@@ -564,8 +560,7 @@
temp += ( _font.width / 8 );
}
}
- _lcd_pin_cs = HIGH;
- ClearXY();
+ Deactivate();
}
void LCD::RotateChar( char c, unsigned short x, unsigned short y, int pos, int fgColor, int bgColor, unsigned short deg )
@@ -579,7 +574,7 @@
unsigned short usedColorFG = fgColor == -1 ? _background : fgColor == -2 ? _foreground : ( unsigned short ) fgColor;
unsigned short usedColorBG = bgColor == -1 ? _background : bgColor == -2 ? _foreground : ( unsigned short ) bgColor;
- _lcd_pin_cs = LOW;
+ Activate();
temp = ( ( c - _font.offset ) * ( ( _font.width / 8 ) * _font.height ) ) + 4;
for ( j = 0; j < _font.height; j++ )
@@ -602,6 +597,5 @@
}
temp += ( _font.width / 8 );
}
- _lcd_pin_cs = HIGH;
- ClearXY();
+ Deactivate();
}
--- a/lcd_base.h Sun Dec 02 01:44:23 2012 +0000
+++ b/lcd_base.h Sun Dec 02 05:44:52 2012 +0000
@@ -120,11 +120,40 @@
* or produce garbage.
*
* This function is controller-specific and needs to be implemented
- * separately for each available implementation.
+ * separately for each available display.
* \param oritentation The display orientation, landscape is default.
*/
virtual void Initialize( orientation_t orientation ) = 0;
+ /** 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.
+ * \remarks This function is controller-specific and needs to be
+ * implemented separately for each available display.
+ */
+ virtual void Sleep( void ) = 0;
+
+ /** 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 ).
+ * \remarks This function is controller-specific and needs to be
+ * implemented separately for each available display.
+ */
+ virtual void WakeUp( void ) = 0;
+
/** Set the foreground color for painting.
*
* This is the default foreground color to be used in painting operations.
@@ -312,8 +341,21 @@
* \param height Height of the display in pixels.
* \param CS Pin connected to the CS input of the display.
* \param RS Pin connected to the RS input of the display.
+ * \param RESET Pin connected to the RESET input of the display.
*/
- LCD( unsigned short width, unsigned short height ,PinName CS, PinName RS );
+ LCD( unsigned short width, unsigned short height ,PinName CS, PinName RS, PinName RESET );
+
+ /** Activates the display for command/data transfer.
+ *
+ * Usually achieved by pulling the CS pin of the display low.
+ */
+ virtual void Activate( void );
+
+ /** Deactivates the display after data has been transmitted.
+ *
+ * Usually achieved by pulling the CS pin of the display high.
+ */
+ virtual void Deactivate( void );
/** Sends a command to the display.
*
@@ -416,11 +458,11 @@
virtual void RotateChar( char c, unsigned short x, unsigned short y, int pos, int fgColor = -2, int bgColor = -1, unsigned short deg = 0 );
protected:
- unsigned short _disp_width, _disp_height;
- DigitalOut _lcd_pin_cs, _lcd_pin_rs;
- orientation_t _orientation;
- unsigned short _foreground, _background;
- font_metrics_t _font;
+ unsigned short _disp_width, _disp_height;
+ DigitalOut _lcd_pin_cs, _lcd_pin_rs, _lcd_pin_reset;
+ orientation_t _orientation;
+ unsigned short _foreground, _background;
+ font_metrics_t _font;
};
#endif /* TFTLCD_BASE_H */
--- a/ssd1289.cpp Sun Dec 02 01:44:23 2012 +0000
+++ b/ssd1289.cpp Sun Dec 02 05:44:52 2012 +0000
@@ -22,21 +22,17 @@
#include "ssd1289.h"
#include "helpers.h"
-SSD1289LCD::SSD1289LCD( PinName CS, PinName RESET, PinName RS, PinName WR, BusOut* DATA_PORT, PinName RD )
- : LCD( 240, 320, CS, RS ), _lcd_pin_reset( RESET ), _lcd_pin_wr( WR )
+SSD1289_LCD::SSD1289_LCD( PinName CS, PinName RESET, PinName RS, PinName WR, BusOut* DATA_PORT, PinName BL, PinName RD )
+ : LCD( 240, 320, CS, RS, RESET ), _lcd_pin_wr( WR )
{
_lcd_port = DATA_PORT;
- if ( RD != NC )
- _lcd_pin_rd = new DigitalOut( RD );
- else
- _lcd_pin_rd = 0;
-
- SetForeground();
- SetBackground();
- _font.font = 0;
+ if ( BL != NC ) _lcd_pin_bl = new DigitalOut( BL );
+ else _lcd_pin_bl = 0;
+ if ( RD != NC ) _lcd_pin_rd = new DigitalOut( RD );
+ else _lcd_pin_rd = 0;
}
-void SSD1289LCD::Initialize( orientation_t orientation )
+void SSD1289_LCD::Initialize( orientation_t orientation )
{
_orientation = orientation;
@@ -46,12 +42,14 @@
wait_ms( 15 );
_lcd_pin_reset = HIGH;
_lcd_pin_cs = HIGH;
+ if ( _lcd_pin_bl != 0 )
+ *_lcd_pin_bl = HIGH;
if ( _lcd_pin_rd != 0 )
*_lcd_pin_rd = HIGH;
_lcd_pin_wr = HIGH;
wait_ms( 15 );
-
+ Activate();
WriteCmdData( 0x00, 0x0001 ); wait_ms( 1 );
WriteCmdData( 0x03, 0xA8A4 ); wait_ms( 1 );
WriteCmdData( 0x0C, 0x0000 ); wait_ms( 1 );
@@ -94,27 +92,38 @@
WriteCmdData( 0x4f, 0x0000 ); wait_ms( 1 );
WriteCmdData( 0x4e, 0x0000 ); wait_ms( 1 );
WriteCmd( 0x22 );
+ Deactivate();
}
-void SSD1289LCD::WriteCmd( unsigned short cmd )
+void SSD1289_LCD::Sleep( void )
{
- _lcd_pin_rs = LOW;
- _lcd_pin_cs = LOW;
- _lcd_port->write( cmd );
- pulseLow( _lcd_pin_wr );
- _lcd_pin_cs = HIGH;
+ // TODO: figure out if the SSD1289 controller has sleep and wakeup commands
+ if ( _lcd_pin_bl != 0 )
+ *_lcd_pin_bl = LOW;
}
-void SSD1289LCD::WriteData( unsigned short data )
+void SSD1289_LCD::WakeUp( void )
+{
+ // TODO: figure out if the SSD1289 controller has sleep and wakeup commands
+ if ( _lcd_pin_bl != 0 )
+ *_lcd_pin_bl = HIGH;
+}
+
+void SSD1289_LCD::WriteCmd( unsigned short cmd )
+{
+ _lcd_pin_rs = LOW;
+ _lcd_port->write( cmd );
+ pulseLow( _lcd_pin_wr );
+}
+
+void SSD1289_LCD::WriteData( unsigned short data )
{
_lcd_pin_rs = HIGH;
- _lcd_pin_cs = LOW;
_lcd_port->write( data );
pulseLow( _lcd_pin_wr );
- _lcd_pin_cs = HIGH;
}
-void SSD1289LCD::SetXY( uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2 )
+void SSD1289_LCD::SetXY( uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2 )
{
if ( _orientation == LANDSCAPE )
{
--- a/ssd1289.h Sun Dec 02 01:44:23 2012 +0000
+++ b/ssd1289.h Sun Dec 02 05:44:52 2012 +0000
@@ -1,4 +1,4 @@
-/** \file ssd.h
+/** \file ssd1289.h
* \brief mbed TFT LCD controller for displays with the SSD1289 IC.
* \copyright GNU Public License, v2. or later
*
@@ -40,7 +40,7 @@
* works with this library is the ITDB02-3.2S from iTeadStudio - a RGB TFT
* with 240x320 pixels resolution and 65K colors, using 16-bit interface.
*
- * The display needs 20 or 21 pins to work with mbed, so it is possibly not
+ * The display needs 20 to 22 pins to work with mbed, so it is possibly not
* the best of choices out there, but other than that it uses +3.3V for
* power and logic, as well as the backlight, thus can be interfaced directly
* to the mbed without the need of shields or level shifters as with Arduino.
@@ -53,7 +53,7 @@
* // prepare the data bus for writing commands and pixel data
* BusOut dataBus( p30, p29, p28, p27, p26, p25, p24, p23, p22, p21, p20, p19, p18, p17, p16, p15 ); // 16 pins
* // create the lcd instance
- * SSD1289 lcd( p14, p13, p12, p11, &dataBus ); // control pins and data bus
+ * SSD1289_LCD lcd( p14, p13, p12, p11, &dataBus ); // control pins and data bus
*
* int main()
* {
@@ -72,7 +72,7 @@
* \version 0.1
* \author Todor Todorov
*/
-class SSD1289LCD : public LCD
+class SSD1289_LCD : public LCD
{
public:
/** Creates a new instance of the class.
@@ -82,11 +82,12 @@
* \param RS Pin for the RS signal.
* \param WR Pin for the WR signal.
* \param DATA_PORT Address of the data bus for transfer of commands and pixel data.
+ * \param BL Pin for controlling the backlight. By default not used.
* \param RD Pin for the RD signal. This line is not needed by the driver, so if you would like to
* use the pin on the mbed for something else, just pull-up the respective pin on the LCD high,
* and do not assign a value to this parameter when creating the controller instance.
*/
- SSD1289LCD( PinName CS, PinName RESET, PinName RS, PinName WR, BusOut* DATA_PORT, PinName RD = NC );
+ SSD1289_LCD( PinName CS, PinName RESET, PinName RS, PinName WR, BusOut* DATA_PORT, PinName BL = NC, PinName RD = NC );
/** Initialize display.
*
@@ -100,14 +101,70 @@
*/
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 );
+
+ /** 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:
- DigitalOut _lcd_pin_reset, _lcd_pin_wr;
- BusOut* _lcd_port;
+ DigitalOut _lcd_pin_wr;
+ BusOut* _lcd_port;
+ DigitalOut* _lcd_pin_bl;
DigitalOut* _lcd_pin_rd;
};