PART ONE
專案總覽｜功能與應用場景
此 Home Assistant 自訂元件透過網路控制 DMX 燈光設備，支援 Art-Net、sACN (E1.31) 及 KiNET 等多種協議。該整合能夠精細調控 RGB、RGBW、色溫等多種類型的燈具，並提供高解析度調光、輸出校正曲線及平滑過渡等進階功能，所有設定均可透過 Home Assistant 圖形介面完成。
🔑 核心功能
- 支援多種協議
- 支援多種燈具類型
- 高解析度與輸出校正
- 平滑過渡與彈性通道設定
- UI 設定介面
📋 功能詳細說明
| 功能名稱 | 說明 |
|---|---|
| 舞台燈光效果同步 | 將舞台上的多個 RGB DMX Par 燈連接到 Art-Net 閘道器。在 Home Assistant 中，為每個燈具設定對應的 DMX 通道和 Universe，然後建立場景，例如「演唱會模式」，可一鍵觸發所有燈光同步閃爍、變換色彩，營造專業的舞台燈光效果。 |
| 建築外牆動態照明 | 在建築物外牆安裝多條 RGBW LED 燈帶，並透過 sACN 協議連接到控制器。使用此整合，可以設定一個自動化任務，讓外牆在日落後自動點亮，並根據不同節日（如聖誕節、新年）呈現不同的動態色彩主題，例如流動的彩虹效果或緩慢的色彩漸變。 |
PART TWO
深入解析｜執行環境與部署步驟
⚙️ 執行環境需求
- 運行此專案所需的軟體、硬體和相依套件
- 需要 Home Assistant 2023.1 或更高版本。建議使用 Home Assistant OS 或 Home Assistant Supervised 安裝方式，以獲得完整的附加元件支援。
- 建議至少 Raspberry Pi 4（2GB RAM）或同等級 x86 設備。若同時運行多個整合，建議 4GB RAM 以上。需要穩定的網路連線和足夠的儲存空間（至少 32GB SD 卡或 SSD）。
- 需要先安裝 HACS 整合商店，用於方便地安裝和管理此自訂元件。可透過 Home Assistant 的附加元件商店或手動安裝 HACS。
- Home Assistant 內建 Python 3.11+ 執行環境，無需額外安裝。此元件的相依套件會在安裝時自動處理。
🔧 部署安裝步驟
| 步驟 | 說明 |
|---|---|
| Step 1 | 將 custom_components/artnet_led 資料夾複製到 Home Assistant 的 config/custom_components/ 目錄 |
| Step 2 | 重新啟動 Home Assistant 伺服器以載入新的整合 |
| Step 3 | 前往「設定」→「裝置與服務」，點擊「新增整合」並搜尋「Art-Net LED」 |
| Step 4 | 在設定精靈中，輸入 Art-Net/sACN 閘道器的 IP 位址、埠號及協議類型 |
| Step 5 | 新增並設定燈具，指定其 DMX Universe、起始通道和燈具類型（如 RGB、Dimmer），即可在儀表板中控制 |
PART THREE
總結與展望｜AI Agent 部署 Prompt
🤖 AI Agent 部署 Prompt
以下是用於部署此專案的 AI Agent Prompt，可直接複製使用：
複製此 Prompt 給 AI Agent，即可自動完成安裝、部署與測試
← 返回開源專案列表