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.

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 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 from other devices.

Overview

No device information is provided in the database. Consider updating the database to improve the documentation.

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 19 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 Enable/disable selective reporting
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). (Valid values 0-60000)
6 Current Threshold - Clamp 2 Threshold change in wattage to induce an automatic report (Clamp 2). (Valid values 0-60000)
7 Current Threshold - Clamp 3 Threshold change in wattage to induce an automatic report (Clamp 3). (Valid values 0-60000)
8 Percent Change - Whole HEM Percentage change in wattage to induce an automatic report (Whole HEM). (Valid values 0-100)
9 Percent Change - Clamp 1 Percentage change in wattage to induce an automatic report (Clamp 1). (Valid values 0-100)
10 Percent Change - Clamp 2 Percentage change in wattage to induce an automatic report (Clamp 2). (Valid values 0-100)
11 Percent Change - Clamp 3 Percentage change in wattage to induce an automatic report (Clamp 3). (Valid values 0-100)
100 Set parameter 101-103 to default values Reset to default parameters number 101-103. Any value other than 0 will initiate this reset.
101 Which reports need to send automatically for group 1 Sum values of all wanted reports (see Overview)
102 Which reports need to send automatically for group 2 Sum values of all wanted reports (see Overview)
103 Which reports need to send automatically for group 3 Sum values of all wanted reports (see Overview)
110 Set parameter 111-113 to default values Reset to default parameters number 111-113. Any value other than 0 will initiate this reset.
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 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

Enable/disable selective reporting When selective reporting is disabled, unit will send a report every X seconds, as configured in items 101-103. When selective reporting is enabled, unit will send a report if thresholds in items 4-7, or percentages in items 8-11, are exceeded. This is used to reduce network traffic. Sum the following values for the source of the reports to be selectively reported:

0 -> Disable Selective Reporting

1 -> Whole HEM

2 -> Clamp 1

4 -> Clamp 2

8 -> Clamp 3 Values in the range 0 to 15 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: Current Threshold - Whole HEM

Threshold change in wattage to induce an automatic report (Whole HEM).

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-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: Current Threshold - Clamp 2

Threshold change in wattage to induce an 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: Current Threshold - Clamp 3

Threshold change in wattage to induce an 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 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 parameter 101-103 to default values

Reset to default parameters number 101-103. Any value other than 0 will initiate this reset.

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: Which reports need to send automatically for group 1

Sum values of all wanted reports (see Overview) 1 -> Battery Report

2 -> MultiSensor Report for Watt (whole device)

4 -> Meter Report for Watt (whole device)

8 -> Meter Report for kWh (whole device)

256 -> Meter Report for Watt (clamp 1)

512 -> Meter Report for Watt (clamp 2)

1024 -> Meter Report for Watt (clamp 3)

2048 -> Meter Report for kWh (clamp 1)

4096 -> Meter Report for kWh (clamp 2)

8192 -> Meter Report for kWh (clamp 3)

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. Values in the range 0 to 16383 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: Which reports need to send automatically for group 2

Sum values of all wanted reports (see Overview) 1 -> Battery Report

2 -> MultiSensor Report for Watt (whole device)

4 -> Meter Report for Watt (whole device)

8 -> Meter Report for kWh (whole device)

256 -> Meter Report for Watt (clamp 1)

512 -> Meter Report for Watt (clamp 2)

1024 -> Meter Report for Watt (clamp 3)

2048 -> Meter Report for kWh (clamp 1)

4096 -> Meter Report for kWh (clamp 2)

8192 -> Meter Report for kWh (clamp 3)

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. Values in the range 0 to 16383 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: Which reports need to send automatically for group 3

Sum values of all wanted reports (see Overview) 1 -> Battery Report

2 -> MultiSensor Report for Watt (whole device)

4 -> Meter Report for Watt (whole device)

8 -> Meter Report for kWh (whole device)

256 -> Meter Report for Watt (clamp 1)

512 -> Meter Report for Watt (clamp 2)

1024 -> Meter Report for Watt (clamp 3)

2048 -> Meter Report for kWh (clamp 1)

4096 -> Meter Report for kWh (clamp 2)

8192 -> Meter Report for kWh (clamp 3)

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. Values in the range 0 to 16383 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 110: Set parameter 111-113 to default values

Reset to default parameters number 111-113. Any value other than 0 will initiate this reset.

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 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: 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

This group supports 5 nodes.

Group 2: Report group 2

This group supports 5 nodes.

Group 3: Report group 3

This group 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_V0| | | COMMAND_CLASS_SENSOR_MULTILEVEL_V2| | | COMMAND_CLASS_METER_V2| |

Endpoint 2

| Command Class | Comment | |—————|———| | COMMAND_CLASS_BASIC_V0| | | COMMAND_CLASS_SENSOR_MULTILEVEL_V2| | | COMMAND_CLASS_METER_V2| |

Endpoint 3

Command Class Comment
COMMAND_CLASS_BASIC_V0  
COMMAND_CLASS_SENSOR_MULTILEVEL_V2  
COMMAND_CLASS_METER_V2  

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