Smart Home Control Panel — Deployment Guide

AI Assistance

Need help choosing hardware, or ready to deploy?

Prefer not to manually configure devices or enter commands? Let AI Assistant size hardware based on your site setup, or run one-click script deployment once ready.

Self-service Consult & Deploy
Preset

E-paper Smart Home Panel

Connect the E1003 e-paper panel via USB and integrate it into Home Assistant. The installer downloads and flashes the panel firmware, sets up or connects to your Home Assistant host, and automatically links the panel for smart home control.

Note: Ensure the reTerminal E1003 panel is connected via USB. The flashing step downloads and installs the firmware directly from the CDN.

1

Install E1003 panel firmware

Select your serial port, click Deploy, and wait for firmware installation and reboot verification to complete.

Flashing

  1. Select the serial port corresponding to the connected E1003 device.
  2. Click Install / Deploy. The installer downloads the factory firmware from the CDN and flashes it to the panel at 115200 baud.
  3. Keep the device connected until flashing and post-deployment reboot verification complete.
<details> <summary>Technical details</summary> <p>Factory firmware: 1,365,696 bytes, SHA-256 <code>1aee4b0c4864181ef9b7cf88bd2c6dcf690d9eafd047badcfbbe8bb6959fd927</code>. Flashing uses 115200 baud, offset 0x0, no full-chip erase, and preserves NVS.</p> </details>

After setup

  1. Wi-Fi: Join the reterminal-e1003-xxxxxx hotspot shown on the panel (no password), open 192.168.4.1 and pick your 2.4 GHz Wi-Fi. The panel then shows its IP and HA WAITING.
  2. Home Assistant: Run Step 3, or add the ESPHome integration with the panel IP (port 6053). The panel shows HA CONNECTED. No API key or extra permission is needed.
  3. Light: Import the blueprint and create an automation. Choose the light, plus Main light command, Main light state and Main light value from this panel. Toggle the light once in Home Assistant to sync the screen. To control another light later, change it in the automation.

Change Wi-Fi: tap the Wi-Fi area on the screen twice (within 8 s), then repeat step 1. Pairing is kept; if Home Assistant does not reconnect, use Reconfigure on the ESPHome entry to enter the new IP.

Green button: press once for a full refresh (clears ghosting); hold 3 s to restart.

Prerequisites
  • A reTerminal E1003 panel and a USB data cable.
  • The computer, E1003 panel, and Home Assistant on the same reachable LAN.
Wiring
  1. Connect the E1003 carrier's USB-UART port to your computer with the USB cable.
  2. Select the device serial port in the App (click “Refresh” in the same row if it does not appear).
Troubleshooting
IssueAction
Device serial port not foundClick Refresh; use a data-capable USB cable; close other programs using the port
Write failedCheck the error message and retry; do not erase NVS
Stays at HA WAITINGPut Home Assistant on the same LAN and add ESPHome by the IP on the screen
Light does not respondMake sure the automation uses the blueprint and all three entities come from this panel

2

Deploy Home Assistant (Optional)

Deploy a Home Assistant instance on your local or remote Docker host. If Home Assistant is already running on port 8123, this step automatically detects it and skips.

Platform Constraint: The Home Assistant container relies on native host networking (network_mode: host) for mDNS and LAN device discovery. Local installation is supported on Linux hosts only. On macOS or Windows environments, Docker Desktop cannot provide native host networking: please uncheck this step to skip it, or select ha_remote to deploy to an independent Linux host (such as a Raspberry Pi or reComputer), or reuse an existing Home Assistant instance on your network.

Troubleshooting
SymptomFix
Home Assistant is already running on port 8123The step detects the running instance and skips installation; continue to the next step.
Local install fails on macOS or WindowsThe container uses host networking, which Docker Desktop does not provide. Select the remote target (a Linux host such as a Raspberry Pi or reComputer) or reuse an existing Home Assistant.
Deployment method

Deploy Home Assistant on a remote host (e.g. Raspberry Pi, reComputer) over the local network.


3

Connect E1003 to Home Assistant (Optional)

Automatically add the E1003 ESPHome panel to Home Assistant using the native config flow API. Then import the light blueprint (Step 1, After setup).

Prerequisites
  • E1003 powered on and connected to your Wi-Fi network.
  • Home Assistant instance running and reachable.
  • Home Assistant administrator username and password.
Troubleshooting
SymptomFix
Home Assistant login failsUse a Home Assistant administrator account and confirm the instance is reachable from this computer.
E1003 panel is not foundThe panel must be powered on and joined to a 2.4 GHz Wi-Fi network on the same LAN. Otherwise add the ESPHome integration manually in Home Assistant with the panel IP (Native API needs no key).