iRidium для Biamp Tesira
Набор инструментов для создания интерфейсов управления оборудованием от производителей Biamp.
документация обновлена 01.01.2024
Описание
Biamp Systems - производитель цифровых систем обработки и маршрутизации звука. На базе аудиоплатформ Biamp можно создавать системы озвучивания и оповещения на объектах. Tesira - Основная линейка оборудования.
Протестировано с оборудованием:
- Tesira DAN CI;
- Tesria X400. ## Подключение
Создание конфигурации производится родным приложением Tesira.
Первый шаг интеграции платформы TesiraFORTÉ с программным обеспечением - это создание файла конфигурации Tesira, который включает в себя блоки входов и выходов USB. Блоки входов USB (USB Input) и выходов USB (USB Output) можно вводить в меню I/O Blocks (Блоки ввода/вывода) на панели инструментов (Object Toolbar).
Подробное описание о предварительной настройке оборудования и создании файла конфигурации можно найти в официальной документации: Tesira Forte Manual.
Работа в iRidium
- В созданном проекте на вкладке Devices добавьте драйвер Biamp Tesira:
2. Укажите настройки подключения драйвера:

- Log Level - уровень логирования;
- Host - IP-адрес оборудования;
- Port - порт (по умолчанию 23);
- Login / Password - логин и пароль доступа к оборудованию с защищённым проектом;
- Wait for Connect (ms) - время ожидания подключения;
- Wait for Data (ms) - время обратной связи от оборудования;
- SSL - тип шифрования;
- Driver Version - версия драйвера.
Настройка команд и фидбеков

Для управления оборудованием настройте команды (Commands) и каналы обратной связи (Feedbacks). Чтобы отправить команду, перетяните ее на графический элемент и укажите значение (Value), которое необходимо отправить. Чтобы отобразить значение с канала обратной связи, перетащите Feedback на графический элемент, и укажите, каким образом вывести значение (Value).
Подробнее о работе с графическими элементами написано в статье "Типы графических элементов".
Commands
Укажите настройки команд:

- Name - имя команды;
- Block - тип блока в родном приложении (влияет на то, какой список атрибутов отобразится);
- Attribute Code - тип отправляемой команды / канала обратной связи;
- Instance Tag - уникальное имя, которое задает пользователь или генерирует приложение Tesira при создании блока;
- Index 1 - индекс команды / фидбэка. Обычно это номер входа / комнаты / канала / выхода (если тип канала output);
- Index 2 - индекс команды / фидбэка. Обычно это номер выхода;
- Command - команда, отправляемая на оборудование:
-
- get - получить (любое значение);
-
- set - установить (входные значения, в зависимости от команды);
-
- toggle - переключить (любое значение);
-
- subscribe - подписка на опрос значений от оборудования (значение периода опроса в мс., по умолчанию 1000);
-
- unsubscribe - отмена подписки опроса (любое значение);
-
- increment - шаг прироста значения (входные значения, в зависимости от команды);
-
- decrement - шаг уменьшения значения (входные значения, в зависимости от команды).
В таблице приведено более подробное описание параметров настройки:
| Custom | - | - | string | Возможность отправлять команды из API напрямую оборудованию например: | Level1 set level 1 - 69 (Instance Tag Command Attribute Code Index1 Index2 Value). |
| Service | recallPreset | - | Preset ID (Integer) | Вызов предустановки по ID. | |
| recallPresetByName | - | Preset name (string) | Вызов предустановки по имени. | ||
| savePreset | - | Preset ID (Integer) | Сохранение предустановки по ID (сохраняется состояние только тех блоков, которые добавлены в пресет в конфигураторе). | ||
| savePresetByName | - | Preset name (string) | Сохранение предустановки по Имени (сохраняется состояние только тех блоков, которые добавлены в пресет в конфигураторе). | ||
| Preset Button Block | preset | Set, Get, Increment, Decrement | ID пресета | Идентификатор предустановки настроенный на кнопке. | |
| Level Control Block | level | get, set, increment, decrement, subscribe, unsubscribe | -100.0 ~ 12.0 dB | Уровень элемента. | |
| maxLevel | get, set, increment, decrement | -100.0 ~ 12.0 dB | Максимальное значение уровня. | ||
| minLevel | get, set, increment, decrement | -100.0 ~ 12.0 dB | Минимальное значение уровня. | ||
| mute | get, set, toggle, subscribe, unsubscribe | 0 / 1 | Выключить звук канала. | ||
| Mute Control Block | mute | get, set, toggle, subscribe, unsubscribe | 0 / 1 | Выключить звук канала. | |
| Matrix Mixer Block | crosspointLevel | get, set, increment, decrement | -100.0 ~ 0.0 dB | Уровень пересечения входа / выхода. | |
| crosspointLevelState | get, set, toggle | 0 / 1 | Значение пересечения входа / выхода. | ||
| inputLevel | get, set, increment, decrement | -100.0 ~ 12.0 dB | Уровень входа. | ||
| inputMaxLevel | get, set, increment, decrement | -100.0 ~ 12.0 dB | Максимальный уровень входа. | ||
| inputMinLevel | get, set, increment, decrement | -100.0 ~ 12.0 dB | Минимальный уровень входа. | ||
| inputMute | get, set, toggle | 0 / 1 | Выключить звук входа. | ||
| outputLevel | get, set, increment, decrement | -100.0 ~ 12.0 dB | Уровень выхода. | ||
| outputMaxLevel | get, set, increment, decrement | -100.0 ~ 12.0 dB | Максимальный уровень выхода. | ||
| outputMinLevel | get, set, increment, decrement | -100.0 ~ 12.0 dB | Минимальный уровень выхода. | ||
| outputMute | get, set, toggle | 0 / 1 | Выключить звук выхода. |
Feedbacks
Укажите настройки каналов обратной связи:

- Name - имя фидбека;
- Block - cписок блоков управления;
- Attribute Code - код атрибута управления;
- Instance Tag - уникальное имя, которое задает пользователь или генерирует приложение Tesira при создании блока;
- Index 1 - индекс фидбэка. Обычно это номер входа / комнаты / канала / выхода (если тип канала output);
- Index 2 - индекс фидбэка. Обычно это номер выхода;
- Polling Interval (sec) - интервал опроса (0 - не опрашивать).
В таблице приведено более подробное описание параметров настройки:
| Matrix Mixer Block | crosspointLevel | -100.0 ~ 0.0 dB | Уровень пересечения входа / выхода. |
| crosspointLevelState | 0 / 1 | Значение пересечения входа / выхода. | |
| inputLevel | -100.0 ~ 12.0 dB | Уровень входа. | |
| inputMaxLevel | -100.0 ~ 12.0 dB | Максимальный уровень входа. | |
| inputMinLevel | -100.0 ~ 12.0 dB | Минимальный уровень входа. | |
| inputMute | 0 / 1 | Выключить звук входа. | |
| outputLevel | -100.0 ~ 12.0 dB | Уровень выхода. | |
| outputMaxLevel | -100.0 ~ 12.0 dB | Максимальный уровень выхода. | |
| outputMinLevel | -100.0 ~ 12.0 dB | Минимальный уровень выхода. | |
| outputMute | 0 / 1 | Выключить звук выхода. | |
| Level Control Block | level | -100.0 ~ 12.0 dB | Уровень элемента. |
| maxLevel | -100.0 ~ 12.0 dB | Максимальное значение уровня. | |
| minLevel | -100.0 ~ 12.0 dB | Минимальное значение уровня. | |
| mute | 0 / 1 | Выключить звук канала. | |
| Mute Control Block | mute | 0 / 1 | Выключить звук канала. |
| Preset Button Block | preset | ID пресета | Идентификатор предустановки настроенный на кнопке. |