OpenDisplay Firmware

Getting Started

Follow these steps to get your e-paper display up and running:

Install & Configure - Use the Toolbox to flash OpenDisplay firmware to your device and configure device settings. Select your device type (ESP32-S3, ESP32-C3, ESP32-C6, or NRF52840) and follow the installation instructions. Premade configurations are automatically selected after installation for popular device models (Seeed EN04, EE04, XIAO breakout boards, etc.) and can be applied with a single button click. You can also customize settings including display dimensions, color scheme, and other parameters.
Display - Use the BLE Tester to upload images and test your display. You can upload images, preview them, and send them directly to your e-paper display.

Home Assistant Integration

This firmware is fully compatible with the OpenDisplay Home Assistant Integration. Unlike AP-based setups, this BLE firmware does not require an access point. It only needs active BLE proxies (such as ESPHome Bluetooth proxies) to communicate with Home Assistant. This makes setup simpler and more flexible, allowing direct communication between your Home Assistant instance and your e-paper displays via Bluetooth Low Energy.

Learn more about the integration's features, entities, services, and installation in the Home Assistant Integration documentation.

Toolbox - Install & Configure

All-in-one toolbox for OpenDisplay firmware management. Install firmware directly to your device through your web browser (supports ESP32-S3, ESP32-C3, ESP32-C6, and NRF52840) and configure device settings in a single workflow. Premade configurations are automatically selected after installation for popular device models (Seeed EN04, EE04, XIAO breakout boards, etc.) and can be applied with a single button click. You can also customize settings including display dimensions, color scheme, and other parameters. This tool supports all Seeed Studio devices and breakout boards and some Waveshare devices.

Open Toolbox

BLE Tester

Test and upload images to your OpenDisplay device via BLE. Upload images, preview them on a canvas, and send them directly to your e-paper display. Supports various color schemes including monochrome, B/W + Red, B/W + Yellow, and multi-color modes.

BLE Tester

Battery Life Calculator

Calculate the expected battery life of your e-paper display based on battery capacity, standby current, update energy consumption, and update frequency. Load configuration values directly from BLE devices or preset configurations. Visualize consumption breakdown with interactive charts.

Calculator

Adding New Displays Guide

Step-by-step guide on how to add support for new display panels to the OpenDisplay firmware. Learn how to find existing displays, add new panel types, implement firmware support, create preset configurations, test your implementation, and measure power consumption.

View Guide

Seeed Display Compatibility

Check compatibility information for Seeed Studio ePaper displays with OpenDisplay Firmware. View detailed compatibility status, resolution information, partial refresh support, and setup notes for various Seeed Studio display models.

View Compatibility

⚠️ Important: OpenDisplay Firmware Only

These tools are designed specifically for the OpenDisplay firmware, not the ATC_BLE firmware. If your Bluetooth device name starts with "ATC", you should use the ATC_BLE Image Upload tool instead.