The openHAB Documentation Has Moved

The documentation has moved to openhab.org/docs and openhab.org/addons.

Please use the link below to be redirected to the new version of this article, and update your bookmarks.

Spirit Thermostatic Valve

This describes the Z-Wave device Spirit, manufactured by Eurotronics with the thing type UID of eurotronic_spirit_00_000.

The device is in the category of Radiator Control, defining Controls on radiators used to heat up rooms.

Spirit product image

The Spirit supports routing. This allows the device to communicate using other routing enabled devices as intermediate routers. This device is unable to participate in the routing of data from other devices.

Overview

Inclusion Information

Start Inclusion mode of your primary Z-Wave Controller. Press the Boost-Button. Spirit Z-Wave Plus will show the assigned NodeID.

Exclusion Information

Start Exclusion mode of your primary Z-Wave Controller. Now press and hold the boost button of the Spirit Z-Wave Plus for at least 5 seconds.

Channels

The following table summarises the channels available for the Spirit -:

Channel Channel Id Category Item Type
Dimmer switch_dimmer DimmableLight Dimmer
Current temperature sensor_temperature Temperature Number
External temperature sensor_report    
Thermostat mode thermostat_mode Temperature Number
Setpoint (heat) thermostat_setpoint Temperature Number
Setpoint (energy heat) thermostat_setpoint Temperature Number
Alarm (system) alarm_system   Switch
Alarm (power) alarm_power Door Switch
Battery Level battery-level Battery Number

Dimmer

The brightness channel allows to control the brightness of a light. It is also possible to switch the light on and off.

The switch_dimmer channel supports the Dimmer item and is in the DimmableLight category.

Current temperature

Indicates the current temperature.

The sensor_temperature channel supports the Number item and is in the Temperature category. This is a read only channel so will only be updated following state changes from the device.

External temperature

Channel type information on this channel is not found.

Thermostat mode

Sets the thermostat.

The thermostat_mode channel supports the Number item and is in the Temperature category. The following state translation is provided for this channel to the Number item type -:

Value Label
0 Off
1 Heat
2 Cool
3 Auto
4 Aux Heat
5 Resume
6 Fan Only
7 Furnace
8 Dry Air
9 Moist Air
10 Auto Changeover
11 Heat Economy
12 Cool Economy
13 Away
15 Full Power
31 Manufacturer Specific

Setpoint (heat)

Precision 0,1 and 2 Scale Celsius and Fahrenheit Temp. Range 8°C-28°C

Sets the thermostate setpoint.

The thermostat_setpoint channel supports the Number item and is in the Temperature category.

Setpoint (energy heat)

Precision 0,1 and 2 Scale Celsius and Fahrenheit Temp. Range 8°C-28°C

Sets the thermostate setpoint.

The thermostat_setpoint channel supports the Number item and is in the Temperature category.

Alarm (system)

Indicates if a system alarm is triggered.

The alarm_system channel supports the Switch item. This is a read only channel so will only be updated following state changes from the device.

The following state translation is provided for this channel to the Switch item type -:

Value Label
OFF Ok
ON Alarm

Alarm (power)

Indicates if a power alarm is triggered.

The alarm_power channel supports the Switch item and is in the Door category. This is a read only channel so will only be updated following state changes from the device.

The following state translation is provided for this channel to the Switch item type -:

Value Label
OFF Ok
ON Alarm

Battery Level

Represents the battery level as a percentage (0-100%). Bindings for things supporting battery level in a different format (e.g. 4 levels) should convert to a percentage to provide a consistent battery level reading.

The battery-level channel supports the Number item and is in the Battery category.

Device Configuration

The following table provides a summary of the 8 configuration parameters available in the Spirit. Detailed information on each parameter can be found in the sections below.

Param Name Description
1 LCD Invert LCD Invert
2 LCD Timeout LCD Timeout
3 Backlight Backlight
4 Battery report Battery report
5 Measured Temperature report Measured Temperature report
6 Valve opening percentage report Valve opening percentage report
7 Window open detection Window open detection
8 Measured Temperature offset Measured Temperature offset

Parameter 1: LCD Invert

LCD Invert

The following option values may be configured -:

Value Description
0 LCD-content normal
1 LCD-content inverted (UK Edition)

The manufacturer defined default value is 0 (LCD-content normal ).

This parameter has the configuration ID config_1_1 and is of type INTEGER.

Parameter 2: LCD Timeout

LCD Timeout 0: No Timeout LCD always on

5-30: LCD will turn off after 5 to 30 seconds The following option values may be configured, in addition to values in the range 5 to 30 -:

Value Description
0 No Timeout LCD always on

The manufacturer defined default value is 0 (No Timeout LCD always on).

This parameter has the configuration ID config_2_1 and is of type INTEGER.

Parameter 3: Backlight

Backlight

The following option values may be configured -:

Value Description
0 Backlight disabled
1 Backlight enabled

The manufacturer defined default value is 1 (Backlight enabled).

This parameter has the configuration ID config_3_1 and is of type INTEGER.

Parameter 4: Battery report

Battery report

The following option values may be configured -:

Value Description
0 system notification
1 Send battery status unsolicited once a day.

The manufacturer defined default value is 1 (Send battery status unsolicited once a day. ).

This parameter has the configuration ID config_4_1 and is of type INTEGER.

Parameter 5: Measured Temperature report

Measured Temperature report 0: Unsolicited Temperature reporting disabled

1-50: report if temperature changed by delta = 0,1°C … 5,0 °C

default 5: report on delta T = 0,5°C Values in the range 0 to 50 may be set.

The manufacturer defined default value is 5.

This parameter has the configuration ID config_5_1 and is of type INTEGER.

Parameter 6: Valve opening percentage report

Valve opening percentage report 0: Unsolicited valve opening percentage reporting disabled.

1-100: report if valve opening changed by delta = 1% … 100% Values in the range 0 to 100 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_6_1 and is of type INTEGER.

Parameter 7: Window open detection

Window open detection

The following option values may be configured -:

Value Description
0 Disabled
1 Sensitivity low
2 Sensitivity medium
3 Sensitivity high

The manufacturer defined default value is 2 (Sensitivity medium).

This parameter has the configuration ID config_7_1 and is of type INTEGER.

Parameter 8: Measured Temperature offset

Measured Temperature offset -50 - +50: Offsets the measured temperature by-5,0°C – (+)5,0°C

128: External temperature sensor will be used for regulation. The following option values may be configured, in addition to values in the range -50 to 50 -:

Value Description
128 External temperature sensor will be used for regulation.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_8_1 and is of type INTEGER.

Association Groups

Association groups allow the device to send unsolicited reports to the controller, or other devices in the network. Using association groups can allow you to eliminate polling, providing instant feedback of a device state change without unnecessary network traffic.

The Spirit supports 1 association group.

Group 1: Lifeline

Spirit Z-Wave Plus can only be associated with the Z-Wave controller. This group supports 1 nodes.

Technical Information

Endpoints

Endpoint 0

Command Class Comment
COMMAND_CLASS_NO_OPERATION_V1  
COMMAND_CLASS_BASIC_V1  
COMMAND_CLASS_SWITCH_MULTILEVEL_V1  
COMMAND_CLASS_SENSOR_MULTILEVEL_V5  
COMMAND_CLASS_THERMOSTAT_MODE_V3  
COMMAND_CLASS_THERMOSTAT_SETPOINT_V3  
COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1  
COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1  
COMMAND_CLASS_ZWAVEPLUS_INFO_V1  
COMMAND_CLASS_CONFIGURATION_V1  
COMMAND_CLASS_ALARM_V8  
COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1  
COMMAND_CLASS_POWERLEVEL_V1  
COMMAND_CLASS_PROTECTION_V1  
COMMAND_CLASS_FIRMWARE_UPDATE_MD_V3  
COMMAND_CLASS_BATTERY_V1  
COMMAND_CLASS_ASSOCIATION_V2  
COMMAND_CLASS_VERSION_V2  
COMMAND_CLASS_SECURITY_V0  

Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.