Digi Device Cloud Smart Energy ConnectPort X2e and ERT Documentation

Table Of Contents

Create 1.6.2, 1.6.3, and 1.6.4 sections.

Change Log

1.6.1

Certified: September 2012

Platforms:
  • 50X2E-Z1C-001-01 X2e Gateway for Smart Energy (ESI/IHD, coordinator/router)
    • XBee version: 5122
    • Linux version: 3.0.1.25

SE Version: 1.1a

Digi website (CPX2e): http://www.digi.com/products/wireless-routers-gateways/gateways/connectportx2ese

Digi website (CPX2): http://www.digi.com/products/wireless-routers-gateways/gateways/connectportx2.jsp#overview

Digi website (ERT): http://www.digi.com/products/wireless-routers-gateways/gateways/ert-ethernet.jsp#overview

Changes:

1.6.0

Note

Internal release

1.5.1

Certified: July 2011

Platforms:
  • X2E-Z1C-E1-A X2e Gateway for Smart Energy (ESI/IHD, coordinator/router, Ethernet and Ethernet/Wi-Fi)
    • XBee version: 5122
    • Linux version: 3.0.1.23

SE Version: 1.1

Digi website (CPX2e): http://www.digi.com/products/wireless-routers-gateways/gateways/connectportx2ese

Changes:
  • Added support for X2e gateway.
  • Free memory check only used for NDS. - Background_Thread.watchdog_memory in Registry Settings. - Background_Thread.watchdog_memory_duration in Registry Settings. - Background_Thread.watchdog_memory_interval in Registry Settings.

1.5.0

Certified: July 2011

Platforms:
  • X2-SE1-EC-A ConnectPort X2 Gateway for Smart Energy (ESP - Coordinator)
    • XBee Version: 3130
    • NDS Version: 2.14.0.3
  • X2-SE4-EC-A ConnectPort X2 Gateway for Smart Energy (ESP/IHD - Router)
    • XBee Version: 3330
    • NDS Version: 2.14.0.3
  • 70002467 Ert/Ethernet Gateway
    • NDS Version:

SE Version: 1.1

Digi website (CPX2): http://www.digi.com/products/wireless-routers-gateways/gateways/connectportx2.jsp#overview

Digi website (ERT): http://www.digi.com/products/wireless-routers-gateways/gateways/ert-ethernet.jsp#overview

Changes:
  • New Zigbee OTA Upgrade Cluster Interface (ZigBee standard over-the-air firmware upgrades) included by default for gateways.

  • Time synchronization on the gateway is transitioning to being handled by the underlying operating system instead of the Python code. Support for NTP will be deprecated in the current Python code and disabled by default.
  • Messages in the asynchronous response buffer can now be stored to flash when Registry Settings “RPC_Manager.use_push” is set to True. (See Asynchronous Requests).
  • Internal representation of XML data types now uses a compressible representation call TreeParser instead of the standard ElementTree Python module. (See XML Parameter Type).

  • The maximum size of the asynchronous output buffer was changed from using a number of messages to a number of bytes. This changes helps control the actual amount of memory used since message sizes can vary greatly. (See Asynchronous Requests).
  • New discovery_status information given to indicate when gateway has finished automated service discovery for each device.
  • RPC command refresh_device_information can optionally remove inactive devices from the device list with the parameter “clear_inactive”. (See get_device_information to get device list).

  • RPC command read_attributes updated to automatically discover and read all of the attributes on a cluster if no list of attributes is supplied.

  • RPC command get_meter_profile updated to accept different parameters and to send multiple ZigBee level messages to retrieve meter profile data. (See new parameters added to GetProfileRecord).

  • New RPC command request_fast_poll_mode added.

  • Background memory check updated. Instead of periodically allocating a large buffer to check for memory availability, the system queries the operating system for available memory.
  • RPC parameters “source_endpoint_id” and “destination_endpoint_id” will now default based on service discovery for RPC functions (including ZigBee Interface).

  • Parameter “attribute_type” no longer required for local writes or reporting configurations when using pseudo reporting:
  • Parameter “max_interval” in AttributeReportingConfigurationRecord can now exceed 0xFFFE when pseudo_reporting is set to True in RPC command start_receiving_reports.

  • New RPC command registry_restore_defaults added.

  • Added Registry Settings “SE_Profile.profile_version_1_X” to set whether the gateway uses Smart Energy Version 1.0 or 1.1.

  • Added Registry Settings “Time_Server.enable_superseding_bit” to force a gateway’s time server to be the authoritative time server on a Smart Energy 1.1 network.

  • Removed “ZDO_Device_Manager.require_explicit_device_add” in Registry Settings. This feature is no longer supported.

  • Parameter “signature” in ReportEventStatusRecord has become optional.

  • Time cluster servers will automatically set their time zone and daylight savings time from the Python time module if available (See ZCL_TimeCluster_server).

1.4.1

Certified: May 2011

Platforms:
  • X2-SE1-EC-A ConnectPort X2 Gateway for Smart Energy (ESP - Coordinator)
    • XBee Version: 3129
    • NDS Version: 82002458_B_SA9 (2.13.0.9)

SE Version: 1.1

Note

This version is not an official production release.

1.4.0

Certified: March 2011

Platforms:
  • X2-SE1-EC-A ConnectPort X2 Gateway for Smart Energy (ESP - Coordinator)
    • XBee Version: 3128
    • NDS Version: 82002458_B (2.13.0.10)
  • X2-SE4-EC-A ConnectPort X2 Gateway for Smart Energy (ESP/IHD - Router)
    • XBee Version: 3328
    • NDS Version: 82002458_B (2.13.0.10)

SE Version: 1.0

Digi website: http://www.digi.com/products/wireless-routers-gateways/gateways/connectportx2.jsp#overview

Changes:
  • Added background watchdog thread. This watchdog is an independent Python thread that periodically checks to make sure the main Python code is still running. It also periodically allocates buffers to check that there is contiguous RAM available to the Python code.
  • Removed registry option Conversation.TX_status_timeout. (See Registry Settings).

  • Changed default value for registry option Conversation.default_timeout from 30 to 10. (See Registry Settings).

  • Removed registry option Endpoint.max_socket_retries. (See Registry Settings).

  • Removed registry option RPC_Manager.pushed_file_extension. (See Registry Settings).

  • Changed default value for registry option RPC_Manager.use_push from False to True. (See Registry Settings).

  • Added registry option ZCL_Cluster.ignore_incomplete_records. (See Registry Settings).

  • Added registry option ZigBee_Socket.max_socket_retries. (See Registry Settings).

  • New parameters added to get_time.

  • RPC parameters “source_endpoint_id” and “destination_endpoint_id” will now default based on service discovery.
  • RPC command remove_device has new optional parameter “remove_from_network”.

  • The response to the RPC command get_zigbee_network_status has a new parameter “certificate_type”.

  • RPC command configure_zigbee_network has new optional parameter “network_key”.

  • New RPC command get_join_status.

  • New RPC command clear_join_status.

  • RPC command xbee_AT has new optional parameter “apply”.

  • RPC command read_reporting_configuration has decremented parameter “remote_configuration”.

  • RPC command send_ZCL has new optional parameter “disable_default_response”.

  • New status codes added for the message* command added:
  • Added Registry Settings “Version.version” to report the current version of the Python code running. This is useful because the version will be saved in registry.ini and can be used to determine the last version that was run on a gateway.

  • Time cluster servers will only support the standard time and local time attributes if the required time zone and daylight savings attributes are set on the gateway (See cluster_ZCL_TimeCluster_server).

1.3.3

Released October 2010

Platforms:
  • 70002467 Ert/Ethernet Gateway
    • NDS Version: 82002585_B (2.13.0.10)

SE Version: 1.0

Digi website: http://www.digi.com/products/wireless-routers-gateways/gateways/ert-ethernet.jsp#overview

Note

This release was not certified because the ERT/Ethernet Router doesn’t have a ZigBee Radio.

Changes:

1.3.0

Certified: June 2010.

Platforms:
  • X2-SE1-EC-A ConnectPort X2 Gateway for Smart Energy (ESP - Coordinator)
    • XBee Version: 3123
    • NDS Version: 82002458_A (2.10.0.3)
  • X2-SE4-EC-A ConnectPort X2 Gateway for Smart Energy (ESP/IHD - Router)
    • XBee Version: 3323
    • NDS Version: 82002458_A (2.10.0.3)

SE Version: 1.0

Digi website: http://www.digi.com/products/wireless-routers-gateways/gateways/connectportx2.jsp#overview

Note

This is the initial version of the Smart Energy Framework for this documentation.

1.2.1

Certified: March 2010.

Platforms:
  • X2-SE4-EC-A ConnectPort X2 Gateway for Smart Energy (ESP/IHD - Router)

SE Version: 1.0

Digi website: http://www.digi.com/products/wireless-routers-gateways/gateways/connectportx2.jsp#overview

Note

This version was released prior to this documentation and is not covered by this User’s Guide.

1.1.1

Certified: March 2010.

Platforms:
  • X2-SE1-EC-A ConnectPort X2 Gateway for Smart Energy (ESP - Coordinator)

SE Version: 1.0

Digi website: http://www.digi.com/products/wireless-routers-gateways/gateways/connectportx2.jsp#overview

Note

This version was released prior to this documentation and is not covered by this User’s Guide.

1.1.0

Certified: October 2009.

Products:
  • X2-SE1-EC-A ConnectPort X2 Gateway for Smart Energy (ESP - Coordinator)

SE Version: 1.0

Digi website: http://www.digi.com/products/wireless-routers-gateways/gateways/connectportx2.jsp#overview

Note

This version was released prior to this documentation and is not covered by this User’s Guide.