ERT Records¶
Important
The ERT products are end-of-life (EOL) and are no longer in production. Digi will continue to make ERT-related documentation available for existing customers.
These records correspond to specification of the ERT Meter Configuration and are used by methods in the ERT Meter Configuration Interface. Refer to those specifications for further information about record parameters.
ERTConfigurationRecord¶
Specifies the configuration of an ERT Meter for which consumption data will be received and presented as a Metering Device on the Smart Energy network.
Note
The unit_of_measure, multiplier, divisor, summation_formatting, and metering_device_type parameters correspond to Attributes of the Smart Energy Simple Metering cluster. See the Smart Energy specification for more details on the configuration options available.
Parameters
Parameter | Type | Description |
---|---|---|
ert_type | int | Type of the ERT Meter. |
ert_id | int | ID of the ERT Meter. Often represented as a 12 digit decimal number. |
unit_of_measure | int | 8-bit identifier specifying the unit of measure (kwH, cubic feet, etc) for consumption tracked by the ERT meter. |
multiplier | int | 32-bit unsigned integer specifying a value to scale the raw consumption value provided by the ERT meter into the unit of measure. |
divisor | int | 32-bit unsigned integer specifying a value to scale the raw consumption value provided by the ERT meter into the unit of measure. |
summation_formatting | int | 8-bit bitmap indicating the number of significant digits valid when displaying scaled consumption data. |
metering_device_type | int | 8-bit enumeration indicating the type of Metering Device on the Smart Energy network (Water, Gas, etc). |
Example
This record represents a Gas ERT Meter.
<record type="ERTConfigurationRecord">
<ert_type type="int">12</ert_type>
<ert_id type="int">12345678</ert_id>
<unit_of_measure type="int">0x2</unit_of_measure>
<divisor type="int">0x1</divisor>
<summation_formatting type="int">0xB0</summation_formatting>
<multiplier type="int">0x2</multiplier>
<metering_device_type type="int">0x1</metering_device_type>
</record>
ERTAddressRecord¶
Specifies the ERT Type and ERT ID of an ERT meter.
Parameters
Parameter | Type | Description |
---|---|---|
ert_type | int | Type of the ERT Meter. |
ert_id | int | ID of the ERT Meter. Often represented as a 12 digit decimal number. |
Example
This record represents a Gas ERT Meter.
<record type="ERTAddressRecord">
<ert_type type="int">12</ert_type>
<ert_id type="int">12345678</ert_id>
</record>
ERTEndpointResponseRecord¶
Specifies the ERT Type and ERT ID of an ERT meter along with the ZigBee Endpoint it is hosted on.
Parameters
Parameter | Type | Description |
---|---|---|
ert_type | int | Type of the ERT Meter. |
ert_id | int | ID of the ERT Meter. Often represented as a 12 digit decimal number. |
endpoint_id | int | Endpoint ID hosting the ERT Meter. |
Example
This record represents a Gas ERT Meter on Endpoint 1.
<record type="ERTEndpointResponseRecord">
<ert_type type="int">12</ert_type>
<ert_id type="int">12345678</ert_id>
<endpoint_id type="int">1</endpoint_id>
</record>
ERTDeviceRecord¶
This record contains the extended address, endpoint containing ERT Configuration Cluster server, and configuration and formatting attributes for all hosted ERT Meters.
Parameters
Parameter | Type | Description |
---|---|---|
addr_extended | MAC | The 64-bit extended address of the device. |
ert_config_endpoint | int | Endpoint on device containing an ERT Configuration Cluster server. |
ert_meters | dict | Dictionary of ERTConfigurationRecord for hosted ERT Meter endpoints of the device. Keys have the format endpoint_0xXX, where XX is the 8-bit endpoint identifier in hexadecimal. |
Example
This record represents a device with two Gas ERT Meters on Endpoints 1 and 2 configured through Endpoint 0x5E.
<record type="ERTDeviceRecord">
<addr_extended type="MAC">00:00:00:00:00:00:00:01</addr_extended>
<ert_config_endpoint type="int">0x5E</ert_config_endpoint>
<ert_meters type="dict">
<endpoint_0x02 type="ERTConfigurationRecord">
<ert_id type="int">0x165EC15</ert_id>
<unit_of_measure type="int">0x2</unit_of_measure>
<divisor type="int">0x1</divisor>
<ert_type type="int">0xC</ert_type>
<summation_formatting type="int">0xB0</summation_formatting>
<multiplier type="int">0x4</multiplier>
<metering_device_type type="int">0x1</metering_device_type>
</endpoint_0x02>
<endpoint_0x01 type="ERTConfigurationRecord">
<ert_id type="int">0xBC614E</ert_id>
<unit_of_measure type="int">0x2</unit_of_measure>
<divisor type="int">0x1</divisor>
<ert_type type="int">0xC</ert_type>
<summation_formatting type="int">0xB0</summation_formatting>
<multiplier type="int">0x2</multiplier>
<metering_device_type type="int">0x1</metering_device_type>
</endpoint_0x01>
</ert_meters>
</record>