mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-06 02:58:57 +00:00
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.
69 lines
2.0 KiB
Markdown
69 lines
2.0 KiB
Markdown
---
|
|
layout: page
|
|
title: "Particulate matter Sensor"
|
|
description: "Instructions on how to integrate particulate matter (dust) sensors with Home Assistant."
|
|
date: 2016-08-11 12:00
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: serial_pm.png
|
|
ha_category: DIY
|
|
ha_release: 0.26
|
|
ha_iot_class: "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](https://www.open-homeautomation.com/2016/07/19/measuring-air-quality/).
|
|
|
|
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](https://www.open-homeautomation.com/2016/07/20/connecting-an-particulate-matter-sensor-to-your-pc-or-mac/).
|
|
|
|
## {% 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:
|
|
|
|
```yaml
|
|
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 %}
|
|
|
|
```yaml
|
|
sensor:
|
|
- platform: serial_pm
|
|
serial_device: /dev/tty.SLAB_USBtoUART
|
|
name: Nova
|
|
brand: novafitness,sds011
|
|
```
|
|
|