Skip to content

Latest commit

 

History

History
executable file
·
491 lines (293 loc) · 19.4 KB

dsb28_0_0.md

File metadata and controls

executable file
·
491 lines (293 loc) · 19.4 KB
layout title
documentation
DSB28 - ZWave

{% include base.html %}

DSB28 Home Energy Meter G2

This describes the Z-Wave device DSB28, manufactured by AEON Labs with the thing type UID of aeon_dsb28_00_000.

The device is in the category of Sensor, defining Device used to measure something.

DSB28 product image

The DSB28 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

Aeon Labs Home Energy Meter is a kind of energy meter for the entire home electric power consumption. It can report immediate wattage and kWh and voltage and amperage usage of the AC mains to a Z-Wave gateway wirelessly.

It can send Z-Wave REPORTS (Meter v3 Command Class) to response Z-Wave GET command at any time.

HEM can also be configured as sending unsolicited reports periodically to the associated nodes (within an association group). The time interval of reports can also be configured HEM can also send report of each individual channel with corresponding current clamp via the command of “Multi Channel Command Class Encapsulation ”.

To reduce the network traffic, HEM can send reports only when the loads significant change occurred(by percentage or Wattage value change, which can be configured)

Inclusion Information

  1. Connect HEM G2 to power and install the device properly (according to the Installation instruction, if necessary, please ask an electrician for help) , at beginning its LED blink slowly.
  2. Let the primary controller of existing Z-Wave network into inclusion mode (If you don’t know how to do this, refer to its manual).
  3. Press the Z-Wave button of HEM G2.
  4. If learning success, HEM G2 LED will stop slow blink, or it will still slow blink, please repeat the process from step 2. 

Exclusion Information

  1. Make sure the HEM G2 is powered, its LED be light on steadily.
  2. Let the primary controller of existing Z-Wave network into remove mode (If you don’t know how to do this, refer to its manual).
  3. Press the Z-Wave button.
  4. If exclusion success, HEM G2 LED will blink slowly or its LED still be on, please repeat the process from step 2.

General Usage Information

Reset HEM G2 to factory Default:

  1. Make sure HEM G2 has been connected to the power supply.
  2. Press and hold the Z-wave button for 10 seconds.
  3. If HEM G2 LED blinks slowly, it indicates reset success, otherwise please repeat step 2.

Note:

Reset HEM G2 to factory default Settings will: sets the HEM G2 to not in Z-Wave network state; delete the Association setting, power measure value and restore the Configuration Settings to the default.

Channels

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

Channel Name Channel ID Channel Type Category Item Type
Electric meter (watts) meter_watts meter_watts Energy Number
Electric meter (amps) meter_current meter_current Energy Number
Electric meter (volts) meter_voltage meter_voltage Energy Number
Electric meter (kWh) meter_kwh meter_kwh Energy Number
Reset Meter meter_reset meter_reset Energy Switch
Reporting Interval- Group 1 config_decimal config_decimal Number
Electric meter (watts) 1 meter_watts1 meter_watts Energy Number
Electric meter (amps) 1 meter_current1 meter_current Energy Number
Electric meter (volts) 1 meter_voltage1 meter_voltage Energy Number
Electric meter (kWh) 1 meter_kwh1 meter_kwh Energy Number
Electric meter (watts) 2 meter_watts2 meter_watts Energy Number
Electric meter (amps) 2 meter_current2 meter_current Energy Number
Electric meter (volts) 2 meter_voltage2 meter_voltage Energy Number
Electric meter (kWh) 2 meter_kwh2 meter_kwh Energy Number
Electric meter (watts) 3 meter_watts3 meter_watts Energy Number
Electric meter (volts) 3 meter_voltage3 meter_voltage Energy Number
Electric meter (amps) 3 meter_current3 meter_current Energy Number
Electric meter (kWh) 3 meter_kwh3 meter_kwh Energy Number

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 (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 (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 (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.

Reset Meter

Reset the meter.

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

Reporting Interval- Group 1

Change the reporting interval to reduce network traffic during off hours

Generic class for configuration parameter.

The config_decimal channel is of type config_decimal and supports the Number item.

Electric meter (watts) 1

Indicates the instantaneous power consumption.

The meter_watts1 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 (amps) 1

Indicates the instantaneous current consumption.

The meter_current1 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 (volts) 1

Indicates the instantaneous voltage.

The meter_voltage1 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 (kWh) 1

Indicates the energy consumption (kWh).

The meter_kwh1 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) 2

Indicates the instantaneous power consumption.

The meter_watts2 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 (amps) 2

Indicates the instantaneous current consumption.

The meter_current2 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 (volts) 2

Indicates the instantaneous voltage.

The meter_voltage2 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 (kWh) 2

Indicates the energy consumption (kWh).

The meter_kwh2 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) 3

Indicates the instantaneous power consumption.

The meter_watts3 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) 3

Indicates the instantaneous voltage.

The meter_voltage3 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) 3

Indicates the instantaneous current consumption.

The meter_current3 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 (kWh) 3

Indicates the energy consumption (kWh).

The meter_kwh3 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.

Device Configuration

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

Param Name Description
2 Reverse clamping If the reverse clamping pliers, negative power is detected.
3 Selective Reporting Report only when power change reaches a threshold set in 4-11 below.
4 Power Threshold - Whole HEM Threshold change in power to induce an automatic report (Whole HEM).
5 Power Threshold - Clamp 1 Threshold change in power to induce an automatic report (Clamp 1)
6 Power Threshold - Clamp 2 Threshold change in power to induce a automatic report (Clamp 2).
7 Power Threshold - Clamp 3 Threshold change in power to induce an automatic report (Clamp 3).
8 Percent Change - Whole HEM Percentage change in power to induce an automatic report (Whole HEM).
9 Percent Change - Clamp 1 Percentage change in power to induce an automatic report (Clamp 1).
10 Percent Change - Clamp 2 Percentage change in power to induce a automatic report (Clamp 2).
11 Percent Change - Clamp 3 Percentage change in power to induce a automatic report (Clamp 3).
101 Reports for group 1 Reports for group 1
102 Reports for group 2 Reports for group 2
103 Reports for group 3 Reports for group 3
111 Interval to send out reports of group 1
112 Interval to send out reports of group 2
113 Interval to send out reports of group 3
255 Factory Reset Reset all settings to factory defaults

Parameter 2: Reverse clamping

If the reverse clamping pliers, negative power is detected.

The following option values may be configured -:

Value Description
0 Disabled
1 Enabled

The manufacturer defined default value is 0 (Disabled).

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

Parameter 3: Selective Reporting

Report only when power change reaches a threshold set in 4-11 below. Enable selective reporting only when power change reaches a certain threshold or percentage set in 4-11 below.

This is used to reduce network traffic.(Bit 0: Whole HEM ,Bit 1:Clamp 1,Bit 2:Clamp 2,Bit 3:Clamp 3) Values in the range 0 to 16 may be set.

The manufacturer defined default value is 1.

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

Parameter 4: Power Threshold - Whole HEM

Threshold change in power to induce an automatic report (Whole HEM). Threshold change in wattage to induce a automatic report (Whole HEM). (Valid values 0-60000) Values in the range 0 to 60000 may be set.

The manufacturer defined default value is 50.

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

Parameter 5: Power Threshold - Clamp 1

Threshold change in power to induce an automatic report (Clamp 1) Threshold change in wattage to induce a automatic report (Clamp 1). (Valid values 0-60000) Values in the range 0 to 60000 may be set.

The manufacturer defined default value is 50.

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

Parameter 6: Power Threshold - Clamp 2

Threshold change in power to induce a automatic report (Clamp 2). Threshold change in wattage to induce a automatic report (Clamp 2). (Valid values 0-60000) Values in the range 0 to 60000 may be set.

The manufacturer defined default value is 50.

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

Parameter 7: Power Threshold - Clamp 3

Threshold change in power to induce an automatic report (Clamp 3). Threshold change in wattage to induce a automatic report (Clamp 3). (Valid values 0-60000) Values in the range 0 to 60000 may be set.

The manufacturer defined default value is 50.

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

Parameter 8: Percent Change - Whole HEM

Percentage change in power to induce an automatic report (Whole HEM). Percentage change in wattage to induce a automatic report (Whole HEM). (Valid values 0-100) Values in the range 0 to 100 may be set.

The manufacturer defined default value is 50.

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

Parameter 9: Percent Change - Clamp 1

Percentage change in power to induce an automatic report (Clamp 1). Percentage change in wattage to induce a automatic report (Clamp 1). (Valid values 0-100) Values in the range 0 to 100 may be set.

The manufacturer defined default value is 50.

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

Parameter 10: Percent Change - Clamp 2

Percentage change in power to induce a automatic report (Clamp 2). Percentage change in wattage to induce a automatic report (Clamp 2). (Valid values 0-100) Values in the range 0 to 100 may be set.

The manufacturer defined default value is 50.

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

Parameter 11: Percent Change - Clamp 3

Percentage change in power to induce a automatic report (Clamp 3). Percentage change in wattage to induce a automatic report (Clamp 3). (Valid values 0-100) Values in the range 0 to 100 may be set.

The manufacturer defined default value is 50.

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

Parameter 101: Reports for group 1

Reports for group 1 1 -> Battery Report

2 -> MultiSensor Report for the whole device

4 -> Meter Report for Watt for the whole device

8 -> Meter Report for kWh for the whole device

256 -> Meter Report for Watt for clamp 1

512 -> Meter Report for W Values in the range 0 to 1061109568 may be set.

The manufacturer defined default value is 8.

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

Parameter 102: Reports for group 2

Reports for group 2 1 -> Battery Report

2 -> MultiSensor Report for the whole device

4 -> Meter Report for Watt for the whole device

8 -> Meter Report for kWh for the whole device

256 -> Meter Report for Watt for clamp 1

512 -> Meter Report for W Values in the range 0 to 1061109568 may be set.

The manufacturer defined default value is 8.

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

Parameter 103: Reports for group 3

Reports for group 3 1 -> Battery Report

2 -> MultiSensor Report for the whole device

4 -> Meter Report for Watt for the whole device

8 -> Meter Report for kWh for the whole device

256 -> Meter Report for Watt for clamp 1

512 -> Meter Report for W Values in the range 0 to 1061109568 may be set.

The manufacturer defined default value is 8.

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

Parameter 111: Interval to send out reports of group 1

Values in the range 1 to 2678400 may be set.

The manufacturer defined default value is 720.

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

Parameter 112: Interval to send out reports of group 2

Values in the range 1 to 2678400 may be set.

The manufacturer defined default value is 720.

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

Parameter 113: Interval to send out reports of group 3

Values in the range 1 to 2678400 may be set.

The manufacturer defined default value is 720.

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

Parameter 255: Factory Reset

Reset all settings to factory defaults If you upgrade firmware and are seeing crazy or impossible numbers, reset to factory then reconfigure unit.This is an advanced parameter and will therefore not show in the user interface without entering advanced mode. The following option values may be configured -:

Value Description
0 Do nothing
1 Reset to Factory Defaults

The manufacturer defined default value is 0 (Do nothing).

This parameter has the configuration ID config_255_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 DSB28 supports 3 association groups.

Group 1: Group 1

Association group 1 supports 5 nodes.

Group 2: Group 2

Association group 2 supports 5 nodes.

Group 3: Group 3

Association group 3 supports 5 nodes.

Technical Information

Endpoints

Endpoint 0

Command Class Comment
COMMAND_CLASS_NO_OPERATION_V1
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_METER_V3 Linked to BASIC
COMMAND_CLASS_CRC_16_ENCAP_V1
COMMAND_CLASS_MULTI_CHANNEL_V2
COMMAND_CLASS_CONFIGURATION_V1
COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1
COMMAND_CLASS_ASSOCIATION_V1
COMMAND_CLASS_VERSION_V1

Endpoint 1

Command Class Comment
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_METER_V3 Linked to BASIC

Endpoint 2

Command Class Comment
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_METER_V3 Linked to BASIC

Endpoint 3

Command Class Comment
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_METER_V3 Linked to BASIC

Documentation Links


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