Home Assistant DMX over IP集成指南

Home Assistant DMX over IP集成指南

hass-dmxHome Assistant DMX over IP Integration项目地址:https://gitcode.com/gh_mirrors/ha/hass-dmx

项目介绍

Home Assistant DMX是专为家庭自动化系统Home Assistant设计的一款IP上的DMX集成组件。该组件由jnimmo开发并维护，基于Art-Net或KiNet协议发送UDP数据包到DMX接口，实现对灯光设备的控制。它不依赖外部库，且需Python版本3.5以上支持。Art-Net技术的设计版权归属Artistic Licence Holdings Ltd。此项目遵循MIT许可证，并在开源社区中得到了积极的支持和贡献。

项目快速启动

环境准备

确保您的Home Assistant版本在0.66及以上。

安装步骤

使用HACS（推荐）

1. 在Home Assistant中安装并配置HACS。
2. 通过HACS搜索hass-dmx并添加仓库jnimmo/hass-dmx。
3. 完成安装后，重启Home Assistant。

手动安装

1. 下载custom_components/dmx目录。
2. 将下载的目录上传至您Home Assistant实例的/config/custom_components/dmx路径下。
3. 重启Home Assistant。

配置

编辑Home Assistant的configuration.yaml文件，在light域下添加DMX灯具配置。例如：

light:
  - platform: dmx
    name: "Stage Light 1"
    channel: 1

记得重启Home Assistant以使配置生效。

应用案例和最佳实践

• 智能舞台照明: 利用Home Assistant作为中心控制台，结合DMX灯具，可创建复杂的照明场景，如演出时根据不同节目自动调整照明颜色和亮度。
• 家居氛围调节: 对于具有DMX接口的LED灯带或吊灯，设置定时变化或与智能家居场景联动，比如晚上自动调低光线，创造温馨的休息环境。

最佳实践

• 分组管理: 根据功能或位置将灯具分组，便于统一控制。
• 动态场景: 利用Home Assistant的场景功能，预设多个灯光效果，一键触发。
• 利用传感器: 结合光照传感器，自动调整室内光线强度，保持舒适度。

典型生态项目

• 兼容硬件: 支持多种DMX硬件接口，包括Enttec devices (e.g., DMXKing edmx series, ODE MK2), FTDI-based USB-DMX adapters when combined with a UDP proxy.
• 第三方插件整合: 尽管主要关注DMX控制，但可以与Home Assistant中的其他插件结合，如与Zigbee/Hue灯具共同编排，实现混合控制场景。

请注意，部署前应详细阅读官方文档，并根据个人需求进行适当配置。持续关注社区更新和讨论，以获取最新特性和解决问题的技巧。

hass-dmxHome Assistant DMX over IP Integration项目地址:https://gitcode.com/gh_mirrors/ha/hass-dmx