2025.3.4
首页 ▸ Integrations ▸

Serial Particulate Matter

Particulate matter sensors measure the amount of very small particles in the air.

Cheap LED based sensors usually use a GPIO interface that is hard to attach to computers. However, there are a lot of laser LED based sensors on the market that use a serial interface and can be connected to your Home Assistant system easily with a USB to serial converter.

Supported Sensors

At this time, the following sensors are supported:

  • oneair,s3
  • novafitness,sds021
  • novafitness,sds011
  • plantower,pms1003
  • plantower,pms5003
  • plantower,pms7003
  • plantower,pms2003
  • plantower,pms3003

Configuration

To use your PM sensor in your installation, add the following to your configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file:

sensor:
  - platform: serial_pm
    serial_device: /dev/tty.SLAB_USBtoUART
    brand: oneair,s3

Configuration Variables

Looking for your configuration file?
serial_device string Required

The serial port to use. On *nix systems, it can often be identified by $ ls /dev/tty*

name string (Optional)

The name displayed in the frontend.

brand string Required

Manufacturer and type of the sensor. (Use a value from the supported sensors list.).

Named Sensor Configuration Example 

sensor:
  - platform: serial_pm
    serial_device: /dev/tty.SLAB_USBtoUART
    name: Nova
    brand: novafitness,sds011