TCS34725 RGB 颜色传感器

tcs34725 传感器平台允许您使用 TCS34725 RGB 颜色传感器 (数据手册, Adafruit)，色温和照度传感器与 ESPHome 配合使用。需要在配置中设置 I²C 才能使此传感器工作。

注意：如果 integration_time 设置得过长而不适合当前光照条件，传感器将会过曝。在这种情况下，传感器的清晰通道可能不会显示 100%。当 integration_time 为 614ms 且 gain 为 1x 时，传感器最大值约为 4100 lx。在这种情况下，各个颜色通道将显示 100%，清晰通道显示 25%。照度（lux）显示为 0，色温（开尔文）也将显示 0。

# 示例配置条目
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"
    glass_attenuation_factor: 1.0
    address: 0x29
    update_interval: 60s

配置变量

red_channel (可选): 红色通道相对于清晰通道的值，以百分比表示。来自 Sensor 的所有选项。
green_channel (可选): 绿色通道相对于清晰通道的值，以百分比表示。来自 Sensor 的所有选项。
blue_channel (可选): 蓝色通道相对于清晰通道的值，以百分比表示。来自 Sensor 的所有选项。
clear_channel (可选): 清晰（无颜色滤镜）通道相对于所选积分时间最大值的值。来自 Sensor 的所有选项。
illuminance (可选): 获取传感器的总照度，单位为 lx。
color_temperature (可选): 获取计算出的光线色温，单位为开尔文。
gain (可选): 设置内部 ADC 的增益，以便在某些低光条件下更好地工作。有效值为 1x（默认）、4x、16x、60x（最高增益）。如果使用自动积分时间，将被覆盖。
integration_time (可选): 光线传感器曝光的时间量。有效值为 auto（默认）、2.4ms、24ms、50ms、101ms、120ms、154ms、180ms、199ms、 240ms、300ms、360ms、401ms、420ms、480ms、499ms、540ms、600ms、614ms。
glass_attenuation_factor (可选): 如果传感器位于玻璃面板后面，玻璃的衰减因子。默认为 1.0，表示 100% 透射率。2 表示 50% 透射率等。
address (可选, 整数): 手动指定传感器的 I²C 地址。默认为 0x29。
update_interval (可选, 时间): 检查传感器的时间间隔。默认为 60s。

对于许多应用，您可以使用 AUTO 时序或将积分时间留空，让 ESP 根据之前的测量选择合适的增益设置。如果光照水平剧烈变化，可能会导致下一次读数饱和，之后增益会向下调整，后续读数将在范围内。如果在动态环境中使用自动模式，最好使用 1 秒的更新速率。可以使用过滤器来限制输出并防止边际变化的更新，例如：

illuminance:
name: "TCS34725 Illuminance"
filters:
  - or:
      - delta: 50
      - throttle: 60sec

当使用低于 154ms 的积分时间时，传感器的精度会下降，且不会再增加光线累积的增益。只有在需要快速读数且建议在稳定光照条件下时，才使用更快的时序。

TCS34725 RGB 颜色传感器

配置变量

另见