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

SPS30 颗粒物传感器

sps30 传感器平台允许您在 ESPHome 中使用 Sensirion SPS30 (数据手册) 传感器。 使用此传感器需要在配置中设置 I²C 总线。 该传感器支持 UART 和 I²C 两种通信方式，但目前仅实现了 I²C 通信。

# 示例配置条目
sensor:
  - platform: sps30
    pm_1_0:
      name: "车间 PM <1µm 质量浓度"
      id: "workshop_PM_1_0"
    pm_2_5:
      name: "车间 PM <2.5µm 质量浓度"
      id: "workshop_PM_2_5"
    pm_4_0:
      name: "车间 PM <4µm 质量浓度"
      id: "workshop_PM_4_0"
    pm_10_0:
      name: "车间 PM <10µm 质量浓度"
      id: "workshop_PM_10_0"
    pmc_0_5:
      name: "车间 PM <0.5µm 数量浓度"
      id: "workshop_PMC_0_5"
    pmc_1_0:
      name: "车间 PM <1µm 数量浓度"
      id: "workshop_PMC_1_0"
    pmc_2_5:
      name: "车间 PM <2.5µm 数量浓度"
      id: "workshop_PMC_2_5"
    pmc_4_0:
      name: "车间 PM <4µm 数量浓度"
      id: "workshop_PMC_4_0"
    pmc_10_0:
      name: "车间 PM <10µm 数量浓度"
      id: "workshop_PMC_10_0"
    pm_size:
      name: "典型颗粒粒径"
      id: "pm_size"
    address: 0x69
    update_interval: 10s
    idle_interval: 5min

配置变量

Section titled “配置变量”

  • pm_1_0 (可选): 直径不超过 1μm 的细颗粒物质量浓度传感器信息。读数单位为 µg/m³。

  • pm_2_5 (可选): 直径不超过 2.5μm 的细颗粒物质量浓度传感器信息。读数单位为 µg/m³。

  • pm_4_0 (可选): 直径不超过 4μm 的粗颗粒物质量浓度传感器信息。读数单位为 µg/m³。

  • pm_10_0 (可选): 直径不超过 10μm 的粗颗粒物质量浓度传感器信息。读数单位为 µg/m³。

  • pmc_0_5 (可选): 直径不超过 0.5μm 的超细颗粒物数量浓度传感器信息。读数单位为 个/cm³。

  • pmc_1_0 (可选): 直径不超过 1μm 的细颗粒物数量浓度传感器信息。读数单位为 个/cm³。

  • pmc_2_5 (可选): 直径不超过 2.5μm 的细颗粒物数量浓度传感器信息。读数单位为 个/cm³。

  • pmc_4_0 (可选): 直径不超过 4μm 的粗颗粒物数量浓度传感器信息。读数单位为 个/cm³。

  • pmc_10_0 (可选): 直径不超过 10μm 的粗颗粒物数量浓度传感器信息。读数单位为 个/cm³。

  • pm_size (可选): 典型颗粒粒径，单位为 μm。

  • auto_cleaning_interval (可选): 定期风扇清洁的时间间隔，单位为秒。

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

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

  • idle_interval (可选, 时间): 如果指定，传感器将在读数之间进入空闲模式指定的时间。

接线

Section titled “接线”

该传感器采用 5 针 JST ZHR 型连接器，间距为 1.5mm。（匹配连接器外壳，数据手册） 要强制传感器进入 I²C 模式，应将 SEL 引脚（接口选择，第 4 脚）短接到地（第 5 脚）。

为了提高稳定性，SDA 和 SCL 线需要合适的上拉电阻。Sensirion 手册中显示在 VDD（5V，第 1 脚）与 SDA（第 2 脚）和 SCL（第 3 脚）之间使用 10 kΩ 电阻。

自动清洁

Section titled “自动清洁”

SPS30 传感器具有自动风扇清洁功能，会将内置风扇加速到最大速度运行 10 秒，以吹出风扇内部积聚的灰尘。 默认的自动清洁间隔为 168 小时（1 周）不间断使用。关闭传感器会重置此计时器。 目前不支持禁用自动清洁或设置手动间隔。

sps30.start_fan_autoclean 动作

Section titled “sps30.start_fan_autoclean 动作”

此 动作 手动启动风扇清洁。

on_...:
  then:
    - sps30.start_fan_autoclean: my_sps30

要从 Home Assistant 触发风扇清洁功能，请添加如下所示的按钮，并使用（定期的）自动化来触发它。

button:
  - platform: template
    name: "SPS30 风扇清洁"
    on_press:
      then:
        - sps30.start_fan_autoclean: my_sps30


sensor:
  - platform: sps30
    id: "my_sps30"
    ...

Sensirion 建议每周至少清洁一次。

空闲工作模式

Section titled “空闲工作模式”

SPS30 传感器可以进入空闲工作模式，此时大部分内部电子设备（包括风扇和激光器）都会关闭。这可以大幅降低功耗并延长传感器寿命。

指定 idle_interval 配置参数将自动停止传感器指定的时间，到时间时唤醒，让传感器预热 30 秒，然后进行读数，之后再将其放回空闲状态。

下面的启动和停止动作允许用户手动将传感器切换进出空闲模式。 请注意，传感器启动后，需要 30 秒的预热期才能输出测量值。

更多信息请参阅 低功耗文档。

sps30.start_measurement 动作

Section titled “sps30.start_measurement 动作”

此 动作 手动将传感器切换到测量模式。

on_...:
  then:
    - sps30.start_measurement: my_sps30

sps30.stop_measurement 动作

Section titled “sps30.stop_measurement 动作”

此 动作 手动将传感器切换到空闲模式。

on_...:
  then:
    - sps30.stop_measurement: my_sps30

另见

Section titled “另见”