Эта страница является переводом страницы ZigBee. Перевод выполнен на 25%.

---

iRidium for ZigBee

how iRidium server gets access to ZigBee wireless network

documentation was last updated on 03.11.2021

Only the following hardware server can work with ZigBee:

iRidium server UMC C3 with a built-in ZigBee* module (for Russian market only).

* - out of production.

iRidium server does not support all ZigBee devices and functions. "Working with Commands and Feedbacks" section contains information about supported ZigBee classes.

Протестированное оборудование

Legrand Netatmo:

• AG07556 - одноклавишный (двухкнопочный), встраиваемый выключатель света (диммер);
• AG0777 - одноклавишный (двухкнопочный), встраиваемый контроллер штор;
• AG08761 - беспроводной одноклавишный выключатель;
• AG08763 - беспроводной контроллер штор;
• AG08761 - беспроводной двухклавишный выключатель.

Danfoss Icon:

• 088U1122 - Room Thermostat;
• 088U1105 - Radio Module;
• 088U1141 - Master Controller OTA;
• 088H3110 - TWA-A NC;
• 088U1130 - Zigbee Module.

Advantages

One of the main spheres of ZigBee use is home automation
ZigBee devices

• can organize mesh-networks that provide self-repair and guaranteed data delivery in cases of connection loss, appearance of obstacles or malfunction of a network item
• are characterized by low power consumptiona and can work on regular batteries, thus, no cable is required.
• can exchange data at a distance of several dozen meters from each other (if located in the line of sight)

There are a lot of devices with ZigBee interface on the market. Developers now have a splendid opportunity to integrate all these devices with iRidium platform.

Adding Devices to the Network

1Подайте питание на сервер.
2Войдите в веб-интерфейс сервера.
3Перейдите на вкладку ZigBee (beta).

4Нажмите кнопку Settings для настройки сети ZigBee.

5Настройте стик или встроенный модуль ZigBee (только для UMC) в соответствии с его техническими характеристиками.

Настройка USB стиков:

Настройка ZigBee модуля.

• Elelabs Zigbee USB Adapter
  • Baud Rate: 115200,
  • Data Bits: 8,
  • Parity: None,
  • Stop Bits: 1.

• DEFARO SPRUTSTICK PRO
  • Baud Rate: 115200,
  • Data Bits: 8,
  • Parity: None,
  • Stop Bits: 1.

• Nortek HUSBZB
  • Baud Rate: 57600,
  • Data Bits: 8,
  • Parity: None,
  • Stop Bits: 1.

• Для ОС Windows
  • Подключите USB-стик;
  • Зайдите в диспетчер устройств и найдите ваш USB-стик. После его имени в скобках будет отображено имя порта, к которому он подключен (в нашем примере: COM7).

Если устройство отображается как неизвестное устройство, обновите драйвера для данного стика.

• Для OC Linux
  • Подключите USB-стик;
  • Установка дополнительных драйверов не требуется. Для выбора порта стика очистите поле Serial Port и выберете из предложенных вариантов ваш стик.

6Нажмите кнопку Create Network для создания новой сети.

7Нажмите на кнопку Open Network. В течение 180 секунд сервер будет сканировать радиоканал. В это время выполните определенные физические действия с добавляемым беспроводным устройством. Как правило, требуется несколько раз нажать кнопку на устройстве (прочитайте руководство по эксплуатации вашего устройства, чтобы узнать точно, какие действия требуется выполнить).

Пример добавления устройства Legrand:

1 Удалите защитный язычок;

2 Удерживайте кнопку пока не загорится светодиод;

3 Нажмите на кнопку еще раз чтобы светодиод замигал (мигающий светодиод показывает, что устройство доступно для подключения к ZigBee);

4 Дождитесь когда устройство отобразится в web интерфейсе.

5The device is added to the list and it gets an "ID". Add all required devices to your net.

Device name can be enteres in User description field.
7After it the network is created. Export data about the created network as a .xml file by clicking the Export button.

To delete a device from the network, use Delete button. After it press the physical button three times on the device that you want to delete (or do another action described in the manual). The whole network can be deletd by clicking Delete Network button.

Working in iRidium studio

Adding ZigBee driver

1Create server project in iRidium studio. Click a button to import the .xml file (ZigBee XML Files).

2Выберите необходимые устройства для добавления в проект.

3The driver with all devices appears in the Project Device Panel.

4You can change device names ("Name"). Names in iRidium studio can differ from name in the server web-interface. The other parameters can't be edited.

Настройка команд и фидбеков

Для управления оборудованием настройте команды (Commands) и каналы обратной связи (Feedbacks). Чтобы отправить команду, перетяните ее на графический элемент и укажите значение (Value), которое необходимо отправить. Чтобы отобразить значение с канала обратной связи, перетащите Feedback на графический элемент, и укажите, каким образом вывести значение (Value).

Подробнее о работе с графическими элементами написано в статье "Типы графических элементов".

You will find below information about supported classes of ZigBee, its commands and feedbacks.

Information about supported ZigBee functions

OnOff

Команда для переключения устройств между состояниями включено и выключено.

Имя команды или обратной связи	Тип	Допустимые значения	Описание
Set state	Command	OFF - 0, ON - 1	Установить состояние выключателя.
Off	Command	Any value	Установить состояние выключателя на выключено.
On	Command	Any value	Установить состояние выключателя на включено.
Toggle	Command	Any value	Переключить выключатель на противоположное состояние.
State	Feedbacks	0 / 1	Текущее состояние выключателя.
Off Event*	Feedbacks	0	Получить событие при выключении выключателя.
On Event*	Feedbacks	0	Получить событие при включении выключателя.
Toggle Event*	Feedbacks	0	Получить событие при переключении состояния выключателя.

Event * - это событие, которое фидбек получает от оборудования при изменении его состояния. Событие нельзя вывести на графический элемент интерфейса, его значение будет отображаться всегда 0.

С помощью настройки Forward value to событие можно передать в команду и таким образом объединить несколько устройств. Например, при включении выключателя (On Event) мы отправляем событие в команду(On) на реле, чтобы включить свет.

Также, при срабатывании Event’ов будет происходить сработка слушателей EVENT TAG CHANGE и EVENT GLOBAL TAG CHANGE.

Level

Этот кластер предоставляет интерфейс для управления характеристикой устройства, которая может быть установлена ​​на уровне, например: яркость света, степень закрытия двери или мощность обогревателя. В большинстве случаев идет в тандеме с классом OnOff.

Имя команды или обратной связи	Тип	Допустимые значения	Описание
Set Value	Command	0 - 255	Установить значение уровня.
Read Value	Command	0 - 255	Принудительно запросить значение уровня.
Move Up	Command	0 - 255	Запустить увеличение значения уровня. Переданное в канал значение будет использоваться как “скорость увеличения” и указывается как единицы в секунду.
Move Down	Command	0 - 255	Запустить уменьшение значения уровня. Переданное в канал значение будет использоваться как "скорость увеличения" и указывается как единицы в секунду.
Step Up	Command	0 - 255	Увеличить значение уровня на определенный шаг. Переданное в канал значение будет использоваться как значение шага.
Step Down	Command	0 - 255	Уменьшить значение уровня на определенный шаг. Переданное в канал значение будет использоваться как значение шага.
Stop	Command	Any value	Прекратить изменение значения уровня.
Value	Feedbacks	0 - 255	Текущее значение уровня.
Move Event	Feedbacks	0 / 1	Событие плавного изменения значения уровня: 0 - движение вверх, 1 - движение вниз.
Move Rate	Feedbacks	0 - 255	Cкорость изменения значения уровня при событии Move.
Step Event	Feedbacks	0 / 1	Событие изменения уровня по шагу: 0 - шаг вверх, 1 - шаг вниз.
Step Size	Feedbacks	0 - 255	Размер шага при событии Step.
Stop Event	Feedbacks	0	Событие остановки изменения уровня.

Power

Атрибуты для определения подробной информации об уровне напряжения и заряда батареи.

Имя команды или обратной связи	Тип	Допустимые значения	Описание
Read Power	Command	Any value	Принудительно запросить значения.
Battery Voltage	Feedback	0 - 255	Текущее напряжение батареи в единицах 100mV.
Battery Percentage	Feedback	0 - 200	Текущий процент заряда батареи: 0 - 0%, 100 - 50%, 200 - 100%, 255 - неверное значение.

Binary Input

Кластер двоичного ввода (базовый) предоставляет интерфейс для считывания значения двоичного измерения и доступа к различным характеристикам этого измерения. Кластер обычно используется для реализации датчика, который измеряет физическую величину с двумя состояниями.

Имя команды или обратной связи	Тип	Допустимые значения	Описание
Read state	Command	Any value	Принудительно запросить текущее значение.
State	Feedback	0 / 1	Состояние входа.
Out of service	Feedback	0 / 1	Канал находится в состоянии обслуживания.

Multistate Input

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

Имя команды или обратной связи	Тип	Допустимые значения	Описание
Read state	Command	Any value	Принудительно запросить текущее значение.
State	Feedback	0 - 65535	Состояние входа.
Out of service	Feedback	0 / 1	Канал находится в состоянии обслуживания.

Curtain

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

Имя команды или обратной связи	Тип	Допустимые значения	Описание
Up	Command	Any value	Открыть / Поднять штору.
Down	Command	Any value	Закрыть / Опустить штору.
Stop	Command	Any value	Остановить открытие / закрытие шторы.
Lift To Value	Command	0 - 65535	Открыть штору до заданного значения.
Lift To Percentage	Command	0 - 100	Открыть штору до заданного процента.
Current Lift Value	Feedback	0 - 65535	Текущее значение открытия штор.
Current Lift Percentage	Feedback	0 - 100	Текущий процент открытия штор.
Tilt To Value	Command	0 - 65535	Повернуть рольставню до заданного значения.
Tilt To Percentage	Command	0 - 100	Повернуть рольставню до заданного процента.
Current Tilt Value	Feedback	0 - 65535	Текущее значение поворота рольставни.
Current Tilt Percentage	Feedback	0 - 100	Текущий процент поворота рольставни.

Humidity

Кластер обеспечивает интерфейс для функций измерения относительной влажности.

Имя команды или обратной связи	Тип	Допустимые значения	Описание
Value	Feedback	0.0 - 100.0	Текущий процент влажности.

Temperature Measurement

Кластер обеспечивает интерфейс для функций измерения температуры.

Имя команды или обратной связи	Тип	Допустимые значения	Описание
Value	Feedback	-273.15 - 327.67 ºC	Текущая температура в градусах Цельсия.

Pressure Measurement

Кластер предоставляет интерфейс для функций измерения атмосферного давления.

Имя команды или обратной связи	Тип	Допустимые значения	Описание
Value	Feedback	-3276.7 - 3276.7 kPa	Текущее атмосферное давление.

Occupancy Sensing

Кластер серверов предоставляет интерфейс для функций определения присутствия, включая настройку и предоставление уведомлений о присутствия.

Имя команды или обратной связи	Тип	Допустимые значения	Описание
State	Feedback	0 / 1	Состояние присутствия.

Electrical Measurement

Этот кластер предоставляет механизм для запроса данных об электрических свойствах, измеренных устройством.

Имя команды или обратной связи	Тип	Допустимые значения	Описание
Read Measurements	Command	Any value	Принудительно запросить текущие измерения.
DC Voltage	Feedback	Any value	Напряжение постоянного тока в вольтах.
DC Current	Feedback	Any value	Значение постоянного тока в амперах.
DC Power	Feedback	Any value	Мощность постоянного тока в ваттах.
AC Frequency	Feedback	Any value	Частота переменного тока в герцах.
AC Total Active Power	Feedback	Any value	Общая полная активная мощность(kW).
AC Total Reactive Power	Feedback	Any value	Общая полная реактивная мощность (kVAr).
AC Total Apparent Power	Feedback	Any value	Общая полная мгновенная мощность (kVAr).
AC Line Current	Feedback	Any value	Сила тока на фазе.
AC Active Current	Feedback	Any value	Активный ток на фазе.
AC Active Power	Feedback	Any value	Активная мощность на фазе.
AC Reactive Current	Feedback	Any value	Реактивный ток на фазе.
AC Reactive Power	Feedback	Any value	Реактивная мощность на фазе.
AC RMS Voltage	Feedback	Any value	Среднеквадратичное напряжение на фазе.
AC RMS Current	Feedback	Any value	Среднеквадратичный ток на фазе.
AC Apparent Power	Feedback	Any value	Мгновенная мощность на фазе.

Thermostat

Этот кластер предоставляет интерфейс для управления термостатом.

Имя команды или обратной связи	Тип	Допустимые значения	Описание
Read Values	Command	Any value	Принудительно запросить все текущие значения фидбэков.
Set Mode	Command	0 - 9	Установка системного режима термостата: 0 - Off, 1 - Auto, 3 - Cool , 4 - Heat , 5 - Emergency heating , 6 - Precooling, 7 - Fan only, 8 - Dry, 9 - Sleep.
Shift Heating Setpoint	Command	-1.27 - 1.27	Сдвинуть уставку нагрева.
Shift Cooling Setpoint	Command	-1.27 - 1.27	Сдвинуть уставку охлаждения.
Local Temperature	Feedback	-273.15 - 327.67	Температура внутри помещения, обслуживаемого датчиком термостата.
Outdoor Temperature	Feedback	-273.15 - 327.67	Внешняя температура.
Occupancy State	Feedback	0 / 1	Состояние присутствия в помещении.
System Mode	Feedback	0 - 9	Текущий системный режим термостата: 0 - Off, 1 - Auto, 3 - Cool, 4 - Heat, 5 - Emergency heating, 6 - Precooling, 7 - Fan only, 8 - Dry, 9 - Sleep.
Running Mode	Feedback	0, 3, 4	Текущий режим работы при System Mode = auto: 0 - Off, 3 - Cool, 4 - Heat.
Occupied Cooling Setpoint	Feedback	-273.15 - 327.67	Уставка охлаждения текущего режима, когда комната находится в состоянии присутствия.
Occupied Heating Setpoint	Feedback	-273.15 - 327.67	Уставка нагрева текущего режима, когда комната находится в состоянии присутствия.
Unoccupied Cooling Setpoint	Feedback	-273.15 - 327.67	Уставка охлаждения текущего режима, когда комната находится в состоянии отсутствия.
Unoccupied Heating Setpoint	Feedback	-273.15 - 327.67	Уставка нагрева текущего режима, когда комната находится в состоянии отсутствия.

Testing

At present ZigBee driver is supported only in iRidium server UMC C3 with ZigBee module.