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

ssd1289.h@4:3ac4239f6c9c, 2012-12-02 (annotated)

Committer:
ttodorov
Date:
Sun Dec 02 05:44:52 2012 +0000
Revision:
4:3ac4239f6c9c
Parent:
3:64a5b67d5b51
Child:
5:09b6d228ceea
- renamed SSD1289 implementation; - refactored base class functions and removed redundant addressing; - added sleep and wake functions; - added HX8340B serial implementation; - fixed test case

Who changed what in which revision?

UserRevisionLine numberNew contents of line
ttodorov 4:3ac4239f6c9c 1 /** \file ssd1289.h
ttodorov 0:881ff0b71102 2 * \brief mbed TFT LCD controller for displays with the SSD1289 IC.
ttodorov 0:881ff0b71102 3 * \copyright GNU Public License, v2. or later
ttodorov 0:881ff0b71102 4 *
ttodorov 0:881ff0b71102 5 * A known display with this type of controller chip is the ITDB02-3.2S
ttodorov 0:881ff0b71102 6 * from http://imall.iteadstudio.com
ttodorov 0:881ff0b71102 7 *
ttodorov 0:881ff0b71102 8 * This library is based on the Arduino/chipKIT UTFT library by Henning
ttodorov 0:881ff0b71102 9 * Karlsen, http://henningkarlsen.com/electronics/library.php?id=52
ttodorov 0:881ff0b71102 10 *
ttodorov 0:881ff0b71102 11 * Copyright (C)2010-2012 Henning Karlsen. All right reserved.
ttodorov 0:881ff0b71102 12 * Copyright (C)2012 Todor Todorov.
ttodorov 0:881ff0b71102 13 *
ttodorov 0:881ff0b71102 14 * This library is free software; you can redistribute it and/or
ttodorov 0:881ff0b71102 15 * modify it under the terms of the GNU Lesser General Public
ttodorov 0:881ff0b71102 16 * License as published by the Free Software Foundation; either
ttodorov 0:881ff0b71102 17 * version 2.1 of the License, or (at your option) any later version.
ttodorov 0:881ff0b71102 18 *
ttodorov 0:881ff0b71102 19 * This library is distributed in the hope that it will be useful,
ttodorov 0:881ff0b71102 20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
ttodorov 0:881ff0b71102 21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
ttodorov 0:881ff0b71102 22 * Lesser General Public License for more details.
ttodorov 0:881ff0b71102 23 *
ttodorov 0:881ff0b71102 24 * You should have received a copy of the GNU Lesser General Public
ttodorov 0:881ff0b71102 25 * License along with this library; if not, write to:
ttodorov 0:881ff0b71102 26 *
ttodorov 0:881ff0b71102 27 * Free Software Foundation, Inc.
ttodorov 0:881ff0b71102 28 * 51 Franklin St, 5th Floor, Boston, MA 02110-1301, USA
ttodorov 0:881ff0b71102 29 *
ttodorov 0:881ff0b71102 30 *********************************************************************/
ttodorov 3:64a5b67d5b51 31 #ifndef TFTLCD_SSD1289_H
ttodorov 3:64a5b67d5b51 32 #define TFTLCD_SSD1289_H
ttodorov 0:881ff0b71102 33
ttodorov 0:881ff0b71102 34 #include "lcd_base.h"
ttodorov 0:881ff0b71102 35
ttodorov 3:64a5b67d5b51 36 /** Represents a LCD instance.
ttodorov 3:64a5b67d5b51 37 *
ttodorov 3:64a5b67d5b51 38 * This is the utility class, through which the display can be manipulated
ttodorov 3:64a5b67d5b51 39 * and graphics objects can be shown to the user. A known display, which
ttodorov 3:64a5b67d5b51 40 * works with this library is the ITDB02-3.2S from iTeadStudio - a RGB TFT
ttodorov 3:64a5b67d5b51 41 * with 240x320 pixels resolution and 65K colors, using 16-bit interface.
ttodorov 3:64a5b67d5b51 42 *
ttodorov 4:3ac4239f6c9c 43 * The display needs 20 to 22 pins to work with mbed, so it is possibly not
ttodorov 3:64a5b67d5b51 44 * the best of choices out there, but other than that it uses +3.3V for
ttodorov 3:64a5b67d5b51 45 * power and logic, as well as the backlight, thus can be interfaced directly
ttodorov 3:64a5b67d5b51 46 * to the mbed without the need of shields or level shifters as with Arduino.
ttodorov 3:64a5b67d5b51 47 *
ttodorov 3:64a5b67d5b51 48 * How to use:
ttodorov 3:64a5b67d5b51 49 * \code
ttodorov 3:64a5b67d5b51 50 * // include the library, this will also pull in the header for the provided fonts
ttodorov 3:64a5b67d5b51 51 * #include "ssd1289.h"
ttodorov 3:64a5b67d5b51 52 *
ttodorov 3:64a5b67d5b51 53 * // prepare the data bus for writing commands and pixel data
ttodorov 3:64a5b67d5b51 54 * BusOut dataBus( p30, p29, p28, p27, p26, p25, p24, p23, p22, p21, p20, p19, p18, p17, p16, p15 ); // 16 pins
ttodorov 3:64a5b67d5b51 55 * // create the lcd instance
ttodorov 4:3ac4239f6c9c 56 * SSD1289_LCD lcd( p14, p13, p12, p11, &dataBus ); // control pins and data bus
ttodorov 3:64a5b67d5b51 57 *
ttodorov 3:64a5b67d5b51 58 * int main()
ttodorov 3:64a5b67d5b51 59 * {
ttodorov 3:64a5b67d5b51 60 * // initialize display - place it in standard portrait mode and set background to black and
ttodorov 3:64a5b67d5b51 61 * // foreground to white color.
ttodorov 3:64a5b67d5b51 62 * lcd.Initialize();
ttodorov 3:64a5b67d5b51 63 * // set current font to the smallest 8x12 pixels font.
ttodorov 3:64a5b67d5b51 64 * lcd.SetFont( Font8x12 );
ttodorov 3:64a5b67d5b51 65 * // print something on the screen
ttodorov 3:64a5b67d5b51 66 * lcd.Print( "Hello, World!", CENTER, 25 ); // align text to center horizontally and use starndard colors
ttodorov 3:64a5b67d5b51 67 *
ttodorov 3:64a5b67d5b51 68 * while ( 1 ) { }
ttodorov 3:64a5b67d5b51 69 * }
ttodorov 3:64a5b67d5b51 70 *
ttodorov 3:64a5b67d5b51 71 * \endcode
ttodorov 3:64a5b67d5b51 72 * \version 0.1
ttodorov 3:64a5b67d5b51 73 * \author Todor Todorov
ttodorov 3:64a5b67d5b51 74 */
ttodorov 4:3ac4239f6c9c 75 class SSD1289_LCD : public LCD
ttodorov 0:881ff0b71102 76 {
ttodorov 0:881ff0b71102 77 public:
ttodorov 0:881ff0b71102 78 /** Creates a new instance of the class.
ttodorov 0:881ff0b71102 79 *
ttodorov 0:881ff0b71102 80 * \param CS Pin for the ChipSelect signal.
ttodorov 0:881ff0b71102 81 * \param RESET Pin for the RESET line.
ttodorov 0:881ff0b71102 82 * \param RS Pin for the RS signal.
ttodorov 0:881ff0b71102 83 * \param WR Pin for the WR signal.
ttodorov 0:881ff0b71102 84 * \param DATA_PORT Address of the data bus for transfer of commands and pixel data.
ttodorov 4:3ac4239f6c9c 85 * \param BL Pin for controlling the backlight. By default not used.
ttodorov 0:881ff0b71102 86 * \param RD Pin for the RD signal. This line is not needed by the driver, so if you would like to
ttodorov 0:881ff0b71102 87 * use the pin on the mbed for something else, just pull-up the respective pin on the LCD high,
ttodorov 0:881ff0b71102 88 * and do not assign a value to this parameter when creating the controller instance.
ttodorov 0:881ff0b71102 89 */
ttodorov 4:3ac4239f6c9c 90 SSD1289_LCD( PinName CS, PinName RESET, PinName RS, PinName WR, BusOut* DATA_PORT, PinName BL = NC, PinName RD = NC );
ttodorov 0:881ff0b71102 91
ttodorov 0:881ff0b71102 92 /** Initialize display.
ttodorov 0:881ff0b71102 93 *
ttodorov 0:881ff0b71102 94 * Wakes up the display from sleep, initializes power parameters.
ttodorov 0:881ff0b71102 95 * This function must be called first, befor any painting on the
ttodorov 0:881ff0b71102 96 * display is done, otherwise the positioning of graphical elements
ttodorov 0:881ff0b71102 97 * will not work properly and any paynt operation will not be visible
ttodorov 0:881ff0b71102 98 * or produce garbage.
ttodorov 0:881ff0b71102 99 *
ttodorov 0:881ff0b71102 100 * \param oritentation The display orientation, landscape is default.
ttodorov 0:881ff0b71102 101 */
ttodorov 0:881ff0b71102 102 virtual void Initialize( orientation_t orientation = LANDSCAPE );
ttodorov 0:881ff0b71102 103
ttodorov 4:3ac4239f6c9c 104 /** Puts the display to sleep.
ttodorov 4:3ac4239f6c9c 105 *
ttodorov 4:3ac4239f6c9c 106 * When the display is in sleep mode, its power consumption is
ttodorov 4:3ac4239f6c9c 107 * minimized. Before new pixel data can be written to the display
ttodorov 4:3ac4239f6c9c 108 * memory, the controller needs to be brought out of sleep mode.
ttodorov 4:3ac4239f6c9c 109 * \sa #WakeUp( void );
ttodorov 4:3ac4239f6c9c 110 * \remarks The result of this operation might not be exactly as
ttodorov 4:3ac4239f6c9c 111 * expected. Putting the display to sleep will cause the
ttodorov 4:3ac4239f6c9c 112 * controller to switch to the standard color of the LCD,
ttodorov 4:3ac4239f6c9c 113 * so depending on whether the display is normally white,
ttodorov 4:3ac4239f6c9c 114 * or normally dark, the screen might or might not go
ttodorov 4:3ac4239f6c9c 115 * dark. Additional power saving can be achieved, if
ttodorov 4:3ac4239f6c9c 116 * the backlight of the used display is not hardwired on
ttodorov 4:3ac4239f6c9c 117 * the PCB and can be controlled via the BL pin.
ttodorov 4:3ac4239f6c9c 118 */
ttodorov 4:3ac4239f6c9c 119 virtual void Sleep( void );
ttodorov 4:3ac4239f6c9c 120
ttodorov 4:3ac4239f6c9c 121 /** Wakes up the display from sleep mode.
ttodorov 4:3ac4239f6c9c 122 *
ttodorov 4:3ac4239f6c9c 123 * This function needs to be called before any other, when the
ttodorov 4:3ac4239f6c9c 124 * display has been put into sleep mode by a previois call to
ttodorov 4:3ac4239f6c9c 125 * #Sleep( void ).
ttodorov 4:3ac4239f6c9c 126 */
ttodorov 4:3ac4239f6c9c 127 virtual void WakeUp( void );
ttodorov 4:3ac4239f6c9c 128
ttodorov 0:881ff0b71102 129 protected:
ttodorov 4:3ac4239f6c9c 130 /** Sends a command to the display.
ttodorov 4:3ac4239f6c9c 131 *
ttodorov 4:3ac4239f6c9c 132 * \param cmd The display command.
ttodorov 4:3ac4239f6c9c 133 * \remarks Commands are controller-specific and this function needs to
ttodorov 4:3ac4239f6c9c 134 * be implemented separately for each available controller.
ttodorov 4:3ac4239f6c9c 135 */
ttodorov 2:81ed304b7e9b 136 virtual void WriteCmd( unsigned short cmd );
ttodorov 4:3ac4239f6c9c 137
ttodorov 4:3ac4239f6c9c 138 /** Sends pixel data to the display.
ttodorov 4:3ac4239f6c9c 139 *
ttodorov 4:3ac4239f6c9c 140 * \param data The display data.
ttodorov 4:3ac4239f6c9c 141 * \remarks Sendin data is controller-specific and this function needs to
ttodorov 4:3ac4239f6c9c 142 * be implemented separately for each available controller.
ttodorov 4:3ac4239f6c9c 143 */
ttodorov 2:81ed304b7e9b 144 virtual void WriteData( unsigned short data );
ttodorov 4:3ac4239f6c9c 145
ttodorov 4:3ac4239f6c9c 146 /** Assigns a chunk of the display memory to receive data.
ttodorov 4:3ac4239f6c9c 147 *
ttodorov 4:3ac4239f6c9c 148 * When data is sent to the display after this function completes, the opertion will
ttodorov 4:3ac4239f6c9c 149 * start from the begining of the assigned address (pixel position) and the pointer
ttodorov 4:3ac4239f6c9c 150 * will be automatically incremented so that the next data write operation will continue
ttodorov 4:3ac4239f6c9c 151 * with the next pixel from the memory block. If more data is written than available
ttodorov 4:3ac4239f6c9c 152 * pixels, at the end of the block the pointer will jump back to its beginning and
ttodorov 4:3ac4239f6c9c 153 * commence again, until the next address change command is sent to the display.
ttodorov 4:3ac4239f6c9c 154 *
ttodorov 4:3ac4239f6c9c 155 * \param x1 The X coordinate of the pixel at the beginning of the block.
ttodorov 4:3ac4239f6c9c 156 * \param y1 The Y coordinate of the pixel at the beginning of the block.
ttodorov 4:3ac4239f6c9c 157 * \param x2 The X coordinate of the pixel at the end of the block.
ttodorov 4:3ac4239f6c9c 158 * \param y2 The Y coordinate of the pixel at the end of the block.
ttodorov 4:3ac4239f6c9c 159 * \remarks Addressing commands are controller-specific and this function needs to be
ttodorov 4:3ac4239f6c9c 160 * implemented separately for each available controller.
ttodorov 4:3ac4239f6c9c 161 */
ttodorov 2:81ed304b7e9b 162 virtual void SetXY( uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2 );
ttodorov 0:881ff0b71102 163
ttodorov 0:881ff0b71102 164 private:
ttodorov 4:3ac4239f6c9c 165 DigitalOut _lcd_pin_wr;
ttodorov 4:3ac4239f6c9c 166 BusOut* _lcd_port;
ttodorov 4:3ac4239f6c9c 167 DigitalOut* _lcd_pin_bl;
ttodorov 0:881ff0b71102 168 DigitalOut* _lcd_pin_rd;
ttodorov 0:881ff0b71102 169 };
ttodorov 0:881ff0b71102 170
ttodorov 3:64a5b67d5b51 171 #endif /* TFTLCD_SSD1289_H */