這個(gè)故事始于三個(gè)月前。那時(shí)候，我天真地認(rèn)為在走廊上掛一個(gè)電子紙儀表盤是一個(gè)“周末項(xiàng)目”。簡(jiǎn)單的要求：顯示溫度，濕度，也許天氣預(yù)報(bào)。沒(méi)有花哨的LCD屏幕，沒(méi)有觸摸界面——只有一個(gè)安靜、優(yōu)雅、對(duì)眼睛友好的電子墨水顯示器。

“用ESPHome!”社區(qū)里的每個(gè)人都說(shuō)?！斑@很容易!”他們保證道。

于是我踏入了深淵。

第一天，我花了四個(gè)小時(shí)弄清楚如何顯示一行文本。第二天，我終于得到了一個(gè)溫度讀數(shù)——在左上角，字體很小，看起來(lái)就像螞蟻在屏幕上移動(dòng)。“沒(méi)問(wèn)題，”我對(duì)自己說(shuō)。“只要調(diào)整坐標(biāo)就行了?！?

改變它。編譯。等待著。三分鐘過(guò)去了。十分鐘過(guò)去了。最后一閃而過(guò)——數(shù)字從屏幕邊緣滑了出來(lái)。

就這樣，我的周末變成了兩周。兩個(gè)星期變成了一個(gè)月。

想要添加圖標(biāo)?首先，研究材料設(shè)計(jì)圖標(biāo)字體。然后計(jì)算字形編碼。然后祈禱它真的呈現(xiàn)出來(lái)。

想要調(diào)整布局?每次更改都需要重新編譯。每次編譯需要3-5分鐘。我開始質(zhì)疑自己的人生選擇。

想要穩(wěn)定的代碼?哈哈。當(dāng)ESPHome 2025.11.0出現(xiàn)故障時(shí)，我精心調(diào)整了一個(gè)月的代碼，變成了一堵紅色的錯(cuò)誤墻。那天晚上，我默默地盯著屏幕很長(zhǎng)時(shí)間。

我知道是時(shí)候另尋出路了。

新的希望

如果你現(xiàn)在手里有一臺(tái)reTerminal E1001或E1002，恭喜你——你將跳過(guò)我所經(jīng)歷的所有痛苦。

我專門開發(fā)了一個(gè)名為Seeed HA discovery的集成來(lái)解決這個(gè)問(wèn)題。核心理念很簡(jiǎn)單：

Flash固件一次。連接WiFi。訂閱實(shí)體。完成了。

沒(méi)有YAML。沒(méi)有坐標(biāo)計(jì)算。沒(méi)有編譯等待。不用擔(dān)心下一次更新會(huì)破壞一切。

讓我來(lái)教你怎么做。我保證這會(huì)比我在esphon上的冒險(xiǎn)愉快一萬(wàn)倍。

你需要什么

在我們開始這段旅程之前，確保你的背包里有：

硬件：一臺(tái)reTerminal E1001(7.5英寸單色)或E1002(7.3英寸彩色)，一根USB-C數(shù)據(jù)線(確保是數(shù)據(jù)線，而不是那種只能充電的騙子)和一臺(tái)電腦。

軟件：正在運(yùn)行的Home Assistant實(shí)例，已經(jīng)安裝了HACS(如果沒(méi)有，請(qǐng)轉(zhuǎn)到HACS)。以及Chrome或Edge瀏覽器(Safari和Firefox不能工作——不要問(wèn)我是怎么知道的)。

網(wǎng)絡(luò)：你的WiFi名稱和密碼，必須是2.4GHz。5 ghz ?ESP32不支持這種語(yǔ)言。

準(zhǔn)備好了嗎?我們走吧。

第一章：為零售終端注入活力

首先，把你的零售終端翻過(guò)來(lái)，找到那個(gè)小小的電源開關(guān)。把它滑到ON。然后用USB-C電纜將其連接到計(jì)算機(jī)上。

這里有一個(gè)我需要提醒你的陷阱：如果設(shè)備處于休眠狀態(tài)，固件不會(huì)閃現(xiàn)。我曾經(jīng)花了半個(gè)小時(shí)擺弄一個(gè)“看似連接”的設(shè)備，然后才意識(shí)到它在裝死。解決方法很簡(jiǎn)單——按下設(shè)備頂部的綠色按鈕來(lái)喚醒它。

打開魔法之門

您將看到一個(gè)干凈的頁(yè)面，列出不同設(shè)備的固件選項(xiàng)。找到您的型號(hào)(E1001或E1002)，然后單擊它旁邊的“InstallFirmware”按鈕。

您的瀏覽器將彈出一個(gè)窗口，詢問(wèn)要連接到哪個(gè)串行端口。選擇看起來(lái)像“USB JTAG”或“USB Serial”的那個(gè)。如果你不確定，就選擇第一個(gè)最壞的情況，再嘗試另一個(gè)。

一鍵發(fā)射

連接后，點(diǎn)擊“安裝”按鈕。

它會(huì)問(wèn)你是否要?jiǎng)h除設(shè)備。如果你之前閃過(guò)其他固件(ESPHome, SenseCraft，無(wú)論什么)，請(qǐng)勾選該框以重新開始。如果你只是在更新，不要勾選它以保持你的WiFi配置。

然后等待。大約一到兩分鐘，進(jìn)度條完成，屏幕上出現(xiàn)“安裝完成!”—祝賀您，您的reTerminal重生了。

專業(yè)提示：不要讓手指抽搐，在過(guò)程中拔掉電纜。我知道等待很無(wú)聊，但是中途斷開連接的后果是……你不會(huì)想經(jīng)歷這些的。

第二章：在家庭助手中設(shè)置家庭

一鍵安裝(實(shí)際上是一鍵安裝)

向下滾動(dòng)，找到閃亮的“OPEN HACS REPOSITORY ON MY HA”按鈕。點(diǎn)擊它。

您的瀏覽器將詢問(wèn)要跳轉(zhuǎn)到哪個(gè)家庭助理地址。

HACS將自動(dòng)打開并詢問(wèn)您是否要下載此集成。點(diǎn)擊“下載”。等待它完成。

重新開始，喝點(diǎn)咖啡

進(jìn)入“設(shè)置→系統(tǒng)→重新啟動(dòng)”，讓家庭助理重新啟動(dòng)。

這需要一兩分鐘。這是喝點(diǎn)水或玩手機(jī)的最佳時(shí)間。當(dāng)你回來(lái)的時(shí)候，一切都會(huì)準(zhǔn)備好的。

第三章：引導(dǎo)您的零售終端回家

WiFi配對(duì)儀式

閃爍后，您的reTerminal將轉(zhuǎn)換為WiFi熱點(diǎn)，其名稱如下：

?Seeed_reTerminal_E1001_AP

?Seeed_reTerminal_E1002_AP

拿起你的手機(jī)，連接到這個(gè)熱點(diǎn)。正常情況下，會(huì)自動(dòng)彈出一個(gè)配置頁(yè)面。

在此頁(yè)面，選擇您的家庭WiFi網(wǎng)絡(luò)，輸入密碼，然后點(diǎn)擊“連接”。

就是這樣。reTerminal將重新啟動(dòng)并安靜地加入您的網(wǎng)絡(luò)。

在家庭助理中申請(qǐng)

如果一切順利，回到“家庭助理”中的“設(shè)置→設(shè)備和服務(wù)”。你會(huì)看到一個(gè)新發(fā)現(xiàn)的設(shè)備在等著你。單擊它并完成配對(duì)。

如果沒(méi)有自動(dòng)出現(xiàn)(在復(fù)雜的網(wǎng)絡(luò)環(huán)境中偶爾會(huì)出現(xiàn)這種情況)，請(qǐng)手動(dòng)添加：?jiǎn)螕簟癮dd Integration”，搜索“Seeed HA Discovery”，然后輸入設(shè)備的IP地址。您可以在路由器的管理頁(yè)面中找到IP。

第四章：魔法時(shí)刻

告訴它你想看到的

導(dǎo)航到設(shè)置→設(shè)備和服務(wù)→查看HA發(fā)現(xiàn)，然后單擊您的reTerminal設(shè)備。

點(diǎn)擊齒輪圖標(biāo)，打開配置面板。這就是奇跡發(fā)生的地方。

單擊添加實(shí)體，然后選擇要在電子墨水屏幕上顯示的實(shí)體：

?客廳溫度傳感器?添加它。

?居室濕度?添加它。

?天氣預(yù)報(bào)嗎?絕對(duì)的。

?門鎖狀態(tài)如何?為什么不。

你一次最多可以訂閱20個(gè)實(shí)體，但請(qǐng)記住屏幕的UI設(shè)計(jì)為最佳顯示6個(gè)實(shí)體。明智地選擇最重要的選項(xiàng)——把它想象成管理你的儀表盤上最受歡迎的內(nèi)容。

完成后提交。

然后……就是這樣。

沒(méi)有YAML。沒(méi)有坐標(biāo)。無(wú)需等待編譯。您選擇的實(shí)體將自動(dòng)出現(xiàn)在電子墨水屏幕上，并按照預(yù)先設(shè)計(jì)的布局進(jìn)行排列，看起來(lái)不錯(cuò)。

當(dāng)我第一次看到這個(gè)作品時(shí)，我盯著屏幕足足看了30秒。不是因?yàn)槟睦锍隽藛?wèn)題，而是因?yàn)椤皇恰ぷ鲉?就這樣嗎?

是。就像這樣。

關(guān)于高級(jí)功能的說(shuō)明

目前，集成集中在一件事上，而且做得很好：實(shí)體訂閱。

如果您需要額外的功能，如編程物理按鈕、調(diào)整刷新間隔或自定義顯示行為，則需要自己深入了解固件。好消息是什么呢?代碼是完全開源的。

固件源代碼：

分叉，修改，把它變成你的。reTerminal有三個(gè)物理按鈕等待使用，刷新時(shí)間可以根據(jù)您的確切需要進(jìn)行調(diào)整。如果您熟悉嵌入式開發(fā)，那么代碼庫(kù)結(jié)構(gòu)良好，可以為您的貢獻(xiàn)做好準(zhǔn)備。

對(duì)于那些只想要一個(gè)工作儀表板而不需要接觸代碼的人來(lái)說(shuō)，當(dāng)前的功能已經(jīng)足夠了。訂閱您的實(shí)體，讓它自動(dòng)刷新，并享受您新的低維護(hù)顯示。

回顧這段旅程

讓我們比較一下這兩條路徑：

ESPHome路徑：學(xué)習(xí)YAML語(yǔ)法→研究字體配置→計(jì)算像素坐標(biāo)→等待編譯→發(fā)現(xiàn)破碎的布局→修改代碼→等待另一次編譯→無(wú)休止地重復(fù)→更新打破一切→從頭開始。

Seeed HA發(fā)現(xiàn)路徑：Flash固件→配置WiFi→訂閱實(shí)體→完成。

我并不是說(shuō)ESPHome不好。對(duì)于需要極端定制的場(chǎng)景，它仍然是一個(gè)強(qiáng)大的工具。但如果你只是想要一個(gè)好用的電子墨水儀表盤——真正好用，不讓人頭疼——現(xiàn)在你有了更好的選擇。

最終的想法

三個(gè)月前，我認(rèn)為我需要成為一個(gè)YAML專家才能擁有一個(gè)電子墨水儀表板。

現(xiàn)在，一臺(tái)零售終端E1002掛在我的走廊上，靜靜地顯示室內(nèi)溫度、室外天氣和空氣質(zhì)量指數(shù)。它不會(huì)產(chǎn)生光污染，每個(gè)游客都會(huì)問(wèn)：“那是什么?”太酷了?！?

如果你想要一個(gè)這樣的儀表盤，現(xiàn)在你知道怎么去做了。

本文編譯自hackster.io