Code Monkey home page Code Monkey logo

gxepd's Introduction

GxEPD

A simple E-Paper display library with common base class and separate IO class for Arduino.

For SPI e-paper displays from Dalian Good Display

and SPI e-paper boards from Waveshare

important note :

- these displays are for 3.3V supply and 3.3V data lines

- never connect data lines directly to 5V Arduino data pins, you may use e.g. 4k7 series resistor

- do not forget to connect GND

Paged Drawing, Picture Loop for AVR

- This library uses paged drawing to cope with RAM restriction and missing single pixel update support

- Paged drawing is implemented using callbacks to callback functions in the user application code,

- the picture loop is internal to the display classes and calls the callback function as many times as needed,

- this is a different implementation compared to the picture loop in U8G2 (Oliver Kraus)

The E-Paper display base class is a subclass of Adafruit_GFX, to have graphics and text rendering.

It needs up to 30kB available RAM to buffer the black/white image for the SPI displays. ESP8266 or STM32 systems have just enough free RAM, e.g. Arduino Due, ESP8266 or STM32. I use it with Wemos D1 mini, STM32F103RB-Nucleo, and STMF103C8T6 (BluePill) systems.

  • Paged Drawing is available to cope with RAM restriction on AVR processors.

Supporting Arduino Forum Topics:

Initial support is for E-Paper displays from Dalian Good Display Inc. with SPI:

These display can be connected using the DESTM32-S2 connection board to power and SPI.

  • GDEW042T2 4.2 inch 400 x 300 pixel black/white
  • GDEW075T8 7.5 inch 640 x 384 pixel black/white
  • Added GDEP015OC1 1.54 inch 200 x 200 pixel black/white
  • Added GDEW027C44 2.7 inch 176 x 264 pixel black/white/red
  • Added example IoT_SHT31LP_Example_1.54inchEPD
  • Added GDE0213B1 2.13 inch 128 x 250 pixel black/white
  • Added GDEH029A1 2.9 inch 128 x 296 pixel black/white

The following classes can be used with Waveshare e-Paper displays:

  • The GxGDEP015OC1 class can be used with Waveshare 1.54inch e-Paper SPI display.
  • The GxGDE0213B1 class can be used with Waveshare 2.13inch e-Paper SPI display.
  • The GxGDEH029A1 class can be used with Waveshare 2.9inch e-Paper SPI display.
  • The GxGDEW042T2 class can be used with Waveshare 4.2inch e-Paper SPI display.
  • The GxGDEW027C44 class may be usable with the Waveshare 264x176 2.7inch 3 color E-Ink display.

Support for partial update and paged drawing (AVR, low RAM).

  • To use on AVR (UNO, NANO) Arduino IDE 1.8.x is required (optimizing linker) for code space.

mapping suggestion from Waveshare SPI 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 suggestion from Waveshare SPI e-Paper to ESP8266 NodeMCU:

  • BUSY -> D2, RST -> D4, DC -> D3, CS -> D8, CLK -> D5, DIN -> D7, GND -> GND, 3.3V -> 3.3V

mapping suggestion from Waveshare SPI e-Paper to generic ESP8266:

  • BUSY -> GPIO4, RST -> GPIO2, DC -> GPIO0, CS -> GPIO15, CLK -> GPIO14, DIN -> GPIO13, GND -> GND, 3.3V -> 3.3V

mapping suggestion (by G6EJD) from Waveshare SPI e-Paper to ESP8266 Huzzah:

  • BUSY -> 03, RST -> 15, DC -> 02, CS -> 00, CLK -> 14, DIN -> 13, GND -> GND, 3.3V -> 3.3V

new mapping suggestion for STM32F1, e.g. STM32F103C8T6 "BluePill"

  • BUSY -> A1, RST -> A2, DC -> A3, CS-> A4, CLK -> A5, DIN -> A7

mapping example for AVR, UNO, NANO etc.:

  • BUSY -> 7, RST -> 9, DC -> 8, C S-> 10, CLK -> 13, DIN -> 11

Added classes for Waveshare and Good Display black / white / red SPI e-Paper displays:

  • GxGDEW0154Z04 1.54 inch 200 x 200 3 color SPI display
  • GxGDEW0213Z16 2.13 inch 104 x 212 3 color SPI display
  • GxGDEW029Z10 2.9 inch 128 x 296 3 color SPI display

Added Fast Partial Update variant GxGDEW042T2_FPU for 4.2 inch black/white display

  • NOTE: This Fast Partial Update variant works with an experimental partial update waveform table
  • Side effects and life expectancy with this LUT are unknown, as it is NOT from the manufacturer!

Added Support for multiple e-paper displays on one Arduino (with enough RAM, e.g. ESP32)

Added GxGDEW042Z15 display class for 4.2inch 400 x 300 black / white / red e-Paper

  • The display class supports partial update, but display update is full screen (controller issue)

Added GxGDEW027W3 display class for 2.7inch 264 x 176 black / white e-Paper

Version 2.3.14

  • added GxEPD_SD_BitmapExample

Version 2.3.13

  • added "no BUSY" support to GxGDEP015OC1 for Heltec E-Paper 1.54" b/w without BUSY
  • set BUSY parameter to -1 for Heltec E-Paper 1.54" b/w without BUSY

Version 2.3.12

  • added GxGDEW0583T7 for 5.83" b/w 600x448 display
  • my GDEW0583T7 panel has a refresh time of ~15 seconds
  • please report if you got this display with faster refresh time, or got faster driver or demo

Version 2.3.11

  • fix GxGDEW042T2 to avoid double full refresh after reset (deep sleep wakeup)

Version 2.3.10

  • added GxGDEW0154Z17 for 1.54" 3-color 152x152 display
  • NOT tested on GDEW0154Z17, I don't have this display
  • tested on 2.9" 3-color display, same controller IL0373
  • use GxEPD_RED to get yellow on yellow 3-color e-paper

Version 2.3.9

  • new version for 7.5" 3-color display GxGDEW075Z09
  • GxGDEW075Z09 runs with full buffer on ESP32, Arduino Due, STM32F4
  • runs with reduced buffer on ESP8266, STM32F1, AVR : will show buffer content as stripes
  • supports paged display on AVR, ESP8266, STM32F1

Version 2.3.8

  • Serial Diagnostic Output selectable by parameter of init() call:
  • void init(uint32_t serial_diag_bitrate = 0); // = 0 : disabled

Version 2.3.7

Version 2.3.6

  • fixes and cleanup

Version 2.3.5

  • GxFont_GFX : Font Rendering Graphics Switch and Bridge Class

For HD E-Paper displays from Dalian Good Display Inc. with parallel interface.

  • GDE060BA 6 inch 800 x 600 pixel 4 gray level
  • GDEW080T5 8 inch 1024 x 768 pixel 4 gray level

These display can be used with the red DESTM32-L evaluation board, it has 1MB FSMC SRAM on board.

The library classes for these display can be used with the STM32GENERIC package for Arduino IDE.

  • Added GxGDE043A2 4.3 inch 800 x 600 pixel 4 gray level, with unresolved degradation issue

gxepd's People

Contributors

brettcvz avatar bytecrusher avatar noobidoo avatar zinggjm avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.