ILI9225 SPI TFT Library

/media/uploads/Arman92/ili9225_tft_front-1-.jpg
This library works with the ILI9225 based 2.2" 176x220 TFT LCD shields commonly found on eBay. Note that there is a commonly available 2.2" 240x320 TFT module very similar in appearance but using the ILI9341 driver. (Only the main Buffer IC and I/O pins are different)
Sample Usage program
Wiring guide :
mbed board	LCD board
+ 3,3V or +5V	VCC
GND	GND
GPIO_PIN	RST (Reset pin)
GPIO_PIN	RS [Command (RS=0)/ Parameter (RS=1)]
GPIO_PIN or GND	CS (Chip selection pin)
SPI_MOSI	SDI (Serial data input )
SPI_SCK	CLK (Reference clock)
GPIO_PIN or PWM or VCC	LED (Backlit)
TFT_22_ILI9225.h

Committer:: Arman92
Date:: 2015-08-31
Revision:: 0:e97881aef140
File content as of revision 0:e97881aef140:

#ifndef TFT_22_ILI9225_h
#define TFT_22_ILI9225_h
#include "mbed.h"
#include "FAmap.h"
#include "EN_FA_font.h"

// Other libraries
#include "SPI.h"

/* ILI9225 screen size */
#define ILI9225_LCD_WIDTH  176
#define ILI9225_LCD_HEIGHT 220

/* ILI9225 LCD Registers */
#define ILI9225_DRIVER_OUTPUT_CTRL      (0x01u)  // Driver Output Control
#define ILI9225_LCD_AC_DRIVING_CTRL     (0x02u)  // LCD AC Driving Control
#define ILI9225_ENTRY_MODE              (0x03u)  // Entry Mode
#define ILI9225_DISP_CTRL1              (0x07u)  // Display Control 1
#define ILI9225_BLANK_PERIOD_CTRL1      (0x08u)  // Blank Period Control
#define ILI9225_FRAME_CYCLE_CTRL        (0x0Bu)  // Frame Cycle Control
#define ILI9225_INTERFACE_CTRL          (0x0Cu)  // Interface Control
#define ILI9225_OSC_CTRL                (0x0Fu)  // Osc Control
#define ILI9225_POWER_CTRL1             (0x10u)  // Power Control 1
#define ILI9225_POWER_CTRL2             (0x11u)  // Power Control 2
#define ILI9225_POWER_CTRL3             (0x12u)  // Power Control 3
#define ILI9225_POWER_CTRL4             (0x13u)  // Power Control 4
#define ILI9225_POWER_CTRL5             (0x14u)  // Power Control 5
#define ILI9225_VCI_RECYCLING           (0x15u)  // VCI Recycling
#define ILI9225_RAM_ADDR_SET1           (0x20u)  // Horizontal GRAM Address Set
#define ILI9225_RAM_ADDR_SET2           (0x21u)  // Vertical GRAM Address Set
#define ILI9225_GRAM_DATA_REG           (0x22u)  // GRAM Data Register
#define ILI9225_GATE_SCAN_CTRL          (0x30u)  // Gate Scan Control Register
#define ILI9225_VERTICAL_SCROLL_CTRL1   (0x31u)  // Vertical Scroll Control 1 Register
#define ILI9225_VERTICAL_SCROLL_CTRL2   (0x32u)  // Vertical Scroll Control 2 Register
#define ILI9225_VERTICAL_SCROLL_CTRL3   (0x33u)  // Vertical Scroll Control 3 Register
#define ILI9225_PARTIAL_DRIVING_POS1    (0x34u)  // Partial Driving Position 1 Register
#define ILI9225_PARTIAL_DRIVING_POS2    (0x35u)  // Partial Driving Position 2 Register
#define ILI9225_HORIZONTAL_WINDOW_ADDR1 (0x36u)  // Horizontal Address Start Position
#define ILI9225_HORIZONTAL_WINDOW_ADDR2 (0x37u)  // Horizontal Address End Position
#define ILI9225_VERTICAL_WINDOW_ADDR1   (0x38u)  // Vertical Address Start Position
#define ILI9225_VERTICAL_WINDOW_ADDR2   (0x39u)  // Vertical Address End Position
#define ILI9225_GAMMA_CTRL1             (0x50u)  // Gamma Control 1
#define ILI9225_GAMMA_CTRL2             (0x51u)  // Gamma Control 2
#define ILI9225_GAMMA_CTRL3             (0x52u)  // Gamma Control 3
#define ILI9225_GAMMA_CTRL4             (0x53u)  // Gamma Control 4
#define ILI9225_GAMMA_CTRL5             (0x54u)  // Gamma Control 5
#define ILI9225_GAMMA_CTRL6             (0x55u)  // Gamma Control 6
#define ILI9225_GAMMA_CTRL7             (0x56u)  // Gamma Control 7
#define ILI9225_GAMMA_CTRL8             (0x57u)  // Gamma Control 8
#define ILI9225_GAMMA_CTRL9             (0x58u)  // Gamma Control 9
#define ILI9225_GAMMA_CTRL10            (0x59u)  // Gamma Control 10

#define ILI9225C_INVOFF  0x20
#define ILI9225C_INVON   0x21


/* RGB 24-bits color table definition (RGB888). */
#define RGB888_RGB565(color) ((((color) >> 19) & 0x1f) << 11) | ((((color) >> 10) & 0x3f) << 5) | (((color) >> 3) & 0x1f)

#define COLOR_BLACK          RGB888_RGB565(0x000000u)
#define COLOR_WHITE          RGB888_RGB565(0xFFFFFFu)
#define COLOR_BLUE           RGB888_RGB565(0x0000FFu)
#define COLOR_GREEN          RGB888_RGB565(0x00FF00u)
#define COLOR_RED            RGB888_RGB565(0xFF0000u)
#define COLOR_NAVY           RGB888_RGB565(0x000080u)
#define COLOR_DARKBLUE       RGB888_RGB565(0x00008Bu)
#define COLOR_DARKGREEN      RGB888_RGB565(0x006400u)
#define COLOR_DARKCYAN       RGB888_RGB565(0x008B8Bu)
#define COLOR_CYAN           RGB888_RGB565(0x00FFFFu)
#define COLOR_TURQUOISE      RGB888_RGB565(0x40E0D0u)
#define COLOR_INDIGO         RGB888_RGB565(0x4B0082u)
#define COLOR_DARKRED        RGB888_RGB565(0x800000u)
#define COLOR_OLIVE          RGB888_RGB565(0x808000u)
#define COLOR_GRAY           RGB888_RGB565(0x808080u)
#define COLOR_SKYBLUE        RGB888_RGB565(0x87CEEBu)
#define COLOR_BLUEVIOLET     RGB888_RGB565(0x8A2BE2u)
#define COLOR_LIGHTGREEN     RGB888_RGB565(0x90EE90u)
#define COLOR_DARKVIOLET     RGB888_RGB565(0x9400D3u)
#define COLOR_YELLOWGREEN    RGB888_RGB565(0x9ACD32u)
#define COLOR_BROWN          RGB888_RGB565(0xA52A2Au)
#define COLOR_DARKGRAY       RGB888_RGB565(0xA9A9A9u)
#define COLOR_SIENNA         RGB888_RGB565(0xA0522Du)
#define COLOR_LIGHTBLUE      RGB888_RGB565(0xADD8E6u)
#define COLOR_GREENYELLOW    RGB888_RGB565(0xADFF2Fu)
#define COLOR_SILVER         RGB888_RGB565(0xC0C0C0u)
#define COLOR_LIGHTGREY      RGB888_RGB565(0xD3D3D3u)
#define COLOR_LIGHTCYAN      RGB888_RGB565(0xE0FFFFu)
#define COLOR_VIOLET         RGB888_RGB565(0xEE82EEu)
#define COLOR_AZUR           RGB888_RGB565(0xF0FFFFu)
#define COLOR_BEIGE          RGB888_RGB565(0xF5F5DCu)
#define COLOR_MAGENTA        RGB888_RGB565(0xFF00FFu)
#define COLOR_TOMATO         RGB888_RGB565(0xFF6347u)
#define COLOR_GOLD           RGB888_RGB565(0xFFD700u)
#define COLOR_ORANGE         RGB888_RGB565(0xFFA500u)
#define COLOR_SNOW           RGB888_RGB565(0xFFFAFAu)
#define COLOR_YELLOW         RGB888_RGB565(0xFFFF00u)

/* Font defines */
#define FONT_HEADER_SIZE 4 // 1: pixel width of 1 font character, 2: pixel height, 
#define readFontByte(x) pgm_read_byte(&cfont.font[x])  

extern uint8_t Terminal6x8[];
extern uint8_t Terminal11x16[];
extern uint8_t Terminal12x16[];
extern uint8_t Trebuchet_MS16x21[];

struct _currentFont
{
    uint8_t* font;
    uint8_t width;
    uint8_t height;
    uint8_t offset;
    uint8_t numchars;
    uint8_t nbrows;
};

/// Main and core class
class TFT_22_ILI9225 {

public:

    TFT_22_ILI9225(PinName RST, PinName RS, PinName CS, PinName SDI, PinName CLK, PinName LED);
    //TFT_22_ILI9225(PinName RST, PinName RS, PinName CS, PinName LED);


    /// Initialization
    void begin(void);

    /// Clear the screen
    void clear(void);

    /// fill the screen with color:
    void fill(uint16_t color);

    /// Invert screen
    /// @param  flag true to invert, false for normal screen
    void invert(bool flag);

    /// Switch backlight on or off
    /// @param  flag true=on, false=off
    void setBacklight(bool flag);

    /// Switch display on or off
    /// @param  flag true=on, false=off
    void setDisplay(bool flag);

    /// Set orientation
    /// @param  orientation orientation, 0=portrait, 1=right rotated landscape, 2=reverse portrait, 3=left rotated landscape
    void setOrientation(uint8_t orientation);

    /// Get orientation
    /// @return orientation orientation, 0=portrait, 1=right rotated landscape, 2=reverse portrait, 3=left rotated landscape
    uint8_t getOrientation(void);

    /// Font size, x-axis
    /// @return horizontal size of current font, in pixels
    uint8_t fontX(void);

    /// Font size, y-axis
    /// @return vertical size of current font, in pixels
    uint8_t fontY(void);

    /// Screen size, x-axis
    /// @return horizontal size of the screen, in pixels
    /// @note   240 means 240 pixels and thus 0..239 coordinates (decimal)
    uint16_t maxX(void);

    /// Screen size, y-axis
    /// @return vertical size of the screen, in pixels
    /// @note   220 means 220 pixels and thus 0..219 coordinates (decimal)
    uint16_t maxY(void);

    /// Draw circle
    /// @param  x0 center, point coordinate, x-axis
    /// @param  y0 center, point coordinate, y-axis
    /// @param  radius radius
    /// @param  color 16-bit color
    void drawCircle(uint16_t x0, uint16_t y0, uint16_t radius, uint16_t color);

    /// Draw solid circle
    /// @param  x0 center, point coordinate, x-axis
    /// @param  y0 center, point coordinate, y-axis
    /// @param  radius radius
    /// @param  color 16-bit color
    void fillCircle(uint8_t x0, uint8_t y0, uint8_t radius, uint16_t color);

    /// Set background color
    /// @param  color background color, default=black
    void setBackgroundColor(uint16_t color = COLOR_BLACK);

    /// Draw line, rectangle coordinates
    /// @param  x1 top left coordinate, x-axis
    /// @param  y1 top left coordinate, y-axis
    /// @param  x2 bottom right coordinate, x-axis
    /// @param  y2 bottom right coordinate, y-axis
    /// @param  color 16-bit color
    void drawLine(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color);

    /// Draw rectangle, rectangle coordinates
    /// @param  x1 top left coordinate, x-axis
    /// @param  y1 top left coordinate, y-axis
    /// @param  x2 bottom right coordinate, x-axis
    /// @param  y2 bottom right coordinate, y-axis
    /// @param  color 16-bit color
    void drawRectangle(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color);

    /// Draw solid rectangle, rectangle coordinates
    /// @param  x1 top left coordinate, x-axis
    /// @param  y1 top left coordinate, y-axis
    /// @param  x2 bottom right coordinate, x-axis
    /// @param  y2 bottom right coordinate, y-axis
    /// @param  color 16-bit color
    void fillRectangle(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color);

    /// Draw pixel
    /// @param  x1 point coordinate, x-axis
    /// @param  y1 point coordinate, y-axis
    /// @param  color 16-bit color
    void drawPixel(uint16_t x1, uint16_t y1, uint16_t color);

    /// Draw ASCII Text (pixel coordinates)
    /// @param  x point coordinate, x-axis
    /// @param  y point coordinate, y-axis
    /// @param  s text string
    /// @param  color 16-bit color, default=white
    void drawText(uint16_t x, uint16_t y, char *s, uint16_t color = COLOR_WHITE);

    /// Calculate 16-bit color from 8-bit Red-Green-Blue components
    /// @param  red red component, 0x00..0xff
    /// @param  green green component, 0x00..0xff
    /// @param  blue blue component, 0x00..0xff
    /// @return 16-bit color
    uint16_t setColor(uint8_t red, uint8_t green, uint8_t blue);

    /// Calculate 8-bit Red-Green-Blue components from 16-bit color
    /// @param  rgb 16-bit color
    /// @param  red red component, 0x00..0xff
    /// @param  green green component, 0x00..0xff
    /// @param  blue blue component, 0x00..0xff
    void splitColor(uint16_t rgb, uint8_t &red, uint8_t &green, uint8_t &blue);

    /// Draw triangle, triangle coordinates
    /// @param  x1 corner 1 coordinate, x-axis
    /// @param  y1 corner 1 coordinate, y-axis
    /// @param  x2 corner 2 coordinate, x-axis
    /// @param  y2 corner 2 coordinate, y-axis
    /// @param  x3 corner 3 coordinate, x-axis
    /// @param  y3 corner 3 coordinate, y-axis
    /// @param  color 16-bit color
    void drawTriangle(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t x3, uint16_t y3, uint16_t color);

    /// Draw solid triangle, triangle coordinates
    /// @param  x1 corner 1 coordinate, x-axis
    /// @param  y1 corner 1 coordinate, y-axis
    /// @param  x2 corner 2 coordinate, x-axis
    /// @param  y2 corner 2 coordinate, y-axis
    /// @param  x3 corner 3 coordinate, x-axis
    /// @param  y3 corner 3 coordinate, y-axis
    /// @param  color 16-bit color
    void fillTriangle(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t x3, uint16_t y3, uint16_t color);

    /// Set current font
    /// @param  font Font name
    void setFont(uint8_t* font);

    /// Draw single character (pixel coordinates)
    /// @param  x point coordinate, x-axis
    /// @param  y point coordinate, y-axis
    /// @param  ch ASCII character
    /// @param  color 16-bit color, default=white
    uint16_t drawChar(uint16_t x, uint16_t y, uint16_t ch, uint16_t color = COLOR_WHITE);

    void setFontColor(int color);
    void setNumberFormatToFa(void);
    void setNumberFormatToEn(void);
    void setFontEffect(int ef);
    void setItalicOn(void);
    void setItalicOff(void);
    void putChar(char character);
    void putBoldChar(char character, int size);
    void goToXY(int x, int y);
    void setTextHighlightOn(void);
    void setTextHighlightOff(void);
    void setTextHighlightColor(unsigned int color);
    void putMixedEnAndFaString(const unsigned char *string, int size);
    void unicode2ascii(char *uni_str, char *ascii_str); 
    void roundRectangle(int x0, int y0, int x1, int y1, int rad, bool fill, int color);


private:
    SPI spi;

    void     _swap(uint16_t &a, uint16_t &b),
        _setWindow(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1),
        _orientCoordinates(uint16_t &x1, uint16_t &y1),
        _writeRegister(uint16_t reg, uint16_t data),
        _writeData(uint8_t HI, uint8_t LO),
        _writeCommand(uint8_t HI, uint8_t LO);

    uint16_t _maxX, _maxY, _bgColor;

    PinName  _rst, _rs, _cs, _sdi, _clk, _led;
    DigitalInOut _rsInOut;
    DigitalInOut _csInOut;
    DigitalInOut _rstInOut;
    DigitalInOut _ledInOut;
    uint8_t _orientation;


    bool  hwSPI;

    _currentFont cfont;

};

#endif
Repository toolbox

Export to desktop IDE
Repository details

Type:	Library
Created:	31 Aug 2015
Imports:	154
Forks:	0
Commits:	3
Dependents:	1
Dependencies:	0
Followers:	5
ILI9225 SPI TFT Library

TFT_22_ILI9225.h

File content as of revision 0:e97881aef140:

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning
