Added coumentation for MH-Z19 CO2 sensor and Bluetooth LE tracker (#827)

* Added MH-Z19 CO2 sensor documentation

* Minor fixes in MH-Z19 documentation
Added Bluetooth Low-energy tracker documentation
This commit is contained in:
Open Home Automation 2016-08-24 21:07:02 +02:00 committed by Fabian Affolter
parent ded32b4cba
commit 0cddbc39f5
2 changed files with 64 additions and 0 deletions

View File

@ -0,0 +1,35 @@
---
layout: page
title: "Bluetooth Tracker"
description: "Instructions for integrating bluetooth low-energy tracking within Home Assistant."
date: 2016-08-24 00:00
sidebar: true
comments: false
sharing: true
footer: true
logo: bluetooth.png
ha_category: Presence Detection
ha_iot_class: "Local Poll"
ha_release: 0.27
---
This tracker discovers new devices on boot and in regular intervals and tracks bluetooth low-energy devices periodically based on interval_seconds value. It is not required to pair the devices with each other!
Devices discovered are stored with 'BLE_' as the prefix for device mac addresses in `known_devices.yaml`.
<p class='note'>
Requires PyBluez. If you are on Raspbian, make sure you first install `bluetooth` and `libbluetooth-dev` by running `sudo apt install bluetooth libbluetooth-dev`
</p>
To use the Bluetooth tracker in your installation, add the following to your `configuration.yaml` file:
```yaml
device_tracker:
platform: bluetooth_le_tracker
```
As some BT LE devices change their MAC address regularly, a new device is only discovered when it has been seen 5 times.
Some BTLE devices (e.g. fitness trackers) are only visible to the devices that they are paired with. In this case, the BTLE tracker won't see this device.
BTLE tracking requires root privileges.
For additional configuration variables check the [Device tracker page](/components/device_tracker/).

View File

@ -0,0 +1,29 @@
---
layout: page
title: "MH-Z19 CO2 Sensor"
description: "Instructions on how to integrate the MH-Z19 CO2 sensor with Home Assistant."
date: 2016-08-24 00:00
sidebar: true
comments: false
sharing: true
footer: true
ha_category: sensor
ha_release: 0.27
---
The MH-Z19 is a small nondispersive infrared sensor that can measure CO2 sensors. High CO2 levels can lead to drowsiness, poor concentration, loss of attention or increased heart rate. Outside CO2 levels are usually between 250 and 350ppm, but inside levels can reach between 1000 and 5000 ppm. High CO2 levels indicate that you should increase ventilation.
Check out the [Open Home Automation web site](https://www.open-homeautomation.com/2016/08/24/monitor-co2-levels-in-your-house/) for a quick guide how to connect the sensor to your PC or Raspberry Pi.
To use this sensor in your installation, add the following to your `configuration.yaml` file:
```yaml
sensor:
- platform: mhz19
serial_device: /dev/tty.SLAB_USBtoUART
name: CO2
```
- **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.