4.1 KiB
layout | title | description | date | sidebar | comments | sharing | footer | logo | ha_category | ha_release | ha_iot_class |
---|---|---|---|---|---|---|---|---|---|---|---|
page | RFLink Sensor | Instructions on how to integrate RFLink sensors into Home Assistant. | 2016-01-04 | true | false | true | true | rflink.png | Sensor | 0.38 | Local Polling |
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, 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.
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:
# Example configuration.yaml entry
sensor:
- platform: rflink
devices:
alectov1_0334_temp: {}
{% configuration %} automatic_add: description: Automatically add new/unconfigured devices to Home Assistant if detected. required: false default: true type: boolean devices: description: A list of sensors. 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 sensor_type: description: Override automatically detected type of sensor. For list of values 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
- barometric_pressure
- battery
- weather_forecast
- doorbell_melody
- command
- co2_air_quality
- current_phase_1
- current_phase_2
- current_phase_3
- distance
- firmware
- humidity_status
- humidity
- hardware
- kilowatt
- light_intensity
- meter_value
- total_rain
- rain_rate
- revision
- noise_level
- temperature
- uv_intensity
- version
- voltage
- watt
- windchill
- winddirection
- windgusts
- windspeed
- windtemp
{% linkable_title Hiding/ignoring sensors %}
Sensors are added automatically when the RFLink gateway intercepts a wireless command in the ether. To prevent cluttering the frontend use any of these methods:
- Disable automatically adding of unconfigured new sensors (set
automatic_add
tofalse
). - Hide unwanted devices using customizations
- Ignore devices on a platform level
{% linkable_title Device support %}
See device support
{% linkable_title Additional configuration examples %}
Multiple sensors with automatic_add
disabled and aliases
# 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