Перейти к основному содержимому

iRidium для Z-Wave

Как iRidium server получает доступ к беспроводной сети Z-Wave

документация обновлена 01.01.2024

примечание

Работать с сетями Z-Wave могут:

  • HS Server со стиком Z-Wave.

  • iRidium server UMC C3 со встроенным модулем Z-Wave* или USB-стиком ZME-UZB1.

      • снят с производства.
  • iRidium server RPi, а также компьютеры с ОС Windows, на которых установлен iRidium server, с помощью USB-стика Z-Wave ZME-UZB1. Подробнее о USB-стике здесь .

Поддержка серверов - компьютеров с операционной системой Linux с Z-Wave/USB-преобразователями и установленным iRidium server планируется.

Внимание

iRidium server поддерживает не все устройства и функции Z-Wave. В разделе "Работа с командами и обратными связями"
приведена информация о поддерживаемые классах Z-Wave.

Преимущества

Беспроводная сеть Z-Wave разработана специально для домашней автоматизации.

Устройства Z-Wave:

  • Могут обмениваться информацией до 30 метров друг от друга (в идеальных условиях, в прямой видимости друг от друга).
  • Потребляют очень мало энергии и могут работать от обычных батареек. Не требуется прокладывать электропроводку, чтобы создать умный дом.
  • Могут организовывать ячеистые сети (mesh): устройства могут обмениваться не только напрямую, но и через промежуточные устройства Z-Wave - ретрансляторы, обходя таким образом препятствия и мертвые зоны. Маршруты передачи данных могут изменяться в реальном времени в зависимости от электромагнитной обстановки. Это повышает надёжность радиосвязи.

На рынке представлено очень много умных устройств с интерфейсом Z-Wave. У разработчиков имеется прекрасная возможность присоединить все эти устройства к единой платформе iRidium.

Добавление устройств в сеть

Беспроводная сеть в отличие от проводной сети требует виртуального соединения устройств. В сети Z-Wave это осуществляется с помощью идентификаторов NodeID. iRidium server хранит список всех беспроводных устройств с их идентификаторами.

  1. Подайте питание на сервер UMC C3 с модулем Z-Wave или подключите Z-Wave/USB-преобразователь к вашему контроллеру или компьютеру, с установленным на него iRidium server. Установите драйвер преобразователя в соответствии с его руководством по эксплуатации.

  2. Войдите в веб-интерфейс сервера.

  3. Перейдите на вкладку Z-Wave .

ZWave_web01.png 4. Нажмите кнопку Change Port

ZWave_change_port0001_1.png

В появившемся окне впишите имя порта, к которому подключен USB-стик Z-Wave

ZWave_change_port2.png

примечание

Для Z-Wave на UMC C3 со встроенным модулем Z-Wave используется порт /hal/zwt_m3 .

Определить порт можно следующим образом:


Для ОС Linux : * Отключите USB-стик от сервера, если он подключен * Запустите Putty, в командной строке впишите ls /dev


Появится список всех портов, в которые подключены устройства

ZWave_change_port3.png

Подключите USB-стик к серверу и повторно наберите команду ls /dev


В списке появится новое имя порта

ZWave_change_port4.png

Это и есть необходимое нам имя порта. В нашем примере: /dev/ttyUSB0


Для HS Server :

  • Отключите Z-Wave стик от сервера, если он подключен.
  • Запустите Putty, в командной строке впишите ls /dev. Появится список всех портов, в которые подключены устройства.
  • Подключите Z-Wave стик к серверу и повторно наберите команду ls /dev.

В списке появится новое имя порта.

Z-Wave_HSS.png

Это и есть необходимое нам имя порта. В нашем примере: /dev/ttyACM0


Для ОС Windows

  • Подключите USB-стик
  • Зайдите в диспетчер устройств. Найдите ваш USB-стик. После его имени в скобках будет отображено имя порта, к которому он подключен. В нашем примере: COM7

ZWave_change_port5_1.png

  1. Нажмите кнопку Add , введите имя добавляемого устройства и затем снова нажмите Add .

ZWave111.png

ZWave_web02(1).png

  1. В течение 20 секунд сервер будет сканировать радиоканал, в течение этого времени выполните определённые физические действия с добавляемым беспроводным устройством. Как правило, требуется нажать кнопку на устройстве три раза. (Прочитайте руководство по эксплуатации на ваше устройство, чтобы узнать точно, какие действия требуется выполнить.)

  2. Устройство добавится в список и получит идентификатор NodeID. Добавьте необходимое количество устройств для вашей сети.

ZWave_web11111.png

  1. После этого построение сети завершено. Экспортируйте данные о созданной сети в виде файла .xml, для этого нажмите кнопку Export .
примечание

Для удаления устройств из сети воспользуйтесь кнопкой Delete . После этого нажмите трижды кнопку на удаляемом устройстве (или выполните другое аналогичное действие согласно инструкции на устройство). После удаления рекомендуется выключить питание удаленного устройства или извлечь батарейку из него, так как многие модели устройств Z-Wave пытаются вновь подключиться к беспроводной сети.

Работа в iRidium studio

Добавление драйвера Z-Wave Network

  1. Создайте серверный проект iRidium studio. Нажмите кнопку импорта файла и выберите Z-Wave (*.xml) .

Z-Wave1.png

  1. Драйвер со всеми устройствами появится в дереве драйверов проекта.

Z-Wave2.png

  1. Вы можете изменять имена устройств (Name ), имена в iRidium studio могут отличаться от имен в веб-интерфейсе сервера. Остальные параметры заблокированы для редактирования.

Работа с командами и обратными связями

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

Подробнее:

Ниже дана информация о поддерживаемых классах устройств Z-Wave и их командах и обратных связях.

Сведения о поддерживаемых функциях Z-Wave

Поддерживаются функции:

  • многоканальные устройства.

Не поддерживаются функции:

  • ассоциации (прямое связывание устройств Z-Wave),
  • сцены.

Battery

ПараметрТипЗначениеОписание
Get state (Battery)CommandЛюбое значениеЗапросить уровень заряда батарейки. Команда может быть выполнена не сразу.
State (Battery)FeedbackОт 0 до 100255 - предупреждение о низком уровне зарядаУровень заряда батарейки

Binary sensor

ПараметрТипЗначениеОписание
Get state (Binary sensor)CommandЛюбое значениеЗапросить состояние датчика
State (Binary sensor)Feedback0 или 1Состояние датчика

Binary switch

ПараметрТипЗначениеОписание
Set state (Binary switch)CommandOFF - 0, ON - от 1 до 99Установить состояние выключателя
State (Binary switch)Feedback0 или 1Состояние выключателя

Central scene

ПараметрТипЗначениеОписание
CountFeedbackValueОтображает количество нажатий по сценарным кнопкам.
ReleasedFeedbackValueНомер отжатой кнопки.
Held DownFeedbackValueНомер зажатой кнопки.
PressedFeedbackValueНомер нажатой кнопки.

Color switch

ПараметрТипЗначениеОписание
Set Warm White (Color switch)CommandОт 0 до 255Установить уровень белого цвета
Get Warm White (Color switch)CommandЛюбое значениеЗапросить уровень белого цвета
Set Red (Color switch)CommandОт 0 до 255Установить уровень красного цвета
Get Red (Color switch)CommandЛюбое значениеЗапросить уровень красного цвета
Set Green (Color switch)CommandОт 0 до 255Установить уровень зеленого цвета
Get Green (Color switch)CommandЛюбое значениеЗапросить уровень зеленого цвета
Set Blue (Color switch)CommandОт 0 до 255Установить уровень синего цвета
Get Blue (Color switch)CommandЛюбое значениеЗапросить уровень синего цвета
State Warm White (Color switch)FeedbackОт 0 до 255Значение белого цвета
State Red (Color switch)FeedbackОт 0 до 255Значение красного цвета
State Green (Color switch)FeedbackОт 0 до 255Значение зеленого цвета
State Blue (Color switch)FeedbackОт 0 до 255Значение синего цвета

Multilevel sensor

ПараметрТипЗначениеОписание
Get stateCommandЛюбое значениеЗапросить состояние датчика
StateFeedbackЗависит от устройстваСостояние датчика

Multilevel switch

ПараметрТипЗначениеОписание
Set levelCommandОт 0 до 99Установить уровень
Get levelCommandЛюбое значениеЗапросить уровень
LevelFeedbackОт 0 до 99Уровень

Meter

ПараметрТипЗначениеОписание
GetCommandЛюбое значениеЗапросить значение
StateFeedbackЗависит от устройстваЗначение

Thermostat

ПараметрТипЗначениеОписание
Set mode by nameCommandHeat
Cool
Fan
Dry
Auto Changeover
Установить режим термостата по имени
Set mode by IDCommandValueУстановить режим термостата по имени
Set StateCommandValueУстановить температуру режима (Cooling, Dry Air, Heating, Auto Changeover)
Get ModeCommandValueЗапросить режим
Get StateCommandValueЗапросить температуру режима (Cooling, Dry Air, Heating, Auto Changeover)
Set on by IDCommandValueВключить вентилятор по ID
Set on by nameCommandAuto Low
Low
Auto High
High
Auto Medium
Medium
Circulation
Left right
Quiet
Up down
Humidity circulation
Включить режим вентилятора по имени
Set off by IDCommandValueВыключить вентилятор по ID
Set off by nameCommandAuto Low
Low
Auto High
High
Auto Medium
Medium
Circulation
Left right
Quiet
Up down
Humidity circulation
Выключить режим вентилятора по имени
Mode TextFeedbackValueНаименование режима
Mode ValueFeedbackValueЗначение режима
State (Setpoint)FeedbackValueЗначение уставки
State TextFeedbackValueНаименование режима вентилятора
State ValueFeedbackValueЗначение режима вентилятора

Тестирование

В настоящее время поддерживается работа драйвера Z-Wave в UMC C3 с модулем Z-Wave, а также в RPi и компьютерах с ОС Windows (на которых установлен iRidium server) с помощью USB-стика Z-Wave ZME-UZB1.

Использование iRidium server в качестве Z-Wave хаба

Для того, чтобы использовать iRidium server UMC, RPi, NUC в качестве Z-Wave хаба для коммуникации с оборудованием на базе протокола Z-Wave, необходимо и достаточно подключить USB-стик Z-Wave ZME_UZB1 к iRidium server и взаимодействовать с сетью Z-Wave напрямую.


Приобрести USB-стик Z-Wave ZME_UZB1 вы можете пройдя по этой ссылке. UZB выпускается в трех различных версиях в зависимости от используемой частоты передачи:

  • ZMEEUZB: версия для всех частот около 868 МГц (ЕС, Россия, Индия, Китай - по умолчанию - ЕС)
  • ZMEAUZB: версия для всех частот около 921 МГц (Австралия, Бразилия, Япония, Корея - по умолчанию Австралия / Бразилия)
  • ZMEUUZB: версия для всех частот около 908 МГц (США, Израиль - по умолчанию США)

В зависимости от вашего местоположения выберите дистрибьютора в вашем регионе.



Важно

Для работы с iRidium server достаточно приобрести USB-стик без лицензии Z-Wave

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


Рекомендуемая розничная цена USB-стика Z-Wave ZME_UZB1 (без лицензии Z-Wave) - 3 050 р.


Если у вас возникнут дополнительные вопросы, обращайтесь в нашу тех.поддержку - support@iridiummobile.ru.