madhu sudhana / Mbed OS newTFTLCD_

1.44 tft lcd display

Dependencies:   TFT_fonts mbed-os

Fork of newTFTLCD by madhu sudhana

hx8340bs.h@6:059ca1648211, 2012-12-03 (annotated)

Committer:
ttodorov
Date:
Mon Dec 03 15:38:56 2012 +0000
Revision:
6:059ca1648211
Parent:
5:09b6d228ceea
Child:
10:69571adcfad5
- add standard __cplusplus ifdefs to headers

Who changed what in which revision?

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