GxEPD2_290c Class Reference

#include <GxEPD2_290c.h>

Inheritance diagram for GxEPD2_290c:

Public Member Functions
	GxEPD2_290c (int16_t cs, int16_t dc, int16_t rst, int16_t busy)
void	clearScreen (uint8_t value=0xFF)
void	clearScreen (uint8_t black_value, uint8_t color_value)
void	writeScreenBuffer (uint8_t value=0xFF)
void	writeScreenBuffer (uint8_t black_value, uint8_t color_value)
void	writeImage (const uint8_t bitmap[], int16_t x, int16_t y, int16_t w, int16_t h, bool invert=false, bool mirror_y=false, bool pgm=false)
void	writeImagePart (const uint8_t bitmap[], int16_t x_part, int16_t y_part, int16_t w_bitmap, int16_t h_bitmap, int16_t x, int16_t y, int16_t w, int16_t h, bool invert=false, bool mirror_y=false, bool pgm=false)
void	writeImage (const uint8_t *black, const uint8_t *color, int16_t x, int16_t y, int16_t w, int16_t h, bool invert=false, bool mirror_y=false, bool pgm=false)
void	writeImagePart (const uint8_t *black, const uint8_t *color, int16_t x_part, int16_t y_part, int16_t w_bitmap, int16_t h_bitmap, int16_t x, int16_t y, int16_t w, int16_t h, bool invert=false, bool mirror_y=false, bool pgm=false)
void	writeNative (const uint8_t *data1, const uint8_t *data2, int16_t x, int16_t y, int16_t w, int16_t h, bool invert=false, bool mirror_y=false, bool pgm=false)
void	drawImage (const uint8_t bitmap[], int16_t x, int16_t y, int16_t w, int16_t h, bool invert=false, bool mirror_y=false, bool pgm=false)
void	drawImagePart (const uint8_t bitmap[], int16_t x_part, int16_t y_part, int16_t w_bitmap, int16_t h_bitmap, int16_t x, int16_t y, int16_t w, int16_t h, bool invert=false, bool mirror_y=false, bool pgm=false)
void	drawImage (const uint8_t *black, const uint8_t *color, int16_t x, int16_t y, int16_t w, int16_t h, bool invert=false, bool mirror_y=false, bool pgm=false)
void	drawImagePart (const uint8_t *black, const uint8_t *color, int16_t x_part, int16_t y_part, int16_t w_bitmap, int16_t h_bitmap, int16_t x, int16_t y, int16_t w, int16_t h, bool invert=false, bool mirror_y=false, bool pgm=false)
void	drawNative (const uint8_t *data1, const uint8_t *data2, int16_t x, int16_t y, int16_t w, int16_t h, bool invert=false, bool mirror_y=false, bool pgm=false)
void	refresh (bool partial_update_mode=false)
void	refresh (int16_t x, int16_t y, int16_t w, int16_t h)
void	powerOff ()
void	hibernate ()
Public Member Functions inherited from GxEPD2_EPD
	GxEPD2_EPD (int16_t cs, int16_t dc, int16_t rst, int16_t busy, int16_t busy_level, uint32_t busy_timeout, uint16_t w, uint16_t h, GxEPD2::Panel p, bool c, bool pu, bool fpu)
virtual void	init (uint32_t serial_diag_bitrate=0)
virtual void	init (uint32_t serial_diag_bitrate, bool initial, uint16_t reset_duration=10, bool pulldown_rst_mode=false)
virtual void	writeImageForFullRefresh (const uint8_t bitmap[], int16_t x, int16_t y, int16_t w, int16_t h, bool invert=false, bool mirror_y=false, bool pgm=false)
virtual void	writeScreenBufferAgain (uint8_t value=0xFF)
virtual void	writeImageAgain (const uint8_t bitmap[], int16_t x, int16_t y, int16_t w, int16_t h, bool invert=false, bool mirror_y=false, bool pgm=false)
virtual void	writeImagePartAgain (const uint8_t bitmap[], int16_t x_part, int16_t y_part, int16_t w_bitmap, int16_t h_bitmap, int16_t x, int16_t y, int16_t w, int16_t h, bool invert=false, bool mirror_y=false, bool pgm=false)
virtual void	setPaged ()
void	setBusyCallback (void(*busyCallback)(const void *), const void *busy_callback_parameter=0)
void	selectSPI (SPIClass &spi, SPISettings spi_settings)

Static Public Attributes
static const uint16_t	WIDTH = 128
static const uint16_t	WIDTH_VISIBLE = WIDTH
static const uint16_t	HEIGHT = 296
static const GxEPD2::Panel	panel = GxEPD2::GDEW029Z10
static const bool	hasColor = true
static const bool	hasPartialUpdate = true
static const bool	usePartialUpdateWindow = true
static const bool	hasFastPartialUpdate = false
static const uint16_t	power_on_time = 40
static const uint16_t	power_off_time = 30
static const uint16_t	full_refresh_time = 15000
static const uint16_t	partial_refresh_time = 15000

Additional Inherited Members
Static Public Member Functions inherited from GxEPD2_EPD
static uint16_t	gx_uint16_min (uint16_t a, uint16_t b)
static uint16_t	gx_uint16_max (uint16_t a, uint16_t b)
Public Attributes inherited from GxEPD2_EPD
const uint16_t	WIDTH
const uint16_t	HEIGHT
const GxEPD2::Panel	panel
const bool	hasColor
const bool	hasPartialUpdate
const bool	hasFastPartialUpdate
Protected Member Functions inherited from GxEPD2_EPD
void	_reset ()
void	_waitWhileBusy (const char *comment=0, uint16_t busy_time=5000)
void	_writeCommand (uint8_t c)
void	_writeData (uint8_t d)
void	_writeData (const uint8_t *data, uint16_t n)
void	_writeDataPGM (const uint8_t *data, uint16_t n, int16_t fill_with_zeroes=0)
void	_writeDataPGM_sCS (const uint8_t *data, uint16_t n, int16_t fill_with_zeroes=0)
void	_writeCommandData (const uint8_t *pCommandData, uint8_t datalen)
void	_writeCommandDataPGM (const uint8_t *pCommandData, uint8_t datalen)
void	_startTransfer ()
void	_transfer (uint8_t value)
void	_endTransfer ()
Protected Attributes inherited from GxEPD2_EPD
int16_t	_cs
int16_t	_dc
int16_t	_rst
int16_t	_busy
int16_t	_busy_level
uint32_t	_busy_timeout
bool	_diag_enabled
bool	_pulldown_rst_mode
SPIClass *	_pSPIx
SPISettings	_spi_settings
bool	_initial_write
bool	_initial_refresh
bool	_power_is_on
bool	_using_partial_mode
bool	_hibernating
uint16_t	_reset_duration
void(*	_busy_callback )(const void *)
const void *	_busy_callback_parameter

Detailed Description

Definition at line 18 of file GxEPD2_290c.h.

Constructor & Destructor Documentation

GxEPD2_290c()

GxEPD2_290c::GxEPD2_290c	(	int16_t	cs,
		int16_t	dc,
		int16_t	rst,
		int16_t	busy )

Definition at line 15 of file GxEPD2_290c.cpp.

                                                                          :
  GxEPD2_EPD(cs, dc, rst, busy, LOW, 20000000, WIDTH, HEIGHT, panel, hasColor, hasPartialUpdate, hasFastPartialUpdate)
{
}

Member Function Documentation

clearScreen() [1/2]

void GxEPD2_290c::clearScreen	(	uint8_t	black_value,
		uint8_t	color_value )

Definition at line 25 of file GxEPD2_290c.cpp.

{
  _initial_write = false; // initial full screen buffer clean done
  _Init_Part();
  _writeCommand(0x91); // partial in
  _setPartialRamArea(0, 0, WIDTH, HEIGHT);
  _writeCommand(0x10);
  for (uint32_t i = 0; i < uint32_t(WIDTH) * uint32_t(HEIGHT) / 8; i++)
  {
    _writeData(black_value);
  }
  _writeCommand(0x13);
  for (uint32_t i = 0; i < uint32_t(WIDTH) * uint32_t(HEIGHT) / 8; i++)
  {
    _writeData(color_value);
  }
  _Update_Part();
  _writeCommand(0x92); // partial out
}

clearScreen() [2/2]

void GxEPD2_290c::clearScreen ( uint8_t value = 0xFF )

virtual

Implements GxEPD2_EPD.

Definition at line 20 of file GxEPD2_290c.cpp.

{
  clearScreen(value, 0xFF);
}

drawImage() [1/2]

void GxEPD2_290c::drawImage	(	const uint8_t *	black,
		const uint8_t *	color,
		int16_t	x,
		int16_t	y,
		int16_t	w,
		int16_t	h,
		bool	invert = false,
		bool	mirror_y = false,
		bool	pgm = false )

Definition at line 259 of file GxEPD2_290c.cpp.

{
  writeImage(black, color, x, y, w, h, invert, mirror_y, pgm);
  refresh(x, y, w, h);
}

drawImage() [2/2]

void GxEPD2_290c::drawImage	(	const uint8_t	bitmap[],
		int16_t	x,
		int16_t	y,
		int16_t	w,
		int16_t	h,
		bool	invert = false,
		bool	mirror_y = false,
		bool	pgm = false )

Definition at line 246 of file GxEPD2_290c.cpp.

{
  writeImage(bitmap, x, y, w, h, invert, mirror_y, pgm);
  refresh(x, y, w, h);
}

drawImagePart() [1/2]

void GxEPD2_290c::drawImagePart	(	const uint8_t *	black,
		const uint8_t *	color,
		int16_t	x_part,
		int16_t	y_part,
		int16_t	w_bitmap,
		int16_t	h_bitmap,
		int16_t	x,
		int16_t	y,
		int16_t	w,
		int16_t	h,
		bool	invert = false,
		bool	mirror_y = false,
		bool	pgm = false )

Definition at line 265 of file GxEPD2_290c.cpp.

{
  writeImagePart(black, color, x_part, y_part, w_bitmap, h_bitmap, x, y, w, h, invert, mirror_y, pgm);
  refresh(x, y, w, h);
}

drawImagePart() [2/2]

void GxEPD2_290c::drawImagePart	(	const uint8_t	bitmap[],
		int16_t	x_part,
		int16_t	y_part,
		int16_t	w_bitmap,
		int16_t	h_bitmap,
		int16_t	x,
		int16_t	y,
		int16_t	w,
		int16_t	h,
		bool	invert = false,
		bool	mirror_y = false,
		bool	pgm = false )

Definition at line 252 of file GxEPD2_290c.cpp.

{
  writeImagePart(bitmap, x_part, y_part, w_bitmap, h_bitmap, x, y, w, h, invert, mirror_y, pgm);
  refresh(x, y, w, h);
}

drawNative()

void GxEPD2_290c::drawNative	(	const uint8_t *	data1,
		const uint8_t *	data2,
		int16_t	x,
		int16_t	y,
		int16_t	w,
		int16_t	h,
		bool	invert = false,
		bool	mirror_y = false,
		bool	pgm = false )

Definition at line 272 of file GxEPD2_290c.cpp.

{
  writeNative(data1, data2, x, y, w, h, invert, mirror_y, pgm);
  refresh(x, y, w, h);
}

hibernate()

void GxEPD2_290c::hibernate ( )

virtual

Implements GxEPD2_EPD.

Definition at line 310 of file GxEPD2_290c.cpp.

{
  _PowerOff();
  if (_rst >= 0)
  {
    _writeCommand(0x07); // deep sleep
    _writeData(0xA5);    // check code
    _hibernating = true;
  }
}

powerOff()

void GxEPD2_290c::powerOff ( void )

virtual

Implements GxEPD2_EPD.

Definition at line 305 of file GxEPD2_290c.cpp.

{
  _PowerOff();
}

refresh() [1/2]

void GxEPD2_290c::refresh ( bool partial_update_mode = false )

virtual

Implements GxEPD2_EPD.

Definition at line 278 of file GxEPD2_290c.cpp.

{
  if (partial_update_mode) refresh(0, 0, WIDTH, HEIGHT);
  else _Update_Full();
}

refresh() [2/2]

void GxEPD2_290c::refresh ( int16_t x, int16_t y, int16_t w, int16_t h )

virtual

Implements GxEPD2_EPD.

Definition at line 284 of file GxEPD2_290c.cpp.

{
  // intersection with screen
  int16_t w1 = x < 0 ? w + x : w; // reduce
  int16_t h1 = y < 0 ? h + y : h; // reduce
  int16_t x1 = x < 0 ? 0 : x; // limit
  int16_t y1 = y < 0 ? 0 : y; // limit
  w1 = x1 + w1 < int16_t(WIDTH) ? w1 : int16_t(WIDTH) - x1; // limit
  h1 = y1 + h1 < int16_t(HEIGHT) ? h1 : int16_t(HEIGHT) - y1; // limit
  if ((w1 <= 0) || (h1 <= 0)) return; 
  // make x1, w1 multiple of 8
  w1 += x1 % 8;
  if (w1 % 8 > 0) w1 += 8 - w1 % 8;
  x1 -= x1 % 8;
  _Init_Part();
  if (usePartialUpdateWindow) _writeCommand(0x91); // partial in
  _setPartialRamArea(x1, y1, w1, h1);
  _Update_Part();
  if (usePartialUpdateWindow) _writeCommand(0x92); // partial out
}

writeImage() [1/2]

void GxEPD2_290c::writeImage	(	const uint8_t *	black,
		const uint8_t *	color,
		int16_t	x,
		int16_t	y,
		int16_t	w,
		int16_t	h,
		bool	invert = false,
		bool	mirror_y = false,
		bool	pgm = false )

Definition at line 74 of file GxEPD2_290c.cpp.

{
  if (_initial_write) writeScreenBuffer(); // initial full screen buffer clean
  delay(1); // yield() to avoid WDT on ESP8266 and ESP32
  int16_t wb = (w + 7) / 8; // width bytes, bitmaps are padded
  x -= x % 8; // byte boundary
  w = wb * 8; // byte boundary
  int16_t x1 = x < 0 ? 0 : x; // limit
  int16_t y1 = y < 0 ? 0 : y; // limit
  int16_t w1 = x + w < int16_t(WIDTH) ? w : int16_t(WIDTH) - x; // limit
  int16_t h1 = y + h < int16_t(HEIGHT) ? h : int16_t(HEIGHT) - y; // limit
  int16_t dx = x1 - x;
  int16_t dy = y1 - y;
  w1 -= dx;
  h1 -= dy;
  if ((w1 <= 0) || (h1 <= 0)) return;
  _Init_Part();
  _writeCommand(0x91); // partial in
  _setPartialRamArea(x1, y1, w1, h1);
  _writeCommand(0x10);
  for (int16_t i = 0; i < h1; i++)
  {
    for (int16_t j = 0; j < w1 / 8; j++)
    {
      uint8_t data = 0xFF;
      if (black)
      {
        // use wb, h of bitmap for index!
        int16_t idx = mirror_y ? j + dx / 8 + ((h - 1 - (i + dy))) * wb : j + dx / 8 + (i + dy) * wb;
        if (pgm)
        {
#if defined(__AVR) || defined(ESP8266) || defined(ESP32)
          data = pgm_read_byte(&black[idx]);
#else
          data = black[idx];
#endif
        }
        else
        {
          data = black[idx];
        }
        if (invert) data = ~data;
      }
      _writeData(data);
    }
  }
  _writeCommand(0x13);
  for (int16_t i = 0; i < h1; i++)
  {
    for (int16_t j = 0; j < w1 / 8; j++)
    {
      uint8_t data = 0xFF;
      if (color)
      {
        // use wb, h of bitmap for index!
        int16_t idx = mirror_y ? j + dx / 8 + ((h - 1 - (i + dy))) * wb : j + dx / 8 + (i + dy) * wb;
        if (pgm)
        {
#if defined(__AVR) || defined(ESP8266) || defined(ESP32)
          data = pgm_read_byte(&color[idx]);
#else
          data = color[idx];
#endif
        }
        else
        {
          data = color[idx];
        }
        if (invert) data = ~data;
      }
      _writeData(data);
    }
  }
  _writeCommand(0x92); // partial out
  delay(1); // yield() to avoid WDT on ESP8266 and ESP32
}

writeImage() [2/2]

void GxEPD2_290c::writeImage ( const uint8_t bitmap[], int16_t x, int16_t y, int16_t w, int16_t h, bool invert = false, bool mirror_y = false, bool pgm = false )

virtual

Implements GxEPD2_EPD.

Definition at line 69 of file GxEPD2_290c.cpp.

{
  writeImage(bitmap, NULL, x, y, w, h, invert, mirror_y, pgm);
}

writeImagePart() [1/2]

void GxEPD2_290c::writeImagePart	(	const uint8_t *	black,
		const uint8_t *	color,
		int16_t	x_part,
		int16_t	y_part,
		int16_t	w_bitmap,
		int16_t	h_bitmap,
		int16_t	x,
		int16_t	y,
		int16_t	w,
		int16_t	h,
		bool	invert = false,
		bool	mirror_y = false,
		bool	pgm = false )

Definition at line 157 of file GxEPD2_290c.cpp.

{
  if (_initial_write) writeScreenBuffer(); // initial full screen buffer clean
  delay(1); // yield() to avoid WDT on ESP8266 and ESP32
  if ((w_bitmap < 0) || (h_bitmap < 0) || (w < 0) || (h < 0)) return;
  if ((x_part < 0) || (x_part >= w_bitmap)) return;
  if ((y_part < 0) || (y_part >= h_bitmap)) return;
  int16_t wb_bitmap = (w_bitmap + 7) / 8; // width bytes, bitmaps are padded
  x_part -= x_part % 8; // byte boundary
  w = w_bitmap - x_part < w ? w_bitmap - x_part : w; // limit
  h = h_bitmap - y_part < h ? h_bitmap - y_part : h; // limit
  x -= x % 8; // byte boundary
  w = 8 * ((w + 7) / 8); // byte boundary, bitmaps are padded
  int16_t x1 = x < 0 ? 0 : x; // limit
  int16_t y1 = y < 0 ? 0 : y; // limit
  int16_t w1 = x + w < int16_t(WIDTH) ? w : int16_t(WIDTH) - x; // limit
  int16_t h1 = y + h < int16_t(HEIGHT) ? h : int16_t(HEIGHT) - y; // limit
  int16_t dx = x1 - x;
  int16_t dy = y1 - y;
  w1 -= dx;
  h1 -= dy;
  if ((w1 <= 0) || (h1 <= 0)) return;
  if (!_using_partial_mode) _Init_Part();
  _writeCommand(0x91); // partial in
  _setPartialRamArea(x1, y1, w1, h1);
  _writeCommand(0x10);
  for (int16_t i = 0; i < h1; i++)
  {
    for (int16_t j = 0; j < w1 / 8; j++)
    {
      uint8_t data;
      // use wb_bitmap, h_bitmap of bitmap for index!
      int16_t idx = mirror_y ? x_part / 8 + j + dx / 8 + ((h_bitmap - 1 - (y_part + i + dy))) * wb_bitmap : x_part / 8 + j + dx / 8 + (y_part + i + dy) * wb_bitmap;
      if (pgm)
      {
#if defined(__AVR) || defined(ESP8266) || defined(ESP32)
        data = pgm_read_byte(&black[idx]);
#else
        data = black[idx];
#endif
      }
      else
      {
        data = black[idx];
      }
      if (invert) data = ~data;
      _writeData(data);
    }
  }
  _writeCommand(0x13);
  for (int16_t i = 0; i < h1; i++)
  {
    for (int16_t j = 0; j < w1 / 8; j++)
    {
      uint8_t data = 0xFF;
      if (color)
      {
        // use wb_bitmap, h_bitmap of bitmap for index!
        int16_t idx = mirror_y ? x_part / 8 + j + dx / 8 + ((h_bitmap - 1 - (y_part + i + dy))) * wb_bitmap : x_part / 8 + j + dx / 8 + (y_part + i + dy) * wb_bitmap;
        if (pgm)
        {
#if defined(__AVR) || defined(ESP8266) || defined(ESP32)
          data = pgm_read_byte(&color[idx]);
#else
          data = color[idx];
#endif
        }
        else
        {
          data = color[idx];
        }
        if (invert) data = ~data;
      }
      _writeData(data);
    }
  }
  _writeCommand(0x92); // partial out
  delay(1); // yield() to avoid WDT on ESP8266 and ESP32
}

writeImagePart() [2/2]

void GxEPD2_290c::writeImagePart ( const uint8_t bitmap[], int16_t x_part, int16_t y_part, int16_t w_bitmap, int16_t h_bitmap, int16_t x, int16_t y, int16_t w, int16_t h, bool invert = false, bool mirror_y = false, bool pgm = false )

virtual

Implements GxEPD2_EPD.

Definition at line 151 of file GxEPD2_290c.cpp.

{
  writeImagePart(bitmap, NULL, x_part, y_part, w_bitmap, h_bitmap, x, y, w, h, invert, mirror_y, pgm);
}

writeNative()

void GxEPD2_290c::writeNative	(	const uint8_t *	data1,
		const uint8_t *	data2,
		int16_t	x,
		int16_t	y,
		int16_t	w,
		int16_t	h,
		bool	invert = false,
		bool	mirror_y = false,
		bool	pgm = false )

Definition at line 238 of file GxEPD2_290c.cpp.

{
  if (data1)
  {
    writeImage(data1, x, y, w, h, invert, mirror_y, pgm);
  }
}

writeScreenBuffer() [1/2]

void GxEPD2_290c::writeScreenBuffer	(	uint8_t	black_value,
		uint8_t	color_value )

Definition at line 50 of file GxEPD2_290c.cpp.

{
  _initial_write = false; // initial full screen buffer clean done
  _Init_Part();
  _writeCommand(0x91); // partial in
  _setPartialRamArea(0, 0, WIDTH, HEIGHT);
  _writeCommand(0x10);
  for (uint32_t i = 0; i < uint32_t(WIDTH) * uint32_t(HEIGHT) / 8; i++)
  {
    _writeData(black_value);
  }
  _writeCommand(0x13);
  for (uint32_t i = 0; i < uint32_t(WIDTH) * uint32_t(HEIGHT) / 8; i++)
  {
    _writeData(color_value);
  }
  _writeCommand(0x92); // partial out
}

writeScreenBuffer() [2/2]

void GxEPD2_290c::writeScreenBuffer ( uint8_t value = 0xFF )

virtual

Implements GxEPD2_EPD.

Definition at line 45 of file GxEPD2_290c.cpp.

{
  writeScreenBuffer(value, 0xFF);
}

Member Data Documentation

full_refresh_time

const uint16_t GxEPD2_290c::full_refresh_time = 15000

static

Definition at line 32 of file GxEPD2_290c.h.

hasColor

const bool GxEPD2_290c::hasColor = true

static

Definition at line 26 of file GxEPD2_290c.h.

hasFastPartialUpdate

const bool GxEPD2_290c::hasFastPartialUpdate = false

static

Definition at line 29 of file GxEPD2_290c.h.

hasPartialUpdate

const bool GxEPD2_290c::hasPartialUpdate = true

static

Definition at line 27 of file GxEPD2_290c.h.

HEIGHT

const uint16_t GxEPD2_290c::HEIGHT = 296

static

Definition at line 24 of file GxEPD2_290c.h.

panel

const GxEPD2::Panel GxEPD2_290c::panel = GxEPD2::GDEW029Z10

static

Definition at line 25 of file GxEPD2_290c.h.

partial_refresh_time

const uint16_t GxEPD2_290c::partial_refresh_time = 15000

static

Definition at line 33 of file GxEPD2_290c.h.

power_off_time

const uint16_t GxEPD2_290c::power_off_time = 30

static

Definition at line 31 of file GxEPD2_290c.h.

power_on_time

const uint16_t GxEPD2_290c::power_on_time = 40

static

Definition at line 30 of file GxEPD2_290c.h.

usePartialUpdateWindow

const bool GxEPD2_290c::usePartialUpdateWindow = true

static

Definition at line 28 of file GxEPD2_290c.h.

WIDTH

const uint16_t GxEPD2_290c::WIDTH = 128

static

Definition at line 22 of file GxEPD2_290c.h.

WIDTH_VISIBLE

const uint16_t GxEPD2_290c::WIDTH_VISIBLE = WIDTH

static

Definition at line 23 of file GxEPD2_290c.h.

---

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

• src/drivers/epd3c/GxEPD2_290c.h
• src/drivers/epd3c/GxEPD2_290c.cpp