2025.3.4
首页 ▸ Integrations ▸

Lutron Caséta

Lutron 是一家美国照明控制公司。他们有几条家庭自动化设备系列，管理灯开关、调光器、占用传感器、HVAC控制等。Home Assistant中的lutron_caseta集成负责与Lutron Caseta Smart Bridge通信，用于Caseta调光器、开关、遮阳和传感器产品系列。它还将与Lutron Radio RA2 Main Repeater通信，用于RA2 Select调光器、开关、遮阳和传感器产品系列。

此集成支持Caséta、RA2 Select、RadioRA 3 和 Homeworks QSX **(不包括QS)**产品系列。

支持的桥接器：

  • Lutron Caséta智能中心（L-BDG2-WH）
  • Lutron Caséta智能桥接器PRO（L-BDGPRO2-WH）
  • RA2 Select主中继器（RR-SEL-REP2-BL）
  • QSX处理器（HQP7）
  • RadioRA 3一体化处理器（RR-PROC3）

有关RadioRA 2和HomeWorks QS产品系列的信息，请参见Lutron集成。

当前支持的设备包括：

配置后，Lutron Caséta集成将自动发现在Lutron Smart Bridge中设置的当前支持的设备。在Lutron移动应用中分配的名称将用于形成在Home Assistant中使用的entity_id。例如，在“卧室”房间中称为“Lamp”的调光器在Home Assistant中变为light.bedroom_lamp。

配置

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

Lutron Caséta 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。

手动配置步骤

如果没有自动发现，请不要担心！您可以设置一个 手动集成条目：

手动中心配置

要在您的安装中使用Lutron Caseta设备，您必须首先登录到您的Lutron账户，并生成一个证书，以使Home Assistant能够连接到您的桥接器。可以按照这里的步骤完成此操作，当您运行时，它将生成三个文件：caseta.key，caseta.crt，caseta-bridge.crt。

如果您已经有caseta.key，caseta.crt，caseta-bridge.crt，并且无法物理访问桥接器以按下按钮，则可以利用这些现有文件进行配对。

一旦您有了这三个必要的文件，请将它们放在您的配置目录中，并将以下内容添加到您的configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more]中：

# 示例configuration.yaml条目
lutron_caseta:
  - host: IP_ADDRESS
    keyfile: caseta.key
    certfile: caseta.crt
    ca_certs: caseta-bridge.crt

Note

请注意，可以通过使用多个配置块来指定多个中心，但每个中心都需要生成并指定自己的keyfile，certfile和ca_certs。

Configuration Variables

Looking for your configuration file?
host string Required

Lutron智能桥接器的IP地址。

keyfile string Required

Home Assistant将用于认证到桥接器的私钥。

certfile string Required

Home Assistant将用于认证到桥接器的证书链。

ca_certs string Required

Home Assistant在连接到桥接器时所期待的证书颁发机构列表（通常只有一个）。

Tip

建议为Lutron智能桥接器分配一个静态IP地址。这确保它不会更改IP地址，因此在重新启动并获得不同IP地址时，您无需更改host。
在您的路由器上使用DHCP保留以保留地址，或在智能桥接器的PRO模型中，在移动应用的网络设置中的高级/集成菜单下设置IP地址。

要让Lutron Caseta卷帘、蜂窝窗帘、木百叶窗、灯光、场景和开关与Home Assistant一起工作，请首先按照上述Lutron Caseta集成的一般说明操作。

遮阳

设置完成后，遮阳将在Home Assistant中使用基于Lutron移动应用中使用名称的entity_id出现。例如，称为“客厅窗户”的遮阳将作为cover.living_room_window在Home Assistant中出现。

有关在Home Assistant中处理遮阳的更多信息，请参阅遮阳集成。

可用的操作：cover.open_cover，cover.close_cover，cover.stop_cover和cover.set_cover_position。遮阳position范围从0（完全关闭）到100（完全打开）。

仅针对倾斜木百叶窗的可用操作：cover.open_cover_tilt，cover.close_cover_tilt，cover.stop_cover_tilt，cover.toggle_tilt。遮阳position为0或100（完全关闭），50（完全打开）。

灯光

设置完成后，包括墙壁和插入式调光器在内的可调光灯将在Home Assistant中使用基于Lutron移动应用中使用名称的entity_id出现。例如，称为“卧室灯”的灯光将作为light.bedroom_lamp在Home Assistant中出现。

对于非调光灯或开关负载，请参见本页面的开关部分。

有关在Home Assistant中处理灯光的更多信息，请参阅灯光集成。

场景

Lutron Caseta场景平台允许您控制在Lutron移动应用中创建的智能桥接器场景。

设置完成后，场景将在Home Assistant中使用基于Lutron移动应用中使用名称的entity_id出现。例如，称为“娱乐”的场景将在Home Assistant中作为scene.entertain出现。

有关在Home Assistant中处理场景的更多信息，请参阅场景集成。

RA3和QSX模型不直接支持场景，然而可以使用按钮平台（见下文）来激活这些系统的场景。

开关

设置完成后，开关将在Home Assistant中使用基于Lutron移动应用中使用名称的entity_id出现。例如，称为“主浴室梳妆台”的灯光开关将在Home Assistant中作为switch.master_bathroom_vanity出现。

对于包括墙壁和插入式调光器的可调光灯，请参见本页面的灯光部分。

有关在Home Assistant中处理开关的更多信息，请参阅开关集成。

风扇

设置完成后，风扇将在Home Assistant中使用基于Lutron移动应用中使用名称的entity_id出现。例如，称为“主卧室天花板风扇”的灯光开关将在Home Assistant中作为fan.master_bedroom_ceiling_fan出现。

有关在Home Assistant中处理风扇的更多信息，请参阅风扇集成。

传感器

可以将占用传感器添加到Lutron Caseta系统中，以在区域变为空闲时触发事件，并可选择在占用时触发。然而，Lutron系统只在占用组中报告占用和空缺状态——即一个或多个传感器的组。

占用组将在Home Assistant中使用基于组内第一个传感器所在区域名称的entity_id出现。例如，“主浴室”中的一个或多个传感器将在Home Assistant中作为binary_sensor.master_bathroom_occupancy出现。

如果组内的任何传感器当前处于“占用”状态，则占用组被视为占用。具体来说，这意味着在该传感器特定超时设置时间内检测到了运动。只有当占用组内的所有传感器报告为空闲时，占用组本身才会报告为空闲。

Lutron Caseta占用传感器支持4种不同的超时和3种不同的灵敏度级别，但这些只能从设备本身控制，不能通过Home Assistant甚至Caseta移动应用设置。

由于Lutron Caseta设备会自动将状态报告给Home Assistant（而不是依赖轮询），占用状态更新几乎是瞬时发生的。

有关在Home Assistant中处理二进制传感器的更多信息，请参阅二进制传感器集成

按钮

按钮实体是为系统中每个键盘按钮和Pico遥控器按钮创建的。 Radio RA3和HomeWorks QSX系统可以使用这些按钮实体来激活在Lutron系统中定义的场景。

有关在Home Assistant中处理按钮的更多信息，请参阅按钮集成。

Pico和遮阳遥控器

Pico和遮阳遥控器在智能桥接器（L-BDG2-WH），智能桥接器PRO（L-BDGPRO2-WH）和RA2 Select（RR-SEL-REP2-BL）模型上受支持。

设备触发器通过监视每个遥控器上按钮的press和release实现，使用lutron_caseta_button_event事件，格式如下：

{
    "serial": 28786608,
    "type": "FourGroupRemote",
    "button_number": 4,
    "device_name": "Shade Remote",
    "area_name": "Upstairs Hall",
    "action": "press"
}