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

Solutions

Technologies

Knowledge

Company