Biamp Tesira · TCP API · KNX Middleware · Control DSP · Sala de conferencias · 10 min de lectura

Integración Biamp Tesira KNX: control API TCP, GAs de silencio y automatización de escenas de conferencia

Biamp Tesira no dispone de un plugin KNX nativo — a diferencia de QSC Q-SYS — pero su API TCP abierta (Tesira Text Protocol en el puerto 8082) permite a cualquier plataforma middleware enviar comandos ASCII para llamada de presets, control de nivel y silencio. La ruta de integración KNX utiliza una capa middleware que traduce las escrituras de direcciones de grupo KNX en comandos TCP Tesira.

Conceptos básicos de la API TCP Tesira

El Tesira Text Protocol funciona como un protocolo simple de comandos/respuestas ASCII sobre TCP en el puerto 8082. Los comandos siguen el formato: OBJECT_NAME COMMAND [param1] [param2]. El servidor (Tesira) responde +OK {"value":"..."} en caso de éxito o -ERR en caso de fallo.

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}

Nombres de objetos: Los nombres de objetos MIXER, los nombres de presets y los índices de entrada/salida se definen en Tesira Software y deben coincidir exactamente (con distinción entre mayúsculas y minúsculas) en los comandos TCP. Exporte el diseño Tesira para verificar todos los nombres de objetos antes de escribir el código middleware. Error frecuente: los espacios en los nombres de objetos deben ir entre comillas en la cadena de comandos.

Enfoque KNX a IP-Symcon a Tesira TCP

IP-Symcon es una plataforma middleware de automatización de edificios con módulos nativos de KNX y cliente TCP. Supervisa las direcciones de grupo KNX y traduce los cambios en comandos TCP Tesira — la solución más robusta para instalaciones donde IP-Symcon ya está desplegado como plataforma de visualización o lógica.

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

Enfoque de integración KNX mediante Home Assistant

Para instalaciones que utilizan Home Assistant como plataforma middleware, la integración HA KNX supervisa las direcciones de grupo y una automatización de script Python o comando de shell de HA envía el correspondiente comando TCP Tesira. Este enfoque no requiere licencias de software adicionales más allá de 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 de silencio, GA de volumen y escena de llamada de preset

El esquema de direcciones de grupo KNX para el control de Tesira sigue las mismas convenciones DPT que la integración QSC Q-SYS, permitiendo una programación coherente de los paneles táctiles KNX en diferentes plataformas DSP.

KNX GA	DPT	Comando Tesira	Notas
7/1/0 — CR1 Volumen	DPT 5.001 (0–100%)	MainMixer setLevel → dB	0%=−60dB, 100%=0dB lineal
7/1/1 — CR1 Silencio	DPT 1.001	MainMixer setMute true/false	1=silencio, 0=activo
7/1/2 — CR1 Preset	DPT 5.010 (sin signo)	DEVICE recallPreset por nombre	0=Standby, 1=Conf., 2=Present.
7/1/3 — CR1 Estado volumen	DPT 5.001	MainMixer getLevel (polling)	Feedback: Tesira → KNX
7/1/4 — CR1 Estado silencio	DPT 1.001	MainMixer getMute (polling)	Feedback: Tesira → KNX

Escena combinada de sala de conferencias con iluminación

Un único GA de escena KNX activa tanto la configuración de audio Tesira como el ajuste de iluminación DALI — creando una experiencia unificada de sala de reuniones con la pulsación de un solo botón o un evento de ocupación.

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

Prueba de puesta en marcha

Pruebe el enlace TCP Tesira utilizando un terminal TCP sin procesar (PuTTY en modo Raw) antes de configurar el middleware, para verificar que Tesira responde correctamente a los comandos. A continuación, pruebe el recorrido completo desde el KNX Group Monitor a través del middleware hasta 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

Guías relacionadas

Sistemas AV

Plugin QSC Q-SYS KNX: llamada de presets en sala de conferencias y control de volumen KNX

Sistemas AV

Control de matriz HDMI y pantallas con KNX: conmutación RS-232 y escenas AV

Solutions

Technologies

Knowledge

Company