#include "configuration.h" #ifdef USE_EINK #include "EInkDisplay2.h" #include "GxEPD2_BW.h" #include "SPILock.h" #include "main.h" #include #if defined(HELTEC_WIRELESS_PAPER) || defined(HELTEC_WIRELESS_PAPER_V1_0) SPIClass *hspi = NULL; #endif #define COLORED GxEPD_BLACK #define UNCOLORED GxEPD_WHITE #if defined(TTGO_T_ECHO) #define TECHO_DISPLAY_MODEL GxEPD2_154_D67 #elif defined(RAK4630) // GxEPD2_213_BN - RAK14000 2.13 inch b/w 250x122 - changed from GxEPD2_213_B74 - which was not going to give partial update // support #define TECHO_DISPLAY_MODEL GxEPD2_213_BN // 4.2 inch 300x400 - GxEPD2_420_M01 // #define TECHO_DISPLAY_MODEL GxEPD2_420_M01 // 2.9 inch 296x128 - GxEPD2_290_T5D // #define TECHO_DISPLAY_MODEL GxEPD2_290_T5D // 1.54 inch 200x200 - GxEPD2_154_M09 // #define TECHO_DISPLAY_MODEL GxEPD2_154_M09 #elif defined(MAKERPYTHON) // 2.9 inch 296x128 - GxEPD2_290_T5D #define TECHO_DISPLAY_MODEL GxEPD2_290_T5D #elif defined(PCA10059) // 4.2 inch 300x400 - GxEPD2_420_M01 #define TECHO_DISPLAY_MODEL GxEPD2_420_M01 #elif defined(M5_COREINK) // M5Stack CoreInk // 1.54 inch 200x200 - GxEPD2_154_M09 #define TECHO_DISPLAY_MODEL GxEPD2_154_M09 #elif defined(HELTEC_WIRELESS_PAPER) // #define TECHO_DISPLAY_MODEL GxEPD2_213_T5D #define TECHO_DISPLAY_MODEL GxEPD2_213_FC1 #elif defined(HELTEC_WIRELESS_PAPER_V1_0) // 2.13" 122x250 - DEPG0213BNS800 #define TECHO_DISPLAY_MODEL GxEPD2_213_BN #endif GxEPD2_BW *adafruitDisplay; EInkDisplay::EInkDisplay(uint8_t address, int sda, int scl, OLEDDISPLAY_GEOMETRY geometry, HW_I2C i2cBus) { #if defined(TTGO_T_ECHO) setGeometry(GEOMETRY_RAWMODE, 200, 200); #elif defined(RAK4630) // GxEPD2_213_BN - RAK14000 2.13 inch b/w 250x122 setGeometry(GEOMETRY_RAWMODE, 250, 122); // GxEPD2_420_M01 // setGeometry(GEOMETRY_RAWMODE, 300, 400); // GxEPD2_290_T5D // setGeometry(GEOMETRY_RAWMODE, 296, 128); // GxEPD2_154_M09 // setGeometry(GEOMETRY_RAWMODE, 200, 200); #elif defined(HELTEC_WIRELESS_PAPER_V1_0) // The display's memory is actually 128px x 250px // Setting the buffersize manually prevents 122/8 truncating to a 15 byte width // (Or something like that..) this->geometry = GEOMETRY_RAWMODE; this->displayWidth = 250; this->displayHeight = 122; this->displayBufferSize = 250 * (128 / 8); #elif defined(HELTEC_WIRELESS_PAPER) // GxEPD2_213_BN - 2.13 inch b/w 250x122 setGeometry(GEOMETRY_RAWMODE, 250, 122); #elif defined(MAKERPYTHON) // GxEPD2_290_T5D setGeometry(GEOMETRY_RAWMODE, 296, 128); #elif defined(PCA10059) // GxEPD2_420_M01 setGeometry(GEOMETRY_RAWMODE, 300, 400); #elif defined(M5_COREINK) // M5Stack_CoreInk 200x200 // 1.54 inch 200x200 - GxEPD2_154_M09 setGeometry(GEOMETRY_RAWMODE, EPD_HEIGHT, EPD_WIDTH); #elif defined(my) // GxEPD2_290_T5D setGeometry(GEOMETRY_RAWMODE, 296, 128); LOG_DEBUG("GEOMETRY_RAWMODE, 296, 128\n"); #elif defined(ESP32_S3_PICO) // GxEPD2_290_T94_V2 setGeometry(GEOMETRY_RAWMODE, EPD_WIDTH, EPD_HEIGHT); LOG_DEBUG("GEOMETRY_RAWMODE, 296, 128\n"); #endif // setGeometry(GEOMETRY_RAWMODE, 128, 64); // old resolution // setGeometry(GEOMETRY_128_64); // We originally used this because I wasn't sure if rawmode worked - it does } // FIXME quick hack to limit drawing to a very slow rate uint32_t lastDrawMsec; /** * Force a display update if we haven't drawn within the specified msecLimit */ bool EInkDisplay::forceDisplay(uint32_t msecLimit) { // No need to grab this lock because we are on our own SPI bus // concurrency::LockGuard g(spiLock); #if defined(USE_EINK_DYNAMIC_PARTIAL) // Decide if update is partial or full bool continueUpdate = determineRefreshMode(); if (!continueUpdate) return false; #else uint32_t now = millis(); uint32_t sinceLast = now - lastDrawMsec; if (adafruitDisplay && (sinceLast > msecLimit || lastDrawMsec == 0)) lastDrawMsec = now; else return false; #endif // FIXME - only draw bits have changed (use backbuf similar to the other displays) // tft.drawBitmap(0, 0, buffer, 128, 64, TFT_YELLOW, TFT_BLACK); for (uint32_t y = 0; y < displayHeight; y++) { for (uint32_t x = 0; x < displayWidth; x++) { // get src pixel in the page based ordering the OLED lib uses FIXME, super inefficient auto b = buffer[x + (y / 8) * displayWidth]; auto isset = b & (1 << (y & 7)); adafruitDisplay->drawPixel(x, y, isset ? COLORED : UNCOLORED); } } LOG_DEBUG("Updating E-Paper... "); #if defined(TTGO_T_ECHO) adafruitDisplay->nextPage(); #elif defined(RAK4630) || defined(MAKERPYTHON) // RAK14000 2.13 inch b/w 250x122 actually now does support partial updates // Full update mode (slow) // adafruitDisplay->display(false); // FIXME, use partial update mode // Only enable for e-Paper with support for partial updates and comment out above adafruitDisplay->display(false); // 1.54 inch 200x200 - GxEPD2_154_M09 // 2.13 inch 250x122 - GxEPD2_213_BN // 2.9 inch 296x128 - GxEPD2_290_T5D // 4.2 inch 300x400 - GxEPD2_420_M01 adafruitDisplay->nextPage(); #elif defined(PCA10059) || defined(M5_COREINK) adafruitDisplay->nextPage(); #elif defined(HELTEC_WIRELESS_PAPER_V1_0) adafruitDisplay->nextPage(); #elif defined(HELTEC_WIRELESS_PAPER) adafruitDisplay->nextPage(); #elif defined(ESP32_S3_PICO) adafruitDisplay->nextPage(); #elif defined(PRIVATE_HW) || defined(my) adafruitDisplay->nextPage(); #endif // Put screen to sleep to save power (possibly not necessary because we already did poweroff inside of display) adafruitDisplay->hibernate(); LOG_DEBUG("done\n"); return true; } // Write the buffer to the display memory void EInkDisplay::display(void) { // We don't allow regular 'dumb' display() calls to draw on eink until we've shown // at least one forceDisplay() keyframe. This prevents flashing when we should the critical // bootscreen (that we want to look nice) #ifdef USE_EINK_DYNAMIC_PARTIAL lowPriority(); forceDisplay(); highPriority(); #else if (lastDrawMsec) { forceDisplay(slowUpdateMsec); // Show the first screen a few seconds after boot, then slower } #endif } // Send a command to the display (low level function) void EInkDisplay::sendCommand(uint8_t com) { (void)com; // Drop all commands to device (we just update the buffer) } void EInkDisplay::setDetected(uint8_t detected) { (void)detected; } // Connect to the display bool EInkDisplay::connect() { LOG_INFO("Doing EInk init\n"); #ifdef PIN_EINK_PWR_ON pinMode(PIN_EINK_PWR_ON, OUTPUT); digitalWrite(PIN_EINK_PWR_ON, HIGH); // If we need to assert a pin to power external peripherals #endif #ifdef PIN_EINK_EN // backlight power, HIGH is backlight on, LOW is off pinMode(PIN_EINK_EN, OUTPUT); digitalWrite(PIN_EINK_EN, LOW); #endif #if defined(TTGO_T_ECHO) { auto lowLevel = new TECHO_DISPLAY_MODEL(PIN_EINK_CS, PIN_EINK_DC, PIN_EINK_RES, PIN_EINK_BUSY, SPI1); adafruitDisplay = new GxEPD2_BW(*lowLevel); adafruitDisplay->init(); adafruitDisplay->setRotation(3); adafruitDisplay->setPartialWindow(0, 0, displayWidth, displayHeight); } #elif defined(RAK4630) || defined(MAKERPYTHON) { if (eink_found) { auto lowLevel = new TECHO_DISPLAY_MODEL(PIN_EINK_CS, PIN_EINK_DC, PIN_EINK_RES, PIN_EINK_BUSY); adafruitDisplay = new GxEPD2_BW(*lowLevel); adafruitDisplay->init(115200, true, 10, false, SPI1, SPISettings(4000000, MSBFIRST, SPI_MODE0)); // RAK14000 2.13 inch b/w 250x122 does actually now support partial updates adafruitDisplay->setRotation(3); // Partial update support for 1.54, 2.13 RAK14000 b/w , 2.9 and 4.2 // adafruitDisplay->setRotation(1); adafruitDisplay->setPartialWindow(0, 0, displayWidth, displayHeight); } else { (void)adafruitDisplay; } } #elif defined(HELTEC_WIRELESS_PAPER_V1_0) { // Is this a normal boot, or a wake from deep sleep? esp_sleep_wakeup_cause_t wakeReason = esp_sleep_get_wakeup_cause(); // If waking from sleep, need to reverse rtc_gpio_isolate(), called in cpuDeepSleep() // Otherwise, SPI won't work if (wakeReason != ESP_SLEEP_WAKEUP_UNDEFINED) { // HSPI + other display pins rtc_gpio_hold_dis((gpio_num_t)PIN_EINK_SCLK); rtc_gpio_hold_dis((gpio_num_t)PIN_EINK_DC); rtc_gpio_hold_dis((gpio_num_t)PIN_EINK_RES); rtc_gpio_hold_dis((gpio_num_t)PIN_EINK_BUSY); rtc_gpio_hold_dis((gpio_num_t)PIN_EINK_CS); rtc_gpio_hold_dis((gpio_num_t)PIN_EINK_MOSI); } // Start HSPI hspi = new SPIClass(HSPI); hspi->begin(PIN_EINK_SCLK, -1, PIN_EINK_MOSI, PIN_EINK_CS); // SCLK, MISO, MOSI, SS // Enable VExt (ACTIVE LOW) // Unsure if called elsewhere first? delay(100); pinMode(Vext, OUTPUT); digitalWrite(Vext, LOW); delay(100); // Create GxEPD2 objects auto lowLevel = new TECHO_DISPLAY_MODEL(PIN_EINK_CS, PIN_EINK_DC, PIN_EINK_RES, PIN_EINK_BUSY, *hspi); adafruitDisplay = new GxEPD2_BW(*lowLevel); // Init GxEPD2 adafruitDisplay->init(); adafruitDisplay->setRotation(3); } #elif defined(HELTEC_WIRELESS_PAPER) { hspi = new SPIClass(HSPI); hspi->begin(PIN_EINK_SCLK, -1, PIN_EINK_MOSI, PIN_EINK_CS); // SCLK, MISO, MOSI, SS delay(100); pinMode(Vext, OUTPUT); digitalWrite(Vext, LOW); delay(100); auto lowLevel = new TECHO_DISPLAY_MODEL(PIN_EINK_CS, PIN_EINK_DC, PIN_EINK_RES, PIN_EINK_BUSY, *hspi); adafruitDisplay = new GxEPD2_BW(*lowLevel); adafruitDisplay->init(); adafruitDisplay->setRotation(3); } #elif defined(PCA10059) { auto lowLevel = new TECHO_DISPLAY_MODEL(PIN_EINK_CS, PIN_EINK_DC, PIN_EINK_RES, PIN_EINK_BUSY); adafruitDisplay = new GxEPD2_BW(*lowLevel); adafruitDisplay->init(115200, true, 10, false, SPI1, SPISettings(4000000, MSBFIRST, SPI_MODE0)); adafruitDisplay->setRotation(3); adafruitDisplay->setPartialWindow(0, 0, displayWidth, displayHeight); } #elif defined(M5_COREINK) auto lowLevel = new TECHO_DISPLAY_MODEL(PIN_EINK_CS, PIN_EINK_DC, PIN_EINK_RES, PIN_EINK_BUSY); adafruitDisplay = new GxEPD2_BW(*lowLevel); adafruitDisplay->init(115200, true, 40, false, SPI, SPISettings(4000000, MSBFIRST, SPI_MODE0)); adafruitDisplay->setRotation(0); adafruitDisplay->setPartialWindow(0, 0, EPD_WIDTH, EPD_HEIGHT); #elif defined(my) || defined(ESP32_S3_PICO) { auto lowLevel = new TECHO_DISPLAY_MODEL(PIN_EINK_CS, PIN_EINK_DC, PIN_EINK_RES, PIN_EINK_BUSY); adafruitDisplay = new GxEPD2_BW(*lowLevel); adafruitDisplay->init(115200, true, 40, false, SPI, SPISettings(4000000, MSBFIRST, SPI_MODE0)); adafruitDisplay->setRotation(1); adafruitDisplay->setPartialWindow(0, 0, EPD_WIDTH, EPD_HEIGHT); } #endif // adafruitDisplay->setFullWindow(); // adafruitDisplay->fillScreen(UNCOLORED); // adafruitDisplay->drawCircle(100, 100, 20, COLORED); // adafruitDisplay->display(false); return true; } // Use a mix of full and partial refreshes, to preserve display health #if defined(USE_EINK_DYNAMIC_PARTIAL) // Suggest that subsequent updates should use partial-refresh void EInkDisplay::highPriority() { isHighPriority = true; } // Suggest that subsequent updates should use full-refresh void EInkDisplay::lowPriority() { isHighPriority = false; } // configure display for partial-refresh void EInkDisplay::configForPartialRefresh() { // Display-specific code can go here #if defined(PRIVATE_HW) #else // Otherwise: adafruitDisplay->setPartialWindow(0, 0, adafruitDisplay->width(), adafruitDisplay->height()); #endif } // Configure display for full-refresh void EInkDisplay::configForFullRefresh() { // Display-specific code can go here #if defined(PRIVATE_HW) #else // Otherwise: adafruitDisplay->setFullWindow(); #endif } bool EInkDisplay::newImageMatchesOld() { uint32_t newImageHash = 0; // Generate hash: sum all bytes in the image buffer for (uint16_t b = 0; b < (displayWidth / 8) * displayHeight; b++) { newImageHash += buffer[b]; } // Compare hashes bool hashMatches = (newImageHash == prevImageHash); // Update the cached hash prevImageHash = newImageHash; // Return the comparison result return hashMatches; } // Change between partial and full refresh config, or skip update, balancing urgency and display health. bool EInkDisplay::determineRefreshMode() { uint32_t now = millis(); uint32_t sinceLast = now - lastUpdateMsec; // If rate-limiting dropped a high-priority update: // promote this update, so it runs ASAP if (missedHighPriorityUpdate) { isHighPriority = true; missedHighPriorityUpdate = false; } // Abort: if too soon for a new frame if (isHighPriority && partialRefreshCount > 0 && sinceLast < highPriorityLimitMsec) { LOG_DEBUG("Update skipped: exceeded EINK_HIGHPRIORITY_LIMIT_SECONDS\n"); missedHighPriorityUpdate = true; return false; } if (!isHighPriority && sinceLast < lowPriorityLimitMsec) { return false; } // Check if old image (partial) should be redrawn (as full), for image quality if (partialRefreshCount > 0 && !isHighPriority) needsFull = true; // If too many partials, require a full-refresh (display health) if (partialRefreshCount >= partialRefreshLimit) needsFull = true; // If image matches if (newImageMatchesOld()) { // If low priority: limit rate // otherwise, every loop() will run the hash method if (!isHighPriority) lastUpdateMsec = now; // If update is *not* for display health or image quality, skip it if (!needsFull) return false; } // Conditions assessed - not skipping - load the appropriate config // If options require a full refresh if (!isHighPriority || needsFull) { if (partialRefreshCount > 0) configForFullRefresh(); LOG_DEBUG("Conditions met for full-refresh\n"); partialRefreshCount = 0; needsFull = false; } // If options allow a partial refresh else { if (partialRefreshCount == 0) configForPartialRefresh(); LOG_DEBUG("Conditions met for partial-refresh\n"); partialRefreshCount++; } lastUpdateMsec = now; // Mark time for rate limiting return true; // Instruct calling method to continue with update } #endif // End USE_EINK_DYNAMIC_PARTIAL #endif