跟CT一起玩轉全屋智慧 篇十五：全網首發：第一款支援米家的子擎存在感測器接入HA保姆級教程
作者：casatift
哈嘍，艾瑞巴蒂。我是你們的智慧家居領路人CT。相信整個九月對於智慧家居玩家群體來說，最期待的事情之一就是米家終於迎來了第一款原生接入米家的人體存在感測器——子擎存在感測器。要說這個感測器有多火，官方預熱當天，玩家交流群就直接到達500人上限，群裡每日的簽到語就是“今天子擎發麼？”經過米家稽核了將近一個月之後，官方終於官宣，產品將於9月30日晚9點09分開始銷售。並且首發優惠將持續整整72小時，兌現了周老闆當初那句，首發優惠人人都有的承諾。而首發的價格也是逼近了目前成品人在感測器的底線，僅售99元，這個價格甚至比海鮮市場一些DIY的作品售價還要低，目前唯一的疑問就是會不會有購買數量限制了。而我則是透過本站達人@酥心餅乾 大佬，提前拿到了這款存在感測器並體驗了將近一個月，並將其接入了home assistant。因為其他大佬都已經出了比較詳細的介紹與評測，所以我這裡主要與大家分享如何將其接入home assistant。
準備工作
首先需要的是子擎存在感測器：
這好像是廢話，但這裡要提醒的是，因為售價關係感測器僅包含感測器+說明書以及3M雙面膠。並未包含電源和TYPE C電源線，相信這兩樣必要附件各位家裡都能翻出來，不過還是要提醒一句，一定要選用3C認證的5V電源，使用寨廠電源很可能會因為輸出波紋不穩，導致毫米波雷達受到干擾影響使用。假若在使用中遇到一直是無人環境報有人的話，就可以嘗試著更換電源。除了使用自帶的3M雙面膠貼牆，貼頂外，官方也有吊頂配件方便大家在吊頂上開孔做嵌入安裝：
其次我們需要將其接入home assistant，所以還要一個多模1代的閘道器：
雖然子擎官方並不推薦使用多模1代閘道器，但目前因為GW3整合僅支援1代（Alex大佬已經拿到2代多模，估計不久的將來2代多模也會被GW3支援），並且我在家中MESH子裝置數量並不是很多（10個以內）的情況下使用也並沒有任何問題，所以這裡對HA玩家我依舊給出搭配多模1代閘道器使用的推薦，不過要是家裡BLE MESH子裝置數量過多的話，可能就會出現延遲等情況。
然後我們就可以將子擎存在感測器接入米家：
在接入過程中，系統會需要你設定你的安裝方式，是貼牆還是頂裝，其中貼牆安裝感測器還會上報目標距離資訊，而頂裝的話僅僅會輸出動作資訊。並且首次安裝感測器還會學習整個空間的環境資訊。本次發售的lite版本除了有存在檢測功能外，還配有光照感測器，而未來的pro版本除了檢測範圍更大外，還會額外搭載溫溼度感測器。如果房間有固定的干擾源——例如風扇，空調，浴霸等，我們還可以在感測器的高階設定裡進行目標排除：
不過這裡需要注意的是，目標排除會排除掉一定距離範圍內的物體移動監測，可能會影響感測器的有人無人判斷。所以除非必要，不然還是調整安裝位置來進行物理的抗干擾。
因為子擎存在感測器的出品人周老闆本身就是資深智慧家居玩家，所以在這款產品內也提供了非常豐富的自動化觸發和狀態條件，方便我們在米家內部建立自動化：
當然，本篇的重點不是米家，而是HA，下面，讓我們轉戰HA。
gateway3整合的安裝和使用：
HACS的安裝
首先，我們要在HA中安裝HACS（如若安裝請跳過此步）：
我們前往github搜尋HACS：
然後點選右側的Releases：
下載最新版的hacs。zip，下載完成解壓後，將資料夾內所有檔案複製到ha目錄下的custom_componentshacs下（如果沒有custom_components，就新建一個）：
然後重啟HA：
然後在整合內新增新整合HACS：
如果搜尋不到就按ctrl +F5強制重新整理下：
然後勾選四個免責宣告，進行提交：
這時頁面會生成key，要求你點選藍色連線前往github驗證（需註冊github）：
然後continue，繼續按綠色按鈕Authorize hacs，會出現Congratulations介面，然後我們返回HA：
就能發現HACS已經配置好了。
gateway3整合的安裝
然後我們點取左側邊欄的HACS，選擇整合：
點右下角的瀏覽並下載儲存庫搜尋gateway3：
選中然後點選右下角的下載：
選擇最新版下載：
下載完成後需要我們重啟HA：
然後新增新整合：
如果搜不到就ctrl+f5強制重新整理下：
新增米家賬號：
再次新增gateway3整合，閘道器就會出現在選擇列表裡：
首次新增需要在Open telnet Command裡填入以下命令開啟閘道器的telnet功能：
{“method”：“set_ip_info”，“params”：{“ssid”：“”“”，“pswd”：“123123 ； passwd -d admin ； echo enable > /sys/class/tty/tty/enable； telnetd”}}
提交之後就可以看到所有子裝置都被新增進了HA：
不過這時候，我們的子擎存在感測器還是一個unkwon的狀態：
裡面就一個switch，顯然是不能用的，所以，我們還要額外配置一下，我們需要在HA的目錄下新
新建一個xiaomi_gateway3。py檔案：
內容如下：
from custom_components。xiaomi_gateway3。core。converters。devices import *
DEVICES = ［{
10356： ［“ZiQing”， “ZQ Presence Sensor Lite”， “R24PL”］，
“spec”： ［
MapConv（“occupancy-status”， “sensor”， mi=“2。p。1”， map={
0： “NoOne”， 1： “EnterIn”， 2： “SmallMove”， 3： “MicroMove”， 4： “Approaching”， 5： “MoveAway”
}），
MathConv（“no-one-determine-time”， “number”， mi=“2。p。2”， min=0， max=10000），
MathConv（“has-someone-duration”， “sensor”， mi=“2。p。3”， min=0， max=255），
MathConv（“no-one-duration”， “sensor”， mi=“2。p。4”， min=0， max=255），
MathConv（“illuminance”， “sensor”， mi=“2。p。5”， min=0， max=65535），
MathConv（“distance”， “sensor”， mi=“2。p。6”， min=0， max=1000），
Converter（“pir”， “switch”， mi=“3。p。3”， enabled=True），
MathConv（“detect-range”， “number”， mi=“3。p。2”， min=0， max=8），
Converter（“led”， “switch”， mi=“3。p。1”， enabled=True），
］，
}］ + DEVICES
然後重啟HA，就能看到存在感測器的所有功能都對映到了HA：
控制裡面detect-range是檢測距離，這裡單位是米，不含小數，設定起來不如米家APP，所以大家要設定精確的話還是去米家設定好了。
no-one-determine-time是無人判定時間，單位是秒。
PIR是是否開啟紅外+雷達雙鑑。
感測器項裡，Distance是目標距離，無人時顯示為0，has-someone-duration是有人持續時間，no-one-duration是無人持續時間，單位為分鐘，這兩項完全可以使用HA計算。illuminance是光線強度，occupancy-status是雷達狀態，有0： “NoOne”， 1： “EnterIn”， 2： “SmallMove”， 3： “MicroMove”， 4： “Approaching”， 5： “MoveAway”分別對應無人、有人進入、微動、靜態、接近、遠離。
其實到這，我們的感測器已經可以使用了，但是因為occupancy-status報的狀態過於複雜，不能直接對映到homekit，所以我們這裡還可以在ha配置里加上一個template：
template：
- binary_sensor：
- unique_id： “ZQ_occupancy_b”
name： “ZQ_occupancy_b”
state： “{{ is_state（‘sensor。b460edb7c62d_occupancy_status’， ‘EnterIn’） or is_state（‘sensor。b460edb7c62d_occupancy_status’， ‘SmallMove’） or is_state（‘sensor。b460edb7c62d_occupancy_status’， ‘MicroMove’） or is_state（‘sensor。b460edb7c62d_occupancy_status’， ‘Approaching’） or is_state（‘sensor。b460edb7c62d_occupancy_status’， ‘MoveAway’）}}”
device_class： occupancy
其中sensor。b460edb7c62d_occupancy_status替換成自己的實體名稱。然後重啟HA，就能看到有一個ZQ_occupancy_b的occupancy實體，只顯示有人無人兩種狀態。
寫在最後
子擎作為第一款接入米家，並提供豐富自動化的存在感測器可以說是滿足了廣大米粉的迫切需求，畢竟在這之前，大家都依賴於毫米波雷達+魔改門窗或人體來實現人體存在感測器。但一是魔改的價格並不低，即使自己DIY，也要60-70元的成本，二是接入後的自動化條件也依賴於原生感測器的條件，非常有限。而雖然接入HA的人體存在感測器DIY方案就能靈活很多，但是成品的顏值，以及有些干擾目標的排除等並不是大多數玩家能夠搞定的。所以就此來看，多花30塊錢買個成品不失為更好的選擇，我之前準備了4款毫米波雷達感測器，3個DIY方案准備分享，但是得知子擎的訊息之後，我就直接給放棄了。因為不管從哪方面看，子擎存在感測器都要顯得比DIY的更為優秀，即使只接入HA。最後，祝大家玩的開心。
