ИК-УПРАВЛЕНИЕ.GC WF2IR.Использование адаптера iTach с контроллером VERA
ИК адаптеры 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" (Сохранить)
Известная проблема с плагином 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 будет работать правильно
Шаг 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
Редактирования файла реализации (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>) – удалить ненужные или добавить новые
Для начала имеет смысл проверить работу устройства, добавив одну команду и один ИК код.
Редактирование файла для описания (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 файл будет выглядеть следующим образом
Загрузка файлов в контроллер 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" (Создать устройство)
- Новое устройство отобразится на вкладке "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
- После этого отобразиться список доступных команд
- Убедитесь, что ИК-эмиттер/бластер установлен перед контролируемым устройством
- Выберите одно из действий в браузере – после этого прибор должен выполнить данное действие
- При неправильной работе прибора проверьте созданные файлы устройства и загрузите их заново
Шаг 6 – управление ИК устройством с помощью сценариев
Теперь вы можете использовать сценарии контроллера VERA для управления вашим ИК оборудованием.
Для этого вам необходимо перейти на вкладку "Advanced" (Дополнительно)
- Создайте новый сценарий – см руководство "Создание сценариев с помощью контроллера VERA"
- Перейдите на вкладку "Advanced" (Дополнительно)
- В разделе "Pick a device" (Выбрать устройство) выберите ИК устройство из выпадающего списка
- Нажмите на "Add" (Добавить)
- Теперь устройство будет добавлено к сценарию
- Выберите команду из выпадающего списка "Please select"
- Нажмите на зеленую кнопку "Confirm changes" (Сохранить изменения) в верхней части окна
- Нажмите на красную кнопку "SAVE" (Сохранить)
- Теперь у вас есть сценарий для управления прибором, который может быть вызван по расписанию или запущен вручную