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 SnapshotResponsePayload

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

  • EmberAfSnapshotConfirmation

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

  • EmberAfSnapshotPayloadType

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

  • EmberAfMeteringSupplyStatus

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

  • EmberAfAmiIntervalChannel

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 SnapshotSchedulePayload

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

  • EmberAfSampleType

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

  • EmberAfSampleType

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

  • EmberAfMeteringSupplyStatus

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

  • EmberAfProposedSupplyStatus

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

  • EmberAfSupplyStatusEmberAfSupplyStatusEmberAfSupplyStatusEmberAfSupplyStatus

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

  • EmberAfAmiUnitOfMeasure