ESPHome 2026.10 新功能怎麼用？Wi-Fi 動作偵測、PIR／毫米波比較與感測器升級指南

想在房間加上自動開燈功能，手邊剛好有一塊 ESP32，能不能直接拿來偵測人走動？ESPHome 在 2026 年 10 月 21 日發布的 2026.10.0，加入 ESPectre 元件，讓這個想法有了框架內建的整合途徑。同一版也補上二氧化碳、雷射測距等感測器支援，並改善韌體更新傳輸。

這篇寫給已經使用 Home Assistant，或準備用 ESP32 製作感測節點的人。先釐清你要知道的是「有人經過」「人還在不在」，還是「距離與環境數值」，再決定要用哪一種感測方式。本文依官方文件與版本原始碼整理；現場部署方法是我們的工程建議，未宣稱完成實體場域測試。

先依自動化目的選感測方式

走廊有人經過就開燈，與書房有人安靜閱讀就保持照明，需要的證據不同。前者關心短時間的變化；後者需要持續判斷占用狀態。把兩種需求都寫成「人體感測」，很容易在採購時選錯，也容易在自動化設定中把「目前沒有偵測到動作」誤當作「房內沒有人」。

手機閱讀可左右滑動表格。

PIR 讀取視野中紅外線的變化，原理與鏡頭配置決定了它對不同移動方向的反應。毫米波方案則能利用反射訊號處理微小動作；能否辨認微動，仍要看模組、韌體與設定。Panasonic 的 PIR 技術說明與 TI 的占用偵測案例提供了兩種方式的原理依據，不能把某一套展示系統的結果直接套用到所有市售模組。PIR 原理與限制、TI 毫米波占用偵測案例。

ESPectre 偵測的是無線通道變化

Wi-Fi CSI（Channel State Information，通道狀態資訊）描述無線訊號經過環境後的通道特徵。人在基地台與 ESP32 周圍移動，會改變部分傳播與反射路徑；ESPectre 以這些資訊形成動作判斷。處理在 ESP32 端進行，不必另外接一顆動作感測器，但仍需要供電、可用的 Wi-Fi 基地台與合適的佈點。

這與看 Wi-Fi 訊號強度 RSSI 是否升降不同。也不要從「無線訊號受人體影響」延伸成穿牆定位、精準人數統計或靜止人體存在保證。ESPHome 元件文件明確把能力界定為動作偵測，並說明結果取決於位置、基地台及無線環境。ESPectre 元件文件。

在自動化中，建議把感測輸出視為一個事件來源。例如工作室有人走進來，先開啟走道照明；若要決定何時關閉工作燈，還要考慮桌面活動、存在感測器或使用者的手動覆寫。這樣比較能避免把單一動作訊號承擔不了的判斷，藏進關燈條件裡。

先確認板子與韌體，再選安裝位置

2026.10.0 的 ESPectre 元件列出 ESP32、S2、S3、C3、C5、C6 支援，並對框架版本做檢查：ESP-IDF 至少 5.5.3，Arduino 至少 3.3.7；在 ESPHome 內，C5、C6 要走 ESP-IDF。這是元件和框架的組合條件，不能只憑賣場標題出現「ESP32」就判定可用。固定版本的驗證規則。

對第一次試作的人，我們建議先使用一塊功能單純、供電穩定的開發板，讓它專心做動作偵測。元件需要持續取得適當的無線資料，會關閉 Wi-Fi 省電，並調整封包聚合與漫遊相關行為。若同一塊板子同時負責音訊串流、大量網頁傳輸或頻繁更新，就要另外測試共存表現；也不宜直接沿用一般休眠型電池節點的耗電預估。

位置先求固定，再求靈敏。把開發板固定在不會被碰動的地方，記錄它與基地台、門口、座位的相對位置。先用 2.4 GHz 完成一輪驗證，避免把尚未確認的頻段、Mesh 漫遊與演算法變動混在同一輪測試。官方建議的環境校正與限制可由ESPectre 專案和元件文件交叉確認。

一個房間的試作，要留下哪些紀錄？

下面是一套建議的測試流程，次數與時間是便於比較的試作設定，並非官方合格標準。目的在於找出「什麼情況會判錯」，而不只是錄下一段成功開燈的影片。

1. 先建立空房基準。板子和基地台固定後，以預設設定啟動；使用預設 Lightweight 模式時，讓校正期間保持安靜。記錄空房狀態下的動作事件。
2. 走相同路線重複測試。例如進門、走向桌邊、走到房間另一側，各走十次。分開記錄有沒有觸發、觸發位置與延遲；不要把不同路線混成一個成功率。
3. 加入日常干擾。依序開啟電風扇、讓窗簾擺動、開關門，再觀察空房是否出現事件。這些是待測干擾情境，不能預先假定一定會或一定不會觸發。
4. 安排靜坐與離開。記錄人在座位上不動時的輸出，以及離開後多久不再觸發。靜坐沒有事件應回到感測原理解讀，不能立即認定是故障。
5. 驗證復原。重啟基地台與節點，檢查重新連線、校正及 Home Assistant 實體恢復。把離線和資料不可用另外記錄，別把它們統計成「無人」。

每次只改一個因素，例如擺放位置或判定設定。保留日期、版本、位置照片與事件紀錄，下一次換基地台時才有可比對的基準。若空房誤報多，先檢查位置、無線來源和干擾，再調整門檻；若走動能被辨認、靜坐卻無法維持占用判斷，就應重新評估感測方式，而不是一味提高靈敏度。

正式接上照明前，可先讓自動化只寫入紀錄或送出通知，經過一般使用時段的觀察，再加入燈具控制。關燈應採用持續無動作的等待條件，並保留手動控制；等待時間要依房間用途決定。沒有資料、離線與確認無動作，應是三種可分辨的狀態。

同版新增的兩種感測器，能解決不同問題

STCC4：接上 CO₂ 數值後，還要處理補償與模組差異

STCC4 以熱導率量測二氧化碳，溫濕度補償是整合的重要部分。ESPHome 的 stcc4 平台使用 I²C，支援 CO₂ 輸出及相關補償設定；溫濕度讀值與板上是否有適當連接的 SHT4x 有關。選購時要確認完整模組的供電、邏輯電壓與感測器配置，不能把晶片名稱當作所有轉接板的共同規格。STCC4 整合文件。

以會議室通風觀察為例，先選定不被人直接呼氣吹到、也不緊貼送風口的位置，觀察不同使用時段的變化，再設計通知和換氣邏輯。若直接把單次瞬間讀值當成控制指令，擺放位置造成的短暫變化就可能讓風扇反覆切換。這裡的重點是把環境量測變成可解釋的趨勢，不從一顆感測器推算精準人數。

TF-Luna：距離之外，也要看訊號品質

新版的 tfluna 元件走 I²C，可取得距離與訊號強度等資訊。官方文件列出的量測範圍仍受目標反射、視野與環境光影響；訊號不足或飽和時，距離資料可能不可用。因此整合前要確認手上 TF-Luna 的介面模式，不能把 UART 接線範例直接套用到這個 I²C 元件。TF-Luna 元件說明。

例如想判斷展示架前是否有物體接近，應先用實際目標的材質、角度與背景測試。自動化除了檢查距離，也應檢查資料是否有效；把未知值當成零距離，可能會造成持續觸發。距離、動作與存在是不同觀察量，資料名稱最好直接反映它們各自的意義。

升級 ESPHome：先驗證一台，再擴大更新

2026.10 把壓縮 OTA 擴充到 ESP32、RP2040 等平台。它減少的是更新時要傳送的資料；更新端與裝置端都支援後才會協商使用，所以從舊韌體第一次升級，不能預期立刻得到同樣的壓縮效果。它也不會替你增加 Flash 容量或免除斷電復原規劃。ESPHome OTA 文件。

建議先保存既有 YAML、外部元件版本及可復原的韌體，挑一台容易接上 USB 的節點升級。依序檢查設定驗證、編譯、燒錄、實體讀值、重啟狀態和原有自動化，全部確認後才處理不方便拆裝的設備。家中若有燈光的 initial_state 設定，這一版修正了開機初始狀態行為，也要實際斷電重開確認。2026.10 官方發布與升級說明。

如果你原本就想做一個房間的動作事件實驗，ESPectre 值得先試；如果目標是讓人在座位上時照明持續開啟，就把具有存在偵測能力的方案一起納入驗證。需要進一步比較實際模組，可接著閱讀我們的人體存在與 PIR 感測器選型指南。

實作與選型諮詢

台灣智能感測科技有限公司（TaiwanSensor）提供感測器、開發板與物聯網整合相關產品資訊。詢問選型時，請附上房間用途、想觸發的動作、供電方式、既有主機與手上板子的完整型號；這些條件比只問「哪一顆最靈敏」更能縮小選擇範圍。可由TaiwanSensor 官網查看產品與聯絡資訊。