| layout | title |
|---|---|
documentation |
DSI-101 binary switch - ZWave |
{% include base.html %}
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.
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. Refer to the Wakeup Information section below for further information.
https://defaro.ru/index.php/support/instructions/208-dsi-101
-
Set controller in inclusion mode
-
Press button on the device for three seconds
-
Set controller in exclusion mode
-
Press button on the device for three seconds
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.
Press button on the device once.
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 |
Triggers when a scene button is pressed.
The scene_number channel supports the Number item.
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.
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.
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 |
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 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.
Association group 1 supports 3 nodes.
Scene Ids:
<td>
B1
</td>
<td>
B2
</td>
<td>
B3
</td>
<td>
B4
</td>
<td>
B5
</td>
<td>
B6
</td>
<td>
B7
</td>
<td>
B8
</td>
<td>
10
</td>
<td>
20
</td>
<td>
30
</td>
<td>
40
</td>
<td>
50
</td>
<td>
60
</td>
<td>
70
</td>
<td>
80
</td>
| Button |
| SceneID |
Association group 2 supports 3 nodes.
Association group 3 supports 10 nodes.
Association group 4 supports 10 nodes.
Association group 5 supports 10 nodes.
Association group 6 supports 10 nodes.
Association group 7 supports 10 nodes.
Association group 8 supports 10 nodes.
Association group 9 supports 10 nodes.
Association group 10 supports 10 nodes.
Association group 11 supports 10 nodes.
Association group 12 supports 10 nodes.
Association group 13 supports 10 nodes.
Association group 14 supports 10 nodes.
Association group 15 supports 10 nodes.
Association group 16 supports 10 nodes.
Association group 17 supports 10 nodes.
Association group 18 supports 10 nodes.
Association group 19 supports 5 nodes.
Association group 20 supports 5 nodes.
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_NO_OPERATION_V1 | |
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_SCENE_ACTIVATION_V1 | |
| COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1 | |
| COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1 | |
| COMMAND_CLASS_CENTRAL_SCENE_V1 | |
| COMMAND_CLASS_ZWAVEPLUS_INFO_V1 | |
| COMMAND_CLASS_CONFIGURATION_V1 | |
| COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1 | |
| COMMAND_CLASS_POWERLEVEL_V1 | |
| 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.