mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-21 08:16:53 +00:00
Remove deprecated Raspihats integration (#21847)
This commit is contained in:
Franck Nijhof
GitHub
parent
e1f71d0243
commit
8af1d4e1e4
@ -1,240 +0,0 @@
|
||||
---
|
||||
title: Raspihats
|
||||
description: Instructions on how to integrate Raspihats add-on boards for Raspberry Pi into Home Assistant.
|
||||
ha_category:
|
||||
- DIY
|
||||
- Binary Sensor
|
||||
- Switch
|
||||
ha_release: 0.45
|
||||
ha_iot_class: Local Push
|
||||
ha_domain: raspihats
|
||||
ha_platforms:
|
||||
- binary_sensor
|
||||
- switch
|
||||
---
|
||||
|
||||
<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>
|
||||
|
||||
The `raspihats` integration is the base for all related Raspihats platforms in Home Assistant. There is no setup needed for the integration itself.
|
||||
|
||||
## Binary Sensor
|
||||
|
||||
The `raspihats` binary sensor platform allows you to read sensor values using the digital inputs of the [raspihats](https://www.raspihats.com/) boards.
|
||||
|
||||
### Configuration
|
||||
|
||||
To use your `raspihats` boards in your installation, add the following to your `configuration.yaml` file:
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
binary_sensor:
|
||||
- platform: raspihats
|
||||
i2c_hats:
|
||||
- board: DI6acDQ6rly
|
||||
address: 0x60
|
||||
channels:
|
||||
- index: 0
|
||||
name: PIR Office
|
||||
invert_logic: true
|
||||
device_class: motion
|
||||
- index: 1
|
||||
name: PIR Bedroom
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
i2c_hats:
|
||||
description: An array of used I2C-HATs.
|
||||
required: false
|
||||
type: list
|
||||
keys:
|
||||
board:
|
||||
description: The board name either Di16, Di6Rly6, DI16ac or DI6acDQ6rly.
|
||||
required: true
|
||||
type: string
|
||||
address:
|
||||
description: The board I2C address as HEX value.
|
||||
required: true
|
||||
type: string
|
||||
channels:
|
||||
description: Array of used digital input channels.
|
||||
required: true
|
||||
type: list
|
||||
keys:
|
||||
index:
|
||||
description: Digital input channel index.
|
||||
required: true
|
||||
type: integer
|
||||
name:
|
||||
description: Friendly name to use for the frontend.
|
||||
required: true
|
||||
type: string
|
||||
invert_logic:
|
||||
description: Inverts the input logic.
|
||||
required: false
|
||||
default: false
|
||||
type: boolean
|
||||
device_class:
|
||||
description: Sets the [class of the device](/integrations/binary_sensor/), changing the device state and icon that is displayed on the frontend.
|
||||
required: false
|
||||
default: "None"
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
|
||||
### Directions for installing smbus support on Raspberry Pi
|
||||
|
||||
Enable I2c interface with the Raspberry Pi configuration utility:
|
||||
|
||||
```bash
|
||||
# pi user environment: Enable i2c interface
|
||||
$ sudo raspi-config
|
||||
```
|
||||
|
||||
Select `Interfacing options->I2C` choose `<Yes>` and hit `Enter`, then go to `Finish`.
|
||||
|
||||
Install dependencies for use the `smbus-cffi` module and enable your `homeassistant` user to join the _i2c_ group:
|
||||
|
||||
```bash
|
||||
# pi user environment: Install i2c dependencies and utilities
|
||||
$ sudo apt-get install build-essential libi2c-dev i2c-tools python-dev libffi-dev
|
||||
|
||||
# pi user environment: Add homeassistant user to the i2c group
|
||||
$ sudo usermod -a -G i2c homeassistant
|
||||
```
|
||||
|
||||
### Check the i2c address of the sensor
|
||||
|
||||
After installing `i2c-tools`, a new utility is available to scan the addresses of the connected sensors, so you can see the sensor address:
|
||||
|
||||
```bash
|
||||
/usr/sbin/i2cdetect -y 1
|
||||
```
|
||||
|
||||
It will output a table like this:
|
||||
|
||||
```text
|
||||
0 1 2 3 4 5 6 7 8 9 a b c d e f
|
||||
00: -- -- -- -- -- -- -- -- -- -- -- -- --
|
||||
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
|
||||
20: -- -- -- 23 -- -- -- -- -- -- -- -- -- -- -- --
|
||||
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
|
||||
40: 40 -- -- -- -- -- UU -- -- -- -- -- -- -- -- --
|
||||
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
|
||||
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
|
||||
70: -- -- -- -- -- -- -- 77
|
||||
```
|
||||
|
||||
For more details about the `raspihats` add-on boards for Raspberry Pi, visit [raspihats.com](https://www.raspihats.com/).
|
||||
|
||||
## Switch
|
||||
|
||||
The `raspihats` switch platform allows you to control the digital outputs of your [Raspihats](https://www.raspihats.com/) boards.
|
||||
|
||||
### Configuration
|
||||
|
||||
To use your Raspihats boards in your installation, add the following to your `configuration.yaml` file:
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
switch:
|
||||
- platform: raspihats
|
||||
i2c_hats:
|
||||
- board: DI6acDQ6rly
|
||||
address: 0x60
|
||||
channels:
|
||||
- index: 0
|
||||
name: Fan Office
|
||||
invert_logic: true
|
||||
initial_state: true
|
||||
- index: 1
|
||||
name: Light Office
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
i2c_hats:
|
||||
description: An array of used I2C-HATs.
|
||||
required: false
|
||||
type: list
|
||||
keys:
|
||||
board:
|
||||
description: The board name.
|
||||
required: true
|
||||
type: string
|
||||
address:
|
||||
description: The board I2C address as HEX value.
|
||||
required: true
|
||||
type: string
|
||||
channels:
|
||||
description: An array of used digital input channels.
|
||||
required: true
|
||||
type: list
|
||||
keys:
|
||||
index:
|
||||
description: The digital input channel index.
|
||||
required: true
|
||||
type: integer
|
||||
name:
|
||||
description: The friendly name to use for the frontend.
|
||||
required: true
|
||||
type: string
|
||||
invert_logic:
|
||||
description: Inverts the input logic.
|
||||
required: false
|
||||
default: false
|
||||
type: boolean
|
||||
initial_state:
|
||||
description: "The initial state, can be either `true` or `false`. `none` means no state is forced on the corresponding digital output when this switch is instantiated."
|
||||
required: false
|
||||
default: None
|
||||
type: boolean
|
||||
{% endconfiguration %}
|
||||
|
||||
### Directions for installing smbus support on Raspberry Pi
|
||||
|
||||
Enable I2c interface with the Raspberry Pi configuration utility:
|
||||
|
||||
```bash
|
||||
# pi user environment: Enable i2c interface
|
||||
sudo raspi-config
|
||||
```
|
||||
|
||||
Select `Interfacing options->I2C` choose `<Yes>` and hit `Enter`, then go to `Finish`.
|
||||
|
||||
Install dependencies for use the `smbus-cffi` module and enable your `homeassistant` user to join the _i2c_ group:
|
||||
|
||||
```bash
|
||||
# pi user environment: Install i2c dependencies and utilities
|
||||
sudo apt-get install build-essential libi2c-dev i2c-tools python-dev libffi-dev
|
||||
|
||||
# pi user environment: Add homeassistant user to the i2c group
|
||||
sudo usermod -a -G i2c homeassistant
|
||||
```
|
||||
|
||||
## Check the i2c address of the sensor
|
||||
|
||||
After installing `i2c-tools`, a new utility is available to scan the addresses of the connected sensors, so you can see the sensor address:
|
||||
|
||||
```bash
|
||||
/usr/sbin/i2cdetect -y 1
|
||||
```
|
||||
|
||||
It will output a table like this:
|
||||
|
||||
```text
|
||||
0 1 2 3 4 5 6 7 8 9 a b c d e f
|
||||
00: -- -- -- -- -- -- -- -- -- -- -- -- --
|
||||
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
|
||||
20: -- -- -- 23 -- -- -- -- -- -- -- -- -- -- -- --
|
||||
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
|
||||
40: 40 -- -- -- -- -- UU -- -- -- -- -- -- -- -- --
|
||||
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
|
||||
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
|
||||
70: -- -- -- -- -- -- -- 77
|
||||
```
|
||||
|
||||
For more details about the Raspihats add-on boards for Raspberry Pi, visit [raspihats.com](https://www.raspihats.com/).
|
||||
@ -181,7 +181,6 @@
|
||||
/components/binary_sensor.raincloud /integrations/raincloud#binary-sensor
|
||||
/components/binary_sensor.rainmachine /integrations/rainmachine
|
||||
/components/binary_sensor.random /integrations/random#binary-sensor
|
||||
/components/binary_sensor.raspihats /integrations/raspihats#binary-sensor
|
||||
/components/binary_sensor.rfxtrx /integrations/rfxtrx#binary-sensors
|
||||
/components/binary_sensor.ring /integrations/ring#binary-sensor
|
||||
/components/binary_sensor.rpi_gpio /integrations/rpi_gpio#binary-sensor
|
||||
@ -965,7 +964,6 @@
|
||||
/components/switch.rainbird /integrations/rainbird#switch
|
||||
/components/switch.raincloud /integrations/raincloud#switch
|
||||
/components/switch.rainmachine /integrations/rainmachine#switch
|
||||
/components/switch.raspihats /integrations/raspihats#switch
|
||||
/components/switch.raspyrfm /integrations/raspyrfm
|
||||
/components/switch.recswitch /integrations/recswitch
|
||||
/components/switch.rfxtrx /integrations/rfxtrx#switch
|
||||
@ -1644,7 +1642,6 @@
|
||||
/components/rainforest_eagle /integrations/rainforest_eagle
|
||||
/components/rainmachine /integrations/rainmachine
|
||||
/components/random /integrations/random
|
||||
/components/raspihats /integrations/raspihats
|
||||
/components/raspyrfm /integrations/raspyrfm
|
||||
/components/recollect_waste /integrations/recollect_waste
|
||||
/components/recorder /integrations/recorder
|
||||
@ -2380,3 +2377,7 @@
|
||||
/components/rpi_rf /more-info/removed-integration 301
|
||||
/components/switch.rpi_rf /more-info/removed-integration 301
|
||||
/integrations/rpi_rf /more-info/removed-integration 301
|
||||
/components/binary_sensor.raspihats /more-info/removed-integration 301
|
||||
/components/raspihats /more-info/removed-integration 301
|
||||
/components/switch.raspihats /more-info/removed-integration 301
|
||||
/integrations/raspihats /more-info/removed-integration 301
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user