mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-15 21:36:52 +00:00
6cbcc1acdc
* fixing ha_category components annotation
Signed-off-by: Piotr Żuralski <piotr.zuralski@gmail.com>
* ✏️ Tweak
71 lines
2.1 KiB
Markdown
71 lines
2.1 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
|
|
redirect_from:
|
|
- /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](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
|
|
```
|