第一部 · 第 8 章

Listener 與 KNXnet/IP 邊界

說明來源中的 listener 與 KNXnet/IP 詞彙,不宣稱端點可達。

已撰寫

本章概覽

先說結論:listener 只是一個等待接收工作的角色。看到設定中有這個角色,不能證明端點可達、連線或 tunnel 成立,也不能證明 KNX bus 狀態。

目的
分清 listener、網路介面、KNXnet/IP 與 KNX bus 的責任。
準備
第 7 章的欄位責任表;不需要端點、網路工具或 ETS。
時間
約 15 分鐘。
系統變更
不修改 Home Assistant 或網路;只閱讀 listener 與 KNXnet/IP 的責任邊界。
預期結果
能說明 listener、網路介面與 KNX bus 的不同責任,不宣稱端點可達或連線成功。
停止條件
  • 需要提供、探測或連線真實網路端點。
  • 不得宣稱 KNX bus 或介面成功;listener 狀態不能證明它。

範圍與安全界線

本章只讀固定範本。不要提供或探測端點。不要執行連線、tunnel、socket 或 reachability 程序。不要抄錄主機、IP、port、URL、網路介面、憑證或任何環境識別資料。

本章不加入 repository、不安裝、不啟動。任何變更仍必須先有完整隔離、書面核准,以及核准的 immutable artifact/image provenance。本站目前缺少核准的 artifact/image digest,因此所有執行動作都被封鎖。

不要連接 KNX 介面或 bus。禁止群組讀取。禁止群組寫入。禁止 telegram 傳送。禁止 ETS programming/download。禁止實體控制。listener 或網路訊息都不能替這些結果作證。

核心概念

先分清「有人坐在櫃檯」「外面的人找得到櫃檯」與「後方工作真的完成」。

等待來電的接待櫃檯

先這樣想:接待員坐在櫃檯等電話。有人值班,不表示外線已接通;外線接通,也不表示後方設備已完成工作。

正式名稱:listener 與 KNXnet/IP 責任邊界。

listener 負責等待網路側請求。網路介面承接資料進出。KNXnet/IP 是網路側通訊語境。KNX bus 則是另一個責任層。

請保持四層分開:範本宣告、程序/listener 狀態、端點 reachability、KNX bus 結果。前一層永遠不能自動證明下一層。

準備與前置條件

畫四個空框,不填端點或數值:

  1. 範本角色:固定文件是否提到 server 或 listener。
  2. 程序角色:是否有獨立的程序/listener 證據。
  3. 網路角色:端點是否可達;本章一律寫「不探測、未建立」。
  4. bus 角色:KNX bus 是否有成果;本章一律寫「未證實」。

這張圖只用來限制說法。它不是網路拓撲,也不能拿來建立連線。

分段步驟

  1. 先寫文件結論。只寫「固定範本包含 listener/server 設定角色」。不要寫「已監聽」。
  2. 放進第一個框。把這句話放在範本層。其餘三框保持未建立或未證實。
  3. 分開網路介面。註明介面只負責網路資料進出;它不等於 listener,也不能代表 bus。
  4. 封住 reachability 推論。在網路框寫「沒有端點、沒有探測、沒有連線或 tunnel 程序」。
  5. 封住 bus 推論。在 bus 框分別寫「沒有 telegram 證據」「沒有群組操作證據」「未執行 ETS programming/download」「沒有實體控制證據」。
  6. 逐句降低結論。若看到端點、連線、tunnel 或 bus 的肯定成果,移除並退回固定範本能支持的說法。

驗證與證據

完成成果是一張四層責任圖。唯一有直接來源的是範本角色。其他層都要保持未證實。

  • 我能說明 listener 像等待來電的接待櫃檯,不等於外線可達。
  • 我把範本、程序/listener、reachability 與 KNX bus 分成四層。
  • 我的圖沒有主機、IP、port、URL、介面名稱、憑證或其他環境識別資料。
  • 我沒有提供探測、連線或 tunnel 程序。bus、ETS、整合與實體控制成果都維持未證實。

下一步:繼續前往第 9 章,分類 INI 區段、選項與受管範本的責任。

故障排除

  • 範本看起來已有完整設定:仍只記為範本角色。它不證明已產生、已套用或已監聽。
  • 日誌出現 listener 字樣:只屬程序/listener 層。依狀態判讀把 reachability 與 bus 保持未證實。
  • 有人要求提供端點:不提供。公開教材不包含可連線值。
  • 有人想探測是否可達:停止。本章沒有 reachability、連線或 tunnel 程序。
  • 有人把 KNXnet/IP 當成 bus 成果:退回四層圖。網路側術語不能證明 KNX bus。

常見問題

進階補充:固定 INI 範本支持的技術說法

Add-on 0.6.1 的受管理 INI 範本含 TCP server 與 listener 相關的設定詞彙。這只證明範本如何表達一個伺服端角色,不證明產生後設定、socket、綁定位置、路由、防火牆或遠端端點。

KNXnet/IP 是本章使用的網路側責任術語。沒有獨立證據時,不能宣稱 reachability、連線、tunnel、轉送介面或 KNX bus 成果。

範本有 server 區段,代表 listener 已建立嗎?

不代表。範本宣告與執行中狀態是不同證據層。

listener 存在,代表遠端可達嗎?

不代表。綁定、路由、防火牆與網路範圍都需要其他證據;本章不探測。

可以提供連線或 tunnel 步驟嗎?

不可以。本章只建立責任邊界,不提供端點或連線程序。

端點可達就代表 KNX bus 有成果嗎?

不代表。網路 reachability 與 KNX bus 是不同責任層。

ETS 要怎麼使用這個 listener?

本章不提供 ETS 連線、programming、download 或群組操作。固定來源也沒有支持這些程序。

證據與來源

證據類別:source-bounded

功能對照:listener-knxnet-ip-boundary

固定來源只支持文件所述範圍;本頁不代表任何本機、硬體、網路或 KNX 匯流排驗證結果。