Beispiele für Systemintegrationen

BSS / Harman HiQnet

Wir haben zwei praktikable Optionen, abhängig davon, mit welchen Geräten Sie kommunizieren möchten:

1) Soundweb London (BLU-80/BLU-160/BLU-100/BLU-3xx, etc.)

Verwenden Sie London Direct Inject (DI) über TCP. Dies ist der vorgesehene Weg für die Steuerung durch Drittanbieter und deutlich einfacher als die direkte Verwendung von HiQnet.

• Transport/Ports: TCP 1023 für die DI-Steuerung; Telnet auf Port 23 (praktisch für Tests). HiQnet-Erkennung und -Steuerung verwenden ebenfalls TCP/UDP-Port 3804 (für DI wird dieser jedoch nicht benötigt).
• Dokumentation: „Soundweb London Drittanbieter-Steuerung / London DI Kit“ erläutert die Nachrichtenstruktur und enthält Beispiele.
• Schnelle Prüfmöglichkeit: Telnet-Anmeldung mit bssaudio / monkey; der Befehl help zeigt die verfügbaren Befehle an.

So verbinden Sie dMix mit Soundweb (empfohlen)

1. Abonniert Ihre dMix-Ereignisse (z. B. a.N.mix, a.N.mute).
2. Öffnet eine TCP-Verbindung zum Soundweb-System über Port 1023.
3. Übersetzt jedes Ereignis in die entsprechende DI-Nachricht für den jeweiligen Parameter (Pegel/Stummschaltung), unter Verwendung der Objekt- und Parameter-IDs aus Ihrem Audio-Architect-Projekt.

Tipp: Notieren Sie sich in Audio Architect die Objektinstanz- und Steuerungs-IDs der Zielblöcke (Pegel, Stummschaltung, Router-Kreuzpunkte). Diese IDs werden direkt den DI-Nutzdaten zugeordnet, die Sie senden. Der Harman DI-Leitfaden enthält die genauen Byte-Strukturen und Beispiele.

2. Allgemeines HiQnet (über Soundweb hinaus: Crown-Endstufen, JBL-Prozessoren usw.)

Sie können HiQnet direkt über Port 3804 (TCP/UDP) verwenden. Dies ist komplexer, wird jedoch offiziell dokumentiert.

• Dokumentation: „HiQnet Third-Party Programmer Documentation“ (behandelt Nachrichtenformate, Übertragungsprotokolle, Befehlstypen sowie Open-Loop- und Closed-Loop-Steuerung). HiQnet Audio Architect
• Ports/Firewall: Stellen Sie sicher, dass TCP/UDP-Port 3804 freigegeben ist (bei einigen Geräten zusätzlich FTP während Firmware-Updates).
• Wann verwenden: Wenn Sie Nicht-Soundweb-HiQnet-Geräte (z. B. Crown-Endstufen) direkt von dMix aus steuern möchten, ohne Audio Architect zu verwenden.

Welche Lösung sollten Sie wählen?

• Steuerung von Soundweb London: Verwenden Sie London DI über TCP-Port 1023. Dies ist eine unkomplizierte und offiziell unterstützte Methode für die Steuerung durch Drittanbieter.
• Steuerung anderer HiQnet-Geräte: Implementieren Sie HiQnet über Port 3804 gemäß dem Programmierhandbuch. Rechnen Sie dabei mit einem höheren Aufwand für Nachrichtenstrukturierung und Zustandsverwaltung.

Minimales Bridge-Konzept (Übersicht)

• Eingabe: dMix WebSocket-JSON (z. B. {"cmd":"set","key":"a.0.mix","value":0.73})
• Ausgabe: DI-Datenpaket an das Soundweb-Pegelobjekt für Kanal 1.
• Geräteerkennung: Nicht erforderlich; die IP-Adresse des BLU-Geräts ist bereits bekannt.
• Rückmeldung: Optional können Messwerte oder Parameter über DI abgefragt bzw. abonniert und anschließend als {"evt":"update", ...} an dMix zurückgesendet werden.

(Die genauen DI-Datenbytes hängen von den Objekt- und Steuerungs-IDs Ihres Projekts ab. Diese können Sie in Audio Architect ermitteln; Beispiele finden Sie im DI-Kit-PDF.)

Netzwerk-Checkliste

• Öffnen Sie 1023/TCP für jedes Soundweb-System zur DI-Steuerung; 23/TCP ist optional für Tests per Telnet.
• Wenn Sie zusätzlich die HiQnet-Geräteerkennung oder -Steuerung verwenden, öffnen Sie TCP/UDP-Port 3804 (sowie TCP-Port 21 und die Ports 49152–50152 für Firmware-Updates bzw. FTP).

Download:

Download: dmix_hiqnet_bridge_v1.zip

(Enthält main.go, config.example.json und eine README-Datei.)

Funktionsumfang

• Abonniert den dMix-WebSocket (evt:"update"-Nachrichten wie {"key":"a.0.mix","value":0.73}).
• Für jeden zugeordneten Schlüssel erstellt die Anwendung ein DI-/HiQnet-Datenpaket auf Basis einer Hex-Vorlage und sendet dieses per TCP an Ihr BSS-Gerät.
• Stellt die Verbindung sowohl zum dMix-WebSocket als auch zur BSS-TCP-Sitzung bei Bedarf automatisch wieder her.

Konfiguration (IP-Adresse kann allgemein gehalten oder später festgelegt werden)

• Legen Sie in der Datei config.example.json folgende Einstellungen fest:
• dmix_ws_url: e.g. ws://dmix.local:8080/ws
• bss_host: leave "127.0.0.1" for now; swap to your BLU device later
• bss_port: 1023 (typical for London DI; change if you target raw HiQnet)
• mappings: map dMix keys → frame templates (hex + tokens)

Unterstützte Vorlagenplatzhalter:

• {VAL_F32_LE}{} → float32 little-endian
• {{VAL_U8}} → 0–255 byte
• {{VAL_I16_BE}}, {{VAL_I16_LE}} → 16-bit signed

Optionale lineare Skalierung pro Zuordnung:

"scale": {
  "mode": "linear",
  "in_min": 0.0, "in_max": 1.0,
  "out_min": -80.0, "out_max": 10.0
}

Beispiel für eine Zuordnung (Header und IDs werden entsprechend Ihrem Projekt angepasst)

{
  "key": "a.0.mix",
  "frame_template": "AA 55 12 34 56 {{VAL_F32_LE}} CC",
  "scale": {"mode":"linear","in_min":0.0,"in_max":1.0,"out_min":-80.0,"out_max":10.0}
},
{
  "key": "a.0.mute",
  "frame_template": "AA 55 12 34 57 {{VAL_U8}} CC"
}

The AA 55 ... CC bytes are placeholders—fill them using the London DI or HiQnet docs for your object/parameter.

Erstellen und Ausführen

cd dmix_hiqnet_bridge_v1
go build -o bridge main.go
./bridge -config ./config.example.json

Auf Wunsch kann ich außerdem Folgendes bereitstellen:

• Einen DI-Prüfsummen-Platzhalter (Checksum Helper), falls Ihr Datenpaket eine Prüfsumme erfordert.
• Einen BSS→dMix-Abfragepfad für die bidirektionale Synchronisation (Parameter auslesen und als evt:"update" an dMix zurücksenden).
• Eine vorkonfigurierte Konfigurationsdatei, wenn Sie die Objekt- und Parameter-IDs der gewünschten Pegel- und Stummschaltungsblöcke bereitstellen.

Hier finden Sie eine Übersicht der gängigsten Installations-Audio-Systeme und der Möglichkeiten, wie dMix mit ihnen kommunizieren kann: