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

sgp4x 传感器平台允许您在 ESPHome 中使用 Sensirion SGP40（数据手册）或 SGP41（数据手册）。使用的传感器类型会自动检测。要在您的配置中使该传感器正常工作，必须先设置好 I²C 总线。

NOTE

该传感器需要以 1Hz 的速率驱动。因此，传感器将以 1 秒一次的间隔在设备上读取，独立于 update_interval。传感器状态会在 update_interval 时报告给其他组件或前端，从而节省 Wi-Fi 功耗和网络通信。

# 示例配置条目
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 表示禁用门控。允许值为 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 表示禁用门控。允许值为 0..3000。默认值为 180 分钟
  - std_initial (可选): 标准差参数的初始估计值对 NOx 没有影响。该参数仍然保留以保持与 VOC 调优参数命令的一致性。此参数必须始终设置为 50。
  - gain_factor (可选): 用于放大或衰减 VOC 指数输出的增益因子。允许值为 1..1000。默认值为 230。
- Sensor 的所有其他选项。
update_interval (可选, Time): 检查传感器的间隔。默认为 60s
store_baseline (可选, boolean): 存储和检索基线信息，以加快启动速度。默认为 true
compensation (可选): 用于补偿的传感器块。如果未设置，将使用默认值。
- temperature_source (必选, ID): 在这里给出外部温度传感器的 ID。这可以改善传感器的内部计算。
- humidity_source (必选, ID): 在这里给出外部湿度传感器的 ID。这可以改善传感器的内部计算。

带补偿的示例

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

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

配置变量

带补偿的示例

参见