Управление устройствами напрямую через протокол Zigbee™

Хабы Яндекса с Zigbee поддерживают протокол Zigbee 3.0. С помощью этой технологии можно подключать устройства умного дома напрямую.

Что поддерживается

Чтобы умные устройства различных производителей могли совместно работать в одной беспроводной сети, нужен стандартный язык общения между ними. В роли такого языка выступает библиотека кластеров Zigbee ZCL (Zigbee Cluster Library) — набор функций и операций, которые могут выполнять устройства в сети Zigbee.

Кластер обозначает группу связанных атрибутов и команд, которые поддерживаются устройствами. Например, есть кластеры для измерения температуры, управления освещением и т. д.

Что мы поддерживаем сейчас:

Кластер	Атрибуты	Команды
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	—

Если устройство корректно передает по протоколу Device ID и атрибуты, то оно без дополнительных действий подключится к платформе умного дома.

Какие есть ограничения

Для некоторых Device ID есть ограничение на кластеры, которые могут быть добавлены к этим устройствам. Кластеры, которые не входят в список разрешенных, пока не поддерживаются этими устройствами.

Тип устройства в платформе умного дома	Zigbee Device ID (ZHA)	Разрешенные кластеры
devices.types.light	OnOffLight = 0x0100	OnOffCluster, LevelCluster, ColorControlCluster
devices.types.light	DimmableLight = 0x0101	OnOffCluster, LevelCluster, ColorControlCluster
devices.types.light	ColorDimmableLight = 0x0102	OnOffCluster, LevelCluster, ColorControlCluster
devices.types.light	ColorTemperatureLight = 0x010c	OnOffCluster, LevelCluster, ColorControlCluster
devices.types.socket	SmartPlug = 0x0051	OnOffCluster
devices.types.socket	OnOffPlugInUnit = 0x010a	OnOffCluster
devices.types.socket	DimmablePlugInUnit = 0x010b	OnOffCluster, LevelCluster
devices.types.other	OnOffBallast = 0x0108	OnOffCluster
devices.types.other	DimmableBallast = 0x0109	OnOffCluster, LevelCluster

На другие Device ID ограничения не распространяются. Устройства подключатся, если будет хотя бы один из поддерживаемых кластеров.

Как добавить поддержку своего устройства

Поддержка дополнительных кластеров и нестандартных спецификаций для работы с хабами напрямую выполняется командой разработки Яндекса.

Если вы хотите, чтобы мы рассмотрели ваше устройство для добавления в платформу, заполните форму:

Zigbee™ является товарным знаком Connectivity Standards Alliance.