跳转到内容

RGBWW 灯光

rgbww 灯光平台根据 5 个 float 输出组件(每个通道一个)创建一个 RGBWW(冷白 + 暖白) 灯光。冷白和暖 白通道可以单独控制或一起控制,更多信息请参见 Mixing。

# 示例配置条目
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

通常最好校准/校正 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%。

对于某些 LED 灯泡,不可能在同时开启白色 LED 的同时开启 RGB LED,或者在希望得到白光时将 RGB 通道设为最大会导致不希望的色相效果。对于这些情况,有一个 配置变量可防止 RGB LED 和白色 LED 同时开启:color_interlock。

将此选项设为 true 将使灯光拥有两种可用的颜色模式,RGB 和 COLD_WARM_WHITE。 当 RGB 颜色模式处于活动时,白色 LED 被关闭,当 COLD_WARM_WHITE 颜色模式处于活动时, RGB LED 被关闭。可以在 Home Assistant 界面中切换这些模式,也可以使用 light control 动作 的 color_mode 选项。

  • red(必选,ID):用于红色通道的 float Output 组件 的 id。

  • green(必选,ID):用于绿色通道的 float Output 组件 的 id。

  • blue(必选,ID):用于蓝色通道的 float Output 组件 的 id。

  • cold_white(必选,ID):用于冷 白色通道的 float Output 组件 的 id。

  • warm_white(必选,ID):用于暖 白色通道的 float Output 组件 的 id。

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

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

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

  • color_interlock(可选,boolean):启用时,这将防止白色 LED 与 RGB LED 同时开启。更多信息参见 颜色互锁。默认为 false。

  • 来自 Light 的所有其他选项。