OpenDisplay

Open-source firmware and protocol standard for e-paper displays

What is OpenDisplay?

OpenDisplay is both a firmware solution and a protocol standard for e-paper displays. It provides a complete ecosystem for creating smart, low-power e-paper displays that can be easily integrated with Home Assistant and other automation platforms.

Firmware

Open-source firmware for ESP32-C3, ESP32-C6, and nRF52840 platforms. Supports a wide range of e-paper displays with flexible configuration and low power consumption.

Protocol Standard

BLE-based communication protocol with YAML-defined configuration schema. Enables interoperability between different clients and devices using a standardized interface.

Firmware

Low Power

Deep sleep support with microamp-level current consumption

BLE Communication

Bluetooth Low Energy for wireless updates and configuration

Multiple Color Schemes

B/W, B/W+Red, B/W+Yellow, 6-color, and grayscale support

Flexible Configuration

YAML-based config system with preset support

Direct Write Mode

Bufferless image transfer for efficient memory usage

Supported Platforms

ESP32-S3 ESP32-C3 ESP32-C6 nRF52840

Get Started

Web-based tools for installing firmware, testing BLE connections, building configurations, calculating battery life, and performing DFU updates.

Protocol Standard

Complete protocol documentation including BLE flow diagrams, OpenDisplay Language configuration schema, display data format specifications, and guides for adding new displays.

Layout Designer

Visual editor for designing display layouts with live preview. Generate OpenDisplay Language code for use with Home Assistant's drawcustom service.

Home Assistant Integration

Comprehensive Home Assistant integration for e-paper displays. Control devices, draw custom images, monitor status, and manage tags through Home Assistant's interface.

View the firmware source code, contribute to the project, report issues, and access technical documentation on GitHub.

Community

Join the OpenDisplay community to get help, share your projects, discuss implementations, and connect with other users and developers.

Join Discord