一、使用前準備

RF-DG-52PAS是信馳達科技基于美國 TI CC2652P和CP2102為核心設計的Zigbee 3.0 USB Dongle,可燒錄 Z-Stack 3.x.0協調器固件，可以直接連接到計算機或樹莓派，通過ZHA或 Zigbee2MQTT連接到 Home Assistant或其他開源物聯網平臺。還可以燒錄路由器固件作為路由設備延展網絡范圍。

HomeAssistant在目前智能家居的地位舉足輕重，深度用戶認為它是智能家居系統的最優解，自由、萬能、穩定；新手用戶則認為它是各個不同智能家居系統連接的橋梁，可以讓你的各品牌電器、傳感器、開關整合在一起，協同工作。HomeAssistant可以運行在PC端，也可以運行在樹莓派上，本文介紹的是在樹莓派上運行HomeAssistant的方式。

1.1 硬件準備

1、RF-DG-52PAS模塊實物圖。

圖 1RF-DG-52PAS實物圖

2、樹莓派實物圖（帶以太網口），樹莓派上運行Home Assistant。

圖 2樹莓派實物圖

3、路由器和PC電腦。

RF-DG-52PAS Dongle模塊官方購買鏈接：

https://item.taobao.com/item.htm?id=692221594545

二、環境配置教程

1、將樹莓派上電，再將樹莓派，PC電腦，路由器連接到同一個局域網內。

2、樹莓派連接進同一局域網內后，等待10-20分鐘。

3、PC電腦登錄路由器背面的管理網址，進入管理界面，查看樹莓派的IP地址。

圖 3路由器查看樹莓派IP地址

4、確定樹莓派地址后，再在瀏覽器中輸入樹莓派IP地址+端口號（8123），即可訪問樹莓派后臺管理界面Home Assistant。由于該設備的IP地址為192.168.133.236，即在瀏覽器中輸入192.168.133.236:8123。

圖 4瀏覽器輸入界面

圖 5用戶登錄Home Assistant界面

5、輸入對應的用戶名及密碼后，即可進入智能家居Home Assistant管理界面，管理界面如下。

圖 6Home Assistant管理界面

三、ZHA網關添加和使用方法

ZHA（Zigbee家庭自動化）集成是一個Zigbee網關實現，遵循標準的Zigbee 3.0規范（和早期版本）。在Zigbee中，有三種不同的設備類型：Zigbee協調器（ZC），Zigbee路由器（ZR）和Zigbee終端設備（ZED）。Zigbee網絡總是有一個（并且沒有更多）Zigbee協調員，但是，Zigbee網絡可以有多個Zigbee路由器和多個Zigbee終端設備。

Zigbee 協調器是 Zigbee 網絡中管理和控制網絡的中央設備。它充當 Zigbee 無線協議的物理接口，并負責維護 Zigbee 網絡拓撲并確保 Zigbee 設備之間的安全高效通信。Zigbee路由器設備是市電供電的，將充當Zigbee網絡網格內的Zigbee信號中繼器，以擴展其范圍并提高覆蓋范圍，而Zigbee終端設備通常是電池供電的傳感器，不會充當Zigbee信號中繼器。

在ZHA的情況下，Zigbee協調器是一個無線電適配器或硬件模塊，其中包含一個運行Zigbee協議棧的微控制器，ZHA集成使用該協議棧來管理和與Zigbee網絡及其設備通信。

在安裝 ZHA集成之前，您需要購買并連接一個 Zigbee 協調無線電適配器或硬件模塊，這些通常以USB加密狗的形式直接插入運行家庭助理安裝的計算機。文中使用的信馳達科技RF-DG-52PAS即為Zigbee協調器。

一旦設置了 ZHA 并配置了 Zigbee 協調器無線電適配器或模塊，您將能夠直接將任何 Zigbee 設備加入/配對到 Zigbee 網絡;無論該基于Zigbee的產品的制造商和品牌如何。請注意，雖然通常建議購買 Zigbee 3.0 兼容設備，因為從理論上講，這些設備應該提供更大的互操作性，但請確保有關支持哪些設備和異常處理的部分。

1、在Home Assistant管理界面中選擇“配置—設備與服務”。

圖 7配置-設備與服務界面

2、進入添加集成界面，選擇“添加集成—搜索ZHA”，選擇Zigbee Home Automation。

圖 8選擇ZHA插件

3、點擊Zigbee Home Automation后，選擇RF-DG-52PAS協調器設備端口后提交（可以插拔一下模塊看下設備路徑）

圖 9選擇串行端口

4、下圖就顯示網關添加成功，可以根據需求去添加區域，也可以不添加，直接點擊完成。

圖 10網關添加成功

5、RF-DG-52PAS Zigbee協調器已經添加到ZHA集成里面，點擊設備后進入添加設備界面。

圖 11ZHA插件添加成功

6、點擊添加設備，開始添加Zigbee終端設備。

圖 12開始添加Zigbee終端設備

7、添加ZHA Zigbee終端設備，要確保Zigbee終端設備處于配對狀態（如何處于配對狀態查看設備說明書）配對成功就會顯示出設備，可以設置名稱以及具體使用區域，這樣更容易查找。

圖 13Zigbee終端設備配對成功

8、添加完成后，可以在添加設備界面查看已配對連接的Zigbee終端設備

圖 14Zigbee終端設備列表界面

9、點擊添加成功的已配對Zigbee終端設備，會看到里面有控制設備的開關，具體使用根據設備功能而定。點擊控制就可以開始遠程控制Zigbee終端設備了。

圖 15Zigbee終端設備控制界面

四、Zigbee2MQTT網關添加和使用方法

1、在Home Assistant平臺中選擇“配置—加載項、備份”，進入“加載項商店”界面。

圖 16配置-加載項、備份界面

2、點擊右下角“加載項商店”進入商店，這里可以看到我們添加的一些插件。

圖 17加載項商店界面

3、添加庫。點擊右上角三個點，選擇倉庫，在添加里面輸入“https://github.com/zigbee2mqtt/hassio-zigbee2mqtt”點擊添加。

圖 18添加下載Zigbe2MQTT

4、上一步添加下載完成后，在商店中搜索“zigbee”，就會看到3個插件，點擊zigbee2mqtt，然后點擊安裝。

圖 19商店中搜索下載好的Zigbe2MQTT

圖 20安裝Zigbe2MQTT

5、點擊啟動，可以勾選上“側邊欄顯示”，方便快速查找使用。

圖 21啟動Zigbe2MQTT

6、啟動完成后，點擊側邊的Zigbee2MQTT,可以看到連接頁面，這個頁面就可以添加設備了，如果點擊搜索后報錯，就重啟一下Zigbee2MQTT。

圖 22添加Zigbee終端設備設備界面

7、點擊添加新設備，RF-DG-52PAS協調器模塊就會開始搜索周圍的Zigbee終端設備，要保證要添加的網關設備處于配對狀態下，配對成功后就會在這個界面顯示出來。

圖 23添加配對Zigbee終端設備

8、網關設備添加成功后，就可以在總覽里面去控制設備了。不同設備的控制方式有所區別。

圖 24Zigbee終端設備添加成功

圖 25Zigbee終端設備控制界面

五、常見問題

1、訪問8123 端口失敗

針對8123端口訪問失敗，常見有兩種情況。

情況一：樹莓派IP地址錯誤。需要檢查IP地址是否輸入錯誤，如“.”是否輸入成了“,”。

情況二：樹莓派正在初始化，需要等待初始化結束。

2、確認樹莓派網絡是否正常連接的方法

(1). 鍵盤輸入windows+R，打開運行界面，輸入CMD。

圖 26電腦查找運行界面

(2).輸入指令，ping +樹莓派地址（如：ping 192.168.133.236 ），確認設備在同一個局域網內并暢通。

圖 27查看樹莓派網絡

六、聯系我們

深圳市信馳達科技有限公司（RF-star）是一家專注于物聯網射頻通信方案的高新技術企業，車聯網聯盟（CCC）和智慧車聯產業生態聯盟（ICCE）會員，通過ISO9001和IATF16949質量體系認證。2010年成立之初即成為美國TI公司官方授權方案商，之后陸續得到Silicon Labs、Nordic、Realtek、Espressif Systems、ASR、卓勝微等海內外知名芯片企業的認可和支持。公司提供物聯網無線模塊和應用方案，包括BLE、Wi-Fi、UWB、Zigbee、Thread、Matter、Sub-1G、Wi-SUN、LoRa等。

審核編輯 黃宇