Biamp Tesira · TCP API · KNX starpprogrammatūra · DSP vadība · Konferences telpa · 10 min lasīšanai

Biamp Tesira KNX integrācija: TCP API vadība, izslēgšanas GA un konferences ainas automatizācija

Biamp Tesira nav iebūvēta KNX atbalsta, bet tā atvērtais TCP API (Tesira ASCII protokols uz porta 8082) ļauj ar starpprogrammatūru sūtīt komandas iestatījumu atsaukšanai, līmeņa vadībai un izslēgšanai. KNX integrācijai izmanto starpslāni, kas pārveido KNX grupas adrešu rakstīšanu Tesira TCP komandās – ideāli Latvijas konferenču telpām.

Tesira TCP API pamati

Tesira teksta protokols darbojas kā vienkāršs ASCII komandu/atbilžu protokols pa TCP uz porta 8082. Komandas seko formātam: OBJEKTA_NOSAUKUMS KOMANDA [param1] [param2]. Serveris (Tesira) atbild ar +OK {"value":"..."} veiksmes gadījumā vai -ERR kļūmes gadījumā.

Būtiskas Tesira TCP komandas

Savienojums:
 Hosts: <Tesira SERVER-IO IP adrese>
 Ports: 8082
 Protokols: TCP, keep-alive
 Autentifikācija: SESSION login admin <parole>

Iestatījumu atsaukšana:
 DEVICE recallPreset <iestatījuma_nosaukums>
 Piemērs: DEVICE recallPreset "Conference Mode"
 Piemērs: DEVICE recallPreset "Presentation Mode"
 Piemērs: DEVICE recallPreset "Standby"

Līmeņa vadība (MIXER objekts):
 <MikseraNosaukums> setLevel <ievades_indekss> <izvades_indekss> <līmenis_dB>
 Piemērs: MainMixer setLevel 1 1 -10.0
 (Ievade 1, Izvade 1, −10 dBFS)

 Līmeņa diapazons: parasti −60.0 līdz +12.0 dB
 KNX DPT 5.001 (0–100%) Tesira dB:
 0% −60 dB (klusums), 100% 0 dB (vienība)
 Lineārā kartēšana: level_dB = (vērtība% / 100) × 60 − 60

Izslēgšanas vadība:
 <MikseraNosaukums> setMute <ievades_indekss> <izvades_indekss> <true|false>
 Piemērs: MainMixer setMute 1 1 true (izslēgt)
 Piemērs: MainMixer setMute 1 1 false (ieslēgt)

Pašreizējā līmeņa iegūšana (divvirzienu atgriezeniskajai saitei):
 <MikseraNosaukums> getLevel <ievades_indekss> <izvades_indekss>
 Atbilde: +OK {"value": -10.0}

Objektu nosaukumi: MIXER objektu nosaukumi, iestatījumu nosaukumi un ievades/izvades indeksi ir definēti Tesira programmatūrā, un tiem precīzi jāsakrīt (reģistrjutīgi) TCP komandās. Pirms starpprogrammatūras koda rakstīšanas eksportējiet Tesira dizainu, lai pārbaudītu visus objektu nosaukumus. Bieža kļūda: atstarpes objektu nosaukumos ir jāiekļauj pēdiņās komandu virknē.

KNX uz IP-Symcon uz Tesira TCP pieeja

IP-Symcon ir ēku automatizācijas starpprogrammatūras platforma ar vietējiem KNX un TCP klientu moduļiem. Tā uzrauga KNX grupas adreses un pārvērš izmaiņas Tesira TCP komandās – visstabilākais ceļš instalācijām, kur IP-Symcon jau ir izvietots kā vizualizācijas vai loģikas platforma.

IP-Symcon Tesira integrācija (skripta fragments)

// IP-Symcon PHP skripts, ko aktivizē KNX GA maiņas notikums

// Izsaukts, kad mainās GA 7/1/1 (Tesira izslēgšana)
function TesiraMute($mute_value) {
 $socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
 socket_connect($socket, "192.168.1.150", 8082);

 // Pieslēgšanās
 socket_write($socket, "SESSION login admin Password123\n");
 $response = socket_read($socket, 256); // sagaida +OK

 // Nosūtīt izslēgšanas komandu
 $cmd = $mute_value ? "true" : "false";
 socket_write($socket, "MainMixer setMute 1 1 $cmd\n");
 $response = socket_read($socket, 256); // sagaida +OK

 socket_close($socket);
}

// KNX GA trigeri:
// GA 7/1/0 (DPT 5.001 skaļums) TesiraSetLevel()
// GA 7/1/1 (DPT 1.001 izslēgšana) TesiraMute()
// GA 7/1/2 (DPT 5.010 iestatījums) TesiraPresetRecall()
// vērtība 0 = Standby, 1 = Conference, 2 = Presentation

Home Assistant KNX integrācijas pieeja

Vietnēm, kurās kā starpprogrammatūras platforma tiek izmantots Home Assistant, HA KNX integrācija uzrauga grupas adreses, un HA Python skripts vai čaulas komandas automatizācija nosūta atbilstošo Tesira TCP komandu. Šī pieeja neprasa papildu programmatūras licenci ārpus HA.

Home Assistant automations.yaml Tesira izslēgšanai

# KNX izslēgšanas GA Tesira TCP komanda
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 konfigurācija (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

# Iestatījumu atsaukšanai – izmantot skaitļa entītiju, ko aktivizē KNX:
 number:
 - name: "knx_cr1_preset"
 address: "7/1/2"
 min: 0
 max: 5
 step: 1

Izslēgšanas GA, skaļuma GA un iestatījumu atsaukšanas aina

KNX grupas adrešu shēma Tesira vadībai seko tām pašām DPT konvencijām kā QSC Q-SYS integrācija, nodrošinot konsekventu KNX skārienpanela programmēšanu dažādās DSP platformās.

KNX GA	DPT	Tesira komanda	Piezīmes
7/1/0 – CR1 Skaļums	DPT 5.001 (0–100%)	MainMixer setLevel dB	0%=−60dB, 100%=0dB lineāri
7/1/1 – CR1 Izslēgšana	DPT 1.001	MainMixer setMute true/false	1=izslēgt, 0=ieslēgt
7/1/2 – CR1 Iestatījums	DPT 5.010 (bez zīmes)	DEVICE recallPreset pēc nosaukuma	0=Standby, 1=Conf, 2=Present
7/1/3 – CR1 Skaļuma statuss	DPT 5.001	MainMixer getLevel (aptaujāts)	Atgriezeniskā saite: Tesira KNX
7/1/4 – CR1 Izslēgšanas statuss	DPT 1.001	MainMixer getMute (aptaujāts)	Atgriezeniskā saite: Tesira KNX

Konferences telpas kombinētā aina ar apgaismojumu

Viena KNX ainas GA aktivizē gan Tesira audio konfigurāciju, gan DALI apgaismojuma regulēšanu – radot vienotu sanāksmju telpas ainas pieredzi no vienas pogas nospiešanas vai klātbūtnes notikuma.

Konferences telpas kombinētā aina (KNX ainas GA Tesira + DALI)

KNX ainas GA 7/0/0 (DPT 18.001 kombinētā telpas aina):

Aina 1 – "Conference" (vērtība 0):
 Tesira: DEVICE recallPreset "Conference Mode"
 Maršrutēšana: visi mikrofoni aktīvi, kodeks iespējots
 Pastiprinājums: konferencei optimizēts, AEC iespējots
 Ieslēgt: MainMixer setMute 1 1 false
 DALI: atsaukt ainu 3 (60%, 4000K, perimetrs 30%)
 Displejs: ieslēgt (KNX binārā izeja RS-232 barošanas komanda)

Aina 2 – "Presentation" (vērtība 1):
 Tesira: DEVICE recallPreset "Presentation Mode"
 Maršrutēšana: klēpjdatora audio ieeja uz skaļruņiem
 Pastiprinājums: prezentācijai optimizēts (augstāks izejas līmenis)
 DALI: atsaukt ainu 4 (40%, 3000K – samazināts projektoram)
 HDMI: pārslēgt ieeju 2 (klēpjdators) uz izeju 1 (projektors)

Aina 0 – "Standby" (vērtība 63 saskaņā ar DPT 18.001 konvenciju):
 Tesira: DEVICE recallPreset "Standby"
 Visas ieejas izslēgtas, līmenis −60 dB
 DALI: atsaukt ainu 0 (viss izslēgts)
 Displejs: izslēgt (RS-232 izslēgšanas komanda)

IP-Symcon/HA: uzrauga GA 7/0/0 nosūta atbilstošo Tesira iestatījumu
 + raksta DALI ainu un displeja GA vienlaicīgi

Nodošanas ekspluatācijā tests

Pirms starpprogrammatūras konfigurēšanas pārbaudiet Tesira TCP savienojumu, izmantojot neapstrādātu TCP termināli (PuTTY neapstrādātā režīmā), lai pārliecinātos, ka Tesira pareizi atbild uz komandām. Pēc tam pārbaudiet no gala līdz galam no KNX grupu monitora caur starpprogrammatūru līdz Tesira.

Tesira TCP nodošanas ekspluatācijā tests

1. solis: Neapstrādāts TCP tests (PuTTY):
 Hosts: <Tesira IP>, Ports: 8082, Savienojuma veids: Raw
 Ierakstiet: SESSION login admin <parole>
 Atbilde: +OK
 Ierakstiet: DEVICE recallPreset "Standby"
 Atbilde: +OK (iestatījuma atsaukšanai netiek atgriezta vērtība)
 Ierakstiet: MainMixer setMute 1 1 true
 Atbilde: +OK
 Ierakstiet: MainMixer getMute 1 1
 Atbilde: +OK {"value": true}

2. solis: Starpprogrammatūras tests (IP-Symcon/HA):
 Ierakstiet 1 uz GA 7/1/1 (KNX izslēgšana), izmantojot ETS6 grupu monitoru
 Pārbaudiet starpprogrammatūras žurnālu: Tesira komanda nosūtīta
 PuTTY sesija: MainMixer getMute jāatgriež true

3. solis: Skaļuma atgriezeniskās saites tests:
 PuTTY: MainMixer setLevel 1 1 -20.0
 Starpprogrammatūrai jāatklāj līmeņa izmaiņas (ja aptauja ir aktīva)
 ETS6 grupu monitors: GA 7/1/3 (skaļuma statuss) jāatjaunina

4. solis: Kombinētās ainas tests:
 Ierakstiet 0 uz GA 7/0/0 Aina 1 (Conference)
 Pārbaudiet, vai Tesira iestatījums ir atsaukts (pārbaudiet Tesira programmatūras monitoru)
 Pārbaudiet, vai DALI aina 3 aktivizējas (redzamas apgaismojuma izmaiņas)
 Pārbaudiet, vai displejs ieslēdzas

Saistītie ceļveži

AV sistēmas

QSC Q-SYS KNX spraudnis: Konferences telpas iestatījumu atsaukšana un KNX skaļuma vadība