Biamp Tesira · TCP API · KNX Middleware · Controllo DSP · Sala conferenze · 10 min di lettura

Integrazione Biamp Tesira KNX: controllo API TCP, GA silenziamento e automazione scene conferenza

Biamp Tesira non dispone di un plugin KNX nativo — a differenza di QSC Q-SYS — ma la sua API TCP aperta (Tesira Text Protocol sulla porta 8082) consente a qualsiasi piattaforma middleware di inviare comandi ASCII per il richiamo dei preset, il controllo del livello e il silenziamento. L'integrazione KNX utilizza uno strato middleware che traduce le scritture degli indirizzi di gruppo KNX in comandi TCP Tesira.

Basi dell'API TCP Tesira

Il Tesira Text Protocol opera come un semplice protocollo di comandi/risposte ASCII su TCP sulla porta 8082. I comandi seguono il formato: OBJECT_NAME COMMAND [param1] [param2]. Il server (Tesira) risponde +OK {"value":"..."} in caso di successo o -ERR in caso di errore.

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}

Nomi degli oggetti: I nomi degli oggetti MIXER, i nomi dei preset e gli indici di ingresso/uscita sono definiti in Tesira Software e devono corrispondere esattamente (con distinzione maiuscole/minuscole) nei comandi TCP. Esportare il progetto Tesira per verificare tutti i nomi degli oggetti prima di scrivere il codice middleware. Errore comune: gli spazi nei nomi degli oggetti devono essere racchiusi tra virgolette nella stringa del comando.

Approccio KNX verso IP-Symcon verso Tesira TCP

IP-Symcon è una piattaforma middleware per l'automazione degli edifici con moduli nativi KNX e client TCP. Monitora gli indirizzi di gruppo KNX e traduce le modifiche in comandi TCP Tesira — la soluzione più robusta per installazioni in cui IP-Symcon è già distribuito come piattaforma di visualizzazione o logica.

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

Approccio integrazione KNX tramite Home Assistant

Per i siti che utilizzano Home Assistant come piattaforma middleware, l'integrazione HA KNX monitora gli indirizzi di gruppo e un'automazione con script Python o comando shell HA invia il corrispondente comando TCP Tesira. Questo approccio non richiede licenze software aggiuntive oltre a 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 silenziamento, GA volume e scena di richiamo preset

Lo schema degli indirizzi di gruppo KNX per il controllo Tesira segue le stesse convenzioni DPT dell'integrazione QSC Q-SYS, consentendo una programmazione coerente dei pannelli touch KNX su diverse piattaforme DSP.

KNX GA	DPT	Comando Tesira	Note
7/1/0 — CR1 Volume	DPT 5.001 (0–100%)	MainMixer setLevel → dB	0%=−60dB, 100%=0dB lineare
7/1/1 — CR1 Silenziamento	DPT 1.001	MainMixer setMute true/false	1=silen., 0=attivo
7/1/2 — CR1 Preset	DPT 5.010 (senza segno)	DEVICE recallPreset per nome	0=Standby, 1=Conf., 2=Present.
7/1/3 — CR1 Stato volume	DPT 5.001	MainMixer getLevel (polling)	Feedback: Tesira → KNX
7/1/4 — CR1 Stato silenziamento	DPT 1.001	MainMixer getMute (polling)	Feedback: Tesira → KNX

Scena combinata della sala conferenze con illuminazione

Un singolo GA di scena KNX attiva contemporaneamente la configurazione audio Tesira e la regolazione dell'illuminazione DALI — creando un'esperienza unificata della sala riunioni con la pressione di un singolo pulsante o un evento di occupazione.

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

Test di messa in servizio

Testare il collegamento TCP Tesira utilizzando un terminale TCP grezzo (PuTTY in modalità Raw) prima di configurare il middleware, per verificare che Tesira risponda correttamente ai comandi. Testare quindi il percorso end-to-end dal KNX Group Monitor attraverso il middleware fino a 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

Guide correlate

Sistemi AV

Plugin QSC Q-SYS KNX: richiamo preset sala conferenze e controllo volume KNX

Sistemi AV

Controllo matrice HDMI e display con KNX: commutazione RS-232 e scene AV

Solutions

Technologies

Knowledge

Company