LTR390 紫外线和环境光传感器

ltr390 传感器平台允许您在 ESPHome 中使用 LTR390 紫外线和环境光传感器（数据手册，Adafruit）。

此传感器需要在您的配置中设置 I²C 总线才能工作。

sensor:
  - platform: ltr390
    uv_index:
      name: "UV Index"
    uv:
      name: "UV Sensor Counts"
    light:
      name: "Light"
    ambient_light:
      name: "Light Sensor Counts"

配置变量

uv_index (可选): UV 指数（UVI）。来自 Sensor 的所有选项。
uv (可选): UV 传感器的传感器计数（#）。来自 Sensor 的所有选项。
light (可选): 环境光的勒克斯值（lx）。来自 Sensor 的所有选项。
ambient_light (可选): 环境光传感器的传感器计数（#）。来自 Sensor 的所有选项。
gain (可选，string): 调整传感器灵敏度。值越大灵敏度越高。默认为 "X18"，参见下表获取可选值。
resolution (可选，int): ADC 分辨率。较高分辨率需要更长的传感器积分时间。默认为 20，参见下表获取可选值。
window_correction_factor (可选，float): 窗口校正因子。在着色玻璃窗下使用时请使用较大值。默认为 1.0，必须 >= 1.0。
address (可选，int): 手动指定传感器的 I²C 地址。默认为 0x53。
update_interval (可选，Time): 检查传感器的间隔。默认为 60s。建议更新间隔至少为 1 秒，因为使用高分辨率值时更新可能耗时长达 800ms。

增益和分辨率的精细控制

默认情况下，gain 和 resolution 参数为 ALS 和 UV 测量设置相同的值。在实际场景中，光强度和 UV 指数可能存在显著差异，因此建议对 ALS 和 UV 传感器使用不同的增益和分辨率值以避免饱和。参见以下示例，其中为 ALS 和 UV 传感器设置了不同的增益和分辨率值：

sensor:
  - platform: ltr390
    uv:
      name: "UV Sensor Counts"
    ambient_light:
      name: "Light Sensor Counts"
    gain:
      ambient_light: X9
      uv: X3
    resolution:
      ambient_light: 18
      uv: 13

勒克斯和 UVI 公式

\text{lux} = \frac{0.6 \times \text{als}}{\text{gain} \times \text{int}/100} \times \text{wfac}

\text{UVI} = \frac{\text{uv}}{\text{sensitivity}} \times \text{wfac}

其中：

als 和 uv 是传感器值。
gain 是传感器增益，详情参见下表。
int 是积分时间（ms），与分辨率关联，详情参见下表。
sensitivity 是传感器每 UVI 的计数值。详情参见下方说明。
wfac 是窗口校正因子。

当需要 UV 指数测量时，建议使用 X18 增益和 20 位分辨率的默认值，因为数据手册仅提供该组合的精确转换公式。使用其他增益和分辨率组合时，UVI 值从此参考点线性缩放，可能略有不准。缩放公式为：

\text{sensitivity} = 2300 \times \frac{\text{gain}}{18} \times \frac{\text{int}}{400}

其中 2300 是默认配置下传感器每 UVI 的计数值。

增益

配置值	gain
X1	1
X3	3
X6	6
X9	9
X18	18

分辨率

配置值	分辨率（位）	积分时间（ms）
16	16	25
17	17	50
18	18	100
19	19	200
20	20	400