全屋智能交互屏幕 — 部署指南

AI 辅助通道

还没定硬件?还是设备已到手准备安装?

不想在网页上手动勾选或敲命令?你可以让 AI 助手根据现场情况自动核算主机与配件,或者在设备通电后一键运行脚本自动安装。

方案自助咨询与部署
套餐

墨水屏智能家居面板

通过 USB 连接 E1003 墨水屏面板并接入 Home Assistant。安装器会自动下载并烧录面板出厂固件,部署或连接 Home Assistant,并自动完成面板联动。

注意:请确保通过 USB 连接 reTerminal E1003 面板。烧录步骤将直接从 CDN 下载并安装固件。

1

安装 E1003 面板程序

在部署工具中选择串口并点击 部署,等待固件安装与重启校验完成。

烧录

  1. 在串口列表中选择连接的 E1003 设备端口。
  2. 点击 安装 / 部署。安装器将从 CDN 下载固件并以 115200 波特率烧录至面板。
  3. 保持设备通电,直到烧录与重启校验完成。
<details> <summary>技术详情</summary> <p>固件大小 1,365,696 字节,SHA-256 为 <code>1aee4b0c4864181ef9b7cf88bd2c6dcf690d9eafd047badcfbbe8bb6959fd927</code>。烧录参数为 115200 波特率、偏移量 0x0、不全片擦除并保留 NVS。</p> </details>
前置条件
  • 一台 reTerminal E1003 面板与一根 USB 数据线。
  • 电脑、E1003 面板与 Home Assistant 处于同一局域网。
接线
  1. 使用 USB 数据线连接 E1003 底板的 USB-UART 口与电脑。
  2. 在 App 的串口列表中选择该设备端口(若列表为空,点击同行的“刷新”)。
故障排查
现象处理方式
找不到设备串口点击刷新;使用支持数据传输的 USB 线;退出占用串口的其它程序
写入失败按提示信息处理后重试,切勿擦除 NVS
一直停在 HA WAITING让 Home Assistant 与面板处于同一局域网,用屏幕上的 IP 手动添加 ESPHome
灯不响应确认自动化使用的是该蓝图,且三个实体都选自这台面板

部署完成后
  1. Wi-Fi:连接面板上显示的 reterminal-e1003-xxxxxx 热点(无密码),浏览器打开 192.168.4.1,选择 2.4 GHz Wi-Fi。面板随后显示 IP 和 HA WAITING。
  2. Home Assistant:执行步骤 3,或手动添加 ESPHome 集成,填面板 IP(端口 6053)。面板显示 HA CONNECTED。无需 API 密钥或额外权限。
  3. 灯光:导入蓝图并创建自动化,选择要控制的灯,以及这台面板的 Main light command、Main light state、Main light value。在 Home Assistant 里切换一次灯,让屏幕同步。以后换灯,直接在该自动化里改。

更换 Wi-Fi:在屏幕上连续点两次 Wi-Fi 区域(8 秒内),再重复第 1 步。配对信息保留;若 Home Assistant 没有重连,在 ESPHome 条目上用 重新配置 填新 IP。

绿色键:单击整屏刷新(清除残影);长按 3 秒重启。

2

部署 Home Assistant(可选)

在本地或远程 Docker 主机上部署 Home Assistant。如果该主机 8123 端口已运行 Home Assistant,本步骤将自动检测并跳过。

宿主平台限制:Home Assistant 容器依赖 Linux 原生 host 网络(network_mode: host)实现 mDNS 与局域网设备自动发现。本地安装仅支持 Linux 宿主环境。在 macOS 或 Windows 环境下,Docker Desktop 无法提供原生 host 网络,请取消勾选本步骤以跳过,或选择 ha_remote 部署到局域网内的独立 Linux 主机(如树莓派、reComputer),也可直接复用局域网中已有的 Home Assistant 实例。

故障排查
问题解决方法
8123 端口上已有 Home Assistant本步骤会检测到已运行的实例并跳过安装,直接进入下一步。
在 macOS 或 Windows 上本地安装失败容器使用主机网络模式,Docker Desktop 不提供该模式。请选择远程部署目标(Raspberry Pi、reComputer 等 Linux 主机),或使用已有的 Home Assistant。
部署方式

通过局域网在远程 Linux 主机(如 Raspberry Pi、reComputer)上部署 Home Assistant。


3

将 E1003 接入 Home Assistant(可选)

通过 Home Assistant 自动化 Config Flow API 将已配网的 E1003 面板直接接入 Home Assistant。随后导入灯光蓝图(步骤 1“部署完成”)。

前置条件
  • E1003 已开机并接入局域网 Wi-Fi。
  • Home Assistant 正常运行且网络可达。
  • Home Assistant 管理员用户名与密码。
故障排查
问题解决方法
Home Assistant 登录失败请使用 Home Assistant 管理员账号,并确认本机能访问该实例。
找不到 E1003 面板面板需已开机并连接到同一局域网的 2.4 GHz Wi-Fi。否则在 Home Assistant 中手动添加 ESPHome 集成并填写面板 IP(Native API 无需密钥)。