Cluster Commands: Simple Metering#

This command is used to request the ESI to mirror Metering Device data.

This command is used to request the ESI to remove its mirror of Metering Device data.

This command is generated in response to a ScheduleSnapshot command, and is sent to confirm whether the requested snapshot schedule has been set up.

• issuerEventId - INT32U

• snapshotResponsePayload - struct sl_zigbee_zcl_snapshot_response_payload_t

This command is generated in response to a TakeSnapshot command, and is sent to confirm whether the requested snapshot has been accepted and successfully taken.

• snapshotId - INT32U

• snapshotConfirmation - SnapshotConfirmation [ENUM8] See Also

  • sl_zigbee_af_snapshot_confirmation_t

This command is generated in response to a GetSnapshot command. It is used to return a single snapshot to the client.

• snapshotId - INT32U

• snapshotTime - UTC_TIME

• totalSnapshotsFound - INT8U

• commandIndex - INT8U

• totalCommands - INT8U

• snapshotCause - SnapshotCause [BITMAP32]

• snapshotPayloadType - SnapshotPayloadType [ENUM8]

• snapshotPayload - INT8U See Also

  • sl_zigbee_af_snapshot_payload_type_t

ConfigureMirror is sent to the mirror once the mirror has been created. The command deals with the operational configuration of the Mirror.

• issuerEventId - INT32U

• reportingInterval - INT24U

• mirrorNotificationReporting - BOOLEAN

• notificationScheme - INT8U

The ConfigureNotificationScheme is sent to the mirror once the mirror has been created. The command deals with the operational configuration of the Mirror and the device that reports to the mirror. No default schemes are allowed to be overwritten.

• issuerEventId - INT32U

• notificationScheme - INT8U

• notificationFlagOrder - BITMAP32

The ConfigureNotificationFlags command is used to set the commands relating to the bit value for each NotificationFlags attribute that the scheme is proposing to use.

• issuerEventId - INT32U

• notificationScheme - INT8U

• notificationFlagAttributeId - INT16U

• clusterId - INT16U

• manufacturerCode - INT16U

• numberOfCommands - INT8U

• commandIds - INT8U

The GetNotifiedMessage command is used only when a BOMD is being mirrored. This command provides a method for the BOMD to notify the Mirror message queue that it wants to receive commands that the Mirror has queued. The Notification flags set within the command shall inform the mirror of the commands that the BOMD is requesting.

• notificationScheme - INT8U

• notificationFlagAttributeId - INT16U

• notificationFlagsN - BITMAP32

This command is transmitted by a Metering Device in response to a ChangeSupply command.

• providerId - INT32U

• issuerEventId - INT32U

• implementationDateTime - UTC_TIME

• supplyStatus - MeteringSupplyStatus [ENUM8] See Also

  • sl_zigbee_af_metering_supply_status_t

This command is transmitted by a Metering Device in response to a StartSampling command.

• sampleId - INT16U

The GetProfile command is generated when a client device wishes to retrieve a list of captured Energy, Gas or water consumption for profiling purposes.

• intervalChannel - AmiIntervalChannel [ENUM8]

• endTime - UTC_TIME

• numberOfPeriods - INT8U See Also

  • sl_zigbee_af_ami_interval_channel_t

The Mirror Removed Command allows the ESI to inform a sleepy Metering Device mirroring support has been removed or halted.

• endpointId - INT16U

The Request Fast Poll Mode command is generated when the metering client wishes to receive near real-time updates of InstantaneousDemand.

• fastPollUpdatePeriod - INT8U

• duration - INT8U

This command is used to set up a schedule of when the device shall create snapshot data.

• issuerEventId - INT32U

• commandIndex - INT8U

• commandCount - INT8U

• snapshotSchedulePayload - struct sl_zigbee_zcl_snapshot_schedule_payload_t

This command is used to instruct the cluster server to take a single snapshot.

• snapshotCause - SnapshotCause [BITMAP32]

This command is used to request snapshot data from the cluster server.

• earliestStartTime - UTC_TIME

• latestEndTime - UTC_TIME

• snapshotOffset - INT8U

• snapshotCause - SnapshotCause [BITMAP32]

The sampling mechanism allows a set of samples of the specified type of data to be taken, commencing at the stipulated start time. This mechanism may run concurrently with the capturing of profile data, and may refer the same parameters, albeit possibly at a different sampling rate.

• issuerEventId - INT32U

• startSamplingTime - UTC_TIME

• sampleType - SampleType [ENUM8]

• sampleRequestInterval - INT16U

• maxNumberOfSamples - INT16U See Also

  • sl_zigbee_af_sample_type_t

This command is used to request sampled data from the server. Note that it is the responsibility of the client to ensure that it does not request more samples than can be held in a single command payload.

• sampleId - INT16U

• earliestSampleTime - UTC_TIME

• sampleType - SampleType [ENUM8]

• numberOfSamples - INT16U See Also

  • sl_zigbee_af_sample_type_t

The ResetLoadLimitCounter command shall cause the LoadLimitCounter attribute to be reset.

• providerId - INT32U

• issuerEventId - INT32U

This command is sent from the Head-end or ESI to the Metering Device to instruct it to change the status of the valve or load switch, i.e. the supply.

• providerId - INT32U

• issuerEventId - INT32U

• requestDateTime - UTC_TIME

• implementationDateTime - UTC_TIME

• proposedSupplyStatus - MeteringSupplyStatus [ENUM8]

• supplyControlBits - SupplyControlBits [BITMAP8] See Also

  • sl_zigbee_af_metering_supply_status_t

This command is a simplified version of the ChangeSupply command, intended to be sent from an IHD to a meter as the consequence of a user action on the IHD. Its purpose is to provide a local disconnection/reconnection button on the IHD in addition to the one on the meter.

• proposedSupplyStatus - ProposedSupplyStatus [ENUM8] See Also

  • sl_zigbee_af_proposed_supply_status_t

This command is used to specify the required status of the supply following the occurance of certain events on the meter.

• issuerEventId - INT32U

• supplyTamperState - SupplyStatus [ENUM8]

• supplyDepletionState - SupplyStatus [ENUM8]

• supplyUncontrolledFlowState - SupplyStatus [ENUM8]

• loadLimitSupplyState - SupplyStatus [ENUM8] See Also

  • sl_zigbee_af_supply_status_tsl_zigbee_af_supply_status_tsl_zigbee_af_supply_status_tsl_zigbee_af_supply_status_t

This command is used to update the 'Uncontrolled Flow Rate' configuration data used by flow meters.

• providerId - INT32U

• issuerEventId - INT32U

• uncontrolledFlowThreshold - INT16U

• unitOfMeasure - AmiUnitOfMeasure [ENUM8]

• multiplier - INT16U

• divisor - INT16U

• stabilisationPeriod - INT8U

• measurementPeriod - INT16U See Also

  • sl_zigbee_af_ami_unit_of_measure_t