From 577e110bc65042a56df9b724e082bd9f93df9067 Mon Sep 17 00:00:00 2001 From: Daniel Matuschek Date: Thu, 11 Aug 2016 09:46:36 +0200 Subject: [PATCH] Documentation for serial particulate matter sensors --- source/_components/sensor.serial_pm.markdown | 43 ++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 source/_components/sensor.serial_pm.markdown diff --git a/source/_components/sensor.serial_pm.markdown b/source/_components/sensor.serial_pm.markdown new file mode 100644 index 000000000000..5fa8b5465a41 --- /dev/null +++ b/source/_components/sensor.serial_pm.markdown @@ -0,0 +1,43 @@ +--- +layout: page +title: "Particulate matter sensors" +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 + +At this time, the following sensors are supported: + +* oneair,s3 +* novafitness,sds021 +* novafitness,sds011 +* plantower,pms1003 +* plantower,pms5003 +* plantower,pms7003 +* plantower,pms2003 +* plantower,pms3003