20
Kramer Electronics, Ltd. СиСтемы управления KramEr указания по построению виртуального устройства редакция 1 предназначено для технического персонала Kramer или самостоятельных системных интеграторов. Чтобы убедиться в том, что вы пользуетесь новейшей версией, зайдите в секцию загрузки DOWNLOaDS нашего веб-сайта по адресу: http://www.kramerelectronics.com/support/downloads.asp

СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

  • Upload
    others

  • View
    28

  • Download
    0

Embed Size (px)

Citation preview

Page 1: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

Kramer Electronics, Ltd.

СиСтемы управления KramEr

указания по построению виртуального устройства

редакция 1

предназначено для технического персонала Kramer или самостоятельных системных интеграторов. Чтобы убедиться в том, что вы пользуетесь новейшей версией, зайдите в секцию загрузки DOWNLOaDS нашего веб-сайта по адресу: http://www.kramerelectronics.com/support/downloads.asp

Page 2: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

KRAMER ELECTRONICS, LTD.2

Торговые марки: Microsoft и Windows являются либо зарегистрированными торговыми марками, либо торговыми марками Microsoft Corporation в США и/или других странах. Linux является зарегистрированной торговой маркой Linus Torvalds в США и дру-гих странах. Android является торговой маркой Google Inc. iPhone, iPad и iOS являются зарегистрированными торговыми марками Apple Inc.

Содержание

1 ВВедение ....................................................................................... 31.1 Определения (в контексте настоящего документа) ............................ 42 Слой коммуникаций .................................................................. 43 ВирТуальное уСТройСТВо — пример приложения ................. 53.1 Обзор системы ............................................................................... 53.2 Аппаратное обеспечение системы ................................................... 63.3 Реализация ..................................................................................... 63.3.1 Пример построения системы ........................................................... 73.4 Функциональные возможности ....................................................... 93.4.1 Установка соединения с контроллером Master RC ............................ 93.4.2 Передача и прием данных в/из контроллера Master RC ....................124 проТокол обмена Protocol 3000 ............................................ 164.1 Формат сообщения ведущего устройства ........................................ 164.1.1 Простая команда ........................................................................... 164.1.2 Длинный ответ устройства (команда эхо) ........................................ 164.2 Подробно о составных частях команды ..........................................174.3 Ввод команд ...................................................................................184.4 Формы команд ..............................................................................184.5 Максимальная длина вводимой строки ............................................18

Page 3: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

3

1 введениеКомпания Kramer Electronics предоставляет широкий выбор техники для управления, которая соответствует разнообразным и многочисленным требованиям к изображению и звуку. Эти решения формируют систему управления Kramer и предоставляют возможность целостной совместимо-сти с продукцией Kramer для управления сигналами и масштабирования, а также взаимодействие с устройствами отображения и прочей продукцией третьих сторон для законченных решений управления помещением. Перечень управляющих воздействий (макрос), поставленный в соответ-ствие конфигурирующим приложением K-Config различным физическим (клавиатурные контроллеры) и программным условиям запуска, может также выполняться путем пересылки команд протокола Kramer Protocol 3000 по интернет-протоколу IP. Настоящий документ представляет собой указания по построению при-ложений (обозначаемых как «виртуальные устройства» в программе K-Config и в настоящем документе), которые будут служить устройствами пользовательских интерфейсов в системах управления помещениями на основе решений Kramer. Приложение способно работать на любой платформе (мобильной, PC и т.д.) и под управлением любой операционной системы (Windows®, Linux®, Android™, iOS® и т.д.) — в зависимости от компетентности разработчика и предпочтений конечного пользователя. Разработчик может воспользоваться указаниями по разработке «вирту-ального устройства» для создания приложения для виртуального устрой-ства — без каких-либо ограничений платформы, дизайна и т.д. Настоящий документ рассчитан на компетентных разработчиков в области соответствующей операционной системы и соответствующих устройств.

Введение

Page 4: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

KRAMER ELECTRONICS, LTD.4

Слой коммуникаций

1.1 определения (в контексте настоящего документа) Система K-NEt™ — система управления Kramer, состоящая как минимум из двух устройств (одно из них, устройство пользовательского интер-фейса, может быть виртуальным устройством). Устройства K-NET взаи-модействуют друг с другом посредством протокола Kramer Protocol 3000. Каждое из устройств системы K-NET имеет свой собственный уникальный идентификационный номер K-NET. Главный контроллер помещения (Master rc) – устройство управле-ния помещением Kramer; используется в качестве ведущего устройства в инсталляции для управления помещением на базе K-NET. Контроллер Master RC будет иметь идентификатор K-NET, равный единице, и будет запускать соответствующий файл конфигурации, созданный в приложе-нии K-Config. На февраль 2011 применимые контроллеры Master RC про-изводства Kramer, подходящие для систем виртуальных устройств: SV-551, SV-552, Sl-1, Sl-10, Sl-12 и Sl-14rc. Вспомогательное устройство K-NEt — устройство Kramer K-NET, кото-рое является составной частью системы управления помещением Kramer и соединяется с контроллером Master RC с помощью кабеля K-NET. Иден-тификатор K-NET вспомогательного устройства всегда будет больше еди-ницы. Виртуальное устройство — Приложение, имитирующее устройство пользовательского интерфейса, которое взаимодействует по интернет-протоколу IP с одним контроллером Kramer Master RC как составная часть системы K-NET. Виртуальное устройство будет использовать один из двух зарезервированных идентификационных номеров K-NET — 11 или 12. Слой триггеров виртуального устройства K-config — Функциональное дублирование активных кнопок и текстовых ролей виртуального устрой-ства в приложении K-Config. Предназначено для связи меню виртуального устройства с перечнем управляющих воздействий (макросов), записанных с помощью K-Config.

2 Слой коммуникаций Виртуальное устройство использует Ethernet-соединение (проводное или беспроводное) и протокол Protocol 3000 (см. раздел 4) для коммуникации со связанным с ним контроллером Master RC.

Page 5: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

5

Виртуальное устройство — пример приложения

3 виртуальное уСтройСтво — пример приложения В приведенных ниже пунктах определены общие указания по построению виртуального устройства.

3.1 обзор системы Источники сигналов • Декодер каналов спутникового ТВ (звуковой и видеосигнал с выхода HDMI)

• DVD-проигрыватель (видеосигнал с выхода композитного видео CV с аналоговым стереофоническим звуком) • PC или ноутбук (графический сигнал PC с выхода HD на 15-контактном разъеме с аналоговым стереофоническим звуком)

Устройство отображения Плоскопанельный ЖК-дисплей

Контроллер Master RC Процессор-коммутатор SV-552 SummitView™

Все источники сигналов передают звуковые и видеосигналы в SV-552 (с помощью настенных панелей SV-30X), который выдает выходные видео-сигналы на плоскопанельный ЖК-дисплей, а усиленный звуковой сигнал — на пару потолочных громкоговорителей. В этом примере системы в качестве пользовательского интерфейса, выда-ющего сигналы коммутации, применен iPhone® либо сотовый телефон, работающий под управлением операционной системы Android. Режимы звука и управления помещением настраиваются в SV-552 (см. рис. 1).

Рис. 1. Пример приложения

SV-552

PC или ноутбук Спутниковое телевидение

DVD-проигрыватель Телевизор HDTV

Page 6: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

KRAMER ELECTRONICS, LTD.6

Виртуальное устройство — пример приложения

3.2 аппаратное обеспечение системы Для соединения между мобильным устройством (iPhone/iPad®/Android) и контроллером Kramer Master RC (в данном примере — SV-552) использу-ется соединение UDP (User Datagram Protocol — протокол пользователь-ских дейтаграмм) через порт 50000. И контроллер Master RC, и мобильное устройство должны пользоваться одним и тем же диапазоном сети/подсети. Контроллер Master RC (в дан-ном примере — SV-552) будет использовать проводное подключение к соответствующей локальной сети, в то время как мобильное устройство будет подключаться с помощью беспроводного соединения к той же самой сети, поэтому, по всей вероятности, будет использоваться беспроводной маршрутизатор или точка доступа (см. рис. 2).

Рис. 2. Физическое соединение

3.3 реализация Контроллеры главных помещений Kramer используют протокол Protocol 3000 для взаимодействия с различными вспомогательными устройствами K-NET — в том числе с виртуальными устройствами (см. раздел 4). Прило-жение должно использовать этот протокол для взаимодействия с контрол-лером Kramer Master RC, а Master RC будет взаимодействовать (обычно посредством RS-232, ИК или других распространенных интерфейсов и протоколов управления) с аудиовизуальным оборудованием, которым оснащено помещение. Каждая кнопка (или значок пускового устройства, используемый вир-туальным устройством) должна функционально дублироваться в слое пусковых устройств виртуального устройства K-Config. Внешний вид и размер кнопок и текстовых полей пусковых устройств, как это видно в графическом представлении, видимом в K-Config, не имеет реального значения. Единственное, на что следует обратить внимание, — это идентификационный номер каждой из функциональных кнопок, что позволяет разработчикам адресовать каждую из них в приложении вир-туального устройства и таким путем отрабатывать необходимый перечень управляющих воздействий.

Беспроводное соединение

Кабельное соединение

Беспроводной маршрутизатор SV-552

Page 7: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

7

Виртуальное устройство — пример приложения

Из изложенного выше должно быть ясно, что дизайн приложения вир-туального устройства, вид и функции, стиль или любые другие свойства никак не ограничены и зависят только от потребностей пользователя и его возможностей.

3.3.1 пример построения системы Пример, приведенный на рис. 3, показывает приложение, включающее три меню: • Главное меню • Меню настроек • Меню виртуального устройства (коммутация источников сигнала) Первые два меню предназначены для настройки и перехода в меню вирту-ального устройства (третье меню). Меню виртуального устройства дубли-руется в слое пусковых устройств виртуального устройства K-Config.

Рис. 3. Примеры меню приложений

Главное менюВ главном меню содержатся три кнопки: • SETTINGS — для перехода к меню настроек • VIRTUAL DEVICE — для перехода к меню виртуального устройства • EXIT — для выхода из приложения Все три кнопки относятся к внутренним функциям или процедурам при-ложения виртуального устройства; таким образом, они не дублируются в слое пусковых устройств виртуального устройства K-Config.

ГЛАВНОЕ МЕНЮ НАСТРОЙКИ ВИРТУАЛЬНОЕ УСТРОЙСТВО

Page 8: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

KRAMER ELECTRONICS, LTD.8

Виртуальное устройство — пример приложения

меню настроекМеню настроек позволяет Вам настраивать коммуникационные параме-тры c помощью контроллера Master RC и также содержит три кнопки: • IP (как опция) — для ручной настройки IP адреса контроллера Master RC • K-ID — для перехода к идентификатору K-NET ID приложения вирту-

ального устройства• CONNECT — для соединения с контроллером Master RC Такой ручной подход к соединению оказывается полезным, если одно и то же приложение виртуального устройства запущено на одном и том же физическом устройстве в качестве пользовательского интерфейса для различных помещений K-NET (разных контроллеров Master RC). В большинстве случаев конечный пользователь не должен иметь про-стой возможности изменения настроек IP, а особенно — идентификатора K-NET виртуальных устройств, поскольку изменение этих настроек при-ведет к потере связи с контроллером Master RC. Данное меню также не дублируется в слое пусковых устройств виртуаль-ного устройства K-Config.

меню виртуального устройстваМеню виртуального устройства содержит три кнопки, которые активируют переключение коммутатора, масштабатора или аналогичного устройства в помещении (для многих систем помещений потребуется также переключе-ние входного канала устройства отображения в помещении), а также тек-стовую метку «Select Source» (выбор источника сигнала, см. рис. 4). Данное меню дублируется как виртуальное устройство в слое пусковых устройств виртуального устройства K-Config.

Рис. 4. Кнопки виртуального устройства и метка

ВИРТУАЛЬНОЕ УСТРОЙСТВО

Метка 1

Кнопка 1Кнопка 2Кнопка 3

Page 9: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

9

Виртуальное устройство — пример приложения

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

3.4 Функциональные возможности В следующих разделах описывается: • Установка соединения с контроллером Master RC (см. подраздел

3.4.1) • Пересылка/прием данных в/из контроллера Master RC (см. подраздел

3.4.2)

3.4.1 установка соединения с контроллером Master rc Виртуальное устройство можно соединить с контроллером Master RC раз-личными способами. В приведенном в подразделе 3.3.1 примере меню настроек предназначено для ввода IP адреса и идентификатора K-NET, после чего нажатие кнопки CONNECT устанавливает соединение с контроллером Master RC. Действуя иначе, эту процедуру установления связи можно выполнять автоматически во время запуска приложения или в рамках любого дру-гого заданного разработчиком события. В любом случае процедура соединения открывает соединение UDP, и, как только соединение установлено, виртуальное устройство передает команду установки связи Handshaking (см. раздел 4):

#\r

Page 10: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

KRAMER ELECTRONICS, LTD.10

Виртуальное устройство — пример приложения

Затем приложение виртуального устройства ожидает ответа от контрол-лера Master RC в течение заранее заданного интервала времени, как это показано на рис. 5:

Рис. 5. Соединение виртуального устройства с контроллером помещения

ШАГ 1

ШАГ 2

ШАГ 3

Page 11: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

11

Виртуальное устройство — пример приложения

Сразу же после приема ответа «OK» от контроллера Master RC, соедине-ние установлено (см. рис. 6).

Рис. 6. Блок-схема соединения

ФУНКЦИЯ СОЕДИНЕНИЯ

СОЕДИНЕНИЕ UDP

ПЕРЕСЫЛКА («#\r»)

ОЖИДАНИЕ ОТВЕТА

ОТВЕТ = «~01 OK»

ОШИБКА СОЕДИНЕНИЯ ИЛИ

ТАЙМ-АУТА

ПРОЧЕЕ

ЗАПУСК ПРИЕМНИКА

ДАННЫХ

ОБРАБОТЧИК ОШИБОК

КОНЕЦ

Page 12: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

KRAMER ELECTRONICS, LTD.12

Виртуальное устройство — пример приложения

3.4.2 передача и прием данных в/из контроллера Master rcКонтроллер Master RC передает свои исходящие сообщения в формате Protocol 3000 на шину K-NET. Все его сообщения передачи данных пересы-лаются во все устройства K-NET, которые к нему подключены. Каждое из дополнительных устройств K-NET должно выполнять только те команды, которые соответствуют его идентификатору K-NET. Все остальные команды должны игнорироваться (см. рис. 8).В зависимости от задействованного контроллера Master rc могут использоваться до двух виртуальных устройств с зарезервированными идентификаторами K-NEt «11» и «12». Идентификатор K-NET виртуального устройства задается в программе K-Config как свойство слоя пусковых устройств виртуального устройства K-Config.

Page 13: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

13

Виртуальное устройство — пример приложения

Рис. 7. Блок-схема приема данных от контроллера помещения

ФУНКЦИЯ ПРИЕМНИКА ДАННЫХ

ОЖИДАНИЕ ДАННЫХ

ДА ПРИЕМ ДАННЫХ

НЕТ

ДА НЕТ

K-ID

=

VD-K-ID

ОШИБКАСОЕДИНЕНИЯ

ДА

НЕТ

АНАЛИЗ

ДАННЫХ

КОМАНДА = «RGB»

КОМАНДА = «LABEL»

КОМАНДА =НЕ ОПОЗНАНА

СМЕНА ЦВЕТА

КНОПКИ

СМЕНА ЦВЕТА МЕТКИ

КОНЕЦ

Page 14: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

KRAMER ELECTRONICS, LTD.14

Виртуальное устройство — пример приложения

Количество кнопок виртуального устройства и их функциональность задаются с помощью программного обеспечения K-Config в слое пуско-вых устройств виртуального устройства K-Config. При нажатии «кнопки» в приложении виртуального устройства соответствующая команда будет пересылаться в контроллер Master RC. В следующем примере виртуальное устройство имеет идентификатор K-NET ID = 11, и при нажатии первой кнопки (#1 в заданном слое пусковых устройств виртуального устройства K-Config) виртуального устройства выполняются следующие действия: • Кнопка сменяет свой цвет на красный • Текстовая метка (заданное текстовое поле) сменяется полем PC

SELECTED (выбрано PC) • Контроллер SV-552 переключается на вход VGA Пересылаемая из виртуального устройства команда имеет сле-дующий вид:

#BTN 1,11,R\r // Пересылка команды из приложения виртуаль-ного устройства

Ответ контроллера Master RC на данное событие, как задано для кнопки 1 виртуального устройства с идентификатором K-NET ID=11 в K-Config имеет следующий вид:

#11@RGB 1,255,0,0,1 // Установить КРАСНЫЙ цвет на виртуаль-ном устройстве #11@LABEL 1,”ON” // Установить метку «PC SELECTED» на вирту-альном устройстве #... (некоторые другие команды) ~01@BTN 1,11,R OK // ПОДТВЕРЖДЕНИЕ команды от контроллера Master RC

Приложение принимает ответ и сменяет цвет кнопки на красный, а метку на «PC SELECTED», как это показано на рис. 8:

Page 15: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

15

Виртуальное устройство — пример приложения

Рис. 8. Пересылка и прием команд

Это важно: контроллер Master RC может пересылать в основном команды состояния/подсветки кнопок и смены текстовых полей в свои вспомогательные устройства K-Net. Однако опытный разработчик с легкостью может воспользоваться комбинацией виртуальных кнопок, определенных как свойство виртуального устройства в K-Config, и использовать эти сообщения как глобальные переменные или другие мощные возможности, обеспечивающие гибкость программирования.

Например, кнопка #15 в виртуальном устройстве #12 не видна в приложе-нии виртуального устройства. Вместо этого состояние ее цвета изменяется как составная часть перечня воздействий K-Config и использует глобаль-ную переменную. Приложение виртуального устройства будет проверять это при необходимости (If BTN15=BLUE then…., If BTN15=RED then…).

ШАГ 1

ШАГ 2

Page 16: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

KRAMER ELECTRONICS, LTD.16

Протокол связи Protocol 3000

4 протокол обмена PrOtOcOL 3000 [CR] = возврат каретки (ASCII 13 = 0x0D)[LF] = перевод строки (ASCII 10 = 0x0A)[SP] = пробел (ASCII 32 = 0x20)

4.1 Формат сообщения ведущего устройстваначало адрес (не обязатель-

ный) Тело разделитель

# Идентификатор_назначения@

Сообщение [CR]

4.1.1 простая команда (командная строка, содержащая только одну команду без адресации):

начало Тело разделитель

# команда [SP] Параметр_1,Параметр_2,…

[CR]

Формат сообщения, получаемого от устройства: начало адрес (не обязатель-

ный)Тело разделитель

~ Идентификатор_отправителя@

Сообщение [CR] [LF]

4.1.2 длинный ответ устройства (команда эхо)начало адрес (не обязатель-

ный)Тело разделитель

~ Идентификатор_отправителя@

команда [SP] [параметр1 ,параметр2 …] результат

[CR] [LF]

Page 17: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

17

Протокол связи Protocol 3000

4.2 подробно о составных частях команды команда: Последовательность букв ASCII («A» … «Z», «a» … «z» и «-»). Команды будут отделяться от параметров не менее чем одним пробелом. параметры: Последовательность алфавитно-цифровых символов ASCII («0» … «9», «A» … «Z», «a» … «z» и некоторые специальные символы для специфи-ческих команд). Параметры будут разделяться запятыми.

Строка сообщения: Каждая из команд должна вводиться как часть строки сообщения, кото-рая начинается с символа начала сообщения и завершается символом закрытия сообщения. Следует учесть, что строка может содержать более чем одну команду. Команды разделяются символом вертикальной линии («|»). Символ начала сообщения: «#» — для запроса или команды ведущего устройства. «~» — для ответа устройства.адрес устройства: Идентификатор устройства K_NET после символа «@». Вопросительный знак = «?» будет следовать после некоторых команд для определения запроса. Символ закрытия сообщения: Сообщения ведущего устройства: возврат каретки (ASCII 13), в настоящем документе будет обозначаться [cr]. Сообщения устройства: возврат каретки (ASCII 13) + Перевод строки (ASCII 10), в настоящем документе будет обозначаться [crlF]. Пробелы между параметрами или составными частями команды будут игнорироваться.

Page 18: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

KRAMER ELECTRONICS, LTD.18

Протокол связи Protocol 3000

4.3 Ввод командЕсли используется программное обеспечение терминала для соединения по последовательным интерфейсам, по сети Ethernet или через порт USB, возможен непосредственный ввод всех символов команды с клавиатуры (CR будет вводиться с помощью клавиши Enter, эта клавиша, кроме того, передает и LF, однако данный символ будет игнорироваться анализатором команд). Передача команд от некоторых контроллеров (например, Crestron) требует кодирования некоторых символов в особой форме (например, \X##). Так или иначе, существует способ ввода всех символов ASCII, таким образом, возможна передача всех команд и с контроллера.

4.4 Формы команд Некоторые команды имеют сокращенный синтаксис имени по сравнению с полным именем, что позволяет быстрее вводить их. Ответ всегда при-ходит в полном синтаксисе.

4.5 максимальная длина вводимой строки64 символа.

команды общего назначения

команда Синтаксис ответ Подтверждение установления связи по протоколу

#[DEV_ID]@ [CR] ~ DEV_ID@ OK [CR][LF]

Параметры: [DEV_ID]: Каждое из устройств имеет свой собственный идентификатор K-Net, который соответствует опреде-ленному устройству в древовидной структуре конфигурации K-Config. Вспомогательное устройство K-Net должно реагировать только на команды, перед которыми следует их соб-ственный идентификатор. Пример: Обращение к устройству: #03@ [CR]Ответ устройства: ~03@ oK [CR][LF]

примечание: Каждое из устройств (или приложений, которые имитируют устройства) должно отвечать на этот запрос, если он предваряется их идентификатором K-NET.

Page 19: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

19

Протокол связи Protocol 3000

[BTN] — Идентификатор кнопки в соответствии с конфигурацией, заданной K-Config [RED], [GREEN], [BLUE] — Интенсивность цвета каждого из основных цветов (красного, зеленого, синего). Диапазон значений — от 0 (нет цвета) до 255 (полный цвет). Одноцветные кнопки, которые поддерживают только включение/выключение подсветки, будут игнорировать значения этих параметров (за исключением случая установки их всех в нулевое значение — то же, что и отключение подсветки). [STATE] = «0» или «Off» (параметры цвета можно игнорировать). «1» или «On» (включено)«2» или «Slow» — для медленного мигания «3» или «Fast» — для быстрого мигания [RESULT] – OK, если команда была выполнена. Сообщение «#[DEV_ID]@RGB ERR 003» должно возвращаться, если любой из параметров превышает свое предельное значение (например, если идентификатор кнопки не существует).

Пример: Ведущее устройство: #03@RGB 1,0,255,0,1[cr] Результат: Приложение устройства должно подсветить свою кнопку 1 и установить полный зеленый цвет. Ответ приложения устройства: ~03@RGB 1,0,255,0,1 OK[crlF]

прочитать текущее состояние свето-диодных индикаторов кнопки rGB

#[DEV_ID]@rGB? [BTN][cr] ~[DEV_ID]@[rGB [BTN], [RED], [GREEN], [BLUE], [STATE] [crlF]

Устройство, в котором применяются подсвеченные кнопки, должны реагировать на эту команду и выдавать состояние подсветки кнопки. Устройство может поддерживать полноцветные кнопки или лишь обычное включение/выключение подсветки. [BTN] — Идентификатор кнопки в соответствии с конфигурацией, заданной K-Config [RED], [GREEN], [BLUE] — Интенсивность цвета каждого из основных цветов (красного, зеленого, синего). Диапазон значений — от 0 (нет цвета) до 255 (полный цвет). Одноцветные кнопки, которые поддерживают только включение/выключение подсветки, могут устанавливать произвольные значения этих параметров (за исключением случая установки их всех в нулевое значение — то же, что и отключение подсветки). [STATE] = «0» или «Off» (значения параметров цвета не имеют значения). «1» или «On» (включено)«2» или «Slow» — для медленного мигания «3» или «Fast» — для быстрого мигания

Пример: Ведущее устройство: #03@RGB? 1[cr] Ответ приложения устройства: ~03@RGB 1,0,255,0,1[crlF]

Записать текст в lcD #[DEV_ID]@lcD [LCD_ID],[”TEXT”][cr]

~[DEV_ID]@lcD [LCD_ID],[”TEXT”] [RESULT] [crlF]

Устройство, в котором имеется дисплей (LCD), должно отреагировать на эту команду и установить «LCD» (или текстовую метку). [LCD_ID] — Метка идентификатора (дисплея LCD) в соответствии с конфигурацией, заданной в K-Config [TEXT] — Текст для отображения на дисплее (данный параметр должен быть заключен в кавычки — символ 34 в ASCII) [RESULT] — OK, если команда была выполнена. Сообщение «LCD ERR 003» должно возвращаться, если любой из параметров превышает свое предельное значение (например, если LCD с таким идентификатором не существует).

Считать текст из lcD #[DEV_ID]@lcD? [LCD_ID][cr] ~[DEV_ID]@lcD [LCD_ID], [”TEXT]”[crlF]

Устройство, в котором имеется дисплей (LCD), должно отреагировать на эту команду и вернуть текст, выво-димый в настоящий момент на дисплее. [LCD_ID] — Метка идентификатора (дисплея LCD) в соответствии с конфигурацией, заданной в K-Config [TEXT] — Текст, отображаемый на дисплее (данный параметр будет заключен в кавычки — символ 34 в ASCII)

Page 20: СиСтемы управления KramEr · 3.2 Аппаратное обеспечение системы ... 3.4.1 Установка соединения с контроллером

KRAMER ELECTRONICS, LTD.20

Протокол связи Protocol 3000

Восстановить пользовательский интерфейс

#01@UI [DEVICE_ID][cr] ~01@UI [DEVICE_ID] oK[crlF]

После ответа OK ведущее устройство должно переслать в устройство команды для обновления элементов пользовательского интерфейса, — наподобие кнопок RGB и меток LCD. Например: #[DEV_ID]@rGB 1, [RED], [GREEN], [BLUE], [STATE][cr] #[DEV_ID]@rGB 2, [RED], [GREEN], [BLUE], [STATE][cr] …(все команды для подсветки кнопок rGB) #[DEV_ID]@lcD 1,[”TEXT”][cr] #[DEV_ID]@lcD 2,[”TEXT”][cr] …(все надписи на дисплеях lcD) Воспользуйтесь этой командой, чтобы обеспечить правильное состояние пользовательского интерфейса при запуске программы или чтобы обновить пользовательский интерфейс при необходимости.

итоговые коды (ошибки)

Синтаксис

Ошибки нет. Команда прошла успешно. ~[DEV_ID]@COMMAND] [PARAMETERS] oK[crlF]

ошибки протокола

Синтаксическая ошибка ~[DEV_ID]@[COMMAND] Err001[crlF]

Команда недоступна для данного устройства ~[DEV_ID]@ Err002[crlF]

Параметр вне диапазона ~[DEV_ID]@COMMAND] Err003[crlF]

Несанкционированный доступ (исполнение команды без входа в систему)

~[DEV_ID]@COMMAND] Err004[crlF]

команды обеспечения безопасностикоманда Синтаксис ответ Считать флаг степени защиты

SEcUr? SEcUr [ON/OFF]

Вход в систему loGIN [AUTH] [PASSWORD] loGIN [AUTH RESULT] получить логин loGIN? loGIN [AUTH] Выход из системы loGoUt loGoUt [RESULT ][AUtH] = USER \ ADMIN. [ON/OFF] = «0» или «OFF» «1» или «ON» алгоритм входа в систему: (пароль и безопасный режим SEcUr можно установить из программы K-config). 1. переслать команду SEcUr?2. если ответ имеет вид SEcUr oFF: вход в систему не требуется. 3. если ответ имеет вид SEcUr oN: продолжить вход в систему (шаг 4) 4. переслать логин и пароль loGIN USEr, PASSWORD 5. устройство перейдет к обычной работе. 6. при отсутствии взаимодействия в течение более чем 5 минут: сокет UDP будет закрыт, а устройство автоматически выйдет из системы, поэтому вход в систему придется выполнить заново. 7. Чтобы предотвратить автоматический выход из системы: можно время от времени пересылать любую команду (например, установления связи). 8. при выходе из программы переслать команду выхода из системы loGoUt (если это не так, устройство автоматически выйдет из системы по истечении тайм-аута). Сессии с защитой паролем: При входе в систему с паролем пользователя или администратора откроется соответствующая сессия, таким образом, имеется возможность продолжения ввода команд без повторного входа в систему до прерывания соединения. Для соединения Ethernet: сессии будут открываться до тех пор, пока активно соединение сокета. Для последовательного или USB соединения: сессия будет активной до истечения интервала тайм-аута.

* Чтобы сбросить пароль администратора, необходим сброс к настройкам предприятия-изготовителя всех данных устройства.