Home Assistant KNX 實體模型

本章概覽

先說結論：你只會用標籤卡分清 Home Assistant entity、KNX 個體位址與群組位址的角色。每張卡只記欄位角色與分類，不放值、映射、payload、服務呼叫或控制例子。

目的

用檔案卡分清 entity、個體位址與群組位址的角色，不記值或映射。

準備

幾張空白卡與第 14 章的離線工作表；不需要 Home Assistant 或 KNX 資料。

時間

約 20 分鐘。

系統變更

不建立 Home Assistant 實體或群組設定；只離線整理實體模型。

預期結果

能說明實體、個體位址與群組位址不可互換，且本章只記欄位角色與分類，不記值或映射。

停止條件

• 需要提供或猜測真實個體位址、群組位址或家庭裝置資料。
• 不得建立實體；不得群組讀寫；不得傳送 telegram；不得實體控制。

範圍與安全界線

卡片只放概念標籤。不要放識別字串、位址值、對應值、映射、資料內容、payload、設定形狀、控制或服務呼叫，也不要舉任何實體設備的控制情境。

不加入 repository、不安裝、不啟動。只有實體隔離、書面核准，以及核准的 immutable artifact／image digest 與 source-to-build attestation 全部具備時，才能在本章之外另案評估；本章不提供授權。

不得自動化群組讀取。不得群組寫入。不得傳送 telegram。不得執行 ETS programming／download。不得實體控制。卡片不能證明 Home Assistant 實體、整合、KNX bus、ETS 或設備有任何成果。

核心概念

即使標籤文字很清楚，也不能由名稱猜出現場值、映射、資料方向、型別或狀態。缺少授權證據時，一律保留「待確認」。

準備與前置條件

每張空白卡只畫四格。不要模仿 Home Assistant 或 KNX 的設定畫面。

• 用途標籤：只寫一般軟體用途。
• 資料語意：只寫「待來源確認」。
• 欄位角色：只寫 entity、device 身分或共享通訊主題的分類；不記任何對照。
• 證據狀態：只用待確認、固定來源支持或不適用。
• 卡片頁尾：寫「不可匯入、不可呼叫、不可控制」。

如果一般用途也會透露家庭、房間、人員或裝置資訊，就換成更抽象的標籤。你不需要為了讓卡片看起來完整而增加例子。

分段步驟

完成品是離線分類卡，不是實體清單。

1. 建立用途卡。每張卡只放一個一般用途，避免家庭、房間、設備或人員名稱。
2. 加入資料語意格。寫這個模型需要哪一類意義；固定來源沒有支持時就寫「待來源確認」。
3. 加入欄位角色格。只分類為 entity、device 身分或共享通訊主題角色，不寫任何值、映射、方向、內容或格式。
4. 加入證據狀態格。把文件概念與 Core 版本中繼資料分開標示，不把兩者寫成執行證據。
5. 做去識別檢查。移除識別字串、家庭情境、payload、呼叫、設定形狀與任何控制暗示。
6. 封存卡片。在整疊卡上寫「僅供紙上審閱；實體、整合與 bus 狀態未知」。

驗證與證據

一眼能分清 entity、device 身分、共享通訊主題與證據，就算完成。任何需要猜測的格子都應維持待確認。

• 我能說明 entity 是面向使用者的檔案卡／語意物件、個體位址是一個 KNX device 的身分、群組位址是 KNX 設計使用的共享通訊主題。
• 我知道三者不可互換，每張卡只記用途、資料語意、欄位角色與證據狀態。
• 所有用途都是去識別的一般標籤。
• 卡片沒有位址值、映射、識別字串、payload、服務呼叫、設定形狀或控制例子。
• 名稱沒有被當成資料方向、型別或現場狀態證據。
• 我沒有建立實體。我不得執行群組操作，不得傳送 telegram，也不得控制設備。

下一步：前往第 16 章，在任何動作發生前先做安全分類。

故障排除

• 標籤像現場名稱：改成一般用途，移除家庭、空間、設備與人員線索。
• 有人想從名稱猜資料意義：改寫為「待來源確認」。名稱不是型別證據。
• 欄位角色格出現值、映射或方向：立即移除，只保留 entity、device 身分或共享通訊主題的分類。
• 卡片看起來可匯入：移除設定形狀與順序，補上不可執行標示。
• 有人要求服務呼叫或控制例子：拒絕。本章只處理離線模型。
• 畫面狀態被當成 bus 證據：退回軟體觀察；本章沒有任何現場成果。

常見問題