mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-15 21:36:52 +00:00
84 lines
2.5 KiB
Markdown
84 lines
2.5 KiB
Markdown
---
|
|
layout: page
|
|
title: "Raspberry Pi RF Switch"
|
|
description: "Instructions on how to integrate devices controlled via codes sent with low-cost GPIO RF modules on a Raspberry Pi into Home Assistant as a switch."
|
|
date: 2016-05-10 09:00
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: raspberry-pi.png
|
|
ha_category: DIY
|
|
ha_release: 0.19
|
|
ha_iot_class: "Assumed state"
|
|
---
|
|
|
|
|
|
The `rpi_rf` switch platform allows you to control devices over 433/315MHz LPD/SRD signals with generic low-cost GPIO RF modules on a [Raspberry Pi](https://www.raspberrypi.org/).
|
|
|
|
Interoperable with codes sniffed via [the rpi-rf module](https://pypi.python.org/pypi/rpi-rf) or [rc-switch](https://github.com/sui77/rc-switch).
|
|
For more info see the PyPi module description: [rpi-rf](https://pypi.python.org/pypi/rpi-rf).
|
|
|
|
## {% linkable_title Configuration %}
|
|
|
|
To enable, add the following to your `configuration.yaml`:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
switch:
|
|
- platform: rpi_rf
|
|
gpio: 17
|
|
switches:
|
|
bedroom_light:
|
|
code_on: 1234567
|
|
code_off: 1234568
|
|
ambilight:
|
|
pulselength: 200
|
|
code_on: 987654
|
|
code_off: 133742
|
|
living_room_light:
|
|
protocol: 5
|
|
code_on: 654321,565874,233555,149874
|
|
code_off: 654320,565873,233554,149873
|
|
signal_repetitions: 15
|
|
```
|
|
|
|
{% configuration %}
|
|
gpio:
|
|
description: GPIO to which the data line of the TX module is connected.
|
|
required: true
|
|
type: integer
|
|
switches:
|
|
description: The array that contains all switches.
|
|
required: true
|
|
type: list
|
|
keys:
|
|
entry:
|
|
description: Name of the switch. Multiple entries are possible.
|
|
required: true
|
|
type: list
|
|
keys:
|
|
code_on:
|
|
description: Decimal code(s) to switch the device on. To run multiple codes in a sequence, separate the individual codes with commas ','.
|
|
required: true
|
|
type: list
|
|
code_off:
|
|
description: Decimal code(s) to switch the device off. To run multiple codes in a sequence, separate the individual codes with commas ','.
|
|
required: true
|
|
type: list
|
|
protocol:
|
|
description: RF Protocol.
|
|
required: false
|
|
default: 1
|
|
type: integer
|
|
pulselength:
|
|
description: Pulselength
|
|
required: false
|
|
type: integer
|
|
signal_repetitions:
|
|
description: Number of times to repeat transmission
|
|
required: false
|
|
default: 10
|
|
type: integer
|
|
{% endconfiguration %}
|