SPM/SDM Zigbee Cluster Reference

This document details the device access standards, data models (Clusters/Attributes), and interaction commands for our Zigbee Smart Meter series (Single-Phase, Split-Phase, and Three-Phase).

Status: Stable | Applies to: SPM/SDM Standard Zigbee 3.0 Version | Firmware: V10+ | Updated: 2026-04-25 | What's New: Re-organize the document to make it more readable

---

1. Device Overview

This profile applies to the following smart meter models. All devices communicate via the standard Zigbee 3.0 protocol with the default Endpoint set to 1.

Single-phase Type (SPM01-xxTZ-U01)

#	Ordering Number	Description
1	SPM01-D2TZ-U01	SPM01 1PN FLEX/63A Standard Zigbee
2	SPM01-D1TZ-U01	SPM01 1PN MCBM-DM/63A Standard Zigbee
3	SPM01-U1TZ-U01	SPM01 1PN MCBM-UM/63A Standard Zigbee

Split-phase Type (SDM02-TZ-*-U01)

#	Ordering Number	Description
1	SDM02-TZ-12-U01	SDM02 Split-Phase SCTA-2×120A/Φ16 Standard Zigbee
2	SDM02-TZ-20-U01	SDM02 Split-Phase SCTA-2×200A/Φ20 Standard Zigbee
3	SDM02-TZ-10U-U01	SDM02 Split-Phase SCTA-2×100A/Φ12-UL2808 Standard Zigbee

Three-phase Type (SPM02-xxTZ-U01; SDM01-TZM-*-U01)

#	Ordering Number	Description
1	SPM02-D2TZ-U01	SPM02 3PN FLEX/63A Standard Zigbee
2	SPM02-D1TZ-U01	SPM02 3PN MCBM-DM/63A Standard Zigbee
3	SPM02-U1TZ-U01	SPM02 3PN MCBM-UM/63A Standard Zigbee
4	SDM01-TZM-12-U01	SDM01 SCTA-3×120A/Φ16 Zigbee (Std. ZB3.0) + RS485
5	SDM01-TZM-20-U01	SDM01 SCTA-3×200A/Φ20 Zigbee (Std. ZB3.0) + RS485

💡 User Best Practices

1. Default Reporting Configuration: For all reportable attributes, the default configuration is Report Min Interval: 30s, Report Max Interval: 30s, and Report Changeable: 0. This means the device is factory-defaulted to automatically report its data every 30 seconds.

2. Multipliers & Divisors: It is highly recommended to read all multiplier and divisor parameters only once upon device power-on/network joining. Do not configure reporting for these static parameters to avoid network congestion.

3. Calculation Formula: Actual Value = Raw Value * Multiplier / Divisor

---

2. Common Clusters

The following Clusters are identical across all Single-Phase, Two-Phase, and Three-Phase devices.

Basic (0x0000)

ID	Attribute Name	Data Type	Access	Description
0x0000	ZCLVersion	uint8	Read Only	ZCL Protocol Version
0x0001	ApplicationVersion	uint8	Read Only	Application Version
0x0002	StackVersion	uint8	Read Only	Stack Version
0x0003	HWVersion	uint8	Read Only	Hardware Version
0x0004	ManufacturerName	string	Read Only	Manufacturer Name
0x0005	ModelIdentifier	string	Read Only	Model Identifier
0x4000	SWBuildID	string	Read Only	Software Build ID

Identify (0x0003)

ID / Cmd	Name	Data Type	Access	Description
Attr 0x0000	IdentifyTime	uint16	Read & Write	Device Locating (Requires Firmware V10 or higher )
Cmd 0x00	Identify	-	Command	Device LED blinks at 5Hz for 15s
Cmd 0x01	Identify Query	-	Command	Query Identify status

On/Off (0x0006)

⚠️ Warning: This Cluster does NOT control a physical relay. It is ONLY used for Resetting Accumulated Energy (clearing the total kWh data to zero). Default value is OFF. (Requires Firmware V10+)

ID / Cmd	Name	Data Type	Access	Description
Attr 0x0000	OnOff	bool	Read/Report/Set	Energy Reset Status
Cmd 0x00	Off	-	Command	No action
Cmd 0x01	On	-	Command	Execute Energy Reset (Clear kWh to 0)

Diagnostics (0x0B05) & OTA (0x0019)

• Diagnostics (0x0B05):

  • Attr 0x011C LastMessageLQI (Read Only)

  • Attr 0x011D LastMessageRSSI (Read Only)

• OTA (0x0019): Supports standard Zigbee OTA upgrade processes.

---

3. Electrical Measurement (0x0B04)

This Cluster is used to read real-time electrical measurement data (Voltage, Current, Power, Frequency, etc.). Please select the tab corresponding to your device type:

Single-Phase

ID	Attribute Name	Data Type	Access	Unit	Description
0x0300	ACFrequency	uint16	Report & Read	Hz	AC Frequency
0x0400	ACFrequencyMultiplier	uint16	Report & Read	-	AC Frequency Multiplier
0x0401	ACFrequencyDivisor	uint16	Report & Read	-	AC Frequency Divisor
0x0505	RMSVoltage	uint16	Report & Read	V	RMS Voltage (Phase A / Single Phase)
0x0508	RMSCurrent	uint16	Report & Read	A	RMS Current (Phase A / Single Phase)
0x050B	ActivePower	int16	Report & Read	W	Active Power (Phase A / Single Phase)
0x050F	ApparentPower	uint16	Report & Read	VA	Apparent Power (Phase A / Single Phase)
0x0510	PowerFactor	int8	Report & Read	%	Power Factor (Phase A / Single Phase)
0x0600	ACVoltageMultiplier	uint16	Report & Read	-	AC Voltage Multiplier
0x0601	ACVoltageDivisor	uint16	Report & Read	-	AC Voltage Divisor
0x0602	ACCurrentMultiplier	uint16	Report & Read	-	AC Current Multiplier
0x0603	ACCurrentDivisor	uint16	Report & Read	-	AC Current Divisor
0x0604	ACPowerMultiplier	uint16	Report & Read	-	AC Power Multiplier
0x0605	ACPowerDivisor	uint16	Report & Read	-	AC Power Divisor

Two-Phase/Split-Phase

ID	Attribute Name	Data Type	Access	Unit	Description
Global Measurements
0x0300	ACFrequency	uint16	Report & Read	Hz	AC Frequency
0x0304	TotalActivePower	int32	Report & Read	W	Total Active Power
0x0305	TotalReactivePower	int32	Report & Read	VAr	Total Reactive Power
0x0306	TotalApparentPower	uint32	Report & Read	VA	Total Apparent Power
0x0400	ACFrequencyMultiplier	uint16	Report & Read	-	AC Frequency Multiplier
0x0401	ACFrequencyDivisor	uint16	Report & Read	-	AC Frequency Divisor
Phase A Measurements
0x0505	RMSVoltage	uint16	Report & Read	V	Phase A RMS Voltage
0x0508	RMSCurrent	uint16	Report & Read	A	Phase A RMS Current
0x050B	ActivePower	int16	Report & Read	W	Phase A Active Power
0x050E	ReactivePower	int16	Report & Read	VAr	Phase A Reactive Power
0x050F	ApparentPower	uint16	Report & Read	VA	Phase A Apparent Power
0x0510	PowerFactor	int8	Report & Read	%	Phase A Power Factor
Global Multipliers & Divisors					(Applies to all phases)
0x0600	ACVoltageMultiplier	uint16	Report & Read	-	AC Voltage Multiplier
0x0601	ACVoltageDivisor	uint16	Report & Read	-	AC Voltage Divisor
0x0602	ACCurrentMultiplier	uint16	Report & Read	-	AC Current Multiplier
0x0603	ACCurrentDivisor	uint16	Report & Read	-	AC Current Divisor
0x0604	ACPowerMultiplier	uint16	Report & Read	-	AC Power Multiplier
0x0605	ACPowerDivisor	uint16	Report & Read	-	AC Power Divisor
Phase B Measurements
0x0905	RMSVoltage	uint16	Report & Read	V	Phase B RMS Voltage
0x0908	RMSCurrent	uint16	Report & Read	A	Phase B RMS Current
0x090B	ActivePower	int16	Report & Read	W	Phase B Active Power
0x090E	ReactivePower	int16	Report & Read	VAr	Phase B Reactive Power
0x090F	ApparentPower	uint16	Report & Read	VA	Phase B Apparent Power
0x0910	PowerFactor	int8	Report & Read	%	Phase B Power Factor

Three-Phase

ID	Attribute Name	Data Type	Access	Unit	Description
Global Measurements
0x0300	ACFrequency	uint16	Report & Read	Hz	AC Frequency
0x0304	TotalActivePower	int32	Report & Read	W	Total Active Power
0x0305	TotalReactivePower	int32	Report & Read	VAr	Total Reactive Power
0x0306	TotalApparentPower	uint32	Report & Read	VA	Total Apparent Power
0x0400	ACFrequencyMultiplier	uint16	Report & Read	-	AC Frequency Multiplier
0x0401	ACFrequencyDivisor	uint16	Report & Read	-	AC Frequency Divisor
Phase A Measurements
0x0505	RMSVoltage	uint16	Report & Read	V	Phase A RMS Voltage
0x0508	RMSCurrent	uint16	Report & Read	A	Phase A RMS Current
0x050B	ActivePower	int16	Report & Read	W	Phase A Active Power
0x050E	ReactivePower	int16	Report & Read	VAr	Phase A Reactive Power
0x050F	ApparentPower	uint16	Report & Read	VA	Phase A Apparent Power
0x0510	PowerFactor	int8	Report & Read	%	Phase A Power Factor
Global Multipliers & Divisors					(Applies to all phases)
0x0600	ACVoltageMultiplier	uint16	Report & Read	-	AC Voltage Multiplier
0x0601	ACVoltageDivisor	uint16	Report & Read	-	AC Voltage Divisor
0x0602	ACCurrentMultiplier	uint16	Report & Read	-	AC Current Multiplier
0x0603	ACCurrentDivisor	uint16	Report & Read	-	AC Current Divisor
0x0604	ACPowerMultiplier	uint16	Report & Read	-	AC Power Multiplier
0x0605	ACPowerDivisor	uint16	Report & Read	-	AC Power Divisor
Phase B Measurements
0x0905	RMSVoltage	uint16	Report & Read	V	Phase B RMS Voltage
0x0908	RMSCurrent	uint16	Report & Read	A	Phase B RMS Current
0x090B	ActivePower	int16	Report & Read	W	Phase B Active Power
0x090E	ReactivePower	int16	Report & Read	VAr	Phase B Reactive Power
0x090F	ApparentPower	uint16	Report & Read	VA	Phase B Apparent Power
0x0910	PowerFactor	int8	Report & Read	%	Phase B Power Factor
Phase C Measurements
0x0A05	RMSVoltage	uint16	Report & Read	V	Phase C RMS Voltage
0x0A08	RMSCurrent	uint16	Report & Read	A	Phase C RMS Current
0x0A0B	ActivePower	int16	Report & Read	W	Phase C Active Power
0x0A0E	ReactivePower	int16	Report & Read	VAr	Phase C Reactive Power
0x0A0F	ApparentPower	uint16	Report & Read	VA	Phase C Apparent Power
0x0A10	PowerFactor	int8	Report & Read	%	Phase C Power Factor

4. Metering (0x0702)

This Cluster is used to read the accumulated energy data (Delivered/Received energy).

💡 Implementation Note for Multi-Phase Energy In the standard Zigbee ZCL specification, the Tier 1/2/3 attributes are originally designed for Time-of-Use (TOU) pricing. To simplify gateway integration and keep all data unified on a single Endpoint (EP1), we have mapped these Tier attributes to represent the individual phase energy:

• Tier 1 maps to Phase A

• Tier 2 maps to Phase B

• Tier 3 maps to Phase C

Single-Phase

ID	Attribute Name	Data Type	Access	Unit	Description
0x0000	CurrentSummationDelivered	uint48	Report & Read	kWh	Total forward energy
0x0001	CurrentSummationReceived	uint48	Report & Read	kWh	Total reverse energy
0x0301	Multiplier	uint24	Read Only	-	Energy Multiplier
0x0302	Divisor	uint24	Read Only	-	Energy Divisor

Two-Phase / Split-Phase

ID	Attribute Name	Data Type	Access	Unit	Description
0x0000	CurrentSummationDelivered	uint48	Report & Read	kWh	Total forward energy
0x0001	CurrentSummationReceived	uint48	Report & Read	kWh	Total reverse energy
0x0100	CurrentTier1SummationDelivered	uint48	Report & Read	kWh	Phase A forward energy (Requires Firmware V11+)
0x0101	CurrentTier1SummationReceived	uint48	Report & Read	kWh	Phase A reverse energy (Requires Firmware V11+)
0x0102	CurrentTier2SummationDelivered	uint48	Report & Read	kWh	Phase B forward energy (Requires Firmware V11+)
0x0103	CurrentTier2SummationReceived	uint48	Report & Read	kWh	Phase B reverse energy (Requires Firmware V11+)
0x0301	Multiplier	uint24	Read Only	-	Energy Multiplier
0x0302	Divisor	uint24	Read Only	-	Energy Divisor

Three-Phase

ID	Attribute Name	Data Type	Access	Unit	Description
0x0000	CurrentSummationDelivered	uint48	Report & Read	kWh	Total forward energy
0x0001	CurrentSummationReceived	uint48	Report & Read	kWh	Total reverse energy
0x0100	CurrentTier1SummationDelivered	uint48	Report & Read	kWh	Phase A forward energy (Requires Firmware V11+)
0x0101	CurrentTier1SummationReceived	uint48	Report & Read	kWh	Phase A reverse energy (Requires Firmware V11+)
0x0102	CurrentTier2SummationDelivered	uint48	Report & Read	kWh	Phase B forward energy (Requires Firmware V11+)
0x0103	CurrentTier2SummationReceived	uint48	Report & Read	kWh	Phase B reverse energy (Requires Firmware V11+)
0x0104	CurrentTier3SummationDelivered	uint48	Report & Read	kWh	Phase C forward energy (Requires Firmware V11+)
0x0105	CurrentTier3SummationReceived	uint48	Report & Read	kWh	Phase C reverse energy (Requires Firmware V11+)
0x0301	Multiplier	uint24	Read Only	-	Energy Multiplier
0x0302	Divisor	uint24	Read Only	-	Energy Divisor

5. Custom Cluster

Modbus CFG (0xFC00)

This is our proprietary Custom Cluster, specifically designed for configuring devices with Modbus functionality.

⚠️ Prerequisites & Requirements

• Applicable Models: Only SDM01 Combo (3-phase version with Modbus).

• Version Requirement: Requires Firmware V10+.

• Authentication: Reading and writing to this Cluster requires the Manufacturer Code 0x1216 to be included in the Zigbee payload.

ID	Attribute Name	Data Type	Access	Default	Description
0x0000	SlaveID	uint8	Read & Write	247	Modbus Slave ID / Address
0x0001	BaudRate	enum8	Read & Write	19200	Communication Baud Rate
0x0002	ParityStop	enum8	Read & Write	N81	Parity & Stop Bit Configuration