PART ONE
專案總覽｜功能與應用場景
這是一個 Home Assistant 的自訂元件，專為控制 Somfy PoE（乙太網路供電）電動窗簾而設計。它透過加密的 UDP 連線，使用 Synergy JSON-RPC API 與馬達進行安全通訊，實現完整的窗簾控制功能。
🔑 核心功能
- 全功能窗簾控制
- 即時位置追蹤
- AES-128-CBC 加密通訊
- 支援 UI 與 YAML 雙重設定
- 自動調整輪詢頻率
- 完整的錯誤處理
📋 功能詳細說明
| 功能名稱 | 說明 |
|---|---|
| 智慧家庭晨間喚醒 | 設定自動化場景，早上7點鬧鐘響起時客廳Somfy窗簾自動緩慢拉開50%，讓陽光自然灑入作為溫和喚醒方式。 |
| 離家模式自動關閉窗簾 | 當家庭成員均已離家時，HA自動觸發離家模式，將所有Somfy窗簾完全關閉，保護隱私並節省能源。 |
PART TWO
深入解析｜執行環境與部署步驟
⚙️ 執行環境需求
- 需要運行中的HA實例，建議版本2023.x或更高
- 支援Synergy API的Somfy PoE系列電動馬達，如Sonesse 30/40 PoE
- HA主機與Somfy馬達需在同一區域網路內
- 需從馬達標籤取得32字元加密金鑰和6字元Target ID
🔧 部署安裝步驟
| 步驟 | 說明 |
|---|---|
| Step 1 | 將custom_components/woow_tech_somfy_cover資料夾複製到HA設定目錄下的custom_components中 |
| Step 2 | 重新啟動HA服務以載入新的自訂元件 |
| Step 3 | 前往設定->裝置與服務，點擊新增整合 |
| Step 4 | 搜尋WoowTech Somfy Cover並進行設定 |
| Step 5 | 輸入窗簾名稱、IP位址、Target ID和加密金鑰 |
| Step 6 | 點擊提交後整合將測試連線並新增裝置 |
| Step 7 | 或在configuration.yaml中手動設定 |
PART THREE
總結與展望｜AI Agent 部署 Prompt
🤖 AI Agent 部署 Prompt
以下是用於部署此專案的 AI Agent Prompt，可直接複製使用：
請幫我安裝並部署 woow_tech_somfy_cover。 ## 專案資訊 - 倉庫位址：https://github.com/WOOWTECH/woow_tech_somfy_cover - 類型：Home Assistant 自訂元件 - 功能：控制Somfy PoE電動窗簾，透過加密UDP連線使用Synergy JSON-RPC API ## 環境需求 - HA 2023.x+ - Somfy PoE馬達(Synergy API) - 同一區域網路 - 32字元加密金鑰+6字元Target ID ## 安裝步驟 1. 複製custom_components到HA目錄 2. 重啟HA 3. 設定->裝置與服務->新增整合 4. 搜尋WoowTech Somfy Cover 5. 輸入名稱、IP、Target ID、加密金鑰 6. 提交完成
← 返回開源專案列表