
用 ESP32 與 ESPectre 建立本地 Wi‑Fi 房間動態偵測
ESPectre 是一個開源項目,可利用 ESP32 的 Wi‑Fi 無線電分析訊號變化,把閒置開發板變成房間動態偵測節點,毋須另接 PIR 模組、鏡頭或咪高峰。對已使用 Home Assistant、手上又有 ESP32 的 DIY 用戶而言,這提供了低成本而且資料可留在屋內的自動化入口,例如以有人走動作為開燈觸發條件。
不過,動態偵測不等於人員存在偵測。來源作者的實作也指出,人在梳化上靜坐、工作枱前久坐或睡覺時,系統未必知道對方仍在房內;它亦不能辨識或計算人數。部署前應先接受這個界線,否則用它控制熄燈,體驗隨時會幾掃興。
Wi‑Fi CSI 怎樣感應移動
Wi‑Fi 封包帶有通道狀態資訊(CSI),用以描述訊號從 router 到 ESP32 的傳播情況。有人在房內走動會干擾這條無線路徑,CSI 隨之改變;ESPectre 在裝置端分析變化,輸出動態狀態及 movement score。
這個設計的私隱取捨相當清楚:它不拍攝畫面、不收錄聲音,並可在本地運算,毋須把資料上傳雲端。但訊號變化本身仍可反映日常活動模式,資料保存和 Home Assistant 的存取權限同樣應由屋主妥善設定。
來源列出的支援範圍包括 ESP32、ESP32-S2、S3、C3、C5 及 C6,使用一般 2.4GHz Wi‑Fi 4 網絡。板子在 router 發送封包時擷取讀數;預設會向 Wi‑Fi gateway 發出 ping,以維持足夠的封包流量。
接入 Home Assistant 的較直接做法
ESPectre 提供 Native、ESPHome、Matter 及 MicroPython 韌體選項。若目標是 Home Assistant,來源作者選擇 ESPHome,原因是 ESPectre component 可讓實體直接出現在 Home Assistant。基本 YAML 設定可建立 binary_sensor;另可加入 movement score 感應器及重新校準按鈕。桌面版 Chrome 亦可透過 espectre.dev 的網頁燒錄器安裝。
實作時有幾項相容性條件:ESPHome 需使用 ESP-IDF 5.5.3 或更新版本,而 C5 與 C6 僅可配合 ESP-IDF。開源項目的晶片支援及版本要求可能變動,實際燒錄前應以專案文件為準。
預設的 Lightweight 模式會以約 10 秒的安靜環境建立門檻,開機校準期間要讓房間保持靜止。High Accuracy 模式則使用裝置上的神經網絡,毋須這段安靜校準;來源中另一名作者稱切換後偵測較準確,但這仍屬個別實測,不能視為所有房間和型號的保證。
先處理擺位,再調參數
CSI 偵測對 access point、板子位置及無線電環境敏感。來源建議多個 access point 的家居中,把 ESP32 放近最強的 access point,理想訊號強度介乎 -40 dBm 至 -70 dBm;系統會暫停 roaming scan,因為掃描會清空 CSI 視窗。若結果不穩定,先移動板子通常比立即反覆調校設定更合理。
ESPectre 約預期每秒有 100 個封包。為配合偵測,它會自動關閉 Wi‑Fi 省電及 frame aggregation(AMPDU);官方文件警告,這些設定作用於整個韌體,可能降低吞吐量。因此,同一塊板上的 OTA 更新、網頁 server 或音訊串流可能變慢。每塊板雖可運行其他 component,但只有一個 ESPectre component 可使用無線電,而且關閉省電也令它較適合作為 USB 供電節點,而非電池裝置。
對走廊、儲物間及以走動觸發的燈光而言,一房一板的做法有實際價值。至於書枱、睡房或需要確認「仍然有人」的地方,分析上較適合把它視為一個動態訊號,配合其他存在感應方式或自動化延時,而非單獨作出熄燈判斷。下一步值得觀察的是不同房間佈局、router 與 ESP32 型號下的穩定性,以及專案更新後的相容性。
延伸閱讀
AI 輔助說明: 本文由 AI 協助整理。
參考來源
- XDA Developers — I turned spare ESP32 boards into motion sensors for rooms using a free open-source project without a single sensor — original report
本文根據原文及公開資料整理;資料有出入時,以原文及官方資料為準。







