mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-10 10:56:49 +00:00
🚜 Merges/Redirect Raspihats component pages (#8283)
This commit is contained in:
Klaas Schoute
Fabian Affolter
parent
2b05df7468
commit
97eab22103
@ -1,120 +0,0 @@
|
|||||||
---
|
|
||||||
layout: page
|
|
||||||
title: "Raspihats Binary Sensor"
|
|
||||||
description: "Instructions on how to integrate Raspihats add-on boards for Raspberry Pi into Home Assistant as a binary_sensor."
|
|
||||||
date: 2017-05-01 04:09
|
|
||||||
sidebar: true
|
|
||||||
comments: false
|
|
||||||
sharing: true
|
|
||||||
footer: true
|
|
||||||
logo: raspihats.png
|
|
||||||
ha_category: DIY
|
|
||||||
ha_release: 0.44
|
|
||||||
ha_iot_class: "Local Push"
|
|
||||||
---
|
|
||||||
|
|
||||||
The `raspihats` binary sensor platform allows you to read sensor values using the digital inputs of the [raspihats](http://www.raspihats.com/) boards.
|
|
||||||
|
|
||||||
## {% linkable_title 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: See device classes in [binary_sensor component](/components/binary_sensor/).
|
|
||||||
required: false
|
|
||||||
default: "None"
|
|
||||||
type: string
|
|
||||||
{% endconfiguration %}
|
|
||||||
|
|
||||||
## {% linkable_title 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
|
|
||||||
```
|
|
||||||
|
|
||||||
### {% linkable_title 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](http://www.raspihats.com/).
|
|
||||||
@ -8,9 +8,231 @@ comments: false
|
|||||||
sharing: true
|
sharing: true
|
||||||
footer: true
|
footer: true
|
||||||
logo: raspihats.png
|
logo: raspihats.png
|
||||||
ha_category: DIY
|
ha_category:
|
||||||
|
- DIY
|
||||||
|
- Binary Sensor
|
||||||
|
- Switch
|
||||||
ha_release: 0.45
|
ha_release: 0.45
|
||||||
ha_iot_class: "Local Push"
|
ha_iot_class: "Local Push"
|
||||||
|
redirect_from:
|
||||||
|
- /components/binary_sensor.raspihats/
|
||||||
|
- /components/switch.raspihats/
|
||||||
---
|
---
|
||||||
|
|
||||||
The `raspihats` component is the base for all related Raspihats platforms in Home Assistant. There is no setup needed for the component itself, for the platforms please check their corresponding pages.
|
The `raspihats` component is the base for all related Raspihats platforms in Home Assistant. There is no setup needed for the component itself.
|
||||||
|
|
||||||
|
## {% linkable_title Binary Sensor %}
|
||||||
|
|
||||||
|
The `raspihats` binary sensor platform allows you to read sensor values using the digital inputs of the [raspihats](http://www.raspihats.com/) boards.
|
||||||
|
|
||||||
|
## {% linkable_title 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: See device classes in [binary_sensor component](/components/binary_sensor/).
|
||||||
|
required: false
|
||||||
|
default: "None"
|
||||||
|
type: string
|
||||||
|
{% endconfiguration %}
|
||||||
|
|
||||||
|
## {% linkable_title 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
|
||||||
|
```
|
||||||
|
|
||||||
|
### {% linkable_title 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](http://www.raspihats.com/).
|
||||||
|
|
||||||
|
## {% linkable_title Switch %}
|
||||||
|
|
||||||
|
The `raspihats` switch platform allows you to control the digital outputs of your [Raspihats](http://www.raspihats.com/) boards.
|
||||||
|
|
||||||
|
## {% linkable_title 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 %}
|
||||||
|
|
||||||
|
## {% linkable_title 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
|
||||||
|
```
|
||||||
|
|
||||||
|
## {% linkable_title 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](http://www.raspihats.com/).
|
||||||
@ -1,120 +0,0 @@
|
|||||||
---
|
|
||||||
layout: page
|
|
||||||
title: "Raspihats Switch"
|
|
||||||
description: "Instructions on how to integrate Raspihats add-on boards for Raspberry Pi into Home Assistant as a switch."
|
|
||||||
date: 2017-05-15 04:20
|
|
||||||
sidebar: true
|
|
||||||
comments: false
|
|
||||||
sharing: true
|
|
||||||
footer: true
|
|
||||||
logo: raspihats.png
|
|
||||||
ha_category: DIY
|
|
||||||
ha_release: 0.45
|
|
||||||
ha_iot_class: "Local Push"
|
|
||||||
---
|
|
||||||
|
|
||||||
The `raspihats` switch platform allows you to control the digital outputs of your [Raspihats](http://www.raspihats.com/) boards.
|
|
||||||
|
|
||||||
## {% linkable_title 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 %}
|
|
||||||
|
|
||||||
## {% linkable_title 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
|
|
||||||
```
|
|
||||||
|
|
||||||
## {% linkable_title 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](http://www.raspihats.com/).
|
|
||||||
Loading…
x
Reference in New Issue
Block a user