建低功耗墨水屏智能家居儀表盤(pán))
1. 項(xiàng)目緣起為什么需要一個(gè)墨水屏儀表盤(pán)如果你和我一樣家里已經(jīng)部署了Home Assistant并且對(duì)智能家居的狀態(tài)監(jiān)控有了一定的依賴那你可能也經(jīng)歷過(guò)這樣的場(chǎng)景早上起床想看一眼室溫和濕度得先摸到手機(jī)解鎖打開(kāi)Home Assistant App等待加載然后才能看到那幾個(gè)數(shù)字?；蛘咴趶N房做飯時(shí)想確認(rèn)一下冰箱溫度或者陽(yáng)臺(tái)的窗戶是否關(guān)閉又得重復(fù)一遍這個(gè)流程。這些操作雖然不復(fù)雜但累積起來(lái)總讓人覺(jué)得不夠“無(wú)縫”不夠“優(yōu)雅”。智能家居的終極目標(biāo)不就是讓信息和服務(wù)主動(dòng)、無(wú)感地融入生活嗎于是一個(gè)常顯、低功耗、信息集中的物理儀表盤(pán)就成了一個(gè)很自然的需求。而電子墨水屏ePaper幾乎是這個(gè)需求的完美答案。它只在刷新時(shí)耗電顯示靜態(tài)內(nèi)容時(shí)幾乎零功耗這意味著你可以把它放在床頭、貼在冰箱上或者掛在玄關(guān)7x24小時(shí)顯示關(guān)鍵信息而不用擔(dān)心電費(fèi)或者屏幕燒屏。它本身不發(fā)光光線越強(qiáng)顯示越清晰非常適合作為環(huán)境信息板。這個(gè)項(xiàng)目就是要在十分鐘內(nèi)用最低的成本和最簡(jiǎn)單的步驟搭建起這樣一個(gè)專屬于你的Home Assistant墨水屏儀表盤(pán)。我們將使用一款非常流行的開(kāi)源硬件——reTerminal或者其核心板reComputer作為主控配合一塊ePaper屏幕通過(guò)ESPHome來(lái)橋接Home Assistant的數(shù)據(jù)。整個(gè)流程清晰直接即使你只有基礎(chǔ)的動(dòng)手能力也能輕松完成。下面我就帶你一步步實(shí)現(xiàn)它。2. 硬件選型與核心原理為什么是reTerminal ESPHome在開(kāi)始動(dòng)手前我們先花幾分鐘搞清楚我們選擇的硬件和軟件方案背后的邏輯。這能幫你理解每一步操作的意義甚至在將來(lái)需要調(diào)整或排查問(wèn)題時(shí)心里有底。2.1 主控選擇reTerminal/reComputer的優(yōu)勢(shì)市面上能驅(qū)動(dòng)ePaper的單板計(jì)算機(jī)很多比如樹(shù)莓派Zero 2W、ESP32系列開(kāi)發(fā)板等。我們選擇Seeed Studio的reTerminal或reComputer主要基于以下幾個(gè)考量集成度與易用性reTerminal本身就是一個(gè)帶5英寸觸摸屏的完整設(shè)備但它也提供了40針的GPIO排針可以方便地連接各種外設(shè)包括我們需要的ePaper屏幕。它的核心是一顆樹(shù)莓派CM4模塊這意味著它擁有完整的Linux操作系統(tǒng)Raspberry Pi OS和強(qiáng)大的計(jì)算能力遠(yuǎn)超一般的微控制器。供電與接口reTerminal通過(guò)Type-C接口供電和通信非常方便。其GPIO電壓為3.3V與大多數(shù)ePaper屏幕兼容無(wú)需額外的電平轉(zhuǎn)換電路。社區(qū)與生態(tài)作為樹(shù)莓派生態(tài)的一員它有龐大的軟件和社區(qū)支持。我們需要用到的ESPHome在Linux系統(tǒng)上部署和運(yùn)行非常成熟穩(wěn)定。如果你手頭沒(méi)有reTerminal使用reComputer不帶屏幕的版本或者樹(shù)莓派4B/3B搭配40Pin GPIO擴(kuò)展板也是完全可行的原理和步驟幾乎一致。2.2 顯示核心電子墨水屏ePaper的工作原理電子墨水屏的技術(shù)核心是“電泳”。屏幕由數(shù)百萬(wàn)個(gè)微膠囊構(gòu)成每個(gè)膠囊里充滿了帶負(fù)電的黑色粒子和帶正電的白色粒子懸浮在透明的液體中。當(dāng)在膠囊兩側(cè)施加一個(gè)電場(chǎng)時(shí)黑色或白色粒子就會(huì)被吸引到頂部從而形成像素點(diǎn)的黑或白顯示。這個(gè)過(guò)程有兩個(gè)關(guān)鍵特性決定了ePaper的優(yōu)缺點(diǎn)雙穩(wěn)態(tài)一旦粒子移動(dòng)到某個(gè)位置即使撤掉電場(chǎng)它們也會(huì)因?yàn)槲锢碜饔昧Χ３衷?。這就是為什么ePaper在顯示靜態(tài)圖像時(shí)不耗電——它只在刷新圖像改變電場(chǎng)時(shí)消耗能量。刷新慢粒子的物理移動(dòng)需要時(shí)間所以ePaper的刷新速度通常需要幾百毫秒到幾秒遠(yuǎn)低于LCD或OLED屏幕。這決定了它不適合顯示快速變化的視頻或動(dòng)畫(huà)但對(duì)于幾分鐘甚至幾小時(shí)更新一次的儀表盤(pán)來(lái)說(shuō)這根本不是問(wèn)題。我們項(xiàng)目中常用的尺寸是7.5英寸800x480分辨率或4.2英寸400x300分辨率它們通常通過(guò)SPI接口與主控通信驅(qū)動(dòng)庫(kù)非常成熟。2.3 軟件橋梁ESPHome的角色你可能會(huì)問(wèn)既然reTerminal本身就能跑Home Assistant為什么不直接寫(xiě)個(gè)Python腳本去拉取數(shù)據(jù)并刷新屏幕呢當(dāng)然可以但這會(huì)引入幾個(gè)復(fù)雜度需要處理Home Assistant的認(rèn)證API Token、需要管理網(wǎng)絡(luò)請(qǐng)求、需要解析JSON數(shù)據(jù)、需要處理定時(shí)任務(wù)等等。而ESPHome巧妙地解決了這些問(wèn)題。在這個(gè)架構(gòu)中ESPHome并不直接運(yùn)行在reTerminal上而是運(yùn)行在同一個(gè)家庭網(wǎng)絡(luò)中的另一臺(tái)設(shè)備上通常是Home Assistant服務(wù)器本身或者一臺(tái)常開(kāi)的電腦。它的角色是一個(gè)“虛擬設(shè)備”或“橋接器”。虛擬設(shè)備我們?cè)贓SPHome中定義一個(gè)“虛擬”的顯示屏設(shè)備它通過(guò)Home Assistant的API持續(xù)訂閱我們關(guān)心的實(shí)體entity狀態(tài)如sensor.living_room_temperature。數(shù)據(jù)橋接當(dāng)這些實(shí)體的狀態(tài)發(fā)生變化時(shí)Home Assistant會(huì)主動(dòng)通過(guò)WebSocket或API調(diào)用通知這個(gè)ESPHome設(shè)備。串口轉(zhuǎn)發(fā)這個(gè)運(yùn)行在后臺(tái)的ESPHome“設(shè)備”并不真正連接硬件屏幕。我們配置它將接收到的數(shù)據(jù)通過(guò)一個(gè)簡(jiǎn)單的協(xié)議比如自定義的文本格式輸出到串口Serial。reTerminal接收與渲染reTerminal通過(guò)USB轉(zhuǎn)TTL串口模塊或者直接使用其GPIO上的UART引腳連接到運(yùn)行ESPHome的電腦讀取串口數(shù)據(jù)。reTerminal上運(yùn)行一個(gè)輕量級(jí)的Python腳本解析這些數(shù)據(jù)然后調(diào)用ePaper的驅(qū)動(dòng)庫(kù)將新的狀態(tài)值更新到屏幕上。這樣做的最大好處是解耦和簡(jiǎn)化。reTerminal上的Python腳本只需要做兩件事讀串口和畫(huà)屏幕。所有復(fù)雜的Home Assistant交互、數(shù)據(jù)訂閱、網(wǎng)絡(luò)通信都由ESPHome在后臺(tái)默默完成。ESPHome成熟的yaml配置語(yǔ)法也讓管理多個(gè)數(shù)據(jù)源變得異常簡(jiǎn)單。3. 十分鐘快速搭建從零到顯示理解了原理我們現(xiàn)在開(kāi)始實(shí)戰(zhàn)。請(qǐng)確保你手頭有以下硬件reTerminal或reComputer/樹(shù)莓派一臺(tái)并已安裝好Raspberry Pi OS推薦Lite版本以減少資源占用。7.5英寸或4.2英寸的SPI接口ePaper屏幕一塊以Waveshare品牌為例。杜邦線母對(duì)母若干?？蛇xUSB轉(zhuǎn)TTL串口模塊一個(gè)用于調(diào)試和初期連接。如果reTerminal和運(yùn)行ESPHome的電腦在同一臺(tái)機(jī)器上可以直接使用虛擬串口。3.1 第一步硬件連接2分鐘我們將ePaper屏幕的SPI引腳連接到reTerminal的GPIO上。以7.5英寸屏幕V2版本和reTerminal為例ePaper 引腳功能reTerminal GPIO (物理引腳號(hào))備注VCC電源 (3.3V)Pin 1 (3.3V)務(wù)必接3.3V接5V會(huì)燒屏GND地Pin 6 (GND)DIN (MOSI)SPI數(shù)據(jù)輸入Pin 19 (GPIO10, MOSI)CLK (SCK)SPI時(shí)鐘Pin 23 (GPIO11, SCLK)CS (CE0)片選Pin 24 (GPIO8, CE0)使用CE0DC數(shù)據(jù)/命令選擇Pin 18 (GPIO24)可自定義代碼中需對(duì)應(yīng)RST復(fù)位Pin 22 (GPIO25)可自定義代碼中需對(duì)應(yīng)BUSY忙狀態(tài)指示Pin 16 (GPIO23)可自定義代碼中需對(duì)應(yīng)注意不同型號(hào)的ePaper屏幕引腳定義可能略有不同請(qǐng)務(wù)必以你購(gòu)買屏幕的說(shuō)明書(shū)為準(zhǔn)。連接時(shí)最好斷開(kāi)電源。3.2 第二步在reTerminal上準(zhǔn)備環(huán)境3分鐘通過(guò)SSH登錄到你的reTerminal。啟用SPI接口運(yùn)行sudo raspi-config選擇Interface Options-SPI-Yes啟用SPI驅(qū)動(dòng)然后重啟。安裝Python庫(kù)我們將使用Waveshare提供的Python庫(kù)來(lái)驅(qū)動(dòng)屏幕。sudo apt update sudo apt install python3-pip python3-pil python3-numpy -y git clone https://github.com/waveshare/e-Paper.git cd e-Paper/RaspberryPi_JetsonNano/python sudo pip3 install .這個(gè)庫(kù)包含了各種尺寸ePaper的驅(qū)動(dòng)代碼。安裝串口通信庫(kù)用于從串口讀取ESPHome發(fā)來(lái)的數(shù)據(jù)。sudo pip3 install pyserial3.3 第三步配置ESPHome“橋接”設(shè)備3分鐘在你的Home Assistant服務(wù)器或另一臺(tái)常開(kāi)電腦上已有ESPHome插件或獨(dú)立安裝。我們創(chuàng)建一個(gè)新的ESPHome設(shè)備配置。新建配置在ESPHome中新建一個(gè)設(shè)備命名為epaper_bridge選擇ESP32作為平臺(tái)這里我們只是利用其軟件功能并不需要真實(shí)硬件。編輯YAML配置核心是使用homeassistant傳感器和uart組件。esphome: name: epaper_bridge platform: ESP32 board: nodemcu-32s # 啟用Home Assistant API組件用于接收數(shù)據(jù) api: encryption: key: 你的api加密密鑰 # 啟用日志便于調(diào)試 logger: # 配置UART將數(shù)據(jù)輸出到串口 uart: id: uart_bus tx_pin: GPIO1 # 虛擬引腳實(shí)際對(duì)應(yīng)串口輸出 baud_rate: 115200 # 定義傳感器關(guān)聯(lián)Home Assistant中的實(shí)體 sensor: - platform: homeassistant name: Living Room Temperature entity_id: sensor.living_room_temperature id: temp_living on_value: then: - uart.write: TEMP,${id(temp_living).state}\n - platform: homeassistant name: Outdoor Humidity entity_id: sensor.outdoor_humidity id: humidity_outdoor on_value: then: - uart.write: HUMI,${id(humidity_outdoor).state}\n - platform: homeassistant name: Living Room Light State entity_id: light.living_room id: light_living on_value: then: - if: condition: lambda: return id(light_living).state on; then: - uart.write: LIGHT,ON\n else: - uart.write: LIGHT,OFF\n # 定義一個(gè)文本傳感器用于接收來(lái)自reTerminal的簡(jiǎn)單指令可選 text_sensor: - platform: uart id: uart_receiver on_value: then: - logger.log: Received from ePaper: $value這個(gè)配置做了幾件事定義了三個(gè)傳感器分別綁定到Home Assistant里的溫度、濕度和燈光實(shí)體。為每個(gè)傳感器設(shè)置了on_value觸發(fā)器。當(dāng)Home Assistant中對(duì)應(yīng)實(shí)體的狀態(tài)發(fā)生變化時(shí)會(huì)執(zhí)行其中的動(dòng)作。動(dòng)作為通過(guò)UART向串口寫(xiě)入一行格式化的文本例如TEMP,22.5。我們定義了一個(gè)簡(jiǎn)單的協(xié)議數(shù)據(jù)標(biāo)簽,數(shù)值以換行符\n結(jié)束。這樣在reTerminal端容易解析。編譯與運(yùn)行由于我們沒(méi)有真實(shí)ESP32硬件不能直接刷機(jī)。我們需要在ESPHome中“安裝”這個(gè)配置到“本地”。在ESPHome儀表板對(duì)該配置選擇“Install” - “Manual Download” - “Modern format (.pio)”。下載后在服務(wù)器上通過(guò)命令行運(yùn)行它# 進(jìn)入你存放ESPHome配置的目錄 cd /path/to/esphome/config # 運(yùn)行虛擬設(shè)備 esphome run epaper_bridge.yaml此時(shí)這個(gè)ESPHome服務(wù)會(huì)啟動(dòng)連接到你的Home Assistant并開(kāi)始監(jiān)聽(tīng)實(shí)體變化。它會(huì)把數(shù)據(jù)輸出到標(biāo)準(zhǔn)輸出stdout我們需要將其重定向到一個(gè)虛擬串口。3.4 第四步建立通信鏈路1分鐘我們需要讓reTerminal能讀到ESPHome服務(wù)輸出的數(shù)據(jù)。這里有兩種方法方法A同一臺(tái)主機(jī)推薦用于測(cè)試使用socat創(chuàng)建一對(duì)虛擬串口。# 在運(yùn)行ESPHome和reTerminal SSH會(huì)話的電腦上執(zhí)行 sudo apt install socat socat -d -d pty,raw,echo0 pty,raw,echo0命令會(huì)輸出兩個(gè)虛擬串口路徑例如/dev/pts/2和/dev/pts/3。它們已經(jīng)連接。將ESPHome的uart配置中的tx_pin注釋掉改用debug組件輸出到標(biāo)準(zhǔn)輸出然后用socat重定向# 運(yùn)行ESPHome將其輸出通過(guò)管道發(fā)給socat的一個(gè)端口 esphome run epaper_bridge.yaml 21 | socat - /dev/pts/2在reTerminal的Python腳本中打開(kāi)另一個(gè)虛擬串口/dev/pts/3進(jìn)行讀取。方法B兩臺(tái)主機(jī)更接近最終部署使用USB轉(zhuǎn)TTL串口模塊。將USB轉(zhuǎn)TTL模塊的TX引腳連接到reTerminal的RX引腳GPIO15物理引腳號(hào)10。將USB轉(zhuǎn)TTL模塊插入運(yùn)行ESPHome的電腦的USB口。在ESPHome配置中uart的tx_pin可以保持為一個(gè)虛擬GPIO因?yàn)镋SPHome在電腦上運(yùn)行時(shí)uart.write默認(rèn)是輸出到標(biāo)準(zhǔn)輸出。我們需要一個(gè)小的Python腳本在電腦上運(yùn)行讀取標(biāo)準(zhǔn)輸出并寫(xiě)入真實(shí)的串口。# bridge_serial.py 運(yùn)行在電腦上 import sys import serial import time # 替換為你的USB轉(zhuǎn)TTL串口設(shè)備名如COM3(Windows)或/dev/ttyUSB0(Linux) ser serial.Serial(/dev/ttyUSB0, 115200, timeout1) try: while True: line sys.stdin.readline() if line: print(fSending to serial: {line.strip()}) ser.write(line.encode(utf-8)) except KeyboardInterrupt: ser.close()運(yùn)行ESPHome服務(wù)并將其輸出通過(guò)管道傳遞給這個(gè)腳本esphome run epaper_bridge.yaml 21 | python3 bridge_serial.py3.5 第五步編寫(xiě)reTerminal上的顯示腳本1分鐘在reTerminal上創(chuàng)建一個(gè)Python腳本例如epaper_dashboard.py。#!/usr/bin/env python3 import serial import time from waveshare_epd import epd7in5_V2 # 根據(jù)你的屏幕型號(hào)導(dǎo)入 from PIL import Image, ImageDraw, ImageFont import threading # 初始化屏幕 epd epd7in5_V2.EPD() epd.init() epd.Clear() # 準(zhǔn)備畫(huà)布和字體 font_large ImageFont.truetype(/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf, 48) font_small ImageFont.truetype(/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf, 24) # 數(shù)據(jù)存儲(chǔ)字典 data { TEMP: --.-°C, HUMI: --%, LIGHT: OFF } def update_display(): 根據(jù)當(dāng)前數(shù)據(jù)刷新屏幕 # 創(chuàng)建一張新圖像初始為白色 image Image.new(1, (epd.width, epd.height), 255) draw ImageDraw.Draw(image) # 繪制標(biāo)題 draw.text((10, 10), Home Dashboard, fontfont_large, fill0) draw.line((10, 70, epd.width-10, 70), fill0, width3) # 繪制數(shù)據(jù) y_offset 90 line_height 60 draw.text((20, y_offset), fTemperature: {data[TEMP]}, fontfont_small, fill0) draw.text((20, y_offset line_height), fHumidity: {data[HUMI]}, fontfont_small, fill0) draw.text((20, y_offset 2*line_height), fLight: {data[LIGHT]}, fontfont_small, fill0) # 顯示到屏幕 epd.display(epd.getbuffer(image)) print(Display updated.) def serial_listener(): 監(jiān)聽(tīng)串口解析數(shù)據(jù) # 替換為你的串口設(shè)備如果是虛擬串口或USB轉(zhuǎn)TTL ser serial.Serial(/dev/ttyUSB0, 115200, timeout1) # 或 /dev/ttyAMA0 (GPIO UART) 或 /dev/pts/3 while True: try: line ser.readline().decode(utf-8).strip() if line: print(fReceived: {line}) parts line.split(,) if len(parts) 2: tag, value parts if tag in data: if tag TEMP: data[tag] f{value}°C elif tag HUMI: data[tag] f{value}% else: data[tag] value # 數(shù)據(jù)更新后觸發(fā)屏幕刷新 update_display() except Exception as e: print(fSerial error: {e}) time.sleep(5) if __name__ __main__: # 首次全屏刷新 update_display() # 啟動(dòng)串口監(jiān)聽(tīng)線程 listener_thread threading.Thread(targetserial_listener, daemonTrue) listener_thread.start() # 主線程保持運(yùn)行也可以加入定時(shí)全刷邏輯防止殘影 try: while True: time.sleep(60) # 每分鐘檢查一次可進(jìn)行定時(shí)全刷等維護(hù)操作 # 例如每6小時(shí)強(qiáng)制全刷一次 # if time.time() % (6*3600) 60: # epd.init() # 重新初始化可以清殘影 # update_display() except KeyboardInterrupt: print(Exiting...) epd.sleep()給腳本執(zhí)行權(quán)限并運(yùn)行chmod x epaper_dashboard.py然后python3 epaper_dashboard.py。如果一切順利你將看到屏幕初始化并顯示初始信息。當(dāng)你在Home Assistant中改變溫度、濕度或燈光狀態(tài)時(shí)屏幕上的內(nèi)容應(yīng)該會(huì)在幾秒內(nèi)更新。4. 優(yōu)化與進(jìn)階讓儀表盤(pán)更實(shí)用、更穩(wěn)定基礎(chǔ)功能跑通后我們可以從多個(gè)維度進(jìn)行優(yōu)化讓它從一個(gè)玩具變成一個(gè)真正可靠的家庭信息中樞。4.1 界面設(shè)計(jì)與布局優(yōu)化上面的示例腳本只展示了最簡(jiǎn)單的文本排列。我們可以利用PIL庫(kù)的強(qiáng)大功能設(shè)計(jì)更美觀的界面。使用模板圖片先用圖形設(shè)計(jì)軟件如Figma、GIMP設(shè)計(jì)好儀表盤(pán)的背景圖包含靜態(tài)的圖標(biāo)、裝飾框和文字標(biāo)簽。將這個(gè)背景圖黑白二值BMP或PNG格式放在reTerminal上。在Python腳本中先加載背景圖然后在對(duì)應(yīng)的坐標(biāo)位置動(dòng)態(tài)繪制變化的數(shù)據(jù)。這樣能獲得更專業(yè)的視覺(jué)效果。background Image.open(dashboard_bg.png) draw ImageDraw.Draw(background) draw.text((x, y), data[TEMP], fontfont, fill0) epd.display(epd.getbuffer(background))布局更多數(shù)據(jù)7.5英寸屏幕有800x480像素可以輕松布局8-10個(gè)關(guān)鍵信息。例如分為上下兩欄上欄顯示環(huán)境數(shù)據(jù)溫濕度、空氣質(zhì)量、天氣下欄顯示設(shè)備狀態(tài)燈光、門窗、電器功耗。添加簡(jiǎn)單圖形可以用draw.rectangle或draw.line畫(huà)簡(jiǎn)單的進(jìn)度條來(lái)表示傳感器數(shù)值如空氣質(zhì)量指數(shù)比純數(shù)字更直觀。4.2 通信協(xié)議與錯(cuò)誤處理強(qiáng)化我們之前定義的簡(jiǎn)單文本協(xié)議TEMP,22.5在家庭網(wǎng)絡(luò)環(huán)境下基本夠用但為了健壯性可以考慮以下改進(jìn)增加校驗(yàn)在行尾添加一個(gè)簡(jiǎn)單的校驗(yàn)和例如CRC8在reTerminal端進(jìn)行驗(yàn)證丟棄錯(cuò)誤數(shù)據(jù)。# ESPHome端 (使用lambda計(jì)算) on_value: then: - lambda: |- int crc 0; std::string msg TEMP, to_string(id(temp_living).state); for(char c : msg) crc ^ c; uart.write(msg * to_string(crc) \n);心跳與重連機(jī)制在ESPHome配置中添加一個(gè)定時(shí)器定期如每30秒發(fā)送一個(gè)PING消息。reTerminal端如果超過(guò)一定時(shí)間如2分鐘沒(méi)收到任何消息包括PING或數(shù)據(jù)則判定連接斷開(kāi)在屏幕上顯示“連接中斷”的提示并嘗試重新初始化串口連接。數(shù)據(jù)緩沖與去抖對(duì)于頻繁變化的傳感器如功率計(jì)可以在ESPHome端或reTerminal端做簡(jiǎn)單的去抖處理避免屏幕因刷新過(guò)于頻繁而出現(xiàn)殘影或縮短壽命。例如只在數(shù)值變化超過(guò)一定閾值或距離上次更新超過(guò)30秒時(shí)才發(fā)送。4.3 系統(tǒng)服務(wù)化與自啟動(dòng)我們不想每次重啟reTerminal后都手動(dòng)SSH進(jìn)去運(yùn)行Python腳本。創(chuàng)建系統(tǒng)服務(wù)在reTerminal上創(chuàng)建一個(gè)systemd服務(wù)文件。sudo nano /etc/systemd/system/epaper-dashboard.service寫(xiě)入以下內(nèi)容[Unit] DescriptionHome Assistant E-Paper Dashboard Afternetwork.target [Service] Typesimple Userpi WorkingDirectory/home/pi ExecStart/usr/bin/python3 /home/pi/epaper_dashboard.py Restarton-failure RestartSec10 [Install] WantedBymulti-user.target啟用并啟動(dòng)服務(wù)sudo systemctl daemon-reload sudo systemctl enable epaper-dashboard.service sudo systemctl start epaper-dashboard.service現(xiàn)在你的墨水屏儀表盤(pán)會(huì)在reTerminal啟動(dòng)時(shí)自動(dòng)運(yùn)行并在崩潰后自動(dòng)重啟。4.4 功耗與屏幕維護(hù)ePaper雖然省電但reTerminal樹(shù)莓派CM4本身功耗在2-5W左右。如果希望進(jìn)一步省電可以考慮使用更省電的主控如ESP32-S3但會(huì)犧牲部分性能和部署便利性。對(duì)于屏幕維護(hù)最關(guān)鍵的是防止殘影。長(zhǎng)期顯示同一靜態(tài)圖像可能導(dǎo)致粒子殘留。解決方法定期全局刷新在腳本中加入邏輯每顯示一定次數(shù)如20次局部更新后或每隔幾小時(shí)執(zhí)行一次完整的全屏清除和重繪epd.Clear() 全圖display。我們的示例腳本注釋里已經(jīng)提到了定時(shí)全刷的思路。深度睡眠如果你不需要24小時(shí)顯示可以配置屏幕在夜間或離家模式時(shí)進(jìn)入深度睡眠epd.sleep()并讓reTerminal也進(jìn)入休眠或關(guān)閉屏幕背光如果是reTerminal設(shè)備。5. 排查與調(diào)試當(dāng)屏幕沒(méi)有如預(yù)期顯示時(shí)即使按照步驟操作也可能會(huì)遇到問(wèn)題。這里提供一個(gè)清晰的排查鏈路。5.1 屏幕無(wú)任何反應(yīng)全白或全黑檢查電源和連接這是最常見(jiàn)的問(wèn)題。確認(rèn)屏幕VCC接的是3.3V不是5V。確認(rèn)所有杜邦線接觸牢固特別是GND?？梢杂萌f(wàn)用表測(cè)量屏幕排針上的電壓。確認(rèn)SPI已啟用運(yùn)行l(wèi)s /dev/spi*應(yīng)該能看到類似/dev/spidev0.0的設(shè)備。如果沒(méi)有返回raspi-config確認(rèn)SPI已開(kāi)啟并重啟。檢查驅(qū)動(dòng)庫(kù)安裝在Python中嘗試導(dǎo)入waveshare_epd庫(kù)看是否報(bào)錯(cuò)。python3 -c import waveshare_epd; print(OK)。驗(yàn)證屏幕型號(hào)確認(rèn)你導(dǎo)入的驅(qū)動(dòng)類如epd7in5_V2與你的屏幕型號(hào)完全一致。不同版本的屏幕驅(qū)動(dòng)可能不兼容。5.2 屏幕初始化成功但收不到數(shù)據(jù)更新確認(rèn)串口連接在reTerminal上運(yùn)行python3 -m serial.tools.list_ports查看可用串口。嘗試用簡(jiǎn)單的串口監(jiān)聽(tīng)程序測(cè)試是否有數(shù)據(jù)流入python3 -m serial.tools.miniterm /dev/ttyUSB0 115200替換為你的設(shè)備名。如果ESPHome端有數(shù)據(jù)發(fā)送你應(yīng)該能在這里看到。檢查ESPHome服務(wù)狀態(tài)在運(yùn)行ESPHome的電腦上查看其日志輸出確認(rèn)它已成功連接到Home Assistant并且沒(méi)有報(bào)錯(cuò)。檢查Home Assistant中對(duì)應(yīng)實(shí)體的狀態(tài)是否真的發(fā)生了變化?？梢栽贖ome Assistant開(kāi)發(fā)者工具-狀態(tài)中手動(dòng)更改一個(gè)實(shí)體狀態(tài)觀察ESPHome日志是否有對(duì)應(yīng)的輸出。檢查通信協(xié)議確認(rèn)reTerminal腳本中解析數(shù)據(jù)的代碼line.split(,)與ESPHome發(fā)送的格式完全匹配包括大小寫(xiě)和換行符。5.3 屏幕刷新出現(xiàn)殘影或鬼影啟用局部刷新模式一些ePaper驅(qū)動(dòng)庫(kù)支持局部刷新epd.display_Partial速度更快但更容易產(chǎn)生殘影。對(duì)于儀表盤(pán)應(yīng)用建議始終使用全局刷新epd.display。增加全刷頻率如前所述增加定時(shí)全屏清除重繪的邏輯。檢查電源穩(wěn)定性屏幕刷新時(shí)功耗較大如果電源特別是3.3V線供電不足可能導(dǎo)致刷新不徹底。嘗試縮短連接線或使用獨(dú)立的3.3V穩(wěn)壓模塊為屏幕供電。5.4 字體顯示為亂碼或方框這是因?yàn)橄到y(tǒng)中沒(méi)有對(duì)應(yīng)的字體文件。我們的腳本使用了DejaVu字體它是Raspberry Pi OS自帶的。如果缺失可以安裝sudo apt install fonts-dejavu-core。你也可以將喜歡的TTF字體文件上傳到reTerminal并在腳本中指定絕對(duì)路徑。整個(gè)項(xiàng)目從硬件連接到穩(wěn)定運(yùn)行核心在于理解數(shù)據(jù)流Home Assistant - ESPHome虛擬橋接- 串口 - reTerminalPython腳本- ePaper驅(qū)動(dòng)。只要這個(gè)鏈條的每一環(huán)都打通了一個(gè)個(gè)性化、低功耗、常顯的家庭信息中心就真正屬于你了。你可以根據(jù)自己的需求輕松地修改ESPHome的配置來(lái)添加更多傳感器或者修改Python腳本來(lái)設(shè)計(jì)更復(fù)雜的界面。 基于ESPHome與reTerminal構(gòu)建低功耗墨水屏智能家居儀表盤(pán)
1. 項(xiàng)目緣起為什么需要一個(gè)墨水屏儀表盤(pán)如果你和我一樣家里已經(jīng)部署了Home Assistant并且對(duì)智能家居的狀態(tài)監(jiān)控有了一定的依賴那你可能也經(jīng)歷過(guò)這樣的場(chǎng)景早上起床想看一眼室溫和濕度得先摸到手機(jī)解鎖打開(kāi)Home Assistant App等待加載然后才能看到那幾個(gè)數(shù)字?；蛘咴趶N房做飯時(shí)想確認(rèn)一下冰箱溫度或者陽(yáng)臺(tái)的窗戶是否關(guān)閉又得重復(fù)一遍這個(gè)流程。這些操作雖然不復(fù)雜但累積起來(lái)總讓人覺(jué)得不夠“無(wú)縫”不夠“優(yōu)雅”。智能家居的終極目標(biāo)不就是讓信息和服務(wù)主動(dòng)、無(wú)感地融入生活嗎于是一個(gè)常顯、低功耗、信息集中的物理儀表盤(pán)就成了一個(gè)很自然的需求。而電子墨水屏ePaper幾乎是這個(gè)需求的完美答案。它只在刷新時(shí)耗電顯示靜態(tài)內(nèi)容時(shí)幾乎零功耗這意味著你可以把它放在床頭、貼在冰箱上或者掛在玄關(guān)7x24小時(shí)顯示關(guān)鍵信息而不用擔(dān)心電費(fèi)或者屏幕燒屏。它本身不發(fā)光光線越強(qiáng)顯示越清晰非常適合作為環(huán)境信息板。這個(gè)項(xiàng)目就是要在十分鐘內(nèi)用最低的成本和最簡(jiǎn)單的步驟搭建起這樣一個(gè)專屬于你的Home Assistant墨水屏儀表盤(pán)。我們將使用一款非常流行的開(kāi)源硬件——reTerminal或者其核心板reComputer作為主控配合一塊ePaper屏幕通過(guò)ESPHome來(lái)橋接Home Assistant的數(shù)據(jù)。整個(gè)流程清晰直接即使你只有基礎(chǔ)的動(dòng)手能力也能輕松完成。下面我就帶你一步步實(shí)現(xiàn)它。2. 硬件選型與核心原理為什么是reTerminal ESPHome在開(kāi)始動(dòng)手前我們先花幾分鐘搞清楚我們選擇的硬件和軟件方案背后的邏輯。這能幫你理解每一步操作的意義甚至在將來(lái)需要調(diào)整或排查問(wèn)題時(shí)心里有底。2.1 主控選擇reTerminal/reComputer的優(yōu)勢(shì)市面上能驅(qū)動(dòng)ePaper的單板計(jì)算機(jī)很多比如樹(shù)莓派Zero 2W、ESP32系列開(kāi)發(fā)板等。我們選擇Seeed Studio的reTerminal或reComputer主要基于以下幾個(gè)考量集成度與易用性reTerminal本身就是一個(gè)帶5英寸觸摸屏的完整設(shè)備但它也提供了40針的GPIO排針可以方便地連接各種外設(shè)包括我們需要的ePaper屏幕。它的核心是一顆樹(shù)莓派CM4模塊這意味著它擁有完整的Linux操作系統(tǒng)Raspberry Pi OS和強(qiáng)大的計(jì)算能力遠(yuǎn)超一般的微控制器。供電與接口reTerminal通過(guò)Type-C接口供電和通信非常方便。其GPIO電壓為3.3V與大多數(shù)ePaper屏幕兼容無(wú)需額外的電平轉(zhuǎn)換電路。社區(qū)與生態(tài)作為樹(shù)莓派生態(tài)的一員它有龐大的軟件和社區(qū)支持。我們需要用到的ESPHome在Linux系統(tǒng)上部署和運(yùn)行非常成熟穩(wěn)定。如果你手頭沒(méi)有reTerminal使用reComputer不帶屏幕的版本或者樹(shù)莓派4B/3B搭配40Pin GPIO擴(kuò)展板也是完全可行的原理和步驟幾乎一致。2.2 顯示核心電子墨水屏ePaper的工作原理電子墨水屏的技術(shù)核心是“電泳”。屏幕由數(shù)百萬(wàn)個(gè)微膠囊構(gòu)成每個(gè)膠囊里充滿了帶負(fù)電的黑色粒子和帶正電的白色粒子懸浮在透明的液體中。當(dāng)在膠囊兩側(cè)施加一個(gè)電場(chǎng)時(shí)黑色或白色粒子就會(huì)被吸引到頂部從而形成像素點(diǎn)的黑或白顯示。這個(gè)過(guò)程有兩個(gè)關(guān)鍵特性決定了ePaper的優(yōu)缺點(diǎn)雙穩(wěn)態(tài)一旦粒子移動(dòng)到某個(gè)位置即使撤掉電場(chǎng)它們也會(huì)因?yàn)槲锢碜饔昧Χ３衷?。這就是為什么ePaper在顯示靜態(tài)圖像時(shí)不耗電——它只在刷新圖像改變電場(chǎng)時(shí)消耗能量。刷新慢粒子的物理移動(dòng)需要時(shí)間所以ePaper的刷新速度通常需要幾百毫秒到幾秒遠(yuǎn)低于LCD或OLED屏幕。這決定了它不適合顯示快速變化的視頻或動(dòng)畫(huà)但對(duì)于幾分鐘甚至幾小時(shí)更新一次的儀表盤(pán)來(lái)說(shuō)這根本不是問(wèn)題。我們項(xiàng)目中常用的尺寸是7.5英寸800x480分辨率或4.2英寸400x300分辨率它們通常通過(guò)SPI接口與主控通信驅(qū)動(dòng)庫(kù)非常成熟。2.3 軟件橋梁ESPHome的角色你可能會(huì)問(wèn)既然reTerminal本身就能跑Home Assistant為什么不直接寫(xiě)個(gè)Python腳本去拉取數(shù)據(jù)并刷新屏幕呢當(dāng)然可以但這會(huì)引入幾個(gè)復(fù)雜度需要處理Home Assistant的認(rèn)證API Token、需要管理網(wǎng)絡(luò)請(qǐng)求、需要解析JSON數(shù)據(jù)、需要處理定時(shí)任務(wù)等等。而ESPHome巧妙地解決了這些問(wèn)題。在這個(gè)架構(gòu)中ESPHome并不直接運(yùn)行在reTerminal上而是運(yùn)行在同一個(gè)家庭網(wǎng)絡(luò)中的另一臺(tái)設(shè)備上通常是Home Assistant服務(wù)器本身或者一臺(tái)常開(kāi)的電腦。它的角色是一個(gè)“虛擬設(shè)備”或“橋接器”。虛擬設(shè)備我們?cè)贓SPHome中定義一個(gè)“虛擬”的顯示屏設(shè)備它通過(guò)Home Assistant的API持續(xù)訂閱我們關(guān)心的實(shí)體entity狀態(tài)如sensor.living_room_temperature。數(shù)據(jù)橋接當(dāng)這些實(shí)體的狀態(tài)發(fā)生變化時(shí)Home Assistant會(huì)主動(dòng)通過(guò)WebSocket或API調(diào)用通知這個(gè)ESPHome設(shè)備。串口轉(zhuǎn)發(fā)這個(gè)運(yùn)行在后臺(tái)的ESPHome“設(shè)備”并不真正連接硬件屏幕。我們配置它將接收到的數(shù)據(jù)通過(guò)一個(gè)簡(jiǎn)單的協(xié)議比如自定義的文本格式輸出到串口Serial。reTerminal接收與渲染reTerminal通過(guò)USB轉(zhuǎn)TTL串口模塊或者直接使用其GPIO上的UART引腳連接到運(yùn)行ESPHome的電腦讀取串口數(shù)據(jù)。reTerminal上運(yùn)行一個(gè)輕量級(jí)的Python腳本解析這些數(shù)據(jù)然后調(diào)用ePaper的驅(qū)動(dòng)庫(kù)將新的狀態(tài)值更新到屏幕上。這樣做的最大好處是解耦和簡(jiǎn)化。reTerminal上的Python腳本只需要做兩件事讀串口和畫(huà)屏幕。所有復(fù)雜的Home Assistant交互、數(shù)據(jù)訂閱、網(wǎng)絡(luò)通信都由ESPHome在后臺(tái)默默完成。ESPHome成熟的yaml配置語(yǔ)法也讓管理多個(gè)數(shù)據(jù)源變得異常簡(jiǎn)單。3. 十分鐘快速搭建從零到顯示理解了原理我們現(xiàn)在開(kāi)始實(shí)戰(zhàn)。請(qǐng)確保你手頭有以下硬件reTerminal或reComputer/樹(shù)莓派一臺(tái)并已安裝好Raspberry Pi OS推薦Lite版本以減少資源占用。7.5英寸或4.2英寸的SPI接口ePaper屏幕一塊以Waveshare品牌為例。杜邦線母對(duì)母若干?？蛇xUSB轉(zhuǎn)TTL串口模塊一個(gè)用于調(diào)試和初期連接。如果reTerminal和運(yùn)行ESPHome的電腦在同一臺(tái)機(jī)器上可以直接使用虛擬串口。3.1 第一步硬件連接2分鐘我們將ePaper屏幕的SPI引腳連接到reTerminal的GPIO上。以7.5英寸屏幕V2版本和reTerminal為例ePaper 引腳功能reTerminal GPIO (物理引腳號(hào))備注VCC電源 (3.3V)Pin 1 (3.3V)務(wù)必接3.3V接5V會(huì)燒屏GND地Pin 6 (GND)DIN (MOSI)SPI數(shù)據(jù)輸入Pin 19 (GPIO10, MOSI)CLK (SCK)SPI時(shí)鐘Pin 23 (GPIO11, SCLK)CS (CE0)片選Pin 24 (GPIO8, CE0)使用CE0DC數(shù)據(jù)/命令選擇Pin 18 (GPIO24)可自定義代碼中需對(duì)應(yīng)RST復(fù)位Pin 22 (GPIO25)可自定義代碼中需對(duì)應(yīng)BUSY忙狀態(tài)指示Pin 16 (GPIO23)可自定義代碼中需對(duì)應(yīng)注意不同型號(hào)的ePaper屏幕引腳定義可能略有不同請(qǐng)務(wù)必以你購(gòu)買屏幕的說(shuō)明書(shū)為準(zhǔn)。連接時(shí)最好斷開(kāi)電源。3.2 第二步在reTerminal上準(zhǔn)備環(huán)境3分鐘通過(guò)SSH登錄到你的reTerminal。啟用SPI接口運(yùn)行sudo raspi-config選擇Interface Options-SPI-Yes啟用SPI驅(qū)動(dòng)然后重啟。安裝Python庫(kù)我們將使用Waveshare提供的Python庫(kù)來(lái)驅(qū)動(dòng)屏幕。sudo apt update sudo apt install python3-pip python3-pil python3-numpy -y git clone https://github.com/waveshare/e-Paper.git cd e-Paper/RaspberryPi_JetsonNano/python sudo pip3 install .這個(gè)庫(kù)包含了各種尺寸ePaper的驅(qū)動(dòng)代碼。安裝串口通信庫(kù)用于從串口讀取ESPHome發(fā)來(lái)的數(shù)據(jù)。sudo pip3 install pyserial3.3 第三步配置ESPHome“橋接”設(shè)備3分鐘在你的Home Assistant服務(wù)器或另一臺(tái)常開(kāi)電腦上已有ESPHome插件或獨(dú)立安裝。我們創(chuàng)建一個(gè)新的ESPHome設(shè)備配置。新建配置在ESPHome中新建一個(gè)設(shè)備命名為epaper_bridge選擇ESP32作為平臺(tái)這里我們只是利用其軟件功能并不需要真實(shí)硬件。編輯YAML配置核心是使用homeassistant傳感器和uart組件。esphome: name: epaper_bridge platform: ESP32 board: nodemcu-32s # 啟用Home Assistant API組件用于接收數(shù)據(jù) api: encryption: key: 你的api加密密鑰 # 啟用日志便于調(diào)試 logger: # 配置UART將數(shù)據(jù)輸出到串口 uart: id: uart_bus tx_pin: GPIO1 # 虛擬引腳實(shí)際對(duì)應(yīng)串口輸出 baud_rate: 115200 # 定義傳感器關(guān)聯(lián)Home Assistant中的實(shí)體 sensor: - platform: homeassistant name: Living Room Temperature entity_id: sensor.living_room_temperature id: temp_living on_value: then: - uart.write: TEMP,${id(temp_living).state}\n - platform: homeassistant name: Outdoor Humidity entity_id: sensor.outdoor_humidity id: humidity_outdoor on_value: then: - uart.write: HUMI,${id(humidity_outdoor).state}\n - platform: homeassistant name: Living Room Light State entity_id: light.living_room id: light_living on_value: then: - if: condition: lambda: return id(light_living).state on; then: - uart.write: LIGHT,ON\n else: - uart.write: LIGHT,OFF\n # 定義一個(gè)文本傳感器用于接收來(lái)自reTerminal的簡(jiǎn)單指令可選 text_sensor: - platform: uart id: uart_receiver on_value: then: - logger.log: Received from ePaper: $value這個(gè)配置做了幾件事定義了三個(gè)傳感器分別綁定到Home Assistant里的溫度、濕度和燈光實(shí)體。為每個(gè)傳感器設(shè)置了on_value觸發(fā)器。當(dāng)Home Assistant中對(duì)應(yīng)實(shí)體的狀態(tài)發(fā)生變化時(shí)會(huì)執(zhí)行其中的動(dòng)作。動(dòng)作為通過(guò)UART向串口寫(xiě)入一行格式化的文本例如TEMP,22.5。我們定義了一個(gè)簡(jiǎn)單的協(xié)議數(shù)據(jù)標(biāo)簽,數(shù)值以換行符\n結(jié)束。這樣在reTerminal端容易解析。編譯與運(yùn)行由于我們沒(méi)有真實(shí)ESP32硬件不能直接刷機(jī)。我們需要在ESPHome中“安裝”這個(gè)配置到“本地”。在ESPHome儀表板對(duì)該配置選擇“Install” - “Manual Download” - “Modern format (.pio)”。下載后在服務(wù)器上通過(guò)命令行運(yùn)行它# 進(jìn)入你存放ESPHome配置的目錄 cd /path/to/esphome/config # 運(yùn)行虛擬設(shè)備 esphome run epaper_bridge.yaml此時(shí)這個(gè)ESPHome服務(wù)會(huì)啟動(dòng)連接到你的Home Assistant并開(kāi)始監(jiān)聽(tīng)實(shí)體變化。它會(huì)把數(shù)據(jù)輸出到標(biāo)準(zhǔn)輸出stdout我們需要將其重定向到一個(gè)虛擬串口。3.4 第四步建立通信鏈路1分鐘我們需要讓reTerminal能讀到ESPHome服務(wù)輸出的數(shù)據(jù)。這里有兩種方法方法A同一臺(tái)主機(jī)推薦用于測(cè)試使用socat創(chuàng)建一對(duì)虛擬串口。# 在運(yùn)行ESPHome和reTerminal SSH會(huì)話的電腦上執(zhí)行 sudo apt install socat socat -d -d pty,raw,echo0 pty,raw,echo0命令會(huì)輸出兩個(gè)虛擬串口路徑例如/dev/pts/2和/dev/pts/3。它們已經(jīng)連接。將ESPHome的uart配置中的tx_pin注釋掉改用debug組件輸出到標(biāo)準(zhǔn)輸出然后用socat重定向# 運(yùn)行ESPHome將其輸出通過(guò)管道發(fā)給socat的一個(gè)端口 esphome run epaper_bridge.yaml 21 | socat - /dev/pts/2在reTerminal的Python腳本中打開(kāi)另一個(gè)虛擬串口/dev/pts/3進(jìn)行讀取。方法B兩臺(tái)主機(jī)更接近最終部署使用USB轉(zhuǎn)TTL串口模塊。將USB轉(zhuǎn)TTL模塊的TX引腳連接到reTerminal的RX引腳GPIO15物理引腳號(hào)10。將USB轉(zhuǎn)TTL模塊插入運(yùn)行ESPHome的電腦的USB口。在ESPHome配置中uart的tx_pin可以保持為一個(gè)虛擬GPIO因?yàn)镋SPHome在電腦上運(yùn)行時(shí)uart.write默認(rèn)是輸出到標(biāo)準(zhǔn)輸出。我們需要一個(gè)小的Python腳本在電腦上運(yùn)行讀取標(biāo)準(zhǔn)輸出并寫(xiě)入真實(shí)的串口。# bridge_serial.py 運(yùn)行在電腦上 import sys import serial import time # 替換為你的USB轉(zhuǎn)TTL串口設(shè)備名如COM3(Windows)或/dev/ttyUSB0(Linux) ser serial.Serial(/dev/ttyUSB0, 115200, timeout1) try: while True: line sys.stdin.readline() if line: print(fSending to serial: {line.strip()}) ser.write(line.encode(utf-8)) except KeyboardInterrupt: ser.close()運(yùn)行ESPHome服務(wù)并將其輸出通過(guò)管道傳遞給這個(gè)腳本esphome run epaper_bridge.yaml 21 | python3 bridge_serial.py3.5 第五步編寫(xiě)reTerminal上的顯示腳本1分鐘在reTerminal上創(chuàng)建一個(gè)Python腳本例如epaper_dashboard.py。#!/usr/bin/env python3 import serial import time from waveshare_epd import epd7in5_V2 # 根據(jù)你的屏幕型號(hào)導(dǎo)入 from PIL import Image, ImageDraw, ImageFont import threading # 初始化屏幕 epd epd7in5_V2.EPD() epd.init() epd.Clear() # 準(zhǔn)備畫(huà)布和字體 font_large ImageFont.truetype(/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf, 48) font_small ImageFont.truetype(/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf, 24) # 數(shù)據(jù)存儲(chǔ)字典 data { TEMP: --.-°C, HUMI: --%, LIGHT: OFF } def update_display(): 根據(jù)當(dāng)前數(shù)據(jù)刷新屏幕 # 創(chuàng)建一張新圖像初始為白色 image Image.new(1, (epd.width, epd.height), 255) draw ImageDraw.Draw(image) # 繪制標(biāo)題 draw.text((10, 10), Home Dashboard, fontfont_large, fill0) draw.line((10, 70, epd.width-10, 70), fill0, width3) # 繪制數(shù)據(jù) y_offset 90 line_height 60 draw.text((20, y_offset), fTemperature: {data[TEMP]}, fontfont_small, fill0) draw.text((20, y_offset line_height), fHumidity: {data[HUMI]}, fontfont_small, fill0) draw.text((20, y_offset 2*line_height), fLight: {data[LIGHT]}, fontfont_small, fill0) # 顯示到屏幕 epd.display(epd.getbuffer(image)) print(Display updated.) def serial_listener(): 監(jiān)聽(tīng)串口解析數(shù)據(jù) # 替換為你的串口設(shè)備如果是虛擬串口或USB轉(zhuǎn)TTL ser serial.Serial(/dev/ttyUSB0, 115200, timeout1) # 或 /dev/ttyAMA0 (GPIO UART) 或 /dev/pts/3 while True: try: line ser.readline().decode(utf-8).strip() if line: print(fReceived: {line}) parts line.split(,) if len(parts) 2: tag, value parts if tag in data: if tag TEMP: data[tag] f{value}°C elif tag HUMI: data[tag] f{value}% else: data[tag] value # 數(shù)據(jù)更新后觸發(fā)屏幕刷新 update_display() except Exception as e: print(fSerial error: {e}) time.sleep(5) if __name__ __main__: # 首次全屏刷新 update_display() # 啟動(dòng)串口監(jiān)聽(tīng)線程 listener_thread threading.Thread(targetserial_listener, daemonTrue) listener_thread.start() # 主線程保持運(yùn)行也可以加入定時(shí)全刷邏輯防止殘影 try: while True: time.sleep(60) # 每分鐘檢查一次可進(jìn)行定時(shí)全刷等維護(hù)操作 # 例如每6小時(shí)強(qiáng)制全刷一次 # if time.time() % (6*3600) 60: # epd.init() # 重新初始化可以清殘影 # update_display() except KeyboardInterrupt: print(Exiting...) epd.sleep()給腳本執(zhí)行權(quán)限并運(yùn)行chmod x epaper_dashboard.py然后python3 epaper_dashboard.py。如果一切順利你將看到屏幕初始化并顯示初始信息。當(dāng)你在Home Assistant中改變溫度、濕度或燈光狀態(tài)時(shí)屏幕上的內(nèi)容應(yīng)該會(huì)在幾秒內(nèi)更新。4. 優(yōu)化與進(jìn)階讓儀表盤(pán)更實(shí)用、更穩(wěn)定基礎(chǔ)功能跑通后我們可以從多個(gè)維度進(jìn)行優(yōu)化讓它從一個(gè)玩具變成一個(gè)真正可靠的家庭信息中樞。4.1 界面設(shè)計(jì)與布局優(yōu)化上面的示例腳本只展示了最簡(jiǎn)單的文本排列。我們可以利用PIL庫(kù)的強(qiáng)大功能設(shè)計(jì)更美觀的界面。使用模板圖片先用圖形設(shè)計(jì)軟件如Figma、GIMP設(shè)計(jì)好儀表盤(pán)的背景圖包含靜態(tài)的圖標(biāo)、裝飾框和文字標(biāo)簽。將這個(gè)背景圖黑白二值BMP或PNG格式放在reTerminal上。在Python腳本中先加載背景圖然后在對(duì)應(yīng)的坐標(biāo)位置動(dòng)態(tài)繪制變化的數(shù)據(jù)。這樣能獲得更專業(yè)的視覺(jué)效果。background Image.open(dashboard_bg.png) draw ImageDraw.Draw(background) draw.text((x, y), data[TEMP], fontfont, fill0) epd.display(epd.getbuffer(background))布局更多數(shù)據(jù)7.5英寸屏幕有800x480像素可以輕松布局8-10個(gè)關(guān)鍵信息。例如分為上下兩欄上欄顯示環(huán)境數(shù)據(jù)溫濕度、空氣質(zhì)量、天氣下欄顯示設(shè)備狀態(tài)燈光、門窗、電器功耗。添加簡(jiǎn)單圖形可以用draw.rectangle或draw.line畫(huà)簡(jiǎn)單的進(jìn)度條來(lái)表示傳感器數(shù)值如空氣質(zhì)量指數(shù)比純數(shù)字更直觀。4.2 通信協(xié)議與錯(cuò)誤處理強(qiáng)化我們之前定義的簡(jiǎn)單文本協(xié)議TEMP,22.5在家庭網(wǎng)絡(luò)環(huán)境下基本夠用但為了健壯性可以考慮以下改進(jìn)增加校驗(yàn)在行尾添加一個(gè)簡(jiǎn)單的校驗(yàn)和例如CRC8在reTerminal端進(jìn)行驗(yàn)證丟棄錯(cuò)誤數(shù)據(jù)。# ESPHome端 (使用lambda計(jì)算) on_value: then: - lambda: |- int crc 0; std::string msg TEMP, to_string(id(temp_living).state); for(char c : msg) crc ^ c; uart.write(msg * to_string(crc) \n);心跳與重連機(jī)制在ESPHome配置中添加一個(gè)定時(shí)器定期如每30秒發(fā)送一個(gè)PING消息。reTerminal端如果超過(guò)一定時(shí)間如2分鐘沒(méi)收到任何消息包括PING或數(shù)據(jù)則判定連接斷開(kāi)在屏幕上顯示“連接中斷”的提示并嘗試重新初始化串口連接。數(shù)據(jù)緩沖與去抖對(duì)于頻繁變化的傳感器如功率計(jì)可以在ESPHome端或reTerminal端做簡(jiǎn)單的去抖處理避免屏幕因刷新過(guò)于頻繁而出現(xiàn)殘影或縮短壽命。例如只在數(shù)值變化超過(guò)一定閾值或距離上次更新超過(guò)30秒時(shí)才發(fā)送。4.3 系統(tǒng)服務(wù)化與自啟動(dòng)我們不想每次重啟reTerminal后都手動(dòng)SSH進(jìn)去運(yùn)行Python腳本。創(chuàng)建系統(tǒng)服務(wù)在reTerminal上創(chuàng)建一個(gè)systemd服務(wù)文件。sudo nano /etc/systemd/system/epaper-dashboard.service寫(xiě)入以下內(nèi)容[Unit] DescriptionHome Assistant E-Paper Dashboard Afternetwork.target [Service] Typesimple Userpi WorkingDirectory/home/pi ExecStart/usr/bin/python3 /home/pi/epaper_dashboard.py Restarton-failure RestartSec10 [Install] WantedBymulti-user.target啟用并啟動(dòng)服務(wù)sudo systemctl daemon-reload sudo systemctl enable epaper-dashboard.service sudo systemctl start epaper-dashboard.service現(xiàn)在你的墨水屏儀表盤(pán)會(huì)在reTerminal啟動(dòng)時(shí)自動(dòng)運(yùn)行并在崩潰后自動(dòng)重啟。4.4 功耗與屏幕維護(hù)ePaper雖然省電但reTerminal樹(shù)莓派CM4本身功耗在2-5W左右。如果希望進(jìn)一步省電可以考慮使用更省電的主控如ESP32-S3但會(huì)犧牲部分性能和部署便利性。對(duì)于屏幕維護(hù)最關(guān)鍵的是防止殘影。長(zhǎng)期顯示同一靜態(tài)圖像可能導(dǎo)致粒子殘留。解決方法定期全局刷新在腳本中加入邏輯每顯示一定次數(shù)如20次局部更新后或每隔幾小時(shí)執(zhí)行一次完整的全屏清除和重繪epd.Clear() 全圖display。我們的示例腳本注釋里已經(jīng)提到了定時(shí)全刷的思路。深度睡眠如果你不需要24小時(shí)顯示可以配置屏幕在夜間或離家模式時(shí)進(jìn)入深度睡眠epd.sleep()并讓reTerminal也進(jìn)入休眠或關(guān)閉屏幕背光如果是reTerminal設(shè)備。5. 排查與調(diào)試當(dāng)屏幕沒(méi)有如預(yù)期顯示時(shí)即使按照步驟操作也可能會(huì)遇到問(wèn)題。這里提供一個(gè)清晰的排查鏈路。5.1 屏幕無(wú)任何反應(yīng)全白或全黑檢查電源和連接這是最常見(jiàn)的問(wèn)題。確認(rèn)屏幕VCC接的是3.3V不是5V。確認(rèn)所有杜邦線接觸牢固特別是GND?？梢杂萌f(wàn)用表測(cè)量屏幕排針上的電壓。確認(rèn)SPI已啟用運(yùn)行l(wèi)s /dev/spi*應(yīng)該能看到類似/dev/spidev0.0的設(shè)備。如果沒(méi)有返回raspi-config確認(rèn)SPI已開(kāi)啟并重啟。檢查驅(qū)動(dòng)庫(kù)安裝在Python中嘗試導(dǎo)入waveshare_epd庫(kù)看是否報(bào)錯(cuò)。python3 -c import waveshare_epd; print(OK)。驗(yàn)證屏幕型號(hào)確認(rèn)你導(dǎo)入的驅(qū)動(dòng)類如epd7in5_V2與你的屏幕型號(hào)完全一致。不同版本的屏幕驅(qū)動(dòng)可能不兼容。5.2 屏幕初始化成功但收不到數(shù)據(jù)更新確認(rèn)串口連接在reTerminal上運(yùn)行python3 -m serial.tools.list_ports查看可用串口。嘗試用簡(jiǎn)單的串口監(jiān)聽(tīng)程序測(cè)試是否有數(shù)據(jù)流入python3 -m serial.tools.miniterm /dev/ttyUSB0 115200替換為你的設(shè)備名。如果ESPHome端有數(shù)據(jù)發(fā)送你應(yīng)該能在這里看到。檢查ESPHome服務(wù)狀態(tài)在運(yùn)行ESPHome的電腦上查看其日志輸出確認(rèn)它已成功連接到Home Assistant并且沒(méi)有報(bào)錯(cuò)。檢查Home Assistant中對(duì)應(yīng)實(shí)體的狀態(tài)是否真的發(fā)生了變化?？梢栽贖ome Assistant開(kāi)發(fā)者工具-狀態(tài)中手動(dòng)更改一個(gè)實(shí)體狀態(tài)觀察ESPHome日志是否有對(duì)應(yīng)的輸出。檢查通信協(xié)議確認(rèn)reTerminal腳本中解析數(shù)據(jù)的代碼line.split(,)與ESPHome發(fā)送的格式完全匹配包括大小寫(xiě)和換行符。5.3 屏幕刷新出現(xiàn)殘影或鬼影啟用局部刷新模式一些ePaper驅(qū)動(dòng)庫(kù)支持局部刷新epd.display_Partial速度更快但更容易產(chǎn)生殘影。對(duì)于儀表盤(pán)應(yīng)用建議始終使用全局刷新epd.display。增加全刷頻率如前所述增加定時(shí)全屏清除重繪的邏輯。檢查電源穩(wěn)定性屏幕刷新時(shí)功耗較大如果電源特別是3.3V線供電不足可能導(dǎo)致刷新不徹底。嘗試縮短連接線或使用獨(dú)立的3.3V穩(wěn)壓模塊為屏幕供電。5.4 字體顯示為亂碼或方框這是因?yàn)橄到y(tǒng)中沒(méi)有對(duì)應(yīng)的字體文件。我們的腳本使用了DejaVu字體它是Raspberry Pi OS自帶的。如果缺失可以安裝sudo apt install fonts-dejavu-core。你也可以將喜歡的TTF字體文件上傳到reTerminal并在腳本中指定絕對(duì)路徑。整個(gè)項(xiàng)目從硬件連接到穩(wěn)定運(yùn)行核心在于理解數(shù)據(jù)流Home Assistant - ESPHome虛擬橋接- 串口 - reTerminalPython腳本- ePaper驅(qū)動(dòng)。只要這個(gè)鏈條的每一環(huán)都打通了一個(gè)個(gè)性化、低功耗、常顯的家庭信息中心就真正屬于你了。你可以根據(jù)自己的需求輕松地修改ESPHome的配置來(lái)添加更多傳感器或者修改Python腳本來(lái)設(shè)計(jì)更復(fù)雜的界面。