HOW TO: Configure ZCL (real) Reporting on the ConnectPort X2e for Smart Energy


The ZCL or "real" reporting method is where a Smart Energy device (example: Programmable Communicating Thermostat or PCT) is configured to report attribute information about itself to the Gateway, based on the amount of change to the value of a specified attribute.  Very few Smart Energy devices on the market support this method of reporting, and of those devices which claim to support it, an even smaller subset report ZCL values correctly.  The only way to determine whether or not a particular Smart Energy device supports ZCL attribute reporting is to contact the manufacturer of the device in question.

Note:  When a ZCL Reporting configuration is used, the configuration is requested/sent from the Gateway, but is created and stored on the Smart Energy device itself.  Since the reporting configuration is stored on the device, performing a <get_local_reporting_configurations> request on the Gateway will not show the presence of ZCL reporting configurations.  

Available ZCL Reporting configuration parameters:

The tables below, found within the Smart Energy Framework User Guide for the ConnectPort X2e for Smart Energy documentation, In the tables below, a parameter type of int = integer, and bool = a value of True or False.  Parameters listed with * specify optional parameters):

Common parameters for all types of reporting:

The status of the configuration operation, which may be 0 (“success”), some other ZCL status code (e.g. 0x86 “attribute not found”) or some internal status code (e.g. 0x202 “conversation timeout”).

Parameters specific to ZCL reporting:

The maximum time that the report receiver (i.e. the local device) will wait for a report from the device before timing out. If a report is not received within this many seconds, the configuration will be re-sent to the target device.

How to configure ZCL or "real" attribute reporting:

The following       <min_interval>0</min_interval>

What did the request do?

We can dissect the request above to see what is happening....

destination_address - the EUI-64 address of the PCT
destination_endpoint_id - ID of the PCT endpoint under which the "interesting data" (i.e. temperature) will be found
cluster_id - the ID of the Temperature server cluster (found under the destination_endpoint specified above)
server_or_client - the type of cluster on the PCT, for cluster_id above (0 = server cluster, 1 = client cluster)
attribute_id - the ID of the Current Temperature attribute found under cluster_id
pseudo_reporting - since we want true ZCL reporting, pseudo_reporting = FALSE
min_interval - reports will not be generated more often than this many seconds, regardless of value change (0 means "no minimum", since we want real-time reporting)
max_interval - reports must be generated at least this often, regardless of value change
reportable_change - the amount of change which is meaningful to generate an attribute report
attribute_type - attribute type for the attribute being reported on (required when the reportable_change value is specified.  This value can be obtained by looking under the readable attribute for this endpoint/cluster/attribute on Device Cloud --- Device Manager --- XBee Networks)
timeout - if a report is not received within this many seconds, the configuration will be re-sent to the Gateway (default = 0 or no timeout).  Time should be greater than max_interval if used


The <start_reports> configuration above can be used to report on the readable ZCL attribute(s) of any Smart Energy device which supports ZCL or "real" attribute reporting (please check with the manufacturer of your device for details).  For devices which don't support ZCL attribute reporting, the Pseudo Reporting or Scheduled Reporting methods are available (see below for link).

Additional Information:

HOW TO: Configure Scheduled (cron) Reporting on the ConnectPort X2e for Smart Energy
HOW TO: Configure Pseudo (differential) Reporting on the ConnectPort X2e for Smart Energy
HOW TO: Run Smart Energy Framework RPC commands from Digi Device Cloud Web Services
Last updated: Aug 31, 2018

Filed Under

Digi Remote Manager

Recently Viewed Articles

No recently viewed articles