openhab-docs/_addons_bindings/zwave/doc/widom/dry700_0_0.md

20 KiB

layout title
documentation DRY700 - ZWave

{% include base.html %}

DRY700 WiDom Smart Dry Contact Switch 7

This describes the Z-Wave device DRY700, manufactured by wiDom with the thing type UID of widom_dry700_00_000.

The device is in the category of Wall Switch, defining Any device attached to the wall that controls a binary status of something, for ex. a light switch.

DRY700 product image

The DRY700 supports routing. This allows the device to communicate using other routing enabled devices as intermediate routers. This device is also able to participate in the routing of data between other devices in the mesh network.

Overview

The Smart Dry Contact Switch 7 can turn ON and OFF equipments with an independent power supply, such as solenoid valves (e.g. gas, water and irrigation), power operated valves, etc.

It is very easy to install and works with both momentary and toggle switches.

It operates in any Z-Wave network with other Z-Wave/Z-Wave Plus certified devices and controllers from any other manufacturer. As a constantly powered node, the device will act as repeater regardless of the vendor in order to increase the reliability of the network.

This device is a security enabled Z-Wave Plus product that is able to use encrypted Z-Wave Plus messages to communicate to other security enabled Z-Wave Plus products. It must be used in conjunction with a Security Enabled Z-Wave Controller in order to fully utilize all implemented functions.

The device has the unique feature Offline setup Mode that allows to configure some parameters without using any user interface. This feature enables the professional user to setup the main features of the device in the field even if the device is not included in a Z-Wave Network. When the device will be included in the network all these configuration parameters will be maintained.

Inclusion Information

All Smart Series 7 devices are compatible with all Z-Wave/Z-Wave Plus certified controllers. The devices support both the Network Wide Inclusion mechanism (which offers the ability to be included in a network, even if the device is not directly connected to the controller) and Normal Inclusion.

By default, the inclusion procedure starts in Normal Inclusion mode and after a short timeout the procedure continues in Network Wide Inclusion mode that lasts for about 20 Seconds.

Only a controller can add the device into the network. After activating the inclusion function by the controller, the device can be added by setting it in Learn Mode.

Before including the device, the LED status indicator is solid RED. The adding of a device is executed by activating the adding procedure in the inclusion section of the controller interface and executing 1 or 3 click on the integrated button (the device is set in Learn Mode). As soon as the inclusion procedure initiates the LED indicator starts a sequence of GREEN-BLUE blinks. The device is included in the network when the LED status is OFF and the interview is completed.

Exclusion Information

Only a controller can remove the device from the network. After activating the exclusion function by the controller, the device can be removed by setting it in Learn Mode.

The procedure of exclusion can be activated by Removing a node from the Z-Wave network and executing 1 or 3 click on the integrated button; as soon as the exclusion initiates, the LED indicator starts a sequence of RED-BLUE blinks. The device is excluded from the network when the LED status indicator is solid RED.

General Usage Information

For the operation of the device within the Z-Wave network and controlling the loads connected to the device, control actions are performed on the switch.

The CONTROL ACTIONS are EVENTS executed on the **EXTERNAL SWITCH **connected to the Line Signal terminal of the device which can be Clicks, Hold Down and Up.

Event: Click, type of switch: momentary switch (button), actions on the switch: press briefly and release (when pressed it autonomously returns to the initial position)

Event: Click, type of switch: toggle switch (bistable), actions on the switch: press and release (single click means one single flip of the switch)

Event: MultiClick = n clicks, type of switch: momentary switch or toggle switch, actions on the switch: sequence of consecutive n clicks

Event: Hold Down, type of switch: momentary switch, actions on the switch: press longer than click (after a Hold Down always follows an Up event)

Event: Up, type of switch: momentary switch, actions on the switch: release (the event applies only if there has been a previous Hold Down event)

Since the device supports Central Scene Notification all the events described here will be notified with a Central Scene Notification Report to the lifeline. The events that trigger a Central Scene Notification Report can be customized with the configuration parameter in the Central Scene Notification Parameter section.

Channels

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

Channel Name Channel ID Channel Type Category Item Type
Switch switch_binary switch_binary Switch Switch

Switch

Switch the power on and off.

The switch_binary channel is of type switch_binary and supports the Switch item and is in the Switch category.

Device Configuration

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

Param Name Description
1 IN_TYPE Input type
10 IN_TOGGLE Which event on the input toggle the output
11 IN_ON_EXCLUSION Which events on the input do not switch on the output
12 IN_OFF_EXCLUSION Which events on the input do not switch off the output
21 OUT_TYPE Type of the output
23 STARTUP_OUT Level of the output on startup (status of the device following a restart)
30 TIMER_SETUP Which trigger events activate the timers when the output status has changed
31 OFF_TIMEOUT Time after which the output will be switched off
32 ON_TIMEOUT Time after which the output will be switched on
40 G1_SETUP Which events on the input control G1 association group
41 G2_SETUP Which events on the input control G2 association group
44 G1_ASS_VALUE Value used to control G1 association group
45 G2_ASS_VALUE Value used to control G2 association group
50 DIMMING_TIME Fade On/Off time to control device in dimming group
51 MIN_DIM_LEVEL Minimum dimming level to control the device in a dimming group
60 SCENE_SETUP Which event on the input trigger a central scene notification

Parameter 1: IN_TYPE

Input type This parameter defines the type of the input. The following option values may be configured, in addition to values in the range 0 to 2 -:

Value Description
0 No switch input
1 Momentary switch (button)
2 Toggle switch

The manufacturer defined default value is 1 (Momentary switch (button)).

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

Parameter 10: IN_TOGGLE

Which event on the input toggle the output This parameter defines which events on the input toggle the output:

****: Disabled

1: 1 click

2: 2 clicks

4: 3 clicks

8: Hold down

16: Up

If more than one event must be supported, the value for the configuration parameter is the sum of the event values. For example:

1 click and 2 clicks → Parameter value must be 1 + 2 = 3

1 click and 3 clicks → Parameter value must be 1 + 4 = 5

Default Value: 1 click, 2 clicks, 3 clicks, Hold down → 15 The following option values may be configured -:

Value Description
0 Disabled
1 1 click
2 2 clicks
4 3 clicks
8 Hold down
16 Up

The manufacturer defined default value is 15.

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

Parameter 11: IN_ON_EXCLUSION

Which events on the input do not switch on the output This parameter defines which events on the input do not switch on the output:

****: Disabled

1: 1 click

2: 2 clicks

4: 3 clicks

8: Hold down

16: Up

If more than one event must be supported, the value for the configuration parameter is the sum of the event values. For example:

1 click and 2 clicks → Parameter value must be 1 + 2 = 3

1 click and 3 clicks → Parameter value must be 1 + 4 = 5

Default Value: Disabled → 0 The following option values may be configured -:

Value Description
0 Disabled
1 1 click
2 2 clicks
4 3 clicks
8 Hold down
16 Up

The manufacturer defined default value is 0 (Disabled).

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

Parameter 12: IN_OFF_EXCLUSION

Which events on the input do not switch off the output This parameter defines which events on the input do not switch off the output:

****: Disabled

1: 1 click

2: 2 clicks

4: 3 clicks

8: Hold down

16: Up

If more than one event must be supported, the value for the configuration parameter is the sum of the event values. For example:

1 click and 2 clicks → Parameter value must be 1 + 2 = 3

1 click and 3 clicks → Parameter value must be 1 + 4 = 5

Default Value: Disabled → 0 The following option values may be configured -:

Value Description
0 Disabled
1 1 click
2 2 clicks
4 3 clicks
8 Hold down
16 Up

The manufacturer defined default value is 0 (Disabled).

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

Parameter 21: OUT_TYPE

Type of the output This parameter defines the type of the output. The following option values may be configured, in addition to values in the range 0 to 1 -:

Value Description
0 Direct load or Normally Open relay
1 Normally Closed relay

The manufacturer defined default value is 0 (Direct load or Normally Open relay).

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

Parameter 23: STARTUP_OUT

Level of the output on startup (status of the device following a restart) This parameter defines the level of the output on startup (status of the device following a restart). The following option values may be configured, in addition to values in the range 0 to 3 -:

Value Description
0 Off
1 On
2 Previous status
3 Equal to input (ON if input closed, OFF if input open)

The manufacturer defined default value is 2 (Previous status).

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

Parameter 30: TIMER_SETUP

Which trigger events activate the timers when the output status has changed This parameter defines which trigger events activate the timers when output status has changed:

****: Disabled

1: 1 click

2: 2 clicks

4: 3 clicks

8: Hold down

16: Up

32: Network (status change triggered by gateway or other devices in the Z-Wave network)

64: System (based on the startup status, or other timer event)

If more than one event must be supported, the value for the configuration parameter is the sum of the event values. For example, to control the load with 1 click and 2 clicks, parameter value must be 1 + 2 = 3

Default value: Disabled → 0 The following option values may be configured -:

Value Description
0 Disabled
1 1 click
2 2 clicks
4 3 clicks
8 Hold down
16 Up
32 Network
64 System

The manufacturer defined default value is 0 (Disabled).

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

Parameter 31: OFF_TIMEOUT

Time after which the output will be switched off This parameter defines the time in tenths of seconds after which the output will be switched off. Values in the range 0 to 360000 may be set.

The manufacturer defined default value is 0.

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

Parameter 32: ON_TIMEOUT

Time after which the output will be switched on This parameter defines the time in tenths of seconds after which the output will be switched on. Values in the range 0 to 360000 may be set.

The manufacturer defined default value is 0.

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

Parameter 40: G1_SETUP

Which events on the input control G1 association group This parameter defines which events on the input control G1 association group:

****: No control

1: 1 click

2: 2 clicks

4: 3 clicks

8: Hold down

16: Up

If more than one event must be supported, the value for the configuration parameter is the sum of the event values. For example:

1 click and 2 clicks → Parameter value must be 1 + 2 = 3

1 click and 3 clicks → Parameter value must be 1 + 4 = 5

Default value: 1 click → 1 The following option values may be configured -:

Value Description
0 No control
1 1 click
2 2 clicks
4 3 clicks
8 Hold down
16 Up

The manufacturer defined default value is 1 (1 click).

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

Parameter 41: G2_SETUP

Which events on the input control G2 association group This parameter defines which events on the input control G2 association group:

****: No control

1: 1 click

2: 2 clicks

4: 3 clicks

8: Hold down

16: Up

If more than one event must be supported, the value for the configuration parameter is the sum of the event values. For example:

1 click and 2 clicks → Parameter value must be 1 + 2 = 3

1 click and 3 clicks → Parameter value must be 1 + 4 = 5

Default value: 2 clicks → 2 The following option values may be configured -:

Value Description
0 No control
1 1 click
2 2 clicks
4 3 clicks
8 Hold down
16 Up

The manufacturer defined default value is 2 (2 clicks).

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

Parameter 44: G1_ASS_VALUE

Value used to control G1 association group This parameter defines the value used to control G1 association group:

****: OFF

1-99: Specific dimming value

100: ON

101: Propagate (output status to the associated devices)

102: Toggle remote (change status ON/OFF of associated devices) The following option values may be configured -:

Value Description
0 Off
100 On
101 Propagate
102 Toggle remote

The manufacturer defined default value is 101 (Propagate).

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

Parameter 45: G2_ASS_VALUE

Value used to control G2 association group This parameter defines the value used to control G2 association group:

****: OFF

1-99: Specific dimming value

100: ON

101: Propagate (output status to the associated devices)

102: Toggle remote (change status ON/OFF of associated devices) The following option values may be configured -:

Value Description
0 Off
100 On
101 Propagate
102 Toggle remote

The manufacturer defined default value is 101 (Propagate).

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

Parameter 50: DIMMING_TIME

Fade On/Off time to control device in dimming group Fade On/Off time in seconds used to control device in dimming group. Values in the range 0 to 3600 may be set.

The manufacturer defined default value is 5.

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

Parameter 51: MIN_DIM_LEVEL

Minimum dimming level to control the device in a dimming group This parameter defines the minimum dimming level to control the device in a dimming group. Values in the range 1 to 99 may be set.

The manufacturer defined default value is 1.

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

Parameter 60: SCENE_SETUP

Which event on the input trigger a central scene notification This parameter defines which event on the input trigger a central scene notification:

****: None

1: 1 click

2: 2 clicks

4: 3 clicks

8: Hold down

16: Up

If more than one event must be supported, the value for the configuration parameter is the sum of the event values. For example:

1 click and 2 clicks → Parameter value must be 1 + 2 = 3

1 click and 3 clicks → Parameter value must be 1 + 4 = 5

Default value: all events → 31 The following option values may be configured -:

Value Description
0 None
1 1 click
2 2 clicks
4 3 clicks
8 Hold down
16 Up

The manufacturer defined default value is 31.

This parameter has the configuration ID config_60_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 DRY700 supports 5 association groups.

Group 1: Lifeline

The Lifeline association group reports device status to a hub and is not designed to control other devices directly. When using the Lineline group with a hub, in most cases, only the lifeline group will need to be configured and normally the hub will perform this automatically during the device initialisation. Life Line Group

Association group 1 supports 8 nodes.

Group 2: Follow me

The state of the output (ON/OFF) will be propagated to the associated device

Association group 2 supports 8 nodes.

Group 3: Clicks on button G1

Association group 3 supports 8 nodes.

Group 4: Clicks on button G2

Association group 4 supports 8 nodes.

Group 5: Dimming group

The devices will be controlled by dimming commands

Association group 5 supports 8 nodes.

Technical Information

Endpoints

Endpoint 0

Command Class Comment
COMMAND_CLASS_NO_OPERATION_V1
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_APPLICATION_STATUS_V1
COMMAND_CLASS_SWITCH_BINARY_V1
COMMAND_CLASS_TRANSPORT_SERVICE_V1
COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1
COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1
COMMAND_CLASS_CENTRAL_SCENE_V3
COMMAND_CLASS_ZWAVEPLUS_INFO_V1
COMMAND_CLASS_SUPERVISION_V1
COMMAND_CLASS_CONFIGURATION_V1
COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1
COMMAND_CLASS_POWERLEVEL_V1
COMMAND_CLASS_FIRMWARE_UPDATE_MD_V1
COMMAND_CLASS_ASSOCIATION_V2
COMMAND_CLASS_VERSION_V2
COMMAND_CLASS_INDICATOR_V3
COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V3
COMMAND_CLASS_SECURITY_2_V1

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