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.

DSI-101 binary switch DSI-101 binary switch

This describes the Z-Wave device DSI-101 binary switch, manufactured by Defaro with the thing type UID of defaro_dsi101_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.

DSI-101 binary switch product image

The DSI-101 binary switch 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.

The DSI-101 binary switch does not permanently listen for messages sent from the controller - it will periodically wake up automatically to check if the controller has messages to send, but will sleep most of the time to conserve battery life. The wakeup period can be configured in the user interface - it is advisable not to make this too short as it will impact battery life - a reasonable compromise is 1 hour. The wakeup period does not impact the devices ability to report events or sensor data. The device can be manually woken with a button press on the device as described below - note that triggering a device to send an event is not the same as a wakeup notification, and this will not allow the controller to communicate with the device.

Overview

https://defaro.ru/index.php/support/instructions/208-dsi-101

Inclusion Information

1. Set controller in inclusion mode

2. Press button on the device for three seconds

Exclusion Information

1. Set controller in exclusion mode

2. Press button on the device for three seconds

Wakeup Information

Press button on the device once.

Channels

The following table summarises the channels available for the DSI-101 binary switch -:

Channel Channel Id Category Item Type
Scene Number scene_number   Number
Central scene number meter_current Energy Number
Battery Level battery-level Battery Number

Scene Number

Triggers when a scene button is pressed.

The scene_number channel supports the Number item.

Central scene number

Never fired off due to the firmware bug, had to add SCENE_ACTIVATION manually

Indicates the instantaneous current consumption.

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

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 23 configuration parameters available in the DSI-101 binary switch. Detailed information on each parameter can be found in the sections below.

Param Name Description
1 B1 operation mode B1 operation mode
2 B2 operation mode B2 operation mode
3 B3 operation mode B3 operation mode
4 B4 operation mode B4 operation mode
5 B5 operation mode B5 operation mode
6 B6 operation mode B6 operation mode
7 B7 operation mode B7 operation mode
8 B8 operation mode B8 operation mode
9 Long press delay Delay for long press detection
10 B1 value for AG 11 B1 value to send for AG 11
11 B2 value to send B2 value to send for AG 12
12 B3 value to send for AG 13 B3 value to send for AG 13
13 B4 value to send B4 value to send for AG 14
14 B5 value to send B5 value to send for AG 15
15 B6 value to send B6 value to send for AG 16
16 B7 value to send B7 value to send for AG 17
17 B8 value to send B8 value to send for AG 18
20 Sensor 1 turn on value Sensor 1 turn on value for AG 19
21 Sensor 1 command off value Sensor 1 command off value for AG19
22 Sensor 1 conversion rules Sensor 1 conversion rules
23 Sensor 2 command on value Sensor 2 command on value for AG 20
24 Sensor 2 command off value Sensor 2 command off value for AG 20
25 Sensor 2 conversion rules Sensor 2 conversion rules
  Wakeup Interval Sets the interval at which the device will accept commands from the controller
  Wakeup Node Sets the node ID of the device to receive the wakeup notifications

Parameter 1: B1 operation mode

B1 operation mode 0 - Turn off for short press/Dim down for hold (monostable switch)

1 - Turn on for short press/Dim up for hold (monostable switch)

2 - Bistable switch

3 - Scene activation mode

4 - Monostable switch. Each press/hold switches on/off/sends dim up/down state for devices from AG 3 or 11 (only first device from this AG is supported!)

5 - Bistable switch for devices from AG 3 or 11 (only first device from this AG is supported!) Values in the range 0 to 5 may be set.

The manufacturer defined default value is 0.

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

Parameter 2: B2 operation mode

B2 operation mode 0 - Turn off for short press/Dim down for hold (monostable switch)

1 - Turn on for short press/Dim up for hold (monostable switch)

2 - Bistable switch

3 - Scene activation mode

4 - Monostable switch. Each press/hold switches on/off/sends dim up/down state for devices from AG 4 or 12 (only first device from this AG is supported!)

5 - Bistable switch for devices from AG 4 or 12 (only first device from this AG is supported) Values in the range 0 to 5 may be set.

The manufacturer defined default value is 0.

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

Parameter 3: B3 operation mode

B3 operation mode 0 - Turn off for short press/Dim down for hold (monostable switch)

1 - Turn on for short press/Dim up for hold (monostable switch)

2 - Bistable switch

3 - Scene activation mode

4 - Monostable switch. Each press/hold switches on/off/sends dim up/down state for devices from AG 5 or 13 (only first device from this AG is supported!)

5 - Bistable switch for devices from AG 5 or 13 (only first device from this AG is supported) Values in the range 0 to 5 may be set.

The manufacturer defined default value is 0.

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

Parameter 4: B4 operation mode

B4 operation mode 0 - Turn off for short press/Dim down for hold (monostable switch)

1 - Turn on for short press/Dim up for hold (monostable switch)

2 - Bistable switch

3 - Scene activation mode

4 - Monostable switch. Each press/hold switches on/off/sends dim up/down state for devices from AG 4 or 12 (only first device from this AG is supported!)

5 - Bistable switch for devices from AG 4 or 12 (only first device from this AG is supported) Values in the range 0 to 5 may be set.

The manufacturer defined default value is 0.

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

Parameter 5: B5 operation mode

B5 operation mode 0 - Turn off for short press/Dim down for hold (monostable switch)

1 - Turn on for short press/Dim up for hold (monostable switch)

2 - Bistable switch

3 - Scene activation mode

4 - Monostable switch. Each press/hold switches on/off/sends dim up/down state for devices from AG 7 or 15 (only first device from this AG is supported!)

5 - Bistable switch for devices from AG 7 or 15 (only first device from this AG is supported) Values in the range 0 to 5 may be set.

The manufacturer defined default value is 0.

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

Parameter 6: B6 operation mode

B6 operation mode 0 - Turn off for short press/Dim down for hold (monostable switch)

1 - Turn on for short press/Dim up for hold (monostable switch)

2 - Bistable switch

3 - Scene activation mode

4 - Monostable switch. Each press/hold switches on/off/sends dim up/down state for devices from AG 8 or 16 (only first device from this AG is supported!)

5 - Bistable switch for devices from AG 8 or 16 (only first device from this AG is supported) Values in the range 0 to 5 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: B7 operation mode

B7 operation mode 0 - Turn off for short press/Dim down for hold (monostable switch)

1 - Turn on for short press/Dim up for hold (monostable switch)

2 - Bistable switch

3 - Scene activation mode

4 - Monostable switch. Each press/hold switches on/off/sends dim up/down state for devices from AG 9 or 17 (only first device from this AG is supported!)

5 - Bistable switch for devices from AG 9 or 17 (only first device from this AG is supported) Values in the range 0 to 5 may be set.

The manufacturer defined default value is 0.

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

Parameter 8: B8 operation mode

B8 operation mode 0 - Turn off for short press/Dim down for hold (monostable switch)

1 - Turn on for short press/Dim up for hold (monostable switch)

2 - Bistable switch

3 - Scene activation mode

4 - Monostable switch. Each press/hold switches on/off/sends dim up/down state for devices from AG 10 or 18 (only first device from this AG is supported!)

5 - Bistable switch for devices from AG 10 or 18 (only first device from this AG is supported) Values in the range 0 to 5 may be set.

The manufacturer defined default value is 0.

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

Parameter 9: Long press delay

Delay for long press detection In 1/10 of sec Values in the range 1 to 50 may be set.

The manufacturer defined default value is 5.

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

Parameter 10: B1 value for AG 11

B1 value to send for AG 11 Value to send to AG 11 (0 - disable this functionality) Values in the range 0 to 99 may be set.

The manufacturer defined default value is 0.

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

Parameter 11: B2 value to send

B2 value to send for AG 12 Value to send to AG 12 (0 - disable this functionality) Values in the range 0 to 99 may be set.

The manufacturer defined default value is 0.

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

Parameter 12: B3 value to send for AG 13

B3 value to send for AG 13 Value to send to AG 13 (0 - disable this functionality) Values in the range 0 to 99 may be set.

The manufacturer defined default value is 0.

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

Parameter 13: B4 value to send

B4 value to send for AG 14 Value to send to AG 14 (0 - disable this functionality) Values in the range 0 to 99 may be set.

The manufacturer defined default value is 0.

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

Parameter 14: B5 value to send

B5 value to send for AG 15 Value to send to AG 15 (0 - disable this functionality) Values in the range 0 to 99 may be set.

The manufacturer defined default value is 0.

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

Parameter 15: B6 value to send

B6 value to send for AG 16 Value to send to AG 16 (0 - disable this functionality) Values in the range 0 to 99 may be set.

The manufacturer defined default value is 0.

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

Parameter 16: B7 value to send

B7 value to send for AG 17 Value to send to AG 17 (0 - disable this functionality) Values in the range 0 to 99 may be set.

The manufacturer defined default value is 0.

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

Parameter 17: B8 value to send

B8 value to send for AG 18 Value to send to AG 18 (0 - disable this functionality) Values in the range 0 to 99 may be set.

The manufacturer defined default value is 0.

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

Parameter 20: Sensor 1 turn on value

Sensor 1 turn on value for AG 19

Values in the range -60 to 1000 may be set.

The manufacturer defined default value is 0.

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

Parameter 21: Sensor 1 command off value

Sensor 1 command off value for AG19

Values in the range -60 to 1000 may be set.

The manufacturer defined default value is 0.

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

Parameter 22: Sensor 1 conversion rules

Sensor 1 conversion rules All commands are sent to devices in AG 19

0 - ignore sensor value

1 - send ON if Value <= Param20 and send OFF if Value >= Param21

2 - send OFF if Value <= Param21 and send ON if Value >= Param20

3 - send ON if Value <= Param20

4 - send ON if Value >= Param20

5 - send OFF if Value >= Param21

6 - send OFF if Value <= Param21 Values in the range 0 to 6 may be set.

The manufacturer defined default value is 0.

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

Parameter 23: Sensor 2 command on value

Sensor 2 command on value for AG 20

Values in the range -60 to 1000 may be set.

The manufacturer defined default value is 0.

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

Parameter 24: Sensor 2 command off value

Sensor 2 command off value for AG 20

Values in the range -60 to 1000 may be set.

The manufacturer defined default value is 0.

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

Parameter 25: Sensor 2 conversion rules

Sensor 2 conversion rules All commands are sent to devices in AG 20

0 - ignore sensor value

1 - send ON if Value <= Param23 and send OFF if Value >= Param24

2 - send OFF if Value <= Param24 and send ON if Value >= Param23

3 - send ON if Value <= Param23

4 - send ON if Value >= Param23

5 - send OFF if Value >= Param24

6 - send OFF if Value <= Param24 Values in the range 0 to 6 may be set.

The manufacturer defined default value is 0.

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

Wakeup Interval

The wakeup interval sets the period at which the device will listen for messages from the controller. This is required for battery devices that sleep most of the time in order to conserve battery life. The device will wake up at this interval and send a message to the controller to tell it that it can accept messages - after a few seconds, it will go back to sleep if there is no further communications.

This setting is defined in seconds. It is advisable not to set this interval too short or it could impact battery life. A period of 1 hour (3600 seconds) is suitable in most instances.

Note that this setting does not affect the devices ability to send sensor data, or notification events.

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

Wakeup Node

When sleeping devices wake up, they send a notification to a listening device. Normally, this device is the network controller, and normally the controller will set this automatically to its own address. In the event that the network contains multiple controllers, it may be necessary to configure this to a node that is not the main controller. This is an advanced setting and should not be changed without a full understanding of the impact.

This parameter has the configuration ID wakeup_node 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 DSI-101 binary switch supports 20 association groups.

Group 1: Battery level

This group supports 3 nodes.

Group 2: Scene activation set

This group supports 3 nodes.

Group 3: On/Off command for switch 1

This group supports 10 nodes.

Group 4: On/Off command for switch 2

This group supports 10 nodes.

Group 5: On/Off command for switch 3

This group supports 10 nodes.

Group 6: On/Off command for switch 4

This group supports 10 nodes.

Group 7: On/Off command for switch 5

This group supports 10 nodes.

Group 8: On/Off command for switch 6

This group supports 10 nodes.

Group 9: On/Off command for switch 7

This group supports 10 nodes.

Group 10: On/Off command for switch 8

This group supports 10 nodes.

Group 11: Dim command for switch 1

This group supports 10 nodes.

Group 12: Dim command for switch 2

This group supports 10 nodes.

Group 13: Dim command for switch 3

This group supports 10 nodes.

Group 14: Dim command for switch 4

This group supports 10 nodes.

Group 15: Dim command for switch 5

This group supports 10 nodes.

Group 16: Dim command for switch 6

This group supports 10 nodes.

Group 17: Dim command for switch 7

This group supports 10 nodes.

Group 18: Dim command for switch 8

This group supports 10 nodes.

Group 19: Sensor 1 group

This group supports 5 nodes.

Group 20: Sensor 2 group

This group supports 5 nodes.

Technical Information

Endpoints

Endpoint 0

Command Class Comment
COMMAND_CLASS_NO_OPERATION_V1  
COMMAND_CLASS_BASIC_V1  
COMMAND_CLASS_SCENE_ACTIVATION_V0  
COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1  
COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1  
COMMAND_CLASS_CENTRAL_SCENE_V0  
COMMAND_CLASS_ZWAVEPLUS_INFO_V1  
COMMAND_CLASS_CONFIGURATION_V1  
COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1  
COMMAND_CLASS_POWERLEVEL_V0  
COMMAND_CLASS_FIRMWARE_UPDATE_MD_V1  
COMMAND_CLASS_BATTERY_V1  
COMMAND_CLASS_WAKE_UP_V2  
COMMAND_CLASS_ASSOCIATION_V1  
COMMAND_CLASS_VERSION_V1  
COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V2  

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