From 3fb810b46ecd671a313932a8a04cbfd9e77dcd4a Mon Sep 17 00:00:00 2001 From: "@RubenKelevra" Date: Tue, 16 Aug 2022 06:08:16 +0200 Subject: [PATCH] tcs34725: Add overexposure quirk note (#2127) Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> --- components/sensor/tcs34725.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/components/sensor/tcs34725.rst b/components/sensor/tcs34725.rst index 42dfa4af1..4def11916 100644 --- a/components/sensor/tcs34725.rst +++ b/components/sensor/tcs34725.rst @@ -11,6 +11,12 @@ The ``tcs34725`` sensor platform allows you to use your TCS34725 RGB color senso `Adafruit`_), color temperature and illuminance sensors with ESPHome. The :ref:`I²C ` is required to be set up in your configuration for this sensor to work. +Note: If the `integration_time` is set too long for the light conditions, the sensor will overexpose. +In this case the sensor may not show 100% on its clear channel. With an `integration_time` of `614ms` +and a `gain` of `1x` the sensor will max out at around 4100 lx. In this case the individual color +channels will show `100%`, the clear channel `25%`. The illumination in lux is shown as `0` as well +as the color temperature in kelvin will show `0`. + .. figure:: images/tcs34725-full.jpg :align: center :width: 50.0%