Biamp Tesira · TCP API · KNX Middleware · Contrôle DSP · Salle de conférence · 10 min de lecture

Intégration Biamp Tesira KNX : contrôle API TCP, GA de sourdine et automatisation de scène de conférence

Biamp Tesira ne dispose pas de plugin KNX natif — contrairement à QSC Q-SYS — mais son API TCP ouverte (Tesira Text Protocol sur le port 8082) permet à toute plateforme middleware d'envoyer des commandes ASCII pour le rappel de préréglages, le contrôle du niveau et la mise en sourdine. L'intégration KNX utilise une couche middleware qui traduit les écritures d'adresses de groupe KNX en commandes TCP Tesira.

Bases de l'API TCP Tesira

Le Tesira Text Protocol fonctionne comme un simple protocole de commandes/réponses ASCII sur TCP sur le port 8082. Les commandes suivent le format : OBJECT_NAME COMMAND [param1] [param2]. Le serveur (Tesira) répond +OK {"value":"..."} en cas de succès ou -ERR en cas d'échec.

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}

Noms d'objets : Les noms d'objets MIXER, les noms de préréglages et les indices d'entrée/sortie sont définis dans Tesira Software et doivent correspondre exactement (sensible à la casse) dans les commandes TCP. Exportez la conception Tesira pour vérifier tous les noms d'objets avant d'écrire le code middleware. Erreur courante : les espaces dans les noms d'objets doivent être placés entre guillemets dans la chaîne de commande.

Approche KNX vers IP-Symcon vers Tesira TCP

IP-Symcon est une plateforme middleware d'automatisation du bâtiment avec des modules natifs KNX et client TCP. Elle surveille les adresses de groupe KNX et traduit les changements en commandes TCP Tesira — la solution la plus robuste pour les installations où IP-Symcon est déjà déployé comme plateforme de visualisation ou de logique.

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

Approche intégration KNX via Home Assistant

Pour les sites utilisant Home Assistant comme plateforme middleware, l'intégration HA KNX surveille les adresses de groupe et une automation de script Python ou de commande shell HA envoie la commande TCP Tesira correspondante. Cette approche ne nécessite aucune licence logicielle supplémentaire au-delà 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 sourdine, GA de volume et scène de rappel de préréglage

Le schéma d'adresses de groupe KNX pour le contrôle Tesira suit les mêmes conventions DPT que l'intégration QSC Q-SYS, permettant une programmation cohérente des panneaux tactiles KNX sur différentes plateformes DSP.

KNX GA	DPT	Commande Tesira	Notes
7/1/0 — CR1 Volume	DPT 5.001 (0–100%)	MainMixer setLevel → dB	0%=−60dB, 100%=0dB linéaire
7/1/1 — CR1 Sourdine	DPT 1.001	MainMixer setMute true/false	1=sourdine, 0=non sourdine
7/1/2 — CR1 Préréglage	DPT 5.010 (non signé)	DEVICE recallPreset par nom	0=Standby, 1=Conf., 2=Présent.
7/1/3 — CR1 Statut volume	DPT 5.001	MainMixer getLevel (interrogé)	Retour : Tesira → KNX
7/1/4 — CR1 Statut sourdine	DPT 1.001	MainMixer getMute (interrogé)	Retour : Tesira → KNX

Scène combinée de salle de conférence avec éclairage

Un seul GA de scène KNX déclenche à la fois la configuration audio Tesira et l'ajustement de l'éclairage DALI — créant une expérience unifiée de salle de réunion en appuyant sur un seul bouton ou lors d'un événement d'occupation.

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 de mise en service

Testez le lien TCP Tesira à l'aide d'un terminal TCP brut (PuTTY en mode Raw) avant de configurer le middleware, pour vérifier que Tesira répond correctement aux commandes. Testez ensuite le parcours complet du KNX Group Monitor via le middleware jusqu'à 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

Guides associés

Systèmes AV

Plugin QSC Q-SYS KNX : rappel de préréglages en salle de conférence et contrôle du volume KNX

Systèmes AV

Contrôle de matrice HDMI et d'affichage avec KNX : commutation RS-232 et scènes AV

Solutions

Technologies

Knowledge

Company