Adafruit_ST77xx Class Reference

Subclass of SPITFT for ST77xx displays (lots in common!) More...

#include <Adafruit_ST77xx.h>

Inheritance diagram for Adafruit_ST77xx:

Public Member Functions
	Adafruit_ST77xx (uint16_t w, uint16_t h, int8_t _CS, int8_t _DC, int8_t _MOSI, int8_t _SCLK, int8_t _RST=-1, int8_t _MISO=-1)
	Instantiate Adafruit ST77XX driver with software SPI.
	Adafruit_ST77xx (uint16_t w, uint16_t h, int8_t CS, int8_t RS, int8_t RST=-1)
	Instantiate Adafruit ST77XX driver with hardware SPI.
	Adafruit_ST77xx (uint16_t w, uint16_t h, SPIClass *spiClass, int8_t CS, int8_t RS, int8_t RST=-1)
	Instantiate Adafruit ST77XX driver with selectable hardware SPI.
void	setAddrWindow (uint16_t x, uint16_t y, uint16_t w, uint16_t h)
	SPI displays set an address window rectangle for blitting pixels.
void	setRotation (uint8_t r)
	Set origin of (0,0) and orientation of TFT display.
void	enableDisplay (boolean enable)
	Change whether display is on or off.
void	enableTearing (boolean enable)
	Change whether TE pin output is on or off.
void	enableSleep (boolean enable)
	Change whether sleep mode is on or off.
Public Member Functions inherited from Adafruit_SPITFT
	Adafruit_SPITFT (uint16_t w, uint16_t h, int8_t cs, int8_t dc, int8_t mosi, int8_t sck, int8_t rst=-1, int8_t miso=-1)
	Adafruit_SPITFT constructor for software (bitbang) SPI.
	Adafruit_SPITFT (uint16_t w, uint16_t h, int8_t cs, int8_t dc, int8_t rst=-1)
	Adafruit_SPITFT constructor for hardware SPI using the board's default SPI peripheral.
	Adafruit_SPITFT (uint16_t w, uint16_t h, SPIClass *spiClass, int8_t cs, int8_t dc, int8_t rst=-1)
	Adafruit_SPITFT constructor for hardware SPI using a specific SPI peripheral.
	Adafruit_SPITFT (uint16_t w, uint16_t h, tftBusWidth busWidth, int8_t d0, int8_t wr, int8_t dc, int8_t cs=-1, int8_t rst=-1, int8_t rd=-1)
	Adafruit_SPITFT constructor for parallel display connection.
void	initSPI (uint32_t freq=0, uint8_t spiMode=SPI_MODE0)
	Configure microcontroller pins for TFT interfacing. Typically called by a subclass' begin() function.
void	initSPI (uint32_t freq, uint8_t spiMode, bool reset)
	Configure microcontroller pins for TFT interfacing. Typically called by a subclass' begin() function.
void	setSPISpeed (uint32_t freq)
	Allow changing the SPI clock speed after initialization.
void	startWrite (void)
	Call before issuing command(s) or data to display. Performs chip-select (if required) and starts an SPI transaction (if using hardware SPI and transactions are supported). Required for all display types; not an SPI-specific function.
void	endWrite (void)
	Call after issuing command(s) or data to display. Performs chip-deselect (if required) and ends an SPI transaction (if using hardware SPI and transactions are supported). Required for all display types; not an SPI-specific function.
void	sendCommand (uint8_t commandByte, uint8_t *dataBytes, uint8_t numDataBytes)
	Adafruit_SPITFT Send Command handles complete sending of commands and data.
void	sendCommand (uint8_t commandByte, const uint8_t *dataBytes=NULL, uint8_t numDataBytes=0)
	Adafruit_SPITFT Send Command handles complete sending of commands and data.
void	sendCommand16 (uint16_t commandWord, const uint8_t *dataBytes=NULL, uint8_t numDataBytes=0)
	Adafruit_SPITFT sendCommand16 handles complete sending of commands and data for 16-bit parallel displays. Currently somewhat rigged for the NT35510, which has the odd behavior of wanting commands 16-bit, but subsequent data as 8-bit values, despite the 16-bit bus (high byte is always 0). Also seems to require issuing and incrementing address with each transfer.
uint8_t	readcommand8 (uint8_t commandByte, uint8_t index=0)
	Read 8 bits of data from display configuration memory (not RAM). This is highly undocumented/supported and should be avoided, function is only included because some of the examples use it.
uint16_t	readcommand16 (uint16_t addr)
	Read 16 bits of data from display register. For 16-bit parallel displays only.
void	writePixel (int16_t x, int16_t y, uint16_t color)
	Draw a single pixel to the display at requested coordinates. Not self-contained; should follow a startWrite() call.
void	writePixels (uint16_t *colors, uint32_t len, bool block=true, bool bigEndian=false)
	Issue a series of pixels from memory to the display. Not self- contained; should follow startWrite() and setAddrWindow() calls.
void	writeColor (uint16_t color, uint32_t len)
	Issue a series of pixels, all the same color. Not self- contained; should follow startWrite() and setAddrWindow() calls.
void	writeFillRect (int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color)
	Draw a filled rectangle to the display. Not self-contained; should follow startWrite(). Typically used by higher-level graphics primitives; user code shouldn't need to call this and is likely to use the self-contained fillRect() instead. writeFillRect() performs its own edge clipping and rejection; see writeFillRectPreclipped() for a more 'raw' implementation.
void	writeFastHLine (int16_t x, int16_t y, int16_t w, uint16_t color)
	Draw a horizontal line on the display. Performs edge clipping and rejection. Not self-contained; should follow startWrite(). Typically used by higher-level graphics primitives; user code shouldn't need to call this and is likely to use the self- contained drawFastHLine() instead.
void	writeFastVLine (int16_t x, int16_t y, int16_t h, uint16_t color)
	Draw a vertical line on the display. Performs edge clipping and rejection. Not self-contained; should follow startWrite(). Typically used by higher-level graphics primitives; user code shouldn't need to call this and is likely to use the self- contained drawFastVLine() instead.
void	writeFillRectPreclipped (int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color)
	A lower-level version of writeFillRect(). This version requires all inputs are in-bounds, that width and height are positive, and no part extends offscreen. NO EDGE CLIPPING OR REJECTION IS PERFORMED. If higher-level graphics primitives are written to handle their own clipping earlier in the drawing process, this can avoid unnecessary function calls and repeated clipping operations in the lower-level functions.
void	dmaWait (void)
	Wait for the last DMA transfer in a prior non-blocking writePixels() call to complete. This does nothing if DMA is not enabled, and is not needed if blocking writePixels() was used (as is the default case).
bool	dmaBusy (void) const
	Check if DMA transfer is active. Always returts false if DMA is not enabled.
void	swapBytes (uint16_t *src, uint32_t len, uint16_t *dest=NULL)
	Swap bytes in an array of pixels; converts little-to-big or big-to-little endian. Used by writePixels() below in some situations, but may also be helpful for user code occasionally.
void	drawPixel (int16_t x, int16_t y, uint16_t color)
	Draw a single pixel to the display at requested coordinates. Self-contained and provides its own transaction as needed (see writePixel(x,y,color) for a lower-level variant). Edge clipping is performed here.
void	fillRect (int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color)
	Draw a filled rectangle to the display. Self-contained and provides its own transaction as needed (see writeFillRect() or writeFillRectPreclipped() for lower-level variants). Edge clipping and rejection is performed here.
void	drawFastHLine (int16_t x, int16_t y, int16_t w, uint16_t color)
	Draw a horizontal line on the display. Self-contained and provides its own transaction as needed (see writeFastHLine() for a lower-level variant). Edge clipping and rejection is performed here.
void	drawFastVLine (int16_t x, int16_t y, int16_t h, uint16_t color)
	Draw a vertical line on the display. Self-contained and provides its own transaction as needed (see writeFastHLine() for a lower- level variant). Edge clipping and rejection is performed here.
void	pushColor (uint16_t color)
	Essentially writePixel() with a transaction around it. I don't think this is in use by any of our code anymore (believe it was for some older BMP-reading examples), but is kept here in case any user code relies on it. Consider it DEPRECATED.
void	drawRGBBitmap (int16_t x, int16_t y, uint16_t *pcolors, int16_t w, int16_t h)
	Draw a 16-bit image (565 RGB) at the specified (x,y) position. For 16-bit display devices; no color reduction performed. Adapted from https://github.com/PaulStoffregen/ILI9341_t3 by Marc MERLIN. See examples/pictureEmbed to use this. 5/6/2017: function name and arguments have changed for compatibility with current GFX library and to avoid naming problems in prior implementation. Formerly drawBitmap() with arguments in different order. Handles its own transaction and edge clipping/rejection.
void	invertDisplay (bool i)
	Invert the colors of the display (if supported by hardware). Self-contained, no transaction setup required.
uint16_t	color565 (uint8_t r, uint8_t g, uint8_t b)
	Given 8-bit red, green and blue values, return a 'packed' 16-bit color value in '565' RGB format (5 bits red, 6 bits green, 5 bits blue). This is just a mathematical operation, no hardware is touched.
void	spiWrite (uint8_t b)
	Issue a single 8-bit value to the display. Chip-select, transaction and data/command selection must have been previously set – this ONLY issues the byte. This is another of those functions in the library with a now-not-accurate name that's being maintained for compatibility with outside code. This function is used even if display connection is parallel.
void	writeCommand (uint8_t cmd)
	Write a single command byte to the display. Chip-select and transaction must have been previously set – this ONLY sets the device to COMMAND mode, issues the byte and then restores DATA mode. There is no corresponding explicit writeData() function – just use spiWrite().
uint8_t	spiRead (void)
	Read a single 8-bit value from the display. Chip-select and transaction must have been previously set – this ONLY reads the byte. This is another of those functions in the library with a now-not-accurate name that's being maintained for compatibility with outside code. This function is used even if display connection is parallel.
void	write16 (uint16_t w)
	Issue a single 16-bit value to the display. Chip-select, transaction and data/command selection must have been previously set – this ONLY issues the word. Thus operates ONLY on 'wide' (16-bit) parallel displays!
void	writeCommand16 (uint16_t cmd)
	Write a single command word to the display. Chip-select and transaction must have been previously set – this ONLY sets the device to COMMAND mode, issues the byte and then restores DATA mode. This operates ONLY on 'wide' (16-bit) parallel displays!
uint16_t	read16 (void)
	Read a single 16-bit value from the display. Chip-select and transaction must have been previously set – this ONLY reads the byte. This operates ONLY on 'wide' (16-bit) parallel displays!
void	SPI_WRITE16 (uint16_t w)
	Issue a single 16-bit value to the display. Chip-select, transaction and data/command selection must have been previously set – this ONLY issues the word. Despite the name, this function is used even if display connection is parallel; name was maintaned for backward compatibility. Naming is also not consistent with the 8-bit version, spiWrite(). Sorry about that. Again, staying compatible with outside code.
void	SPI_WRITE32 (uint32_t l)
	Issue a single 32-bit value to the display. Chip-select, transaction and data/command selection must have been previously set – this ONLY issues the longword. Despite the name, this function is used even if display connection is parallel; name was maintaned for backward compatibility. Naming is also not consistent with the 8-bit version, spiWrite(). Sorry about that. Again, staying compatible with outside code.
void	SPI_CS_HIGH (void)
	Set the chip-select line HIGH. Does NOT check whether CS pin is set (>=0), that should be handled in calling function. Despite function name, this is used even if the display connection is parallel.
void	SPI_CS_LOW (void)
	Set the chip-select line LOW. Does NOT check whether CS pin is set (>=0), that should be handled in calling function. Despite function name, this is used even if the display connection is parallel.
void	SPI_DC_HIGH (void)
	Set the data/command line HIGH (data mode).
void	SPI_DC_LOW (void)
	Set the data/command line LOW (command mode).
void	drawRGBBitmap (int16_t x, int16_t y, const uint16_t bitmap[], int16_t w, int16_t h)
	Draw a PROGMEM-resident 16-bit image (RGB 5/6/5) at the specified (x,y) position. For 16-bit display devices; no color reduction performed.
void	drawRGBBitmap (int16_t x, int16_t y, const uint16_t bitmap[], const uint8_t mask[], int16_t w, int16_t h)
	Draw a PROGMEM-resident 16-bit image (RGB 5/6/5) with a 1-bit mask (set bits = opaque, unset bits = clear) at the specified (x,y) position. BOTH buffers (color and mask) must be PROGMEM-resident. For 16-bit display devices; no color reduction performed.
void	drawRGBBitmap (int16_t x, int16_t y, uint16_t *bitmap, uint8_t *mask, int16_t w, int16_t h)
	Draw a RAM-resident 16-bit image (RGB 5/6/5) with a 1-bit mask (set bits = opaque, unset bits = clear) at the specified (x,y) position. BOTH buffers (color and mask) must be RAM-resident. For 16-bit display devices; no color reduction performed.
Public Member Functions inherited from Adafruit_GFX
	Adafruit_GFX (int16_t w, int16_t h)
	Instatiate a GFX context for graphics! Can only be done by a superclass.
virtual void	writeLine (int16_t x0, int16_t y0, int16_t x1, int16_t y1, uint16_t color)
	Write a line. Bresenham's algorithm - thx wikpedia.
virtual void	fillScreen (uint16_t color)
	Fill the screen completely with one color. Update in subclasses if desired!
virtual void	drawLine (int16_t x0, int16_t y0, int16_t x1, int16_t y1, uint16_t color)
	Draw a line.
virtual void	drawRect (int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color)
	Draw a rectangle with no fill color.
void	drawCircle (int16_t x0, int16_t y0, int16_t r, uint16_t color)
	Draw a circle outline.
void	drawCircleHelper (int16_t x0, int16_t y0, int16_t r, uint8_t cornername, uint16_t color)
	Quarter-circle drawer, used to do circles and roundrects.
void	fillCircle (int16_t x0, int16_t y0, int16_t r, uint16_t color)
	Draw a circle with filled color.
void	fillCircleHelper (int16_t x0, int16_t y0, int16_t r, uint8_t cornername, int16_t delta, uint16_t color)
	Quarter-circle drawer with fill, used for circles and roundrects.
void	drawTriangle (int16_t x0, int16_t y0, int16_t x1, int16_t y1, int16_t x2, int16_t y2, uint16_t color)
	Draw a triangle with no fill color.
void	fillTriangle (int16_t x0, int16_t y0, int16_t x1, int16_t y1, int16_t x2, int16_t y2, uint16_t color)
	Draw a triangle with color-fill.
void	drawRoundRect (int16_t x0, int16_t y0, int16_t w, int16_t h, int16_t radius, uint16_t color)
	Draw a rounded rectangle with no fill color.
void	fillRoundRect (int16_t x0, int16_t y0, int16_t w, int16_t h, int16_t radius, uint16_t color)
	Draw a rounded rectangle with fill color.
void	drawBitmap (int16_t x, int16_t y, const uint8_t bitmap[], int16_t w, int16_t h, uint16_t color)
	Draw a PROGMEM-resident 1-bit image at the specified (x,y) position, using the specified foreground color (unset bits are transparent).
void	drawBitmap (int16_t x, int16_t y, const uint8_t bitmap[], int16_t w, int16_t h, uint16_t color, uint16_t bg)
	Draw a PROGMEM-resident 1-bit image at the specified (x,y) position, using the specified foreground (for set bits) and background (unset bits) colors.
void	drawBitmap (int16_t x, int16_t y, uint8_t *bitmap, int16_t w, int16_t h, uint16_t color)
	Draw a RAM-resident 1-bit image at the specified (x,y) position, using the specified foreground color (unset bits are transparent).
void	drawBitmap (int16_t x, int16_t y, uint8_t *bitmap, int16_t w, int16_t h, uint16_t color, uint16_t bg)
	Draw a RAM-resident 1-bit image at the specified (x,y) position, using the specified foreground (for set bits) and background (unset bits) colors.
void	drawXBitmap (int16_t x, int16_t y, const uint8_t bitmap[], int16_t w, int16_t h, uint16_t color)
	Draw PROGMEM-resident XBitMap Files (*.xbm), exported from GIMP. Usage: Export from GIMP to *.xbm, rename *.xbm to *.c and open in editor. C Array can be directly used with this function. There is no RAM-resident version of this function; if generating bitmaps in RAM, use the format defined by drawBitmap() and call that instead.
void	drawGrayscaleBitmap (int16_t x, int16_t y, const uint8_t bitmap[], int16_t w, int16_t h)
	Draw a PROGMEM-resident 8-bit image (grayscale) at the specified (x,y) pos. Specifically for 8-bit display devices such as IS31FL3731; no color reduction/expansion is performed.
void	drawGrayscaleBitmap (int16_t x, int16_t y, uint8_t *bitmap, int16_t w, int16_t h)
	Draw a RAM-resident 8-bit image (grayscale) at the specified (x,y) pos. Specifically for 8-bit display devices such as IS31FL3731; no color reduction/expansion is performed.
void	drawGrayscaleBitmap (int16_t x, int16_t y, const uint8_t bitmap[], const uint8_t mask[], int16_t w, int16_t h)
	Draw a PROGMEM-resident 8-bit image (grayscale) with a 1-bit mask (set bits = opaque, unset bits = clear) at the specified (x,y) position. BOTH buffers (grayscale and mask) must be PROGMEM-resident. Specifically for 8-bit display devices such as IS31FL3731; no color reduction/expansion is performed.
void	drawGrayscaleBitmap (int16_t x, int16_t y, uint8_t *bitmap, uint8_t *mask, int16_t w, int16_t h)
	Draw a RAM-resident 8-bit image (grayscale) with a 1-bit mask (set bits = opaque, unset bits = clear) at the specified (x,y) position. BOTH buffers (grayscale and mask) must be RAM-residentt, no mix-and-match Specifically for 8-bit display devices such as IS31FL3731; no color reduction/expansion is performed.
void	drawRGBBitmap (int16_t x, int16_t y, const uint16_t bitmap[], int16_t w, int16_t h)
	Draw a PROGMEM-resident 16-bit image (RGB 5/6/5) at the specified (x,y) position. For 16-bit display devices; no color reduction performed.
void	drawRGBBitmap (int16_t x, int16_t y, uint16_t *bitmap, int16_t w, int16_t h)
	Draw a RAM-resident 16-bit image (RGB 5/6/5) at the specified (x,y) position. For 16-bit display devices; no color reduction performed.
void	drawRGBBitmap (int16_t x, int16_t y, const uint16_t bitmap[], const uint8_t mask[], int16_t w, int16_t h)
	Draw a PROGMEM-resident 16-bit image (RGB 5/6/5) with a 1-bit mask (set bits = opaque, unset bits = clear) at the specified (x,y) position. BOTH buffers (color and mask) must be PROGMEM-resident. For 16-bit display devices; no color reduction performed.
void	drawRGBBitmap (int16_t x, int16_t y, uint16_t *bitmap, uint8_t *mask, int16_t w, int16_t h)
	Draw a RAM-resident 16-bit image (RGB 5/6/5) with a 1-bit mask (set bits = opaque, unset bits = clear) at the specified (x,y) position. BOTH buffers (color and mask) must be RAM-resident. For 16-bit display devices; no color reduction performed.
void	drawChar (int16_t x, int16_t y, unsigned char c, uint16_t color, uint16_t bg, uint8_t size)
	Draw a single character.
void	drawChar (int16_t x, int16_t y, unsigned char c, uint16_t color, uint16_t bg, uint8_t size_x, uint8_t size_y)
	Draw a single character.
void	getTextBounds (const char *string, int16_t x, int16_t y, int16_t *x1, int16_t *y1, uint16_t *w, uint16_t *h)
	Helper to determine size of a string with current font/size. Pass string and a cursor position, returns UL corner and W,H.
void	getTextBounds (const __FlashStringHelper *s, int16_t x, int16_t y, int16_t *x1, int16_t *y1, uint16_t *w, uint16_t *h)
	Helper to determine size of a PROGMEM string with current font/size. Pass string and a cursor position, returns UL corner and W,H.
void	getTextBounds (const String &str, int16_t x, int16_t y, int16_t *x1, int16_t *y1, uint16_t *w, uint16_t *h)
	Helper to determine size of a string with current font/size. Pass string and a cursor position, returns UL corner and W,H.
void	setTextSize (uint8_t s)
	Set text 'magnification' size. Each increase in s makes 1 pixel that much bigger.
void	setTextSize (uint8_t sx, uint8_t sy)
	Set text 'magnification' size. Each increase in s makes 1 pixel that much bigger.
void	setFont (const GFXfont *f=NULL)
	Set the font to display when print()ing, either custom or default.
void	setCursor (int16_t x, int16_t y)
	Set text cursor location.
void	setTextColor (uint16_t c)
	Set text font color with transparant background.
void	setTextColor (uint16_t c, uint16_t bg)
	Set text font color with custom background color.
void	setTextWrap (bool w)
	Set whether text that is too long for the screen width should automatically wrap around to the next line (else clip right).
void	cp437 (bool x=true)
	Enable (or disable) Code Page 437-compatible charset. There was an error in glcdfont.c for the longest time – one character (#176, the 'light shade' block) was missing – this threw off the index of every character that followed it. But a TON of code has been written with the erroneous character indices. By default, the library uses the original 'wrong' behavior and old sketches will still work. Pass 'true' to this function to use correct CP437 character values in your code.
virtual void	write (uint8_t)
	Print one byte/character of data, used to support print()
int16_t	width (void) const
	Get width of the display, accounting for current rotation.
int16_t	height (void) const
	Get height of the display, accounting for current rotation.
uint8_t	getRotation (void) const
	Get rotation setting for display.
int16_t	getCursorX (void) const
	Get text cursor X location.
int16_t	getCursorY (void) const
	Get text cursor Y location.
size_t	write (const char *str)
virtual size_t	write (const uint8_t *buffer, size_t size)
size_t	write (const char *buffer, size_t size)
Public Member Functions inherited from Print
int	getWriteError ()
void	clearWriteError ()
size_t	write (const char *str)
size_t	write (const char *buffer, size_t size)
virtual int	availableForWrite ()
size_t	print (const __FlashStringHelper *)
size_t	print (const String &)
size_t	print (const char[])
size_t	print (char)
size_t	print (unsigned char, int=DEC)
size_t	print (int, int=DEC)
size_t	print (unsigned int, int=DEC)
size_t	print (long, int=DEC)
size_t	print (unsigned long, int=DEC)
size_t	print (long long, int=DEC)
size_t	print (unsigned long long, int=DEC)
size_t	print (float, int=2)
size_t	print (double, int=2)
size_t	print (const Printable &)
size_t	println (const __FlashStringHelper *)
size_t	println (const String &s)
size_t	println (const char[])
size_t	println (char)
size_t	println (unsigned char, int=DEC)
size_t	println (int, int=DEC)
size_t	println (unsigned int, int=DEC)
size_t	println (long, int=DEC)
size_t	println (unsigned long, int=DEC)
size_t	println (long long, int=DEC)
size_t	println (unsigned long long, int=DEC)
size_t	println (float, int=2)
size_t	println (double, int=2)
size_t	println (const Printable &)
size_t	println (void)
int	printf (const char *format,...)
int	printf (const __FlashStringHelper *format,...)
int	vprintf (const __FlashStringHelper *format, va_list ap)
int	vprintf (const char *format, va_list ap)
virtual void	flush ()

Protected Member Functions
void	begin (uint32_t freq=0)
	Initialize ST77xx chip. Connects to the ST77XX over SPI and sends initialization procedure commands.
void	begin (uint32_t freq, bool reset)
	Initialize ST77xx chip. Connects to the ST77XX over SPI and sends initialization procedure commands.
void	commonInit (const uint8_t *cmdList)
	Initialization code common to all ST77XX displays.
void	displayInit (const uint8_t *addr)
	Companion code to the initiliazation tables. Reads and issues a series of LCD commands stored in PROGMEM byte array.
void	setColRowStart (int8_t col, int8_t row)
	Set origin of (0,0) of display with offsets.
Protected Member Functions inherited from Adafruit_SPITFT
void	SPI_MOSI_HIGH (void)
	Set the software (bitbang) SPI MOSI line HIGH.
void	SPI_MOSI_LOW (void)
	Set the software (bitbang) SPI MOSI line LOW.
void	SPI_SCK_HIGH (void)
	Set the software (bitbang) SPI SCK line HIGH.
void	SPI_SCK_LOW (void)
	Set the software (bitbang) SPI SCK line LOW.
bool	SPI_MISO_READ (void)
	Read the state of the software (bitbang) SPI MISO line.
void	SPI_BEGIN_TRANSACTION (void)
	Start an SPI transaction if using the hardware SPI interface to the display. If using an earlier version of the Arduino platform (before the addition of SPI transactions), this instead attempts to set up the SPI clock and mode. No action is taken if the connection is not hardware SPI-based. This does NOT include a chip-select operation – see startWrite() for a function that encapsulated both actions.
void	SPI_END_TRANSACTION (void)
	End an SPI transaction if using the hardware SPI interface to the display. No action is taken if the connection is not hardware SPI-based or if using an earlier version of the Arduino platform (before the addition of SPI transactions). This does NOT include a chip-deselect operation – see endWrite() for a function that encapsulated both actions.
void	TFT_WR_STROBE (void)
	Set the WR line LOW, then HIGH. Used for parallel-connected interfaces when writing data.
void	TFT_RD_HIGH (void)
	Set the RD line HIGH. Used for parallel-connected interfaces when reading data.
void	TFT_RD_LOW (void)
	Set the RD line LOW. Used for parallel-connected interfaces when reading data.
Protected Member Functions inherited from Adafruit_GFX
void	charBounds (unsigned char c, int16_t *x, int16_t *y, int16_t *minx, int16_t *miny, int16_t *maxx, int16_t *maxy)
	Helper to determine size of a character with current font/size. Broke this out as it's used by both the PROGMEM- and RAM-resident getTextBounds() functions.
Protected Member Functions inherited from Print
void	setWriteError (int err=1)

Protected Attributes
uint8_t	_colstart = 0
	Some displays need this changed to offset.
uint8_t	_rowstart = 0
	Some displays need this changed to offset.
uint8_t	spiMode = SPI_MODE0
	Certain display needs MODE3 instead.
Protected Attributes inherited from Adafruit_SPITFT
struct {
SPIClass *   _spi
	SPI class pointer.
uint32_t   _freq
	SPI bitrate (if no SPI transactions)
uint32_t   _mode
	SPI data mode (transactions or no)
}	hwspi
	Hardware SPI values.
struct {
int8_t   _mosi
	MOSI pin #.
int8_t   _miso
	MISO pin #.
int8_t   _sck
	SCK pin #.
}	swspi
	Software SPI values.
struct {
int8_t   _d0
	Data pin 0 #.
int8_t   _wr
	Write strobe pin #.
int8_t   _rd
	Read strobe pin # (or -1)
bool   wide = 0
	If true, is 16-bit interface.
}	tft8
	Parallel interface settings.
uint8_t	connection
	TFT_HARD_SPI, TFT_SOFT_SPI, etc.
int8_t	_rst
	Reset pin # (or -1)
int8_t	_cs
	Chip select pin # (or -1)
int8_t	_dc
	Data/command pin #.
int16_t	_xstart = 0
	Internal framebuffer X offset.
int16_t	_ystart = 0
	Internal framebuffer Y offset.
uint8_t	invertOnCommand = 0
	Command to enable invert mode.
uint8_t	invertOffCommand = 0
	Command to disable invert mode.
Protected Attributes inherited from Adafruit_GFX
int16_t	WIDTH
	This is the 'raw' display width - never changes.
int16_t	HEIGHT
	This is the 'raw' display height - never changes.
int16_t	_width
	Display width as modified by current rotation.
int16_t	_height
	Display height as modified by current rotation.
int16_t	cursor_x
	x location to start print()ing text
int16_t	cursor_y
	y location to start print()ing text
uint16_t	textcolor
	16-bit background color for print()
uint16_t	textbgcolor
	16-bit text color for print()
uint8_t	textsize_x
	Desired magnification in X-axis of text to print()
uint8_t	textsize_y
	Desired magnification in Y-axis of text to print()
uint8_t	rotation
	Display rotation (0 thru 3)
bool	wrap
	If set, 'wrap' text at right edge of display.
bool	_cp437
	If set, use correct CP437 charset (default is off)
GFXfont *	gfxFont
	Pointer to special font.

Detailed Description

Subclass of SPITFT for ST77xx displays (lots in common!)

Constructor & Destructor Documentation

Adafruit_ST77xx() [1/3]

Adafruit_ST77xx::Adafruit_ST77xx	(	uint16_t	w,
		uint16_t	h,
		int8_t	cs,
		int8_t	dc,
		int8_t	mosi,
		int8_t	sclk,
		int8_t	rst = -1,
		int8_t	miso = -1 )

Instantiate Adafruit ST77XX driver with software SPI.

Parameters

w	Display width in pixels at default rotation setting (0)
h	Display height in pixels at default rotation setting (0)
cs	Chip select pin #
dc	Data/Command pin #
mosi	SPI MOSI pin #
sclk	SPI Clock pin #
rst	Reset pin # (optional, pass -1 if unused)
miso	SPI MISO pin # (optional, pass -1 if unused)

Adafruit_ST77xx() [2/3]

Adafruit_ST77xx::Adafruit_ST77xx	(	uint16_t	w,
		uint16_t	h,
		int8_t	cs,
		int8_t	dc,
		int8_t	rst = -1 )

Instantiate Adafruit ST77XX driver with hardware SPI.

Parameters

w	Display width in pixels at default rotation setting (0)
h	Display height in pixels at default rotation setting (0)
cs	Chip select pin #
dc	Data/Command pin #
rst	Reset pin # (optional, pass -1 if unused)

Adafruit_ST77xx() [3/3]

Adafruit_ST77xx::Adafruit_ST77xx	(	uint16_t	w,
		uint16_t	h,
		SPIClass *	spiClass,
		int8_t	cs,
		int8_t	dc,
		int8_t	rst = -1 )

Instantiate Adafruit ST77XX driver with selectable hardware SPI.

Parameters

w	Display width in pixels at default rotation setting (0)
h	Display height in pixels at default rotation setting (0)
spiClass	A pointer to an SPI device to use (e.g. &SPI1)
cs	Chip select pin #
dc	Data/Command pin #
rst	Reset pin # (optional, pass -1 if unused)

Member Function Documentation

begin() [1/2]

void Adafruit_ST77xx::begin ( uint32_t freq, bool reset )

protected

Initialize ST77xx chip. Connects to the ST77XX over SPI and sends initialization procedure commands.

Parameters

freq	Desired SPI clock frequency
reset	Whether or not to reset the hardware monitor

begin() [2/2]

void Adafruit_ST77xx::begin ( uint32_t freq = 0 )

protectedvirtual

Initialize ST77xx chip. Connects to the ST77XX over SPI and sends initialization procedure commands.

Parameters

freq	Desired SPI clock frequency

Implements Adafruit_SPITFT.

commonInit()

void Adafruit_ST77xx::commonInit ( const uint8_t * cmdList )

protected

Initialization code common to all ST77XX displays.

Parameters

cmdList

Flash memory array with commands and data to send

displayInit()

void Adafruit_ST77xx::displayInit ( const uint8_t * addr )

protected

Companion code to the initiliazation tables. Reads and issues a series of LCD commands stored in PROGMEM byte array.

Parameters

addr	Flash memory array with commands and data to send

enableDisplay()

void Adafruit_ST77xx::enableDisplay

(

boolean

enable

)

Change whether display is on or off.

Parameters

enable

True if you want the display ON, false OFF

enableSleep()

void Adafruit_ST77xx::enableSleep

(

boolean

enable

)

Change whether sleep mode is on or off.

Parameters

enable

True if you want sleep mode ON, false OFF

enableTearing()

void Adafruit_ST77xx::enableTearing

(

boolean

enable

)

Change whether TE pin output is on or off.

Parameters

enable

True if you want the TE pin ON, false OFF

setAddrWindow()

void Adafruit_ST77xx::setAddrWindow ( uint16_t x, uint16_t y, uint16_t w, uint16_t h )

virtual

SPI displays set an address window rectangle for blitting pixels.

Parameters

x	Top left corner x coordinate
y	Top left corner x coordinate
w	Width of window
h	Height of window

Implements Adafruit_SPITFT.

setColRowStart()

void Adafruit_ST77xx::setColRowStart ( int8_t col, int8_t row )

protected

Set origin of (0,0) of display with offsets.

Parameters

col	The offset from 0 for the column address
row	The offset from 0 for the row address

setRotation()

void Adafruit_ST77xx::setRotation ( uint8_t m )

virtual

Set origin of (0,0) and orientation of TFT display.

Parameters

m	The index for rotation, from 0-3 inclusive

Reimplemented from Adafruit_GFX.

---

The documentation for this class was generated from the following files:

• Monitor/src/Adafruit_ST7735_and_ST7789_Library/Adafruit_ST77xx.h
• Monitor/src/Adafruit_ST7735_and_ST7789_Library/Adafruit_ST77xx.cpp