E-Ink / E-Paper
Interfacing GDEW0154 E-Ink / E-Paper with Raspberry Pi
What is the GDEW0154?
GDEW0154 practical reference
The GDEW0154 is a 200×200 pixel, 1.54-inch e-paper panel that holds its last image with zero power draw — only refreshing (which takes ~1-2 seconds and briefly flashes black/white) actually uses current. That makes it a natural fit for battery-powered badges, price tags, and status signs that update rarely.
It's a partial-refresh-capable panel over SPI, driven almost universally through Jean-Marc Zingg's GxEPD2 library on Arduino-family boards, which abstracts away the panel's row/column update sequencing.
Key specifications
- Resolution: 200 × 200 pixels, monochrome (black/white)
- Operating voltage: 3.3V
- Interface: SPI
- Full refresh time: ~1-2 seconds, visible black/white flash
- Power draw when static: ~0 (image persists with no power)
Pinout and connection notes
This panel is 3.3V logic only - do not feed it 5V on VCC even on 5V boards like the Uno, or you risk damaging the panel. BUSY must be checked (the library handles this for you) before starting a new update; writing mid-refresh corrupts the image.
- VCC: Power, 3.3V
- GND: Ground
- DIN: SPI data in (MOSI)
- CLK: SPI clock (SCK)
- CS: SPI chip select
- DC: Data/command select
- RST: Reset, active low
- BUSY: Goes high during a refresh - poll or interrupt on this before sending new data
Integration checklist
- Confirm the exact part number and breakout-board revision.
- Verify supply voltage, current demand, logic levels, and signal direction against the datasheet.
- Check controller pin assignments and bus address or interface mode against the example code.
- Power up with external loads disconnected, then test signals before full integration.
- If readings or communication fail, check power and ground first, then pin mapping, interface settings, and library initialization.
Troubleshooting and reproducibility
Record the board used, wiring, library/version, supply arrangement, and measured behavior. Use the selected board-specific wiring example as the source of truth. Never assume visually similar modules share identical voltage tolerance or pin order.
Setting Up GDEW0154 with Raspberry Pi
Library
Waveshare epd1in54 by Waveshare
sudo raspi-config # Interface Options -> SPI -> Enable, then reboot pip3 install waveshare-epd Pillow
Wiring
| Component pin | Raspberry Pi pin | Note |
|---|---|---|
| VCC | Pin 1 (3.3V) | |
| GND | Pin 6 (GND) | |
| DIN | GPIO10 (MOSI, Pin 19) | |
| CLK | GPIO11 (SCK, Pin 23) | |
| CS | GPIO8 (CE0, Pin 24) | |
| DC | GPIO25 (Pin 22) | |
| RST | GPIO17 (Pin 11) | |
| BUSY | GPIO24 (Pin 18) |
Swipe sideways to see every column →
- Enable SPI via
raspi-configfirst - it's off by default on Raspberry Pi OS. epd.sleep()drops the panel into low-power hold; callepd.init()again before the next update.
Related Components
Related Guides & Projects
Raspberry Pi Pico W and Pico 2 W: Install MicroPython with Thonny or UF2
Hold BOOTSEL, drag the correct UF2 file, open the REPL and blink the onboard LED. Includes the Pico vs Pico W vs Pico 2 W firmware differences and what to do when the drive does not appear.
Raspberry Pi Pico W Web Server in MicroPython: Control an LED and Read a Sensor
Connect the Pico W to WiFi, serve a responsive control page, switch an LED and display the onboard temperature or an external sensor, with timeouts and reconnect handling.
Raspberry Pi Pico Oscilloscope with MicroPython
Convert a Raspberry Pi Pico into a basic 500 kSPS oscilloscope using its 12-bit ADC and MicroPython. Displays waveforms on an SSD1306 OLED or streams samples over USB serial to a Python plotter on your PC.
Self-Hosted Nextcloud NAS on Raspberry Pi 4
Build a private, durable Nextcloud NAS on a Raspberry Pi 4 -- SSD boot instead of a failure-prone SD card, Docker Compose with Redis caching, Tailscale for remote access with zero ports forwarded, and an automated backup strategy that actually runs.