first commit

2025-03-06 11:15:32 +01:00
commit 7b30d6e298
5276 changed files with 2108927 additions and 0 deletions
--- a/libraries/GxEPD/examples/PartialUpdateTest/PartialUpdateTest.ino
+++ b/libraries/GxEPD/examples/PartialUpdateTest/PartialUpdateTest.ino
@@ -0,0 +1,269 @@
+// 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 <GxEPD.h>
+
+// select the display class to use, only one
+//#include <GxDEPG0150BN/GxDEPG0150BN.h>    // 1.50" b/w
+//#include <GxGDEP015OC1/GxGDEP015OC1.h>    // 1.54" b/w
+//#include <GxGDEH0154D67/GxGDEH0154D67.h>  // 1.54" b/w 200x200, SSD1681
+//#include <GxGDEW0154T8/GxGDEW0154T8.h>    // 1.54" b/w 152x152 UC8151 (IL0373)
+//#include <GxGDEW0154M09/GxGDEW0154M09.h>  // 1.54" b/w 200x200 JD79653A
+//#include <GxGDEW0154M10/GxGDEW0154M10.h>  // 1.54" b/w 152x152 UC8151D
+//#include <GxGDEW0154Z04/GxGDEW0154Z04.h>  // 1.54" b/w/r 200x200
+//#include <GxGDEW0154Z17/GxGDEW0154Z17.h>  // 1.54" b/w/r 152x152
+//#include <GxGDEH0154Z90/GxGDEH0154Z90.h>  // 1.54" b/w/r 200x200 SSD1681
+//#include <GxGDEW0213I5F/GxGDEW0213I5F.h>  // 2.13" b/w 104x212 flexible
+//#include <GxGDE0213B1/GxGDE0213B1.h>      // 2.13" b/w
+//#include <GxGDEH0213B72/GxGDEH0213B72.h>  // 2.13" b/w new panel
+//#include <GxGDEH0213B73/GxGDEH0213B73.h>  // 2.13" b/w newer panel
+//#include <GxGDEM0213B74/GxGDEM0213B74.h>  // 2.13" b/w 128x250 SSD1680
+//#include <GxGDEW0213Z16/GxGDEW0213Z16.h>  // 2.13" b/w/r
+//#include <GxGDEH0213Z19/GxGDEH0213Z19.h>  // 2.13" b/w/r UC8151D
+//#include <GxGDEW0213T5D/GxGDEW0213T5D.h>  // 2.13" b/w 104x212 UC8151D
+//#include <GxDEPG0213BN/GxDEPG0213BN.h>    // 2.13" b/w 128x250, SSD1680, TTGO T5 V2.4.1, V2.3.1
+//#include <GxGDEH029A1/GxGDEH029A1.h>      // 2.9" b/w
+//#include <GxGDEW029T5/GxGDEW029T5.h>      // 2.9" b/w UC8151 (IL0373)
+//#include <GxGDEW029T5D/GxGDEW029T5D.h>    // 2.9" b/w UC8151D
+//#include <GxGDEM029T94/GxGDEM029T94.h>    // 2.9" b/w
+//#include <GxDEPG0290BS/GxDEPG0290BS.h>    // 2.9" b/w Waveshare variant, TTGO T5 V2.4.1 2.9"
+//#include <GxGDEW029Z10/GxGDEW029Z10.h>    // 2.9" b/w/r
+//#include <GxGDEH029Z13/GxGDEH029Z13.h>    // 2.9" b/w/r UC8151D
+//#include <GxGDEW026T0/GxGDEW026T0.h>      // 2.6" b/w
+//#include <GxDEPG0266BN/GxDEPG0266BN.h>      // 2.66" b/w 152x296, SSD1680, TTGO T5 V2.66, TTGO T5 V2.4.1
+//#include <GxGDEW027C44/GxGDEW027C44.h>    // 2.7" b/w/r
+//#include <GxGDEW027W3/GxGDEW027W3.h>      // 2.7" b/w
+//#include <GxGDEY027T91/GxGDEY027T91.h>    // 2.7" b/w
+//#include <GxGDEW0371W7/GxGDEW0371W7.h>    // 3.7" b/w
+//#include <GxGDEW042T2/GxGDEW042T2.h>      // 4.2" b/w
+//#include <GxGDEW042Z15/GxGDEW042Z15.h>    // 4.2" b/w/r
+//#include <GxGDEW0583T7/GxGDEW0583T7.h>    // 5.83" b/w
+//#include <GxGDEW075T8/GxGDEW075T8.h>      // 7.5" b/w
+//#include <GxGDEW075T7/GxGDEW075T7.h>      // 7.5" b/w 800x480
+//#include <GxGDEW075Z09/GxGDEW075Z09.h>    // 7.5" b/w/r
+//#include <GxGDEW075Z08/GxGDEW075Z08.h>    // 7.5" b/w/r 800x480
+
+#include <GxIO/GxIO_SPI/GxIO_SPI.h>
+#include <GxIO/GxIO.h>
+
+// FreeFonts from Adafruit_GFX
+#include <Fonts/FreeMonoBold9pt7b.h>
+#include <Fonts/FreeMonoBold12pt7b.h>
+
+#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