This repository contains all the code and dashboard configurations used on my ReTerminal E1002 colour epaper display, running ESPHome and displaying dashboards from Home Assistant.
esphome.yaml contains the ESPHome code for the ReTerminal E1002. This code is based on ESPHome version 2025.11.X.
hass-dashboard.yaml contains the full raw dashboard used in Home Assistant.
e1002-automation.yaml includes a sample automation to select the page to display + notify on low battery.
/images/wallpaper-sample.webp is my own photo.
ESPHome minimum version is 2025.11.0, as this implemented the display model for the E1002.
The dashboard relies on the following custom cards, together with cardmod to optimise for the epaper display:
custom:clock-weather-card
custom:mushroom-template-card
custom:bubble-card
custom:calendar-card-pro
custom:mushroom-chips-card
custom:flower-card
The wallpaper is just a picture card with a sample uploaded. On my personal setup I use immich-kiosk to allow a single URL to display dynamic content from my Immich photo library.
The ESPHome code requires running the Puppet Addon version 2.4.0 or above to generate the screenshots and convert them to the right colours for the epaper to display. Specifically, it relies on pull request #25 and pull request #37, as these implement the required functionality for dithering and display colour mapping. These were fully implemented in version 2.4.0.
Home page
Wallpaper page
Energy
Plants
After a couple of months "live", I can comment on the actual battery life.
With the overnight deep sleep and 60 minutes between updates (as exists in this repo's esphome.yaml) I can get a full month out of the battery.
In my personal device I have the updates every 45 minutes (with a long deep sleep overnight) and I get around 25 days out of the battery.