惟家智能機（Home Assistant）購買後注意提示及使用教學

• 盒子插上網線開機，進入路由器後台管理查看盒子的 IP 位址，打開瀏覽器輸入查詢到的位址 xx.xx.xx.xx:8123。
• 設定 HA 帳號密碼登入；沒問題的話進入路由器後台設定靜態 IP，固定惟家智能機 IP 位址，後續都用這個位址 IP:8123 來使用。推薦所有智能設備都在路由器裡固定靜態 IP。

• 在 Windows 系統「我的電腦」裡訪問 HA 資料夾。
• 檔案管理器左邊欄「本機」按右鍵 → 加入一個網路位置 → 輸入 \\xx.xx.xx.xx\config（xx 是盒子的 IP 位址）→ 輸入 Samba 帳號密碼即可管理盒子 Config 資料夾。

• 左邊欄 → 開發者工具 → YAML 配置頁面 → 配置檢查：先點檢查；若編輯的 configuration.yaml 配置沒問題才能選擇重新啟動，否則會提示哪一行錯誤而無法重啟，重新編輯後才能重啟。
• 🔴 切勿強行重啟，否則 HA 系統可能無法正常啟動。
• 「配置重載」裡的選項不用重啟整個 HA，可單獨重啟某個服務（如 HomeKit、MQTT 或某個插件）。

把所有設備接入 HA 後，再配置 HomeKit。

HomeKit 設置方法請參考：分享 HA 三個設定 HomeKit 的橋接技巧，讓你 HomeKit 設定更方便、使用更完美。

注意：電視、攝影機、空淨、播放器、擴大機等設備 HomeKit 無法直接完美支援，需要其他方法單獨配置。

• 更新：如果確實需要更新，系統與加載項會提示更新前備份，最好勾選。
• 備份：左邊欄 → 系統 → 備份。
• 智能機裡有一份出貨前的原始備份，前期折騰崩了可以恢復；後續配置好了推薦一週備份一次，特別是更新系統之前一定要備份。

左邊欄 → 配置 → 設備與服務 → 添加集成。常用集成/插件：

• Xiaomi Gateway3（小米多模網關接入）
• Xiaomi Miot Auto（小米 Wi-Fi 設備接入）
• Aqara Gateway（綠米網關 zigbee 設備接入）
• Ble Monitor（部分藍牙非 mesh 設備接入，如 Yeelight 藍牙遙控器、藍牙旋鈕、青萍人體傳感器、小米溫濕度計 2 等）
• Bemfa（巴法雲，把 HA 裡的設備或場景中轉到米家裡，可在米家做自動化控制）
• Sonoff（易微聯設備接入）
• Scheduler（HA 圖形化定時開關）
• iPhone Device Tracker（手機在家或離家追蹤）
• WebRTC（把支援 RTSP 協議的監控攝影機畫面接入 HA，非 HomeKit）
• Edge TTS（使用微軟語音結合接入 HA 的音箱設備做自定義 TTS 語音播報）
• File Editor 文件管理器（管理 Config 資料夾、編輯 configuration.yaml 等）

• 插件更新到 3.0+ 版後需看原作者說明是否支援多模網關 1 和 2 的最新固件，推薦更新；破解也不需輸入命令（插件已自動集成命令）。仍推薦網關固定 IP，固件不要追新，確定沒問題再更新。
• HA 左邊欄 → 配置 → 設備與服務 → 右下角添加集成 → Xiaomi Gateway 3 → Add Mi Cloud Account → 輸入米家帳號密碼 → 再次選擇添加集成 → Xiaomi Gateway3 → 列表會有小米多模網關 1 或 2。
• 頁面下面只勾選「支援 BLE 設備」和「Zigbee 和 BLE 效能數據」，提交即可（若出現掉線就取消這個勾選）。
• 多模網關 1 要在路由器設為靜態 IP，加入米家後關閉固件自動更新，固件版本最好是 v1.5.0_0102；其他固件或多或少有問題，可能需要降級。
• 多模網關 2 暫時沒支援藍牙（測試版）；如需接入：固件版本需 1.0.3_0028（1.05/1.06 不支援，需降級）。HACS → 集成 → 找到 Xiaomi Gateway 3 → 右上角三個點 → 重新下載 → 選最下面的 master → 下載完重啟 HA。

• HA 左邊欄 → 配置 → 設備與服務 → 右下角添加集成 → Xiaomi Miot Auto → 選擇帳號集成 → 輸入米家帳號密碼 → 自動模式 → 提交後設備與服務裡就有此插件。
• 點插件卡片的「選項」→ 勾選「更新設備列表」後提交 → 選擇「包含」→ 勾選需要接入的設備後提交即可。

第一次使用需開啟 telnet。開啟 telnet 前，請將網關（M1S、P3、E1 適用）切換到米家模式並接入：

• 插上電源，等待「請打開 Aqara Home APP」語音出現。
• 快速連續按 M1S 網關上面的按鍵 10 次（連按不是長按）。
• 聽到「正在恢復出廠設置」或「恢復出廠設置成功」，且指示燈開始閃爍。
• 再快速連按兩次按鍵。
• 聽到「請打開米家 APP 添加設備」就搞定了（較老固件可能沒有語音提示，從 app 查找）。

注意：所有網關要在路由器設為靜態 IP，加入米家或 Aqara App 後關閉固件自動更新。

取得 token：下載 token_extractor.exe，打開後輸入米家帳號密碼會列出米家下設備的資訊，找到網關的 token 記錄下來。

M1S 網關打開 telnet：HA 左邊欄 → 打開 Terminal 依次輸入運行：

運行成功後就打開了網關的 telnet。

E1 網關打開 telnet：使用 putty 軟件選擇 telnet → 輸入網關 IP → 帳號 admin、密碼空，成功進入後：

• 開始自動刷寫自定義固件；刷寫完畢後輸入 reboot。
• 如使用米家模式可繼續操作；如需 Aqara 模式則按上面方法切換後再繼續。
• HA 左邊欄 → 配置 → 設備與服務 → 右下角添加集成 → Aqara Gateway → 輸入網關 IP、token、選擇網關型號提交即可（密碼為空）。
• 注意：接入後網關最好不要在米家或 Aqara App 升級，否則可能導致無法接入或接入的設備有問題。

• 註冊帳號 → 登入後複製左上角用戶名下面的私鑰 → HA 集成裡添加 Bemfa → 輸入私鑰即可添加 HA 中的部分實體。
• 小愛同學：米家 app → 我的 → 其他平台設備 → 添加 → 找到「巴法」，輸入巴法雲帳號即可，設備會自動同步到米家。
• 天貓精靈：天貓精靈 app 搜尋「巴法雲」→ 找到巴法雲技能 → 綁定帳號 → 登入巴法雲帳號。
• 小度音箱：小度 app 首頁 + 號 → 添加設備 → 搜尋「巴法」→ 輸入巴法雲帳號即可。

常見問題：

• 支援同步的實體：受巴法雲限制，目前僅支援開關類、燈類、風扇類、窗簾類、空調類與溫度/濕度/開關/光照傳感器；各語音助手支援各有區別（如小度不支援風扇類和空調類）。此插件會把掃地機/腳本/自動化/場景等虛擬成開關類，可語音開關。
• 調燈顏色卻調到色溫：巴法雲中燈的顏色和色溫為同一欄位，此插件無法精確區分。
• 更改實體名字：預設為 HA 平台上的名字，可改 HA 名字後重新配置插件；或直接登入巴法雲平台改主題名（下次重配插件會同步回去）。
• 增加/刪除實體：目前只能先刪除插件再重新配置（重配時會預設選中上次配置的實體）。

HA 左邊欄 → 配置 → 設備與服務 → 右下角添加集成 → Sonoff → 輸入帳號密碼 → 選擇 Auto 提交即可。

HA 左邊欄「概覽」→ 右上角三個點 → 編輯儀錶板 → 右下角添加卡片 → 找到自定義 Scheduler Card（或概覽的計劃任務卡片下點編輯）→ 左邊 ENTITIES 選需要控制設備的類型與條件傳感器 → 保存後在計劃任務卡片點添加 → 選被控設備（如插座）→ 設定自動開/關時間，還可設「滿足某條件才開關」（如有人在家、檢測到某房間有人）。

在檔案管理裡編輯 configuration.yaml，添加：

• hostname1 代表手機 1，後面是手機 1 在路由器裡取得的 IP 位址。
• 此插件追蹤 iPhone 較準，晚上待機也不會切換為未在家；安卓手機不一定準確（wifi 休眠問題），需自行測試。

管理 HA 的 Config 資料夾與 configuration.yaml 等：HA 左邊欄 → 文件管理 → 左邊資料夾、右邊檔案 → 找到 configuration.yaml 後點右邊箭頭選編輯即可。configuration.yaml 有專門的格式要求（少一個空格都無法生效），編輯完的內容一般需要重啟 HA 後生效。

• 左邊欄 → 配置 → 設備與服務 → 右下角添加集成 → Sony Bravia TV → 輸入電視 IP → 等電視出現配對碼輸入後完成。
• 添加集成 → HomeKit → 不勾選直接提交 → 找到剛建立的 HomeKit → 選項 → HomeKit 模式選 accessory → 包含模式 include → 包含的域 Media Player → 實體選 Sony 電視 → 提交完成。
• 左邊欄通知裡會出現 HomeKit 配對碼，打開 iPhone 家庭 APP 掃碼配對即可。

左邊欄 → 配置 → 設備與服務 → 右下角添加集成 → Webrtc Camera → 地址留空提交 → 設置外部訪問密碼後提交。此集成不會添加實體，只會建立兩個服務和首頁卡片。

左邊欄「概覽」→ 右上角三個點 → 編輯儀錶板 → 右下角添加卡片 → 自定義 Webrtc Camera → 填寫攝影機的 RTSP 位址（海康、大華、TP-Link 等品牌攝影機設置裡都有 RTSP 位址，小米系列不支援此協議）：

• 先接入博聯 APP，然後在設備選項裡把「設備上鎖」功能取消。
• HA 左邊欄 → 配置 → 設備與服務 → 右下角添加集成 → 會自動出現博聯設備點配置即可（沒出現就添加裡選 Broadlink 再輸入設備 IP）。
• 學習紅外命令：左邊欄 → 配置 → 場景自動化 → 上面選「腳本」→ 添加腳本 → 順序下點添加動作 → 調用服務 →「遙控: Learn Command」。

學習界面欄位：目標選博聯遙控器實體；Device = 學習的設備名（如 Sony）；Command = 命令自定義名（要一次學多個就依序添加）；Command Type 選 IR（紅外）或 RF（射頻）；Timeout = 等待時間（如 15 秒，15 秒內用遙控器對準按下）。多個命令名格式如下：

學習完會在通知或「文件管理器 → .storage → broadlink_remote_XXXX_flags」看到學到的命令代碼。發送命令用「遙控: Send Command」，Command 輸入學到的命令，格式如下（必須 b64: 開頭）：

把每個命令設成執行腳本，點一次就發送命令；腳本可接入 HomeKit（以開關形式）。HA 的 HomeKit 設置裡只要包含了 Scripts 域，就能把學到的紅外命令腳本以開關形式同步到 HomeKit 調用。