FrameOSWaveshare 5.84" e-Paper
768×256 black & white e-ink display for FrameOS - specs, setup and driver details.
Illustration
Waveshare 5.84" e-Paper
- Vendor
- Waveshare
- Model
- 5.84" e-Paper
- Technology
- E-ink
- Colors
- Black / White
- Resolution
- 768×256 px
- Size
- 5.84″ diagonal
- Interface
- SPI
- Platforms
- Raspberry Pi · ESP32-S3
- Status
- 🟡 Should work
- FrameOS driver
waveshare.EPD_5in84
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 5.84" e-Paper is a 5.84″ e-ink panel with a resolution of 768×256 pixels showing black and white. Two-tone e-ink has the fastest refresh of any e-paper type - a full update takes only a couple of seconds - and the high contrast works great for text, dashboards and dithered photos. 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_5in84) 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 5.84" 768x256 Black/White 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.