驅動家族選擇與版本限制

本章概覽

先說結論：你只會選出一個「固定文件有說明的驅動家族」，交給日後人工複核。這不是安裝建議，也不是硬體相容證明。文件不足就不選。

目的

依固定文件列出一個可供人工複核的 driver 家族候選。

準備

第 5 章的去識別分類結果，以及固定版本的文件對照。

時間

約 15 分鐘。

系統變更

不修改 Home Assistant；只依固定文件離線比較 driver 家族。

預期結果

能列出供人工複核的 driver 家族候選，不把名稱對應寫成硬體相容或可用證明。

停止條件

• 有人要求從產品名稱直接推論 driver 或硬體相容性。
• 步驟要求載入 driver、啟動服務或接觸實體介面。

範圍與安全界線

本章只讀固定文件。不要從產品名稱、外觀、插頭、候選代號或網路文章猜驅動。也不要輪流啟動驅動來試。若沒有同版本的明確文件，答案就是「不選，待補證據」。

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

不要連接介面或 KNX bus。禁止群組讀取、群組寫入、telegram 傳送、ETS programming／download 與實體控制。不要記錄任何環境識別資料。

核心概念

選擇時只問兩題：Add-on 固定版本是否接受這個名稱？鎖定的 upstream 文件是否明確說明同名家族？兩題都是「是」，才可列為日後人工複核候選。

準備與前置條件

建立一張離線決策卡。不要放產品名稱、裝置路徑、序號、主機、IP 或端點。卡片只需要：

• 需求類別：只寫「裝置型輸入」或「端點型輸入」等角色。
• Add-on 名稱證據：有、沒有或未知。
• upstream 文件說明：有、沒有或未知。
• 人工複核狀態：待複核或停止。
• 非結論：本機硬體相容、驅動啟動與 bus 狀態都未證實。

版本不符時，先看版本與相容性。不要拿其他版本補答案。

分段步驟

1. 先寫需求角色。只寫需要處理哪一類輸入。不要寫品牌、型號或真實值。
2. 核對 Add-on 名稱。確認候選名稱在 Add-on 0.6.1 的固定列舉中。沒有就停止，不自行改名。
3. 核對 upstream 說明。確認 upstream 0.14.72 固定文件明確描述同名驅動家族。只有名稱相似不算。
4. 最多保留一個候選。兩邊文件都明確時，寫成「文件候選，待人工複核」。若有多個或沒有明確答案，就不選。
5. 補上非結論。寫明「未證明硬體相容、未載入驅動、未啟動服務、未接觸 bus」。
6. 在文件層停止。把決策卡交給核准流程。不要試啟動，也不要用正向日誌替候選加分。

驗證與證據

完成結果只能是「文件候選」或「證據不足」。不能寫成「驅動適用」。

• 候選同時有 Add-on 0.6.1 名稱證據與 upstream 0.14.72 明確文件。
• 決策卡沒有產品、路徑、序號、主機、IP、端點或憑證。
• 我把硬體相容、載入、啟動、listener 與 bus 狀態都保留為未證實。
• 我沒有輪流試驅動，也沒有安裝、啟動或連接實體介面。

下一步：前往第 7 章，只辨認設定欄位、占位文字、門牌號碼與暴露責任。

故障排除

• 只有 Add-on 名稱，沒有 upstream 說明：標示證據不足，不建立家族對應。
• 名稱很像但不完全相同：視為不同。不要從字首、字尾或產品描述猜。
• 有兩個文件候選：兩個都不選。列出文件缺口，交給人工複核。
• 有人把預設值當推薦：移除推薦語句。來源預設只是一個 schema 事實。
• 有人要求啟動看看：停止。試啟動不是文件選擇，也不能證明硬體相容。

常見問題