Digi Device Cloud Smart Energy ConnectPort X2e and ERT Documentation

Table Of Contents

Digi-SE ERT

Overview

ERT is an Itron technology that is used to communicate wirelessly with meters. This webpage allows you to configure Digi ERT devices to read from Itron ERT meters. For more information see Itron ERT.

https://digi-se.appspot.com/ert allows a developer to:

Requirements

You’ll need one of the following Digi ERT setups:

The gateway needs to be connected to your account on Device Cloud. See Setup Device Cloud.

You’ll need access to an ERT meter in the vicinity of the Digi ERT device to read meter values.

You should already to logged into https://digi-se.appspot.com. See Digi-SE Getting Started for more information.

Add ERT meter to Digi device

  1. Go to https://digi-se.appspot.com/ert and select your Digi gateway from the Gateway dropdown (see Gateway Selection).

    ../../_images/ert-blank.png
  2. Within a few seconds, the EUI(s) (64-bit long address) of your Digi ERT devices should automatically load in the ERT Device EUI dropdown. If the field doesn’t auto-populate, make sure that your gateway is connected to Device Cloud and running the Smart Energy Framework. Also, make sure you have a Digi ERT device.

    Note

    ERT Device EUI is the identifier of a device which can be configured to read from an ERT Meter, not an ERT Meter itself. Normally there will be only one ERT Device per network. If more than one ERT Device is available select the desired device before continuing.

    ../../_images/ert-eui.png
  3. If necessary, select “Add New Meter” from ERT Meter dropdown.

    ../../_images/ert-add_new_meter.png
  4. Locate and enter the ERT Type and ERT ID for your ERT Meter.

    ../../_images/ert-type_id.png
  5. Select your meter type from the Metering Device Type drop-down box. Once selected, additional formatting attributes will populate with typical values for the selected metering device type.

    ../../_images/ert-metering_device_type.png
  6. Configure Unit of Measure, Multiplier, Divisor, and Summation Formatting. These attributes convert the raw value from the the meter to a meaningful value with units. The conversion equation is: value = (raw value * Multiplier) / Divisor in Units of Measure. The Summation Formatting field lets a display know how many digits to the left and right of the decimal to display.

    Note

    If unsure of proper configuration accept the default values. The meter can still be read and corrected scaling attributes entered once basic operation is verified.

    ../../_images/ert-scaling.png
  7. Click the Add/Save button and wait for the form to reload. You can verify the ERT meter by reading its value. See Read from ERT meter on Digi device.

    Note

    An ERT Endpoint is chosen for you and is the endpoint where the Zigbee Smart Energy meter is now located on the Digi devices with the metering information from the ERT meter. This ERT Endpoint is listed under ERT Meter and will likely be 0x01 if no other ERT Meters are configured.

    ../../_images/ert-configured.png

Edit ERT meter configuration on Digi device

  1. Go to https://digi-se.appspot.com/ert and select your Digi gateway from the Gateway dropdown (see Gateway Selection).

    ../../_images/ert-blank.png
  2. Within a few seconds, the EUI(s) (64-bit long address) of your Digi ERT devices should automatically load in the ERT Device EUI dropdown. If the field doesn’t auto-populate, make sure that your gateway is connected to Device Cloud and running the Smart Energy Framework. Also, make sure you have a Digi ERT device.

    Note

    ERT Device EUI is the identifier of a device which can be configured to read from an ERT Meter, not an ERT Meter itself. Normally there will be only one ERT Device per network. If more than one ERT Device is available select the desired device before continuing.

    ../../_images/ert-eui.png
  3. Select the ERT device you want to edit from ERT Meter dropdown.

    ../../_images/ert-select_meter.png
  4. Click the button labeled Edit to enable editing for this ERT meter.

    ../../_images/ert-editing.png
  5. Make your changes to the ERT Type, ERT ID, Metering Device Type, Unit of Measure, Multiplier, Divisor, and Summation Formatting fields.

    ../../_images/ert-editing-changes.png
  6. Save your changes by clicking the button labeled Add/Save.

    ../../_images/ert-editing-save.png
  7. Discard your changes by clicking the button labeled Restore.

    ../../_images/ert-configured.png

Remove ERT meter from Digi device

  1. Go to https://digi-se.appspot.com/ert and select your Digi gateway from the Gateway dropdown (see Gateway Selection).

    ../../_images/ert-blank.png
  2. Within a few seconds, the EUI(s) (64-bit long address) of your Digi ERT devices should automatically load in the ERT Device EUI dropdown. If the field doesn’t auto-populate, make sure that your gateway is connected to Device Cloud and running the Smart Energy Framework. Also, make sure you have a Digi ERT device.

    Note

    ERT Device EUI is the identifier of a device which can be configured to read from an ERT Meter, not an ERT Meter itself. Normally there will be only one ERT Device per network. If more than one ERT Device is available select the desired device before continuing.

    ../../_images/ert-eui.png
  3. Select the ERT device you want to remove from ERT Meter dropdown.

    ../../_images/ert-select_meter.png
  4. Click the button labeled Remove. The page should reload and the ERT meter should no longer be configured on your Digi device.

    ../../_images/ert-remove.png

Read from ERT meter on Digi device

Once an ERT meter is configured on a Digi device, it shows up on the ZigBee network as a normal ZigBee meter.

  1. Go to https://digi-se.appspot.com/ert and select your Digi gateway from the Gateway dropdown (see Gateway Selection).

    ../../_images/ert-blank.png
  2. Within a few seconds, the EUI(s) (64-bit long address) of your Digi ERT devices should automatically load in the ERT Device EUI dropdown. If the field doesn’t auto-populate, make sure that your gateway is connected to Device Cloud and running the Smart Energy Framework. Also, make sure you have a Digi ERT device.

    Note

    ERT Device EUI is the identifier of a device which can be configured to read from an ERT Meter, not an ERT Meter itself. Normally there will be only one ERT Device per network. If more than one ERT Device is available select the desired device before continuing.

    ../../_images/ert-eui.png
  3. Take note of the ERT Device EUI and the ERT Endpoint of the ERT device you want to read from.

    ../../_images/ert-eui_endpoint.png
  4. To view the raw metering data from the configured ERT meter, select Tree under Network in the top banner area. After a few seconds, a Tree representing your ZigBee network should appear.

    ../../_images/ert-network_tree-initial.png
  5. To view the raw ERT meter data, expand the following items in sequence by clicking on the small + symbol.
    1. ERT Device EUI
    2. ERT Endpoint
    3. Input (Server) Clusters
    4. Cluster 0x702 - Metering Device
    ../../_images/ert-network_tree-expanded.png
  6. Once expanded Attribute 0x0000 represents the raw reading retrieved from the ERT Meter while Attribute 0x0007 indicates the time of that raw reading. Other attributes indicate the various formatting attributes as specified during configuration.

    Note

    It may take several minutes to begin reading the ERT Meter depending on the frequency with which the ERT Meter broadcasts. Until the first reading is received Attribute 0x0000 will display 0xFFFFFFFFFFFFFFFF and Attribute 0x0007 will also display an invalid value. If these values are displayed wait a couple of minutes, refresh the page, and try again.

  7. Once a raw reading has been retrieved and is displayed in Attribute 0x0000 note the raw reading as well as actual consumption displayed on the physical ERT Meter.

  8. To view scaled and formatted consumption data from the configured ERT meter, select In-Home Display under Network in the top banner area.

    Note

    It may take several minutes to begin reading the ERT Meter depending on the frequency with which the ERT Meter broadcasts. Until the first reading is received the In-Home Display will display “Invalid”.

    ../../_images/ert-in_home_display.png
  9. Compare the scaled and formatted consumption data from the In-Home Display page with physical meter’s display. If the displays do not match then the Multiplier and Divisor attributes configured earlier are incorrect. Calculate a new Multiplier and Divisor using the raw reading from the Network Tree page. See Edit ERT meter configuration on Digi device to update these values.

    Note

    It is very important configure a correct Multiplier and Divisor before linking the ERT Meter to a higher layer that may cache and display incorrectly scaled meter consumption.