先認識 KNX、KNXD、ETS 與 Home Assistant

本章任務卡

你已經熟悉 Home Assistant 的 Add-on、整合與實體。這一章不要求你安裝或設定任何東西，只先把四個角色放對位置。角色分清楚，之後看到像設備通訊道路的 KNX、像設計圖工具的 ETS或像翻譯櫃檯的 KNXD時，就不必靠猜。

目的

能用自己的話分清 Home Assistant、ETS、KNXD 與 KNX 裝置網路。

準備

只要會使用 Home Assistant；不需要懂 KNX、Linux 或網路工程。

時間

約 10 分鐘。

系統變更

不修改 Home Assistant。

預期結果

能分清 Home Assistant、ETS、KNXD 與 KNX 裝置網路，且知道程序執行不等於 bus 成功。

停止條件

• 需要輸入真實 KNX 位址、主機資料或秘密。
• 步驟要求連接 KNX bus 或控制實體設備。

先守住安全界線

本章是認識角色的閱讀任務。你不會啟動 Add-on，也不會傳送像道路短訊息的 KNX telegram，或讀寫像共同信箱的群組位址。畫面上即使出現「執行中」，也只能說某個程序正在執行，不能說 KNX 裝置網路已經接通。

請記住：程序正在執行，不等於 bus 已成功。就像翻譯人員已經坐到櫃檯，不代表電話線已接好，也不代表大樓裡的設備收到訊息。本章不證明 ETS 專案、Home Assistant KNX 整合或實體設備控制有任何成果。

環境識別資料包括真實主機名稱、IP、個體位址與群組位址。秘密或裝置識別資料包括 USB 序號、token 與憑證；兩類資料都不要抄錄或分享。

用大樓櫃檯認識四個角色

開始前只要知道這些

你不需要準備硬體、ETS 專案或網路資料。先用一張紙寫下四格：Home Assistant、ETS、KNXD、KNX 裝置網路。接著把每個角色的一句白話說明放進對應格子即可。

• Home Assistant 是你提出需求的控制櫃檯。
• ETS 是規劃與設定 KNX 專案的工具，不是 KNXD 的另一個名稱。
• 在本指南採用的路徑中，KNXD 是翻譯櫃檯；Add-on 是 Home Assistant 管理它的包裝。
• 在本站的責任圖裡，KNX 裝置網路放在設備側；其他程序的狀態不能替它作證。

用四句話走一遍

現在只做口頭演練，不操作任何介面。每一步都問「誰負責」，不要問「要填什麼值」。

1. 先找操作入口。你在 Home Assistant 提出需求，所以它是控制櫃檯。
2. 再找專案規劃。需要描述 KNX 專案如何設計時，那是 ETS 的角色，不是 Home Assistant Add-on 的角色。
3. 再找中間翻譯。本指南採用的 Add-on 路徑把 KNXD 放在 Home Assistant 管理端與 KNX 裝置網路之間；Add-on 負責在 Home Assistant 中管理這個程序。
4. 最後守住結果邊界。KNXD 程序出現或正在執行，只能證明程序層狀態；KNX bus 是否接通仍未由此證實。

若你能在不提任何 IP、位址或設定值的情況下說完四句，就已完成本章的白話主線。

完成檢查

用下面清單自我檢查。這裡的完成是「心智模型完成」，不是系統部署完成。

• 我能說出 Home Assistant 是控制櫃檯，ETS 是大樓設計圖與設定工具。
• 我能說出 KNXD 是翻譯櫃檯，KNX 是設備通訊網路。
• 我知道 Add-on 顯示執行中，不能當成 KNX bus 的成功證據。
• 我沒有連接 bus、操作 ETS、讀寫群組或控制實體設備。

下一步：前往第 2 章，用同一個大樓比喻看懂資料責任會依序經過哪些角色。

角色放錯時怎麼辦

這一章不會遇到服務故障，常見問題是把角色或證據層級混在一起。請用下列方式把說法改回正確位置。

• 把 ETS 當成 Home Assistant 整合：拆開來看；ETS 是 KNX 專案的規劃與設定工具，整合是 Home Assistant 內的另一個角色。
• 把 KNXD 當成 KNX 裝置：把 KNXD 放回翻譯櫃檯；裝置網路仍在它的下游。
• 看到「執行中」就以為 bus 接通：把結論降回程序層，bus 維持「未由此證實」。
• 覺得一定要先取得現場資料：停止收集；本章只需要角色名稱，不需要任何環境識別資訊。

進階補充與常見問題