萬物皆可HA？教你把各種智能設備接入Home Assistant 圖文教程
請配合視頻教程食用喔。
廢話不多說，本期教程教大家把常見的智能家居平臺設備接入Home Assistant（以下簡稱 HA），包括米家、Aqara Home、涂鴉，以及其他支持HomeKit的設備。其他平臺因為我沒相應設備，就煩請大家多搜搜教程啦，推薦一個論壇“瀚思彼岸”（https://bbs.hassbian.com）。
以下是部分智能平臺的接入方法，我這里就具體講前五種。
HA的安裝我之前的視頻講過，網(wǎng)上各種設備的安裝教程也有很多，我就不再贅述。
由于不同人安裝的 HA 的版本不同，界面可能會有些許不同，不過基本思路相同，不會影響操作。但為了避免各種奇奇怪怪的問題，建議通過官方渠道安裝，并升級到最新版的 HA 。我使用的 core 版本是 2023.3。
本教程均不會影響設備在原生態(tài)平臺的操作及聯(lián)動。我也會把圖文教程發(fā)在B站專欄。
本教程需要的環(huán)境：
1、安裝了 HACS 商店 的 Home Assistant。
2、流暢的互聯(lián)網(wǎng)環(huán)境。
3、SSH/Telnet工具（按需）。Windows 推薦 MobaXterm，MacOS 推薦 Royal TSX。
一、米家設備
米家設備分為 Wi-Fi 設備（大部分電器，部分舊款燈具等）、藍牙/藍牙Mesh設備（大部分傳感器、開關、燈具等）和 ZigBee 設備（綠米相關傳感器、開關等）。
1、Xiaomi Miot Auto
倉庫地址：https://github.com/al-one/hass-xiaomi-miot
表格第一行 Xiaomi Miot Auto 集成，因為它是通過輪詢來獲取設備的狀態(tài)，所以不支持實時監(jiān)聽無線開關、人體門窗傳感器之類設備的事件。所以你如果只是想把米家設備接入 HA ，并且橋接到 HomeKit 來控制的話，這個集成也夠用了。且大部分 Wi-Fi 設備能本地接入，支持斷網(wǎng)控制，藍牙和 ZigBee 設備則需要云端控制。
(1) 在 HACS 商店下載集成
點擊左側 HACS ，點擊右邊 “集成”，選擇右下角 “瀏覽并下載存儲庫”。
搜索 “Miot Auto”。
進入詳情頁后點擊右下角 “下載”，在選擇版本界面直接點擊下載，稍等片刻。
下載完之后返回 HACS 首頁，會提示等待重啟，點擊 “前往”，點擊 “重新啟動”。
(2) 添加集成并綁定小米賬號
重啟完成后，點擊左側 “配置”-“設備與服務”，右下角 “添加集成”。
搜索 “Miot Auto”，點擊進入并選擇第一個 “賬號集成”，下一步。輸入小米賬號和密碼后，其他不用改，點擊 “提交”。
(3) 篩選你需要的設備
在 “篩選設備” 界面，選擇你需要接入的設備，建議使用包含模式。
設備列表中，括號里是 IP 地址的代表的是 Wi-Fi 設備，基本可以本地控制；其他顯示型號代碼的則是藍牙或者 ZigBee 設備，只能云端接入。點擊 “提交” 稍等片刻，出現(xiàn)成功界面，選擇一下設備所在的房間，點擊 ”完成“。
(4) 盡情控制吧
在集成界面點擊設備，就可以隨心控制啦。
2、Xiaomi Gateway 3
倉庫地址：https://github.com/AlexxIT/XiaomiGateway3
如果要對米家藍牙/藍牙Mesh或者接入多模的 ZigBee 設備進行本地控制，或者想要把米家的人體門窗傳感器、無線開關等觸發(fā)類設備接入 HA ，就需要用到這個 Xiaomi Gateway 3 集成。使用此集成需要一臺小米多模網(wǎng)關，一代二代都可以。如果你有小米中樞網(wǎng)關，由于它會跟同網(wǎng)絡下的多模網(wǎng)關“搶設備”，造成接入 HA 后部分設備狀態(tài)丟失，顯示不可用，所以需要把中樞網(wǎng)關斷電，雖然損失了跨網(wǎng)關本地自動化和極客版自動化的功能，但是 HA 強大的本地聯(lián)動和 Node-Red 自動化編輯器完全可以替代它們。
(1) 下載集成
在 HACS 商店下載集成 Xiaomi Gateway 3，方法同上。
(2) 添加集成并綁定小米賬號
重啟后，在集成頁面點擊右下角，添加 Xiaomi Gateway 3 集成，選擇 “Add Mi Cloud Account”。
輸入小米賬號和密碼，點擊提交。
(3) 添加網(wǎng)關及子設備
再次添加集成，會自動列出支持的設備，選擇添加多模網(wǎng)關，點擊提交。
稍等片刻，刷新下界面，就能顯示出網(wǎng)關下的子設備啦。
如果顯示不可用，等待一會或者手動觸發(fā)一下傳感器，讓子設備主動上報一次網(wǎng)關就可以了。
二、Aqara ZigBee ?網(wǎng)關
倉庫地址：https://github.com/niceboygithub/AqaraGateway
如果你用的是 Aqara（綠米）的 ZigBee 網(wǎng)關，比如M1S、M2、空調伴侶P3等，可以通過 Aqara Gateway 集成來把子設備接入 HA ，無論接的是米家還是 Aqara Home （M2、H1網(wǎng)關需要拆機焊接）。不過要注意的是，此集成只是將網(wǎng)關及其子設備接入 HA ，所以空調伴侶P3的空調功能是無法接入 HA 的（可以使用下面的 HomeKit 反向接入）。
我這里以 Aqara 空調伴侶 P3 為例。首先要在 App 中查看一下網(wǎng)關目前的固件版本。
然后到這個倉庫（https://github.com/niceboygithub/AqaraM1SM2fw），自制固件里查看一下目前支持的版本號，如果大于或等于你網(wǎng)關的版本，就可以放心刷機。
(1) 把網(wǎng)關切換為米家模式（米家用戶忽略此步）
如果你的網(wǎng)關目前為 Aqara Home 模式，需要手動切換到米家模式來打開 Telnet 功能。注意，此步驟會將網(wǎng)關恢復出廠設置，所以之后需要重新配對子設備。快速點擊網(wǎng)關按鈕十次，當聽到 “恢復出廠設置成功” 之后，再雙擊一下按鈕，聽到提示音，再等待片刻，網(wǎng)關播報 “等待連接中，請打開米家 App”。然后和平常一樣把網(wǎng)關接入米家即可。
(2) 下載 AqaraGateway 集成
進入 HACS 商店的集成頁面，點擊右上角三個點，選擇 “自定義存儲庫”，輸入集成地址 niceboygithub/AqaraGateway ，類別選擇集成，點擊 ”添加“ 并關閉窗口。
點擊自動發(fā)現(xiàn)的 ”Aqara Gateway“ 集成（如果沒有手動搜索即可），并下載和重啟。
(3) 獲取網(wǎng)關 Token
這時候需要用到前面的 Xiaomi Gateway 3 集成，如果你之前已經添加過該集成（沒有的話按照上面的步驟添加一次），直接點擊你的賬號-選項。
在列表中選擇你的網(wǎng)關。
提交后就可以看到設備的 IP 和 Token，復制一下。
(4) 添加集成并連接網(wǎng)關
右下角搜索并添加 Aqara Gateway 集成，輸入 IP 和 Token，”Model“ 選擇你網(wǎng)關的型號，提交。
稍等片刻，顯示成功后，就可以在集成中看到網(wǎng)關設備了，默認就是一個網(wǎng)關的警戒實體。
如果你只是在米家中使用網(wǎng)關，那現(xiàn)在已經可以用了，在米家中添加的子設備會自動同步到這個集成下的設備中。如果你要連接 Aqara Home 使用，那還需要下面的步驟。
(5) 刷寫官改固件
打開 Telnet 工具，我這里使用 Windows 下的 MobaXterm，其他工具操作類似。添加一個 Telnet 會話，Host 處輸入網(wǎng)關 IP，點擊確認進行連接。
用戶名輸入 admin，按回車。連接成功后，會顯示這樣一個界面。
我們打開 Aqara Gateway 的倉庫，找到你網(wǎng)關型號的相應刷機代碼，比如我的P3，一共三行代碼，復制一行，粘貼一行，回車 ，重復三次。
M1S:
P3:
顯示 “Update Done” 之后，刷入成功。然后輸入 reboot 重啟。
(6) 切換回 Aqara Home 模式
和第 (1) 步一樣，再次重置并切換模式。聽到網(wǎng)關播報 “等待連接中，請打開 Aqara Home App“ 后，和平常一樣把網(wǎng)關接入 Aqara Home。
(7) 再次添加 Aqara Gateway 集成
把之前添加的集成刪除，會自動發(fā)現(xiàn)待連接的網(wǎng)關，如果沒有在右下角手動添加，點擊提交。
稍等片刻，刷新一下，就能看到網(wǎng)關及子設備了，我這里添加了一個溫濕度傳感器。此時就可以進行重命名等操作了。
三、HomeKit反向接入
如果遇到支持 HomeKit 的 Wi-Fi 設備（例如 Aqara 的妙控開關S1E、人在FP2）或者其他平臺支持 HomeKit 的網(wǎng)關（例如涂鴉的 ZigBee 網(wǎng)關），比較通用的做法就是先將設備接入 HA 里的 HomeKit 控制器，再通過 HA 里的 HomeKit 橋接器接到 HomeKit，即 HomeKit 反向接入。這種方法適用于幾乎所有支持 HomeKit 的設備，但是由于許多設備接入 HomeKit 都有閹割，所以也無法在 HA 里使用這些閹割的功能，比如功率。
(1) 確保設備未連接到任何 HomeKit 家庭
首先，需要確保你的設備未連接到 HomeKit，如果有，請在家庭 App 中刪除這個設備，如果之后還是無法添加，請重置設備。
(2) 添加 HomeKit 控制器 集成
在集成頁面，右下角添加 HomeKit 控制器 集成。
會自動搜索并列出局域網(wǎng)中待連接的設備。
選擇你的設備并提交，之后輸入設備的配對代碼，一般能在設備上或者包裝上找到。
提交后就添加成功了。
(3) 通過橋接器將設備添加到 HomeKit 家庭
如果你還想在家庭 App 中控制設備，就需要把 HA 里的設備再次通過 HomeKit 橋接器接入到 HomeKit 家庭。具體方法可以看我這期視頻喔。
要注意的是，由于 HA 無法橋接無線開關之類的按鈕實體，所以 HA 中的無線開關，包括妙控開關中的無線開關，是無法橋接到 HomeKit 的，只能在 HA 里做自動化。
四、涂鴉設備
涂鴉設備也分為 Wi-Fi 直連、ZigBee 和 BLE（低功耗藍牙）設備。
1、涂鴉 Wi-Fi 設備
倉庫地址：https://github.com/rospogrigio/localtuya
涂鴉 Wi-Fi 設備大部分可以使用 Local Tuya 集成來本地接入，支持斷網(wǎng)控制。需要涂鴉開發(fā)者賬號輔助添加，可以不開通 IoT Core 連接服務（付費，免費試用一個月）。
(1) 下載 Local Tuya 集成
在 HACS 商店下載 Local Tuya 集成并重啟。
(2) 注冊登錄涂鴉 IoT 平臺
進入涂鴉 IoT 平臺網(wǎng)頁，如果沒有賬號就注冊一個。登錄完成后選擇左邊的云開發(fā)，點擊 ”創(chuàng)建云項目“。
隨便輸入項目名稱，服務行業(yè)和開發(fā)方式都選擇全屋智能，數(shù)據(jù)中心選擇中國。
由于我這邊已經創(chuàng)建過了，就用這個 Local 項目來演示。
(3) 綁定涂鴉 App
在項目中，點擊 ”設備“ 選項卡，選擇 ”關聯(lián)涂鴉APP賬號“，點擊 ”添加 App 賬號“，用涂鴉智能或者智能生活 App 掃描二維碼進行綁定。
設備權限這里選擇 ”讀、寫、管理“。
確定之后就能看到賬號下綁定的設備了，可以留意一下這里的 設備ID ，待會會用到。
(4) 添加 Local Tuya 集成并綁定設備
回到 HA，添加 Local Tuya 集成，區(qū)域選擇 ”cn“，其他留空，由于我們沒有開通 IoT Core 連接服務，所以勾選最下面的復選框，不配置 API 賬號。
提交之后，點擊集成的選項，選擇添加新設備。
此時會自動發(fā)現(xiàn)局域網(wǎng)中的涂鴉 Wi-Fi 設備，這里的代碼就是 IoT 平臺項目中的 設備ID 。
選擇要添加的設備，我這里以 GoSund 智能燈泡為例，自定義一個名字。然后復制設備ID。
回到 IoT 平臺，鼠標移到左邊的 ”云開發(fā)“，選擇 ”API 調試“。
選擇 ”通用設備管理“ - ”獲取設備信息“，然后粘貼剛剛復制的設備ID，點擊 ”發(fā)起調用“。
在右邊的響應結果里，就能看到設備的 local_key 了。
復制一下值，粘貼至 HA，提交。
選擇需要添加的實體類型，然后需要指定一下不同數(shù)值的功能，比如亮度、色溫。
可以在 Api 調試界面的 ”獲取單個設備的狀態(tài)“ 里，邊調整設備狀態(tài)，邊發(fā)起調用，右邊對應的數(shù)值則會改變，便可找到相對應的功能。
也可以參考這個鏈接（https://github.com/rospogrigio/localtuya/wiki/HOWTO-get-a-DPs-dump）里的內容。
提交之后，如果所有實體類型都添加完了，勾選下方的不再添加實體，即可完成配置。
如果還要添加其他設備，重復上面步驟即可。
此時就可以本地控制設備了，對照 App 的響應，幾乎沒有延遲。
2、涂鴉 ZigBee/BLE 設備
涂鴉的 ZigBee/BLE 設備，包括之前的 Wi-Fi 設備，都可以用官方的 Tuya 集成來進行云端接入，但是需要購買IoT Core 連接服務，15萬一年，emm~，雖然能免費試用一個月，還是算了吧。
其他設備的接入方法，也歡迎大家在評論區(qū)提問或解答喔。
之后還會出各個生態(tài)平臺互相聯(lián)動的方法，教程制作不易，請多多三連加關注喔。
