Power Quality Cluster

 

This cluster has been implemented to measure and evaluate the quality of the electrical main where a device is plugged in.

If a field of the payload starts with 0x, this means that it’s an hexadecimal representation, and if it starts with 0b, it is a binary representation.

Any multi-byte numerical value is serialized in “Big Endian” order.

Current

Standard report

Report

FeaturesFctrl CmdIDClusterIDAttributeIDAttribute typeDataComment
Report attributes0x11 or 0x31 or
...		0x0A0x80 0x520x00 0x000x410x18 [0xpppp]*120x18: data length
[0xpppp]*12:
Freq, Freq Min, Freq Max: (x+22232)(Hz/1000)
Vrms, Vrms Min, Vrms Max: V/10
Vpeak, Vpeak Min, Vpeak Max: V/10
OverVoltageNumber,SagNumber, BrownoutNumber: Number (counter)

Configuration

FeaturesFctrl CmdIDClusterIDPayloadComment
Configure reporting0x11 or 0x31 or
...		0x060x80 0x520x00 0x00 0x00 0x41 0xmmmm 0xMMMM 0x18 [0xpppp]*12
0x00 0x00: attributeID
0x41: attribute type
0xmmmm: minimum reporting interval
0xMMMM: maximum reporting interval
Reportable change:
0x18: data length
[0xpppp]*12:
Freq, Freq Min, Freq Max: Hz/1000
Vrms, Vrms Min, Vrms Max: V/10
Vpeak, Vpeak Min, Vpeak Max: V/10
OverVoltageNumber,SagNumber, BrownoutNumber: Number (counter)
Configure reporting response0x11 or 0x31 or
...		0x070x80 0x520xss 0x00 0x00 0x000xss:status
Read reporting configuration0x11 or 0x31 or
...		0x080x80 0x520x00 0x00 0x000x00 0x00: attributeID
Read reporting configuration response0x11 or 0x31 or
...		0x090x80 0x520xss 0x00 0x00 0x00 0x41 0xmmmm 0xMMMM 0x18 [0xpppp]*120xss:status
0x00 0x00: attributeID
0x41: attribute type
0xmmmm: minimum reporting interval
0xMMMM: maximum reporting interval
Reportable change:
0x18: data length
[0xpppp]*12:
Freq, Freq Min, Freq Max: (Hz/1000)
Vrms, Vrms Min, Vrms Max: V/10
Vpeak, Vpeak Min, Vpeak Max: V/10
OverVoltageNumber,SagNumber, BrownoutNumber: Number (counter)

Read/Write

FeaturesFctrl CmdIDClusterIDAttributeIDStatusAttribute typeDataComment
Read attribute request0x11 or 0x31 or
...		0x000x80 0x520x00 0x00Ask the current power quality measurements
Read attribute response0x11 or 0x31 or
...		0x010x80 0x520x00 0x000x000x410x18 [0xpppp]*120x18: data length
[0xpppp]*12:
Freq, Freq Min, Freq Max: (x+22232)(Hz/1000)
Vrms, Vrms Min, Vrms Max: V/10
Vpeak, Vpeak Min, Vpeak Max: V/10
OverVoltageNumber,SagNumber, BrownoutNumber: Number (counter)

Batch report

Configuration

Feature Fctrl CmdIDClusterIDPayloadComment
Configure reporting0x11 or 0x31 or
...		0x060x80 0x520bsssssss1 0x00 0x00 [0xii 0xmmmm 0xMMMM 0xdddd 0xrrrr 0xtt]...0bsssssss1: obsssssss is the size of configuration string after attributeID (obsssssss1 right shifted)
0x00 0x00: attribute ID
0xii: the index of required field
0,1,2: Freq, Freq Min, Freq Max (Hz/1000)
3,4,5: Vrms,Vrms Min, Vrms Max (V/10)
6,7,8: Vpeak, Vpeak Min, Vpeak Max (V/10)
9,10,11: OverVoltageNumber, SagNumber, BrownoutNumber (number)
0xmmmm: minimum recorting interval
0xMMMM: maximum recorting interval
0xdddd: the required delta value (the size depends on the attribute data type)
0xrrrr: the required resolution value (the size depends on the attribute data type)
0xtt:the tag value
Configure reporting response0x11 or 0x31 or
...		0x070x80 0x520xss 0x01 0x00 0x000xss : status
0x01 : batch
Read reporting configuration0x11 or 0x31 or
...		0x080x80 0x520x01 0x00 0x000x01: Batch
Read reporting configuration response0x11 or 0x31 or
...		0x090x80 0x520xss 0bsssssss1 0x00 0x00 [0xii 0xmmmm 0xMMMM 0xdddd 0xrrrr 0xtt]...0xss : status
0bsssssss1: obsssssss is the size of configuration string after attributeID (obsssssss1 right shifted)
0x00 0x00: attribute ID
0xii: the index of required field
0,1,2: Freq, Freq Min, Freq Max (Hz/1000)
3,4,5: Vrms,Vrms Min, Vrms Max (V/10)
6,7,8: Vpeak, Vpeak Min, Vpeak Max (V/10)
9,10,11: OverVoltageNumber, SagNumber, BrownoutNumber (number)
0xmmmm: minimum recorting interval
0xMMMM: maximum recorting interval
0xdddd: the required delta value (the size depends on the attribute data type)
0xrrrr: the required resolution value (the size depends on the attribute data type)
0xtt:the tag value

Sag cycle Threshold

Standard report

Read/Write

FeaturesFctrl CmdIDClusterIDAttributeIDStatusAttribute typeDataComment
Read attribute request0x11 or 0x31 or
...		0x000x80 0x520x00 0x01Ask the current over sag Cycle threshold: Number of voltage half cycle under Sag Voltage Treshold to increment SagNumber.
Default value: 2 (1 cycle => 20 ms at 50 Hz)
Read attribute response0x11 or 0x31 or
...		0x010x80 0x520x00 0x010x000x200xpppp0xpppp: Sag half cycle threshold in number (0...255)
Write attribute no response0x11 or 0x31 or
...		0x050x80 0x520x00 0x010x200xpppp0xpppp: Sag half cycle threshold in (V/10)

Sag voltage Threshold

Standard report

Read/Write

FeaturesFctrl CmdIDClusterIDAttributeIDStatusAttribute typeDataComment
Read attribute request0x11 or 0x31 or
...		0x000x80 0x520x00 0x02Ask the current Sag voltage threshold
Voltage Peak Treshold under which a Sag is consider to increment SagNumber.
Default value: 260V peak
Read attribute response0x11 or 0x31 or
...		0x010x80 0x520x00 0x020x000x210xpppp0xpppp: Sag voltage threshold (V/10)
Write attribute no response0x11 or 0x31 or
...		0x050x80 0x520x00 0x020x210xpppp

Over voltage Threshold

Standard report

Read/Write

FeaturesFctrl CmdIDClusterIDAttributeIDStatusAttribute typeDataComment
Read attribute request0x11 or 0x31 or
...		0x000x80 0x520x00 0x03Ask the current over voltage threshold
Voltage peak Treshold over which a OvrVoltageNumber is incremented.
Default value: 390V peak
Read attribute response0x11 or 0x31 or
...		0x010x80 0x520x00 0x030x000x210xpppp0xpppp : peak over voltage threshold in (V/10)
Write attribute no response0x11 or 0x31 or
...		0x050800 0x520x00 0x030x210xpppp

Cluster commands

FeaturesFctrl CmdIDClusterIDDataComment
Reset power quality fields0x11 or 0x31 or
...		0x500x80 0x520x00 0xrrRequest reset of accumulated fields :
0xrr: Bitfield for which
b0: Reset Freq Min&Max (0xFFFF and 0x0000)
b1: Reset VRMS Min&Max (0xFFFF and 0x0000)
b2: Reset VPeak Min&Max (0xFFFF and 0x0000)
b3: Reset SAGNumber(0x0000)
b4: Reset OverVoltageNumber (0x0000)
b4: Reset OverBrownoutNumber (0x0000)

 

Print Friendly