建立一个家庭助理电子仪表盘

这个故事始于三个月前。那时候，我天真地认为在走廊上挂一个电子纸仪表盘是一个“周末项目”。简单的要求：显示温度，湿度，也许天气预报。没有花哨的LCD屏幕，没有触摸界面——只有一个安静、优雅、对眼睛友好的电子墨水显示器。

“用ESPHome!”社区里的每个人都说。“这很容易!”他们保证道。

于是我踏入了深渊。

第一天，我花了四个小时弄清楚如何显示一行文本。第二天，我终于得到了一个温度读数——在左上角，字体很小，看起来就像蚂蚁在屏幕上移动。“没问题，”我对自己说。“只要调整坐标就行了。”

改变它。编译。等待着。三分钟过去了。十分钟过去了。最后一闪而过——数字从屏幕边缘滑了出来。

就这样，我的周末变成了两周。两个星期变成了一个月。

想要添加图标?首先，研究材料设计图标字体。然后计算字形编码。然后祈祷它真的呈现出来。

想要调整布局?每次更改都需要重新编译。每次编译需要3-5分钟。我开始质疑自己的人生选择。

想要稳定的代码?哈哈。当ESPHome 2025.11.0出现故障时，我精心调整了一个月的代码，变成了一堵红色的错误墙。那天晚上，我默默地盯着屏幕很长时间。

我知道是时候另寻出路了。

新的希望

如果你现在手里有一台reTerminal E1001或E1002，恭喜你——你将跳过我所经历的所有痛苦。

我专门开发了一个名为Seeed HA discovery的集成来解决这个问题。核心理念很简单：

Flash固件一次。连接WiFi。订阅实体。完成了。

没有YAML。没有坐标计算。没有编译等待。不用担心下一次更新会破坏一切。

让我来教你怎么做。我保证这会比我在esphon上的冒险愉快一万倍。

你需要什么

在我们开始这段旅程之前，确保你的背包里有：

硬件：一台reTerminal E1001(7.5英寸单色)或E1002(7.3英寸彩色)，一根USB-C数据线(确保是数据线，而不是那种只能充电的骗子)和一台电脑。

软件：正在运行的Home Assistant实例，已经安装了HACS(如果没有，请转到HACS)。以及Chrome或Edge浏览器(Safari和Firefox不能工作——不要问我是怎么知道的)。

网络：你的WiFi名称和密码，必须是2.4GHz。5 ghz ?ESP32不支持这种语言。

准备好了吗?我们走吧。

第一章：为零售终端注入活力

首先，把你的零售终端翻过来，找到那个小小的电源开关。把它滑到ON。然后用USB-C电缆将其连接到计算机上。

这里有一个我需要提醒你的陷阱：如果设备处于休眠状态，固件不会闪现。我曾经花了半个小时摆弄一个“看似连接”的设备，然后才意识到它在装死。解决方法很简单——按下设备顶部的绿色按钮来唤醒它。

打开魔法之门

您将看到一个干净的页面，列出不同设备的固件选项。找到您的型号(E1001或E1002)，然后单击它旁边的“InstallFirmware”按钮。

您的浏览器将弹出一个窗口，询问要连接到哪个串行端口。选择看起来像“USB JTAG”或“USB Serial”的那个。如果你不确定，就选择第一个最坏的情况，再尝试另一个。

一键发射

连接后，点击“安装”按钮。

它会问你是否要删除设备。如果你之前闪过其他固件(ESPHome, SenseCraft，无论什么)，请勾选该框以重新开始。如果你只是在更新，不要勾选它以保持你的WiFi配置。

然后等待。大约一到两分钟，进度条完成，屏幕上出现“安装完成!”—祝贺您，您的reTerminal重生了。

专业提示：不要让手指抽搐，在过程中拔掉电缆。我知道等待很无聊，但是中途断开连接的后果是……你不会想经历这些的。

第二章：在家庭助手中设置家庭

一键安装(实际上是一键安装)

向下滚动，找到闪亮的“OPEN HACS REPOSITORY ON MY HA”按钮。点击它。

您的浏览器将询问要跳转到哪个家庭助理地址。

HACS将自动打开并询问您是否要下载此集成。点击“下载”。等待它完成。

重新开始，喝点咖啡

进入“设置→系统→重新启动”，让家庭助理重新启动。

这需要一两分钟。这是喝点水或玩手机的最佳时间。当你回来的时候，一切都会准备好的。

第三章：引导您的零售终端回家

WiFi配对仪式

闪烁后，您的reTerminal将转换为WiFi热点，其名称如下：

•Seeed_reTerminal_E1001_AP

•Seeed_reTerminal_E1002_AP

拿起你的手机，连接到这个热点。正常情况下，会自动弹出一个配置页面。

在此页面，选择您的家庭WiFi网络，输入密码，然后点击“连接”。

就是这样。reTerminal将重新启动并安静地加入您的网络。

在家庭助理中申请

如果一切顺利，回到“家庭助理”中的“设置→设备和服务”。你会看到一个新发现的设备在等着你。单击它并完成配对。

如果没有自动出现(在复杂的网络环境中偶尔会出现这种情况)，请手动添加：单击“add Integration”，搜索“Seeed HA Discovery”，然后输入设备的IP地址。您可以在路由器的管理页面中找到IP。

第四章：魔法时刻

告诉它你想看到的

导航到设置→设备和服务→查看HA发现，然后单击您的reTerminal设备。

点击齿轮图标，打开配置面板。这就是奇迹发生的地方。

单击添加实体，然后选择要在电子墨水屏幕上显示的实体：

•客厅温度传感器?添加它。

•居室湿度?添加它。

•天气预报吗?绝对的。

•门锁状态如何?为什么不。

你一次最多可以订阅20个实体，但请记住屏幕的UI设计为最佳显示6个实体。明智地选择最重要的选项——把它想象成管理你的仪表盘上最受欢迎的内容。

完成后提交。

然后……就是这样。

没有YAML。没有坐标。无需等待编译。您选择的实体将自动出现在电子墨水屏幕上，并按照预先设计的布局进行排列，看起来不错。

当我第一次看到这个作品时，我盯着屏幕足足看了30秒。不是因为哪里出了问题，而是因为……它只是…工作吗?就这样吗?

是。就像这样。

关于高级功能的说明

目前，集成集中在一件事上，而且做得很好：实体订阅。

如果您需要额外的功能，如编程物理按钮、调整刷新间隔或自定义显示行为，则需要自己深入了解固件。好消息是什么呢?代码是完全开源的。

固件源代码：

分叉，修改，把它变成你的。reTerminal有三个物理按钮等待使用，刷新时间可以根据您的确切需要进行调整。如果您熟悉嵌入式开发，那么代码库结构良好，可以为您的贡献做好准备。

对于那些只想要一个工作仪表板而不需要接触代码的人来说，当前的功能已经足够了。订阅您的实体，让它自动刷新，并享受您新的低维护显示。

回顾这段旅程

让我们比较一下这两条路径：

ESPHome路径：学习YAML语法→研究字体配置→计算像素坐标→等待编译→发现破碎的布局→修改代码→等待另一次编译→无休止地重复→更新打破一切→从头开始。

Seeed HA发现路径：Flash固件→配置WiFi→订阅实体→完成。

我并不是说ESPHome不好。对于需要极端定制的场景，它仍然是一个强大的工具。但如果你只是想要一个好用的电子墨水仪表盘——真正好用，不让人头疼——现在你有了更好的选择。

最终的想法

三个月前，我认为我需要成为一个YAML专家才能拥有一个电子墨水仪表板。

现在，一台零售终端E1002挂在我的走廊上，静静地显示室内温度、室外天气和空气质量指数。它不会产生光污染，每个游客都会问：“那是什么?”太酷了。”

如果你想要一个这样的仪表盘，现在你知道怎么去做了。

本文编译自hackster.io