小米設(shè)備接入 Home Assistant 指南選對(duì)控制方式五步完成連接【免費(fèi)下載鏈接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_homeXiaomi Home米家集成是小米官方支持的 Home Assistant 集成組件登錄小米賬號(hào)后可以把米家設(shè)備全部導(dǎo)入 Home Assistant實(shí)現(xiàn)跨品牌設(shè)備的統(tǒng)一管理、自動(dòng)化與場景聯(lián)動(dòng)。本文用新手能看懂的方式講清云端還是本地控制怎么選、如何完成安裝登錄、多賬號(hào)怎么管以及常見問題怎么處理。為什么要把小米設(shè)備接入 Home Assistant小米生態(tài)鏈設(shè)備好用但有個(gè)現(xiàn)實(shí)問題米家 App 只能管理米家體系內(nèi)的設(shè)備。家里如果同時(shí)有小米的門磁、其他品牌的燈和空調(diào)想開門磁時(shí)關(guān)燈、開空調(diào)在米家 App 里是做不到的。Home Assistant 解決的就是這件事。它本身不認(rèn)識(shí)小米設(shè)備裝完 Xiaomi Home 集成后小米設(shè)備會(huì)像原生設(shè)備一樣出現(xiàn)在系統(tǒng)里之后所有品牌設(shè)備的開關(guān)、狀態(tài)放在同一個(gè)儀表盤上自動(dòng)化可以用任何設(shè)備的狀態(tài)做觸發(fā)條件不再受單個(gè) App 的限制場景、儀表盤、語音控制都能跨品牌使用。接入后你能拿到什么覆蓋大部分米家品類燈、插座開關(guān)、空調(diào)、空氣凈化器、加濕器、掃地機(jī)、熱水器、音箱媒體播放器、門窗傳感器二進(jìn)制傳感器等。小米按 MIoT 規(guī)范把設(shè)備功能自動(dòng)轉(zhuǎn)成 Home Assistant 實(shí)體——可寫的屬性變成開關(guān)、數(shù)值、選項(xiàng)只讀屬性變成傳感器事件變成事件實(shí)體動(dòng)作變成按鈕或通知實(shí)體。有少數(shù)品類不支持藍(lán)牙設(shè)備、紅外設(shè)備、虛擬設(shè)備。這三類接不進(jìn)來選型時(shí)先排除。云端還是本地一分鐘選對(duì)控制方式接入前唯一要做的決定是控制指令走哪條路。差別只在命令經(jīng)過誰的手。云端控制兼容好開箱即用沒有額外硬件時(shí)指令從 Home Assistant 發(fā)到小米云再轉(zhuǎn)到設(shè)備設(shè)備狀態(tài)變化則由云端的 MQTT 訂閱機(jī)制直接推送給集成不需要反復(fù)輪詢所以設(shè)備多也不會(huì)給云端造成壓力。好處很直接不挑設(shè)備、不加硬件裝好就能用人在外面也能控制家里設(shè)備遠(yuǎn)程訪問是標(biāo)配缺點(diǎn)是指令要繞道公網(wǎng)家里斷網(wǎng)就無法控制。云端控制的完整實(shí)現(xiàn)在 custom_components/xiaomi_home/miot/miot_cloud.py。本地控制低延遲斷網(wǎng)可用本地控制需要一臺(tái)小米中樞網(wǎng)關(guān)固件 ≥ 3.3.0_0023或一臺(tái)內(nèi)置中樞網(wǎng)關(guān)功能的米家設(shè)備軟件 ≥ 0.8.9。中樞網(wǎng)關(guān)內(nèi)部自帶標(biāo)準(zhǔn) MQTT BrokerHome Assistant 直接向網(wǎng)關(guān)訂閱消息、發(fā)布指令全程走局域網(wǎng)。局域網(wǎng)內(nèi)響應(yīng)更快斷網(wǎng)也能控制數(shù)據(jù)不出家門隱私上更干凈限制中樞網(wǎng)關(guān)目前僅在中國大陸銷售其他地區(qū)用不了。本地控制的完整實(shí)現(xiàn)在 custom_components/xiaomi_home/miot/miot_lan.py中樞網(wǎng)關(guān)的局域網(wǎng)發(fā)現(xiàn)邏輯在 custom_components/xiaomi_home/miot/miot_mdns.py。另外還有個(gè)局域網(wǎng)控制選項(xiàng)可以直控同一局域網(wǎng)內(nèi)帶 IP 的設(shè)備Wi-Fi 或網(wǎng)線連接但控制不了藍(lán)牙 Mesh、ZigBee 設(shè)備官方文檔提示該功能可能引起異常建議不要開啟。有中樞網(wǎng)關(guān)時(shí)它也不會(huì)生效。對(duì)照表怎么選對(duì)比項(xiàng)云端控制本地控制中樞網(wǎng)關(guān)響應(yīng)速度經(jīng)過云端略有延遲局域網(wǎng)內(nèi)響應(yīng)更快隱私指令與狀態(tài)經(jīng)過小米云數(shù)據(jù)不出局域網(wǎng)遠(yuǎn)程訪問支持任何地方都能控制僅限家庭網(wǎng)絡(luò)硬件要求無中樞網(wǎng)關(guān)或內(nèi)置中樞設(shè)備地區(qū)限制無支持中國大陸、歐洲、印度、俄羅斯、新加坡、美國中樞網(wǎng)關(guān)僅中國大陸有售一句話結(jié)論沒有中樞網(wǎng)關(guān)就用云端這是大多數(shù)新手的路徑有中樞網(wǎng)關(guān)、又在意延遲和隱私就切本地控制。小米設(shè)備接入 Home Assistant 的 5 個(gè)步驟第 1 步確認(rèn) Home Assistant 版本Core ≥ 2024.4.4Operating System 安裝方式 ≥ 13.0。版本不夠先升級(jí)這是所有安裝方式的前提。第 2 步安裝 Xiaomi Home 集成三種方式任選其一方式 AHACS多數(shù)人首選。打開 HACS搜索 Xiaomi Home進(jìn)入詳情頁下載即可。方式 BGit clone官方推薦方便鎖定版本。進(jìn)入 config 目錄執(zhí)行g(shù)it clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /config第一條命令把倉庫拉到 config 目錄下install.sh /config會(huì)自動(dòng)把集成復(fù)制到custom_components并提示重啟。以后想固定某個(gè)版本切到對(duì)應(yīng) tag 再跑一遍腳本即可。方式 C手動(dòng)復(fù)制。通過 Samba 或 FTP把custom_components/xiaomi_home整個(gè)文件夾拷到 Home Assistant 的config/custom_components下。裝完記得重啟 Home Assistant否則集成不會(huì)出現(xiàn)。第 3 步添加集成并登錄小米賬號(hào)依次進(jìn)入設(shè)置 設(shè)備與服務(wù) 添加集成 搜索 Xiaomi Home 下一步 點(diǎn)擊登錄按頁面提示用小米賬號(hào)完成授權(quán)。配置流程的實(shí)現(xiàn)在 custom_components/xiaomi_home/config_flow.py。登錄走的是 OAuth 2.0 授權(quán)賬號(hào)密碼不會(huì)存進(jìn) Home Assistant這一點(diǎn)可以放心。第 4 步選擇地區(qū)與家庭導(dǎo)入設(shè)備配置過程中要先選擇所在地區(qū)。小米云的數(shù)據(jù)按地區(qū)隔離當(dāng)前支持中國大陸、歐洲、印度、俄羅斯、新加坡、美國六個(gè)地區(qū)選錯(cuò)地區(qū)就會(huì)看不到設(shè)備。登錄成功后彈出選擇家庭與設(shè)備對(duì)話框選中要導(dǎo)入的米家家庭該家庭下的設(shè)備會(huì)一并導(dǎo)入。第 5 步驗(yàn)證設(shè)備實(shí)體打開設(shè)備頁面確認(rèn)每個(gè)設(shè)備都生成了實(shí)體門窗傳感器有事件實(shí)體、空調(diào)有 climate 實(shí)體、燈有 light 實(shí)體。把它們拖進(jìn)對(duì)應(yīng)區(qū)域客廳、臥室就可以開始寫場景和自動(dòng)化了。關(guān)于賬號(hào)安全記住兩件事密碼不保存但登錄成功后設(shè)備信息、證書、token 等憑據(jù)會(huì)明文存放在 Home Assistant 的配置文件中這是 HA 平臺(tái)的限制。配置文件泄露等于賬號(hào)授權(quán)泄露請(qǐng)保管好配置目錄。懷疑 token 泄露時(shí)去米家 App 撤銷授權(quán)我的 點(diǎn)擊用戶名進(jìn)入小米賬號(hào)頁面 應(yīng)用授權(quán) Xiaomi Home (Home Assistant Integration) 取消授權(quán)。從能用到好用多賬號(hào)管理、自動(dòng)化場景與規(guī)格擴(kuò)展多賬號(hào)管理家人名下的設(shè)備也接進(jìn)來一個(gè)家庭里設(shè)備分散在多個(gè)小米賬號(hào)下很常見。第一個(gè)賬號(hào)配置完成后進(jìn)入 設(shè)置 設(shè)備與服務(wù) 已配置 Xiaomi Home 添加中樞再登錄另一個(gè)小米賬號(hào)即可。不同賬號(hào)、甚至不同地區(qū)的設(shè)備都可以放進(jìn)同一個(gè)區(qū)域統(tǒng)一管理。先寫這三組自動(dòng)化離家模式觸發(fā)條件設(shè)成所有手機(jī)device_tracker 實(shí)體離開家動(dòng)作是關(guān)閉全部燈和插座、啟動(dòng)掃地機(jī)?；丶夷Ｊ酵砩系郊议_門時(shí)門磁事件實(shí)體觸發(fā)打開客廳燈、空調(diào)切到預(yù)設(shè)溫度。睡眠模式定時(shí)觸發(fā)臥室燈調(diào)至最低亮度加濕器設(shè)到睡眠濕度。小提示小米設(shè)備的事件門磁觸發(fā)、開關(guān)雙擊、傳感器報(bào)警等都會(huì)轉(zhuǎn)成 Home Assistant 的事件實(shí)體可以直接在自動(dòng)化里做觸發(fā)條件不需要額外寫輪詢。設(shè)備規(guī)格擴(kuò)展修正和補(bǔ)充實(shí)體個(gè)別設(shè)備的實(shí)體翻譯不對(duì)、或者該有的實(shí)體沒生成時(shí)可以改 custom_components/xiaomi_home/miot/specs/ 目錄下的規(guī)則文件spec_add.json補(bǔ)充額外的實(shí)體轉(zhuǎn)換規(guī)則spec_filter.yaml/spec_modify.yaml過濾不需要的實(shí)體、修改已有轉(zhuǎn)換multi_lang.json本地維護(hù)的多語言字典優(yōu)先級(jí)高于云端下載的文件適合修正實(shí)體名稱。改完文件不會(huì)自動(dòng)生效要到集成頁面點(diǎn)CONFIGURE 更新實(shí)體轉(zhuǎn)換規(guī)則。集成共支持 13 種界面語言簡中、繁中、英文、西班牙語、俄語、法語、德語、日語、意大利語、荷蘭語、葡萄牙語、巴西葡萄牙語、土耳其語在配置流程的語言選項(xiàng)里選。翻譯文件在 custom_components/xiaomi_home/translations/。Action 調(diào)試模式驗(yàn)證自動(dòng)化是否發(fā)對(duì)了指令在配置項(xiàng)里開啟Action 調(diào)試模式后集成會(huì)為帶參數(shù)的動(dòng)作生成一個(gè)文本實(shí)體你可以手動(dòng)向設(shè)備發(fā)送帶參數(shù)的 Action 指令。自動(dòng)化行為不符合預(yù)期時(shí)用它來確認(rèn)是觸發(fā)條件的問題還是指令本身的問題比翻日志快。小米設(shè)備接入 Home Assistant 排障現(xiàn)象 → 原因 → 解決現(xiàn)象可能原因解決辦法安裝后搜不到集成裝完沒重啟重啟 Home Assistantinstall.sh 結(jié)束時(shí)也會(huì)提示登錄后設(shè)備列表是空的地區(qū)選錯(cuò)重新走配置流程選正確的地區(qū)——各地區(qū)小米云數(shù)據(jù)相互隔離某些設(shè)備一直不出現(xiàn)該設(shè)備屬于藍(lán)牙、紅外或虛擬設(shè)備官方暫不支持這三類屬預(yù)期行為控制明顯延遲或超時(shí)云端鏈路慢或家庭網(wǎng)絡(luò)連小米云不穩(wěn)定先排查家庭網(wǎng)絡(luò)有中樞網(wǎng)關(guān)的話改用本地控制想用本地模式卻用不了網(wǎng)絡(luò)里沒有中樞網(wǎng)關(guān)或版本不達(dá)標(biāo)升級(jí)中樞網(wǎng)關(guān)固件至 3.3.0_0023 以上、內(nèi)置中樞軟件至 0.8.9 以上不在中國大陸則只能用云端開啟了局域網(wǎng)控制卻不生效局域網(wǎng)內(nèi)已存在中樞網(wǎng)關(guān)該功能自動(dòng)失效或設(shè)備是藍(lán)牙 Mesh/ZigBee 無 IP官方本就不建議開啟此功能不需要可直接關(guān)閉實(shí)體名稱是英文或翻譯不準(zhǔn)云端多語言文件覆蓋不全在multi_lang.json補(bǔ)充對(duì)應(yīng)翻譯再點(diǎn)更新實(shí)體轉(zhuǎn)換規(guī)則改了 specs 目錄的文件沒反應(yīng)忘記觸發(fā)規(guī)則更新CONFIGURE 更新實(shí)體轉(zhuǎn)換規(guī)則懷疑賬號(hào)或 token 泄露配置文件被他人讀取先在米家 App 撤銷授權(quán)見上文路徑再收緊配置目錄的訪問權(quán)限寫在最后接入本身不復(fù)雜復(fù)雜的是之后的習(xí)慣養(yǎng)成。建議從兩三臺(tái)最常用的設(shè)備開始把離家、回家這兩組自動(dòng)化跑穩(wěn)再逐步導(dǎo)入全屋設(shè)備。等云端和本地的區(qū)別在你家網(wǎng)絡(luò)里驗(yàn)證清楚剩下的就是按需調(diào)整——這個(gè)順序下幾乎不會(huì)踩到上面排障表里的大部分問題。【免費(fèi)下載鏈接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考