跳转到内容
ESPHome - 智能家居，简单易用

RGBWW 灯

rgbww 灯光平台从 5 个浮点输出组件创建一个 RGBWW（冷白 + 暖白）灯（每个通道一个）。冷白和暖白通道可以单独控制或一起控制，更多信息请参见混合。

# 配置示例
light:
  - platform: rgbww
    name: "Livingroom Lights"
    red: output_component1
    green: output_component2
    blue: output_component3
    cold_white: output_component4
    warm_white: output_component5
    cold_white_color_temperature: 6536 K
    warm_white_color_temperature: 2000 K

颜色校正

Section titled “颜色校正”

校准/校正 LED 灯带产生的颜色通常是有利的，因为不同颜色的感知强度通常会有所不同。这可以通过在各个输出通道上使用 max_power 来实现：

# 配置示例
light:
  - platform: rgbw
    name: "Livingroom Lights"
    red: output_component1
    green: output_component2
    blue: output_component3
    white: output_component4


# 输出配置示例
output:
  - platform: ...
    id: output_component1
    max_power: 80%

NOTE

请记住，gamma_correct 默认启用（γ=2.8），在校准时可能需要考虑这一点。例如，如果你将灯设置为 50% 亮度并希望这成为新的最大值：max_PWM_power = max_light_power^2.8 = 0.5^2.8 = 0.144，那么你应该将 max_power 设置为 14.4%。

颜色互锁

Section titled “颜色互锁”

对于某些 LED 灯泡，无法同时启用 RGB LED 和白色 LED，或者在希望获得白光时将 RGB 通道设置为最大值会产生不理想的色调效果。针对这些情况，提供了一个配置变量来防止 RGB LED 和白色 LED 同时点亮：color_interlock。

将此选项设置为 true 将使灯光具有两种可用的颜色模式：RGB 和 COLD_WARM_WHITE。当 RGB 颜色模式激活时，白色 LED 关闭；当 COLD_WARM_WHITE 颜色模式激活时，RGB LED 关闭。可以从 Home Assistant 界面切换这些模式，或使用灯光控制动作的 color_mode 选项。

配置变量

Section titled “配置变量”

  • red (必需, ID): 用于红色通道的浮点输出组件的 ID。

  • green (必需, ID): 用于绿色通道的浮点输出组件的 ID。

  • blue (必需, ID): 用于蓝色通道的浮点输出组件的 ID。

  • cold_white (必需, ID): 用于冷白通道的浮点输出组件的 ID。

  • warm_white (必需, ID): 用于暖白通道的浮点输出组件的 ID。

  • cold_white_color_temperature (可选, 浮点数): 冷白通道的色温（以mireds或开尔文为单位）。请注意，当启用颜色互锁时，此选项是从 Home Assistant 控制灯光所必需的。

  • warm_white_color_temperature (可选, 浮点数): 暖白通道的色温（以mireds或开尔文为单位）。请注意，当启用颜色互锁时，此选项是从 Home Assistant 控制灯光所必需的。

  • constant_brightness (可选, 布尔值): 启用后，将通过限制冷白和暖白通道的组合输出为单个通道的 100% 来保持其整体亮度恒定。这会降低可能的整体亮度，但对于某些无法同时以全亮度运行两个通道的电源是必需的。默认为 false。

  • color_interlock (可选, 布尔值): 启用后，将防止白色 LED 与 RGB LED 同时点亮。更多信息请参见颜色互锁。默认为 false。

  • 所有其他选项来自灯光组件。

另见

Section titled “另见”