Digi-SE ERT

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.

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. Sign in to https://digi-se.appspot.com. This is the same user name and password you use to sign in to Device Cloud.

  2. Go to Configuration > ERT and select your Digi gateway from the Gateway menu.

    ../../_images/ert-blank.png
  3. Make sure the 64-bit Extended Unique Identifier (EUI-64) of your gateway automatically populates the ERT Device EUI field. If the field does not auto-populate, make sure your device is a Digi ERT device, that it is connected to Device Cloud, and running the Smart Energy Framework.

    Note

    ERT Device EUI is the device identifier that you can configure to read from an ERT Meter, not an ERT Meter itself. Normally, there is only one ERT device per network. If more than one ERT Device is available, select the correct device before continuing.

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

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

    ../../_images/ert-type_id.png
  6. Select your meter type from the Metering Device Type menu. Additional formatting attributes appear with typical values.

    ../../_images/ert-metering_device_type.png
  7. Configure the following attributes to 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 configures the number of digits to display to the left and right of a decimal.

    • Unit of Measure
    • Multiplier
    • Divisor
    • Summation Formatting

    Note

    Accept the default values if you are unsure of appropriate configuration values. The device can still read the meter and you can enter correct scaling attributes after you verify basic operation.

    ../../_images/ert-scaling.png
  8. Click Add/Save and wait for the form to reload. Verify the ERT meter by reading its value. See Read from ERT meter on a Digi device.

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 a Digi device

  1. Sign in to https://digi-se.appspot.com. This is the same user name and password you use to sign in to Device Cloud.

  2. Go to Configuration > ERT and select your Digi gateway from the Gateway menu.

    ../../_images/ert-blank.png
  3. Make sure the 64-bit Extended Unique Identifier (EUI-64) of your gateway automatically populates the ERT Device EUI field. If the field does not auto-populate, make sure your device is a Digi ERT device, that it is connected to Device Cloud, and running the Smart Energy Framework.

    Note

    ERT Device EUI is the device identifier that you can configure to read from an ERT Meter, not an ERT Meter itself. Normally, there is only one ERT device per network. If more than one ERT Device is available, select the correct device before continuing.

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

    ../../_images/ert-select_meter.png
  5. Click Edit to enable editing for this ERT meter.

  6. Make changes to the necessary fields and click Add/Save. Click Restore before saving if you need to discard the changes.

Remove ERT meter from a Digi device

  1. Sign in to https://digi-se.appspot.com. This is the same user name and password you use to sign in to Device Cloud.

  2. Go to Configuration > ERT and select your Digi gateway from the Gateway menu.

    ../../_images/ert-blank.png
  3. Make sure the 64-bit Extended Unique Identifier (EUI-64) of your gateway automatically populates the ERT Device EUI field. If the field does not auto-populate, make sure your device is a Digi ERT device, that it is connected to Device Cloud, and running the Smart Energy Framework.

    Note

    ERT Device EUI is the device identifier that you can configure to read from an ERT Meter, not an ERT Meter itself. Normally, there is only one ERT device per network. If more than one ERT Device is available, select the correct device before continuing.

    ../../_images/ert-eui.png
  4. Select the ERT device you want to remove from ERT Meter menu and click Remove. The page reloads and the ERT meter is no longer configured on your device.

    ../../_images/ert-select_meter.png

Read from ERT meter on a 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. Sign in to https://digi-se.appspot.com. This is the same user name and password you use to sign in to Device Cloud.

  2. Go to Configuration > ERT and select your Digi gateway from the Gateway menu.

    ../../_images/ert-blank.png
  3. Make sure the 64-bit Extended Unique Identifier (EUI-64) of your gateway automatically populates the ERT Device EUI field. If the field does not auto-populate, make sure your device is a Digi ERT device, that it is connected to Device Cloud, and running the Smart Energy Framework.

    Note

    ERT Device EUI is the device identifier that you can configure to read from an ERT Meter, not an ERT Meter itself. Normally, there is only one ERT device per network. If more than one ERT Device is available, select the correct device before continuing.

    ../../_images/ert-eui.png
  4. 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
  5. Select Network > Tree to view the raw metering data from the configured ERT meter. After a few seconds, a tree structure representing your ZigBee network appears.

  6. To view the raw ERT meter data, expand each item.
    • ERT Device EUI
    • ERT Endpoint
    • Input (Server) Clusters
    • Cluster 0x702 - Metering Device

    In the tree structure, 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.

    ../../_images/ert-network_tree-expanded.png
  7. Make note of the raw reading and actual consumption on the physical ERT meter after a raw reading is displayed in Attribute 0x0000.

  8. Select Network > In-Home Display to view scaled and formatted consumption data from the configured ERT meter.

    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 displays “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 are incorrect. Calculate new Multiplier and Divisor values using the raw reading from the Network > Tree page. See Edit ERT meter configuration on a 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.