home-assistant.io/source/_components/cover.rflink.markdown
2019-01-22 22:27:56 +01:00

4.9 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 on how to integrate RFLink Somfy RTS Cover into Home Assistant. 2017-08-08 true false true true rflink.png Cover 0.55

The rflink component 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.

After configuring the RFLink hub, covers will be automatically discovered and added. Except the Somfy RTS devices.

{% linkable_title Setting up a Somfy RTS device %}

You have to add the Somfy RTS manually with the supplied RFlinkLoader (Windows only).

Press the Learn button on the original Somfy remote enter the following code within 3 seconds. Your blinds will go up and down shortly:

10;RTS;02FFFF;0412;3;PAIR;

Your blinds will go up and down again. This means your RFLink is now paired with your RTS motor. To check this enter the following code again and see if there is a record.

10;RTSSHOW;
RTS Record: 0 Address: FFFFFF RC: FFFF
RTS Record: 1 Address: FFFFFF RC: FFFF
RTS Record: 2 Address: FFFFFF RC: FFFF
RTS Record: 3 Address: 02FFFF RC: 0018
RTS Record: 4 Address: FFFFFF RC: FFFF
RTS Record: 5 Address: FFFFFF RC: FFFF
RTS Record: 6 Address: FFFFFF RC: FFFF
RTS Record: 7 Address: FFFFFF RC: FFFF
RTS Record: 8 Address: FFFFFF RC: FFFF
RTS Record: 9 Address: FFFFFF RC: FFFF
RTS Record: 10 Address: FFFFFF RC: FFFF
RTS Record: 11 Address: FFFFFF RC: FFFF
RTS Record: 12 Address: FFFFFF RC: FFFF
RTS Record: 13 Address: FFFFFF RC: FFFF
RTS Record: 14 Address: FFFFFF RC: FFFF
RTS Record: 15 Address: FFFFFF RC: FFFF

After configuring the RFLink Somfy RTS you have to add the cover to the configuration.yaml file like any other RFlink device.

RFLink cover ID's are composed of: protocol, id, and gateway. For example: RTS_0100F2_0.

Once the ID of a cover is known, it can be used to configure the cover in Home Assistant, for example, to add it to a different group, hide it or set a nice name.

Configuring devices as a cover:

# Example configuration.yaml entry
cover:
  - platform: rflink
    devices:
      RTS_0100F2_0: {}
      bofumotor_455201_0f: {}

{% configuration %} device_defaults: description: The defaults for the devices. required: false type: map keys: fire_event: description: Set default fire_event for RFLink cover devices. required: false default: false type: boolean signal_repetitions: description: Set default signal_repetitions for RFLink cover devices. required: false default: 1 type: integer devices: description: A list of covers. required: false type: list keys: rflink_ids: description: RFLink ID of the device required: true type: map keys: name: description: Name for the device. required: false default: RFLink ID type: string aliases: description: Alternative RFLink ID's this device is known by. required: false type: [list, string] fire_event: description: Fire a button_pressed event if this device is turned on or off. required: false default: False type: boolean signal_repetitions: description: The number of times every RFLink command should repeat. required: false type: integer group: description: Allow light to respond to group commands (ALLON/ALLOFF). required: false default: true type: boolean group_aliases: description: The aliases which only respond to group commands. required: false type: [list, string] no_group_aliases: description: The aliases which do not respond to group commands. required: false type: [list, string] {% endconfiguration %}

{% linkable_title Device support %}

See device support.

{% linkable_title Additional configuration examples %}

Multiple covers with custom names and aliases

# Example configuration.yaml entry
cover:
  - platform: rflink
    devices:
      RTS_0A8720_0:
        name: enanos
        aliases:
          - rts_31e53f_01
          - rts_32e53f_01
      RTS_30E542_0:
        name: comedor
        aliases:
          - rts_33e53f_01
          - rts_fa872e_01
      RTS_33E542_0:
        name: dormitorio
        aliases:
          - rts_30e53f_01
          - rts_32e53f_01
      RTS_32E542_0:
        name: habitaciones
        fire_event: true