home-assistant.io/source/_components/serial_pm.markdown
Franck Nijhof ebca3218c7
🔥Removes linkable_title everywhere (#9772)
* Automatically create linkable headers

* Visually improve position of linkable header chain icon

* Do not auto link  headers on homepage

* Remove linkable_title everywhere

* 🚑 Re-instante linkable_title plugin as NOOP
2019-07-04 19:08:27 +02:00

2.0 KiB

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.

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