RFXCOM Binding

This binding integrates large number of sensors and actuators from several different manufactures through RFXCOM transceivers.

RFXCOM transceivers support RF 433 Mhz protocols like:

  • HomeEasy
  • Cresta
  • X10
  • La Crosse
  • OWL
  • CoCo (KlikAanKlikUit),
  • PT2262
  • Oregon
  • etc.

See the RFXtrx User Guide from RFXCOM for the complete list of supported sensors and devices as well as firmware update announcements.

Supported RFXCOM Types

This binding supports the RFXtrx433E and RFXtrx315 transceivers and the RFXrec433 receiver as bridges for accessing different sensors and actuators.

Discovery

The transceivers/receivers may be automatically discovered by the JD2XX library and put in the Inbox or may be configured manually.

After the bridge is configured and the transceiver receives a message from any sensor or actuator, the device is put in the Inbox. Because RFXCOM communication is a one way protocol, receiver actuators can't be discovered automatically.

Note: Apple OS X

Apple provides built-in FTDI drivers for OS X, which need to be disabled to get JD2XX work properly.

FTDI driver disabling can be done by the following command

sudo kextunload -b com.apple.driver.AppleUSBFTDI

FTDI driver can be enabled by the following command

sudo kextload -b com.apple.driver.AppleUSBFTDI

Note: Linux

Linux has built-in FTDI drivers, which need to be disabled for JD2XX to take over

FTDI drivers can be disabled by blacklisting the ftdi_sio module in your modprobe config (/etc/modprobe.d/). However this will require ALL FTDI devices to then be accessed via something like JD2XX. If you have, or may acquire, other USB serial devices you will probably prefer to configure your RFXCOM manually.

If you configure the RFXCOM manually note that the serial port that is assigned to it may change if you have more than one USB serial device. On systems using udev (practically all modern Linux systems) you can add a rule to /etc/udev/rules.d/ such as:

SUBSYSTEM=="tty", ATTRS{product}=="RFXtrx433", ATTRS{serial}=="A12LPLW", SYMLINK+="rfxtrx0"

and then you will be able to use /dev/rfxtrx0 as the serial device regardless of what /dev/ttyUSB<n> device has been assigned. (N.B. you can get the product and serial strings to use from the output of dmesg, lsusb or by looking in /sys/)

Manual Configuration

If you have any problems with JD2XX or you don't want to disable FTDI driver on OS X or Linux, you can also configure RFXCOM transceivers/receivers manually.

To do that via the PaperUI, manually add the generic RFXCOM device named RFXCOM USB Transceiver, with the description "This is universal RFXCOM transceiver bridge for manual configuration purposes". You will need to specify at least the serial port which has been assigned to the RFXCOM (see notes above). You may also need to change permissions on the serial port to allow openhab to access it and you may need to tell the java libraries about it by adding a line to <openhab root>/conf/environment such as:

EXTRA\_JAVA\_OPTS="-Dgnu.io.rxtx.SerialPorts=/dev/&lt;device&gt;

Alternatively you can add the RFXCOM using a thing file such as:

Bridge rfxcom:bridge:usb0 [ serialPort="/dev/&lt;device&gt;" ] {
    _thing definitions_...
}

RFXCOM over TCP/IP

You can also use an RFXCOM device over TCP/IP. To start a TCP server for an RFXCOM device, you can use socat:

socat tcp-listen:10001,fork,reuseaddr file:/dev/ttyUSB0,raw

A TCP bridge, for use with socat on a remote host, can only be configured manually either through the PaperUI by adding an "RFXCOM USB Transceiver over TCP/IP" device or in a thing file like this:

Bridge rfxcom:tcpbridge:sunflower [ host="sunflower", port=10001 ] {
    Thing lighting2 100001_1 [deviceId="100001.1", subType="AC"]
}

Bridge Configuration

Applies toParameter LabelParameter IDDescriptionRequiredDefault
allTransceiver typetransceiverTypeType of the transceiverfalse
allDisable discoverydisableDiscoveryPrevent unknown devices from being added to the inboxtruefalse
allSkip transceiver configurationignoreConfigDo not send config. command, other config will be ignoredtruetrue
allRFXCOM transceiver modesetModeConfig. command as hexadec. (28 chars). If set, other config is ignored.false
allTransmit PowertransmitPowerTransmit power in dBm, between -18dBm and +10dBm.false-18
all except RFXtrx315Enable AEBlyssenableAEBlyssEnable receiving of protocol AEBlyssfalse
all except RFXtrx315Enable ACenableACEnable receiving of protocol ACfalse
all except RFXtrx315Enable AD / LightwaveRFenableADLightwaveRFEnable receiving of protocol AD / LightwaveRFfalse
all except RFXtrx315Enable ARCenableARCEnable receiving of protocol ARCfalse
all except RFXtrx315Enable ATIenableATIEnable receiving of protocol ATI / cartelectronicfalse
all except RFXtrx315Enable Blinds T0enableBlindsT0Enable receiving of protocol Blinds T0false
all except RFXtrx315Enable Blinds T1enableBlindsT1T2T3T4Enable receiving of protocol Blinds T1false
all except RFXtrx315Enable Byron SXenableByronSXEnable receiving of protocol Byron SXfalse
all except RFXtrx315Enable FineOffset / VikingenableFineOffsetVikingEnable receiving of protocol FineOffset / Vikingfalse
all except RFXtrx315Enable FS20/Legrand CADenableFS20Enable receiving of protocol FS20/Legrand CADfalse
all except RFXtrx315Enable Hideki / UPMenableHidekiUPMEnable receiving of protocol Hideki / UPMfalse
all except RFXtrx315Enable HomeConfortenableHomeConfortEnable receiving of protocol HomeConfortfalse
all except RFXtrx315Enable HomeEasy EUenableHomeEasyEUEnable receiving of protocol HomeEasy EUfalse
all except RFXtrx315Enable Imagintronix / OpusenableImagintronixOpusEnable receiving of protocol Imagintronix / Opusfalse
all except RFXtrx315Enable KEELOQenableKEELOQEnable receiving of protocol KEELOQfalse
all except RFXtrx315Enable La CrosseenableLaCrosseEnable receiving of protocol La Crossefalse
all except RFXtrx315Enable Lighting4enableLighting4Enable receiving of protocol Lighting4false
all except RFXtrx315Enable MeiantechenableMeiantechEnable receiving of protocol Meiantechfalse
all except RFXtrx315Enable MertikenableMertikEnable receiving of protocol Mertikfalse
all except RFXtrx315Enable Oregon ScientificenableOregonScientificEnable receiving of protocol Oregon Scientificfalse
all except RFXtrx315Enable ProGuardenableProGuardEnable receiving of protocol ProGuardfalse
all except RFXtrx315Enable RSLenableRSLEnable receiving of protocol RSLfalse
all except RFXtrx315Enable RubicsonenableRubicsonEnable receiving of protocol Rubicson / Lacrosse / Banggoodfalse
allEnable VisonicenableVisonicEnable receiving of protocol Visonicfalse
allEnable UndecodedenableUndecodedEnable receiving of protocol Undecodedfalse
allEnable X10enableX10Enable receiving of protocol X10false
bridgeSerial portserialPortSerial port for manual configurationtrue
RFXtrx315 / RFXrec433 / RFXtrx433Serial numberbridgeIdSerial number of the RFXCOM (FTDI) devicetrue
tcpbridgeHosthostHostname / ip address of devicetrue
tcpbridgePortportPort of devicetrue

Thing Configuration

Available configuration parameters are:

Applies toParameter LabelParameter IDDescriptionRequiredDefault
All thingsDevice IDdeviceId(Unique) id of the device, for example "100001.1", "B.8" or "286169"true
All thingsSub typesubTypeSub type, note that every thing-type has its own sub typestrue
Lighting4PulsepulsePulse length used by the device, only used when sendingfalse350
Lighting4On command IDonCommandIdId of the command which should be send to turn the device ONfalse1
Lighting4Off command IDoffCommandIdId of the command which should be send to turn the device OFFfalse4

Channels

This binding currently supports following channel types:

Channel Type IDItem TypeDescription
chimesoundNumberId of the chime sound
commandSwitchCommand channel.
commandIdStringId of the command.
contactContactContact channel.
datetimeDateTimeDateTime channel.
dimminglevelDimmerDimming level channel.
forecastStringWeather forecast from device: NO_INFO_AVAILABLE/SUNNY/PARTLY_CLOUDY/CLOUDY/RAIN
humidityNumberRelative humidity level in percentages.
humiditystatusStringCurrent humidity status: NORMAL/COMFORT/DRY/WET
instantampNumberInstant current in Amperes.
instantpowerNumberInstant power consumption in Watts.
moodNumberMood channel.
motionSwitchMotion detection sensor state.
pressureNumberBarometric value in hPa.
rainrateNumberRain fall rate in millimeters per hour.
raintotalNumberTotal rain in millimeters.
rawmessageStringHexadecimal representation of the raw RFXCOM msg incl. header and payload
rawpayloadStringHexadecimal representation of payload RFXCOM messages
setpointNumberRequested temperature.
shutterRollershutterShutter/blind channel.
statusStringStatus channel.
temperatureNumberCurrent temperature in degree Celsius.
totalusageNumberUsed energy in Watt hours.
totalamphourNumberUsed "energy" in ampere-hours.
uvNumberCurrent UV level.
venetianBlindDimmerOpen/close and adjust angle of venetian blind
winddirectionNumberWind direction in degrees.
windspeedNumberWind speed in meters per second.

The binding uses the following system channels:

Channel Type IDItem TypeDescription
system.signal-strengthNumberRepresents signal strength of a device as a Number with values 0, 1, 2, 3 or 4; 0 being worst strength and 4 being best strength.
system.battery-levelNumberRepresents the battery level as a percentage (0-100%). Bindings for things supporting battery level in a different format (eg 4 levels) should convert to a percentage to provide a consistent battery level reading.
system.low-batterySwitchRepresents a low battery warning with possible values on/off.

Full example

Thing files

Sensors/actuators are easy to configure through the PaperUI. However, if you used a thing file for your RFXCOM you can also configure them manually there as well, for example:

Bridge rfxcom:bridge:usb0 [ serialPort="/dev/&lt;device&gt;" ] {
    Thing lighting2 100001_1 [ deviceId="100001.1", subType="AC" ]
}

Item files

Items may be created through PaperUI or add using item files in which you add a channel parameter specifying the bridge's name, the thing ID and channel that the item should be linked to, for example:

Switch Switch {channel="rfxcom:lighting2:usb0:100001_1:command"}

Supported Things

This binding currently supports the following things / message types:

bbqtemperature - RFXCOM BBQ Temperature Sensor

A BBQ Temperature device

Channels

NameChannel TypeItem TypeRemarks
foodTemperaturetemperatureNumber
bbqTemperaturetemperatureNumber
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id
    • Sensor Id. Example 56923

blinds1 - RFXCOM Blinds1 Actuator

A Blinds1 device

Channels

nameChannel TypeItem typeRemarks
commandcommandSwitch
shuttershutterRollershutter
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id

    • Sensor Id + unit code, separated by dot. Example 23455.1
  • subType - Sub Type

    • Specifies device sub type.

      • T0 - RollerTrol, Hasta new
      • T1 - Hasta old
      • T2 - A-OK RF01
      • T3 - A-OK AC114/AC123
      • T4 - Raex YR1326
      • T5 - Media Mount
      • T6 - DC106/Rohrmotor24-RMF/Yooda
      • T7 - Forest
      • T8 - Chamberlain CS4330CN

chime - RFXCOM Chime

A Chime device

Channels

NameChannel TypeItem TypeRemarks
chimeSoundchimesoundNumbernot all devices support multiple sounds
signalLevelsystem.signal-strengthNumber

Configuration Options

  • deviceId - Device Id

    • Sensor Id. Example 2983
  • subType - Sub Type

    • Specifies device sub type.

      • BYRONSX - Byron SX
      • BYRONMP001 - Byron MP001
      • SELECTPLUS - SelectPlus
      • SELECTPLUS3 - SelectPlus3
      • ENVIVO - Envivo

current - RFXCOM Current Sensor

A Current sensing device.

Channels

NameChannel TypeItem TypeRemarks
channel1AmpsinstantampNumber
channel2AmpsinstantampNumber
channel3AmpsinstantampNumber
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id

    • Sensor Id. Example 5693
  • subType - Sub Type

    • Specifies device sub type.

      • ELEC1 - OWL - CM113

currentenergy - RFXCOM CurrentEnergy Actuator

A CurrentEnergy device

Channels

NameChannel TypeItem TypeRemarks
channel1AmpsinstantampNumber
channel2AmpsinstantampNumber
channel3AmpsinstantampNumber
totalUsagetotalusageNumber
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id

    • Sensor Id. Example 47104
  • subType - Sub Type

    • Specifies device sub type.

      • ELEC4 - OWL - CM180i

curtain1 - RFXCOM Curtain1 Actuator

A Curtain1 device

Channels

NameChannel TypeItem TypeRemarks
commandcommandSwitch
shuttershutterRollershutter
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id

    • House code + unit code, separated by dot. Example A.1
  • subType - Sub Type

    • Specifies device sub type.

      • HARRISON - Harrison Curtain

datetime - RFXCOM Date/time sensor

A DateTime device

Channels

NameChannel TypeItem TypeRemarks
dateTimedatetimeDateTime
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id

    • Device id, example 47360
  • subType - Sub Type

    • Specifies device sub type.

      • RTGR328N - Oregon RTGR328N

energy - RFXCOM Energy Sensor

An Energy device

Channels

NameChannel TypeItem TypeRemarks
instantPowerinstantpowerNumber
totalUsagetotalusageNumber
instantAmpinstantampNumber
totalAmpHourtotalamphourNumber
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id

    • Sensor Id. Example 5693
  • subType - Sub Type

    • Specifies device sub type.

      • ELEC2 - CM119/160
      • ELEC3 - CM180

humidity - RFXCOM Humidity Sensor

A Humidity device

Channels

NameChannel TypeItem TypeRemarks
humidityhumidityNumber
humidityStatushumiditystatusString
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id

    • Sensor Id. Example 5693
  • subType - Sub Type

    • Specifies device sub type.

      • HUM1 - LaCrosse TX3
      • HUM2 - LaCrosse WS2300

lighting1 - RFXCOM Lighting1 Actuator

A Lighting1 device

Channels

NameChannel TypeItem TypeRemarks
commandcommandSwitch
contactcontactContact
signalLevelsystem.signal-strengthNumber

Configuration Options

  • deviceId - Device Id

    • Device Id. House code + unit code, separated by dot. Example A.1
  • subType - Sub Type

    • Specifies device sub type.

      • X10 - X10 lighting
      • ARC - ARC
      • AB400D - ELRO AB400D (Flamingo)
      • WAVEMAN - Waveman
      • EMW200 - Chacon EMW200
      • IMPULS - IMPULS
      • RISINGSUN - RisingSun
      • PHILIPS - Philips SBC
      • ENERGENIE - Energenie ENER010
      • ENERGENIE_5 - Energenie 5-gang
      • COCO - COCO GDR2-2000R
      • HQ_COCO20 - HQ COCO-20

lighting2 - RFXCOM Lighting2 Actuator

A Lighting2 device

Channels

NameChannel TypeItem TypeRemarks
commandcommandSwitch
contactcommandContact
dimmingLeveldimminglevelDimmer
signalLevelsystem.signal-strengthNumber

Configuration Options

  • deviceId - Device Id

    • Remote/switch/unit Id + unit code, separated by dot. Example 8773718.10
  • subType - Sub Type

    • Specifies device sub type.

      • AC - AC
      • HOME_EASY_EU - HomeEasy EU
      • ANSLUT - ANSLUT
      • KAMBROOK - Kambrook RF3672

lighting4 - RFXCOM Lighting4 Actuator

A Lighting4 device

Channels

NameChannel TypeItem TypeRemarks
commandcommandSwitch
commandIdcommandIdNumber
signalLevelsystem.signal-strengthNumber

Configuration Options

  • deviceId - Device Id

    • Device Id. Example 3456
  • subType - Sub Type

    • Specifies device sub type.

    • PT2262 - PT2262

  • pulse - Pulse length

    • Pulse length of the device
  • onCommandId - On command

    • Specifies command to be send when ON must be transmitted

      • 0 - OFF (value 0)
      • 1 - ON (value 1)
      • 2 - OFF (value 2)
      • 3 - ON (value 3)
      • 4 - OFF (value 4)
      • 5 - ON (value 5)
      • 6 - value 6
      • 7 - ON (value 7)
      • 8 - value 8
      • 9 - ON (value 9)
      • 10 - ON (value 10)
      • 11 - ON (value 11)
      • 12 - ON (value 12)
      • 13 - value 13
      • 14 - OFF (value 14)
      • 15 - value 15
  • offCommandId - Off command

    • Specifies command to be send when OFF must be transmitted

      • 0 - OFF (value 0)
      • 1 - ON (value 1)
      • 2 - OFF (value 2)
      • 3 - ON (value 3)
      • 4 - OFF (value 4)
      • 5 - ON (value 5)
      • 6 - value 6
      • 7 - ON (value 7)
      • 8 - value 8
      • 9 - ON (value 9)
      • 10 - ON (value 10)
      • 11 - ON (value 11)
      • 12 - ON (value 12)
      • 13 - value 13
      • 14 - OFF (value 14)
      • 15 - value 15

Examples

The support for lighting 4 in RFXCOM is less complete because a lot of different devices use the same chips and can not easily be distinguished.

So some extra configuration can be used for fine tuning the behavior of your Lighting4 devices. For configuration via the PaperUI three extra fields are available, being the the pulse length and a commmand id for on and off commands. If your item is auto-discovered normally the on or off command should be recognized properly.

For a usb attached RFXCOM on Windows the configuration could look like this (note that the onCommandId, offCommandId and pulse are all optional):

Bridge rfxcom:bridge:238adf67 [ serialPort="COM4" ] {
    Thing lighting4 17745  [deviceId="17745",  subType="PT2262", onCommandId=7, offCommandId=4, pulse=800]
    Thing lighting4 motion [deviceId="286169", subType="PT2262", onCommandId=9, pulse=392]
}

Your items file could look like this:

Switch Switch                               {channel="rfxcom:lighting4:238adf67:17745:command"}
Number SwitchCommandId "Command ID [%d]"    {channel="rfxcom:lighting4:238adf67:17745:commandId"}

And if you want random actions on your relay you could for example do like this:

rule "Set random relay variations"
    when
        System started or
        Time cron "/20 * * * * ?"
    then
        SwitchCommandId.sendCommand((Math::random * 15.9).intValue)
end

Devices:

BrandWhatActionCommand IDSupportedSource
KeruiMotion SensorMotion10as ON#3103
KeruiDoor Contactdoor open14as OFF#3103
KeruiDoor Contactdoor closed7as ON#3103
KeruiDoor Contacttamper7as ON#3103

lighting5 - RFXCOM Lighting5 Actuator

A Lighting5 device

Channels

NameChannel TypeItem TypeRemarks
commandcommandSwitch
contactcommandContact
dimmingLeveldimminglevelDimmer
moodmoodNumber
signalLevelsystem.signal-strengthNumber

Configuration Options

  • deviceId - Device Id

    • Remote/switch/unit Id + unit code, separated by dot. Example 10001.1
  • subType - Sub Type

    • Specifies device sub type.

      • AOKE - Aoke Relay
      • AVANTEK - Avantek
      • BBSB_NEW - BBSB new types
      • CONRAD_RSL2 - Conrad RSL2
      • EMW100 - EMW100 GAO/Everflourish
      • EURODOMEST - Eurodomest
      • IT - IT
      • KANGTAI - Kangtai, Cotech
      • LIGHTWAVERF - LightwaveRF, Siemens
      • LIVOLO - Livolo Dimmer or On/Off 1-3
      • LIVOLO_APPLIANCE - Livolo Appliance On/Off 1-10
      • MDREMOTE - MDREMOTE LED dimmer v106
      • MDREMOTE_107 - MDREMOTE v107
      • MDREMOTE_108 - MDREMOTE v108, EKAB-10KRF
      • RGB_TRC02 - RGB TRC02 (2 batt)
      • RGB_TRC02_2 - RGB TRC02_2 (3 batt)

lighting6 - RFXCOM Lighting6 Actuator

A Lighting6 device

Channels

NameChannel TypeItem TypeRemarks
commandcommandSwitch
contactcommandContact
signalLevelsystem.signal-strengthNumber

Configuration Options

  • deviceId - Device Id

    • Remote/switch/unit Id + group code + unit code, separated by dot. Example 100.A.1
  • subType - Sub Type

    • Specifies device sub type.

      • BLYSS - Blyss

rain - RFXCOM Rain Sensor

A Rain device

Channels

NameChannel TypeItem TypeRemarks
rainRaterainrateNumber
rainTotalraintotalNumber
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id

    • Sensor Id. Example 56923
  • subType - Sub Type

    • Specifies device sub type.

      • RAIN1 - RGR126/682/918/928
      • RAIN2 - PCR800
      • RAIN3 - TFA
      • RAIN4 - UPM RG700
      • RAIN5 - WS2300
      • RAIN6 - La Crosse TX5

rfy - RFXCOM Rfy Actuator

A Rfy device

Channels

NameChannel TypeItem TypeRemarks
commandcommandSwitchSends a program command to pair with a device when switched from off to on.
programcommandSwitchSend Program Command
shuttershutterRollershutterShutter
venetianBlindvenetianBlindDimmer
sunWindDetectorcommandSwitchEnable the sun+wind detector.
signalLevelsystem.signal-strengthNumber

Configuration Options

  • deviceId - Device Id

    • Unit Id + unit code, separated by dot. Example 100.1
  • subType - Sub Type

    • Specifies device sub type.

      • RFY - RFY
      • RFY_EXT - RFY Ext

security1 - RFXCOM Security1 Sensor

A Security1 device

Channels

NameChannel TypeItem TypeRemarks
statusstatusString
contactcommandContact
motionmotionSwitch
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id

    • Remote/sensor Id. Example 10001
  • subType - Sub Type

    • Specifies device sub type.

      • X10_SECURITY - X10 security door/window sensor
      • X10_SECURITY_MOTION - X10 security motion sensor
      • X10_SECURITY_REMOTE - X10 security remote (no alive packets)
      • KD101 - KD101 (no alive packets)
      • VISONIC_POWERCODE_SENSOR_PRIMARY_CONTACT - Visonic PowerCode door/window sensor – primary contact (with alive packets)
      • VISONIC_POWERCODE_MOTION - Visonic PowerCode motion sensor (with alive packets)
      • VISONIC_CODESECURE - Visonic CodeSecure (no alive packets)
      • VISONIC_POWERCODE_SENSOR_AUX_CONTACT - Visonic PowerCode door/window sensor – auxiliary contact (no alive packets)
      • MEIANTECH - Meiantech
      • SA30 - SA30 (no alive packets)

temperaturehumiditybarometric - RFXCOM Temperature-Humidity-Barometric Sensor

A Temperature-Humidity-Barometric device

Channels

NameChannel TypeItem TypeRemarks
temperaturetemperatureNumber
humidityhumidityNumber
humidityStatushumiditystatusString
pressurepressureNumber
forecastforecastString
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id

    • Sensor Id. Example 59648
  • subType - Sub Type

    • Specifies device sub type.

      • THB1 - BTHR918, BTHGN129
      • THB2 - BTHR918N, BTHR968

temperaturehumidity - RFXCOM Temperature-Humidity Sensor

A Temperature-Humidity device

Channels

NameChannel TypeItem TypeRemarks
temperaturetemperatureNumber
humidityhumidityNumber
humidityStatushumiditystatusString
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id

    • Sensor Id. Example 56923
  • subType - Sub Type

    • Specifies device sub type.

      • TH1 - THGN122/123, THGN132, THGR122/228/238/268
      • TH2 - THGR810, THGN800
      • TH3 - RTGR328
      • TH4 - THGR328
      • TH5 - WTGR800
      • TH6 - THGR918/928, THGRN228, THGN500
      • TH7 - TFA TS34C, Cresta
      • TH8 - WT260,WT260H,WT440H,WT450,WT450H
      • TH9 - Viking 02035,02038 (02035 has no humidity), Proove TSS320, 311501
      • TH10 - Rubicson
      • TH11 - EW109
      • TH12 - Imagintronix/Opus XT300 Soil sensor
      • TH13 - Alecto WS1700 and compatibles

temperaturerain - RFXCOM Temperature-Rain Sensor

A Temperature-Rain device

Channels

NameChannel TypeItem TypeRemarks
temperaturetemperatureNumber
rainTotalraintotalNumber
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id

    • Sensor Id. Example 56923
  • subType - Sub Type

    • Specifies device sub type.

      • WS1200 - WS1200

temperature - RFXCOM Temperature Sensor

A Temperature device

Channels

NameChannel TypeItem TypeRemarks
temperaturetemperatureNumber
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id

    • Sensor Id. Example 56923
  • subType - Sub Type

    • Specifies device sub type.

      • TEMP1 - THR128/138, THC138
      • TEMP2 - THC238/268,THN132,THWR288,THRN122,THN122,AW129/131
      • TEMP3 - THWR800
      • TEMP4 - RTHN318
      • TEMP5 - La Crosse TX2, TX3, TX4, TX17
      • TEMP6 - TS15C. UPM temp only
      • TEMP7 - Viking 02811, Proove TSS330, 311346
      • TEMP8 - La Crosse WS2300
      • TEMP9 - Rubicson
      • TEMP10 - TFA 30.3133
      • TEMP11 - WT0122

thermostat1 - RFXCOM Thermostat1 Sensor

A Thermostat1 device

Channels

NameChannel TypeItem TypeRemarks
contactcommandContact
setpointsetpointNumber
temperaturetemperatureNumber
signalLevelsystem.signal-strengthNumber

Configuration Options

  • deviceId - Device Id

    • Sensor Id. Example 56923
  • subType - Sub Type

    • Specifies device sub type.

      • DIGIMAX - Digimax, TLX7506
      • DIGIMAX_SHORT - Digimax with short format (no set point)

thermostat3 - RFXCOM Thermostat3 Sensor

A Thermostat3 device.

Channels

NameChannel TypeItem TypeRemarks
commandcommandSwitch
signalLevelsystem.signal-strengthNumber

Configuration Options

  • deviceId - Device Id

  • Sensor Id. Example 106411

  • subType - Sub Type

  • Specifies device sub type.

    • MERTIK__G6R_H4T1 - Mertik (G6R H4T1)
    • MERTIK__G6R_H4TB__G6_H4T__G6R_H4T21_Z22 - Mertik (G6R H4TB, G6R H4T, or G6R H4T21-Z22)
    • MERTIK__G6R_H4TD__G6R_H4T16 - Mertik (G6R H4TD or G6R H4T16)
    • MERTIK__G6R_H4S_TRANSMIT_ONLY - Mertik (G6R H4S - transmit only)

undecoded - RFXCOM Undecoded RF Messages

Any messages that RFXCOM can receive but not decode.

Channels

NameChannel TypeItem TypeRemarks
rawMessagerawmessageString
rawPayloadrawpayloadString

Configuration Options

  • deviceId - Device Id

    • Undecoded items cannot provide a device ID, so this value is always UNDECODED.
  • subType - Sub Type

    • Specifies device sub type.

      • AC - AC
      • ARC - ARC
      • ATI - ATI
      • HIDEKI_UPM - Hideki, UPM
      • LACROSSE_VIKING - La Crosse, Viking
      • AD - AD
      • MERTIK - Mertik Maxitrol Fireplace controllers
      • OREGON1 - Oregon Scientific 1
      • OREGON2 - Oregon Scientific 2
      • OREGON3 - Oregon Scientific 3
      • PROGUARD - ProGuard
      • VISONIC - Visonic
      • NEC - NEC
      • FS20 - FS20
      • RESERVED - Reserved
      • BLINDS - Blinds
      • RUBICSON - Rubicson
      • AE - AE
      • FINE_OFFSET - Fine Offset
      • RGB - RGB
      • RTS - RTS
      • SELECT_PLUS - Select Plus
      • HOME_CONFORT - Home Confort

uv - RFXCOM UV/Temperature Sensor

A UV/Temperature device

Channels

NameChannel TypeItem TypeRemarks
uvuvNumber
temperaturetemperatureNumber
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id

    • Sensor Id. Example 56923
  • subType - Sub Type

    • Specifies device sub type.

      • UV1 - UVN128, UV138
      • UV2 - UVN800
      • UV3 - TFA

wind - RFXCOM Wind Sensor

A Wind device

Channels

NameChannel TypeItem TypeRemarks
avgWindSpeedwindspeedNumberAverage Wind Speed
windSpeedwindspeedNumberWind Gust
windDirectionwinddirectionNumberWind Direction
temperaturetemperatureNumberCurrent temperature in degree Celsius
chillTemperaturetemperatureNumberChill temperature in degree Celsius
signalLevelsystem.signal-strengthNumber
batteryLevelsystem.battery-levelNumber
lowBatterysystem.low-batterySwitch

Configuration Options

  • deviceId - Device Id

    • Sensor Id. Example 2983
  • subType - Sub Type

    • Specifies device sub type.

      • WIND1 - WTGR800
      • WIND2 - WGR800
      • WIND3 - STR918, WGR918, WGR928
      • WIND4 - TFA
      • WIND5 - UPM WDS500
      • WIND6 - WS2300
      • WIND7 - Alecto WS4500, Auriol H13726, Hama EWS1500, Meteoscan W155/W160, Ventus WS155