TCS34725 RGB 颜色传感器

tcs34725 传感器平台允许您在 ESPHome 中使用 TCS34725 RGB 颜色传感器（数据手册，Adafruit）、色温和照度传感器。要在您的配置中使该传感器正常工作，必须先设置好 I²C。

注意：如果 integration_time 相对于当前光线条件设置得过长，传感器会过曝。在这种情况下，传感器的 Clear（清透）通道可能不会显示 100%。当 integration_time 为 614ms、gain 为 1x 时，传感器在约 4100 lx 时会达到饱和。此时各颜色通道显示为 100%，Clear 通道显示为 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 (可选): 红色通道相对于 Clear 通道的值，以百分比表示。 Sensor 的所有选项。
green_channel (可选): 绿色通道相对于 Clear 通道的值，以百分比表示。 Sensor 的所有选项。
blue_channel (可选): 蓝色通道相对于 Clear 通道的值，以百分比表示。 Sensor 的所有选项。
clear_channel (可选): 无颜色滤镜的 Clear 通道的值，相对于所选积分时间的最大值。 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 (可选, int): 手动指定传感器的 I²C 地址。默认为 0x29。
update_interval (可选, Time): 检查传感器的间隔。默认为 60s。

对于许多应用，您可以使用 AUTO 定时模式，或留空积分时间，让 ESP 根据上一次测量值选择合适的前置增益设置。如果光线水平变化剧烈，这可能会导致下一次读数饱和，随后增益将下调，后续读数则会回到量程内。在动态环境中使用自动模式时，1 秒的更新速率效果最佳。可以使用过滤器来限制输出，防止微小变化触发更新，例如：

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

当使用低于 154ms 的积分时间时，传感器的精度会下降，且不会带来额外的光累积增益。仅在需要快速读取且光线条件稳定的情况下使用较快的定时。

TCS34725 RGB 颜色传感器

配置变量

参见