home-assistant.io/source/_components/cover.rfxtrx.markdown
Franck Nijhof c464056402
Making our website faster, cleaner and prettier (#9853)
* 🔥 Removes octopress.js

* 🔥 Removes use of root_url var

* 🔥 Removes Octopress generator reference from feed

* 🔥 Removes delicious support

* 🔥 Removes support for Pinboard

* 🔥 Removes support for Disqus

* 🔥 Removes support for Google Plus

* ↩️ Migrate custom after_footer to default template

* ↩️ Migrate custom footer to default template

* ↩️ Migrate custom header to default template

* 🔥 Removes unused template files

* 🚀 Places time to read directly in post template

* 🚀 Removes unneeded capture from archive_post.html template

* 🔥 🚀 Removes unused, but heaving sorting call in component page

* 🚀 Merged javascripts into a single file

* 🔥 Removes more uses of root_url

* 🚀 Removal of unneeded captures from head

* 🔥 🚀 Removal of expensive liquid HTML compressor

* 🔥 Removes unneeded templates

* 🚀 Replaces kramdown with GitHub's CommonMark 🚀

* 💄 Adds Prism code syntax highlighting

*  Adds support for redirect in Netlify

* ↩️ 🔥 Let Netlify handle all developer doc redirects

* ✏️ Fixes typo in redirects file: Netify -> Netlify

* 🔥 Removes unused .themes folder

* 🔥 Removes unused aside.html template

* 🔥 Removes Disqus config leftover

* 🔥 Removes rouge highlighter config

* 🔥 Removes Octopress 🎉

* 💄 Adjust code block font size and adds soft wraps

* 💄 Adds styling for inline code blocks

* 💄 Improve styling of note/warning/info boxes + div support

* 🔨 Rewrites all note/warning/info boxes
2019-07-15 22:17:54 +02:00

3.1 KiB

title, description, logo, ha_category, ha_release
title description logo ha_category ha_release
RFXtrx Cover Instructions on how to integrate RFXtrx covers into Home Assistant. rfxtrx.png
Cover
0.27

The rfxtrx platform supports Siemens/LightwaveRF and RFY roller shutters that communicate in the frequency range of 433.92 MHz.

First you have to set up your rfxtrx hub.

Configuration

Siemens/LightwaveRF

The easiest way to find your roller shutters is to add this to your configuration.yaml:

cover:
  - platform: rfxtrx
    automatic_add: true

Launch your homeassistant and go the website (e.g http://localhost:8123). Push your remote and your device should be added.

Once added it will show an ID (e.g 0b11000102ef9f210010f70) and you can verify that it works from the frontend. Then you should update your configuration to:

cover:
  - platform: rfxtrx
    devices:
      0b11000102ef9f210010f70:
        name: device_name
RFY

The RFXtrx433e is required for RFY support, however it does not support receive for the RFY protocol - as such devices cannot be automatically added. Instead, configure the device in the rfxmngr tool. Make a note of the assigned ID and Unit Code and then add a device to the configuration with the following id 071a0000[id][unit_code]. E.g., if the id was 0a 00 01, and the unit code was 01 then the fully qualified id would be 071a00000a000101, if you set your id/code to single digit in the rfxmngr, e.g., id: 1 02 04 and unit code: 1 you will need to add 0 before, so 102031 becomes 071a000001020301.

Common

Example configuration:

# Example configuration.yaml entry
cover:
  - platform: rfxtrx
    automatic_add: false
    signal_repetitions: 2
    devices:
      0b1100ce3213c7f210010f70: # Siemens/LightwaveRF
        name: Bedroom Shutter
      071a00000a000101: # RFY
        name: Bathroom Shutter

{% configuration %} devices: description: A list of devices. required: false type: list keys: name: description: Override the name to use in the frontend. required: true type: string fire_event: description: Fires an event even if the state is the same as before. Can be used for automations. required: false default: false type: boolean automatic_add: description: To enable the automatic addition of new covers (Siemens/LightwaveRF only). required: false default: false type: boolean signal_repetitions: description: Because the rxftrx device sends its actions via radio and from most receivers it's impossible to know if the signal was received or not. Therefore you can configure the roller shutter to try to send each signal repeatedly. required: false type: integer {% endconfiguration %}

If a device ID consists of only numbers, please make sure to surround it with quotes. This is a known limitation in YAML, because the device ID will be interpreted as a number otherwise.