SGP40 挥发性有机化合物传感器和 SGP41 VOC 与 NOx 传感器

sgp4x 传感器平台允许您使用 Sensirion SGP40 (数据手册) 或 SGP41 (数据手册) 与 ESPHome 配合使用。使用的传感器类型会被自动检测。需要在配置中设置 I²C 总线才能使此传感器工作。

NOTE

此传感器需要以 1Hz 的频率驱动。因此，传感器将每秒在设备上单独读取一次，与 update_interval 分开。状态将按 update_interval 报告给其他组件或前端，以节省 WiFi 功耗和网络通信。

# 示例配置条目
sensor:
  - platform: sgp4x
    voc:
      name: "VOC Index"
    nox:
      name: "NOx Index"

配置变量

voc (可选): VOC 指数
- algorithm_tuning (可选): VOC 算法可以通过调整 6 个不同的参数进行自定义。有关更多详细信息，请参阅 SEN5x 工程指南
  - index_offset (可选): 代表典型（平均）条件的 VOC 指数。允许值范围为 1..250。默认值为 100。
  - learning_time_offset_hours (可选): 从历史数据估计 VOC 算法偏移的时间常数（小时）。过去的事件将在大约两倍学习时间后被遗忘。允许值范围为 1..1000。默认值为 12 小时
  - learning_time_gain_hours (可选): 从历史数据估计 VOC 算法增益的时间常数（小时）。过去的事件将在大约两倍学习时间后被遗忘。允许值范围为 1..1000。默认值为 12 小时。
  - gating_max_duration_minutes (可选): 门控的最大持续时间（分钟）（在高 VOC 指数信号期间冻结估计器）。零表示禁用门控。允许值范围为 0..3000。默认值为 180 分钟
  - std_initial (可选): 标准差的初始估计值。较低的值会在初始学习期间增强事件，但可能导致设备间的差异较大。允许值范围为 10..5000。默认值为 50。
  - gain_factor (可选): 用于放大或衰减 VOC 指数输出的增益因子。允许值范围为 1..1000。默认值为 230。
- 来自 Sensor 的所有其他选项。
nox (可选): NOx 指数。仅适用于 SGP41。如果检测到 SGP40 传感器，此传感器将被忽略
- algorithm_tuning (可选): NOx 算法可以通过调整 5 个不同的参数进行自定义。有关更多详细信息，请参阅 SEN5x 工程指南
  - index_offset (可选): 代表典型（平均）条件的 NOx 指数。允许值范围为 1..250。默认值为 100。
  - learning_time_offset_hours (可选): 从历史数据估计 NOx 算法偏移的时间常数（小时）。过去的事件将在大约两倍学习时间后被遗忘。允许值范围为 1..1000。默认值为 12 小时
  - learning_time_gain_hours (可选): 从历史数据估计 NOx 算法增益的时间常数（小时）。过去的事件将在大约两倍学习时间后被遗忘。允许值范围为 1..1000。默认值为 12 小时。
  - gating_max_duration_minutes (可选): 门控的最大持续时间（分钟）（在高 NOx 指数信号期间冻结估计器）。零表示禁用门控。允许值范围为 0..3000。默认值为 180 分钟
  - std_initial (可选): 标准差参数的初始估计值对 NOx 没有影响。此参数仍然保留是为了与 VOC 调参参数命令保持一致性。此参数必须始终设置为 50。
  - gain_factor (可选): 用于放大或衰减 VOC 指数输出的增益因子。允许值范围为 1..1000。默认值为 230。
- 来自 Sensor 的所有其他选项。
update_interval (可选, 时间): 检查传感器的时间间隔。默认为 60s
store_baseline (可选, 布尔值): 存储和检索基线信息以加快启动速度。默认为 true
compensation (可选): 包含用于补偿的传感器的块。如果未设置，将使用默认值。
- temperature_source (可选, ID): 在此处提供外部温度传感器 ID。这可以改善传感器的内部计算。默认为 25
- humidity_source (可选, ID): 在此处提供外部湿度传感器 ID。这可以改善传感器的内部计算。默认为 50

带补偿的示例

# 示例配置条目
sensor:
- platform: sgp4x
  voc:
    name: "VOC Index"
  nox:
    name: "NOx Index"
  compensation:
    humidity_source: dht1_hum
    temperature_source: dht1_temp

SGP40 挥发性有机化合物传感器和 SGP41 VOC 与 NOx 传感器

配置变量

带补偿的示例

另见