Biamp Tesira · TCP API · KNX Middleware · Управление DSP · Конференц-зал · 10 мин чтения

Интеграция Biamp Tesira с KNX: управление через TCP API, GA отключения звука и автоматизация конференц-сцены

Biamp Tesira не имеет встроенного плагина KNX – в отличие от QSC Q-SYS – однако открытый TCP API (Tesira Text Protocol на порту 8082) позволяет любой промежуточной платформе отправлять ASCII-команды для вызова пресетов, управления уровнем и отключения звука. Интеграция с KNX реализуется через промежуточный уровень, который транслирует записи в групповые адреса KNX в TCP-команды Tesira.

Основы Tesira TCP API

Tesira Text Protocol работает как простой протокол ASCII-команд/ответов через TCP на порту 8082. Команды имеют формат: OBJECT_NAME COMMAND [param1] [param2]. Сервер (Tesira) отвечает +OK {"value":"..."} при успехе или -ERR при ошибке.

Essential Tesira TCP commands

Connection:
 Host: <Tesira SERVER-IO IP address>
 Port: 8082
 Protocol: TCP, keep-alive
 Auth: SESSION login admin <password>

Preset recall:
 DEVICE recallPreset <preset_name>
 Example: DEVICE recallPreset "Conference Mode"
 Example: DEVICE recallPreset "Presentation Mode"
 Example: DEVICE recallPreset "Standby"

Level control (MIXER object):
 <MixerName> setLevel <input_index> <output_index> <level_dB>
 Example: MainMixer setLevel 1 1 -10.0
 (Input 1, Output 1, −10 dBFS)

 Level range: typically −60.0 to +12.0 dB
 KNX DPT 5.001 (0–100%) Tesira dB:
 0% −60 dB (silence), 100% 0 dB (unity)
 Linear mapping: level_dB = (value% / 100) × 60 − 60

Mute control:
 <MixerName> setMute <input_index> <output_index> <true|false>
 Example: MainMixer setMute 1 1 true (mute)
 Example: MainMixer setMute 1 1 false (unmute)

Get current level (for bidirectional feedback):
 <MixerName> getLevel <input_index> <output_index>
 Response: +OK {"value": -10.0}

Имена объектов: Имена MIXER-объектов, имена пресетов и индексы входов/выходов задаются в Tesira Software и должны точно совпадать (с учётом регистра) в TCP-командах. Экспортируйте дизайн Tesira для проверки всех имён объектов перед написанием кода middleware. Распространённая ошибка: пробелы в именах объектов должны быть заключены в кавычки в строке команды.

Подход KNX IP-Symcon Tesira TCP

IP-Symcon – это промежуточная платформа автоматизации зданий с нативными модулями KNX и TCP-клиента. Она отслеживает групповые адреса KNX и транслирует изменения в TCP-команды Tesira – наиболее надёжный способ для установок, где IP-Symcon уже используется как платформа визуализации или логики.

IP-Symcon Tesira integration (script excerpt)

// IP-Symcon PHP script triggered by KNX GA change event

// Called when GA 7/1/1 (Tesira mute) changes
function TesiraMute($mute_value) {
 $socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
 socket_connect($socket, "192.168.1.150", 8082);

 // Login
 socket_write($socket, "SESSION login admin Password123
");
 $response = socket_read($socket, 256); // expect +OK

 // Send mute command
 $cmd = $mute_value ? "true" : "false";
 socket_write($socket, "MainMixer setMute 1 1 $cmd
");
 $response = socket_read($socket, 256); // expect +OK

 socket_close($socket);
}

// KNX GA triggers:
// GA 7/1/0 (DPT 5.001 volume) TesiraSetLevel()
// GA 7/1/1 (DPT 1.001 mute) TesiraMute()
// GA 7/1/2 (DPT 5.010 preset) TesiraPresetRecall()
// value 0 = Standby, 1 = Conference, 2 = Presentation

Подход с интеграцией KNX через Home Assistant

Для объектов, использующих Home Assistant в качестве промежуточной платформы, интеграция HA KNX отслеживает групповые адреса, а автоматизация на основе Python-скрипта или shell-команды HA отправляет соответствующую TCP-команду Tesira. Этот подход не требует дополнительной лицензии на ПО помимо HA.

Home Assistant automations.yaml for Tesira mute

# KNX mute GA Tesira TCP command
automation:
 - alias: "CR1 Tesira Mute"
 trigger:
 - platform: state
 entity_id: binary_sensor.knx_cr1_mute
 action:
 - service: shell_command.tesira_mute
 data:
 mute: "{{ states('binary_sensor.knx_cr1_mute') }}"

# shell_commands.yaml:
tesira_mute: >
 python3 /config/scripts/tesira_cmd.py
 "MainMixer setMute 1 1 {{ mute == 'on' | lower }}"

# KNX configuration (configuration.yaml):
knx:
 binary_sensor:
 - name: "knx_cr1_mute"
 state_address: "7/1/1"
 sensor:
 - name: "knx_cr1_volume"
 state_address: "7/1/0"
 type: "percentU8" # DPT 5.001

# For preset recall – use number entity triggered by KNX:
 number:
 - name: "knx_cr1_preset"
 address: "7/1/2"
 min: 0
 max: 5
 step: 1

GA отключения звука, GA громкости и сцена вызова пресета

Схема групповых адресов KNX для управления Tesira следует тем же соглашениям DPT, что и интеграция QSC Q-SYS, обеспечивая единое программирование KNX-сенсорных панелей для разных DSP-платформ.

KNX GA	DPT	Команда Tesira	Примечания
7/1/0 – CR1 Громкость	DPT 5.001 (0–100%)	MainMixer setLevel dB	0%=−60dB, 100%=0dB линейно
7/1/1 – CR1 Отключение звука	DPT 1.001	MainMixer setMute true/false	1=откл., 0=вкл.
7/1/2 – CR1 Пресет	DPT 5.010 (беззнаковый)	DEVICE recallPreset по имени	0=Standby, 1=Конф., 2=Презент.
7/1/3 – CR1 Статус громкости	DPT 5.001	MainMixer getLevel (опрос)	Обратная связь: Tesira KNX
7/1/4 – CR1 Статус откл. звука	DPT 1.001	MainMixer getMute (опрос)	Обратная связь: Tesira KNX

Комбинированная сцена конференц-зала с освещением

Единственная GA сцены KNX запускает одновременно настройку звука Tesira и регулировку освещения DALI – создавая единое впечатление от переговорной комнаты одним нажатием кнопки или событием присутствия.

Conference room combined scene (KNX scene GA Tesira + DALI)

KNX scene GA 7/0/0 (DPT 18.001 combined room scene):

Scene 1 – "Conference" (value 0):
 Tesira: DEVICE recallPreset "Conference Mode"
 Routing: all microphones active, codec enabled
 Gain: conference optimised, AEC enabled
 Unmute: MainMixer setMute 1 1 false
 DALI: recall scene 3 (60%, 4000K, perimeter 30%)
 Display: power on (KNX binary output RS-232 power command)

Scene 2 – "Presentation" (value 1):
 Tesira: DEVICE recallPreset "Presentation Mode"
 Routing: laptop audio input to loudspeakers
 Gain: presentation optimised (higher output level)
 DALI: recall scene 4 (40%, 3000K – reduced for projector)
 HDMI: switch input 2 (laptop) to output 1 (projector)

Scene 0 – "Standby" (value 63 per DPT 18.001 convention):
 Tesira: DEVICE recallPreset "Standby"
 All inputs muted, level −60 dB
 DALI: recall scene 0 (all off)
 Display: power off (RS-232 power off command)

IP-Symcon/HA: monitors GA 7/0/0 sends matching Tesira preset
 + writes DALI scene and display GA simultaneously

Тест ввода в эксплуатацию

Проверьте TCP-соединение с Tesira с помощью сырого TCP-терминала (PuTTY в режиме Raw) перед настройкой middleware, чтобы убедиться в правильности ответов Tesira на команды. Затем проверьте сквозную цепочку от KNX Group Monitor через middleware до Tesira.

Tesira TCP commissioning test

Step 1: Raw TCP test (PuTTY):
 Host: <Tesira IP>, Port: 8082, Connection type: Raw
 Type: SESSION login admin <password>
 Response: +OK
 Type: DEVICE recallPreset "Standby"
 Response: +OK (no value returned for preset recall)
 Type: MainMixer setMute 1 1 true
 Response: +OK
 Type: MainMixer getMute 1 1
 Response: +OK {"value": true}

Step 2: Middleware test (IP-Symcon/HA):
 Write 1 to GA 7/1/1 (KNX mute) via ETS6 Group Monitor
 Check middleware log: Tesira command sent
 PuTTY session: MainMixer getMute should return true

Step 3: Volume feedback test:
 In PuTTY: MainMixer setLevel 1 1 -20.0
 Middleware should detect level change (if polling active)
 ETS6 Group Monitor: GA 7/1/3 (volume status) should update

Step 4: Combined scene test:
 Write 0 to GA 7/0/0 Scene 1 (Conference)
 Verify Tesira preset recalled (check Tesira Software monitor)
 Verify DALI scene 3 activates (visible lighting change)
 Verify display powers on