FrameOSWaveshare 2.7" (B) e-Paper
264×176 black/white/red e-ink display for FrameOS - specs, setup and driver details.
Official Waveshare store
Official store page for this device.
Manufacturer docs & datasheets
- Vendor
- Waveshare
- Model
- 2.7" (B) e-Paper
- Technology
- E-ink
- Colors
- Black / White / Red
- Resolution
- 264×176 px
- Size
- 2.7″ diagonal
- Interface
- SPI
- Platforms
- Raspberry Pi · ESP32-S3
- Status
- 🟡 Should work
- FrameOS driver
waveshare.EPD_2in7b
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 2.7" (B) e-Paper is a 2.7″ e-ink panel with a resolution of 264×176 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_2in7b) 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
- 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.
- Add a frame in the FrameOS backend and select the Waveshare 2.7" (B) 264x176 Black/White/Red driver.
- 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.