NEWS

如何在 Home Assistant 中整合唐果智能燈具與智慧開關

2025/05/03

一、智慧家庭與開源平台的完美結合

在現代家居中，智慧家庭已從夢想邁向現實。透過各種智能設備與自動化系統的整合，居住者能夠享受更高的便利性、安全性與能源效率。Home Assistant作為最受歡迎的開源智慧家庭平台之一，以其強大的整合性、靈活的客製化能力以及自主控制的開源架構受到廣泛青睞。

Home Assistant 的優勢：開源、自主、強大整合性

開源自主：使用者可完全掌控系統運作，無須仰賴雲端平台，避免隱私疑慮，實現真正的本地化控制。
廣泛支援裝置：支援超過2000種以上的智慧設備，從照明、空調、安全監控到能源管理，整合性極高。
社群活躍：有活躍的開發者與使用者社群，持續提供插件與功能優化，不斷進化中。

為什麼選擇唐果科技產品？

專業智慧照明子系統：模組化設計您的居家，一站式多樣燈具及開關挑選，省去複雜繁索的整合問題。
本土品牌：唐果科技專注於台灣智慧家庭市場，熟悉在地需求與住宅結構，能快速回應在地使用者的問題。
系統穩定：產品穩定度高，與Modbus協定整合良好，不易掉線或失控，是打造穩定智慧系統的基礎。
高度整合能力：開關與燈具互通性高，支援群組控制、情境切換、調光調色，應用彈性極大。

二、準備工作：安裝與基礎環境設定

要順利整合唐果科技產品與 Home Assistant，您需要先完成以下幾項準備：

安裝 Home Assistant

推薦使用 Raspberry Pi（建議為 Raspberry Pi 4 Model B，至少4GB RAM）搭配 microSD 卡安裝 Home Assistant OS。若需要更穩定的系統，也可選擇安裝至 SSD 或 NUC。請參考官方安裝指南：https://www.home-assistant.io/installation/raspberrypi

唐果產品設備準備清單：

智慧開關（Smart Switch）：支援情境切換、觸控回饋、多路控制等功能。
智慧燈具：具備可調光、色溫控制等功能，支援無線通訊。
唐果 Modbus/2.4GHz Gateway：作為橋接 Home Assistant 與智慧燈具的通訊媒介，轉換資料協定，確保訊號穩定傳輸。

其他必要工具：

與唐果科技聯絡，取得 Configuration.yaml 與 Gateway匯入工具（tgm_Import.exe）及說明文件。
一張128GB以下的Micro SD卡（格式建議為 FAT32），建議使用品質穩定品牌避免錯誤。
USB轉RS485通訊模組（用以連接 Gateway 與 Home Assistant），可採用 CH340、FTDI 晶片模組。
一台具備網路連線的電腦與讀卡機，以進行資料匯出與檔案處理。

三、唐果智能開關與燈具的接入方式

接下來是實際整合步驟說明：

Step1：智慧開關新增設備與設定

開啟唐果智慧開關Smart Switch，新增燈具與控制模組，並依照需求設定群組（如客廳、臥室、餐廳），設定不同的情境模式（如日常、晚間、觀影）。

Step2：插入 SD 卡並匯出備份

將設備設定完成後，透過 App 匯出設定至插入的 SD 卡。檔案名稱為 Mesh_Config.json，建議儲存備份副本。

Step3：設定 Gateway 參數

將唐果 Gateway 接上 USB-RS485 模組，並插入至 Windows 電腦。透過觀察播碼開關確認 ID = 1，Baud Rate 設為19200bps。這是 Gateway 與 Home Assistant 能否成功通訊的關鍵參數。

Step4：執行匯入工具

將剛才的 Mesh_Config.json 以及 tgm_Import.exe 放入同一資料夾，點擊執行。匯入過程會將設備資訊轉為 Modbus 可識別格式。出現「匯入成功」提示即代表完成。

Step5：轉移 Gateway 至 Home Assistant 裝置

將 Gateway 與 USB-RS485 模組轉接至安裝好 Home Assistant 的裝置（如 Raspberry Pi）。確保 USB 連接正常。

Step6：導入 Configuration.yaml 並重啟

將取得的 configuration.yaml 檔案放入 Home Assistant 的 config 資料夾中，並重啟 Home Assistant。系統將自動讀取配置檔並開始連線與辨識設備。

四、實作案例分享：從入門到進階

以下實際操作分享涵蓋從簡單控制到客製化儀表板的應用：

Web Dashboard 儀表板燈光控制

控制房間燈光開關、調光、調色、情境控制。
可調整閱讀燈、床頭燈的亮度與色溫（例如 2700K~6000K）。

連接Apple Home，整合語音助理與手機操控

結合 Apple Siri、Google Assistant、Amazon Alexa 等主流語音助理。
透過手機 App（如 HomeKit、Google Home）遠端控制燈光、開關。
設定「回家模式」、「外出模式」等情境自動啟用特定燈光與設備。

高階應用：Lovelace 儀表板客製化

使用 Home Assistant 的 Lovelace UI 建立儀表板介面。
顯示各房間燈具狀態（開關、亮度、色溫）。
增加 RGB 控制盤、色溫滑桿、自動化啟動按鈕。
可搭配時間條件、感測器或場景進行進階自動控制。

五、整合時常見問題與排錯建議

整合過程中難免會遇到問題，以下是常見錯誤與解法：

Q1：無法匯入 Mesh 設定檔？

播碼開關未設定為 ID = 1，請再次確認硬體設定。
SD 卡容量超過 128GB，建議使用 128GB 以下卡片。
匯出過程中未完整寫入，請重新匯出並格式化後重試。

Q2：Gateway 無反應或燈具無法控制？

確認 RS485 模組與 Gateway 間接線正確，A/B 線不要接反。
確保 Gateway 供電正常，LED 狀態顯示應為常亮或閃爍。
將所有設備斷電 10 秒再重新上電，清除暫存狀態。

Q3：燈具未出現在 Home Assistant 中？

檢查 configuration.yaml 是否格式正確、縮排無誤。
進入 Home Assistant > 開發者工具 > Entities，確認裝置是否被識別。
嘗試重新載入 YAML 設定或重啟 Home Assistant。

六、結語：打造屬於你的智慧家庭照明生態

透過本文的完整教學，您將能有效地將 唐果科技的智慧開關與燈具整合進 Home Assistant，打造真正具備高效能、低維護、可擴充、符合台灣實際使用需求的智慧家庭系統。

選擇唐果科技，代表選擇有實戰經驗的在地品牌，確保軟硬整合順暢。
整合 Home Assistant，讓您的所有設備邁向自動化，並具備無限擴充可能。
從燈光入手，未來可逐步擴充至冷氣、窗簾、感測器、警報系統等。

若您在建置過程中遇到問題，唐果科技提供在地技術支援與遠端協助，是每位智慧家庭建構者的可靠後盾。

歡迎加賴，專人為你服務!!