跳转到内容
ESPHome - 让智能家居更简单2026.7.0

SGP30 CO₂ 与挥发性有机化合物传感器

sgp30 传感器平台允许您在 ESPHome 中使用 Sensirion SGP30 多像素气体（数据手册）传感器或 SVM30 评估板（产品页）。要在您的配置中使该传感器正常工作，必须先设置好 I²C 总线。

# 示例配置条目
sensor:
  - platform: sgp30
    eco2:
      name: "eCO2"
    tvoc:
      name: "TVOC"

配置变量

Section titled “配置变量”

  • eco2 (可选): CO₂eq. 传感器的信息。

  • tvoc (可选): 总挥发性有机化合物传感器的信息。

  • store_baseline (可选, boolean): 计算或更新基线时持久化存储传感器基线。默认为 true。

  • address (可选, int): 手动指定传感器的 I²C 地址。默认为 0x58。

  • update_interval (可选, Time): 检查传感器的间隔。默认为 60s。

高级：

  • baseline (可选): 用于校准的基线块。更多信息请参见校准基线。

    • eco2_baseline (必选, int): 用于校准的 eCO2 基线。OTA 后，此值将用于校准传感器。

    • tvoc_baseline (必选, int): 用于校准的 TVOC 基线。OTA 后，此值将用于校准传感器。

  • eco2_baseline (可选): CO₂eq. 基线值传感器的信息。基线值以十进制形式发布。

  • tvoc_baseline (可选): TVOC 基线值传感器的信息。基线值以十进制形式发布。

  • compensation (可选): 用于补偿的传感器块。必须同时提供两个值，才能生成需要报告给传感器的绝对湿度。

    • temperature_source (必选, ID): 在这里给出外部温度传感器的 ID。数据必须为摄氏度。这可以改善传感器的内部计算。

    • humidity_source (必选, ID): 在这里给出外部相对湿度传感器的 ID。这可以改善传感器的内部计算。

校准基线

Section titled “校准基线”

SGP30 传感器每次通电时都会重新校准其基线。首次开机时，此过程最多需要 12 小时。建议在校准期间累计至少接触外部空气 10 分钟。

为了获得最佳性能和更快的启动时间，需要在关机前将当前的基线持久化存储在设备上，并在启动时再次设置。这意味着如果传感器在空气质量比平时差的时刻重启，数值将会有一个恒定的偏移，无法与上次启动前的数值进行比较。

使用 store_baseline 选项可在校准后或运行时更新时自动存储基线值。启动时，存储的值将被（重新）应用到传感器中。存储的基线在 OTA 后会被清除。

另一种方法是手动在配置文件中指定基线值。要做到这一点，请让传感器在无基线设置的情况下启动，并让传感器自行校准。大约 12 小时后，您可以查看 ESP 上的远程日志。下次读取传感器时，您会看到一条类似 Current eCO2 baseline: 0x86C5, TVOC baseline: 0x8B38 的日志消息。

另一种获取基线值的方法是配置 eCO2 和 TVOC 基线值传感器。这些值将发布到您的家庭自动化系统中。 使用前请将十进制值转换为十六进制值（例如 37577 —> 0x92C9）。

然后在配置文件中像这样设置 baseline 属性，使用您从日志中获得的值：

# 示例配置条目
sensor:
  - platform: sgp30
    # ...
    baseline:
      eco2_baseline: 0x86C5
      tvoc_baseline: 0x8B38

下次上传代码时，SGP30 将以该基线继续运行，您将得到一致的数值。

请注意，当传感器关闭时，基线值最长仅在七天内有效。

参见

Section titled “参见”