jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-22 16:56:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge with already existing docs

Browse Source
This commit is contained in:
Fabian Affolter 2016-08-11 10:20:55 +02:00
parent 939a614764
commit 5664262b79
No known key found for this signature in database
GPG Key ID: DDF3D6F44AAB1336
1 changed files with 17 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
source/_components/sensor.serial_pm.markdown
View File

@ -1,35 +1,19 @@
---
layout: page
title: "Particulate matter sensors"
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:
ha_category: DIY
ha_release: 0.26
---
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 your with PCs. 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/).
```yaml
sensor:
platform: serial_pm
serial_device: /dev/tty.SLAB_USBtoUART
name: Nova
brand: novafitness,sds011
```
- **platform** (*Required*): serial_pm
- **serial_device** (*Required*): The serial port to use. On *nix systems, it can often be identified by "ls /dev/tty*"
- **name** (*Optional*): The name displayed
- **brand** (*Required*): Manufacturer and type of the sensor.
###Supported sensors
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/).
At this time, the following sensors are supported:
@ -41,3 +25,18 @@ At this time, the following sensors are supported:
* plantower,pms7003
* plantower,pms2003
* plantower,pms3003
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
name: Nova
brand: novafitness,sds011
```
- **serial_device** (*Required*): The serial port to use. On *nix systems, it can often be identified by `$ ls /dev/tty*`
- **name** (*Optional*): The name displayed in the frontend.
- **brand** (*Required*): Manufacturer and type of the sensor.