diff --git a/source/_integrations/raspihats.markdown b/source/_integrations/raspihats.markdown deleted file mode 100644 index da010ded807..00000000000 --- a/source/_integrations/raspihats.markdown +++ /dev/null @@ -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 ---- - -
- -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). - -
- -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 `` 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 `` 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/). diff --git a/source/_redirects b/source/_redirects index 62bc6dc7953..57aa8ac9ee3 100644 --- a/source/_redirects +++ b/source/_redirects @@ -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