jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions

Update 'ha_release' and formatting updates

Browse source
This commit is contained in:
Fabian Affolter 2017-06-22 09:20:04 +02:00
parent 2094220a42
commit ad242d6b3c
No known key found for this signature in database
GPG key ID: DDF3D6F44AAB1336
3 changed files with 89 additions and 73 deletions
Download patch file Download diff file Expand all files Collapse all files

39
source/_components/sensor.htu21d.markdown
View file

@ -1,7 +1,7 @@
---
layout: page
title: "HTU21D Temperature and humidity sensor"
description: "Instructions how to integrate a HTU21D Temperature and humidity sensor in a Raspberry PI into Home Assistant."
description: "Instructions how to integrate a HTU21D Temperature and humidity sensor into Home Assistant."
date: 2017-06-10 00:00
sidebar: true
comments: false
@ -9,12 +9,16 @@ sharing: true
footer: true
logo: raspberry-pi.png
ha_category: Sensor
ha_release: 0.47
ha_release: 0.48
ha_iot_class: "Local Push"
---
The `htu21d` sensor platform allows you to read the temperature and humidity from a [HTU21D sensor](http://www.datasheetspdf.com/PDF/HTU21D/779951/1) connected via [I2c](https://en.wikipedia.org/wiki/I²C) bus (SDA, SCL pins) to your [Raspberry Pi](https://www.raspberrypi.org/).
The `htu21d` sensor platform allows you to read the temperature and humidity from a [HTU21D sensor](http://www.datasheetspdf.com/PDF/HTU21D/779951/1) connected via [I2c](https://en.wikipedia.org/wiki/I²C) bus (SDA, SCL pins).
Tested devices:
- [Raspberry Pi](https://www.raspberrypi.org/)
To use your HTU21D sensor in your installation, add the following to your `configuration.yaml` file:
@ -29,11 +33,10 @@ Configuration variables:
- **name** (*Optional*): The name of the sensor
- **i2c_bus** (*Optional*): I2c bus where the sensor is. Defaults to 1, for Raspberry Pi 2 and 3.
#### Customizing the sensor data
**Give the values friendly names & icons**
## {% Customizing the sensor data %}
Add the following to your `customize`
Give the values friendly names and icons, add the following to your `customize:` section.
```yaml
# Example configuration.yaml entry
@ -46,9 +49,7 @@ customize:
friendly_name: "Humidity"
```
**Create a group**
Add the following to your `groups`
To create a group, add the following to your `groups` section.
```yaml
# Example configuration.yaml entry
@ -60,37 +61,39 @@ group:
- sensor.htu21d_sensor_humidity
```
### Directions for installing smbus support on Raspberry Pi:
## {% linkable_title Directions for installing smbus support on Raspberry Pi %}
Enable I2c interface with the Raspberry Pi configuration utility:
Enable I2c interface with the Raspberry Pi config utility:
```bash
# pi user environment: Enable i2c interface
sudo raspi-config
$ sudo raspi-config
```
Select `Interfacing options->I2C` choose `<Yes>` and hit `Enter`, then go to `Finish` and you'll be prompted to reboot.
Install dependencies for use the `smbus-cffi` module and enable your _homeassistant_ user to join the _i2c_ group:
```bash
# pi user environment: Install i2c dependencies and utilities
sudo apt-get install build-essential libi2c-dev i2c-tools python-dev libffi-dev
$ sudo apt-get install build-essential libi2c-dev i2c-tools python-dev libffi-dev
# pi user environment: Add homeassistant user to the i2c group
sudo addgroup homeassistant i2c
$ sudo addgroup homeassistant i2c
# pi user environment: Reboot Raspberry Pi to apply changes
sudo reboot
$ sudo reboot
```
###### Check the i2c address of the sensor
### {% linkable_title Check the i2c address of the sensor %}
After installing `i2c-tools`, a new utility is available to scan the addresses of the connected sensors:
```bash
/usr/sbin/i2cdetect -y 1
$ /usr/sbin/i2cdetect -y 1
```
It will output a table like this:
```text
0 1 2 3 4 5 6 7 8 9 a b c d e f
00: -- -- -- -- -- -- -- -- -- -- -- -- --