在 如何讓米家設(shè)備輕松接入 HomeKit？ 這篇文章中，我看到了大家對(duì)于 HomeKit 的熱情，不少小伙伴都表示，文章里主要介紹了不同的方向，但在實(shí)際操作過(guò)程，想要一份更清晰的「說(shuō)明書」。想來(lái)上一次寫接入 HomeKit 的文章已經(jīng)是 2016 年，正好就趁著這個(gè)機(jī)會(huì)來(lái)更新一下。

這篇文章將從零開(kāi)始，向你介紹如何通過(guò)在樹莓派安裝 HomeBridge，將幾個(gè)典型的米家設(shè)備接入到 HomeKit 中。準(zhǔn)備好了嗎？那我們?cè)挷徽f(shuō)，直接開(kāi)始吧。

你需要準(zhǔn)備的東西

在開(kāi)始之前，我們首先得購(gòu)買對(duì)應(yīng)的硬件設(shè)備。在這個(gè)方案中，你需要準(zhǔn)備的有這些東西：

• 一臺(tái)電腦（此處以 Mac 為例子）
• 一個(gè)樹莓派（建議 3B+ 及以上）
• 一張 16GB 以上的 TF 卡和讀卡器（用來(lái)給樹莓派裝系統(tǒng)）
• 一根 MicroUSB 線（給樹莓派連接電源，如果是樹莓派 4，則需要準(zhǔn)備一根 USB-C 線）
• 一個(gè)安卓模擬器
• 有了這些硬件設(shè)備之后，我們就可以開(kāi)始在電腦上進(jìn)行操作了

當(dāng)然了，這里只是以我的環(huán)境作為例子，如果你想在其他平臺(tái)上安裝 HomeBridge 肯定也是沒(méi)問(wèn)題的，官方也給出了對(duì)應(yīng)的安裝指南。只不過(guò)考慮到要保持接入家居的實(shí)時(shí)可用性，就需要一臺(tái)常開(kāi)的設(shè)備來(lái)運(yùn)行 HomeBridge，所以樹莓派無(wú)論是在功耗還是性價(jià)比上，都是再合適不過(guò)的選擇。

macOS 和 Linux 的小伙伴可以用系統(tǒng)自帶的終端進(jìn)行操作，而 Windows 的小朋友們可以選擇剛推出不久的 Windows Terminal。

給樹莓派安裝系統(tǒng)

首先自然是給樹莓派安裝 Raspbian 系統(tǒng)。打開(kāi) 這個(gè)網(wǎng)站，并選擇「Raspbian Buster with desktop」進(jìn)行下載。

至于為什么選擇它的原因，主要有兩點(diǎn)：一是「Raspbian Buster with desktop and recommended software」解壓之后的系統(tǒng)鏡像比較大，會(huì)占用更多空間，而它所推薦的軟件都是我們不需要的；二是我并不確定 lite 版的系統(tǒng)是否缺失一些必要的支持，因此最保險(xiǎn)的還是選擇「Raspbian Buster with desktop」版本的系統(tǒng)。

下載好 zip 文件之后解壓，可以獲得一個(gè) img 格式的鏡像文件。這時(shí)候?qū)⑽覀兊?TF 卡連接到電腦上，打開(kāi) balenaEtcher 這款軟件，選擇剛剛解壓好的 Raspbian 系統(tǒng)，將它刷進(jìn) TF 卡中。

大約十分鐘之后，你就擁有了一張能夠讓樹莓派啟動(dòng)的「系統(tǒng)盤」了。不過(guò)這時(shí)候先不要著急著給樹莓派開(kāi)機(jī)，因?yàn)槲覀冞€需要做一些設(shè)置，好讓電腦能夠直接無(wú)線遠(yuǎn)程連接到樹莓派，省去插拔 HDMI 和鍵鼠的麻煩。

將 TF 卡重新連接到電腦，可以看到一個(gè)名為 boot 的磁盤。接著，我們打開(kāi)終端，依次輸入下面的代碼：

cd?/Volumes/boot
touch?ssh
touch?wpa_supplicant.conf
sudo nano?wpa_supplicant.conf

輸入完之后，會(huì)提示你需要密碼。這里輸入你電腦的登陸密碼即可。需要提醒的是，輸入密碼的過(guò)程中終端不會(huì)顯示任何內(nèi)容，輸入完回車就行了。完成之后，你會(huì)在終端進(jìn)入到一個(gè)文本編輯器中。在編輯器內(nèi)復(fù)制以下內(nèi)容，并將對(duì)應(yīng) Wi-Fi 的 SSID 和密碼改成你家的。

country=CN
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
network={
ssid="你家Wi-Fi的名稱"
psk="你家Wi-Fi的密碼"
key_mgmt=WPA-PSK
priority=1
}

需要提醒的是，如果你家的 ssid 是隱藏的，那么就需要在 priority=1 的后面加入一條 scan_ssid=1 的參數(shù)。

就像上面這樣

設(shè)置完成后，按下 ?control+X，然后輸入 y 并按下回車鍵進(jìn)行保存，就可以將 TF 卡插入樹莓派，連接電源開(kāi)機(jī)啟動(dòng)了?；氐?Mac 上，我們繼續(xù)用終端進(jìn)行操作。

安裝 HomeBridge

要正式開(kāi)始安裝 HomeBridge 了。跟著下面的步驟一步一步來(lái)，你也可以在一杯咖啡的時(shí)間里，將 HomeBridge 輕松地安裝在樹莓派上。

不過(guò)在此之前，你需要到路由器后臺(tái)，找到樹莓派的局域網(wǎng) IP 地址。接著在終端內(nèi)輸入

ssh?pi@樹莓派的IP地址

隨后，電腦可能會(huì)向你問(wèn)一個(gè)問(wèn)題，不用管它問(wèn)什么，直接輸入 yes，然后輸入連接樹莓派的 ssh 默認(rèn)密碼：raspberry。

再次需要提醒的是，輸入密碼的過(guò)程中終端不會(huì)顯示任何內(nèi)容，輸入完回車就行了。如果出現(xiàn)了下面的界面，說(shuō)明連接就成功建立了。

第二步，是對(duì)樹莓派內(nèi)置軟件源進(jìn)行更換。由于眾所周知的原因，Raspbian 在更新軟件包時(shí)可能會(huì)遇到速度緩慢甚至是無(wú)法更新的問(wèn)題，因此我們將國(guó)外的軟件源更換為國(guó)內(nèi)的清華鏡像源，加快連接速度。替換軟件源的很簡(jiǎn)單，按照下面的操作步驟執(zhí)行即可。

sudo?nano?/etc/apt/sources.list

將原有的內(nèi)容刪除，或是加 # 進(jìn)行注釋，并替換為下面的內(nèi)容：

deb?http://mirrors.tuna.tsinghua.edu.cn/raspbian/raspbian/?buster?main?non-free?contrib
deb-src?http://mirrors.tuna.tsinghua.edu.cn/raspbian/raspbian/?buster?main?non-free?contrib

完成后，按下 ?control+X，然后輸入 y 回車進(jìn)行保存。接著，繼續(xù)修改 /etc/apt/sources.list.d/raspi.list 文件，輸入：

sudo?nano?/etc/apt/sources.list.d/raspi.list

將里面內(nèi)容用下面的內(nèi)容取代，然后同樣用上面的方法進(jìn)行保存：

deb?http://mirrors.tuna.tsinghua.edu.cn/raspberrypi/?buster?main?ui

完成后，先進(jìn)行一遍軟件源更新。在終端中依次輸入以下代碼：

sudo?apt-get?update
sudo?apt-get?upgrade

中途會(huì)詢問(wèn)你，是否進(jìn)行更新，輸入 y 之后回車即可。好了，等待十分鐘左右，你就可以將樹莓派里的軟件包都更新到最新的版本了。

現(xiàn)在，我們可以正式開(kāi)始安裝 HomeBridge，話不多說(shuō)，直接依次在終端中執(zhí)行下面的代碼：

curl -sL https://deb.nodesource.com/setup_12.x | sudo bash -sudo apt-get install -y nodejs gcc g++ make pythonnode -vsudo npm i -g npmsudo npm install -g --unsafe-perm homebridge homebridge-config-ui-xsudo hb-service install --user homebridge

需要注意，第二步和第五步由于需要從國(guó)外的服務(wù)器下載對(duì)應(yīng)的軟件包，因此建議大家配置一下網(wǎng)絡(luò)環(huán)境，不然可能會(huì)十分慢。其次，第三步中，node -v 的含義是為了查看安裝的 node 版本。如果輸入之后得到類似 v12.X.X 的結(jié)果，那就說(shuō)明 node 安裝成功，可以進(jìn)行下一步。

跑完所有代碼之后，HomeBridge 便已經(jīng)成功部署在了樹莓派上，接下來(lái)我們就可以安裝對(duì)應(yīng)的插件，將米家設(shè)備接入到 HomeKit 中。

安裝插件，編寫 config.json

得益于安裝了 homebridge-config-ui-x 這一款插件，現(xiàn)在你可以打開(kāi)一個(gè)瀏覽器，輸入上面返回的任意一個(gè) IP 地址，進(jìn)入 HomeBridge 后臺(tái)管理界面（默認(rèn)的賬戶密碼都是 admin）。

進(jìn)入到這里之后，我們就可以在插件頁(yè)面搜索對(duì)應(yīng)的米家插件進(jìn)行安裝。這里我推薦來(lái)自「deserteagle」（GitHub 用戶名為銀行碼 YinHangCode）的米家插件，不僅種類較多，而且基本上都能長(zhǎng)期穩(wěn)定工作。這里我們以米家空氣凈化器和米家空調(diào)伴侶作為例子，演示如何將它們接入 HomeKit 中。

首先，在插件頁(yè)面用關(guān)鍵詞搜索到對(duì)應(yīng)的插件，點(diǎn)擊安裝。兩款插件安裝完成后，來(lái)到配置頁(yè)面，開(kāi)始編寫 config.json。

說(shuō)到編寫 config.json 這個(gè)文件，就到了新手最頭疼的地方。但其實(shí)不用害怕，都是四級(jí)水平不到的英語(yǔ)，理解起來(lái)并不困難。但請(qǐng)一定一定要認(rèn)真閱讀一遍作者的 Readme 和 config 例子，不然你必然會(huì)出現(xiàn)錯(cuò)誤。

這里我貼出我的一部分 config.json，對(duì)里面的內(nèi)容進(jìn)行細(xì)致的講解。不過(guò)需要注意的是，json 格式的文件并不支持注釋，如果需要使用這份 config.json 文件，除了需要將對(duì)應(yīng)內(nèi)容更改為你的設(shè)備之外，還需要刪除掉 # 和后面的中文注釋。

另外還需要提醒大家的是，json 文件的 {}、[]、, 等符號(hào)一定不能弄錯(cuò)，否則一定會(huì)報(bào)錯(cuò)。如果是運(yùn)行時(shí)提示 config 文件出現(xiàn)錯(cuò)誤，首先檢查自己是不是哪里打多了一個(gè) ,，或者是哪里遺漏了一個(gè)括號(hào)，再檢查語(yǔ)法是否正確。

{????"bridge":?{?#homebridge基礎(chǔ)設(shè)置，大部分都不需要修改????????"name":?"HomeBridge",????????"username":?"00:00:00:00:00:02",????????"port":?58888,????????"pin":?"199-71-226"?#你在家庭應(yīng)用進(jìn)行配對(duì)時(shí)的配對(duì)碼，支持自定義????},????"platforms":?[????????{????????????"platform":?"MiAirPurifierPlatform",?#插件平臺(tái)名稱，固定不可更改????????????"deviceCfgs":?[????????????????{????????????????????"type":?"MiAirPurifier2S",?#型號(hào)名稱，固定不可更改????????????????????"ip":?"192.168.1.195",?#空氣凈化器的IP地址????????????????????"token":?"b5d7120997c45761f3adac05887c5fc2",?#空氣凈化器的token????????????????????"airPurifierDisable":?false,?#是否在家庭應(yīng)用中不顯示空氣凈化器????????????????????"airPurifierName":?"空氣凈化器",?#在家庭應(yīng)用中顯示的名稱????????????????????"silentModeSwitchDisable":?false,?#是否在家庭應(yīng)用中不顯示空凈睡眠模式開(kāi)關(guān)????????????????????"silentModeSwitchName":?"空凈睡眠模式",?#在家庭應(yīng)用中顯示的名稱????????????????????"temperatureDisable":?false,?#是否在家庭應(yīng)用中不顯示空凈檢測(cè)的環(huán)境溫度????????????????????"temperatureName":?"溫度",?#在家庭應(yīng)用中顯示的名稱????????????????????"humidityDisable":?false,?#是否在家庭應(yīng)用中不顯示空凈檢測(cè)的環(huán)境濕度????????????????????"humidityName":?"濕度",?#在家庭應(yīng)用中顯示的名稱????????????????????"buzzerSwitchDisable":?true,?#是否在家庭應(yīng)用中不顯示空凈的靜音開(kāi)關(guān)????????????????????"buzzerSwitchName":?"MiAirPurifier2S?Buzzer?Switch",?#在家庭應(yīng)用中顯示的名稱????????????????????"ledBulbDisable":?true,?#是否在家庭應(yīng)用中不顯示空凈的屏幕顯示開(kāi)關(guān)????????????????????"ledBulbName":?"空氣凈化器顯示屏",?#在家庭應(yīng)用中顯示的名稱????????????????????"airQualityDisable":?false,?#是否在家庭應(yīng)用中不顯示空凈檢測(cè)的空氣質(zhì)量????????????????????"airQualityName":?"空氣質(zhì)量"?#在家庭應(yīng)用中顯示的名稱????????????????}????????????]????????},{????????????"name":?"Config",?#這部分不需要修改，是homebridge?UI插件自動(dòng)生成的????????????"port":?8581,????????????"auth":?"form",????????????"theme":?"pink",????????????"tempUnits":?"c",????????????"platform":?"config"????????}????],????"accessories":?[?#是使用「platform」還是「accessories」，需要根據(jù)插件的說(shuō)明進(jìn)行選擇????????{????????????"accessory":?"MiHeaterCooler",?#插件名稱，固定不可更改????????????"name":?"空調(diào)",?#在家庭應(yīng)用中顯示的名稱????????????"address":?"192.168.1.146",?#空調(diào)伴侶的IP地址????????????"token":?"5ff11db226e994e41a4b7653cd713c6f",?#空調(diào)伴侶的token????????????"ratedPower":?735?#空調(diào)的額定功率，非必須參數(shù)????????}????]}

其中，獲得 token 的操作相對(duì)麻煩一些，但卻又是米家設(shè)備接入 HomeKit 必不可少的一項(xiàng)參數(shù)。那么，要如何獲取對(duì)應(yīng)設(shè)備的 token？如果你不了解，可以跟著下面的步驟操作：

• 第一步，我們打開(kāi)準(zhǔn)備好的安卓虛擬機(jī)，安裝一個(gè)舊版的米家 app（必須要舊版，建議找 2017 年左右的版本）；
• 第二步，打開(kāi)米家 App，登陸你的賬號(hào)，檢查你需要接入的設(shè)備是否顯示在 App 中，然后簡(jiǎn)單進(jìn)行操作，確定設(shè)備能夠響應(yīng)；
• 第三步，安裝 RE 瀏覽器，進(jìn)入到 /data/data/com.xiaomi.smarthome/databases/ 目錄下，找到 miio2.db 文件，并將它復(fù)制到電腦上；
• 第四步，打開(kāi) 這個(gè)網(wǎng)站，將 miio2.db 文件上傳，然后點(diǎn)擊 submit，就可以獲取到所有設(shè)備的 token 了。建議將這份表格保存好，以備后期萬(wàn)一出現(xiàn) bug 時(shí)進(jìn)行修復(fù)。

至此，將米家設(shè)備接入 HomeKit 的所有操作完成。你終于可以拿起 iPhone，將設(shè)備加入到家庭應(yīng)用中，享受 Siri、快捷指令和家庭自動(dòng)化帶來(lái)的便利體驗(yàn)了。

總結(jié)

文章的篇幅看起來(lái)有一些長(zhǎng)，但實(shí)際上莫過(guò)于就是三大步：「裝系統(tǒng) - 裝 HomeBridge - 裝插件并適配」，熟練之后，你可以輕松在半小時(shí)不到的時(shí)間里接入數(shù)個(gè)米家設(shè)備。

但落實(shí)到每一步來(lái)說(shuō)，都需要你的細(xì)心和耐心，如果中途出錯(cuò)，不要急于放棄，好好閱讀返回的報(bào)錯(cuò)內(nèi)容，并學(xué)會(huì)用 Google、百度搜索一下，或者是再仔細(xì)閱讀插件開(kāi)發(fā)者所寫的 Readme 文件，看看問(wèn)題是出在了哪里，對(duì)癥下藥進(jìn)行解決。

當(dāng)然，如果實(shí)在是有一些你無(wú)法找到的 config.json 錯(cuò)誤，私信我，帶上你的 config 文件和報(bào)錯(cuò)內(nèi)容，我也很樂(lè)意提供幫助。

也是不禁回想起過(guò)去，為了折騰一個(gè) YeeLight 彩光燈，而耗費(fèi)的一天時(shí)間。雖說(shuō)現(xiàn)在 HomeBridge 已經(jīng)默默為我服務(wù)多年，但當(dāng)年成功點(diǎn)亮燈泡那一刻的喜悅，至今都記憶猶新。