mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-10 10:56:49 +00:00
Update the formatting and move the customization part to the end
This commit is contained in:
parent
536d0b539a
commit
0f2fa10f79
@ -35,11 +35,55 @@ Configuration variables:
|
|||||||
- 'humidity'
|
- 'humidity'
|
||||||
- 'pressure'
|
- 'pressure'
|
||||||
|
|
||||||
|
### {% 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.
|
||||||
|
|
||||||
**Format the sensor values**
|
Install SenseHAT package. Switch to the `homeassistant_venv` directory and activate the virtual environment.
|
||||||
Add the following to your `sensor`
|
|
||||||
|
```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.
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
@ -63,8 +107,7 @@ sensor:
|
|||||||
unit_of_measurement: '%'
|
unit_of_measurement: '%'
|
||||||
```
|
```
|
||||||
|
|
||||||
**Give the values friendly names & icons**
|
Add the following to your `customize` section to set friendly names & icons for the values.
|
||||||
Add the following to your `customize`
|
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
@ -78,10 +121,9 @@ customize:
|
|||||||
sensor.sensehat_pressure:
|
sensor.sensehat_pressure:
|
||||||
icon: mdi:gauge
|
icon: mdi:gauge
|
||||||
friendly_name: "Pressure"
|
friendly_name: "Pressure"
|
||||||
```
|
```
|
||||||
|
|
||||||
**Create a group**
|
Create a group for your Sense HAT details by adding the following to your `groups` section.
|
||||||
Add the following to your `groups`
|
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
@ -93,7 +135,9 @@ group:
|
|||||||
- sensor.sensehat_humidity
|
- sensor.sensehat_humidity
|
||||||
- sensor.sensehat_pressure
|
- sensor.sensehat_pressure
|
||||||
```
|
```
|
||||||
|
|
||||||
Add the _sense_hat group_ a group (_Kitchen for example_)
|
Add the _sense_hat group_ a group (_Kitchen for example_)
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
group:
|
group:
|
||||||
@ -101,52 +145,3 @@ group:
|
|||||||
- group.sense_hat
|
- 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/)
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user