home-assistant.io/source/_components/cover.rflink.markdown
2017-10-07 22:34:25 +02:00

2.4 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release
layout title description date sidebar comments sharing footer logo ha_category ha_release
page RFLink Cover Instructions how to integrate RFXtrx covers into Home Assistant. 2016-08-24 14:30 true false true true rflink.png Cover 0.55

The rflink cover platform supports devices that use RFLink gateway firmware, for example the Nodo RFLink Gateway. RFLink gateway is an Arduino firmware that allows two-way communication with a multitude of RF wireless devices using cheap hardware (Arduino + transceiver).

First you have to set up your rflink hub.

The RFLink component does not know the difference between a switch and a light. Therefore all switchable devices are automatically added as light by default.

RFLink switch/light/cover ID's are composed of: protocol, id, switch. For example: newkaku_0000c6c2_1.

Once the ID of a switch is known it can be used to configure it as a switch type in HA, for example to add it to a different group, hide it or configure a nice name.

To add RFLink to your installation, add the following to your Home Assistant configuration.yaml file:

# Example configuration.yaml entry
cover:
  platform: rflink
  device_defaults:
    fire_event: true
    signal_repetitions: 2
  devices:
    newkaku_0000c6c2_1:
      name: Ceiling fan
    conrad_00785c_0a:
      name: Motion sensor kitchen

Configuration variables:

  • devices (Optional): A list of devices with their name to use in the frontend.
  • device_defaults: (Optional)
    • fire_event (Optional): Set default fire_event for RFLink switch devices (see below).
    • signal_repetitions (Optional): Set default signal_repetitions for RFLink switch devices (see below).

Device configuration variables:

  • name (Optional): Name for the device, defaults to RFLink ID.
  • aliases (Optional): Alternative RFLink ID's this device is known by.
  • fire_event (Optional): Fire an button_pressed event if this device is turned on or off (default: False).
  • signal_repetitions (Optional): Repeat every RFLink command this number of times (default: 1)
  • group (Optional): Allow switch to respond to group commands (ALLON/ALLOFF). (default: yes)
  • group_aliases (Optional): aliases which only respond to group commands.
  • no_group_aliases (Optional): aliases which do not respond to group commands.