Skip to content

Fix merge error & added doc for sensehat new flag #2100

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Feb 23, 2017
Merged

Fix merge error & added doc for sensehat new flag #2100

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8867d0f
Fix merge error & added doc for sensehat new flag
nodinosaur Feb 20, 2017
ca28360
Changes as per PR comments
nodinosaur Feb 23, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
111 changes: 58 additions & 53 deletions source/_components/sensor.sensehat.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,56 +34,13 @@ Configuration variables:
- 'temperature'
- 'humidity'
- 'pressure'
is_hat_attached (Optional): True|False boolean; Default value is True declaring that the SenseHAT _is_ physically on the Raspberry Pi


### {% linkable_title Installation instruction for the All-In-One installer and HASSbian %}
#### Customizing the Sense HAT data

Here are the steps to make the Sense HAT sensor work with a virtual environment.

Install SenseHAT package. Switch to the `homeassistant_venv` directory and activate the virtual environment.

```bash
$ sudo su -s /bin/bash homeassistant
$ source /srv/homeassistant/homeassistant_venv/bin/activate
```

Install the `sense-hat` module.

```bash
$ pip3 install sense-hat
```

Please be patient, this will take a long while...

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 the [RTIMU](https://github.com/RPi-Distro/RTIMULib) Python module:

```bash
$ pip3 install rtimulib
```

Add symlink to RTIMU in `homeassistant_venv` directory. Create a symlink using the following command:

```bash
$ 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.

```bash
$ sudo addgroup homeassistant input
$ sudo addgroup homeassistant i2c
```

Reboot Raspberry Pi to apply changes.

```bash
$ sudo reboot
```

### {% linkable_title Customizing the Sense HAT data %}

To format the sensor values, add the following to your `sensor` entry in your `configuration.yaml` file.
**Format the sensor values**
Add the following to your `sensor`

```yaml
# Example configuration.yaml entry
Expand All @@ -107,7 +64,8 @@ sensor:
unit_of_measurement: '%'
```

Add the following to your `customize` section to set friendly names & icons for the values.
**Give the values friendly names & icons**
Add the following to your `customize`

```yaml
# Example configuration.yaml entry
Expand All @@ -121,9 +79,10 @@ customize:
sensor.sensehat_pressure:
icon: mdi:gauge
friendly_name: "Pressure"
```
```

Create a group for your Sense HAT details by adding the following to your `groups` section.
**Create a group**
Add the following to your `groups`

```yaml
# Example configuration.yaml entry
Expand All @@ -135,13 +94,59 @@ group:
- 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/)