GxEPD2_420 Class Reference

#include <GxEPD2_420.h>

Inheritance diagram for GxEPD2_420:

Public Member Functions
	GxEPD2_420 (int16_t cs, int16_t dc, int16_t rst, int16_t busy)
void	clearScreen (uint8_t value=0xFF)
void	writeScreenBuffer (uint8_t value=0xFF)
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	writeImage_4G (const uint8_t bitmap[], uint8_t bpp, 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	writeImagePart_4G (const uint8_t bitmap[], uint8_t bpp, 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	drawImage_4G (const uint8_t bitmap[], uint8_t bpp, 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	drawImagePart_4G (const uint8_t bitmap[], uint8_t bpp, 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 = 400
static const uint16_t	HEIGHT = 300
static const GxEPD2::Panel	panel = GxEPD2::GDEW042T2
static const bool	hasColor = false
static const bool	hasPartialUpdate = true
static const bool	usePartialUpdateWindow = false
static const bool	hasFastPartialUpdate = true
static const uint16_t	power_on_time = 40
static const uint16_t	power_off_time = 20
static const uint16_t	full_refresh_time = 1600
static const uint16_t	partial_refresh_time = 600

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 20 of file GxEPD2_420.h.

Constructor & Destructor Documentation

GxEPD2_420()

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

Definition at line 15 of file GxEPD2_420.cpp.

                                                                        :
  GxEPD2_EPD(cs, dc, rst, busy, LOW, 10000000, WIDTH, HEIGHT, panel, hasColor, hasPartialUpdate, hasFastPartialUpdate)
{
  _refresh_mode = full_refresh;
}

Member Function Documentation

clearScreen()

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

virtual

Implements GxEPD2_EPD.

Definition at line 21 of file GxEPD2_420.cpp.

{
  writeScreenBuffer(value);
  refresh(true);
  if (_refresh_mode != grey_refresh) writeScreenBuffer(value);
}

drawImage() [1/2]

void GxEPD2_420::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 418 of file GxEPD2_420.cpp.

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

drawImage() [2/2]

void GxEPD2_420::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 403 of file GxEPD2_420.cpp.

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

drawImage_4G()

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

drawImagePart() [1/2]

void GxEPD2_420::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 425 of file GxEPD2_420.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);
  writeImagePart(black, color, x_part, y_part, w_bitmap, h_bitmap, x, y, w, h, invert, mirror_y, pgm);
}

drawImagePart() [2/2]

void GxEPD2_420::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 410 of file GxEPD2_420.cpp.

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

drawImagePart_4G()

void GxEPD2_420::drawImagePart_4G	(	const uint8_t	bitmap[],
		uint8_t	bpp,
		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 )

drawNative()

void GxEPD2_420::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 433 of file GxEPD2_420.cpp.

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

hibernate()

void GxEPD2_420::hibernate ( )

virtual

Implements GxEPD2_EPD.

Definition at line 482 of file GxEPD2_420.cpp.

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

powerOff()

void GxEPD2_420::powerOff ( void )

virtual

Implements GxEPD2_EPD.

Definition at line 477 of file GxEPD2_420.cpp.

{
  _PowerOff();
}

refresh() [1/2]

void GxEPD2_420::refresh ( bool partial_update_mode = false )

virtual

Implements GxEPD2_EPD.

Definition at line 440 of file GxEPD2_420.cpp.

{
  if (partial_update_mode) refresh(0, 0, WIDTH, HEIGHT);
  else
  {
    if (_refresh_mode == forced_full_refresh) _refresh_mode = full_refresh;
    if (_refresh_mode == fast_refresh) _Init_Full();
    if (_refresh_mode == grey_refresh) _Update_4G();
    else _Update_Full();
    _initial_refresh = false; // initial full update done
  }
}

refresh() [2/2]

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

virtual

Implements GxEPD2_EPD.

Definition at line 453 of file GxEPD2_420.cpp.

{
  if (_initial_refresh) return refresh(false); // initial update needs be full update
  if (_refresh_mode == forced_full_refresh) return refresh(false);
  // 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;
  if (_refresh_mode == full_refresh) _Init_Part();
  if (usePartialUpdateWindow) _writeCommand(0x91); // partial in
  _setPartialRamArea(x1, y1, w1, h1);
  if (_refresh_mode == grey_refresh) _Update_4G();
  else _Update_Part();
  if (usePartialUpdateWindow) _writeCommand(0x92); // partial out
}

writeImage() [1/2]

void GxEPD2_420::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 378 of file GxEPD2_420.cpp.

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

writeImage() [2/2]

void GxEPD2_420::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 51 of file GxEPD2_420.cpp.

{
    writeImage_4G(bitmap, GxEPD_BPP, x, y, w, h,  invert, mirror_y, pgm);
 
//  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;
//  if (_refresh_mode == grey_refresh) _Force_Init_Full();
//  else if (_refresh_mode == full_refresh) _Init_Part();
//  //uint32_t start = micros();
//  _writeCommand(0x91); // partial in
//  _setPartialRamArea(x1, y1, w1, h1);
//  _writeCommand(0x13);
//  _startTransfer();
//  for (int16_t i = 0; i < h1; i++)
//  {
//    for (int16_t j = 0; j < w1 / 8; j++)
//    {
//      uint8_t data;
//      // 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(&bitmap[idx]);
//#else
//        data = bitmap[idx];
//#endif
//      }
//      else
//      {
//        data = bitmap[idx];
//      }
//      if (invert) data = ~data;
//      _transfer(data);
//    }
//  }
//  _endTransfer();
//  _writeCommand(0x92); // partial out
//  //Serial.print("GxEPD2_420::writeImage took "); Serial.println(micros() - start);
//  delay(1); // yield() to avoid WDT on ESP8266 and ESP32
}

writeImage_4G()

void GxEPD2_420::writeImage_4G	(	const uint8_t	bitmap[],
		uint8_t	bpp,
		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 105 of file GxEPD2_420.cpp.

{
  uint16_t ppb = (bpp == 2 ? 4 : (bpp == 4 ? 2 : (bpp == 8 ? 1 : 0)));
  uint8_t mask = (bpp == 2 ? 0xC0 : (bpp == 4 ? 0xF0 : 0xFF));
  uint8_t grey1 = (bpp == 2 ? 0x80 : 0xA0); // demo limit for 4bpp
  if (ppb == 0) return;
  if (_initial_write) writeScreenBuffer(); // initial full screen buffer clean
  delay(1); // yield() to avoid WDT on ESP8266 and ESP32
  int16_t wbc = (w + 7) / 8; // width bytes on controller
  x -= x % 8; // byte boundary on controller
  w = wbc * 8; // byte boundary on controller
  int16_t wb = (w + ppb - 1) / ppb; // width bytes of bitmap, bitmaps are padded
  int16_t x1 = x < 0 ? 0 : x; // limit
  int16_t y1 = y < 0 ? 0 : y; // limit
  uint16_t w1 = x + w < int16_t(WIDTH) ? w : int16_t(WIDTH) - x; // limit
  uint16_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_4G();
  _writeCommand(0x91); // partial in
  _setPartialRamArea(x1, y1, w1, h1);
  _writeCommand(0x10);
  for (uint16_t i = 0; i < h1; i++) // lines
  {
    for (uint16_t j = 0; j < w1 / ppb; j += bpp) // out bytes
    {
      uint8_t out_byte = 0;
      for (uint16_t k = 0; k < bpp; k++) // in bytes (bpp per out byte)
      {
        uint8_t in_byte;
        // use wb, h of bitmap for index!
        uint32_t idx = mirror_y ? j + k + dx / ppb + uint32_t((h - 1 - (i + dy))) * wb : j + k + dx / ppb + uint32_t(i + dy) * wb;
        if (pgm)
        {
#if defined(__AVR) || defined(ESP8266) || defined(ESP32)
          in_byte = pgm_read_byte(&bitmap[idx]);
#else
          in_byte = bitmap[idx];
#endif
        }
        else
        {
          in_byte = bitmap[idx];
        }
        if (invert) in_byte = ~in_byte;
        for (uint16_t n = 0; n < ppb; n++) // bits, nibbles (ppb per in byte)
        {
          out_byte <<= 1;
          uint8_t nibble = in_byte & mask;
          if (nibble == mask) out_byte |= 0x01;//white
          else if (nibble == 0x00) out_byte |= 0x00;  //black
          else if (nibble >= grey1) out_byte |= 0x01;  //gray1
          else out_byte |= 0x00; //gray2
          in_byte <<= bpp;
        }
      }
      _writeData(out_byte);
    }
  }
  _writeCommand(0x13);
  for (uint16_t i = 0; i < h1; i++) // lines
  {
    for (uint16_t j = 0; j < w1 / ppb; j += bpp) // out bytes
    {
      uint8_t out_byte = 0;
      for (uint16_t k = 0; k < bpp; k++) // in bytes (bpp per out byte)
      {
        uint8_t in_byte;
        // use wb, h of bitmap for index!
        uint32_t idx = mirror_y ? j + k + dx / ppb + uint32_t((h - 1 - (i + dy))) * wb : j + k + dx / ppb + uint32_t(i + dy) * wb;
        if (pgm)
        {
#if defined(__AVR) || defined(ESP8266) || defined(ESP32)
          in_byte = pgm_read_byte(&bitmap[idx]);
#else
          in_byte = bitmap[idx];
#endif
        }
        else
        {
          in_byte = bitmap[idx];
        }
        if (invert) in_byte = ~in_byte;
        for (uint16_t n = 0; n < ppb; n++) // bits, nibbles (ppb per in byte)
        {
          out_byte <<= 1;
          uint8_t nibble = in_byte & mask;
          if (nibble == mask) out_byte |= 0x01;//white
          else if (nibble == 0x00) out_byte |= 0x00;  //black
          else if (nibble >= grey1) out_byte |= 0x00;  //gray1
          else out_byte |= 0x01; //gray2
          in_byte <<= bpp;
        }
      }
      _writeData(out_byte);
    }
  }
  _writeCommand(0x92); // partial out
  delay(1); // yield() to avoid WDT on ESP8266 and ESP32
}

writeImagePart() [1/2]

void GxEPD2_420::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 386 of file GxEPD2_420.cpp.

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

writeImagePart() [2/2]

void GxEPD2_420::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 209 of file GxEPD2_420.cpp.

{
    writeImagePart_4G(bitmap, GxEPD_BPP, x_part, y_part, w_bitmap, h_bitmap, x, y, w, h, invert, mirror_y, pgm);
//  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 (_refresh_mode == grey_refresh) _Force_Init_Full();
//  else if (_refresh_mode == full_refresh) _Init_Part();
//  _writeCommand(0x91); // partial in
//  _setPartialRamArea(x1, y1, w1, h1);
//  _writeCommand(0x13);
//  _startTransfer();
//  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(&bitmap[idx]);
//#else
//        data = bitmap[idx];
//#endif
//      }
//      else
//      {
//        data = bitmap[idx];
//      }
//      if (invert) data = ~data;
//      _transfer(data);
//    }
//  }
//  _endTransfer();
//  _writeCommand(0x92); // partial out
//  delay(1); // yield() to avoid WDT on ESP8266 and ESP32
}

writeImagePart_4G()

void GxEPD2_420::writeImagePart_4G	(	const uint8_t	bitmap[],
		uint8_t	bpp,
		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 267 of file GxEPD2_420.cpp.

{
  uint16_t ppb = (bpp == 2 ? 4 : (bpp == 4 ? 2 : (bpp == 8 ? 1 : 0)));
  uint8_t mask = (bpp == 2 ? 0xC0 : (bpp == 4 ? 0xF0 : 0xFF));
  uint8_t grey1 = (bpp == 2 ? 0x80 : 0xA0); // demo limit for 4bpp
  if (ppb == 0) return;
  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 + ppb - 1) / ppb; // width bytes, bitmaps are padded
  x_part -= x_part % ppb; // 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
  int16_t wbc = (w + 7) / 8; // width bytes on controller
  x -= x % 8; // byte boundary on controller
  w = wbc * 8; // byte boundary on controller
  int16_t x1 = x < 0 ? 0 : x; // limit
  int16_t y1 = y < 0 ? 0 : y; // limit
  uint16_t w1 = x + w < int16_t(WIDTH) ? w : int16_t(WIDTH) - x; // limit
  uint16_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_4G();
  _writeCommand(0x91); // partial in
  _setPartialRamArea(x1, y1, w1, h1);
  _writeCommand(0x10);
  for (uint16_t i = 0; i < h1; i++) // lines
  {
    for (uint16_t j = 0; j < w1 / ppb; j += bpp) // out bytes
    {
      uint8_t out_byte = 0;
      for (uint16_t k = 0; k < bpp; k++) // in bytes (bpp per out byte)
      {
        uint8_t in_byte;
        // use wb_bitmap, h_bitmap of bitmap for index!
        uint32_t idx = mirror_y ? x_part / ppb + j + k + dx / ppb + uint32_t((h_bitmap - 1 - (y_part + i + dy))) * wb_bitmap : x_part / ppb + j + k + dx / ppb + uint32_t(y_part + i + dy) * wb_bitmap;
        if (pgm)
        {
#if defined(__AVR) || defined(ESP8266) || defined(ESP32)
          in_byte = pgm_read_byte(&bitmap[idx]);
#else
          in_byte = bitmap[idx];
#endif
        }
        else
        {
          in_byte = bitmap[idx];
        }
        if (invert) in_byte = ~in_byte;
        for (uint16_t n = 0; n < ppb; n++) // bits, nibbles (ppb per in byte)
        {
          out_byte <<= 1;
          uint8_t nibble = in_byte & mask;
          if (nibble == mask) out_byte |= 0x01;//white
          else if (nibble == 0x00) out_byte |= 0x00;  //black
          else if (nibble >= grey1) out_byte |= 0x01;  //gray1
          else out_byte |= 0x00; //gray2
          in_byte <<= bpp;
        }
      }
      _writeData(out_byte);
    }
  }
  _writeCommand(0x13);
  for (uint16_t i = 0; i < h1; i++) // lines
  {
    for (uint16_t j = 0; j < w1 / ppb; j += bpp) // out bytes
    {
      uint8_t out_byte = 0;
      for (uint16_t k = 0; k < bpp; k++) // in bytes (bpp per out byte)
      {
        uint8_t in_byte;
        // use wb_bitmap, h_bitmap of bitmap for index!
        uint32_t idx = mirror_y ? x_part / ppb + j + k + dx / ppb + uint32_t((h_bitmap - 1 - (y_part + i + dy))) * wb_bitmap : x_part / ppb + j + k + dx / ppb + uint32_t(y_part + i + dy) * wb_bitmap;
        if (pgm)
        {
#if defined(__AVR) || defined(ESP8266) || defined(ESP32)
          in_byte = pgm_read_byte(&bitmap[idx]);
#else
          in_byte = bitmap[idx];
#endif
        }
        else
        {
          in_byte = bitmap[idx];
        }
        if (invert) in_byte = ~in_byte;
        for (uint16_t n = 0; n < ppb; n++) // bits, nibbles (ppb per in byte)
        {
          out_byte <<= 1;
          uint8_t nibble = in_byte & mask;
          if (nibble == mask) out_byte |= 0x01;//white
          else if (nibble == 0x00) out_byte |= 0x00;  //black
          else if (nibble >= grey1) out_byte |= 0x00;  //gray1
          else out_byte |= 0x01; //gray2
          in_byte <<= bpp;
        }
      }
      _writeData(out_byte);
    }
  }
  _writeCommand(0x92); // partial out
  delay(1); // yield() to avoid WDT on ESP8266 and ESP32
}

writeNative()

void GxEPD2_420::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 395 of file GxEPD2_420.cpp.

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

writeScreenBuffer()

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

virtual

Implements GxEPD2_EPD.

Definition at line 28 of file GxEPD2_420.cpp.

{
  _initial_write = false; // initial full screen buffer clean done
  if (_refresh_mode == full_refresh) _Init_Part();
  if (_initial_refresh || (_refresh_mode == grey_refresh))
  {
    _writeCommand(0x10); // init old data
    _startTransfer();
    for (uint32_t i = 0; i < uint32_t(WIDTH) * uint32_t(HEIGHT) / 8; i++)
    {
      _transfer(value);
    }
    _endTransfer();
  }
  _writeCommand(0x13);
  _startTransfer();
  for (uint32_t i = 0; i < uint32_t(WIDTH) * uint32_t(HEIGHT) / 8; i++)
  {
    _transfer(value);
  }
  _endTransfer();
}

Member Data Documentation

full_refresh_time

const uint16_t GxEPD2_420::full_refresh_time = 1600

static

Definition at line 33 of file GxEPD2_420.h.

hasColor

const bool GxEPD2_420::hasColor = false

static

Definition at line 27 of file GxEPD2_420.h.

hasFastPartialUpdate

const bool GxEPD2_420::hasFastPartialUpdate = true

static

Definition at line 30 of file GxEPD2_420.h.

hasPartialUpdate

const bool GxEPD2_420::hasPartialUpdate = true

static

Definition at line 28 of file GxEPD2_420.h.

HEIGHT

const uint16_t GxEPD2_420::HEIGHT = 300

static

Definition at line 25 of file GxEPD2_420.h.

panel

const GxEPD2::Panel GxEPD2_420::panel = GxEPD2::GDEW042T2

static

Definition at line 26 of file GxEPD2_420.h.

partial_refresh_time

const uint16_t GxEPD2_420::partial_refresh_time = 600

static

Definition at line 34 of file GxEPD2_420.h.

power_off_time

const uint16_t GxEPD2_420::power_off_time = 20

static

Definition at line 32 of file GxEPD2_420.h.

power_on_time

const uint16_t GxEPD2_420::power_on_time = 40

static

Definition at line 31 of file GxEPD2_420.h.

usePartialUpdateWindow

const bool GxEPD2_420::usePartialUpdateWindow = false

static

Definition at line 29 of file GxEPD2_420.h.

WIDTH

const uint16_t GxEPD2_420::WIDTH = 400

static

Definition at line 24 of file GxEPD2_420.h.

---

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

• src/drivers/epd/GxEPD2_420.h
• src/drivers/epd/GxEPD2_420.cpp