Skip to main content

Z-Wave

Версия: 1.26.0

Подключитесь к сети Z-Wave через USB-накопитель (протестировано с помощью Aeotec Z-Stick Gen5). Для этого протокола требуется сопоставление device для контейнера manager Docker, чтобы обеспечить доступ к USB-накопителю.

Убедитесь, что сопоставление устройств и конфигурация тома для контейнера manager Docker в файле docker-compose.yml выглядят следующим образом:

......volumes:  proxy-data:  manager-data:  postgresql-data:  zwave-data:......  manager:    restart: always    ...    ...    volumes:      ...      ...      - zwave-data:/zwave    devices:      - /dev/ttyACM0:/dev/ttyS0......

В этом примере последовательный порт /dev/ttyACM0 хоста сопоставляется с последовательным портом /dev/ttyS0 контейнера manager Docker.

Конфигурация агента​

Ниже описаны поддерживаемые атрибуты конфигурации агента:

Атрибут

Описание

Тип значения

Требуется

serialPort

Адрес последовательного порта

Текст (/dev/ttyS0)

Да

Для атрибутов, связанных с этим агентом, ниже описаны поддерживаемые поля ссылки на агента, которые являются дополнением к стандартным полям Agent Link:

Поле

Описание

Тип значения

Требуется

type

Тип агента

Текст (должен быть ZWaveAgentLink)

Да

deviceNodeId

Идентификатор узла устройства

Целое число

Да

deviceEndpoint

Конечная точка устройства

Целое число

Да

deviceValue

Значение устройства, которое нужно связать с этим атрибутом.

Текст

Да

Обнаружение и импорт​

Чтобы понять, как происходит обнаружение и импорт, см. Обнаружение агентов и активов/Импорт. Этот протокол поддерживает следующее:

  • Обнаружение активов протокола

Вы можете повторять эту процедуру столько раз, сколько захотите, и устройства не будут импортированы более одного раза. Эту процедуру следует выполнить изначально и после добавления нового устройства в сеть Z-Wave.

ЗАДАЧА: Очистите следующее

Включить устройства Z-Wave​

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

Обратите внимание: прежде чем вы сможете выполнить эту процедуру, вам необходимо выполнить процедуру Import Z-Wave Devices хотя бы один раз, в противном случае актив Z-Wave Controller будет отсутствовать.

  1. Выберите Z-Wave Controller в списке активов слева.
  2. Активируйте флажок Device Inclusion.
  3. Перевести устройство Z-Wave во режим включения (см. инструкцию к устройству)
  4. Выполните процедуру Import Z-Wave Devices, чтобы добавить новое устройство в список активов слева.

Исключить устройства Z-Wave​

Эта процедура описывает, как удалить устройство из сети Z-Wave (исключение устройства Z-Wave).

Обратите внимание: прежде чем вы сможете выполнить эту процедуру, вам необходимо выполнить процедуру Import Z-Wave Devices хотя бы один раз, в противном случае актив Z-Wave Controller будет отсутствовать.

  1. Выберите Z-Wave Controller в списке активов слева.
  2. Активируйте флажок Device Exclusion.
  3. Переведите устройство Z-Wave в режим исключения (см. инструкцию к устройству).

Настройка параметров устройства Z-Wave​

  1. Выберите устройство Z-Wave в списке активов слева и разверните его, чтобы увидеть группу Parameters.
  2. Разверните группу Parameters.
  3. Выберите параметр Z-Wave слева.
  4. Отредактируйте выбранный параметр Z-Wave справа. Чтобы получить информацию о выбранном параметре Z-Wave, прочитайте текст атрибута Description справа. Атрибут с отключенной кнопкой Write показывает текущее значение параметра Z-Wave. Все остальные атрибуты с включенной кнопкой Write используются для изменения значения параметра Z-Wave. В случае устройства с батарейным питанием вам необходимо активировать устройство (см. руководство устройства), чтобы на устройство можно было отправить настроенное значение параметра.

Дополнительная информация​

К сожалению, Docker for Windows и Docker for Mac не поддерживают сквозную передачу устройств. На компьютере под управлением Windows или Mac вам необходимо установить Linux как виртуальную машину с помощью VirtualBox. Есть два варианта сделать это.

Windows — вариант 1 (панель инструментов Docker)​

  1. Загрузите и установите VirtualBox.
  2. Загрузите и установите Пакет расширений VirtualBox.
  3. В Windows 10 откройте окно Windows Features и убедитесь, что следующие функции не выбраны: Hyper-V, Virtual Machine Platform, Windows Subsystem for Linux.
  4. Установите Docker Toolbox. Выберите следующие дополнительные компоненты: Docker Compose for Windows и Git for Windows. Не выбирайте и не устанавливайте VirtualBox.
  5. Запустите Git Bash и введите следующую команду:
docker-machine create --driver virtualbox --virtualbox-boot2docker-url https://github.com/boot2docker/boot2docker/releases/download/v18.06.1-ce/boot2docker.iso default

Обратите внимание: если виртуальная машина с именем default уже существует, вы можете удалить ее с помощью следующей команды:

docker-machine rm default
  1. Запустите VirtualBox, выберите виртуальную машину с именем default слева и перейдите в Настройки -> Сеть -> Адаптер 1 -> Дополнительно -> Переадресация портов.
  2. Добавьте следующие правила:

Имя

Протокол

IP-адрес хоста

Хост-порт

Гостевой IP

Гостевой порт

PostgreSQL

TCP

5432

5432

плащ-ключ

TCP

8081

8081

карта

TCP

8082

8082

прокси http

TCP

80

80

прокси https

TCP

443

443

  1. Подключите Aeotec Z-Stick к ПК.
  2. В VirtualBox заходим в Настройки -> USB.
    • Активировать Enable USB Controller
    • Выберите USB 2.0 (EHCI) Controller.
    • Нажмите кнопку Add USB-Filter и выберите устройство Aeotec Z-Stick (Sigma Designs, Inc.).
  3. Узнайте имя последовательного порта. В VirtualBox запустите виртуальную машину с именем default слева и нажмите кнопку «Пуск». В окне терминала boot2docker введите следующую команду:
ls -al /dev/tty* | more

В случае Aeotec Z-Stick Gen5 имя USB-устройства обычно — /dev/ttyACM0. Более старый Aeotec Z-Stick S2 обычно имеет название /dev/ttyUSB0.

Mac — вариант 1 (Docker Toolbox)​

  1. Загрузите и установите VirtualBox.
  2. Загрузите и установите Пакет расширений VirtualBox
  3. Установите Docker Toolbox.
  4. Запустите терминал и выполните следующую команду:
docker-machine create --driver virtualbox --virtualbox-boot2docker-url https://github.com/boot2docker/boot2docker/releases/download/v18.06.1-ce/boot2docker.iso default

Обратите внимание: если виртуальная машина с именем default уже существует, вы можете удалить ее с помощью следующей команды:

docker-machine rm default
  1. Запустите VirtualBox, выберите виртуальную машину с именем default слева и перейдите в Настройки -> Сеть -> Адаптер 1 -> Дополнительно -> Переадресация портов.
  2. Добавьте следующие правила:

Имя

Протокол

IP-адрес хоста

Хост-порт

Гостевой IP

Гостевой порт

PostgreSQL

TCP

5432

5432

плащ-ключ

TCP

8081

8081

карта

TCP

8082

8082

прокси http

TCP

80

80

прокси https

TCP

443

443

  1. Подключите Aeotec Z-Stick к ПК.
  2. В VirtualBox заходим в Настройки -> Порты -> USB.
    • Активировать Enable USB Controller
    • Выберите USB 2.0 (EHCI) Controller.
    • Нажмите кнопку Add USB-Filter и выберите устройство Aeotec Z-Stick (Sigma Designs, Inc.).
  3. Узнайте имя USB-устройства в виртуальной машине boot2docker. В VirtualBox запустите виртуальную машину с именем default слева и нажмите кнопку «Пуск». В окне терминала boot2docker введите следующую команду:
ls -al /dev/tty* | more

В случае Aeotec Z-Stick Gen5 имя USB-устройства обычно — /dev/ttyACM0. Более старый Aeotec Z-Stick S2 обычно имеет имя /dev/ttyUSB0.

Windows и Mac — вариант 2 (Ubuntu VM)​

  1. Загрузите и установите VirtualBox
  2. Загрузите и установите Пакет расширений VirtualBox
  3. Загрузите Ubuntu Desktop
  4. Запустите VirtualBox и создайте новую виртуальную машину, нажав кнопку New на верхней панели инструментов.
  5. Внесите следующие изменения, пока VirtualBox проведет вас через мастера:
    • Тип: Linux
    • Версия: Ubuntu (64-bit)
    • Размер памяти: минимум 4096 MB.
    • Размер виртуального жесткого диска: минимум 20 GB.
  6. Нажмите кнопку Start на верхней панели инструментов и выберите ISO-образ Ubuntu, который вы загрузили на шаге 3, чтобы установить Ubuntu.
  7. После установки Ubuntu рекомендуется установить «гостевые дополнения». Запустите виртуальную машину Ubuntu и в верхней строке меню выберите следующее: Устройства -> Вставить образ компакт-диска с гостевыми дополнениями...
  8. Установите Docker Engine
  9. Установите Docker Compose
  10. Выключите виртуальную машину Ubuntu и подключите Aeotec Z-Stick к ПК. В VirtualBox Manager перейдите в «Настройки» -> «Порты» -> «USB» -> «Порт1» и добавьте следующую конфигурацию:
    • Активировать Enable USB Controller
    • Выберите USB 3.0 (xHCI) Controller.
    • Нажмите кнопку Add Filter и выберите USB-устройство Aeotec Z-Stick (Sigma Designs, Inc.).
  11. Узнайте имя последовательного порта. Выполните следующую команду:
dmesg -w

Вы должны увидеть что-то вроде следующего:

[15624.940828] cdc_acm 2-1:1.0: ttyACM0: USB ACM device

В этом примере результирующее имя последовательного порта будет:

/dev/ttyACM0

Линукс​

  1. Установите Docker Engine
  2. Установите Docker Compose
  3. Узнайте имя последовательного порта. Подключите Aeotec Z-Stick к ПК и выполните следующую команду:
dmesg -w

Вы должны увидеть что-то вроде следующего:

[15624.940828] cdc_acm 2-1:1.0: ttyACM0: USB ACM device

В этом примере результирующее имя последовательного порта будет:

/dev/ttyACM0

Уведомление о лицензии: атрибуция документации OpenRemote