b5cff3d63e
Update configuration variable section and move "complete" configuration example (including the optional value) as a second example. Have the main configuration example only include required variables. Bring more attention to the list of supported sensors. (List of supported sensors is still current with the pmsensor library used by this component.) Related to #6385.
2.0 KiB
| layout | title | description | date | sidebar | comments | sharing | footer | logo | ha_category | ha_release | ha_iot_class |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 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 |
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