385 lines
17 KiB
C++
385 lines
17 KiB
C++
#include "Adafruit_ST7735.h"
|
|
#include "Adafruit_ST77xx.h"
|
|
|
|
// CONSTRUCTORS ************************************************************
|
|
|
|
/*!
|
|
@brief Instantiate Adafruit ST7735 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)
|
|
*/
|
|
Adafruit_ST7735::Adafruit_ST7735(int8_t cs, int8_t dc, int8_t mosi, int8_t sclk,
|
|
int8_t rst)
|
|
: Adafruit_ST77xx(ST7735_TFTWIDTH_128, ST7735_TFTHEIGHT_160, cs, dc, mosi,
|
|
sclk, rst) {}
|
|
|
|
/*!
|
|
@brief Instantiate Adafruit ST7735 driver with default hardware SPI
|
|
@param cs Chip select pin #
|
|
@param dc Data/Command pin #
|
|
@param rst Reset pin # (optional, pass -1 if unused)
|
|
*/
|
|
Adafruit_ST7735::Adafruit_ST7735(int8_t cs, int8_t dc, int8_t rst)
|
|
: Adafruit_ST77xx(ST7735_TFTWIDTH_128, ST7735_TFTHEIGHT_160, cs, dc, rst) {}
|
|
|
|
#if !defined(ESP8266)
|
|
/*!
|
|
@brief Instantiate Adafruit ST7735 driver with selectable hardware SPI
|
|
@param spiClass Pointer to an SPI device to use (e.g. &SPI1)
|
|
@param cs Chip select pin #
|
|
@param dc Data/Command pin #
|
|
@param rst Reset pin # (optional, pass -1 if unused)
|
|
*/
|
|
Adafruit_ST7735::Adafruit_ST7735(SPIClass *spiClass, int8_t cs, int8_t dc,
|
|
int8_t rst)
|
|
: Adafruit_ST77xx(ST7735_TFTWIDTH_128, ST7735_TFTHEIGHT_160, spiClass, cs,
|
|
dc, rst) {}
|
|
#endif // end !ESP8266
|
|
|
|
// SCREEN INITIALIZATION ***************************************************
|
|
|
|
// Rather than a bazillion writecommand() and writedata() calls, screen
|
|
// initialization commands and arguments are organized in these tables
|
|
// stored in PROGMEM. The table may look bulky, but that's mostly the
|
|
// formatting -- storage-wise this is hundreds of bytes more compact
|
|
// than the equivalent code. Companion function follows.
|
|
|
|
// clang-format off
|
|
static const uint8_t PROGMEM
|
|
Bcmd[] = { // Init commands for 7735B screens
|
|
18, // 18 commands in list:
|
|
ST77XX_SWRESET, ST_CMD_DELAY, // 1: Software reset, no args, w/delay
|
|
50, // 50 ms delay
|
|
ST77XX_SLPOUT, ST_CMD_DELAY, // 2: Out of sleep mode, no args, w/delay
|
|
255, // 255 = max (500 ms) delay
|
|
ST77XX_COLMOD, 1+ST_CMD_DELAY, // 3: Set color mode, 1 arg + delay:
|
|
0x05, // 16-bit color
|
|
10, // 10 ms delay
|
|
ST7735_FRMCTR1, 3+ST_CMD_DELAY, // 4: Frame rate control, 3 args + delay:
|
|
0x00, // fastest refresh
|
|
0x06, // 6 lines front porch
|
|
0x03, // 3 lines back porch
|
|
10, // 10 ms delay
|
|
ST77XX_MADCTL, 1, // 5: Mem access ctl (directions), 1 arg:
|
|
0x08, // Row/col addr, bottom-top refresh
|
|
ST7735_DISSET5, 2, // 6: Display settings #5, 2 args:
|
|
0x15, // 1 clk cycle nonoverlap, 2 cycle gate
|
|
// rise, 3 cycle osc equalize
|
|
0x02, // Fix on VTL
|
|
ST7735_INVCTR, 1, // 7: Display inversion control, 1 arg:
|
|
0x0, // Line inversion
|
|
ST7735_PWCTR1, 2+ST_CMD_DELAY, // 8: Power control, 2 args + delay:
|
|
0x02, // GVDD = 4.7V
|
|
0x70, // 1.0uA
|
|
10, // 10 ms delay
|
|
ST7735_PWCTR2, 1, // 9: Power control, 1 arg, no delay:
|
|
0x05, // VGH = 14.7V, VGL = -7.35V
|
|
ST7735_PWCTR3, 2, // 10: Power control, 2 args, no delay:
|
|
0x01, // Opamp current small
|
|
0x02, // Boost frequency
|
|
ST7735_VMCTR1, 2+ST_CMD_DELAY, // 11: Power control, 2 args + delay:
|
|
0x3C, // VCOMH = 4V
|
|
0x38, // VCOML = -1.1V
|
|
10, // 10 ms delay
|
|
ST7735_PWCTR6, 2, // 12: Power control, 2 args, no delay:
|
|
0x11, 0x15,
|
|
ST7735_GMCTRP1,16, // 13: Gamma Adjustments (pos. polarity), 16 args + delay:
|
|
0x09, 0x16, 0x09, 0x20, // (Not entirely necessary, but provides
|
|
0x21, 0x1B, 0x13, 0x19, // accurate colors)
|
|
0x17, 0x15, 0x1E, 0x2B,
|
|
0x04, 0x05, 0x02, 0x0E,
|
|
ST7735_GMCTRN1,16+ST_CMD_DELAY, // 14: Gamma Adjustments (neg. polarity), 16 args + delay:
|
|
0x0B, 0x14, 0x08, 0x1E, // (Not entirely necessary, but provides
|
|
0x22, 0x1D, 0x18, 0x1E, // accurate colors)
|
|
0x1B, 0x1A, 0x24, 0x2B,
|
|
0x06, 0x06, 0x02, 0x0F,
|
|
10, // 10 ms delay
|
|
ST77XX_CASET, 4, // 15: Column addr set, 4 args, no delay:
|
|
0x00, 0x02, // XSTART = 2
|
|
0x00, 0x81, // XEND = 129
|
|
ST77XX_RASET, 4, // 16: Row addr set, 4 args, no delay:
|
|
0x00, 0x02, // XSTART = 1
|
|
0x00, 0x81, // XEND = 160
|
|
ST77XX_NORON, ST_CMD_DELAY, // 17: Normal display on, no args, w/delay
|
|
10, // 10 ms delay
|
|
ST77XX_DISPON, ST_CMD_DELAY, // 18: Main screen turn on, no args, delay
|
|
255 }, // 255 = max (500 ms) delay
|
|
|
|
Rcmd1[] = { // 7735R init, part 1 (red or green tab)
|
|
15, // 15 commands in list:
|
|
ST77XX_SWRESET, ST_CMD_DELAY, // 1: Software reset, 0 args, w/delay
|
|
150, // 150 ms delay
|
|
ST77XX_SLPOUT, ST_CMD_DELAY, // 2: Out of sleep mode, 0 args, w/delay
|
|
255, // 500 ms delay
|
|
ST7735_FRMCTR1, 3, // 3: Framerate ctrl - normal mode, 3 arg:
|
|
0x01, 0x2C, 0x2D, // Rate = fosc/(1x2+40) * (LINE+2C+2D)
|
|
ST7735_FRMCTR2, 3, // 4: Framerate ctrl - idle mode, 3 args:
|
|
0x01, 0x2C, 0x2D, // Rate = fosc/(1x2+40) * (LINE+2C+2D)
|
|
ST7735_FRMCTR3, 6, // 5: Framerate - partial mode, 6 args:
|
|
0x01, 0x2C, 0x2D, // Dot inversion mode
|
|
0x01, 0x2C, 0x2D, // Line inversion mode
|
|
ST7735_INVCTR, 1, // 6: Display inversion ctrl, 1 arg:
|
|
0x07, // No inversion
|
|
ST7735_PWCTR1, 3, // 7: Power control, 3 args, no delay:
|
|
0xA2,
|
|
0x02, // -4.6V
|
|
0x84, // AUTO mode
|
|
ST7735_PWCTR2, 1, // 8: Power control, 1 arg, no delay:
|
|
0xC5, // VGH25=2.4C VGSEL=-10 VGH=3 * AVDD
|
|
ST7735_PWCTR3, 2, // 9: Power control, 2 args, no delay:
|
|
0x0A, // Opamp current small
|
|
0x00, // Boost frequency
|
|
ST7735_PWCTR4, 2, // 10: Power control, 2 args, no delay:
|
|
0x8A, // BCLK/2,
|
|
0x2A, // opamp current small & medium low
|
|
ST7735_PWCTR5, 2, // 11: Power control, 2 args, no delay:
|
|
0x8A, 0xEE,
|
|
ST7735_VMCTR1, 1, // 12: Power control, 1 arg, no delay:
|
|
0x0E,
|
|
ST77XX_INVOFF, 0, // 13: Don't invert display, no args
|
|
ST77XX_MADCTL, 1, // 14: Mem access ctl (directions), 1 arg:
|
|
0xC8, // row/col addr, bottom-top refresh
|
|
ST77XX_COLMOD, 1, // 15: set color mode, 1 arg, no delay:
|
|
0x05 }, // 16-bit color
|
|
|
|
Rcmd2green[] = { // 7735R init, part 2 (green tab only)
|
|
2, // 2 commands in list:
|
|
ST77XX_CASET, 4, // 1: Column addr set, 4 args, no delay:
|
|
0x00, 0x02, // XSTART = 0
|
|
0x00, 0x7F+0x02, // XEND = 127
|
|
ST77XX_RASET, 4, // 2: Row addr set, 4 args, no delay:
|
|
0x00, 0x01, // XSTART = 0
|
|
0x00, 0x9F+0x01 }, // XEND = 159
|
|
|
|
Rcmd2red[] = { // 7735R init, part 2 (red tab only)
|
|
2, // 2 commands in list:
|
|
ST77XX_CASET, 4, // 1: Column addr set, 4 args, no delay:
|
|
0x00, 0x00, // XSTART = 0
|
|
0x00, 0x7F, // XEND = 127
|
|
ST77XX_RASET, 4, // 2: Row addr set, 4 args, no delay:
|
|
0x00, 0x00, // XSTART = 0
|
|
0x00, 0x9F }, // XEND = 159
|
|
|
|
Rcmd2green144[] = { // 7735R init, part 2 (green 1.44 tab)
|
|
2, // 2 commands in list:
|
|
ST77XX_CASET, 4, // 1: Column addr set, 4 args, no delay:
|
|
0x00, 0x00, // XSTART = 0
|
|
0x00, 0x7F, // XEND = 127
|
|
ST77XX_RASET, 4, // 2: Row addr set, 4 args, no delay:
|
|
0x00, 0x00, // XSTART = 0
|
|
0x00, 0x7F }, // XEND = 127
|
|
|
|
Rcmd2green160x80[] = { // 7735R init, part 2 (mini 160x80)
|
|
2, // 2 commands in list:
|
|
ST77XX_CASET, 4, // 1: Column addr set, 4 args, no delay:
|
|
0x00, 0x00, // XSTART = 0
|
|
0x00, 0x4F, // XEND = 79
|
|
ST77XX_RASET, 4, // 2: Row addr set, 4 args, no delay:
|
|
0x00, 0x00, // XSTART = 0
|
|
0x00, 0x9F }, // XEND = 159
|
|
|
|
Rcmd2green160x80plugin[] = { // 7735R init, part 2 (mini 160x80 with plugin FPC)
|
|
3, // 3 commands in list:
|
|
ST77XX_INVON, 0, // 1: Display is inverted
|
|
ST77XX_CASET, 4, // 2: Column addr set, 4 args, no delay:
|
|
0x00, 0x00, // XSTART = 0
|
|
0x00, 0x4F, // XEND = 79
|
|
ST77XX_RASET, 4, // 3: Row addr set, 4 args, no delay:
|
|
0x00, 0x00, // XSTART = 0
|
|
0x00, 0x9F }, // XEND = 159
|
|
|
|
Rcmd3[] = { // 7735R init, part 3 (red or green tab)
|
|
4, // 4 commands in list:
|
|
ST7735_GMCTRP1, 16 , // 1: Gamma Adjustments (pos. polarity), 16 args + delay:
|
|
0x02, 0x1c, 0x07, 0x12, // (Not entirely necessary, but provides
|
|
0x37, 0x32, 0x29, 0x2d, // accurate colors)
|
|
0x29, 0x25, 0x2B, 0x39,
|
|
0x00, 0x01, 0x03, 0x10,
|
|
ST7735_GMCTRN1, 16 , // 2: Gamma Adjustments (neg. polarity), 16 args + delay:
|
|
0x03, 0x1d, 0x07, 0x06, // (Not entirely necessary, but provides
|
|
0x2E, 0x2C, 0x29, 0x2D, // accurate colors)
|
|
0x2E, 0x2E, 0x37, 0x3F,
|
|
0x00, 0x00, 0x02, 0x10,
|
|
ST77XX_NORON, ST_CMD_DELAY, // 3: Normal display on, no args, w/delay
|
|
10, // 10 ms delay
|
|
ST77XX_DISPON, ST_CMD_DELAY, // 4: Main screen turn on, no args w/delay
|
|
100 }; // 100 ms delay
|
|
|
|
// clang-format on
|
|
|
|
/**************************************************************************/
|
|
/*!
|
|
@brief Initialization code common to all ST7735B displays
|
|
*/
|
|
/**************************************************************************/
|
|
void Adafruit_ST7735::initB(void) {
|
|
commonInit(Bcmd);
|
|
setRotation(0);
|
|
}
|
|
|
|
/**************************************************************************/
|
|
/*!
|
|
@brief Initialization code common to all ST7735R displays
|
|
@param options Tab color from adafruit purchase
|
|
*/
|
|
/**************************************************************************/
|
|
void Adafruit_ST7735::initR(uint8_t options) {
|
|
commonInit(Rcmd1);
|
|
if (options == INITR_GREENTAB) {
|
|
displayInit(Rcmd2green);
|
|
_colstart = 2;
|
|
_rowstart = 1;
|
|
} else if ((options == INITR_144GREENTAB) || (options == INITR_HALLOWING)) {
|
|
_height = ST7735_TFTHEIGHT_128;
|
|
_width = ST7735_TFTWIDTH_128;
|
|
displayInit(Rcmd2green144);
|
|
_colstart = 2;
|
|
_rowstart = 3; // For default rotation 0
|
|
} else if (options == INITR_MINI160x80) {
|
|
_height = ST7735_TFTWIDTH_80;
|
|
_width = ST7735_TFTHEIGHT_160;
|
|
displayInit(Rcmd2green160x80);
|
|
_colstart = 24;
|
|
_rowstart = 0;
|
|
} else if (options == INITR_MINI160x80_PLUGIN) {
|
|
_height = ST7735_TFTWIDTH_80;
|
|
_width = ST7735_TFTHEIGHT_160;
|
|
displayInit(Rcmd2green160x80plugin);
|
|
_colstart = 26;
|
|
_rowstart = 1;
|
|
invertOnCommand = ST77XX_INVOFF;
|
|
invertOffCommand = ST77XX_INVON;
|
|
} else {
|
|
// colstart, rowstart left at default '0' values
|
|
displayInit(Rcmd2red);
|
|
}
|
|
displayInit(Rcmd3);
|
|
|
|
// Black tab, change MADCTL color filter
|
|
if ((options == INITR_BLACKTAB) || (options == INITR_MINI160x80)) {
|
|
uint8_t data = 0xC0;
|
|
sendCommand(ST77XX_MADCTL, &data, 1);
|
|
}
|
|
|
|
if (options == INITR_HALLOWING) {
|
|
// Hallowing is simply a 1.44" green tab upside-down:
|
|
tabcolor = INITR_144GREENTAB;
|
|
setRotation(2);
|
|
} else {
|
|
tabcolor = options;
|
|
setRotation(0);
|
|
}
|
|
}
|
|
|
|
// OTHER FUNCTIONS *********************************************************
|
|
|
|
/**************************************************************************/
|
|
/*!
|
|
@brief Set origin of (0,0) and orientation of TFT display
|
|
@param m The index for rotation, from 0-3 inclusive
|
|
*/
|
|
/**************************************************************************/
|
|
void Adafruit_ST7735::setRotation(uint8_t m) {
|
|
uint8_t madctl = 0;
|
|
|
|
rotation = m & 3; // can't be higher than 3
|
|
|
|
// For ST7735 with GREEN TAB (including HalloWing)...
|
|
if ((tabcolor == INITR_144GREENTAB) || (tabcolor == INITR_HALLOWING)) {
|
|
// ..._rowstart is 3 for rotations 0&1, 1 for rotations 2&3
|
|
_rowstart = (rotation < 2) ? 3 : 1;
|
|
}
|
|
|
|
switch (rotation) {
|
|
case 0:
|
|
if ((tabcolor == INITR_BLACKTAB) || (tabcolor == INITR_MINI160x80)) {
|
|
madctl = ST77XX_MADCTL_MX | ST77XX_MADCTL_MY | ST77XX_MADCTL_RGB;
|
|
} else {
|
|
madctl = ST77XX_MADCTL_MX | ST77XX_MADCTL_MY | ST7735_MADCTL_BGR;
|
|
}
|
|
|
|
if (tabcolor == INITR_144GREENTAB) {
|
|
_height = ST7735_TFTHEIGHT_128;
|
|
_width = ST7735_TFTWIDTH_128;
|
|
} else if (tabcolor == INITR_MINI160x80 ||
|
|
tabcolor == INITR_MINI160x80_PLUGIN) {
|
|
_height = ST7735_TFTHEIGHT_160;
|
|
_width = ST7735_TFTWIDTH_80;
|
|
} else {
|
|
_height = ST7735_TFTHEIGHT_160;
|
|
_width = ST7735_TFTWIDTH_128;
|
|
}
|
|
_xstart = _colstart;
|
|
_ystart = _rowstart;
|
|
break;
|
|
case 1:
|
|
if ((tabcolor == INITR_BLACKTAB) || (tabcolor == INITR_MINI160x80)) {
|
|
madctl = ST77XX_MADCTL_MY | ST77XX_MADCTL_MV | ST77XX_MADCTL_RGB;
|
|
} else {
|
|
madctl = ST77XX_MADCTL_MY | ST77XX_MADCTL_MV | ST7735_MADCTL_BGR;
|
|
}
|
|
|
|
if (tabcolor == INITR_144GREENTAB) {
|
|
_width = ST7735_TFTHEIGHT_128;
|
|
_height = ST7735_TFTWIDTH_128;
|
|
} else if (tabcolor == INITR_MINI160x80 ||
|
|
tabcolor == INITR_MINI160x80_PLUGIN) {
|
|
_width = ST7735_TFTHEIGHT_160;
|
|
_height = ST7735_TFTWIDTH_80;
|
|
} else {
|
|
_width = ST7735_TFTHEIGHT_160;
|
|
_height = ST7735_TFTWIDTH_128;
|
|
}
|
|
_ystart = _colstart;
|
|
_xstart = _rowstart;
|
|
break;
|
|
case 2:
|
|
if ((tabcolor == INITR_BLACKTAB) || (tabcolor == INITR_MINI160x80)) {
|
|
madctl = ST77XX_MADCTL_RGB;
|
|
} else {
|
|
madctl = ST7735_MADCTL_BGR;
|
|
}
|
|
|
|
if (tabcolor == INITR_144GREENTAB) {
|
|
_height = ST7735_TFTHEIGHT_128;
|
|
_width = ST7735_TFTWIDTH_128;
|
|
} else if (tabcolor == INITR_MINI160x80 ||
|
|
tabcolor == INITR_MINI160x80_PLUGIN) {
|
|
_height = ST7735_TFTHEIGHT_160;
|
|
_width = ST7735_TFTWIDTH_80;
|
|
} else {
|
|
_height = ST7735_TFTHEIGHT_160;
|
|
_width = ST7735_TFTWIDTH_128;
|
|
}
|
|
_xstart = _colstart;
|
|
_ystart = _rowstart;
|
|
break;
|
|
case 3:
|
|
if ((tabcolor == INITR_BLACKTAB) || (tabcolor == INITR_MINI160x80)) {
|
|
madctl = ST77XX_MADCTL_MX | ST77XX_MADCTL_MV | ST77XX_MADCTL_RGB;
|
|
} else {
|
|
madctl = ST77XX_MADCTL_MX | ST77XX_MADCTL_MV | ST7735_MADCTL_BGR;
|
|
}
|
|
|
|
if (tabcolor == INITR_144GREENTAB) {
|
|
_width = ST7735_TFTHEIGHT_128;
|
|
_height = ST7735_TFTWIDTH_128;
|
|
} else if (tabcolor == INITR_MINI160x80 ||
|
|
tabcolor == INITR_MINI160x80_PLUGIN) {
|
|
_width = ST7735_TFTHEIGHT_160;
|
|
_height = ST7735_TFTWIDTH_80;
|
|
} else {
|
|
_width = ST7735_TFTHEIGHT_160;
|
|
_height = ST7735_TFTWIDTH_128;
|
|
}
|
|
_ystart = _colstart;
|
|
_xstart = _rowstart;
|
|
break;
|
|
}
|
|
|
|
sendCommand(ST77XX_MADCTL, &madctl, 1);
|
|
}
|