diff --git a/source/_components/sensor.sensehat.markdown b/source/_components/sensor.sensehat.markdown index b4c1b377ca87..468e1a4eef56 100644 --- a/source/_components/sensor.sensehat.markdown +++ b/source/_components/sensor.sensehat.markdown @@ -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/)