ИК-УПРАВЛЕНИЕ.GC WF2IR.Использование адаптера iTach с контроллером VERA

Материал из Z-Wave Wiki для инсталляторов и пользователей
Перейти к: навигация, поиск

ИК адаптеры Global Cache iTach идеально подходят для управления различным AV оборудованием (ТВ, Blu-Ray, домашний кинотеатр) и другими устройствами, имеющими поддержку ИК команд.

Данное руководство показывает, как использовать iTach адаптеры с Z-Wave контроллерами VERA Lite и VERA3 с версией прошивки UI5.

Использование iTach с контроллером VERA

Для использования адаптера iTach с контроллером VERA необходимо скачать специальный плагин, а затем создать файлы для каждого контролируемого ИК устройсва. Этапы установки:

  • Загрузка и настройка плагина VERA iTach (GC100) Plugin
  • Создание файлов для каждого контролируемого устройства
  • Добавление ИК-кодов адаптера iTach к файлам
  • Создание устройства в контроллере VERA для каждого прибора
  • Управление функциями приборов через сценарии в контроллере VERA



Шаг 1 – Загрузка файлов

Для установки плагина VERA iTach (GC100) и управления устройств вам понадобятся несколько файлов, которые содержаться в следующем ZIP-архиве:

Данный архив включает в себя четыре файла:

  • I_GC100.xml - GC100 (Файл для обновления)
  • D_Bose_Sounddock.xml (Описание)
  • I_Bose_Sounddock.xml (Реализация)
  • S_Bose_Sounddock.xml (Служебный)



Шаг 2 – установка и настройка плагина iTach/GC100 Plugin

Плагин iTach/GC100 позволяет использовать и настраивать ИК адаптер iTach.

Установка плагина GC100

  • В пользовательском интерфейсе контроллера VERA перейдите на вкладку "APPS" (Приложения) и нажмите на "Install Apps" (Установка приложений)
  • Выберите "GC100"
  • После установки приложения оно отобразится на вкладке "My Apps"
  • На вкладке "DEVICES" (Устройства) отобразиться новое устройство GC100
  • Нажмите на значок гаечного ключа и перейдите на вкладку "Advanced"
  • Введите IP адрес устройства iTach (см. статью "Базовая настройка адаптера Global Cache iTach Wi-Fi to IR")
  • Закройте окно и нажмите на красную кнопку "SAVE" (Сохранить)



APNT-68 GC100 IP Address a.png

Известная проблема с плагином GC100

У плагина GC100 Plugin есть известная проблема – он посылает ИК-команды два раза.

Это легко исправить, загрузив файл I_GC100.xml (Включен в ZIP-архив).

  • Перейдите на вкладку "APPS" (Приложения) > "Develop Apps" (Редактирование приложений)
  • Нажмите на "LUUP Files"
  • Нажмите на кнопку "Choose File" (Выбрать файл) и выберите I_GC100.xml
  • Нажмите на "Go"
  • После загрузки файла необходимо перезагрузить контроллер
  • Перейдите к "SETUP" (Установка) > Net & Wi-fi (Сети) и нажмите на "Reboot" (Перезагрузка)
  • Дождитесь, пока контроллер VERA перезагрузится
  • Теперь плагин GC100 будет работать правильно



APNT-68 GC100 Icon.png

Шаг 3 – Создание и загрузка файлов для контролируемых устройств

Для создания ИК устройств в контроллере VERA необходимо создать и отредактировать соответствующие файлы.

В данном примере показан набор файлов, которые были созданы для док-станции Bose Sounddock. Также приведены части XML файлов, которые вам необходимо изменить для вашего устройства.

  • Извлеките файлы .xml из ZIP-файла
  • Переименуйте их, чтобы знать, к которому устройству они относятся к – например, "XYZ", "Yamaha RX675" и т.д.
  • Вы можете ввести любое название – в данном примере файл называется Bose_SoundDock



Редактирование служебного файла (S_ File)

Файл S_Bose_SoundDock.xml – это служебный файл для ИК устройства, который контролирует действия прибора. В данном примере мы определим действия которые могут быть вызваны с помощью команд iTach.

  • Откройте файл S_Bose_SoundDock.xml file в текстовом или HTML редакторе
  • На 7-й строке вы увидите тег <ActionList>, а также несколько тегов <action> под ним
  • Они соответствуют аналогичным тегам <action> в файле I_Bose_SoundDock.xml, которые содержат фактические ИК коды для управления оборудованием
  • Отредактируйте теги <name> в файле S_Bose_SoundDock.xml – сотрите ненужные или добавьте новые
  • В данном примере используется только две команды для док-станции SoundDock – "Bose Play" (Воспроизведение) и "Bose Off" (Отк)
  • Не забудьте сохранить изменения
  • Окончательный файл S_Bose_SoundDock.xml показан на рисунке 3



APNT-68 VERA System File a.png

Редактирования файла реализации (I-File)

Файл I_Bose_SoundDock.xml содержит команды и ИК коды для управления оборудованием.

  • Откройте файл I_Bose_SoundDock.xml file в текстовом или HTML редакторе
  • На 3-й строке вы увидите тег <ActionList>, а также несколько тегов <action> под ним
  • Они содержат ИК коды, которые передаются при активации каждого действия
  • Переименуйте <serviceId> в соответствии с названием вашего прибора – в данном примере – <serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock< /serviceId >
  • Примечание: этот же < serviceId > используется во всех командах в файле I_Bose_SoundDock.xml
  • Переименуйте тег < name > в соответствии с типом выполняемой команды – в данном примере – <name>Bose Play</name>



Добавление ИК кода

Теперь вы должны добавить ИК код, созданный в приложении iTach iLearn, в файл реализации. (См. статью "Базовая настройка адаптера Global Cache iTach Wi-Fi to IR")

  • Файл I_Bose_SoundDock.xml использует код HEX – в iLearn вам необходимо выбрать формат HEX
  • Вставьте этот код между тегами < ir >
  • Вы можете редактировать все остальные команды (<actions>) – удалить ненужные или добавить новые

Для начала имеет смысл проверить работу устройства, добавив одну команду и один ИК код.

APNT-68 VERA Implementation Filea.png

Редактирование файла для описания (D_ File)

Файл D_Bose_SoundDock.xml содержит полную информацию об ИК устройстве. Вам необходимо добавить информацию об устройствах и необходимые ссылки к файлам I_Bose_Sounddock.xml и S_Bose_Sounddock.xml.

Описание устройства

Введите описание контролируемого устройства:

< friendlyName > (Название), < manufacturer > (Производитель), < manufacturerURL > (Ссылка на сайт производителя), < modelDescription > (Описание модели) и < modelName > (Название модели)

Строка для файла I_XML

  • Имя файла (строка 120) должно совпадать с вашим I_XML файлом – в данном примере I_Bose_SoundDock.xml.



Служебные файлы

  • Отредактируйте раздел служебных файлов (строка 31), который должен соответствовать вашему файлу S_XML – в данном примере – S_Bose_SoundDock.xml:

< serviceType >urn:a-lurker-com:service:Bose_SoundDock:1 </serviceType>

< serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock1 </serviceId>

< SCPDURL >S_Bose_SoundDock.xml </SCPDURL>

  • Примечание: в первых двух строках после названия файлов стоят ":1" и "1"
  • Остальные данные – это различные служебные файлы контроллера VERA – вы можете сохранить их или удалить из файла D_SoundDock.xml.



Уникальное имя устройства (UDN)

Это очень важный этап.

Каждое устройство должно иметь уникальное имя (UDN). Вы можете создать его для каждого ИК устройства.

  • Для создания уникального имени перейдите по ссылке http://www.famkruithof.net/uuid/uuidgen
  • Нажмите на "Get" (Получить)
  • В верхней части страницы отобразиться уникальное имя в формате b2f53800-b8ea-11e3-a5e2-0800200c9a66
  • Вставьте его в строку < UDN > после uuid:

< UDN >uuid:b2f53800-b8ea-11e3-a5e2-0800200c9a66 </serviceType>

  • Ваш D_SoundDock.xml файл будет выглядеть следующим образом



APNT-68 VERA Description File a.png

Загрузка файлов в контроллер VERA

Эти файлы должны быть загружены в контроллер VERA (подобно тому, как вы ранее загрузили плагин GC100).

  • Перейдите на вкладку "APPS" (Приложения) > "Develop Apps" (Редактирование приложений)
  • Нажмите на "LUUP Files"
  • Нажмите на кнопку "Choose File" (Выбрать файл) и выберите файлы D_Bose_SoundDock.xml, I_Bose_SoundDock.xml и S_Bose_SoundDock.xml
  • Нажмите на "Go"
  • После загрузки файла необходимо перезагрузить контроллер
  • Перейдите к "SETUP" (Установка) > Net & Wi-fi (Сети) и нажмите на "Reboot" (Перезагрузка)
  • Дождитесь, пока контроллер VERA перезагрузится
  • Файлы устройств теперь будут загружены в контролер VERA



Шаг 4 – Создание ИК устройства в контроллере VERA

Теперь вы можете создать устройство в контроллере VERA, которое будет использовать созданные файлы. Это устройство является "виртуальным" аналогом реального устройства, которым можно будет управлять с помощью сценариев.

  • Перейдите на вкладку "APPS" (Приложения) > "Develop Apps" (Редактирование приложений)
  • В левой части экрана нажмите на кнопку "Create Device" (Создать устройство)
  • Введите "D_Bose_SoundDock.xml" в поле "Upnp Device Filename"
  • Нажмите на "Create Device" (Создать устройство)



APNT-68 Create Device a.png

  • Новое устройство отобразится на вкладке "DEVICES" (Устройства), однако оно еще не полностью настроено
  • Нажмите на синюю кнопку "RELOAD" (Перезагрузка) в верхней части экрана и дождитесь, пока контроллер VERA перезагрузится
  • Данное устройство будет иметь название, которое вы ввели в файле "Device Description" (Описание устройства)
  • На вкладке "Advanced" (Дополнительно) оно должно иметь правильный файл описания (D_Bose_SoundDock.xml) и тип устройства (urn:schemas-micasaverde-com:device:IrDevice:1)
  • Если эти данные не отображаются, тогда заново нажмите на синюю кнопку "RELOAD" (Перезагрузка) в верхней части экрана и дождитесь, пока контроллер VERA перезагрузится
  • Устройству необходимо назначить правильный порт iTach (iTach имеет 3 порта) – в данном примере выбран ИК-бластер (порт 3). (см. статью "Базовая настройка адаптера Global Cache iTach Wi-Fi to IR")
  • Перейдите на вкладку "Settings" (Настройки) и выберите необходимый порт из выпадающего списка
  • Закройте окно настроек устройства и нажмите на красную кнопку "SAVE" (Сохранить) в верхней части окна
  • После перезагрузки контроллера VERA устройство будет готово к тестированию



Шаг 5 – Тестирование ИК устройства

Теперь необходимо протестировать новое устройство и убедиться, что оно работает правильно.

  • В адресной строке вашего браузера введите http://VERAs_IP_address:3480/data_request?id=lu_invoke – вместо строки "VERAs_IP_address" введите IP адрес вашего контроллера
  • Нажмите на соответствующее устройство – в данном примере #200 Bose SoundDock
  • После этого отобразиться список доступных команд
  • Убедитесь, что ИК-эмиттер/бластер установлен перед контролируемым устройством
  • Выберите одно из действий в браузере – после этого прибор должен выполнить данное действие
  • При неправильной работе прибора проверьте созданные файлы устройства и загрузите их заново



APNT-68 Device Actions in Browser.png

Шаг 6 – управление ИК устройством с помощью сценариев

Теперь вы можете использовать сценарии контроллера VERA для управления вашим ИК оборудованием.

Для этого вам необходимо перейти на вкладку "Advanced" (Дополнительно)

  • Создайте новый сценарий – см руководство "Создание сценариев с помощью контроллера VERA"
  • Перейдите на вкладку "Advanced" (Дополнительно)
  • В разделе "Pick a device" (Выбрать устройство) выберите ИК устройство из выпадающего списка
  • Нажмите на "Add" (Добавить)
  • Теперь устройство будет добавлено к сценарию
  • Выберите команду из выпадающего списка "Please select"
  • Нажмите на зеленую кнопку "Confirm changes" (Сохранить изменения) в верхней части окна
  • Нажмите на красную кнопку "SAVE" (Сохранить)
  • Теперь у вас есть сценарий для управления прибором, который может быть вызван по расписанию или запущен вручную



APNT-68 Create Scene.png