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 (可选): 紫外线指数 (UVI)。所有选项来自传感器。
uv (可选): 紫外线传感器的传感器计数值 (#)。所有选项来自传感器。
light (可选): 环境光照度 (lx)。所有选项来自传感器。
ambient_light (可选): 环境光传感器的传感器计数值 (#)。所有选项来自传感器。
gain (可选, 字符串): 调整传感器的灵敏度。较大的值表示较高的灵敏度。默认值为 "X18"，请参阅下表了解可用选项。
resolution (可选, 整数): ADC 分辨率。较高的分辨率需要较长的传感器积分时间。默认值为 20，请参阅下表了解可用选项。
window_correction_factor (可选, 浮点数): 窗口校正因子。在有色窗户下使用时使用较大的值。默认值为 1.0，必须 >= 1.0。
address (可选, 整数): 手动指定传感器的 I²C 地址。默认值为 0x53。
update_interval (可选, 时间): 检查传感器的时间间隔。默认值为 60s。建议更新间隔至少为 1 秒，因为在使用高分辨率值时，更新可能需要长达 800ms。

增益和分辨率的精细控制

默认情况下，gain 和 resolution 参数为 ALS 和 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 是积分时间（毫秒），与分辨率相关，详情请参阅下表。
sensitivity 是传感器的每 UVI 计数值。详情请参阅下面的说明。
wfac 是窗口校正因子。

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

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

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

增益

配置值	增益
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

LTR390 紫外线与环境光传感器

配置变量

增益和分辨率的精细控制

照度和 UVI 公式

增益

分辨率

另见