home-assistant.io/source/_integrations/serial_pm.markdown

title	description	ha_category	ha_release	ha_iot_class	ha_domain	ha_platforms	ha_integration_type	ha_quality_scale
Serial Particulate Matter	Instructions on how to integrate particulate matter (dust) sensors with Home Assistant.	DIY	0.26	Local Polling	serial_pm	sensor	integration	legacy

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 {% term "configuration.yaml" %} file:

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

{% configuration %} serial_device: description: The serial port to use. On *nix systems, it can often be identified by $ ls /dev/tty* required: true type: string name: description: The name displayed in the frontend. required: false type: string brand: description: Manufacturer and type of the sensor. (Use a value from the supported sensors list.). required: true type: string {% endconfiguration %}

Named Sensor Configuration Example

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