From c8a5da84785b2bd17e77892a78d9bded31b27f2c Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Sat, 26 Feb 2022 22:37:01 +0100 Subject: [PATCH] Remove deprecated Sense HAT integration (#21811) Co-authored-by: Paulus Schoutsen --- source/_integrations/sensehat.markdown | 207 ------------------------- source/_redirects | 7 +- 2 files changed, 4 insertions(+), 210 deletions(-) delete mode 100644 source/_integrations/sensehat.markdown diff --git a/source/_integrations/sensehat.markdown b/source/_integrations/sensehat.markdown deleted file mode 100644 index 99a8d580de7..00000000000 --- a/source/_integrations/sensehat.markdown +++ /dev/null @@ -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 ---- - -
- -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). - -
- -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). diff --git a/source/_redirects b/source/_redirects index 1c691e06d7a..342314e7c2b 100644 --- a/source/_redirects +++ b/source/_redirects @@ -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