Update to components/sensor.sensehat (#2009)

* Update to components/sensor.sensehat

• Have provided more information on how to install the SenseHAT for Virtual Environment installs
• Have included directions on making the SenseHAT prettier

* Amends to comform with PR
This commit is contained in:
George.M 2017-02-14 10:15:37 +00:00 committed by Fabian Affolter
parent 5dcb6fbd2a
commit 779fdeae32

View File

@ -36,3 +36,116 @@ Configuration variables:
- 'pressure'
#### Customizing the Sense HAT data
**Format the sensor values**
Add the following to your `sensor`
```yaml
# Example configuration.yaml entry
sensor:
- platform: sensehat
display_options:
- temperature
- humidity
- pressure
- platform: template
sensors:
sensehat_temperature:
value_template: '{% raw %}{{ states.sensor.temperature.state | round(1) }}{% endraw %}'
unit_of_measurement: '°C'
sensehat_pressure:
value_template: '{% raw %}{{ states.sensor.pressure.state | round(1) }}{% endraw %}'
unit_of_measurement: 'mb'
sensehat_humidity:
value_template: '{% raw %}{{ states.sensor.humidity.state | round(1) }}{% endraw %}'
unit_of_measurement: '%'
```
**Give the values friendly names & icons**
Add the following to your `customize`
```yaml
# Example configuration.yaml entry
customize:
sensor.sensehat_temperature:
icon: mdi:thermometer
friendly_name: "Temperature"
sensor.sensehat_humidity:
icon: mdi:weather-rainy
friendly_name: "Humidity"
sensor.sensehat_pressure:
icon: mdi:gauge
friendly_name: "Pressure"
```
**Create a group**
Add the following to your `groups`
```yaml
# Example configuration.yaml entry
group:
sense_hat:
name: Sense HAT
entities:
- sensor.sensehat_temperature
- sensor.sensehat_humidity
- sensor.sensehat_pressure
```
Add the _sense_hat group_ a group (_Kitchen for example_)
```yaml
# Example configuration.yaml entry
group:
kitchen:
- group.sense_hat
```
### Directions for installing on Raspberry Pi All-In-One installer and HASSbian:
Here are the steps to make the _SenseHAT_ sensor work _successfully_ with the virtual enviroment versions.
#### Install SenseHAT package to _homeassistant_venv_
```bash
# switch to the homeassistant_venv environment
sudo su -s /bin/bash homeassistant
source /srv/homeassistant/homeassistant_venv/bin/activate
# install the sense-hat lib
pip3 install sense-hat
# be patient, this will take a long while
```
#### Return to `pi`
Type `exit` to quit out of the _homeassistant_venv_ back to your `pi` environment.
As all of the following steps should be under the `pi` user environment.
###### Install _RTIMU_
```bash
# Install RTIMU to pi user environment
pip3 install rtimulib
# Add symlink to RTIMU in _homeassistant_venv_
# Create a symlink using the following command:
ln -s /usr/lib/python3/dist-packages/RTIMU.cpython-34m-arm-linux-gnueabihf.so /srv/homeassistant/homeassistant_venv/lib/python3.4/
# Add _homeassistant_ user to the _input_ and the _i2c_ groups
sudo addgroup homeassistant input
sudo addgroup homeassistant i2c
# Reboot Raspberry Pi to apply changes
sudo reboot
```
Unfortunately enabling the SenseHAT Sensor component for a Virtual Environment install of Home-Assistant fails with errors.
_(The Raspberry Pi All-In-One installer and HASSbian both run Home-Assistant in an virtual environment)._
These issues have been discussed in the repository issue (#5093)[https://github.com/home-assistant/home-assistant/issues/5093)
This fix has been tested with a clean install of:
* [Raspbian Jessie - version January 2017](https://downloads.raspberrypi.org/raspbian/images/raspbian-2017-01-10/)
and
* [Home-Assistant 0.37.1](https://home-assistant.io/getting-started/installation-raspberry-pi-all-in-one/)