// PartialUpdateTest : example for Waveshare 1.54", 2.31" and 2.9" e-Paper and the same e-papers from Dalian Good Display Inc. // // Created by Jean-Marc Zingg based on demo code from Good Display for GDEP015OC1. // // The e-paper displays are available from: // // https://www.aliexpress.com/store/product/Wholesale-1-54inch-E-Ink-display-module-with-embedded-controller-200x200-Communicate-via-SPI-interface-Supports/216233_32824535312.html // // http://www.buy-lcd.com/index.php?route=product/product&path=2897_8363&product_id=35120 // or https://www.aliexpress.com/store/product/E001-1-54-inch-partial-refresh-Small-size-dot-matrix-e-paper-display/600281_32815089163.html // // Supporting Arduino Forum Topics: // Waveshare e-paper displays with SPI: http://forum.arduino.cc/index.php?topic=487007.0 // Good Dispay ePaper for Arduino : https://forum.arduino.cc/index.php?topic=436411.0 // mapping from Waveshare 2.9inch e-Paper to Wemos D1 mini // BUSY -> D2, RST -> D4, DC -> D3, CS -> D8, CLK -> D5, DIN -> D7, GND -> GND, 3.3V -> 3.3V // mapping example for AVR, UNO, NANO etc. // BUSY -> 7, RST -> 9, DC -> 8, C S-> 10, CLK -> 13, DIN -> 11 // include library, include base class, make path known #include // select the display class to use, only one //#include // 1.50" b/w //#include // 1.54" b/w //#include // 1.54" b/w 200x200, SSD1681 //#include // 1.54" b/w 152x152 UC8151 (IL0373) //#include // 1.54" b/w 200x200 JD79653A //#include // 1.54" b/w 152x152 UC8151D //#include // 1.54" b/w/r 200x200 //#include // 1.54" b/w/r 152x152 //#include // 1.54" b/w/r 200x200 SSD1681 //#include // 2.13" b/w 104x212 flexible //#include // 2.13" b/w //#include // 2.13" b/w new panel //#include // 2.13" b/w newer panel //#include // 2.13" b/w 128x250 SSD1680 //#include // 2.13" b/w/r //#include // 2.13" b/w/r UC8151D //#include // 2.13" b/w 104x212 UC8151D //#include // 2.13" b/w 128x250, SSD1680, TTGO T5 V2.4.1, V2.3.1 //#include // 2.9" b/w //#include // 2.9" b/w UC8151 (IL0373) //#include // 2.9" b/w UC8151D //#include // 2.9" b/w //#include // 2.9" b/w Waveshare variant, TTGO T5 V2.4.1 2.9" //#include // 2.9" b/w/r //#include // 2.9" b/w/r UC8151D //#include // 2.6" b/w //#include // 2.66" b/w 152x296, SSD1680, TTGO T5 V2.66, TTGO T5 V2.4.1 //#include // 2.7" b/w/r //#include // 2.7" b/w //#include // 2.7" b/w //#include // 3.7" b/w //#include // 4.2" b/w //#include // 4.2" b/w/r //#include // 5.83" b/w //#include // 7.5" b/w //#include // 7.5" b/w 800x480 //#include // 7.5" b/w/r //#include // 7.5" b/w/r 800x480 #include #include // FreeFonts from Adafruit_GFX #include #include #include GxEPD_BitmapExamples #if defined(ESP8266) // for SPI pin definitions see e.g.: // C:\Users\xxx\AppData\Local\Arduino15\packages\esp8266\hardware\esp8266\2.4.2\variants\generic\common.h GxIO_Class io(SPI, /*CS=D8*/ SS, /*DC=D3*/ 0, /*RST=D4*/ 2); // arbitrary selection of D3(=0), D4(=2), selected for default of GxEPD_Class GxEPD_Class display(io /*RST=D4*/ /*BUSY=D2*/); // default selection of D4(=2), D2(=4) #elif defined(ESP32) // for SPI pin definitions see e.g.: // C:\Users\xxx\Documents\Arduino\hardware\espressif\esp32\variants\lolin32\pins_arduino.h GxIO_Class io(SPI, /*CS=5*/ SS, /*DC=*/ 17, /*RST=*/ 16); // arbitrary selection of 17, 16 GxEPD_Class display(io, /*RST=*/ 16, /*BUSY=*/ 4); // arbitrary selection of (16), 4 // for LILYGO® TTGO T5 2.66 board uncomment next two lines instead of previous two lines //GxIO_Class io(SPI, /*CS=5*/ SS, /*DC=*/ 19, /*RST=*/ 4); // LILYGO® TTGO T5 2.66 //GxEPD_Class display(io, /*RST=*/ 4, /*BUSY=*/ 34); // LILYGO® TTGO T5 2.66 #elif defined(ARDUINO_ARCH_SAMD) // for SPI pin definitions see e.g.: // C:\Users\xxx\AppData\Local\Arduino15\packages\arduino\hardware\samd\1.6.19\variants\mkr1000\variant.h // C:\Users\xxx\AppData\Local\Arduino15\packages\arduino\hardware\samd\1.6.19\variants\mkrzero\variant.h GxIO_Class io(SPI, /*CS=*/ 4, /*DC=*/ 7, /*RST=*/ 6); GxEPD_Class display(io, /*RST=*/ 6, /*BUSY=*/ 5); #elif defined(_BOARD_GENERIC_STM32F103C_H_) // STM32 Boards(STM32duino.com) Generic STM32F103C series STM32F103C8 // for SPI pin definitions see e.g.: // C:\Users\xxx\Documents\Arduino\hardware\Arduino_STM32\STM32F1\variants\generic_stm32f103c\variant.h // C:\Users\xxx\Documents\Arduino\hardware\Arduino_STM32\STM32F1\variants\generic_stm32f103c\board\board.h // new mapping suggestion for STM32F1, e.g. STM32F103C8T6 "BluePill" // BUSY -> A1, RST -> A2, DC -> A3, CS-> A4, CLK -> A5, DIN -> A7 GxIO_Class io(SPI, /*CS=*/ SS, /*DC=*/ 3, /*RST=*/ 2); GxEPD_Class display(io, /*RST=*/ 2, /*BUSY=*/ 1); #elif defined(ARDUINO_GENERIC_STM32F103V) && defined(MCU_STM32F103VB) // STM32 Boards(STM32duino.com) Generic STM32F103V series STM32F103VB // for SPI pin definitions see e.g.: // C:\Users\xxx\Documents\Arduino\hardware\Arduino_STM32\STM32F1\variants\generic_stm32f103vb\variant.h // C:\Users\xxx\Documents\Arduino\hardware\Arduino_STM32\STM32F1\variants\generic_stm32f103vb\board\board.h // Good Display DESPI-M01 // note: needs jumper wires from SS=PA4->CS, SCK=PA5->SCK, MOSI=PA7->SDI GxIO_Class io(SPI, /*CS=*/ SS, /*DC=*/ PE15, /*RST=*/ PE14); // DC, RST as wired by DESPI-M01 GxEPD_Class display(io, /*RST=*/ PE14, /*BUSY=*/ PE13); // RST, BUSY as wired by DESPI-M01 #else // for SPI pin definitions see e.g.: // C:\Users\xxx\AppData\Local\Arduino15\packages\arduino\hardware\avr\1.6.21\variants\standard\pins_arduino.h GxIO_Class io(SPI, /*CS=*/ SS, /*DC=*/ 8, /*RST=*/ 9); // arbitrary selection of 8, 9 selected for default of GxEPD_Class GxEPD_Class display(io /*RST=9*/ /*BUSY=7*/); // default selection of (9), 7 #endif #if defined(_GxGDEP015OC1_H_) || defined(_GxGDEH0154D67_H_) const uint32_t partial_update_period_s = 1; const uint32_t full_update_period_s = 6 * 60 * 60; #elif defined(_GxGDE0213B1_H_) || defined(_GxGDEH029A1_H_) || defined(_GxGDEM029T94_H_) || defined(_GxGDEW042T2_H_) const uint32_t partial_update_period_s = 2; const uint32_t full_update_period_s = 1 * 60 * 60; #else const uint32_t partial_update_period_s = 2; const uint32_t full_update_period_s = 1 * 60 * 60; #endif uint32_t start_time; uint32_t next_time; uint32_t previous_time; uint32_t previous_full_update; uint32_t total_seconds = 0; uint32_t seconds, minutes, hours, days; void setup(void) { Serial.begin(115200); Serial.println(); Serial.println("setup"); //display.init(115200); // enable diagnostic output on Serial display.init(); // disable diagnostic output on Serial Serial.println("setup done"); display.setTextColor(GxEPD_BLACK); display.setRotation(0); // draw background #if defined(__AVR) && defined(_GxGDEW042T2_H_) // cope with code size limitation display.drawExampleBitmap(BitmapExample1, sizeof(BitmapExample1)); display.setFont(&FreeMonoBold9pt7b); #else display.drawExampleBitmap(BitmapExample1, 0, 0, GxEPD_WIDTH, GxEPD_HEIGHT, GxEPD_BLACK); display.update(); display.setFont(&FreeMonoBold12pt7b); #endif // partial update to full screen to preset for partial update of box window // (this avoids strange background effects) display.drawExampleBitmap(BitmapExample1, sizeof(BitmapExample1), GxEPD::bm_default | GxEPD::bm_partial_update); start_time = next_time = previous_time = previous_full_update = millis(); display.setRotation(1); } void loop() { uint32_t actual = millis(); while (actual < next_time) { // the "BlinkWithoutDelay" method works also for overflowed millis if ((actual - previous_time) > (partial_update_period_s * 1000)) { //Serial.print(actual - previous_time); Serial.print(" > "); Serial.println(partial_update_period_s * 1000); break; } delay(100); actual = millis(); } //Serial.print("actual: "); Serial.print(actual); Serial.print(" previous: "); Serial.println(previous_time); if ((actual - previous_full_update) > full_update_period_s * 1000) { #if defined(__AVR) && defined(_GxGDEW042T2_H_) display.drawExampleBitmap(BitmapExample1, sizeof(BitmapExample1)); display.drawExampleBitmap(BitmapExample1, sizeof(BitmapExample1), GxEPD::bm_default | GxEPD::bm_partial_update); #else display.update(); #endif previous_full_update = actual; } previous_time = actual; next_time += uint32_t(partial_update_period_s * 1000); total_seconds += partial_update_period_s; seconds = total_seconds % 60; minutes = (total_seconds / 60) % 60; hours = (total_seconds / 3600) % 24; days = (total_seconds / 3600) / 24; #if defined(__AVR) showPartialUpdate_AVR(); #else showPartialUpdate(); #endif } void print02d(uint32_t d) { if (d < 10) display.print("0"); display.print(d); } #if !defined(__AVR) void showPartialUpdate() { uint16_t box_x = 10; uint16_t box_y = 15; uint16_t box_w = 170; uint16_t box_h = 20; uint16_t cursor_y = box_y + 16; display.fillRect(box_x, box_y, box_w, box_h, GxEPD_WHITE); display.setCursor(box_x, cursor_y); display.print(days); display.print("d "); print02d(hours); display.print(":"); print02d(minutes); display.print(":"); print02d(seconds); display.updateWindow(box_x, box_y, box_w, box_h, true); } #else void drawCallback() { uint16_t box_x = 10; uint16_t box_y = 15; uint16_t box_w = 170; uint16_t box_h = 20; uint16_t cursor_y = box_y + 16; display.fillRect(box_x, box_y, box_w, box_h, GxEPD_WHITE); display.setCursor(box_x, cursor_y); display.print(days); display.print("d "); print02d(hours); display.print(":"); print02d(minutes); display.print(":"); print02d(seconds); } void showPartialUpdate_AVR() { uint16_t box_x = 10; uint16_t box_y = 15; uint16_t box_w = 170; uint16_t box_h = 20; uint16_t cursor_y = box_y + 14; display.drawPagedToWindow(drawCallback, box_x, box_y, box_w, box_h); } #endif