Biamp Tesira · TCP API · KNX Middleware · DSP-Steuerung · Konferenzraum · 10 Min. Lesezeit

Biamp Tesira KNX-Integration: TCP-API-Steuerung, Stummschalt-GAs und Konferenzszenen-Automation

Biamp Tesira verfügt — im Gegensatz zu QSC Q-SYS — über kein natives KNX-Plugin, jedoch ermöglicht die offene TCP-API (Tesira Text Protocol auf Port 8082) jeder Middleware-Plattform, ASCII-Befehle für Preset-Abruf, Pegelsteuerung und Stummschaltung zu senden. Die KNX-Integration erfolgt über eine Middleware-Schicht, die KNX-Gruppenadressschreibvorgänge in Tesira-TCP-Befehle überbrückt.

Grundlagen der Tesira TCP API

Das Tesira Text Protocol arbeitet als einfaches ASCII-Befehls-/Antwortprotokoll über TCP auf Port 8082. Befehle folgen dem Format: OBJECT_NAME COMMAND [param1] [param2]. Der Server (Tesira) antwortet bei Erfolg mit +OK {"value":"..."} oder bei Fehler mit -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}

Objektnamen: MIXER-Objektnamen, Preset-Namen und Ein-/Ausgangsindizes werden in der Tesira Software definiert und müssen in TCP-Befehlen exakt übereinstimmen (Groß-/Kleinschreibung beachten). Exportieren Sie das Tesira-Design zur Überprüfung aller Objektnamen, bevor Sie Middleware-Code schreiben. Häufiger Fehler: Leerzeichen in Objektnamen müssen im Befehlsstring in Anführungszeichen gesetzt werden.

KNX zu IP-Symcon zu Tesira TCP — Ansatz

IP-Symcon ist eine Gebäudeautomations-Middleware-Plattform mit nativen KNX- und TCP-Client-Modulen. Sie überwacht KNX-Gruppenadressen und übersetzt Änderungen in Tesira-TCP-Befehle — der robusteste Weg für Installationen, bei denen IP-Symcon bereits als Visualisierungs- oder Logikplattform eingesetzt wird.

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

Home Assistant KNX-Integration — Ansatz

Für Anlagen, die Home Assistant als Middleware-Plattform verwenden, überwacht die HA KNX-Integration die Gruppenadressen, und ein HA-Python-Skript oder eine Shell-Command-Automation sendet den entsprechenden Tesira-TCP-Befehl. Dieser Ansatz erfordert keine zusätzliche Softwarelizenz über HA hinaus.

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

Stummschalt-GA, Lautstärke-GA und Preset-Abruf-Szene

Das KNX-Gruppenadressschema für die Tesira-Steuerung folgt denselben DPT-Konventionen wie die QSC Q-SYS-Integration und ermöglicht eine konsistente KNX-Touchpanel-Programmierung über verschiedene DSP-Plattformen hinweg.

KNX GA	DPT	Tesira-Befehl	Hinweise
7/1/0 — CR1 Lautstärke	DPT 5.001 (0–100%)	MainMixer setLevel → dB	0%=−60dB, 100%=0dB linear
7/1/1 — CR1 Stummschaltung	DPT 1.001	MainMixer setMute true/false	1=stumm, 0=nicht stumm
7/1/2 — CR1 Preset	DPT 5.010 (vorzeichenlos)	DEVICE recallPreset nach Name	0=Standby, 1=Konf., 2=Präsent.
7/1/3 — CR1 Lautstärkestatus	DPT 5.001	MainMixer getLevel (gepollt)	Feedback: Tesira → KNX
7/1/4 — CR1 Stummschaltstatus	DPT 1.001	MainMixer getMute (gepollt)	Feedback: Tesira → KNX

Kombinierte Konferenzraumszene mit Beleuchtung

Eine einzige KNX-Szenen-GA löst sowohl die Tesira-Audiokonfiguration als auch die DALI-Beleuchtungsanpassung aus — und schafft so ein einheitliches Besprechungsraumerlebnis durch einen einzigen Tastendruck oder ein Belegungsereignis.

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

Inbetriebnahmetest

Testen Sie die Tesira-TCP-Verbindung mit einem Raw-TCP-Terminal (PuTTY im Raw-Modus), bevor Sie die Middleware konfigurieren, um sicherzustellen, dass Tesira korrekt auf Befehle reagiert. Testen Sie anschließend den vollständigen Pfad vom KNX Group Monitor über die Middleware bis zu 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