258 lines
No EOL
10 KiB
C++
258 lines
No EOL
10 KiB
C++
/*
|
|
ILI9163C - A fast SPI driver for TFT that use Ilitek ILI9163C.
|
|
|
|
Features:
|
|
- Very FAST!, expecially with Teensy 3.x where uses DMA SPI.
|
|
- It uses just 4 or 5 wires.
|
|
- Compatible at command level with Adafruit display series so it's easy to adapt existing code.
|
|
- It uses the standard Adafruit_GFX Library (you need to install).
|
|
|
|
Background:
|
|
I got one of those displays from a chinese ebay seller but unfortunatly I cannot get
|
|
any working library so I decided to hack it. ILI9163C looks pretty similar to other
|
|
display driver but it uses it's own commands so it's tricky to work with it unlsess you
|
|
carefully fight with his gigantic and not so clever datasheet.
|
|
My display it's a 1.44"", 128x128 that suppose to substitute Nokia 5110 LCD and here's the
|
|
first confusion! Many sellers claim that it's compatible with Nokia 5110 (that use a philips
|
|
controller) but the only similarity it's the pin names since that this one it's color and
|
|
have totally different controller that's not compatible.
|
|
http://www.ebay.com/itm/Replace-Nokia-5110-LCD-1-44-Red-Serial-128X128-SPI-Color-TFT-LCD-Display-Module-/141196897388
|
|
http://www.elecrow.com/144-128x-128-tft-lcd-with-spi-interface-p-855.html
|
|
Pay attention that ILI9163C can drive different resolutions and your display can be
|
|
160*128 or whatever, also there's a strain of this display with a black PCB that a friend of mine
|
|
got some weeks ago and need some small changes in library to get working.
|
|
If you look at TFT_ILI9163C.h file you can add your modifications and let me know so I
|
|
can include for future versions.
|
|
|
|
Code Optimizations:
|
|
The purpose of this library it's SPEED. I have tried to use hardware optimized calls
|
|
where was possible and results are quite good for most applications, actually nly filled circles
|
|
are still a bit slow. Many SPI call has been optimized by reduce un-needed triggers to RS and CS
|
|
lines. Of course it can be improved so feel free to add suggestions.
|
|
-------------------------------------------------------------------------------
|
|
Copyright (c) 2014, .S.U.M.O.T.O.Y., coded by Max MC Costa.
|
|
|
|
TFT_ILI9163C Library is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
TFT_ILI9163C 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 General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with Foobar. If not, see <http://www.gnu.org/licenses/>.
|
|
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|
|
This file needs the following Libraries:
|
|
|
|
Adafruit_GFX by Adafruit:
|
|
https://github.com/adafruit/Adafruit-GFX-Library
|
|
Remember to update GFX library often to have more features with this library!
|
|
From this version I'm using my version of Adafruit_GFX library:
|
|
https://github.com/sumotoy/Adafruit-GFX-Library
|
|
It has faster char rendering and some small little optimizations but you can
|
|
choose one of the two freely since are both fully compatible.
|
|
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
|
Special Thanks:
|
|
Thanks Adafruit for his Adafruit_GFX!
|
|
Thanks to Paul Stoffregen for his beautiful Teensy3 and DMA SPI.
|
|
|
|
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|
|
Version:
|
|
0.1a1: First release, compile correctly. Altrough not fully working!
|
|
0.1a3: Better but still some addressing problems.
|
|
|
|
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|
|
BugList of the current version:
|
|
|
|
- This is an Alpha version and finally TFT reacts to code but I still have some
|
|
issue to fix so if you want to download remember that pixel addressing it's still
|
|
not complete and display rotation have several issues.
|
|
Actually no scroll commands (only in release will be included).
|
|
*/
|
|
#ifndef _TFT_ILI9163CLIB_H_
|
|
#define _TFT_ILI9163CLIB_H_
|
|
|
|
#if ARDUINO >= 100
|
|
#include "Arduino.h"
|
|
#include "Print.h"
|
|
#else
|
|
#include "WProgram.h"
|
|
#endif
|
|
|
|
#include <Adafruit_GFX.h>
|
|
|
|
//----- Define here witch display you own
|
|
#define __144_RED_PCB__//128x128
|
|
//---------------------------------------
|
|
|
|
#if defined(__SAM3X8E__)
|
|
#include <include/pio.h>
|
|
#define PROGMEM
|
|
#define pgm_read_byte(addr) (*(const unsigned char *)(addr))
|
|
#define pgm_read_word(addr) (*(const unsigned short *)(addr))
|
|
typedef unsigned char prog_uchar;
|
|
#endif
|
|
#ifdef __AVR__
|
|
#include <avr/pgmspace.h>
|
|
#endif
|
|
#if defined(__MK20DX128__) || defined(__MK20DX256__)
|
|
// #include "mk20dx128.h"
|
|
// #include "core_pins.h"
|
|
#define __DMASPI
|
|
|
|
#define CTAR_24MHz (SPI_CTAR_PBR(0) | SPI_CTAR_BR(0) | SPI_CTAR_CSSCK(0) | SPI_CTAR_DBR)
|
|
#define CTAR_16MHz (SPI_CTAR_PBR(1) | SPI_CTAR_BR(0) | SPI_CTAR_CSSCK(0) | SPI_CTAR_DBR)
|
|
#define CTAR_12MHz (SPI_CTAR_PBR(0) | SPI_CTAR_BR(0) | SPI_CTAR_CSSCK(0))
|
|
#define CTAR_8MHz (SPI_CTAR_PBR(1) | SPI_CTAR_BR(0) | SPI_CTAR_CSSCK(0))
|
|
#define CTAR_6MHz (SPI_CTAR_PBR(0) | SPI_CTAR_BR(1) | SPI_CTAR_CSSCK(1))
|
|
#define CTAR_4MHz (SPI_CTAR_PBR(1) | SPI_CTAR_BR(1) | SPI_CTAR_CSSCK(1))
|
|
#endif
|
|
|
|
//ILI9163C versions------------------------
|
|
#if defined(__144_RED_PCB__)
|
|
#define _TFTWIDTH 128
|
|
#define _TFTHEIGHT 160
|
|
#define __COLORSPC DTA_MADCTL_BGR//DTA_MADCTL_RGB
|
|
#define __GAMMASET1
|
|
#else
|
|
#define _TFTWIDTH 128
|
|
#define _TFTHEIGHT 160
|
|
#endif
|
|
//-----------------------------------------
|
|
|
|
|
|
#define _DTA_WIDTH _TFTWIDTH//0x7F//=128 hex
|
|
#define _DTA_HEIGHT _TFTHEIGHT//0x7F//=128 hex
|
|
//ILI9163C registers-----------------------
|
|
#define CMD_NOP 0x00//Non operation
|
|
#define CMD_SWRESET 0x01//Soft Reset
|
|
#define CMD_RDDID 0x04//Read Display Identification Information
|
|
#define CMD_RDDST 0x09//Read Display Status
|
|
#define CMD_RDMODE 0x0A//Read Display power mode
|
|
#define CMD_RDMADCTL 0x0B//Read Display MADCTL (orientation)
|
|
#define CMD_RDPIXFMT 0x0C//Read Display Pixel Format
|
|
#define CMD_RDIMMDE 0x0D//Read Display Image Mode
|
|
#define CMD_RDSNMDE 0x0E//Read Display Signal Mode
|
|
//#define CMD_RDSNMDE 0x0F//Read Display Signal Mode
|
|
|
|
#define CMD_SLPIN 0x10//Sleep ON
|
|
#define CMD_SLPOUT 0x11//Sleep OFF
|
|
#define CMD_PTLON 0x12//Partial Mode ON
|
|
#define CMD_NORML 0x13//Normal Display ON
|
|
#define CMD_DINVOF 0x20//Display Inversion OFF
|
|
#define CMD_DINVON 0x21//Display Inversion ON
|
|
#define CMD_GAMMASET 0x26//Gamma Set
|
|
#define CMD_DISPOFF 0x28//Display OFF
|
|
#define CMD_DISPON 0x29//Display ON
|
|
#define CMD_IDLEON 0x39//Idle Mode ON
|
|
#define CMD_IDLEOF 0x38//Idle Mode OFF
|
|
#define CMD_CLMADRS 0x2A//Column Address Set
|
|
#define CMD_PGEADRS 0x2B//Page Address Set
|
|
|
|
#define CMD_RAMWR 0x2C//Memory Write
|
|
#define CMD_RAMRD 0x2E//Memory Read
|
|
#define CMD_CLRSPACE 0x2D//Color Space : 4K/65K/262K
|
|
#define CMD_PARTAREA 0x30//Partial Area
|
|
#define CMD_VSCLLDEF 0x33//Vertical Scroll Definition
|
|
#define CMD_TEFXLON 0x34//Tearing Effect Line ON
|
|
#define CMD_TEFXLOF 0x35//Tearing Effect Line OFF
|
|
#define CMD_MADCTL 0x36//Memory Access Control
|
|
|
|
#define CMD_PIXFMT 0x3A//Interface Pixel Format
|
|
#define CMD_FRMCTR1 0xB1//Frame Rate Control (In normal mode/Full colors)
|
|
#define CMD_FRMCTR2 0xB2//Frame Rate Control(In Idle mode/8-colors)
|
|
#define CMD_FRMCTR3 0xB3//Frame Rate Control(In Partial mode/full colors)
|
|
#define CMD_DINVCTR 0xB4//Display Inversion Control
|
|
#define CMD_RGBBLK 0xB5//RGB Interface Blanking Porch setting
|
|
#define CMD_DFUNCTR 0xB6//Display Fuction set 5
|
|
#define CMD_SDRVDIR 0xB7//Source Driver Direction Control
|
|
#define CMD_GDRVDIR 0xB8//Gate Driver Direction Control
|
|
|
|
#define CMD_PWCTR1 0xC0//Power_Control1
|
|
#define CMD_PWCTR2 0xC1//Power_Control2
|
|
#define CMD_PWCTR3 0xC2//Power_Control3
|
|
#define CMD_PWCTR4 0xC3//Power_Control4
|
|
#define CMD_PWCTR5 0xC4//Power_Control5
|
|
#define CMD_VCOMCTR1 0xC5//VCOM_Control 1
|
|
#define CMD_VCOMCTR2 0xC6//VCOM_Control 2
|
|
#define CMD_VCOMOFFS 0xC7//VCOM Offset Control
|
|
|
|
#define CMD_WRID4VL 0xD3//Write ID4 Value
|
|
|
|
#define CMD_NVMEMFC1 0xD5//NV Memory Function Controller(1)
|
|
#define CMD_NVMEMFC2 0xD6//NV Memory Function Controller(1)
|
|
#define CMD_NVMEMFC3 0xD7//NV Memory Function Controller(1)
|
|
#define CMD_RDID1 0xDA//Read ID1
|
|
#define CMD_RDID2 0xDB//Read ID2
|
|
#define CMD_RDID3 0xDC//Read ID3
|
|
#define CMD_RDID4 0xDD//Read ID4
|
|
#define CMD_PGAMMAC 0xE0//Positive Gamma Correction Setting
|
|
#define CMD_NGAMMAC 0xE1//Negative Gamma Correction Setting
|
|
#define CMD_GAMRSEL 0xF2//GAM_R_SEL
|
|
|
|
|
|
#define DTA_MADCTL_MX 0x00//0x40
|
|
#define DTA_MADCTL_MY 0x80
|
|
#define DTA_MADCTL_MV 0x20
|
|
#define DTA_MADCTL_ML 0x10
|
|
#define DTA_MADCTL_RGB 0x00
|
|
#define DTA_MADCTL_BGR 0x08
|
|
#define DTA_MADCTL_MH 0x04
|
|
|
|
|
|
class TFT_ILI9163C : public Adafruit_GFX {
|
|
|
|
public:
|
|
|
|
TFT_ILI9163C(uint8_t cspin,uint8_t dcpin,uint8_t rstpin);
|
|
TFT_ILI9163C(uint8_t CS, uint8_t DC);
|
|
|
|
void begin(void),
|
|
setAddrWindow(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1),
|
|
setCursor(int16_t x,int16_t y),
|
|
pushColor(uint16_t color),
|
|
fillScreen(uint16_t color=0x0000),
|
|
clearScreen(uint16_t color=0x0000),
|
|
drawPixel(int16_t x, int16_t y, uint16_t color),
|
|
drawFastVLine(int16_t x, int16_t y, int16_t h, uint16_t color),
|
|
drawFastHLine(int16_t x, int16_t y, int16_t w, uint16_t color),
|
|
fillRect(int16_t x, int16_t y, int16_t w, int16_t h,uint16_t color),
|
|
setRotation(uint8_t r),
|
|
invertDisplay(boolean i);
|
|
uint16_t Color565(uint8_t r, uint8_t g, uint8_t b);
|
|
void setBitrate(uint32_t n);
|
|
|
|
private:
|
|
|
|
uint8_t tabcolor;
|
|
void writecommand(uint8_t c);
|
|
void writedata(uint8_t d);
|
|
void writedata16(uint16_t d);
|
|
void chipInit();
|
|
bool boundaryCheck(int16_t x,int16_t y);
|
|
void homeAddress();
|
|
#if defined(__AVR__)
|
|
void spiwrite(uint8_t);
|
|
volatile uint8_t *dataport, *clkport, *csport, *rsport;
|
|
uint8_t _cs,_rs,_sid,_sclk,_rst;
|
|
uint8_t datapinmask, clkpinmask, cspinmask, rspinmask;
|
|
#endif // #ifdef __AVR__
|
|
|
|
#if defined(__SAM3X8E__)
|
|
void spiwrite(uint8_t);
|
|
Pio *dataport, *clkport, *csport, *rsport;
|
|
uint8_t _cs,_rs,_sid,_sclk,_rst;
|
|
uint32_t datapinmask, clkpinmask, cspinmask, rspinmask;
|
|
#endif // #if defined(__SAM3X8E__)
|
|
|
|
#if defined(__MK20DX128__) || defined(__MK20DX256__)
|
|
uint8_t _cs,_rs,_sid,_sclk,_rst;
|
|
uint8_t pcs_data, pcs_command;
|
|
uint32_t ctar;
|
|
volatile uint8_t *datapin, *clkpin, *cspin, *rspin;
|
|
#endif
|
|
};
|
|
#endif |