2025.3.4
首页 ▸ Integrations ▸

Lutron Homeworks

Lutron 是一家美国照明控制公司。 Lutron Homeworks 系列 4 和 8 系统相对较旧（约 2003 年），使用 RS-232 连接与家庭自动化系统进行通信。 Home Assistant 中的 homeworks 集成负责与这些系统的主控制器进行通信。通信是通过以太网到串行转换器（例如 NPort）进行的。

仅支持 Homeworks 系统的部分 - 灯光和键盘。

Lutron 多年来创造了许多系统，每个系统都有自己独特的接口协议。有三种 Homeworks 系统 - QS、系列 4 和 8 以及原始版。这个平台仅适用于系列 4 和 8。还有其他集成 lutron 处理 Lutron RadioRA 2 系统。

Homeworks 键盘按钮是瞬时开关。按钮被按下并释放，意味着没有“状态”。按钮会生成 homeworks_button_press 和 homeworks_button_release 事件。这些事件包含被按下按钮的“id”、“name”和“button”。“id”源自“name”，“button”是键盘上按钮的编号（从 1 开始）。也可以添加指示键盘 LED 是否点亮的二进制传感器实体，以及可以用于触发与键盘按钮绑定的操作的按钮实体。

配置

要将 Lutron Homeworks integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

如果上述 My 按钮不起作用，您也可以手动执行以下步骤：

没有文档记录用于自动提取控制器设备信息的协议。灯光和键盘需要手动添加。可以通过在添加集成后配置集成来完成这项工作。

操作

操作 send_command

向 Lutron Homeworks 控制器发送自定义命令。

数据属性 可选 示例 描述
controller_id 否 homeworks 命令应发送到的控制器。
command 否 KBP, [02:08:02:01], 1 你想发送的命令。这可以是单个命令或一系列命令。除了控制器支持的命令外，还支持特殊命令 DELAY <ms>，其中 ms 是要休眠的毫秒数。

发送命令列表

示例展示了如何发送 KBP，等待 0.5 秒，然后发送 KBR 来模拟键盘按钮按压持续半秒。

action: homeworks.send_command
data:
  controller_id: "homeworks"
  command:
    - "KBP, [02:08:02:01], 1"
    - "DELAY 500"
    - "KBR, [02:08:02:01], 1"