跳转到内容
ESPHome - 智能家居，简单易用

VEML3235 环境光传感器

veml3235 传感器平台允许您在 ESPHome 中使用 Vishay VEML3235 环境光传感器。 设备通过 I²C 通信，您的配置中必须存在该总线。

VEML3235 环境光传感器

此传感器提供 16 位动态范围的环境光检测，范围从 0 lx 到近 18 klx，分辨率最小为 0.0021 lx/counts。它通过两个可配置的 gain 值和一系列积分时间实现这一范围。对于许多应用，您可以启用自动增益，让 ESPHome 根据上一次测量选择合适的增益设置。如果光照水平剧烈变化，下一次读数可能会饱和，之后增益将被调整以使后续读数回到范围内。通常，在测量较弱光源时使用更高的增益值和/或更长的积分时间。

此维基百科文章有一些照度值的比较表。

报告的值单位为 lux但请理解，任何照度值的测量都需要针对被测光频率进行仔细校准、特定设备的转换系数以及其他因素。简而言之，要真正获得准确的照度测量值，您应该针对您的使用场景进行实验室级校准。如果您是那种可以进行实验室级校准的人，您可能已经知道所有这些了。尽管如此，即使没有校准，您仍然可以获得”大致正确”的值。如果您只想区分”无光”、“有一点光”、“很多光”等，这尤其有用。

# 示例配置条目
sensor:
  - platform: veml3235
    id: veml3235_sensor
    name: VEML3235 光传感器
    auto_gain: true
    auto_gain_threshold_high: 90%
    auto_gain_threshold_low: 20%
    digital_gain: 1X
    gain: 1X
    integration_time: 50ms

配置变量

Section titled “配置变量”

  • gain (可选, string): 设备将使用的增益。在低光条件下，较高的值更好。 您不能指定任意的增益倍数。必须是以下之一：

    • 1x （默认）
    • 2x
    • 4x

  • digital_gain (可选, string): 类似于 gain；提供额外的倍数，进一步增加 范围。您不能指定任意的数字增益倍数。必须是以下之一：

    • 1x （默认）
    • 2x

  • integration_time (可选, 时间): 设备每次测量使用的时间。更长 意味着更准确的值。您不能指定任意的时间量。必须是以下之一：

    • 50ms （默认）
    • 100ms
    • 200ms
    • 400ms
    • 800ms

  • auto_gain (可选, boolean): 当设置为 true（默认值）时，gain、digital_gain 和 integration_time 将自动调整以避免传感器饱和，并允许使用最大可能的分辨率；如果配置中包含这些值，它们将仅用作初始值。

  • auto_gain_threshold_high (可选, percentage): 给定当前增益和积分时间下最大可能照度测量的百分比；当照度测量值上升到此值以上时，gain、digital_gain 和 integration_time 值将被重置并重新计算，以避免饱和并最大化分辨率。 默认值为 90%。

  • auto_gain_threshold_low (可选, percentage): 给定当前增益和积分时间下最大可能照度测量的百分比；当照度测量值下降到此值以下时，gain、digital_gain 和 integration_time 值将被重置并重新计算，以避免饱和并最大化分辨率。 默认值为 20%。

  • 来自 Sensor 的所有其他选项。

另见

Section titled “另见”