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

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release, ha_iot_class, redirect_from

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release	ha_iot_class	redirect_from
page	Particulate matter Sensor	Instructions on how to integrate particulate matter (dust) sensors with Home Assistant.	2016-08-11 12:00	true	false	true	true	serial_pm.png	DIY	0.26	Local Polling	/components/sensor.serial_pm/

Particulate matter sensors measure the amount of very small particles in the air. A short introduction how these sensors work can be found on Open Home Automation.

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 an USB to serial converter.

{% linkable_title 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

{% linkable_title Configuration %}

To use your PM sensor in your installation, add the following to your 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 %}

{% linkable_title Named Sensor Configuration Example %}

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