GxEPD2_583.h 4.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172
  1. // Display Library for SPI e-paper panels from Dalian Good Display and boards from Waveshare.
  2. // Requires HW SPI and Adafruit_GFX. Caution: these e-papers require 3.3V supply AND data lines!
  3. //
  4. // based on Demo Example from Good Display: http://www.e-paper-display.com/download_list/downloadcategoryid=34&isMode=false.html
  5. // Controller: IL0371 : http://www.e-paper-display.com/download_detail/downloadsId=536.html
  6. //
  7. // Author: Jean-Marc Zingg
  8. //
  9. // Version: see library.properties
  10. //
  11. // Library: https://github.com/ZinggJM/GxEPD2
  12. #ifndef _GxEPD2_583_H_
  13. #define _GxEPD2_583_H_
  14. #include "../GxEPD2_EPD.h"
  15. class GxEPD2_583 : public GxEPD2_EPD
  16. {
  17. public:
  18. // attributes
  19. static const uint16_t WIDTH = 600;
  20. static const uint16_t HEIGHT = 448;
  21. static const GxEPD2::Panel panel = GxEPD2::GDEW0583T7;
  22. static const bool hasColor = false;
  23. static const bool hasPartialUpdate = true;
  24. static const bool hasFastPartialUpdate = false;
  25. static const uint16_t power_on_time = 60; // ms, e.g. 56728us
  26. static const uint16_t power_off_time = 30; // ms, e.g. 20291us
  27. static const uint16_t full_refresh_time = 15000; // ms, e.g. 14598868us
  28. static const uint16_t partial_refresh_time = 15000; // ms, e.g. 14598868us
  29. // constructor
  30. GxEPD2_583(int8_t cs, int8_t dc, int8_t rst, int8_t busy);
  31. // methods (virtual)
  32. // Support for Bitmaps (Sprites) to Controller Buffer and to Screen
  33. void clearScreen(uint8_t value = 0x33); // init controller memory and screen (default white)
  34. void writeScreenBuffer(uint8_t value = 0x33); // init controller memory (default white)
  35. // write to controller memory, without screen refresh; x and w should be multiple of 8
  36. 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);
  37. void writeImagePart(const uint8_t bitmap[], int16_t x_part, int16_t y_part, int16_t w_bitmap, int16_t h_bitmap,
  38. int16_t x, int16_t y, int16_t w, int16_t h, bool invert = false, bool mirror_y = false, bool pgm = false);
  39. 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);
  40. 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,
  41. int16_t x, int16_t y, int16_t w, int16_t h, bool invert = false, bool mirror_y = false, bool pgm = false);
  42. // write sprite of native data to controller memory, without screen refresh; x and w should be multiple of 8
  43. 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);
  44. // write to controller memory, with screen refresh; x and w should be multiple of 8
  45. 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);
  46. void drawImagePart(const uint8_t bitmap[], int16_t x_part, int16_t y_part, int16_t w_bitmap, int16_t h_bitmap,
  47. int16_t x, int16_t y, int16_t w, int16_t h, bool invert = false, bool mirror_y = false, bool pgm = false);
  48. 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);
  49. 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,
  50. int16_t x, int16_t y, int16_t w, int16_t h, bool invert = false, bool mirror_y = false, bool pgm = false);
  51. // write sprite of native data to controller memory, with screen refresh; x and w should be multiple of 8
  52. 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);
  53. void refresh(bool partial_update_mode = false); // screen refresh from controller memory to full screen
  54. void refresh(int16_t x, int16_t y, int16_t w, int16_t h); // screen refresh from controller memory, partial screen
  55. void powerOff(); // turns off generation of panel driving voltages, avoids screen fading over time
  56. void hibernate(); // turns powerOff() and sets controller to deep sleep for minimum power use, ONLY if wakeable by RST (rst >= 0)
  57. private:
  58. void _send8pixel(uint8_t data);
  59. void _setPartialRamArea(uint16_t x, uint16_t y, uint16_t w, uint16_t h);
  60. void _PowerOn();
  61. void _PowerOff();
  62. void _InitDisplay();
  63. void _Init_Full();
  64. void _Init_Part();
  65. void _Update_Full();
  66. void _Update_Part();
  67. };
  68. #endif