Конференц-системы KCS-TKR/Инструкции/Программирование интерфейса управления

Подключение

Сенсорный интерфейс управления представляет собой веб-страницу, загружаемую со встроенного в контроллеры TKx веб-сервера. Интерфейс формируется контроллером на основе xml-файла, описывающего видимые элементы страницы. Видимые элементы отправляют события управляющему модулю, который осуществляет непосредственную коммуникацию со всеми аппаратными средствами.

Веб-интерфейс центрального блока KCS-TKR описывается одним XML файлом, изображения видимых элементов могут быть загружены во внутреннюю память ЦБ. Для программирования веб-интерфейса необходимо подключиться к центральному блоку по протоколу FTP, логин programmer, пароль вам должен сообщить ваш дистрибьютор. IP адрес центрального контроллера зависит от условий использования. Настройки Far Manager для подключения:

После подключения вы попадаете в корневую папку. Файл webface.xml (описание видимых элементов) и папка img (изображения видимых элементов) находятся в папке www.

Формат файла XML

Стандарт именования изображений

Предопределенные ID

Файл конфигурации tkrd.conf

Файл также находится в корневой папке при доступе по FTP под логином programmer. Представляет собой стандартный текстовый INI-файл. Этот формат предполагает определение секций в квадратных скобках, в каждой секции может быть неограниченное количество записей либо в виде строки без пробелов, либо в виде пары «параметр = значение». Весь синтаксис файла чувствителен к регистру. Обновление конфигурации центрального блока происходит автоматически после сохранения изменений в файле, никаких дополнительных действий не требуется.

Секция MAIN содержит всего один параметр mic_count, определяющий количество микрофонов в системе:

[MAIN]
mic_count = 32

Секция UPDATE содержит список предопределённых id управления аудиоплатформой, которые присутствуют в веб-интерфейсе и которые необходимо обновлять (у аудиоплатформы очень много параметров, если обновлять все — это существенно замедлит обмен данными). На одной строке — один id:

[UPDATE]
/~dsp/gain/in/1
/~dsp/mute/in/1
/~dsp/gain/in/3
/~dsp/mute/in/3
и т. д.

Секция MIDI содержит настройки MIDI-контроллера (обновление 2025 года). В случае применения контроллера EASYcontrol эта секция может отсутствовать.

Параметр scheme определяет, какой MIDI-контроллер используется с центральным блоком, может принимать 2 значения: XTOUCH для Behringer X-Touch Extender и KORG для KORG Nanocontrol 2:

[MIDI]
scheme = XTOUCH

Далее для режимов XTOUCH и KORG определяются «привязки» органов управления MIDI-контроллера к видимым элементам веб-интерфейса, кроме того, для X-Touch определяются надписи и цвет подсветки на дисплеях. Для каждой группы необходимо задать следующие параметры:

text<номер>up - верхняя строка текста на дисплее
text<номер>dn – нижняя строка текста на дисплее
col<номер> - цвет подсветки (цифра 0-7)
mute<номер>_event – предопределённый id кнопки «mute»
fader<номер>_event – предопределённый id фейдера

Номера указываются без пробела, напр. fader1_event.

Nanocontrol 2 не оснащён дисплеями, соответственно, для него указание этих параметров не имеет смысла, достаточно только привязать mute, а вот привязка фейдера необходима, т. к. они работают в обе стороны (при движении фейдера MIDI-контроллера генерируется событие с этим id, если его не указать — фейдер не будет работать).

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