ERT Meter Configuration Interface¶
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.
The following are the RPC requests and responses added by the RPC_ERT_Config_Interface class and correspond to specification of the ERT Meter Configuration. These methods perform actions to configure and remove ERT Metering Device endpoints and track ERT Metering Device endpoints currently available on the network. Many requests defined by RPC_ERT_Config_Interface require source_endpoint_id, destination_endpoint_id, and destination_address parameters to configure and remove ERT Metering Device endpoints. If not provided, the interface will attempt to determine reasonable defaults for these parameters. The destination_address parameter will default to the local device and expected to be useful on the ERT/Ethernet Gateway. The source_endpoint_id and destination_endpoint_id will be looked up in device information tables maintained by the gateway. When not provided, defaulted parameter values will be indicated in the response.
configure_ert_meter¶
Configures an ERT meter endpoint for a given ERT ID and ERT Type using the Configure ERT Meter Request command defined by the ERT Configuration Cluster (server). A new endpoint will be created if the ERT Meter is not already configured on the destination device. If already configured then the destination device will update the configuration. Generation of the configure_ert_meter_response will be stalled until the expected configuration is verified on the destination device and device information tables maintained by the gateway are updated or an error is detected.
Request Parameters
| Parameter | Type | Description |
|---|---|---|
| destination_address | MAC | 64-bit extended address of the device to which the ERT command will be sent. If not provided, the command will be sent to the local device. |
| source_endpoint_id | int | 8-bit identifier of the endpoint on the local device from which the ERT command will be sent. If not provided, defaults to an endpoint on the local device with a compatible cluster. |
| destination_endpoint_id | int | 8-bit identifier of the endpoint on the destination device to which the ERT command will be sent. If not provided, defaults to an endpoint on the target device with a compatible cluster. |
| record | ERTConfigurationRecord | Requested ERT Meter configuration. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| destination_address | MAC | 64-bit extended address of the device which sent the ERT response command. |
| source_endpoint_id | int | 8-bit identifier of the endpoint on the destination device which sent the ERT response command. |
| destination_endpoint_id | int | 8-bit identifier of the endpoint on the local device which received the ERT response command. |
| record | ERTEndpointResponseRecord | Indicates endpoint on which the configured ERT Meter is hosted. |
| verify_status | int | Success or failure of secondary verification of the requested ERT Meter configuration on target device. 0 if ERT meter verified successfully and gateway device information tables updated, 1 if a generic error occurred, 2 if a timeout occurred waiting to verify. |
Example
<configure_ert_meter synchronous="true">
<destination_address type="MAC">00:00:00:00:00:00:00:01</destination_address>
<source_endpoint_id>0x5E</source_endpoint_id>
<destination_endpoint_id>0x5E</destination_endpoint_id>
<record type="ERTConfigurationRecord">
<ert_type type="int">12</ert_type>
<ert_id type="int">123456789123</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>
</configure_ert_meter>
<configure_ert_meter_response timestamp="1292453505.0">
<source_endpoint_id type="int">0x5E</source_endpoint_id>
<record type="ERTEndpointResponseRecord">
<ert_id type="int">0xBC614E</ert_id>
<ert_type type="int">0xC</ert_type>
<endpoint_id type="int">0x1</endpoint_id>
</record>
<verify_status type="int">0x0</verify_status>
<destination_endpoint_id type="int">0x5E</destination_endpoint_id>
<source_address type="MAC">00:00:00:00:00:00:00:01</source_address>
</configure_ert_meter_response>
find_ert_meter¶
Check if an ERT Meter is hosted on the destination device based on ERT Type and ERT ID using the Find ERT Meter Request command defined by the ERT Configuration Cluster (server). If found the response will indicate which endpoint is hosting the ERT Meter.
Request Parameters
| Parameter | Type | Description |
|---|---|---|
| destination_address | MAC | 64-bit extended address of the device to which the ERT command will be sent. If not provided, the command will be sent to the local device. |
| source_endpoint_id | int | 8-bit identifier of the endpoint on the local device from which the ERT command will be sent. If not provided, defaults to an endpoint on the local device with a compatible cluster. |
| destination_endpoint_id | int | 8-bit identifier of the endpoint on the destination device to which the ERT command will be sent. If not provided, defaults to an endpoint on the target device with a compatible cluster. |
| record | ERTAddressRecord | ERT meter to find. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| destination_address | MAC | 64-bit extended address of the device which sent the ERT response command. |
| source_endpoint_id | int | 8-bit identifier of the endpoint on the destination device which sent the ERT response command. |
| destination_endpoint_id | int | 8-bit identifier of the endpoint on the local device which received the ERT response command. |
| record | ERTEndpointResponseRecord | ERT meter to find. |
Example
<find_ert_meter synchronous="true">
<destination_address type="MAC">00:00:00:00:00:00:00:01</destination_address>
<source_endpoint_id type="int">0x5E</source_endpoint_id>
<destination_endpoint_id type="int">0x5E</destination_endpoint_id>
<record type="ERTAddressRecord">
<ert_id type="int">12345678</ert_id>
<ert_type type="int">12</ert_type>
</record>
</find_ert_meter>
<find_ert_meter_response>
<source_endpoint_id type="int">0x5E</source_endpoint_id>
<destination_endpoint_id type="int">0x5E</destination_endpoint_id>
<source_address type="MAC">00:00:00:00:00:00:00:01</source_address>
<record type="ERTEndpointResponseRecord">
<ert_id type="int">0xBC614E</ert_id>
<ert_type type="int">0xC</ert_type>
<endpoint_id type="int">0x1</endpoint_id>
</record>
</find_ert_meter_response>
remove_ert_meter¶
Remove a hosted ERT Meter from the destination device based on ERT Type and ERT ID using the Remove ERT Meter Request command defined by the ERT Configuration Cluster (server). Generation of the response will be stalled until the meter’s removal is verified on the destination device and device information tables maintained by the gateway are updated or an error is detected.
Request Parameters
| Parameter | Type | Description |
|---|---|---|
| destination_address | MAC | 64-bit extended address of the device to which the ERT command will be sent. If not provided, the command will be sent to the local device. |
| source_endpoint_id | int | 8-bit identifier of the endpoint on the local device from which the ERT command will be sent. If not provided, defaults to an endpoint on the local device with a compatible cluster. |
| destination_endpoint_id | int | 8-bit identifier of the endpoint on the destination device to which the ERT command will be sent. If not provided, defaults to an endpoint on the target device with a compatible cluster. |
| record | ERTAddressRecord | ERT meter to remove. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| destination_address | MAC | 64-bit extended address of the device which sent the ERT response command. |
| source_endpoint_id | int | 8-bit identifier of the endpoint on the destination device which sent the ERT response command. |
| destination_endpoint_id | int | 8-bit identifier of the endpoint on the local device which received the ERT response command. |
| verify_status | int | Success or failure of secondary verification of the requested ERT Meter removal on target device. 0 if ERT meter verified successfully and gateway device information tables updated, 1 if a generic error occurred, 2 if a timeout occurred waiting to verify. |
Example
<remove_ert_meter synchronous="true">
<destination_address type="MAC">00:00:00:00:00:00:00:01</destination_address>
<source_endpoint_id>0x5E</source_endpoint_id>
<destination_endpoint_id>0x5E</destination_endpoint_id>
<record type="ERTAddressRecord">
<ert_type type="int">12</ert_type>
<ert_id type="int">12345678</ert_id>
</record>
</remove_ert_meter>
<remove_ert_meter_response>
<source_endpoint_id type="int">0x5E</source_endpoint_id>
<record type="ERTAddressRecord">
<ert_id type="int">0xBC614E</ert_id>
<ert_type type="int">0xC</ert_type>
</record>
<verify_status type="int">0x0</verify_status>
<destination_endpoint_id type="int">0x5E</destination_endpoint_id>
<source_address type="MAC">00:00:00:00:00:00:00:01</source_address>
</remove_ert_meter_response>
remove_all_ert_meters¶
Removes all hosted ERT Meters from the destination device using the Remove All ERT Meters command defined by the ERT Configuration Cluster (server). Generation of the response will be stalled until each meter’s removal is verified on the destination device and device information tables maintained by the gateway are updated or an error is detected.
Request Parameters
| Parameter | Type | Description |
|---|---|---|
| destination_address | MAC | 64-bit extended address of the device to which the ERT command will be sent. If not provided, the command will be sent to the local device. |
| source_endpoint_id | int | 8-bit identifier of the endpoint on the local device from which the ERT command will be sent. If not provided, defaults to an endpoint on the local device with a compatible cluster. |
| destination_endpoint_id | int | 8-bit identifier of the endpoint on the destination device to which the ERT command will be sent. If not provided, defaults to an endpoint on the target device with a compatible cluster. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| destination_address | MAC | 64-bit extended address of the device which sent the ERT response command. |
| source_endpoint_id | int | 8-bit identifier of the endpoint on the destination device which sent the ERT response command. |
| destination_endpoint_id | int | 8-bit identifier of the endpoint on the local device which received the ERT response command. |
| verify_status | int | Success or failure of secondary verification of the requested ERT Meter removal on target device. 0 if ERT meter verified successfully and gateway device information tables updated, 1 if a generic error occurred, 2 if a timeout occurred waiting to verify. |
Example
<remove_all_ert_meters synchronous="true">
<destination_address type="MAC">00:00:00:00:00:00:00:01</destination_address>
<source_endpoint_id>0x5E</source_endpoint_id>
<destination_endpoint_id>0x5E</destination_endpoint_id>
</remove_all_ert_meters>
<remove_all_ert_meters_response>
<source_endpoint_id type="int">0x5E</source_endpoint_id>
<destination_endpoint_id type="int">0x5E</destination_endpoint_id>
<source_address type="MAC">00:00:00:00:00:00:00:01</source_address>
<verify_status type="int">0x0</verify_status>
</remove_all_ert_meters_response>
get_ert_meters¶
Gets cached ERT Meter device information tables maintained by the gateway. These tables indicate which devices on the network have ERT Configuration Clusters and for those devices what ERT meters are currently configured.
Request Parameters
None
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| record_list | list | A list of records of type ERTDeviceRecord. Each record corresponds to a device on the network with an ERT Configuration Cluster server. |
Example
<get_ert_meters synchronous="true">
</get_ert_meters>
<get_ert_meters_response>
<record_list type="list">
<item 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>
</item>
</record_list>
</get_ert_meters_response>
refresh_ert_meters¶
Initiates a new discovery to refresh cached ERT Meter device information tables maintained by the gateway.
Request Parameters
| Parameter | Type | Description |
|---|---|---|
| full_refresh* | bool | If TRUE, clears cached device information tables before initiating discovery. If FALSE, overlays new device information into the existing tables. Defaults to FALSE. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| full_refresh | bool | If TRUE, cleared cached device information tables before initiating discovery. If FALSE, overlayed new device information into the existing tables. |
Example
<refresh_ert_meters synchronous="true">
</refresh_ert_meters>
<refresh_ert_meters_response>
<full_refresh type="bool">FALSE</full_refresh>
</refresh_ert_meters_response>