2024.12.5
Home ▸ 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.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the 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