AV & Custom Systems (RS232)

iRidium для AV & Custom Systems (RS232) позволяет:

• управлять оборудованием, напрямую подключенным к вашему ПК через СОМ-порт
• с помощью программной надстройки "Gate TCP to UDP" и приложения iRidium Gate на ПК, драйвер позволяет предавать RS232 команды по TCP/IP.

Условия работы с драйвером:

• возможность управления выбранным оборудованием по RS232 (наличие управляющего интерфейса)
• наличие команд управления оборудованием по RS232 и описания протокола
• возможность самостоятельного создания скриптов, если протокол предполагает авторизацию и обязательный обмен данными с панелью управления

Описание работы драйвера:

Драйвер "AV & Custom Systems (RS232)" подключается к выбранному СОМ-порту ПК. Когда соединение установлено, подключенному через СОМ-порт оборудованию можно отправлять команды - список команд формируется пользователем в процессе создания проекта. Обратная связь от оборудования реализуется за счет обработки входящих данных посредством скрипта, созданного в проекте iRidium (см. iRidium DDK и iRidium Script API).

Эта инструкция не описывает создание скриптов для обработки приходящих от оборудования данных. Получение обратной связи от оборудования описано в разделе iRidium DDK.

Принцип работы AV & Custom Systems (RS232)

В iRidium вы можете использовать универсальный драйвер "AV & Custom Systems (RS232)" для подключения к вашему аудио-видео и другому оборудованию. Схема связи iRidium с оборудованием:

В этом разделе описан базовый вариант использования драйвера: запуск iRidium на ПК, когда ПК подключен к оборудованию через СОМ-порт.

Для работы с оборудованием по RS232 через преобразователи Global Cache (iTach), см. Global Cache: управление по RS232.

Протокол передачи данных: RS232.

Поддерживаемые форматы обмена данными: ASCII, HEX, DEC.
Для записи команд в разных форматах используется синтаксис iRidium.

Обратная связь от оборудования: в базовом варианте отсутствует. Реализуется через iRidium Script, cм. iRidium DDK.

Необходимая лицензия: Device License Pro для AV & Custom Systems (см. Лицензирование). Подходит для любого оборудования, управляемого с помощью "AV & Custom Systems". Позволяет использовать в проекте любые скрипты.

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

 Инструкция: iRidium Gate для AV оборудования (RS232 через TCP/IP)

 Инструкция: Global Cache: управление по RS232 (RS232 через TCP/IP)

Создание и настройка драйвера AV & Custom Systems (RS232)

Выберите в окне DEVICE BASE редактора iRidium GUI Editor вкладку AV & Custom Systems, разверните ее и найдите "AV & Custom Systems (RS232)". Перетащите драйвер в окно PROJECT DEVICE PANEL:

Параметры подключения к оборудованию через AV & Custom Systems (RS232):

• Background Mode - работа в фоновом режиме (для подключения с iOS через iRidium Gate)
• Port - номер СОМ-порта, к которому подключен контроллер
• Baud Rate - скорость обмена данными
• Data Bits - число информационных разрядов в кадре
• Parity - контроль четности.
• Stop Bits - cтоповый бит в кадре
• Script Mode - режим отправки команд и взаимодействия со скриптами в проекте iRidium
  • Direct & Script - данные из команды будут отправлены напрямую оборудованию и обработаны скриптовой системой
  • Script Only - команды, созданные внутри драйвера, не уходят оборудованию непосредственно, а обрабатываются скриптовой системой, которая производит целевые действия.

Для подключения к оборудованию с удаленного устройства и через Интернет:

Необходим аппаратный или программный преобразователь из TCP/IP в RS232:

• аппаратные преобразователи Global Cache (GC-100, iTach), см. Global Cache: управление по RS232.
• программный преобазователь iRidium Gate для ПК, см. iRidium Gate для AV оборудования (RS232 через TCP/IP)

Настройка маршрутизатора для работы через Интернет:

1. в строке Host укажите публичный IP-адрес вашего интернет-маршрутизатора

2. На маршрутизаторе настройте проброс портов (Port Forwarding) для возможности удаленного управления оборудованием.

Узнать публичный IP-адрес своего маршрутизатора Вы можете при помощи интернет-сервисов, например Яндекс.Интернет

Для переключения между локальным соединением и работой через Интернет:

Используйте пример, представленный далее.

↑ К оглавлению

Структура драйвера AV & Custom Systems

Драйвер AV & Custom Systems в проекте iRidium состоит из 3х частей:

• Driver Tokens - список переменных, которые хранят информацию о подключении к оборудованию.
• Commands - список команд, которые можно отправить оборудованию (или в скрипт) по нажатию кнопки интерфейса
• Feedbacks - список имен каналов обратной связи, куда могут записываться данные от управляемого оборудования, обработанные скриптовой системой iRidium.

Параметры и назначение частей драйвера:

Driver Tokens

Driver Tokens - переменные, в которых хранится статус подключения к оборудованию. Эти параметры можно только прочитать.

Для использования переменной драйвера, перетащите ее на графический элемент (значение можно вывести в текстовое поле элемента или повлиять им на состояние элемента)

• Online - состояние подключения к оборудованию (Online/Offline = 1/0)
• Status - статус подключения к оборудованию (Offline/Connecting/Online/Waiting = 0...3)
• Port - COM-порт ПК, через который производится связь с удаленной системой

Commands и Feedbacks

Commands - список команд, которые можно отправить оборудованию (или в скрипт) по нажатию кнопки интерфейса. Заполняется свободно. Число команд не ограничено.

Feedbacks - список имен каналов обратной связи, куда могут записываться данные от управляемого оборудования, обработанные скриптовой системой iRidium. Данные, записанные в поле Data канала Feedback, можно прочитать через скрипт.

Команды (Commands)

• Name - произвольное имя команды
• Data - данные, которые должна отправить команда при вызове. Можно записать в HEX, DEC, ASCII
• Desable Header - используется только для модулей Global Cache и готовых спец. драйверов. По умолчанию оставьте False.

Обратная связь (Feedback)

• Name - имя канала обратной связи. По имени можно обратиться к каналу из скрипта для записи данных
• Data - данные, которые хранит канал обратной связи при запуске проекта. Могут быть перезаписаны с помощью команды графического элемента или из скрипта.

Чтобы привязать команду к графическому элементу:
перетащите ее на графический элемент и выберите, по какому событию отправлять команду:

• Press - нажатие на элемент
• Release - отпускание элемента
• Hold - удержание элемента
• Move - перемещение по элементу (в основном используется для элементов Level)

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

• In Value - при получении любого значения, не равного нулю, элемент изменит свое состояние (State 1/State 2). Используется для визуализации изменений за счет смены внешнего вида элемента.
• In Text - при получении каналом любых данных, они будут записаны в текстовое поле элемента
• More... - полученные данные могут влиять на любой другой параметр элемента (см. доступные параметры в диалоге привязки)

↑ К оглавлению

Отправка команд AV оборудованию

Выберите команды для оборудования, которые нужно добавить в список драйвера AV & Custom Systems (TCP). Они могут храниться в одном из форматов:

• ASCII - строка
• HEX - шестнадцатеричный
• DEC - десятичный

Нужно правильно оформить информацию, которая хранится в каждом из этих форматов, чтобы iRidium смог ее обработать и отправить оборудованию. Для оформления команд служит "синтаксис" iRidium для команд драйвера AV & Custom Systems. Этот синтаксис одинаков для TCP, UDP, RS232 транспорта.

Команды в формате ASCII (строка)

Внесите ASCII строку в окно "Data":

* обособьте строку ‘одинарными кавычками’
* если после строки идут данные в другом формате, отделяйте их запятыми
* в конце строки используйте символы "возврат каретки" <CR> и "конец строки" <LF>

Исходная команда (в документации):	PWR01 <CR>	VOLUME 50 <CR> <LF>	AUD 1>3 <CR>	6CH/8CH <CR> <LF>
В iRidium (поле Data):	'PWR01',0x0D	'VOLUME 50',0x0D,0x0A	'AUD 1>3',0x0D	'6CH/8CH',0x0D,0x0A

Оформление символов "возврат каретки" <CR> и "конец строки" <LF>:

В документации:	<CR>	<CR>	<CR>	<LF>	<LF>	<LF>
В iRidium (поле Data):	0x0D	$0D	13	0x0A	$0A	10

Можно использовать любой из трех способов оформления конца строки.

↑ К оглавлению

Команды в формате HEX (шестнадцатеричный)

Внесите HEX символы в окно "Data":

* Перед каждым HEX символом поставьте 0x или $
* Разделяйте HEX символы запятыми, не используйте пробелы
* Если в документации у HEX символов стоят дополнительные метки, уберите их (FFh > FF)
* После последнего HEX символа укажите "возврат каретки" <CR> и "конец строки" <LF>

Исходная команда (в документации):	01 81 81 81 <CR>	16 8A FF <CR> <LF>	19h EEh A1h <CR> <LF>
В iRidium (поле Data):	0x01,0x81,0x81,0x81,0x0D	0x16,0x8A,0xFF,0x0D,0x0A	0x19,0xEE,0xA1,0x0D,0x0A

Оформление символов "возврат каретки" <CR> и "конец строки" <LF>:

В документации:	<CR>	<CR>	<CR>	<LF>	<LF>	<LF>
В iRidium (поле Data):	0x0D	$0D	13	0x0A	$0A	10

↑ К оглавлению

Команды в формате DEC (десятичный)

Внесите DEC числа в окно "Data":

* Не используйте дополнительных символов
* Разделяйте числа запятыми, не используйте пробелы
* После последнего числа укажите "возврат каретки" <CR> и "конец строки" <LF>

Исходная команда (в документации):	01 255 255 <CR>	20 30 40 50 <CR> <LF>
В iRidium (поле Data):	01,255,255,13	20,30,40,50,13,10

Оформление символов "возврат каретки" <CR> и "конец строки" <LF>:

В документации:	<CR>	<CR>	<CR>	<LF>	<LF>	<LF>
В iRidium (поле Data):	0x0D	$0D	13	0x0A	$0A	10

↑ К оглавлению

Работа с командами AV & Custom Systems (RS232)

Пример использования команды для AV & Custom Systems (RS232):

1. Добавьте драйвер AV & Custom Systems (RS232) в проект iRidium. Настройте параметры подключения к оборудованию.

2. Создайте команду, в поле Data укажите данные для отправки оборудованию

3. Настройте кнопку, которая будет отвечать за отправку команды.

Type: Button

Feedback: Momentary

4. Перетяните команду на кнопку

5. Выберите, по какому событию отправить команду:

Press - нажатие на элемент

Release - отпускание элемента

Hold - удержание элемента

Move - перемещение по элементу (в основном используется для элементов Level)

Нельзя изменить команду в поле Data, когда проект уже загружен на панель управления. Это значит, что если команда отвечает за установку громкости, например, на 50%, то ее нельзя привязать к уровню для плавного регулирования громкости. Она будет работать только с кнопкой (Button) и при каждом нажатии устанавливать громкость на 50%.

Чтобы отправить значение (например, громкость) с уровня, вам необходимо формировать команду не в дереве проекта, а с помощью скрипта (см. iRidium Script API и iRidium DDK)

↑ К оглавлению

Создание своей базы команд AV & Custom Systems (RS232)

Чтобы использовать устройство AV & Custom Systems (RS232) в проекте iRidium, сохраните его в базу данных iRidium.

Для добавления устройства в базу iRidium используйте DB Editor - редактор баз данных. Добавить новое устройство Вы можете только в свою базу данных, т.к. стандартные базы закрыты для изменения.

Создание базы - не единственный способ переноса команд между проектами iRidium. Если вы создали устройство с командами в проекте iRidium, то можете импортировать его в другой проект с помощью File > Import > *.irpz

Новая база данных:

Используйте для хранения своих устройств пользовательские базы данных. Они создаются в DB Editor. При создании базы укажите ее имя и директорию для сохранения

Новое устройство:

Тип создаваемого устройства - RS232 (RS232 Device), определяет его транспортную часть и характеристики.

Настройка устройства

Настройте описание, чтобы легче идентифицировать устройство:

• Device Type - тип управляемого устройства (TV, DVD, Blu Ray, ...)
• Manufacturer - наименование производителя устройства
• Description - описание устройства, может включать гиперссылки
• Date - дата создания драйвера

Параметры подключения:

• Port - номер СОМ-порта, к которому подключен контроллер
• Baud Rate - скорость обмена данными
• Data Bits - число информационных разрядов в кадре
• Parity - контроль четности.
• Stop Bits - cтоповый бит в кадре

Необязательные параметры:

• Parameters - дополнительные параметры для подключения
• Login - логин для подключения
• Password - пароль для подключения

Необязательные параметры можно скрыть: щелкните два раза по параметру, поставьте галочку Hiden в его настройках:

Добавление команд в список устройства

Перейдите во вкладку Commands & Feedback и воспользуйтесь инструментами редактора:

По умолчанию команда не содержит данных. Инструкция, которую должна отправить команда, задается в окне Comand Properties. Щелкните два раза по команде, чтобы открыть окно Comand Properties:

• В поле Command напишите инструкцию для команды, в нашем случае для команды Reset (перезагрузка устройства) есть инструкция '# RESET',13, где # RESET - это содержание инструкции, 13 = <CR> (команда отправляется в ASCII формате).
• Поставьте галочку в поле Name Read Only если не хотите, что бы имя команды можно было изменить (полезно, когда к команде обращается скрипт)
• В поле Descriptions задайте описание команды.

Когда все команды будут добавлены, закончим работу с DB Editor.

↑ К оглавлению