mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-23 09:17:06 +00:00
Remove deprecated Sense HAT integration (#21811)
Co-authored-by: Paulus Schoutsen <balloob@gmail.com>
This commit is contained in:
Franck Nijhof
GitHub
parent
3159277be9
commit
c8a5da8478
@ -1,207 +0,0 @@
|
||||
---
|
||||
title: Sense HAT
|
||||
description: Instructions on how to setup Sense HAT LED lights within Home Assistant.
|
||||
ha_category:
|
||||
- DIY
|
||||
- Light
|
||||
- Sensor
|
||||
ha_iot_class: Assumed State
|
||||
ha_release: 0.44
|
||||
ha_domain: sensehat
|
||||
ha_platforms:
|
||||
- light
|
||||
- sensor
|
||||
---
|
||||
|
||||
<div class='note warning'>
|
||||
|
||||
This integration is deprecated and will be removed in Home Assistant Core 2022.4.
|
||||
|
||||
For more information see: [Architectural Decision Record 0019](https://github.com/home-assistant/architecture/blob/master/adr/0019-GPIO.md).
|
||||
|
||||
</div>
|
||||
|
||||
There is currently support for the following device types within Home Assistant:
|
||||
|
||||
- [Light](#light)
|
||||
- [Sensor](#sensor)
|
||||
|
||||
## Light
|
||||
|
||||
The `sensehat` light platform lets you control the [Sense HAT](https://www.raspberrypi.org/products/sense-hat/) board's 8x8 RGB LED matrix on your Raspberry Pi from within Home Assistant.
|
||||
|
||||
To add `sensehat` light to your installation, add the following to your `configuration.yaml` file:
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
light:
|
||||
- platform: sensehat
|
||||
```
|
||||
|
||||
## Sensor
|
||||
|
||||
The `sensehat` sensor platform allows you to display information collected by a [Sense HAT](https://www.raspberrypi.org/products/sense-hat/) add-on board for Raspberry Pi.
|
||||
|
||||
To add this platform to your installation, add the following to your `configuration.yaml` file:
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
sensor:
|
||||
- platform: sensehat
|
||||
display_options:
|
||||
- temperature
|
||||
- humidity
|
||||
- pressure
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
display_options:
|
||||
description: List of details to monitor.
|
||||
required: true
|
||||
default: "`memory_free`"
|
||||
type: list
|
||||
keys:
|
||||
temperature:
|
||||
description: Temperature
|
||||
humidity:
|
||||
description: Humidity
|
||||
pressure:
|
||||
description: Pressure
|
||||
name:
|
||||
description: Change the name of the sensor, for in the frontend.
|
||||
required: false
|
||||
type: string
|
||||
is_hat_attached:
|
||||
description: Declaring that the SenseHAT _is_ physically on the Raspberry Pi.
|
||||
required: false
|
||||
default: true
|
||||
type: boolean
|
||||
{% endconfiguration %}
|
||||
|
||||
### Customizing the Sense HAT data
|
||||
|
||||
#### Format the sensor values
|
||||
|
||||
Add the following to your `sensor`:
|
||||
|
||||
{% raw %}
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
sensor:
|
||||
- platform: sensehat
|
||||
display_options:
|
||||
- temperature
|
||||
- humidity
|
||||
- pressure
|
||||
|
||||
- platform: template
|
||||
sensors:
|
||||
sensehat_temperature:
|
||||
value_template: "{{ states('sensor.temperature') | round(1) }}"
|
||||
unit_of_measurement: "°C"
|
||||
sensehat_pressure:
|
||||
value_template: "{{ states('sensor.pressure') | round(1) }}"
|
||||
unit_of_measurement: "mb"
|
||||
sensehat_humidity:
|
||||
value_template: "{{ states('sensor.humidity') | round(1) }}"
|
||||
unit_of_measurement: "%"
|
||||
```
|
||||
|
||||
{% endraw %}
|
||||
|
||||
#### 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 (_Kitchen for example_)
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
group:
|
||||
kitchen:
|
||||
- group.sense_hat
|
||||
```
|
||||
|
||||
### Directions for installing on Raspberry Pi Raspbian Based installation:
|
||||
|
||||
Here are the steps to make the _SenseHAT_ sensor work _successfully_ with the virtual environment versions.
|
||||
|
||||
#### Install SenseHAT package to _homeassistant_venv_
|
||||
|
||||
```bash
|
||||
# switch to the homeassistant_venv environment
|
||||
sudo -u homeassistant -H -s
|
||||
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
|
||||
# pi user environment: Install RTIMU
|
||||
pip3 install rtimulib
|
||||
|
||||
# pi user environment: Add _homeassistant_ user to the _input_, _video_ and the _i2c_ groups
|
||||
sudo addgroup homeassistant input
|
||||
sudo addgroup homeassistant i2c
|
||||
sudo addgroup homeassistant video
|
||||
|
||||
# HA environment: Add symlink to RTIMU
|
||||
ln -s /usr/lib/python3/dist-packages/RTIMU.cpython-35m-arm-linux-gnueabihf.so /srv/homeassistant/lib/python3.5/site-packages/
|
||||
|
||||
# pi user environment: Reboot Raspberry Pi to apply changes
|
||||
sudo reboot
|
||||
```
|
||||
|
||||
Unfortunately enabling the SenseHAT Sensor integration for a Virtual Environment install of Home Assistant fails with errors.
|
||||
_(The Raspberry Pi All-In-One installer run Home Assistant in a 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
|
||||
|
||||
For setting up the Sense HAT's RGB LED matrix as lights within Home Assistant, please see the [Sense HAT light component](#light).
|
||||
@ -448,7 +448,6 @@
|
||||
/components/light.qwikswitch /integrations/qwikswitch
|
||||
/components/light.rfxtrx /integrations/rfxtrx#light
|
||||
/components/light.scsgate /integrations/scsgate#light
|
||||
/components/light.sensehat /integrations/sensehat#light
|
||||
/components/light.sisyphus /integrations/sisyphus
|
||||
/components/light.skybell /integrations/skybell#light
|
||||
/components/light.smartthings /integrations/smartthings#light
|
||||
@ -813,7 +812,6 @@
|
||||
/components/sensor.scrape /integrations/scrape
|
||||
/components/sensor.season /integrations/season
|
||||
/components/sensor.sense /integrations/sense
|
||||
/components/sensor.sensehat /integrations/sensehat#sensor
|
||||
/components/sensor.serial /integrations/serial
|
||||
/components/sensor.serial_pm /integrations/serial_pm
|
||||
/components/sensor.seventeentrack /integrations/seventeentrack
|
||||
@ -1697,7 +1695,6 @@
|
||||
/components/season /integrations/season
|
||||
/components/sendgrid /integrations/sendgrid
|
||||
/components/sense /integrations/sense
|
||||
/components/sensehat /integrations/sensehat
|
||||
/components/sensibo /integrations/sensibo
|
||||
/components/sensor /integrations/sensor
|
||||
/components/sensor.buienradar /integrations/sensor.buienradar
|
||||
@ -2369,6 +2366,10 @@
|
||||
/components/light.piglow /more-info/removed-integration 301
|
||||
/components/piglow /more-info/removed-integration 301
|
||||
/integrations/piglow /more-info/removed-integration 301
|
||||
/components/light.sensehat /more-info/removed-integration 301
|
||||
/components/sensehat /more-info/removed-integration 301
|
||||
/components/sensor.sensehat /more-info/removed-integration 301
|
||||
/integrations/sensehat /more-info/removed-integration 301
|
||||
/integrations/pi4ioe5v9xxxx /more-info/removed-integration 301
|
||||
/components/rpi_rf /more-info/removed-integration 301
|
||||
/components/switch.rpi_rf /more-info/removed-integration 301
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user