Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ Every Seeed ePaper product on the [main hub page](/seeed_epaper_displays) that h
<tr>
<td><strong>reTerminal E1001 / E1002 / E1003 / E1004</strong></td>
<td>XIAO ESP32-S3</td>
<td><a href="/reterminal_e10xx_with_esphome">Basic</a> · <a href="/reterminal_e10xx_with_esphome_advanced">Advanced (peripherals)</a></td>
<td><a href="/reterminal_e10xx_with_esphome">Display</a> · <a href="/reterminal_e10xx_with_esphome_advanced">I/O & power</a> · <a href="/reterminal_e10xx_with_esphome_rtc_sd_microphone">RTC, SD & mic</a></td>
</tr>
<tr>
<td><strong>EE04 driver board</strong></td>
Expand Down Expand Up @@ -193,8 +193,9 @@ You can now drag the entities into a Lovelace dashboard, or — much more intere

This page intentionally stops at the boilerplate. The product-specific YAML, peripheral examples, and end-to-end recipes live in each product's cookbook:

- **[reTerminal E Series — Basic ESPHome](/reterminal_e10xx_with_esphome)** — first dashboard, Wi-Fi setup, pre-built firmware ZIP for E1001/E1002/E1003/E1004.
- **[reTerminal E Series — Advanced ESPHome](/reterminal_e10xx_with_esphome_advanced)** — buttons, buzzer, battery monitoring, SHT4x sensor, deep sleep, multi-page dashboards.
- **[reTerminal E Series — ESPHome Display](/reterminal_e10xx_with_esphome)** — first dashboard, Wi-Fi setup, pre-built firmware ZIP, and ePaper drawing examples for E1001/E1002/E1003/E1004.
- **[reTerminal E Series — ESPHome I/O, Battery & Power](/reterminal_e10xx_with_esphome_advanced)** — buttons, buzzer, onboard LED, battery monitoring, SHT4x sensor, deep sleep, and multi-page dashboards.
- **[reTerminal E1001 / E1002 — ESPHome RTC, SD & Microphone](/reterminal_e10xx_with_esphome_rtc_sd_microphone)** — PCF8563 RTC time sync, microSD card power/detect pins, and onboard PDM microphone setup.
- **[EE04 driver board — ESPHome](/EE04_with_esphome_advanced)** — full Home Assistant integration on the XIAO ESP32-S3 + EE04 + your choice of ePaper screen.
- **[XIAO 7.5" ePaper Panel — ESPHome](/xiao_075inch_epaper_panel_esphome)** — minimal ESP32-C3 dashboard.
- **[TRMNL 7.5" DIY Kit — ESPHome](/ogdiy_kit_works_with_esphome)** — using the kit hardware with ESPHome instead of the TRMNL cloud platform.
Expand All @@ -217,7 +218,7 @@ When new ePaper products ship, the corresponding cookbook is added under each pr

### Battery drains faster than expected

ePaper only saves power when the rest of the SoC is also asleep. Add a `deep_sleep` block (see the Advanced cookbook for your product) and lower the `update_interval`.
ePaper only saves power when the rest of the SoC is also asleep. Add a `deep_sleep` block (see the I/O, battery, and low-power cookbook for your product) and lower the `update_interval`.

For deeper troubleshooting on a specific product, check the cookbook for that hardware.

Expand Down
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
description: ESPHome cookbook for reTerminal E1001 / E1002 / E1003 / E1004 - Basic Home Assistant integration, first dashboard, Wi-Fi setup, pre-built firmware ZIP.
title: ESPHome Cookbook - Basic (reTerminal E Series)
description: ESPHome display cookbook for reTerminal E1001 / E1002 / E1003 / E1004 - Home Assistant integration, first dashboard, Wi-Fi setup, pre-built firmware ZIP, and ePaper drawing examples.
title: ESPHome Cookbook - Display Basics (reTerminal E Series)
image: https://files.seeedstudio.com/wiki/reterminal_e10xx/img/44.webp
slug: /reterminal_e10xx_with_esphome
aliases:
- /reterminal_e10xx_esphome
sku: 100017057,100073581
sidebar_position: 3
sidebar_label: ESPHome (Basic)
sidebar_label: ESPHome - Display
last_update:
date: 04/28/2026
author: Citric
Expand All @@ -19,10 +19,10 @@ url: https://wiki.seeedstudio.com/reterminal_e10xx_with_esphome/
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# ESPHome Cookbook - Basic: reTerminal E Series
# ESPHome Cookbook - Display Basics: reTerminal E Series

:::tip Read the main ESPHome guide first
This page is the **reTerminal E Series-specific ESPHome cookbook (basic)**. The shared boilerplate — picking a flashing path, the generic YAML skeleton, connecting to Home Assistant — lives in **[Work with ESPHome](/epaper_work_with_esphome)**. Skim that first if you're new to ESPHome on Seeed ePaper. For onboard-peripheral examples (buttons, buzzer, battery, SHT4x, deep sleep), see the [Advanced cookbook](/reterminal_e10xx_with_esphome_advanced).
This page is the **reTerminal E Series-specific ESPHome display cookbook**. The shared boilerplate — picking a flashing path, the generic YAML skeleton, connecting to Home Assistant — lives in **[Work with ESPHome](/epaper_work_with_esphome)**. Skim that first if you're new to ESPHome on Seeed ePaper. For buttons, buzzer, LED, battery, SHT4x, and deep sleep, see the [I/O, battery, and low-power cookbook](/reterminal_e10xx_with_esphome_advanced). For RTC, microSD card detect, and microphone setup, see the [RTC, SD card, and microphone cookbook](/reterminal_e10xx_with_esphome_rtc_sd_microphone).
:::

<div style={{textAlign:'center'}}><img src="https://files.seeedstudio.com/wiki/reterminal_e10xx/img/44.jpg" style={{width:700, height:'auto'}}/></div><br />
Expand Down Expand Up @@ -969,7 +969,10 @@ By combining images with text and other display elements covered in previous exa

## Continue Reading

Due to space constraints, this article only covers some basic use cases and drawing examples of the device. We will cover the use of reTerminal's hardware on ESPHome in more detail in the [Advanced ESPHome Usage of reTerminal E Series ePaper Display in Home Assistant](https://wiki.seeedstudio.com/reterminal_e10xx_with_esphome_advanced)'s Wiki, which you can read on.
This article focuses on connecting the display and drawing content on the ePaper screen. Continue with these ESPHome cookbooks when you want to use the rest of the onboard hardware:

- **[ESPHome Cookbook: Buttons, Buzzer, LED, Battery & Low Power](/reterminal_e10xx_with_esphome_advanced)** - user buttons, buzzer feedback, onboard LED, battery monitoring, SHT4x sensor, deep sleep, and multi-page dashboards.
- **[ESPHome Cookbook: RTC, SD Card & Microphone](/reterminal_e10xx_with_esphome_rtc_sd_microphone)** - PCF8563 RTC time sync, microSD card power/detect pins, and onboard PDM microphone initialization.

## FAQ

Expand All @@ -991,6 +994,15 @@ In this case, you should go to Settings -> Devices & Services -> Integrations to

Try unplugging and replugging it several times, or just install the driver according to the prompts.

### Q4: Why is there no serial log over USB?

The reTerminal E Series uses a CH340K USB-to-UART bridge on UART0. Keep this logger setting in your YAML:

```yaml
logger:
hardware_uart: UART0
```

## Tech Support & Product Discussion

Thank you for choosing our products! We are here to provide you with different support to ensure that your experience with our products is as smooth as possible. We offer several communication channels to cater to different preferences and needs.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
description: ESPHome cookbook for reTerminal E1001 / E1002 / E1003 / E1004 - Advanced peripherals (buttons, buzzer, battery monitoring, SHT4x sensor, deep sleep, multi-page dashboards).
title: ESPHome Cookbook - Advanced (reTerminal E Series)
description: ESPHome cookbook for reTerminal E1001 / E1002 / E1003 / E1004 - buttons, buzzer, onboard LED, battery monitoring, SHT4x sensor, deep sleep, and multi-page dashboards.
title: 'ESPHome Cookbook: Buttons, Buzzer, LED, Battery & Low Power (reTerminal E Series)'
image: https://files.seeedstudio.com/wiki/reterminal_e10xx/img/27.webp
slug: /reterminal_e10xx_with_esphome_advanced
sidebar_position: 4
sidebar_label: ESPHome (Advanced)
sidebar_label: 'ESPHome - I/O, Battery & Power'
last_update:
date: 04/28/2026
author: Citric
Expand All @@ -16,15 +16,15 @@ url: https://wiki.seeedstudio.com/reterminal_e10xx_with_esphome_advanced/
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# ESPHome Cookbook - Advanced: reTerminal E Series
# ESPHome Cookbook: Buttons, Buzzer, LED, Battery & Low Power (reTerminal E Series)

:::tip Prerequisites
This page assumes you've already worked through the [Basic ESPHome cookbook for reTerminal E Series](/reterminal_e10xx_with_esphome) (device on Wi-Fi, Home Assistant integration online, first dashboard rendered). For the platform-level YAML skeleton and Home Assistant integration steps, see [Work with ESPHome](/epaper_work_with_esphome).
This page assumes you've already worked through the [ESPHome display cookbook for reTerminal E Series](/reterminal_e10xx_with_esphome) (device on Wi-Fi, Home Assistant integration online, first dashboard rendered). For the platform-level YAML skeleton and Home Assistant integration steps, see [Work with ESPHome](/epaper_work_with_esphome). For RTC, microSD card detect, and microphone setup, see [ESPHome Cookbook: RTC, SD Card & Microphone](/reterminal_e10xx_with_esphome_rtc_sd_microphone).
:::

<div style={{textAlign:'center'}}><img src="https://files.seeedstudio.com/wiki/reterminal_e10xx/img/27.jpg" style={{width:700, height:'auto'}}/></div><br />

This article explores advanced ESPHome configurations for your reTerminal E Series ePaper Display device, building upon the foundational concepts covered in our [Basic ESPHome Usage guide](https://wiki.seeedstudio.com/reterminal_e10xx_with_esphome). If you're new to ESPHome or the reTerminal E Series, we recommend starting with the basic guide before diving into these advanced applications.
This article covers the onboard I/O and power-related ESPHome configurations for your reTerminal E Series ePaper Display device, building upon the foundational concepts covered in our [ESPHome display cookbook](https://wiki.seeedstudio.com/reterminal_e10xx_with_esphome). If you're new to ESPHome or the reTerminal E Series, we recommend starting with the display guide before using these hardware examples.

## Hardware Capabilities

Expand Down Expand Up @@ -207,11 +207,11 @@ logger:
# Enable Home Assistant API
api:
encryption:
key: "m+rOiVDwjdvePoiG1zritvcD0Kl/a2zmsnuG+4IfWlw="
key: "REPLACE_WITH_YOUR_API_KEY"

ota:
- platform: esphome
password: "710fecea969062a5775b287a54f3c0f5"
password: "REPLACE_WITH_YOUR_OTA_PASSWORD"

wifi:
ssid: !secret wifi_ssid
Expand All @@ -220,7 +220,7 @@ wifi:
# Enable fallback hotspot (captive portal) in case wifi connection fails
ap:
ssid: "Reterminal-E10Xx"
password: "tRc2fXaYE54Q"
password: "ChangeMe123"

captive_portal:

Expand Down Expand Up @@ -645,11 +645,11 @@ logger:
# Enable Home Assistant API
api:
encryption:
key: "g93yP72UIyVsz9WfffaDMK+JeIQYROIFRK+VIQjkM+g="
key: "REPLACE_WITH_YOUR_API_KEY"

ota:
- platform: esphome
password: "1ff187393ee444aa2e892779dc78e488"
password: "REPLACE_WITH_YOUR_OTA_PASSWORD"

wifi:
ssid: !secret wifi_ssid
Expand All @@ -658,7 +658,7 @@ wifi:
# Enable fallback hotspot (captive portal) in case wifi connection fails
ap:
ssid: "reTerminal-E1001"
password: "yoUkaGlJaDpC"
password: "ChangeMe123"

captive_portal:

Expand Down Expand Up @@ -967,11 +967,11 @@ logger:
# Enable Home Assistant API
api:
encryption:
key: "g93yP72UIyVsz9WfffaDMK+JeIQYROIFRK+VIQjkM+g="
key: "REPLACE_WITH_YOUR_API_KEY"

ota:
- platform: esphome
password: "1ff187393ee444aa2e892779dc78e488"
password: "REPLACE_WITH_YOUR_OTA_PASSWORD"

wifi:
ssid: !secret wifi_ssid
Expand All @@ -980,7 +980,7 @@ wifi:
# Enable fallback hotspot (captive portal) in case wifi connection fails
ap:
ssid: "reTerminal-E1002"
password: "yoUkaGlJaDpC"
password: "ChangeMe123"

captive_portal:

Expand Down Expand Up @@ -1316,6 +1316,15 @@ Step 4. Finally, replug the cable and upload a new program. -->

In this case, your device is either offline or in deep sleep mode. Please ensure it's connected to your network or wake it up from sleep mode before attempting to upload.

### Q4: Why is there no serial log over USB?

The reTerminal E Series uses a CH340K USB-to-UART bridge on UART0. Keep this logger setting in your YAML:

```yaml
logger:
hardware_uart: UART0
```

## Tech Support & Product Discussion

Thank you for choosing our products! We are here to provide you with different support to ensure that your experience with our products is as smooth as possible. We offer several communication channels to cater to different preferences and needs.
Expand Down
Loading
Loading