Skip to content

Latest commit

 

History

History
1002 lines (551 loc) · 28.7 KB

dsb09_0_0.md

File metadata and controls

1002 lines (551 loc) · 28.7 KB
layout title
documentation
DSB09 - ZWave

{% include base.html %}

DSB09 Home Energy Meter

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

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

DSB09 product image

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

Your Home Energy Meter can be reset to default factory settings with ease.

  1. Press and hold the Action Button for 10 seconds.
  2. If successful, the LED on the HEM should begin to blink slowly.

Inclusion Information

The electrical installation of your Home Energy Meter (HEM) is now complete. You  must now wirelessly link it to your Z-Wave network.

  1. Put your primary Z-Wave controller, usually a gateway or hub, into inclusion mode. If  you are not sure how to do this, please refer to your controller’s user manual.
  2. Press the Action Button on your HEM. If it has been successfully linked to your  network, its LED will remain illuminated. If the linking was unsuccessful, your HEM’s LED will continue to blink.

Exclusion Information

Your Home Energy Meter (HEM) can be removed from your Z-Wave network at  any time. You'll need to use your Z-Wave network’s primary to do this.

  1. Put your main controller into its device removal mode. If you are unsure how to do  this, please refer to your controller’s user manual.
  2. Press the Action Button on your HEM. If it has been successfully removed from your  network, its LED will blink. If the removal was unsuccessful, its LED will be solid and it will be then repeated again.

General Usage Information

NOTE: If a report is included in more then one Report Group, it will only be sent in the Report Group with the most recently updated configuration parameter.

Channels

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

Channel Channel Id Category Item Type
Sensor (power) sensor_power Energy Number
Electric meter (kWh) meter_kwh Energy Number
Electric meter (watts) meter_watts Energy Number
Reset Meter meter_reset Energy Switch
Battery Level battery-level Battery Number
Sensor (power) 1 sensor_power1 Energy Number
Electric meter (kWh) 1 meter_kwh1 Energy Number
Electric meter (watts) 1 meter_watts1 Energy Number
Sensor (power) 2 sensor_power2 Energy Number
Electric meter (kWh) 2 meter_kwh2 Energy Number
Electric meter (watts) 2 meter_watts2 Energy Number
Sensor (power) 3 sensor_power3 Energy Number
Electric meter (kWh) 3 meter_kwh3 Energy Number
Electric meter (watts) 3 meter_watts3 Energy Number

Sensor (power)

Indicates the energy consumption (kWh).

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

Electric meter (kWh)

Indicates the energy consumption (kWh).

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

Electric meter (watts)

Indicates the instantaneous power consumption.

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

Reset Meter

Reset the meter.

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

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.

Sensor (power) 1

Indicates the energy consumption (kWh).

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

Electric meter (kWh) 1

Indicates the energy consumption (kWh).

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

Electric meter (watts) 1

Indicates the instantaneous power consumption.

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

Sensor (power) 2

Indicates the energy consumption (kWh).

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

Electric meter (kWh) 2

Indicates the energy consumption (kWh).

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

Electric meter (watts) 2

Indicates the instantaneous power consumption.

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

Sensor (power) 3

Indicates the energy consumption (kWh).

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

Electric meter (kWh) 3

Indicates the energy consumption (kWh).

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

Electric meter (watts) 3

Indicates the instantaneous power consumption.

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

Device Configuration

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

Param Name Description
1 Voltage Voltage to calculate wattage from amperage.
3 Selective Reporting: Whole HEM
3 Selective Reporting: Clamp 1
3 Selective Reporting: Clamp 2
3 Selective Reporting: Clamp 3
4 Current Threshold - Whole HEM Threshold change in wattage to induce an automatic report (Whole HEM).
5 Current Threshold - Clamp 1 Threshold change in wattage to induce an automatic report (Clamp 1)
6 Current Threshold - Clamp 2 Threshold change in wattage to induce an automatic report (Clamp 2)
7 Current Threshold - Clamp 3 Threshold change in wattage to induce an automatic report (Clamp 3)
8 Percent Change - Whole HEM Percentage change in wattage to induce an automatic report (Whole HEM)
9 Percent Change - Clamp 1 Percentage change in wattage to induce an automatic report (Clamp 1)
10 Percent Change - Clamp 2 Percentage change in wattage to induce an automatic report (Clamp 2)
11 Percent Change - Clamp 3 Percentage change in wattage to induce an automatic report (Clamp 3)
100 Set parameters 101-103 to default values
101 Report Group 1: Battery Report
101 Report Group 1: MultiSensor Report for Watt (whole HEM)
101 Report Group 1: Meter Report for Watt (whole device)
101 Report Group 1: Meter Report for kWh (whole HEM)
101 Report Group 1: Meter Report for Watt (clamp 1)
101 Report Group 1: Meter Report for Watt (clamp 2)
101 Report Group 1: Meter Report for Watt (clamp 3)
101 Report Group 1: Meter Report for kWh (clamp 1)
101 Report Group 1: Meter Report for kWh (clamp 2)
101 Report Group 1: Meter Report for kWh (clamp 3)
102 Report Group 2: Battery Report
102 Report Group 2: MultiSensor Report for Watt (whole HEM)
102 Report Group 2: Meter Report for Watt (whole device)
102 Report Group 2: Meter Report for kWh (whole HEM)
102 Report Group 2: Meter Report for Watt (clamp 1)
102 Report Group 2: Meter Report for Watt (clamp 2)
102 Report Group 2: Meter Report for Watt (clamp 3)
102 Report Group 2: Meter Report for kWh (clamp 1)
102 Report Group 2: Meter Report for kWh (clamp 2)
102 Report Group 2: Meter Report for kWh (clamp 3)
103 Report Group 3: Battery Report
103 Report Group 3: MultiSensor Report for Watt (whole HEM)
103 Report Group 3: Meter Report for Watt (whole device)
103 Report Group 3: Meter Report for kWh (whole HEM)
103 Report Group 3: Meter Report for Watt (clamp 1)
103 Report Group 3: Meter Report for Watt (clamp 2)
103 Report Group 3: Meter Report for Watt (clamp 3)
103 Report Group 3: Meter Report for kWh (clamp 1)
103 Report Group 3: Meter Report for kWh (clamp 2)
103 Report Group 3: Meter Report for kWh (clamp 3)
110 Set parameters 111-113 to default values
111 Interval to send Report Group 1
112 Interval to send Report Group 2
113 Interval to send Report Group 3
255 Reset to Factory Reset all settings to factory defaults

Parameter 1: Voltage

Voltage to calculate wattage from amperage.

Values in the range 0 to 32000 may be set.

The manufacturer defined default value is 240.

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

Parameter 3: Selective Reporting: Whole HEM

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 3: Selective Reporting: Clamp 1

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 3: Selective Reporting: Clamp 2

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 3: Selective Reporting: Clamp 3

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 4: Current Threshold - Whole HEM

Threshold change in wattage to induce an automatic report (Whole HEM). Valid values: 0-60,000 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: Current Threshold - Clamp 1

Threshold change in wattage to induce an automatic report (Clamp 1) Valid values: 0-60,000 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: Current Threshold - Clamp 2

Threshold change in wattage to induce an automatic report (Clamp 2) Valid values: 0-60,000 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: Current Threshold - Clamp 3

Threshold change in wattage to induce an automatic report (Clamp 3) Valid values: 0-60,000 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 wattage to induce an 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 wattage to induce an 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 wattage to induce an 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 wattage to induce an 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 100: Set parameters 101-103 to default values

The following option values may be configured -:

Value Description
0 No change
1 Reset

The manufacturer defined default value is 0 (No change).

This parameter has the configuration ID config_100_4_wo and is of type INTEGER. This is a write only parameter.

Parameter 101: Report Group 1: Battery Report

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 101: Report Group 1: MultiSensor Report for Watt (whole HEM)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 101: Report Group 1: Meter Report for Watt (whole device)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 101: Report Group 1: Meter Report for kWh (whole HEM)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 101: Report Group 1: Meter Report for Watt (clamp 1)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 101: Report Group 1: Meter Report for Watt (clamp 2)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 101: Report Group 1: Meter Report for Watt (clamp 3)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 101: Report Group 1: Meter Report for kWh (clamp 1)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 101: Report Group 1: Meter Report for kWh (clamp 2)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 101: Report Group 1: Meter Report for kWh (clamp 3)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 102: Report Group 2: Battery Report

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 102: Report Group 2: MultiSensor Report for Watt (whole HEM)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 102: Report Group 2: Meter Report for Watt (whole device)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 102: Report Group 2: Meter Report for kWh (whole HEM)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 102: Report Group 2: Meter Report for Watt (clamp 1)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 102: Report Group 2: Meter Report for Watt (clamp 2)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 102: Report Group 2: Meter Report for Watt (clamp 3)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 102: Report Group 2: Meter Report for kWh (clamp 1)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 102: Report Group 2: Meter Report for kWh (clamp 2)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 102: Report Group 2: Meter Report for kWh (clamp 3)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 103: Report Group 3: Battery Report

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 103: Report Group 3: MultiSensor Report for Watt (whole HEM)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 103: Report Group 3: Meter Report for Watt (whole device)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 103: Report Group 3: Meter Report for kWh (whole HEM)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 103: Report Group 3: Meter Report for Watt (clamp 1)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 103: Report Group 3: Meter Report for Watt (clamp 2)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 103: Report Group 3: Meter Report for Watt (clamp 3)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 103: Report Group 3: Meter Report for kWh (clamp 1)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 103: Report Group 3: Meter Report for kWh (clamp 2)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 103: Report Group 3: Meter Report for kWh (clamp 3)

The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

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

Parameter 110: Set parameters 111-113 to default values

The following option values may be configured -:

Value Description
0 No change
1 Reset

The manufacturer defined default value is 0 (No change).

This parameter has the configuration ID config_110_4_wo and is of type INTEGER. This is a write only parameter.

Parameter 111: Interval to send Report 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 Report 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 Report 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: Reset to Factory

Reset all settings to factory defaults Reset all settings in unit to factory settings.  If you're getting crazy voltage readings in a unit after upgrading firmware, use this then reconfigure the 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_4_wo and is of type INTEGER. This is a write only parameter.

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 DSB09 supports 3 association groups.

Group 1: Report group 1

Association group 1 supports 5 nodes.

Group 2: Report group 2

Association group 2 supports 5 nodes.

Group 3: Report 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_SENSOR_MULTILEVEL_V2
COMMAND_CLASS_METER_V2
COMMAND_CLASS_MULTI_CHANNEL_V2
COMMAND_CLASS_CONFIGURATION_V1
COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1
COMMAND_CLASS_BATTERY_V1
COMMAND_CLASS_ASSOCIATION_V1
COMMAND_CLASS_VERSION_V1

Endpoint 1

Command Class Comment
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_SENSOR_MULTILEVEL_V2
COMMAND_CLASS_METER_V2

Endpoint 2

Command Class Comment
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_SENSOR_MULTILEVEL_V2
COMMAND_CLASS_METER_V2

Endpoint 3

Command Class Comment
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_SENSOR_MULTILEVEL_V2
COMMAND_CLASS_METER_V2

Documentation Links


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