forked from Bodmer/TFT_eSPI
Bodmer
0e0fd75277
The library has been cleaned up as it has got a bit untidy due to the large number of small incremental changes. 4bit Sprite examples renaed to be consistent with others. alphaBlend example moved to generic folder (alphaBlend fn was moved to TFT_eSPI class). Added sections + explanatory comments to functions prototypes. Temporary comments added for potential gotchas for noobs when using DMA. spi_begin/end functions renamed to reflect functionality. Old fns retained for backwards compatibility with user setup.h files.
156 lines
6.1 KiB
C
156 lines
6.1 KiB
C
////////////////////////////////////////////////////
|
|
// TFT_eSPI generic driver functions //
|
|
////////////////////////////////////////////////////
|
|
|
|
#ifndef _TFT_eSPI_GENERICH_
|
|
#define _TFT_eSPI_GENERICH_
|
|
|
|
// Processor ID reported by getSetup()
|
|
#define PROCESSOR_ID 0x0000
|
|
|
|
// Include processor specific header
|
|
// None
|
|
|
|
// Processor specific code used by SPI bus transaction startWrite and endWrite functions
|
|
#define SET_BUS_WRITE_MODE // Not used
|
|
#define SET_BUS_READ_MODE // Not used
|
|
|
|
// Code to check if DMA is busy, used by SPI bus transaction startWrite and endWrite functions
|
|
#define DMA_BUSY_CHECK // Not used so leave blank
|
|
|
|
// To be safe, SUPPORT_TRANSACTIONS is assumed mandatory
|
|
#if !defined (SUPPORT_TRANSACTIONS)
|
|
#define SUPPORT_TRANSACTIONS
|
|
#endif
|
|
|
|
// Initialise processor specific SPI functions, used by init()
|
|
#define INIT_TFT_DATA_BUS
|
|
|
|
// If smooth fonts are enabled the filing system may need to be loaded
|
|
#ifdef SMOOTH_FONT
|
|
// Call up the filing system for the anti-aliased fonts
|
|
//#define FS_NO_GLOBALS
|
|
//#include <FS.h>
|
|
#endif
|
|
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
// Define the DC (TFT Data/Command or Register Select (RS))pin drive code
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
#ifndef TFT_DC
|
|
#define DC_C // No macro allocated so it generates no code
|
|
#define DC_D // No macro allocated so it generates no code
|
|
#else
|
|
#define DC_C digitalWrite(TFT_DC, LOW)
|
|
#define DC_D digitalWrite(TFT_DC, HIGH)
|
|
#endif
|
|
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
// Define the CS (TFT chip select) pin drive code
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
#ifndef TFT_CS
|
|
#define CS_L // No macro allocated so it generates no code
|
|
#define CS_H // No macro allocated so it generates no code
|
|
#else
|
|
#define CS_L digitalWrite(TFT_CS, LOW)
|
|
#define CS_H digitalWrite(TFT_CS, HIGH)
|
|
#endif
|
|
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
// Define the WR (TFT Write) pin drive code
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
#ifdef TFT_WR
|
|
#define WR_L digitalWrite(TFT_WR, LOW)
|
|
#define WR_H digitalWrite(TFT_WR, HIGH)
|
|
#endif
|
|
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
// Define the touch screen chip select pin drive code
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
#if !defined TOUCH_CS || (TOUCH_CS < 0)
|
|
#define T_CS_L // No macro allocated so it generates no code
|
|
#define T_CS_H // No macro allocated so it generates no code
|
|
#else
|
|
#define T_CS_L digitalWrite(TOUCH_CS, LOW)
|
|
#define T_CS_H digitalWrite(TOUCH_CS, HIGH)
|
|
#endif
|
|
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
// Make sure TFT_MISO is defined if not used to avoid an error message
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
#ifndef TFT_MISO
|
|
#define TFT_MISO -1
|
|
#endif
|
|
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
// Macros to write commands/pixel colour data to an ILI9488 TFT
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
#if defined (ILI9488_DRIVER) // 16 bit colour converted to 3 bytes for 18 bit RGB
|
|
|
|
// Write 8 bits to TFT
|
|
#define tft_Write_8(C) spi.transfer(C)
|
|
|
|
// Convert 16 bit colour to 18 bit and write in 3 bytes
|
|
#define tft_Write_16(C) spi.transfer(((C) & 0xF800)>>8); \
|
|
spi.transfer(((C) & 0x07E0)>>3); \
|
|
spi.transfer(((C) & 0x001F)<<3)
|
|
|
|
// Convert swapped byte 16 bit colour to 18 bit and write in 3 bytes
|
|
#define tft_Write_16S(C) spi.transfer((C) & 0xF8); \
|
|
spi.transfer(((C) & 0xE000)>>11 | ((C) & 0x07)<<5); \
|
|
spi.transfer(((C) & 0x1F00)>>5)
|
|
// Write 32 bits to TFT
|
|
#define tft_Write_32(C) spi.transfer16((C)>>16); spi.transfer16((uint16_t)(C))
|
|
|
|
// Write two address coordinates
|
|
#define tft_Write_32C(C,D) spi.transfer16(C); spi.transfer16(D)
|
|
|
|
// Write same value twice
|
|
#define tft_Write_32D(C) spi.transfer16(C); spi.transfer16(C)
|
|
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
// Macros to write commands/pixel colour data to other displays
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
#else
|
|
#if defined (RPI_DISPLAY_TYPE) // RPi TFT type always needs 16 bit transfers
|
|
#define tft_Write_8(C) spi.transfer(0); spi.transfer(C)
|
|
#else
|
|
#ifdef __AVR__ // AVR processors do not have 16 bit transfer
|
|
#define tft_Write_8(C) {SPDR=(C); while (!(SPSR&_BV(SPIF)));}
|
|
#define tft_Write_16(C) tft_Write_8((uint8_t)((C)>>8));tft_Write_8((uint8_t)((C)>>0))
|
|
#define tft_Write_16S(C) tft_Write_8((uint8_t)((C)>>0));tft_Write_8((uint8_t)((C)>>8))
|
|
#else
|
|
#define tft_Write_8(C) spi.transfer(C)
|
|
#define tft_Write_16(C) spi.transfer16(C)
|
|
#define tft_Write_16S(C) spi.transfer16(((C)>>8) | ((C)<<8))
|
|
#endif // AVR
|
|
#endif // RPI_DISPLAY_TYPE
|
|
|
|
#define tft_Write_32(C) \
|
|
tft_Write_16((uint16_t) ((C)>>16)); \
|
|
tft_Write_16((uint16_t) ((C)>>0))
|
|
|
|
#define tft_Write_32C(C,D) \
|
|
tft_Write_16((uint16_t) (C)); \
|
|
tft_Write_16((uint16_t) (D))
|
|
|
|
#define tft_Write_32D(C) \
|
|
tft_Write_16((uint16_t) (C)); \
|
|
tft_Write_16((uint16_t) (C))
|
|
#endif
|
|
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
// Macros to read from display using SPI or software SPI
|
|
////////////////////////////////////////////////////////////////////////////////////////
|
|
#if defined (TFT_SDA_READ)
|
|
// Use a bit banged function call for STM32 and bi-directional SDA pin
|
|
#define TFT_eSPI_ENABLE_8_BIT_READ // Enable tft_Read_8(void);
|
|
#define SCLK_L digitalWrite(TFT_SCLK, LOW)
|
|
#define SCLK_H digitalWrite(TFT_SCLK, LOW)
|
|
#else
|
|
// Use a SPI read transfer
|
|
#define tft_Read_8() spi.transfer(0)
|
|
#endif
|
|
|
|
|
|
#endif // Header end
|