diff --git a/components/light/rgb.rst b/components/light/rgb.rst index d1d8b9733..692e418fe 100644 --- a/components/light/rgb.rst +++ b/components/light/rgb.rst @@ -35,6 +35,32 @@ The ``rgb`` light platform creates an RGB light from 3 :ref:`float output compon pin: D1 # Repeat for green and blue output +Color Correction +---------------- + +It is often favourable to calibrate/correct the color produced by an LED strip light as the +perceived intensity of different colors will generally vary. This can be done by using +:ref:`max_power ` on individual output channels: + +.. code-block:: yaml + + # Example configuration entry + light: + - platform: rgb + name: "Living Room Lights" + red: output_component1 + green: output_component2 + blue: output_component3 + + # Example output entry + output: + - platform: esp8266_pwm + id: output_component1 + pin: D1 + max_power: 80% + # Repeat for green and blue output + + Configuration variables: ------------------------ diff --git a/components/light/rgbw.rst b/components/light/rgbw.rst index c37a835cd..0af887c24 100644 --- a/components/light/rgbw.rst +++ b/components/light/rgbw.rst @@ -18,6 +18,31 @@ The ``rgbw`` light platform creates an RGBW light from 4 :ref:`float output comp blue: output_component3 white: output_component4 +Color Correction +---------------- + +It is often favourable to calibrate/correct the color produced by an LED strip light as the +perceived intensity of different colors will generally vary. This can be done by using +:ref:`max_power ` on individual output channels: + +.. code-block:: yaml + + # Example configuration entry + light: + - platform: rgbw + name: "Livingroom Lights" + red: output_component1 + green: output_component2 + blue: output_component3 + white: output_component4 + + # Example output entry + output: + - platform: esp8266_pwm + id: output_component1 + pin: D1 + max_power: 80% + Configuration variables: ------------------------ diff --git a/components/light/rgbww.rst b/components/light/rgbww.rst index a58e0eef7..71e8eb03a 100644 --- a/components/light/rgbww.rst +++ b/components/light/rgbww.rst @@ -23,6 +23,33 @@ and warm white channels will be mixed using the color temperature configuration cold_white_color_temperature: 6536 K warm_white_color_temperature: 2000 K +Color Correction +---------------- + +It is often favourable to calibrate/correct the color produced by an LED strip light as the +perceived intensity of different colors will generally vary. This can be done by using +:ref:`max_power ` on individual output channels: + + +.. code-block:: yaml + + # Example configuration entry + light: + - platform: rgbw + name: "Livingroom Lights" + red: output_component1 + green: output_component2 + blue: output_component3 + white: output_component4 + + # Example output entry + output: + - platform: esp8266_pwm + id: output_component1 + pin: D1 + max_power: 80% + + Configuration variables: ------------------------