---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.0
alternate:
  - https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/zigbee-devices.md
  - https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/zigbee-devices.md
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/zigbee-devices.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741

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

<!-- source: ru/_includes/reusables/neuroexpert-button.md -->



<!-- endsource: ru/_includes/reusables/neuroexpert-button.md -->


[Хабы Яндекса с Zigbee](https://yandex.ru/alice/support/smart-home/devices.html) поддерживают протокол Zigbee 3.0. С помощью этой технологии можно подключать устройства умного дома напрямую.


## Что поддерживается {#clusters}

Чтобы умные устройства различных производителей могли совместно работать в одной беспроводной сети, нужен стандартный язык общения между ними. В роли такого языка выступает библиотека кластеров 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 и атрибуты, то оно без дополнительных действий подключится к платформе умного дома.


## Какие есть ограничения {#cluster-restrictions}

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

#|
||
**Тип устройства в платформе умного дома**
|
**Zigbee Device ID (ZHA)**
|
**Разрешенные кластеры**
||

||
[devices.types.light](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/device-type-light.md)
|
`OnOffLight = 0x0100`
|
`OnOffCluster`, `LevelCluster`, `ColorControlCluster`
||

||
[devices.types.light](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/device-type-light.md)
|
`DimmableLight = 0x0101`
|
`OnOffCluster`, `LevelCluster`, `ColorControlCluster`
||

||
[devices.types.light](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/device-type-light.md)
|
`ColorDimmableLight = 0x0102`
|
`OnOffCluster`, `LevelCluster`, `ColorControlCluster`
||

||
[devices.types.light](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/device-type-light.md)
|
`ColorTemperatureLight = 0x010c`
|
`OnOffCluster`, `LevelCluster`, `ColorControlCluster`
||

||
[devices.types.socket](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/device-type-socket.md)
|
`SmartPlug = 0x0051`
|
`OnOffCluster`
||

||
[devices.types.socket](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/device-type-socket.md)
|
`OnOffPlugInUnit = 0x010a`
|
`OnOffCluster`
||

||
[devices.types.socket](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/device-type-socket.md)
|
`DimmablePlugInUnit = 0x010b`
|
`OnOffCluster, LevelCluster`
||

||
[devices.types.other](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/device-type-other.md)
|
`OnOffBallast = 0x0108`
|
`OnOffCluster`
||

||
[devices.types.other](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/device-type-other.md)
|
`DimmableBallast = 0x0109`
|
`OnOffCluster`, `LevelCluster`
||
|#

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

## Как добавить поддержку своего устройства {#extra-clusters}

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

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

<div style="padding: 15px;
     margin: 10px 0;
     background: #FFFFFF;
     border-radius: 10px;
     border: 1px solid var(--yc-color-line-generic);">
  <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.ru/surveys/13471086.33397f43c59be78b4363d1ee3ac7cf0d05b01f92/?&iframe=1">
  </iframe>
</div>


<!-- source: ru/_includes/about/id-support/support-button.md -->
[![Служба поддержки](../_images/support-image.svg)](https://yandex.ru/dev/dialogs/smart-home/doc/ru/feedback.md)
<!-- endsource: ru/_includes/about/id-support/support-button.md -->


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


