Home Assistant 安裝小燕科技整合指南

關於小燕 Home Assistant 整合

小燕科技的系統與通訊協定經過多年使用驗證，具備穩定可靠的運行表現。隨著智慧家居生態的發展，我們持續為用戶提供更開放、更靈活的整合方案。

我們的 Home Assistant 外掛程式由專業團隊持續維護更新，確保與最新版本的相容性，讓用戶能夠輕鬆將小燕產品整合至 Home Assistant 生態系統中。

安裝前準備

必要條件

1. 小燕產品與網關：需要擁有小燕智慧家居產品及小燕家庭中心

2. Home Assistant 環境：建議使用 HAOS 系統（可購買成品 HA 盒子降低入門門檻）

技術說明

小燕的 HA 外掛程式採用自有的 TCP 協定與 Home Assistant 進行串接，因此需要透過小燕家庭中心運作。對於小燕單品用戶，部分產品已支援 Zigbee2MQTT 接入方式。

支援設備類型

我們的 Home Assistant 整合支援以下設備類型：

照明與開關

• 智慧燈具

• 智慧開關

• 無線開關

• 旋鈕開關（支援按鍵點擊事件）

• 智慧插座

自動化設備

• 窗簾電機

• 空調控制

感測器設備

• 人體感測器

• 門磁感測器

• 溫度感測器

• 濕度感測器

• 照度感測器

• 存在感測器

安裝方式

透過 HACS 安裝（推薦）

我們建議透過 HACS 的圖形化介面進行安裝，操作簡單直觀： 請參考我們的 GitHub 頁面  https://github.com/rxwen/homeassistant-terncy-component

• 安裝 HACS：在您的 Home Assistant 中先安裝 HACS 系統

• 開啟 HACS 管理頁面：在 HA 介面中進入 HACS 管理

• 點擊頁面右上角的三個點圖標，選擇 Custom repositories 入口

• 在 Repository 輸入框輸入 https://github.com/rxwen/homeassistant-terncy-component，類別中選擇 Integration。點擊Add。

• 在搜尋框輸入 "terncy" 搜尋小燕插件，點選搜尋結果進入詳情頁。

• 點選頁面右下角的下載按鈕，查看下載詳情。

• 選擇最新版本，點擊下載安裝插件

• 重啟HA

配置流程：

外掛程式安裝完成後，home assistant 可以自動發現網路中的小燕家庭中心。

連接小燕設備前，請先使用小燕在家App 完成系統設定。

- 在 home assistant 的設定-整合 頁面上，點選自動發現的小燕家庭中心圖示的設定按鈕，啟動初始化流程。 （如未自動發現，點擊新增整合並選擇 Terncy 進行查找。）

• 在畫面中點擊Submit

• 此時在小燕在家 App 中可收到 home assistant 請求連線的提醒，點選同意。 （如未發現提示框，請查看家庭中心設定頁，進入區域網路存取授權欄查看）

• 回到 home assistant 頁面再次點擊提Submit，完成配置

配置完成后，即可在 home assistant 中看到小燕設備。