掃地機器人接進 Home Assistant：三條路線、分區清掃與連動

charles

這篇的內容（17 段）

1. 做完之後你會有
2. 步驟 3（路線 B）：Matter
3. 步驟 4（路線 C）：Valetudo
4. 4-1 三種刷入路徑
5. 4-3 刷之前一定要先做的兩件事
6. 4-4 刷完之後接進 Home Assistant
7. 步驟 6：叫它掃指定的房間
8. cleaning_area_id 要填什麼
9. 步驟 7：出門就掃
10. 三個設計重點
11. 步驟 9：掃完通知、卡住通知
12. 零件清單
13. 220Ω 是怎麼算出來的
14. 完整的 ESPHome 設定檔
15. 步驟 11：把按鈕接上動作
16. 步驟 12：其他家電要不要接
17. 通過這篇的標準

Home Assistant 2026.9 把掃地機整個重做了一次，版本代號就叫「There's room on this bus」—— room 是雙關，這一版終於有了標準化的「掃指定房間」。

在那之前，分區清掃要靠每家廠商自己的 vacuum.send_command 傳一串只有那個牌子看得懂的分區編號。現在有一個所有支援的機器通用的動作：vacuum.clean_area，而且直接對應到 Home Assistant 自己的「區域」。



這篇從「確認你的機器走哪條路」開始，做到分區清掃、出門自動掃、掃地時不要誤觸發其他自動化，最後做一個放在玄關的實體按鈕。

做完之後你會有

• 一個 vacuum.xxx 實體，看得到狀態也控制得了
  
• 掃地機的分區對應到 Home Assistant 的區域，可以直接說「掃客廳」
  
• 三條自動化：出門就掃、掃完通知、卡住了通知
  
• 一個不會被掃地機誤觸發的人體感測器
  
• 一個玄關按鈕，按一下掃客廳、按另一顆掃臥室
  

步驟 1：先確認你的機器走哪一條路

三條路，優先順序由易到難：

• 路線 A：原廠整合 —— 最簡單。小米、石頭（Roborock）、Dreame、iRobot 都有社群或官方整合。多數要登入廠商帳號，控制指令有些走雲端、有些走本地
  
• 路線 B：Matter —— 新機型才有。不用帳號、完全本地，但功能比較基本
  
• 路線 C：Valetudo —— 刷開源韌體，把整台機器從雲端切斷，功能最完整而且百分之百本地。但只有特定型號可以，而且有把機器變磚的風險
  

怎麼查你的機器在不在 Valetudo 的支援清單上

打開 valetudo.cloud 的 Supported Robots 頁面。官方在頁面開頭就寫了一句話：這份清單是窮舉的，不在上面就是不支援（原文：this list is exhaustive）。

你會看到這些廠牌與型號：

1. Xiaomi     V1 / 1C / 1T / P2148 / Vacuum-Mop P /
2.            Vacuum-Mop 2 Ultra / X10 Plus
3. Dreame     D9 / D9 Pro / F9 / L10 Pro / Z10 Pro / W10 / W10 Pro /
4.            L10s Ultra / D10s Pro / D10s Plus / L10s Pro Ultra Heat /
5.            L20 Ultra / X30 Ultra / L40 Ultra / X40 Ultra / X40 Master
6. MOVA       Z500 / S20 Ultra / P10 Pro Ultra
7. Roborock   S5 / S6 / S6 Pure / S4 / S4 Max / S5 Max /
8.            S7 / S7 Pro Ultra / Q7 Max
9. Viomi      V6 / SE
10. Eureka     J15 Max Ultra / J15 Pro Ultra / J15 Ultra / J12 Ultra /
11.            E20 Evo Plus / E20 Plus
12. Cecotec    Conga 3290 / Conga 3790
13. Proscenic  M6 Pro
14. Commodore  CVR 200
15. IKOHS      Netbot LS22

複製代碼

⚠ 同一個型號名稱不代表同一台機器。 官方文件自己舉的例子：Xiaomi 1C 有好幾個硬體版本共用同一個名字，只有 dreame.vacuum.mc1808 那個版本支援，分辨方法是看機器發出的 Wi-Fi 熱點 SSID。Xiaomi V1 則是以 2020 年 3 月 為界：更早出廠的可以用筆電做 OTA 破解、保固封條完整；之後出廠的要整台拆開。

所以「我朋友的同型號刷成功了」不是證據。 買二手要刷的機器之前，先照官方文件的方法確認硬體版本。

不在清單上怎麼辦 → 走路線 A 或 B。不要去論壇問「有沒有人試過」，官方文件明文請大家不要問這個 —— 能不能刷取決於有沒有人找到那台機器的安全漏洞，不是有沒有人「試過」。

步驟 2（路線 A）：用原廠整合接上

以最常見的幾種為例：

• 石頭 Roborock —— 設定 → 裝置與服務 → 新增整合，搜尋 Roborock，用你 Roborock App 的帳號密碼登入
  
• 小米 / 米家 —— 搜尋 Xiaomi Miio。有些機型需要先拿到裝置的 token
  
• Dreame —— 目前要透過 HACS 安裝社群整合
  
• iRobot / Roomba —— 搜尋 iRobot
  

你會看到：整合加完後出現一個裝置，底下至少有一個 vacuum.xxx 實體。到 開發者工具 → 狀態 搜尋 vacuum.，狀態應該是 docked（在充電座上）。

vacuum 實體只有八種狀態，這是通用的，跟牌子無關：

1. cleaning      正在清掃
2. docked        在充電座上（含充電中）
3. returning     正在回充，但還沒到
4. paused        暫停，而且不在充電座上
5. idle          沒在掃、沒回充、也沒有錯誤
6. error         發生錯誤
7. unavailable   實體目前連不上
8. unknown       還不知道狀態

複製代碼

⚠ 電量不在 vacuum 實體的屬性裡。 現行的 vacuum 實體文件完全沒有電量這個欄位 —— 電量是由各個整合另外提供一個獨立的 sensor 實體。到 設定 → 裝置與服務 點進你的掃地機裝置，你會看到一個類似 sensor.xxx_battery 的實體。

舊教學寫 state_attr('vacuum.xxx', 'battery_level') 的，現在會回 None，而且不會報錯 —— 模板算出來就是空的，自動化安靜地不動。這是最容易踩的一個坑。

實測一次：到 開發者工具 → 動作，選 吸塵器.開始清掃（vacuum.start），目標選你的機器，按執行動作。

以下還有約 80% 的內容
登入後即可閱讀完整教學

登入繼續閱讀使用 Google 登入