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


To use your PM sensor in your installation, add the following to your configuration.yaml file:

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

Configuration Variables

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

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