reTerminal E Series ePaper Display Work with ESPHome for Home Assistant | Seeed Studio Wiki

[giscus[bot]]

reTerminal E Series ePaper Display Work with ESPHome for Home Assistant | Seeed Studio Wiki

This article describes how to get the reTerminal E Series ePaper Display to work with Home Assistant and ESPHome.

https://wiki.seeedstudio.com/reterminal_e10xx_with_esphome/

[Japerre]

It took me quite a long time to figure out that the reTerminal E should be turned on before hitting install 🤦‍♂️. Might be good to note this in the guide ;).

[nfs0619]

Thank you for your feedback! We really appreciate you taking the time to share your experience. We’ll take your suggestion into consideration when reviewing our documentation in the future. If you run into any issues while using the product, please feel free to reach out to our technical support team at [email protected].

[noclue]

To view logs over the USB connection on e1002 I had to use the following:

logger:
  hardware_uart: UART0

This is apparent from the Arduino example that configures the UART0 pins for logging.

The ESPHome default UART for ESP32 S3 is USB_SERIAL_JTAG. That is not correct for the e1002 (See https://esphome.io/components/logger/)

[nfs0619]

Thank you for your comment. On the e1001/e1002 boards, due to the hardware design the USB port is connected via a CH340 USB-to-UART bridge to UART0 instead of the default USB_SERIAL_JTAG. This allows the CH340 to control the EN/BOOT pins so the board can automatically enter flashing mode over USB without pressing any buttons. Because of this, using Serial will not show any output and you need to use Serial1.

[WarC0zes]

Hi,
with ESPHome 2025.11.0, the E1002 model is now supported in the epaper_spi component.
Use this code :

display:
  - platform: epaper_spi
    id: epaper_display
    model: Seeed-reTerminal-E1002
    update_interval: never

No need to specify the pins.
https://esphome.io/components/display/epaper_spi/

[Allen-Kuang]

It's great! Thank you for you feedback and we will update our wiki

[jdtimothy]

I think something has changed with the last ESPHome update, none of these tutorials make anything display on the screen. I did notice for text now you have to use the "it.printf()" instead of just "print". I cannot get shapes to render, and the online image code causes the reTerminal e1002 to bootloop or remain in a crashed state constantly (however, I can still flash a new firmware over wifi while it is in this state)