Component guide · Intermediate · 3 min read
E-Paper Displays
How They Work and Using Them with ESP32
By Geekobot Learning Team · Updated 24 Oct 2026
On this page
An e-paper (e-ink) display moves charged pigment particles to form an image, then keeps it with no power at all. It is readable in sunlight and draws current only while refreshing, which makes it ideal for battery dashboards, labels and weather stations. Refreshes are slow: about 1 to 3 seconds for a full black-and-white update, and 15 seconds or more for three-colour panels. Most modules use SPI and the GxEPD2 library.
Key specs at a glance
- Power
- Zero to hold the image; a few mA for about 1 to 3 s while refreshing
- Colours
- Black/white, black/white/red, black/white/yellow, some 7-colour
- Refresh
- Full 1 to 3 s (B/W), 15 s or more (3-colour); partial about 0.3 s on supported panels
- Interface
- SPI plus BUSY, RST, DC and CS pins
- Supply
- 3.3 V; many modules level-shift for 5 V
- Sizes
- 1.54, 2.13, 2.9, 4.2 and 7.5 inch common
Wiring and library
Connect VCC to 3.3 V, GND, DIN (MOSI), CLK (SCK), CS, DC, RST and BUSY to free GPIOs on your SPI bus. On an ESP32 the default SPI pins are MOSI 23 and SCK 18.
Install GxEPD2 and the Adafruit GFX library. Choose the exact driver class for your panel's size and controller (shown on the flex cable or listing, for example GDEY029T94); a wrong class gives a blank or garbled screen. Draw with GFX functions inside a firstPage() / nextPage() loop, then call hibernate() so the panel draws no current.
Full vs partial refresh and ghosting
A full refresh flashes the screen black and white a few times to clear old images; it is slow but clean. A partial refresh updates only part of the screen quickly with no flashing, good for a clock's digits, but repeated partial updates leave faint ghost images. Do a full refresh every 5 to 10 partial updates.
Three-colour panels do not support partial refresh and take longer. Panels also refresh more slowly in the cold and are usually rated from about 0 to 50 °C.
Battery-powered dashboards
The classic project: an ESP32 wakes from deep sleep every 15 to 60 minutes, connects to Wi-Fi, fetches weather or calendar data, updates the display, hibernates it and sleeps again. With a low-quiescent regulator and an 18650 cell, this can run for weeks or months. Use the battery life calculator to estimate it, and see lithium batteries for the cell.
Try it: Battery life calculator
Change the values and the diagram and results update as you type.
Common mistakes to avoid
- Choosing the wrong GxEPD2 driver class for the panel.
- Never calling hibernate(), leaving the panel powered.
- Partial refreshing forever without a periodic full refresh.
- Expecting video or fast animation.
- Leaving a three-colour panel in direct sun for long periods, which can fade it.
Frequently asked questions
Does an e-paper display use power when showing an image?
No. It keeps the image without power and only uses current while refreshing.
Why is my e-paper display blank?
Usually the wrong driver class in GxEPD2, wrong pins, or BUSY not connected.
Can e-paper show animation?
No. Refresh takes about a second or more, so it suits information that changes every few minutes.
What causes ghosting on e-paper?
Repeated partial refreshes. Do a full refresh every 5 to 10 updates.
Are e-paper displays readable in sunlight?
Yes, very. They reflect light like paper and need no backlight.
Parts for this guide
Calculators
Terms in this guide
Keep learning
Sources
Written by the Geekobot team from manufacturer datasheets. Always check the datasheet for the exact part and variant you buy.


