/*! * @file Adafruit_ILI9341.cpp * * @mainpage Adafruit ILI9341 TFT Displays * * @section intro_sec Introduction * * This is the documentation for Adafruit's ILI9341 driver for the * Arduino platform. * * This library works with the Adafruit 2.8" Touch Shield V2 (SPI) * http://www.adafruit.com/products/1651 * * Adafruit 2.4" TFT LCD with Touchscreen Breakout w/MicroSD Socket - ILI9341 * https://www.adafruit.com/product/2478 * * 2.8" TFT LCD with Touchscreen Breakout Board w/MicroSD Socket - ILI9341 * https://www.adafruit.com/product/1770 * * 2.2" 18-bit color TFT LCD display with microSD card breakout - ILI9340 * https://www.adafruit.com/product/1770 * * TFT FeatherWing - 2.4" 320x240 Touchscreen For All Feathers * https://www.adafruit.com/product/3315 * * These displays use SPI to communicate, 4 or 5 pins are required * to interface (RST is optional). * * Adafruit invests time and resources providing this open source code, * please support Adafruit and open-source hardware by purchasing * products from Adafruit! * * @section dependencies Dependencies * * This library depends on * Adafruit_GFX being present on your system. Please make sure you have * installed the latest version before using this library. * * @section author Author * * Written by Limor "ladyada" Fried for Adafruit Industries. * * @section license License * * BSD license, all text here must be included in any redistribution. * */ #include "Adafruit_ILI9341.h" #ifndef ARDUINO_STM32_FEATHER #include "pins_arduino.h" #ifndef RASPI #include "wiring_private.h" #endif #endif #include #if defined (ARDUINO_ARCH_ARC32) || defined (ARDUINO_MAXIM) #define SPI_DEFAULT_FREQ 16000000 #elif defined (__AVR__) || defined(TEENSYDUINO) #define SPI_DEFAULT_FREQ 8000000 #elif defined(ESP8266) || defined(ESP32) #define SPI_DEFAULT_FREQ 40000000 #elif defined(RASPI) #define SPI_DEFAULT_FREQ 80000000 #elif defined(ARDUINO_ARCH_STM32F1) #define SPI_DEFAULT_FREQ 36000000 #else #define SPI_DEFAULT_FREQ 24000000 ///< Default SPI data clock frequency #endif #define MADCTL_MY 0x80 ///< Bottom to top #define MADCTL_MX 0x40 ///< Right to left #define MADCTL_MV 0x20 ///< Reverse Mode #define MADCTL_ML 0x10 ///< LCD refresh Bottom to top #define MADCTL_RGB 0x00 ///< Red-Green-Blue pixel order #define MADCTL_BGR 0x08 ///< Blue-Green-Red pixel order #define MADCTL_MH 0x04 ///< LCD refresh right to left /**************************************************************************/ /*! @brief Instantiate Adafruit ILI9341 driver with software SPI @param cs Chip select pin # @param dc Data/Command pin # @param mosi SPI MOSI pin # @param sclk SPI Clock pin # @param rst Reset pin # (optional, pass -1 if unused) @param miso SPI MISO pin # (optional, pass -1 if unused) */ /**************************************************************************/ Adafruit_ILI9341::Adafruit_ILI9341(int8_t cs, int8_t dc, int8_t mosi, int8_t sclk, int8_t rst, int8_t miso) : Adafruit_SPITFT(ILI9341_TFTWIDTH, ILI9341_TFTHEIGHT, cs, dc, mosi, sclk, rst, miso) { } /**************************************************************************/ /*! @brief Instantiate Adafruit ILI9341 driver with hardware SPI @param cs Chip select pin # @param dc Data/Command pin # @param rst Reset pin # (optional, pass -1 if unused) */ /**************************************************************************/ Adafruit_ILI9341::Adafruit_ILI9341(int8_t cs, int8_t dc, int8_t rst) : Adafruit_SPITFT(ILI9341_TFTWIDTH, ILI9341_TFTHEIGHT, cs, dc, rst) { } static const uint8_t PROGMEM initcmd[] = { 0xEF, 3, 0x03, 0x80, 0x02, 0xCF, 3, 0x00, 0xC1, 0x30, 0xED, 4, 0x64, 0x03, 0x12, 0x81, 0xE8, 3, 0x85, 0x00, 0x78, 0xCB, 5, 0x39, 0x2C, 0x00, 0x34, 0x02, 0xF7, 1, 0x20, 0xEA, 2, 0x00, 0x00, ILI9341_PWCTR1 , 1, 0x23, // Power control VRH[5:0] ILI9341_PWCTR2 , 1, 0x10, // Power control SAP[2:0];BT[3:0] ILI9341_VMCTR1 , 2, 0x3e, 0x28, // VCM control ILI9341_VMCTR2 , 1, 0x86, // VCM control2 ILI9341_MADCTL , 1, 0x48, // Memory Access Control ILI9341_VSCRSADD, 1, 0x00, // Vertical scroll zero ILI9341_PIXFMT , 1, 0x55, ILI9341_FRMCTR1 , 2, 0x00, 0x18, ILI9341_DFUNCTR , 3, 0x08, 0x82, 0x27, // Display Function Control 0xF2, 1, 0x00, // 3Gamma Function Disable ILI9341_GAMMASET , 1, 0x01, // Gamma curve selected ILI9341_GMCTRP1 , 15, 0x0F, 0x31, 0x2B, 0x0C, 0x0E, 0x08, // Set Gamma 0x4E, 0xF1, 0x37, 0x07, 0x10, 0x03, 0x0E, 0x09, 0x00, ILI9341_GMCTRN1 , 15, 0x00, 0x0E, 0x14, 0x03, 0x11, 0x07, // Set Gamma 0x31, 0xC1, 0x48, 0x08, 0x0F, 0x0C, 0x31, 0x36, 0x0F, ILI9341_SLPOUT , 0x80, // Exit Sleep ILI9341_DISPON , 0x80, // Display on 0x00 // End of list }; /**************************************************************************/ /*! @brief Initialize ILI9341 chip Connects to the ILI9341 over SPI and sends initialization procedure commands @param freq Desired SPI clock frequency */ /**************************************************************************/ void Adafruit_ILI9341::begin(uint32_t freq) { if(!freq) freq = SPI_DEFAULT_FREQ; _freq = freq; initSPI(freq); startWrite(); uint8_t cmd, x, numArgs; const uint8_t *addr = initcmd; while((cmd = pgm_read_byte(addr++)) > 0) { writeCommand(cmd); x = pgm_read_byte(addr++); numArgs = x & 0x7F; while(numArgs--) spiWrite(pgm_read_byte(addr++)); if(x & 0x80) delay(120); } endWrite(); _width = ILI9341_TFTWIDTH; _height = ILI9341_TFTHEIGHT; } /**************************************************************************/ /*! @brief Set origin of (0,0) and orientation of TFT display @param m The index for rotation, from 0-3 inclusive */ /**************************************************************************/ void Adafruit_ILI9341::setRotation(uint8_t m) { rotation = m % 4; // can't be higher than 3 switch (rotation) { case 0: m = (MADCTL_MX | MADCTL_BGR); _width = ILI9341_TFTWIDTH; _height = ILI9341_TFTHEIGHT; break; case 1: m = (MADCTL_MV | MADCTL_BGR); _width = ILI9341_TFTHEIGHT; _height = ILI9341_TFTWIDTH; break; case 2: m = (MADCTL_MY | MADCTL_BGR); _width = ILI9341_TFTWIDTH; _height = ILI9341_TFTHEIGHT; break; case 3: m = (MADCTL_MX | MADCTL_MY | MADCTL_MV | MADCTL_BGR); _width = ILI9341_TFTHEIGHT; _height = ILI9341_TFTWIDTH; break; } startWrite(); writeCommand(ILI9341_MADCTL); spiWrite(m); endWrite(); } /**************************************************************************/ /*! @brief Enable/Disable display color inversion @param invert True to invert, False to have normal color */ /**************************************************************************/ void Adafruit_ILI9341::invertDisplay(boolean invert) { startWrite(); writeCommand(invert ? ILI9341_INVON : ILI9341_INVOFF); endWrite(); } /**************************************************************************/ /*! @brief Scroll display memory @param y How many pixels to scroll display by */ /**************************************************************************/ void Adafruit_ILI9341::scrollTo(uint16_t y) { startWrite(); writeCommand(ILI9341_VSCRSADD); SPI_WRITE16(y); endWrite(); } /**************************************************************************/ void Adafruit_ILI9341::setScrollMargins(uint16_t top, uint16_t bottom) { uint16_t height = _height - (top + bottom); startWrite(); writeCommand(0x33); SPI_WRITE16(top); SPI_WRITE16(height); SPI_WRITE16(bottom); endWrite(); } /**************************************************************************/ /*! @brief Set the "address window" - the rectangle we will write to RAM with the next chunk of SPI data writes. The ILI9341 will automatically wrap the data as each row is filled @param x TFT memory 'x' origin @param y TFT memory 'y' origin @param w Width of rectangle @param h Height of rectangle */ /**************************************************************************/ void Adafruit_ILI9341::setAddrWindow(uint16_t x, uint16_t y, uint16_t w, uint16_t h) { uint32_t xa = ((uint32_t)x << 16) | (x+w-1); uint32_t ya = ((uint32_t)y << 16) | (y+h-1); writeCommand(ILI9341_CASET); // Column addr set SPI_WRITE32(xa); writeCommand(ILI9341_PASET); // Row addr set SPI_WRITE32(ya); writeCommand(ILI9341_RAMWR); // write to RAM } /**************************************************************************/ /*! @brief Read 8 bits of data from ILI9341 configuration memory. NOT from RAM! This is highly undocumented/supported, it's really a hack but kinda works? @param command The command register to read data from @param index The byte index into the command to read from @return Unsigned 8-bit data read from ILI9341 register */ /**************************************************************************/ uint8_t Adafruit_ILI9341::readcommand8(uint8_t command, uint8_t index) { uint32_t freq = _freq; if(_freq > 24000000) _freq = 24000000; startWrite(); writeCommand(0xD9); // woo sekret command? spiWrite(0x10 + index); writeCommand(command); uint8_t r = spiRead(); endWrite(); _freq = freq; return r; }