FrameOS
Devices

Waveshare 10.2" (B) e-Paper

960×640 black/white/red e-ink display for FrameOS - specs, setup and driver details.

Illustration

Waveshare 10.2" (B) e-Paper

Vendor
Waveshare
Model
10.2" (B) e-Paper
Technology
E-ink
Colors
Black / White / Red
Resolution
960×640 px
Size
10.2″ diagonal
Interface
SPI
Platforms
Raspberry Pi · ESP32-S3
Status
🟡 Should work
FrameOS driver
waveshare.EPD_10in2b

Part of the FrameOS device database. Spotted an error, or tested this panel? Edit this page on GitHub - it's a markdown file.

The Waveshare 10.2" (B) e-Paper is a 10.2″ e-ink panel with a resolution of 960×640 pixels showing black, white and red. Panels with an accent ink run a multi-pass refresh that takes roughly 15-30 seconds, so they suit art, calendars and dashboards that update every few minutes rather than every second. Like all e-paper, it keeps the last image with zero power - the frame only wakes up to render.

How it works

FrameOS ships a native Nim driver (waveshare.EPD_10in2b) compiled straight into the binary that runs on your Raspberry Pi - no Python, no vendor libraries. Each render pass draws your scene into a full-color image, dithers it to the panel's palette, and pushes the result to the display over SPI.

Setup

  1. Connect the panel to the Raspberry Pi - plug the HAT onto the GPIO header, or hook up the separate driver board with the bundled ribbon cable.
  2. Add a frame in the FrameOS backend and select the Waveshare 10.2" (B) 960x640 Black/White/Red driver.
  3. Save & deploy. The panel blinks through a refresh cycle and shows your scene.

Make sure the letter suffix on your panel's ribbon cable matches the driver - Waveshare reuses product names across revisions. More tips in the Waveshare buying guide.

Status

🟡 Should work, not yet confirmed on real hardware. The driver shares its controller logic with panels that are confirmed working. If you have this display, tell us on GitHub or Discord and we'll mark it confirmed.

On this page