home-assistant.io/source/_components/serial_pm.markdown
Franck Nijhof 1833c32a2c Cleans up front matter (#9835)
* Sets front matter defaults

* Removes default front matter from section templates/pages

* Removes default front matter from addon pages

* Removes default front matter from integration pages

* Removes default front matter from posts

* Removes default front matter from docs pages

* Removes default front matter from other pages

* Fixes blog category pages
2019-07-11 14:35:08 -07:00

1.9 KiB

title, description, logo, ha_category, ha_release, ha_iot_class, redirect_from
title description logo ha_category ha_release ha_iot_class redirect_from
Particulate matter Sensor Instructions on how to integrate particulate matter (dust) sensors with Home Assistant. 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.

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.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