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

25 KiB

layout title
documentation EDSC700 - ZWave

{% include base.html %}

EDSC700 WiDom Energy Driven Switch C 7

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

The device is in the category of Power Outlet, defining Small devices to be plugged into a power socket in a wall which stick there.

EDSC700 product image

The EDSC700 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 Energy Driven Switch C 7 is a device designed to monitor all parameters, usage, faults and overloads of your electrical system. Unlike ordinary energy meters, it is a bi-directional meter capable of measuring both the consumed and produced power, equipped with a relay that can be activated to initiate specific scenarios in relation to detected power levels.

The device is equipped with an external current transformer and can measure powers over 10 KW.

• Active Energy-saving management

Automatically connects and disconnects a specific load if the established threshold limit is exceeded, or supplies the required power, momentarily excluding non-priority loads.

• Management and prevention of electrical faults

Identifies malfunctions based on irregular consumption and to the maximum time of activity.

• Electrical overload management

Notifies or disconnects non-priority loads in the eventuality of system overloads.

Similarly to the other Smart Series 7 devices, it can be fully integrated into pre-existing systems and configured in full integration with the Z-Wave home automation ecosystem.

At the same time, it is completely configurable so that it can adapt to the most varied needs while also being ready to be used without needing additional configurations in order to operate.

The device is equipped with contact protection technology (Zero Crossing) which reduces the electrical stress on the relay contacts and ensures a longer life. The open / closed switching of the device always occur when the instantaneous value of voltage is 0.

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.

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

The Energy Driven Switch C 7 can implement an active energy saving policy by managing electric loads in order to maximize the self-consumption during the greater production period of a wind power or photovoltaic plant, optimizing the net metering and the energy saving. Refer to the configuration section for the parameter details.

The system implements a control logic of the associated loads through load controlled directly by the integrated relay, and the association groups which is based on the following logic:

  • The Up Power G1 and Up Power G2 groups are controlled if an Up Power event occurs.

  • The Down Power G1 and Down Power G2 groups are controlled if a Down Power event occurs.

The Up Power and Down Power events are defined based on the power value above / below a certain level, over a certain period of time.

Both the power levels and the time thresholds of permanence are defined by the user.

In case the device recognizes an UP/DOWN Power event threshold, it tries to overcome the situation, by controlling in sequence the:

  1. Integrated relay

  2. UP/DOWN G1 group

  3. UP/DOWN G2 group

The command sent during the controlling sequence can be configured by the user as the first timeout generates the event and the next timeout passes at the next controlling step.

The Up/Down Power First Timeout is always to be considered as Local Control on the relay, even if the relay is not connected to a load.

The Up/Down Power Next Timeout is always to be considered for both G1 and G2 groups in sequence after the Local Up/Down Power First Timeout.

The minimum time after which the group that has been commanded can be re-commanded, is defined as Protection Time.

Channels

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

Channel Name Channel ID Channel Type Category Item Type
Electric meter (kWh) meter_kwh meter_kwh Energy Number
Electric meter (watts) meter_watts meter_watts Energy Number
Electric meter (volts) meter_voltage meter_voltage Energy Number
Electric meter (amps) meter_current meter_current Energy Number
Electric meter (power factor) meter_powerfactor meter_powerfactor Energy Number
Alarm (power) alarm_power alarm_power Energy Switch

Electric meter (kWh)

Indicates the energy consumption (kWh).

The meter_kwh channel is of type meter_kwh and 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.

Electric meter (watts)

Indicates the instantaneous power consumption.

The meter_watts channel is of type meter_watts and 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.

Electric meter (volts)

Indicates the instantaneous voltage.

The meter_voltage channel is of type meter_voltage and 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.

Electric meter (amps)

Indicates the instantaneous current consumption.

The meter_current channel is of type meter_current and 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.

Electric meter (power factor)

Indicates the instantaneous power factor.

The meter_powerfactor channel is of type meter_powerfactor and 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.

Alarm (power)

Indicates if a power alarm is triggered.

The alarm_power channel is of type alarm_power and supports the Switch item and is in the Energy 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

Device Configuration

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

Param Name Description
21 OUT_TYPE Output type
23 STARTUP_OUT Output level on startup
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 UP_POWER_LOCAL_CONTROL Value used to control the integrated Relay in case of Up Power event
41 DOWN_POWER_LOCAL_CONTROL Value used to control the integrated Relay in case of Down Power event
42 METER_TYPE How positive and negative power are treated
43 CT_TYPE Model of Current Transformer connected to the device
44 UP_POWER_REMOTE_CONTROL Value used to control Up Power Group
45 DOWN_POWER_REMOTE_CONTROL Value used to control Down Power Group
46 OVER_VOLTAGE_LIMIT Over Voltage Limit
47 DOWN_VOLTAGE_LIMIT Down Voltage Limit
50 UP_POWER_LEVEL Up Power level
51 UP_POWER_TYPE Up Power type
52 UP_POWER_FIRST_TIMEOUT Time of permanence above the Up Power level after which the first Up Power event occurs
53 UP_POWER_NEXT_TIMEOUT Time of permanence above the Up Power level after which the next Up Power event occurs
54 DOWN_POWER_LEVEL Down Power level
55 DOWN_POWER_TYPE Down Power type
56 DOWN_POWER_FIRST_TIMEOUT Time of permanence below the Down Power level after which the first Down Power event occurs
57 DOWN_POWER_NEXT_TIMEOUT Time of permanence below the Down Power level after which the next Down Power event occurs
58 PROTECTION_TIME Minimum time after which an Up/Down Power event can be triggered again
71 METER_REPORT_MAX_DELAY Maximum time after which the next Meter sequence report will be sent
75 METER_INSTANT_REPORT Percentage of Power change from the last sent report that triggers a new meter report
76 REPORT_CONFIG Which report scale will be sent

Parameter 21: OUT_TYPE

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

Value Description
0 Direct load control or normally open relay
1 Normally closed relay

The manufacturer defined default value is 0 (Direct load control or normally open relay).

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

Parameter 23: STARTUP_OUT

Output level on startup This parameter defines the output level on startup. The following option values may be configured, in addition to values in the range 0 to 2 -:

Value Description
0 Off
1 On
2 Previous status

The manufacturer defined default value is 0 (OFF).

This parameter has the configuration ID config_23_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 second after which the output will be switched off (0 → disabled). 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 second after which the output will be switched on (0 → disabled). 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: UP_POWER_LOCAL_CONTROL

Value used to control the integrated Relay in case of Up Power event This parameter defines the value used to control the integrated Relay in case of Up Power event. The following option values may be configured, in addition to values in the range 0 to 1 -:

Value Description
0 Off
1 On

The manufacturer defined default value is 1 (ON).

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

Parameter 41: DOWN_POWER_LOCAL_CONTROL

Value used to control the integrated Relay in case of Down Power event This parameter defines the value used to control the integrated Relay in case of Down Power event. The following option values may be configured, in addition to values in the range 0 to 1 -:

Value Description
0 Off
1 On

The manufacturer defined default value is 1 (ON).

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

Parameter 42: METER_TYPE

How positive and negative power are treated This parameter defines how positive and negative power are treated:

****: As is (the meter is connected in a bidirectional system and you want to measure consumed and produced energy)

1: Negative value is considered 0 (the meter is connected in a bidirectional system, but you are interested only in consumed energy)

2: Positive value is considered 0 (the meter is connected in a bidirectional system, but you are interested only in produced energy)

3: All values are considered positive (the meter is connected in a system that only consumes energy)

4: All values are considered negative (the meter is connected in a system that only produces energy) The following option values may be configured, in addition to values in the range 0 to 4 -:

Value Description
0 As is
1 Negative value is considered 0
2 Positive value is considered 0
3 All values are considered positive
4 All values are considered negative

The manufacturer defined default value is 3 (All values are considered positive).

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

Parameter 43: CT_TYPE

Model of Current Transformer connected to the device This parameter defines the model of Current Transformer connected to the device. The following option values may be configured, in addition to values in the range 1 to 2 -:

Value Description
1 Standard type
2 Type 2 version

The manufacturer defined default value is 1 (Standard type).

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

Parameter 44: UP_POWER_REMOTE_CONTROL

Value used to control Up Power Group This parameter defines the value used to control Up Power Group:

0-99: Specific value (where 0 equals OFF)

100: ON The following option values may be configured -:

Value Description
0 Off
100 On

The manufacturer defined default value is 0 (OFF).

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

Parameter 45: DOWN_POWER_REMOTE_CONTROL

Value used to control Down Power Group This parameter defines the value used to control Down Power Group:

0-99: Specific value (where 0 equals OFF)

100: ON The following option values may be configured -:

Value Description
0 Off
100 On

The manufacturer defined default value is 100 (ON).

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

Parameter 46: OVER_VOLTAGE_LIMIT

Over Voltage Limit This parameter defines the Over Voltage Limit in tenths of Volt (accepted values between 900 and 2530). Values in the range 900 to 2530 may be set.

The manufacturer defined default value is 2530.

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

Parameter 47: DOWN_VOLTAGE_LIMIT

Down Voltage Limit This parameter defines the Down Voltage Limit in tenths of Volt (accepted values between 900 and 2530). Values in the range 900 to 2530 may be set.

The manufacturer defined default value is 2070.

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

Parameter 50: UP_POWER_LEVEL

Up Power level This parameter sets the level of Watts beyond which time of permanence above this level is calculated:

****: Up Power event disabled

1-100000: Instantaneous power in Watts Values in the range 0 to 100000 may be set.

The manufacturer defined default value is 0.

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

Parameter 51: UP_POWER_TYPE

Up Power type This parameter defines if the Up Power is consumed or produced. The following option values may be configured, in addition to values in the range 0 to 1 -:

Value Description
0 Consumed
1 Produced

The manufacturer defined default value is 0 (Consumed).

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

Parameter 52: UP_POWER_FIRST_TIMEOUT

Time of permanence above the Up Power level after which the first Up Power event occurs This parameter defines the time of permanence in seconds above the Up Power level after which the first Up Power event occurs (accepted values are between 2 and 7200 seconds). Values in the range 2 to 7200 may be set.

The manufacturer defined default value is 30.

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

Parameter 53: UP_POWER_NEXT_TIMEOUT

Time of permanence above the Up Power level after which the next Up Power event occurs This parameter defines the time of permanence in seconds above the Up Power level after which the next Up Power event occurs (accepted values are between 2 and 7200 seconds). Values in the range 2 to 7200 may be set.

The manufacturer defined default value is 5.

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

Parameter 54: DOWN_POWER_LEVEL

Down Power level This parameter sets the level of Watts beyond which time of permanence below this level is calculated:

****: Down Power event disabled

1-100000: Instantaneous power in Watts Values in the range 0 to 100000 may be set.

The manufacturer defined default value is 0.

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

Parameter 55: DOWN_POWER_TYPE

Down Power type This parameter defines if the Down Power is consumed or produced. The following option values may be configured, in addition to values in the range 0 to 1 -:

Value Description
0 Consumed
1 Produced

The manufacturer defined default value is 0 (Consumed).

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

Parameter 56: DOWN_POWER_FIRST_TIMEOUT

Time of permanence below the Down Power level after which the first Down Power event occurs This parameter defines the time of permanence in seconds below the Down Power level after which the first Down Power event occurs (accepted values are between 2 and 7200 seconds). Values in the range 2 to 7200 may be set.

The manufacturer defined default value is 30.

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

Parameter 57: DOWN_POWER_NEXT_TIMEOUT

Time of permanence below the Down Power level after which the next Down Power event occurs This parameter defines the time of permanence in seconds below the Down Power level after which the next Down Power event occurs (accepted values are between 2 and 7200 seconds). Values in the range 2 to 7200 may be set.

The manufacturer defined default value is 5.

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

Parameter 58: PROTECTION_TIME

Minimum time after which an Up/Down Power event can be triggered again This parameter defines the minimum time in seconds after which an Up/Down Power event can be triggered again (accepted values are between 2 and 3600 seconds). Values in the range 2 to 3600 may be set.

The manufacturer defined default value is 60.

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

Parameter 71: METER_REPORT_MAX_DELAY

Maximum time after which the next Meter sequence report will be sent This parameter defines the maximum time in minutes after which the next Meter sequence report will be sent (accepted values are between 1 and 120 minutes). Values in the range 1 to 120 may be set.

The manufacturer defined default value is 10.

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

Parameter 75: METER_INSTANT_REPORT

Percentage of Power change from the last sent report that triggers a new meter report This parameter defines the percentage of Power change from the last sent report that triggers a new meter report sequence (accepted values are between 0 and 100, where 0 means that no report is sent, for any power change). Values in the range 0 to 100 may be set.

The manufacturer defined default value is 20.

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

Parameter 76: REPORT_CONFIG

Which report scale will be sent This parameter defines which report scale will be sent.

If more than one scale must be sent, the value of the configuration parameter is a sum of values.

For example:

Energy and Power reports → Parameter value must be 1 + 4 =5

Voltage and Current reports → Parameter value must be 16 + 32 =48

Default value: 117 (to receive all reports) Values in the range 0 to 117 may be set.

The manufacturer defined default value is 117.

This parameter has the configuration ID config_76_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 EDSC700 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 5 nodes.

Group 2: Up Power Detected G1

G1 and G2 group are controlled in sequence, after a user defined delay, in the case of an Up Power event

Association group 2 supports 5 nodes.

Group 3: Up Power Detected G2

G1 and G2 group are controlled in sequence, after a user defined delay, in the case of an Up Power event

Association group 3 supports 5 nodes.

Group 4: Down Power Detected G1

G1 and G2 group are controlled in sequence, after a user defined delay, in the case of a Down Power event

Association group 4 supports 5 nodes.

Group 5: Down Power Detected G2

G1 and G2 group are controlled in sequence, after a user defined delay, in the case of a Down Power event

Association group 5 supports 5 nodes.

Technical Information

Endpoints

Endpoint 0

Command Class Comment
COMMAND_CLASS_NO_OPERATION_V1
COMMAND_CLASS_APPLICATION_STATUS_V1
COMMAND_CLASS_METER_V3
COMMAND_CLASS_TRANSPORT_SERVICE_V1
COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1
COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1
COMMAND_CLASS_ZWAVEPLUS_INFO_V1
COMMAND_CLASS_SUPERVISION_V1
COMMAND_CLASS_CONFIGURATION_V1
COMMAND_CLASS_ALARM_V8
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.