Controlling devices directly via Zigbee™

Yango hubs with Zigbee support Zigbee 3.0. With this technology, you can connect smart home devices directly.

What is supported

For smart devices from different vendors on the same wireless network to interact, they need a standard communication language. The Zigbee Cluster Library (ZCL) fills that role. It's a set of features and operations that devices in a Zigbee network can perform.

Clusters are groups of related attributes and commands supported by devices. For example, there are clusters for temperature measurement, light control, and more.

What we currently support:


Cluster	Attributes	Commands
`OnOffCluster`	`OnOff = 0x0000`	`Off = 0x00` `On = 0x01` `Toggle = 0x02`
`LevelCluster`	`CurrentLevel = 0x0000`	`MoveToLevel = 0x00` `MoveToLevelWithOnOff = 0x04`
`ColorControlCluster`	`ColorTemperatureMireds = 0x0007`	`MoveToColorTemperature = 0x0A`
`IlluminanceMeasurementCluster`	`MeasuredValue = 0x0000`	—
`TemperatureMeasurementCluster`	`MeasuredValue = 0x0000` `MinMeasuredValue = 0x0001` `MaxMeasuredValue = 0x0002` `Tolerance = 0x0003`	—
`PressureMeasurementCluster`	`MeasuredValue = 0x0000` `MinMeasuredValue = 0x0001` `MaxMeasuredValue = 0x0002` `Tolerance = 0x0003`	—
`RelativeHumidityCluster`	`MeasuredValue = 0x0000` `MinMeasuredValue = 0x0001` `MaxMeasuredValue = 0x0002` `Tolerance = 0x0003`	—
`OccupancySensingCluster`	`Occupancy = 0x0000` `OccupancySensorType = 0x0001`	—


Cluster	Attributes	Commands
`OnOffCluster`	`OnOff = 0x0000`	`Off = 0x00` `On = 0x01` `Toggle = 0x02`
`LevelCluster`	`CurrentLevel = 0x0000`	`MoveToLevel = 0x00` `MoveToLevelWithOnOff = 0x04`
`ColorControlCluster`	`ColorTemperatureMireds = 0x0007`	`MoveToColorTemperature = 0x0A`
`IlluminanceMeasurementCluster`	`MeasuredValue = 0x0000`	—
`TemperatureMeasurementCluster`	`MeasuredValue = 0x0000` `MinMeasuredValue = 0x0001` `MaxMeasuredValue = 0x0002` `Tolerance = 0x0003`	—
`PressureMeasurementCluster`	`MeasuredValue = 0x0000` `MinMeasuredValue = 0x0001` `MaxMeasuredValue = 0x0002` `Tolerance = 0x0003`	—
`RelativeHumidityCluster`	`MeasuredValue = 0x0000` `MinMeasuredValue = 0x0001` `MaxMeasuredValue = 0x0002` `Tolerance = 0x0003`	—
`OccupancySensingCluster`	`Occupancy = 0x0000` `OccupancySensorType = 0x0001`	—

If a device transmits the Device ID and attributes over the protocol correctly, it connects right to the smart home platform.

What restrictions apply

For some Device IDs, there is a restriction on clusters that can be added to the respective devices. Clusters that are not included in the list of allowed ones currently are not supported by these devices.


Smart home device type	Zigbee Device ID (ZHA)	Allowed clusters
devices.types.light	`OnOffLight = 0x0100`	`OnOffCluster`, `LevelCluster`, `ColorControlCluster`
	`DimmableLight = 0x0101`
	`ColorDimmableLight = 0x0102`
	`ColorTemperatureLight = 0x010c`
devices.types.socket	`SmartPlug = 0x0051`	`OnOffCluster`
	`OnOffPlugInUnit = 0x010a`	`OnOffCluster`
	`DimmablePlugInUnit = 0x010b`	`OnOffCluster, LevelCluster`
devices.types.other	`OnOffBallast = 0x0108`	`OnOffCluster`
devices.types.other	`DimmableBallast = 0x0109`	`OnOffCluster`, `LevelCluster`


Smart home device type	Zigbee Device ID (ZHA)	Allowed clusters
devices.types.light	`OnOffLight = 0x0100`	`OnOffCluster`, `LevelCluster`, `ColorControlCluster`
	`DimmableLight = 0x0101`
	`ColorDimmableLight = 0x0102`
	`ColorTemperatureLight = 0x010c`
devices.types.socket	`SmartPlug = 0x0051`	`OnOffCluster`
	`OnOffPlugInUnit = 0x010a`	`OnOffCluster`
	`DimmablePlugInUnit = 0x010b`	`OnOffCluster, LevelCluster`
devices.types.other	`OnOffBallast = 0x0108`	`OnOffCluster`
devices.types.other	`DimmableBallast = 0x0109`	`OnOffCluster`, `LevelCluster`

The restrictions do not apply to other Device IDs. Devices will connect if there is at least one supported cluster.


Zigbee™ is a trademark of the Connectivity Standards Alliance.