// Display Library for SPI e-paper panels from Dalian Good Display and boards from Waveshare. // Requires HW SPI and Adafruit_GFX. Caution: these e-papers require 3.3V supply AND data lines! // // based on Demo Example from Good Display: http://www.e-paper-display.com/download_list/downloadcategoryid=34&isMode=false.html // Controller: IL0376F : http://www.e-paper-display.com/download_detail/downloadsId=541.html // // Author: Jean-Marc Zingg // // Version: see library.properties // // Library: https://github.com/ZinggJM/GxEPD2 #ifndef _GxEPD2_154c_H_ #define _GxEPD2_154c_H_ #include "../GxEPD2_EPD.h" class GxEPD2_154c : public GxEPD2_EPD { public: // attributes static const uint16_t WIDTH = 200; static const uint16_t HEIGHT = 200; static const GxEPD2::Panel panel = GxEPD2::GDEW0154Z04; static const bool hasColor = true; static const bool hasPartialUpdate = false; static const bool hasFastPartialUpdate = false; static const uint16_t power_on_time = 20; // ms, e.g. 10157us static const uint16_t power_off_time = 20; // ms, e.g. 10157us static const uint16_t full_refresh_time = 7500; // ms, e.g. 7135635us static const uint16_t partial_refresh_time = 7500; // ms, e.g. 7135635us // constructor GxEPD2_154c(int8_t cs, int8_t dc, int8_t rst, int8_t busy); // methods (virtual) void init(uint32_t serial_diag_bitrate = 0); // = 0 : disabled // Support for Bitmaps (Sprites) to Controller Buffer and to Screen void clearScreen(uint8_t value = 0xFF); // init controller memory and screen (default white) void clearScreen(uint8_t black_value, uint8_t color_value); // init controller memory and screen void writeScreenBuffer(uint8_t value = 0xFF); // init controller memory (default white) void writeScreenBuffer(uint8_t black_value, uint8_t color_value); // init controller memory // write to controller memory, without screen refresh; x and w should be multiple of 8 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(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); // write sprite of native data to controller memory, without screen refresh; x and w should be multiple of 8 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); // write to controller memory, with screen refresh; x and w should be multiple of 8 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(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); // write sprite of native data to controller memory, with screen refresh; x and w should be multiple of 8 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); // screen refresh from controller memory to full screen void refresh(int16_t x, int16_t y, int16_t w, int16_t h); // screen refresh from controller memory, partial screen void powerOff(); // turns off generation of panel driving voltages, avoids screen fading over time void hibernate(); // turns powerOff() and sets controller to deep sleep for minimum power use, ONLY if wakeable by RST (rst >= 0) void setPaged(); // for GxEPD2_154c paged workaround private: void _writeScreenBuffer(uint8_t value); void _setPartialRamArea(uint16_t x, uint16_t y, uint16_t w, uint16_t h); void _PowerOn(); void _PowerOff(); void _InitDisplay(); void _Init_Full(); void _Init_Part(); void _Update_Full(); void _Update_Part(); protected: bool _initial, _power_is_on, _hibernating; bool _paged, _second_phase; static const uint8_t bw2grey[]; }; #endif