From bc29dfae1d4bba434a09474f835cb45ac2afcab0 Mon Sep 17 00:00:00 2001 From: javicalle Date: Sun, 28 Oct 2018 16:33:18 +0100 Subject: [PATCH 1/9] Homogeneous description for RFLINK platform devices Correction of deprecated attributes --- .../_components/binary_sensor.rflink.markdown | 7 +- source/_components/cover.rflink.markdown | 84 ++++++++-------- source/_components/light.rflink.markdown | 99 +++++++++++-------- source/_components/sensor.rflink.markdown | 45 +++++---- source/_components/switch.rflink.markdown | 90 ++++++++++------- 5 files changed, 190 insertions(+), 135 deletions(-) diff --git a/source/_components/binary_sensor.rflink.markdown b/source/_components/binary_sensor.rflink.markdown index 9e9bee2a3c9..cfe439201a8 100644 --- a/source/_components/binary_sensor.rflink.markdown +++ b/source/_components/binary_sensor.rflink.markdown @@ -37,7 +37,7 @@ binary_sensor: devices: description: A list of binary sensors. required: false - type: map + type: list keys: rflink_ids: description: RFLink ID of the device @@ -45,15 +45,16 @@ devices: type: map keys: name: - description: Name of the device, defaults to RFLink ID. + 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 device_class: - description: The [type or class of the sensor](/components/binary_sensor/) to set the icon in the frontend. + description: The [type or class of the sensor](/components/binary_sensor/#device-class) to set the icon in the frontend. required: false type: string off_delay: diff --git a/source/_components/cover.rflink.markdown b/source/_components/cover.rflink.markdown index 768d1e20455..b145251fe5f 100644 --- a/source/_components/cover.rflink.markdown +++ b/source/_components/cover.rflink.markdown @@ -75,56 +75,62 @@ cover: ``` {% configuration %} -devices: - description: A list of devices with their name to use in the frontend. - required: false - type: list - keys: - name: - description: The name for the device. Defaults to value for Rflink ID. - required: false - type: string - aliases: - description: The alternative Rflink ID's this device is known by. - required: false - type: list - 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 - no_group_aliases: - description: The `aliases` which do not respond to group commands. - required: false - type: list device_defaults: - description: The default values for a device. + description: The defaults for the devices. required: false - type: list + type: map keys: fire_event: - description: The default `fire_event` for Rflink cover devices. + description: Set default `fire_event` for Rflink cover devices. required: false default: False type: boolean signal_repetitions: - description: The default `signal_repetitions` for Rflink cover devices. + 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 %} diff --git a/source/_components/light.rflink.markdown b/source/_components/light.rflink.markdown index 61e366392e3..4f179609b5c 100644 --- a/source/_components/light.rflink.markdown +++ b/source/_components/light.rflink.markdown @@ -41,63 +41,82 @@ light: device_defaults: description: The defaults for the devices. required: false - type: list + type: map keys: fire_event: description: Set default `fire_event` for Rflink switch devices (see below). required: false + default: False type: boolean signal_repetitions: description: Set default `signal_repetitions` for Rflink switch devices (see below). required: false + default: 1 type: integer automatic_add: - description: Automatically add new/unconfigured devices to HA if detected. + description: Automatically add new/unconfigured devices to Home Assistant if detected. required: false default: true type: boolean devices: - description: A list of devices with their name to use in the frontend. + description: A list of lights. required: false type: list keys: - name: - description: Name for the device. - required: false - default: Rflink ID - type: string - type: - description: "Override automatically detected type of the light device, can be: switchable, dimmable, hybrid or toggle. See 'Light Types' below." - required: false - default: switchable - type: string - aliases: - description: (deprecated) Alternative Rflink ID's this device is known by. - required: false - type: [list, string] - group_aliases: - description: "(deprecated) `aliases` which only respond to group commands." - required: false - type: [list, string] - no_group_aliases: - description: "(deprecated) `aliases` which do not respond to group commands." - 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: Repeat every Rflink command this number of times. - required: false - default: 1 - type: integer - group: - description: Allow light to respond to group commands (ALLON/ALLOFF). - required: false - default: true - type: boolean + 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 + type: + description: Override automatically detected type of the light device, can be: switchable, dimmable, hybrid or toggle. See [Light Types](components/light.rflink/#light-types) below. + required: false + default: switchable + type: string + aliases: + description: Alternative Rflink ID's this device is known by. + required: false + type: [list, string] + group_aliases: + description: "`aliases` which only respond to group commands." + required: false + type: [list, string] + no_group_aliases: + description: "`aliases` which do not respond to group commands." + 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: Repeat every Rflink command this number of times. + required: false + default: 1 + type: integer + group: + description: Allow light to respond to group commands (ALLON/ALLOFF). + required: false + default: true + type: boolean + aliasses: + description: (**deprecated**) Alternative Rflink ID's this device is known by. + required: false + type: [list, string] + group_aliasses: + description: "(**deprecated**) `aliases` which only respond to group commands." + required: false + type: [list, string] + no_group_aliasses: + description: "(**deprecated**) `aliases` which do not respond to group commands." + required: false + type: [list, string] {% endconfiguration %} ### {% linkable_title Light state %} diff --git a/source/_components/sensor.rflink.markdown b/source/_components/sensor.rflink.markdown index 7254bbf2f27..019e3917dc0 100644 --- a/source/_components/sensor.rflink.markdown +++ b/source/_components/sensor.rflink.markdown @@ -41,29 +41,40 @@ automatic_add: default: true type: boolean devices: - description: A list of devices with their name to use in the frontend. + description: A list of sensors. required: false type: list keys: - name: - description: Name for the device. - required: false - default: RFLink ID - type: string - sensor_type: - description: Override automatically detected type of sensor. For list of values see below. + rflink_ids: + description: RFLink ID of the device required: true - type: string - unit_of_measurement: - description: Override automatically detected unit of sensor. - required: false - type: string - aliases: - description: "(deprecated) Alternative RFLink ID's this device is known by." - required: false - type: [list, string] + type: map + keys: + name: + description: Name for the device. + required: false + default: RFLink ID + type: string + sensor_type: + description: Override automatically detected type of sensor. For list of [values](components/sensor.rflink/#sensors-types) see below. + required: true + type: string + unit_of_measurement: + description: Override automatically detected unit of sensor. + required: false + type: string + aliases: + description: "Alternative RFLink ID's this device is known by." + required: false + type: [list, string] + aliasses: + description: "(**deprecated**) Alternative RFLink ID's this device is known by." + required: false + type: [list, string] {% endconfiguration %} +### {% linkable_title Sensors types%} + Sensor type values: - average_windspeed diff --git a/source/_components/switch.rflink.markdown b/source/_components/switch.rflink.markdown index 0b8840479e2..5f424f038ca 100644 --- a/source/_components/switch.rflink.markdown +++ b/source/_components/switch.rflink.markdown @@ -41,55 +41,74 @@ switch: {% configuration %} device_defaults: - description: The defaults for all listed devices. + description: The defaults for the devices. required: false - type: list + type: map keys: fire_event: description: Set default `fire_event` for Rflink switch devices (see below). required: false + default: False type: boolean signal_repetitions: description: Set default `signal_repetitions` for Rflink switch devices (see below). required: false + default: 1 type: integer devices: - description: A list of devices with their name to use in the frontend. + description: A list of switches. required: false type: list keys: - name: - description: Name for the device. - required: false - default: Rflink ID - type: string - aliases: - description: (deprecated) Alternative Rflink ID's this device is known by. - required: false - type: [list, string] - group_aliases: - description: "(deprecated) `aliases` which only respond to group commands." - required: false - type: [list, string] - no_group_aliases: - description: "(deprecated) `aliases` which do not respond to group commands." - 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: Set default `signal_repetitions` for RFLink switch devices (see below). - required: false - default: 1 - type: integer - group: - description: Allow light to respond to group commands (ALLON/ALLOFF). - required: false - default: true - type: boolean + 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] + group_aliases: + description: "`aliases` which only respond to group commands." + required: false + type: [list, string] + no_group_aliases: + description: "`aliases` which do not respond to group commands." + 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: Set default `signal_repetitions` for RFLink switch devices (see below). + required: false + default: 1 + type: integer + group: + description: Allow light to respond to group commands (ALLON/ALLOFF). + required: false + default: true + type: boolean + aliases: + description: "(**deprecated**) Alternative Rflink ID's this device is known by." + required: false + type: [list, string] + group_aliases: + description: "(**deprecated**) `aliases` which only respond to group commands." + required: false + type: [list, string] + no_group_aliases: + description: "(**deprecated**) `aliases` which do not respond to group commands." + required: false + type: [list, string] {% endconfiguration %} ### {% linkable_title Switch state %} @@ -105,7 +124,6 @@ switch: devices: newkaku_0000c6c2_1: name: Ceiling fan - icon: mdi:fan aliases: - newkaku_000000001_2 - kaku_000001_a From df44eb6fab69a6da17d921242b1ab039111a328e Mon Sep 17 00:00:00 2001 From: javicalle Date: Sun, 28 Oct 2018 17:02:32 +0100 Subject: [PATCH 2/9] Minimal configuration & Additional configuration examples --- source/_components/cover.rflink.markdown | 37 ++++++++++++++--- source/_components/light.rflink.markdown | 43 ++++++++++++++------ source/_components/sensor.rflink.markdown | 34 ++++++++++++++-- source/_components/switch.rflink.markdown | 48 ++++++++++++++--------- 4 files changed, 125 insertions(+), 37 deletions(-) diff --git a/source/_components/cover.rflink.markdown b/source/_components/cover.rflink.markdown index b145251fe5f..8a5f6f53edd 100644 --- a/source/_components/cover.rflink.markdown +++ b/source/_components/cover.rflink.markdown @@ -61,17 +61,15 @@ RFLink cover ID's are composed of: protocol, id, and gateway. For example: `RTS_ 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. -Assigning a name to a cover: +Configuring devices as a cover: ```yaml # Example configuration.yaml entry cover: - platform: rflink devices: - RTS_0100F2_0: - name: SunShade - bofumotor_455201_0f: - name: Sovrumsgardin + RTS_0100F2_0: {} + bofumotor_455201_0f: {} ``` {% configuration %} @@ -136,3 +134,32 @@ devices: ### {% linkable_title Device support %} See [device support](/components/rflink/#device-support). + +### {% linkable_title Additional configuration examples %} + +Multiple covers with custom names and aliases + +```yaml +# 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 +``` \ No newline at end of file diff --git a/source/_components/light.rflink.markdown b/source/_components/light.rflink.markdown index 4f179609b5c..ec8932605f8 100644 --- a/source/_components/light.rflink.markdown +++ b/source/_components/light.rflink.markdown @@ -23,18 +23,17 @@ RFLink switch/light ID's are composed of: protocol, id, switch. For example: `ne Once the ID of a light is known it can be used to configure the light in HA, for example to add it to a different group, hide it or configure a nice name. -Configuring a device as light with a nice name: +Configuring devices as a light: ```yaml # Example configuration.yaml entry light: - platform: rflink - device_defaults: - fire_event: true - signal_repetitions: 2 devices: - newkaku_0000c6c2_1: - name: Living room + NewKaku_02a48800_0: {} + newkaku_0000c6c2_1: {} + Ansluta_ce30_0: {} + Maclean_0d82_01: {} ``` {% configuration %} @@ -131,14 +130,9 @@ light: - platform: rflink devices: newkaku_0000c6c2_1: - name: Living room aliases: - newkaku_000000001_2 - kaku_000001_a - Ansluta_ce30_0: - name: Kitchen Under Counter Lights - Maclean_0d82_01: - name: Bedroom Lamp ``` Any on/off command from any alias ID updates the current state of the light. However when sending a command through the frontend only the primary ID is used. @@ -165,3 +159,30 @@ Lights are added automatically when the RFLink gateway intercepts a wireless com ### {% linkable_title Device support %} See [device support](/components/rflink/#device-support) + +### {% linkable_title Additional configuration examples %} + +Multiple lights with `signal_repetitions` and custom names + +```yaml +# Example configuration.yaml entry +light: + - platform: rflink + device_defaults: + fire_event: true + signal_repetitions: 2 + automatic_add: true + devices: + NewKaku_02a48800_0: + name: Kitchen + type: hybrid + newkaku_0000c6c2_1: + name: Living room + aliases: + - newkaku_000000001_2 + - kaku_000001_a + Ansluta_ce30_0: + name: Kitchen Under Counter Lights + Maclean_0d82_01: + name: Bedroom Lamp +``` \ No newline at end of file diff --git a/source/_components/sensor.rflink.markdown b/source/_components/sensor.rflink.markdown index 019e3917dc0..a0b15bcf5d7 100644 --- a/source/_components/sensor.rflink.markdown +++ b/source/_components/sensor.rflink.markdown @@ -23,15 +23,14 @@ RFLink sensor ID's are composed of: protocol, id and type (optional). For exampl Once the ID of a sensor is known it can be used to configure the sensor in HA, for example to add it to a different group, hide it or configure a nice name. -Assigning name to a sensor: +Configuring a device as a sensor: ```yaml # Example configuration.yaml entry sensor: - platform: rflink devices: - alectov1_0334_temp: - sensor_type: temperature + alectov1_0334_temp: {} ``` {% configuration %} @@ -121,3 +120,32 @@ Sensors are added automatically when the RFLink gateway intercepts a wireless co ### {% linkable_title Device support %} See [device support](/components/rflink/#device-support) + +### {% linkable_title Additional configuration examples %} + +Multiple sensors with `automatic_add` disabled and `aliases` + +```yaml +# Example configuration.yaml entry +sensor: + - platform: rflink + automatic_add: false + devices: + oregontemp_0d93_temp: + sensor_type: temperature + oregontemp_0d93_bat: + sensor_type: battery + tunex_c001_temp: + sensor_type: temperature + aliases: + - xiron_4001_temp + tunex_c001_hum: + sensor_type: humidity + aliases: + - xiron_4001_hum + tunex_c001_bat: + sensor_type: battery + aliases: + - xiron_4001_bat +``` + diff --git a/source/_components/switch.rflink.markdown b/source/_components/switch.rflink.markdown index 5f424f038ca..ef550189edd 100644 --- a/source/_components/switch.rflink.markdown +++ b/source/_components/switch.rflink.markdown @@ -22,21 +22,15 @@ RFLink switch/light ID's are composed of: protocol, id, switch. For example: `ne 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. -Configuring a device as switch with a nice name: +Configuring devices as switch : ```yaml # Example configuration.yaml entry switch: - platform: rflink - device_defaults: - fire_event: true - signal_repetitions: 2 - devices: - newkaku_0000c6c2_1: - name: Ceiling fan - conrad_00785c_0a: - name: Motion sensor kitchen - + - platform: rflink + devices: + newkaku_0000c6c2_1: {} + conrad_00785c_0a: {} ``` {% configuration %} @@ -120,13 +114,13 @@ Sometimes a switch is controlled by multiple wireless remotes, each remote has i ```yaml # Example configuration.yaml entry switch: - platform: rflink - devices: - newkaku_0000c6c2_1: - name: Ceiling fan - aliases: - - newkaku_000000001_2 - - kaku_000001_a + - platform: rflink + devices: + newkaku_0000c6c2_1: + name: Ceiling fan + aliases: + - newkaku_000000001_2 + - kaku_000001_a ``` Any on/off command from any alias ID updates the current state of the switch. However when sending a command through the frontend only the primary ID is used. @@ -134,3 +128,21 @@ Any on/off command from any alias ID updates the current state of the switch. Ho ### {% linkable_title Device support %} See [device support](/components/rflink/#device-support) + +### {% linkable_title Additional configuration examples %} + +Multiple switches with signal repetitions and custom names + +```yaml +# Example configuration.yaml entry +switch: + - platform: rflink + device_defaults: + fire_event: true + signal_repetitions: 2 + devices: + newkaku_0000c6c2_1: + name: Ceiling fan + conrad_00785c_0a: + name: Motion sensor kitchen +``` \ No newline at end of file From 58ad4a6936e6ced6161aff555cb6ebc2ee8170bd Mon Sep 17 00:00:00 2001 From: javicalle Date: Sun, 28 Oct 2018 19:29:21 +0100 Subject: [PATCH 3/9] deploy/netlify failed "mapping values are not allowed in this context" --- source/_components/light.rflink.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/light.rflink.markdown b/source/_components/light.rflink.markdown index ec8932605f8..e34158d92c6 100644 --- a/source/_components/light.rflink.markdown +++ b/source/_components/light.rflink.markdown @@ -40,7 +40,7 @@ light: device_defaults: description: The defaults for the devices. required: false - type: map + type: list keys: fire_event: description: Set default `fire_event` for Rflink switch devices (see below). From 982da0a6e9a61378365674fbdb21a2ec621ba1b8 Mon Sep 17 00:00:00 2001 From: javicalle Date: Sun, 28 Oct 2018 19:40:41 +0100 Subject: [PATCH 4/9] not the map type Maybe the anchor definition... --- source/_components/light.rflink.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/light.rflink.markdown b/source/_components/light.rflink.markdown index e34158d92c6..02e181673d8 100644 --- a/source/_components/light.rflink.markdown +++ b/source/_components/light.rflink.markdown @@ -40,7 +40,7 @@ light: device_defaults: description: The defaults for the devices. required: false - type: list + type: map keys: fire_event: description: Set default `fire_event` for Rflink switch devices (see below). @@ -73,7 +73,7 @@ devices: default: Rflink ID type: string type: - description: Override automatically detected type of the light device, can be: switchable, dimmable, hybrid or toggle. See [Light Types](components/light.rflink/#light-types) below. + description: Override automatically detected type of the light device, can be: switchable, dimmable, hybrid or toggle. See [Light Types](/components/light.rflink/#light-types) below. required: false default: switchable type: string From ec39f924fcc8c942191a6384ecc2b7668931d74b Mon Sep 17 00:00:00 2001 From: javicalle Date: Sun, 28 Oct 2018 20:07:41 +0100 Subject: [PATCH 5/9] ahhh, the colon symbol --- source/_components/light.rflink.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/light.rflink.markdown b/source/_components/light.rflink.markdown index 02e181673d8..770e6b2f6e0 100644 --- a/source/_components/light.rflink.markdown +++ b/source/_components/light.rflink.markdown @@ -73,7 +73,7 @@ devices: default: Rflink ID type: string type: - description: Override automatically detected type of the light device, can be: switchable, dimmable, hybrid or toggle. See [Light Types](/components/light.rflink/#light-types) below. + description: "Override automatically detected type of the light device, can be: switchable, dimmable, hybrid or toggle. See [Light Types](/components/light.rflink/#light-types) below." required: false default: switchable type: string From f86bc4db68f4aa268c13111b6a7db4f68c5a27f5 Mon Sep 17 00:00:00 2001 From: javicalle Date: Sun, 28 Oct 2018 20:50:22 +0100 Subject: [PATCH 6/9] RFLink typo for platform references homogenous definitions & references (PE: binary_sensor) minor typos --- .../_components/binary_sensor.rflink.markdown | 2 +- source/_components/cover.rflink.markdown | 18 +++++++-------- source/_components/light.rflink.markdown | 22 +++++++++---------- source/_components/sensor.rflink.markdown | 10 ++++----- source/_components/switch.rflink.markdown | 20 ++++++++--------- 5 files changed, 36 insertions(+), 36 deletions(-) diff --git a/source/_components/binary_sensor.rflink.markdown b/source/_components/binary_sensor.rflink.markdown index cfe439201a8..d73b4f73dea 100644 --- a/source/_components/binary_sensor.rflink.markdown +++ b/source/_components/binary_sensor.rflink.markdown @@ -47,7 +47,7 @@ devices: name: description: Name for the device. required: false - default: Rflink ID + default: RFLink ID type: string aliases: description: Alternative RFLink ID's this device is known by. diff --git a/source/_components/cover.rflink.markdown b/source/_components/cover.rflink.markdown index 8a5f6f53edd..5d38115cd14 100644 --- a/source/_components/cover.rflink.markdown +++ b/source/_components/cover.rflink.markdown @@ -13,11 +13,11 @@ ha_release: 0.55 --- -The `rflink` cover platform supports devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example, the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-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). +The `rflink` component supports devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-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](/components/rflink/). +First, you have to set up your [RFLink hub](/components/rflink/). -After configuring the RFLink hub covers will be automatically discovered and added. Except the Somfy RTS devices. +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 %} @@ -29,7 +29,7 @@ Press the Learn button on the original Somfy remote enter the following code wit 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. +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. ```text @@ -79,12 +79,12 @@ device_defaults: type: map keys: fire_event: - description: Set default `fire_event` for Rflink cover devices. + 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. + description: Set default `signal_repetitions` for RFLink cover devices. required: false default: 1 type: integer @@ -101,10 +101,10 @@ devices: name: description: Name for the device. required: false - default: Rflink ID + default: RFLink ID type: string aliases: - description: Alternative Rflink ID's this device is known by. + description: Alternative RFLink ID's this device is known by. required: false type: [list, string] fire_event: @@ -113,7 +113,7 @@ devices: default: False type: boolean signal_repetitions: - description: The number of times every Rflink command should repeat. + description: The number of times every RFLink command should repeat. required: false type: integer group: diff --git a/source/_components/light.rflink.markdown b/source/_components/light.rflink.markdown index 770e6b2f6e0..c181c93800f 100644 --- a/source/_components/light.rflink.markdown +++ b/source/_components/light.rflink.markdown @@ -13,15 +13,15 @@ ha_release: 0.38 ha_iot_class: "Assumed state" --- -The `rflink` component support devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-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). +The `rflink` component supports devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-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](/components/rflink/). +First, you have to set up your [RFLink hub](/components/rflink/). -After configuring the RFLink hub lights will be automatically discovered and added. +After configuring the RFLink hub, lights will be automatically discovered and added. -RFLink switch/light ID's are composed of: protocol, id, switch. For example: `newkaku_0000c6c2_1`. +RFLink binary_sensor/switch/light ID's are composed of: protocol, id, switch/channel. For example: `newkaku_0000c6c2_1`. -Once the ID of a light is known it can be used to configure the light in HA, for example to add it to a different group, hide it or configure a nice name. +Once the ID of a light is known, it can be used to configure the light in HA, for example to add it to a different group, hide it or configure a nice name. Configuring devices as a light: @@ -43,12 +43,12 @@ device_defaults: type: map keys: fire_event: - description: Set default `fire_event` for Rflink switch devices (see below). + description: Set default `fire_event` for RFLink switch devices (see below). required: false default: False type: boolean signal_repetitions: - description: Set default `signal_repetitions` for Rflink switch devices (see below). + description: Set default `signal_repetitions` for RFLink switch devices (see below). required: false default: 1 type: integer @@ -70,7 +70,7 @@ devices: name: description: Name for the device. required: false - default: Rflink ID + default: RFLink ID type: string type: description: "Override automatically detected type of the light device, can be: switchable, dimmable, hybrid or toggle. See [Light Types](/components/light.rflink/#light-types) below." @@ -78,7 +78,7 @@ devices: default: switchable type: string aliases: - description: Alternative Rflink ID's this device is known by. + description: Alternative RFLink ID's this device is known by. required: false type: [list, string] group_aliases: @@ -95,7 +95,7 @@ devices: default: false type: boolean signal_repetitions: - description: Repeat every Rflink command this number of times. + description: Repeat every RFLink command this number of times. required: false default: 1 type: integer @@ -105,7 +105,7 @@ devices: default: true type: boolean aliasses: - description: (**deprecated**) Alternative Rflink ID's this device is known by. + description: (**deprecated**) Alternative RFLink ID's this device is known by. required: false type: [list, string] group_aliasses: diff --git a/source/_components/sensor.rflink.markdown b/source/_components/sensor.rflink.markdown index a0b15bcf5d7..0e8340f1627 100644 --- a/source/_components/sensor.rflink.markdown +++ b/source/_components/sensor.rflink.markdown @@ -13,15 +13,15 @@ ha_release: 0.38 ha_iot_class: "Local Polling" --- -The `rflink` component support devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-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). +The `rflink` component supports devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-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](/components/rflink/). +First, you have to set up your [RFLink hub](/components/rflink/). -After configuring the RFLink hub sensors will be automatically discovered and added. +After configuring the RFLink hub, sensors will be automatically discovered and added. -RFLink sensor ID's are composed of: protocol, id and type (optional). For example: `alectov1_0334_temp`. Some sensors emit multiple types of data. Each will be created as its own +RFLink sensor ID's are composed of: protocol, id and type (optional). For example: `alectov1_0334_temp`. Some sensors emit multiple types of data. Each will be created as its own. -Once the ID of a sensor is known it can be used to configure the sensor in HA, for example to add it to a different group, hide it or configure a nice name. +Once the ID of a sensor is known, it can be used to configure the sensor in HA, for example to add it to a different group, hide it or configure a nice name. Configuring a device as a sensor: diff --git a/source/_components/switch.rflink.markdown b/source/_components/switch.rflink.markdown index ef550189edd..7a915b2f07c 100644 --- a/source/_components/switch.rflink.markdown +++ b/source/_components/switch.rflink.markdown @@ -12,15 +12,15 @@ ha_category: Switch ha_release: 0.38 --- -The `rflink` component support devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-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). +The `rflink` component supports devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-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](/components/rflink/). +First, you have to set up your [RFLink hub](/components/rflink/). -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. +The RFLink component does not know the difference between a `switch`, a `binary_sensor` and a `light`. Therefore all switchable devices are automatically added as `light` by default. -RFLink switch/light ID's are composed of: protocol, id, switch. For example: `newkaku_0000c6c2_1`. +RFLink binary_sensor/switch/light ID's are composed of: protocol, id, switch/channel. 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. +Once the ID of a switch is known, it can be used to configure it as a switch type in HA and, for example, to add it to a different group, hide it or configure a nice name. Configuring devices as switch : @@ -40,12 +40,12 @@ device_defaults: type: map keys: fire_event: - description: Set default `fire_event` for Rflink switch devices (see below). + description: Set default `fire_event` for RFLink switch devices (see below). required: false default: False type: boolean signal_repetitions: - description: Set default `signal_repetitions` for Rflink switch devices (see below). + description: Set default `signal_repetitions` for RFLink switch devices (see below). required: false default: 1 type: integer @@ -62,10 +62,10 @@ devices: name: description: Name for the device. required: false - default: Rflink ID + default: RFLink ID type: string aliases: - description: Alternative Rflink ID's this device is known by. + description: Alternative RFLink ID's this device is known by. required: false type: [list, string] group_aliases: @@ -92,7 +92,7 @@ devices: default: true type: boolean aliases: - description: "(**deprecated**) Alternative Rflink ID's this device is known by." + description: "(**deprecated**) Alternative RFLink ID's this device is known by." required: false type: [list, string] group_aliases: From d2302f9fd9a5c98ace77db9f46f3b2a99759502a Mon Sep 17 00:00:00 2001 From: javicalle Date: Sun, 28 Oct 2018 21:08:40 +0100 Subject: [PATCH 7/9] one last colon --- source/_components/binary_sensor.rflink.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/binary_sensor.rflink.markdown b/source/_components/binary_sensor.rflink.markdown index d73b4f73dea..b40c2a4a093 100644 --- a/source/_components/binary_sensor.rflink.markdown +++ b/source/_components/binary_sensor.rflink.markdown @@ -13,7 +13,7 @@ ha_iot_class: "Local Push" ha_release: "0.81" --- -The `rflink` component supports devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example, the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-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). +The `rflink` component supports devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-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](/components/rflink/). From 7c4f7b18c366e9380fabff48efc9399f34876f93 Mon Sep 17 00:00:00 2001 From: javicalle Date: Sun, 28 Oct 2018 21:19:03 +0100 Subject: [PATCH 8/9] one last colon --- source/_components/sensor.rflink.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/sensor.rflink.markdown b/source/_components/sensor.rflink.markdown index 0e8340f1627..d1741c17afd 100644 --- a/source/_components/sensor.rflink.markdown +++ b/source/_components/sensor.rflink.markdown @@ -21,7 +21,7 @@ After configuring the RFLink hub, sensors will be automatically discovered and a RFLink sensor ID's are composed of: protocol, id and type (optional). For example: `alectov1_0334_temp`. Some sensors emit multiple types of data. Each will be created as its own. -Once the ID of a sensor is known, it can be used to configure the sensor in HA, for example to add it to a different group, hide it or configure a nice name. +Once the ID of a sensor is known, it can be used to configure the sensor in Home Assistant, for example to add it to a different group, hide it or configure a nice name. Configuring a device as a sensor: From 58a24d29f087abedd2925f41996932f5796f9c02 Mon Sep 17 00:00:00 2001 From: javicalle <31999997+javicalle@users.noreply.github.com> Date: Tue, 22 Jan 2019 22:43:14 +0100 Subject: [PATCH 9/9] Update switch.rflink.markdown --- source/_components/switch.rflink.markdown | 17 +++++------------ 1 file changed, 5 insertions(+), 12 deletions(-) diff --git a/source/_components/switch.rflink.markdown b/source/_components/switch.rflink.markdown index 08cf847e7e8..10d6625ed1e 100644 --- a/source/_components/switch.rflink.markdown +++ b/source/_components/switch.rflink.markdown @@ -12,11 +12,9 @@ ha_category: Switch ha_release: 0.38 --- -The `rflink` component support devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example, the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-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). +The `rflink` component supports devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example, the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-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). -## {% linkable_title Configuration %} - -First, you have to set up your [rflink hub](/components/rflink/). +First, you have to set up your [RFLink hub](/components/rflink/). The RFLink component does not know the difference between a `switch`, a `binary_sensor` and a `light`. Therefore all switchable devices are automatically added as `light` by default. @@ -30,14 +28,9 @@ Configuring devices as switch : # Example configuration.yaml entry switch: - platform: rflink - device_defaults: - fire_event: true - signal_repetitions: 2 devices: - newkaku_0000c6c2_1: - name: Ceiling fan - conrad_00785c_0a: - name: Motion sensor kitchen + newkaku_0000c6c2_1: {} + conrad_00785c_0a: {} ``` {% configuration %} @@ -152,4 +145,4 @@ switch: name: Ceiling fan conrad_00785c_0a: name: Motion sensor kitchen -``` \ No newline at end of file +```