| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677 |
- // Display Library for SPI e-paper panels from Dalian Good Display and boards from Waveshare.
- // Requires HW SPI and Adafruit_GFX. Caution: the e-paper panels require 3.3V supply AND data lines!
- //
- // based on Demo Example from Waveshare: https://github.com/waveshareteam/e-Paper/tree/master/Arduino/epd3in0g
- // Panel: 3inch 4-Color E-Paper : https://www.waveshare.com/product/displays/e-paper/3inch-e-paper-module-g.htm
- // Controller: unknown
- //
- // Author: Jean-Marc Zingg
- //
- // Version: see library.properties
- //
- // Library: https://github.com/ZinggJM/GxEPD2
- #ifndef _GxEPD2_300c_H_
- #define _GxEPD2_300c_H_
- #include "../GxEPD2_EPD.h"
- class GxEPD2_300c : public GxEPD2_EPD
- {
- public:
- // attributes
- static const uint16_t WIDTH = 168;
- static const uint16_t WIDTH_VISIBLE = WIDTH;
- static const uint16_t HEIGHT = 400;
- static const GxEPD2::Panel panel = GxEPD2::Waveshare3inch4color;
- static const bool hasColor = true;
- static const bool hasPartialUpdate = true;
- static const bool hasFastPartialUpdate = false;
- static const uint16_t power_on_time = 600; // ms, e.g. 574001us
- static const uint16_t power_off_time = 50; // ms, e.g. 41000us
- static const uint16_t full_refresh_time = 13000; // ms, e.g. 12358001us
- static const uint16_t partial_refresh_time = 13000; // ms, e.g. 12358001us
- // constructor
- GxEPD2_300c(int16_t cs, int16_t dc, int16_t rst, int16_t busy);
- // methods (virtual)
- // 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 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 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);
- // 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);
- void writeNativePart(const uint8_t* data1, const uint8_t* data2, 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);
- // 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 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 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);
- // 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, also for 4-color for use with hasPartialUpdate = false
- private:
- void _refresh(bool partial_update_mode);
- void _setPartialRamArea(uint16_t x, uint16_t y, uint16_t w, uint16_t h, bool partial_mode = true);
- void _PowerOn();
- void _PowerOff();
- void _InitDisplay();
- private:
- bool _paged;
- };
- #endif
|