TCS34725 RGB Color Sensor

The tcs34725 sensor platform allows you to use your TCS34725 RGB color sensors (datasheet, Adafruit), color temperature and illuminance sensors with ESPHome. The I²C is required to be set up in your configuration for this sensor to work.

../../_images/tcs34725-full.jpg

TCS34725 RGB Color Sensor

../../_images/tcs34725-ui.png
# Example configuration entry
sensor:
  - platform: tcs34725
    red_channel:
      name: "TCS34725 Red Channel"
    green_channel:
      name: "TCS34725 Green Channel"
    blue_channel:
      name: "TCS34725 Blue Channel"
    clear_channel:
      name: "TCS34725 Clear Channel"
    illuminance:
      name: "TCS34725 Illuminance"
    color_temperature:
      name: "TCS34725 Color Temperature"
    gain: 1x
    integration_time: 2.4ms
    glass_attenuation_factor: 1.0
    address: 0x29
    update_interval: 60s

Configuration variables:

  • red_channel (Optional): Get the percentage of how strongly the red color channel is activated. All options from Sensor.

  • green_channel (Optional): Get the percentage of how strongly the green color channel is activated. All options from Sensor.

  • blue_channel (Optional): Get the percentage of how strongly the blue color channel is activated. All options from Sensor.

  • clear_channel (Optional): Get the percentage of how strongly the clear (without a color filter) channel is activated. All options from Sensor.

  • illuminance (Optional): Get the total illuminance of the sensor in lx. All options from Sensor.

  • color_temperature (Optional): Get the calculated color temperature of the light in Kelvin. All options from Sensor.

  • gain (Optional): Set the gain for the internal ADCs to work better in certain low-light conditions. Valid values are 1x (default), 4x, 16x, 60x (highest gain).

  • integration_time (Optional): The amount of time the light sensor is exposed. Valid values are 2.4ms (default), 24ms, 50ms, 101ms, 120ms, 154ms, 180ms, 199ms, 240ms, 300ms, 360ms, 401ms, 420ms, 480ms, 499ms, 540ms, 600ms, 614ms.

  • glass_attenuation_factor (Optional): The attenuation factor of glass if it’s behind some glass facia. Default is 1.0 means 100% transmissivity. 2 means 50% transmissivity etc.

  • address (Optional, int): Manually specify the I²C address of the sensor. Defaults to 0x29.

  • update_interval (Optional, Time): The interval to check the sensor. Defaults to 60s.

See Also