en 129 / TFTLCDwithFastIO

TFTLCD with FastIO

Fork of TFTLCD by en 129

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 */