LIGHTWARE Smart IP-Treiber

Technische Daten
- Produkt: Genelec Smart IP-Treiber für LARA
- Kompatibilität: Genelec Smart IP-Lautsprecher
- Kommunikationsprotokoll: REST-Stil mit einem reduzierten Satz von HTTP/1.1
- Mindestausrüstungsanforderungen:
- Lightware UCX-Serie Universal Matrix Switcher (FW: v2.12.0b3) oder UCX-BD-Serie Universal Matrix Switcher (FW: v2.14.0b3) mit integriertem DSP
- Smart-IP-Gerät (z. B. Genelec 4410-Lautsprecher FW: 44×0-1.4.0)
- Ethernet-Netzwerk-Switch
- Kabel
Anweisungen zur Produktverwendung
Installation
Um den Genelec Smart IP-Treiber für LARA zu installieren, gehen Sie folgendermaßen vor:
- Stellen Sie sicher, dass Sie über die Mindestausrüstungsanforderungen verfügen.
- Verbinden Sie den Universal Matrix Switcher der Lightware UCX-Serie über Kabel mit dem Smart IP-Gerät und dem Ethernet-Netzwerk-Switch.
Konfiguration
LARA starten, Konfiguration hochladen
Um das System zu konfigurieren, gehen Sie folgendermaßen vor:
- Öffnen Sie ein neues Browserfenster und geben Sie ein: https://192.168.1.88/lara, wobei die IP-Adresse Ihres Matrixgeräts der UCX-Serie ist.
- Wählen Sie: KONFIGURATION HOCHLADEN.
Ausführliche Konfigurationsinformationen finden Sie im Kapitel „Lightware Advanced Room Automation (LARA)“ im Benutzerhandbuch unter: Bedienungsanleitung.
Einführung
Das Smart IP LARA-Modul dient zur Steuerung von Genelec Smart IP-Lautsprechern über REST-Kommunikation mit einem reduzierten Satz von HTTP/1.1-Protokollen. Die Smart IP API-Dokumentation kann hier heruntergeladen werden: https://www.genelec.com/smart-ip-api
Installation und Konfiguration
Installation
Mindestausstattungsanforderung für die Lösung:
- Universal-Matrix-Switcher der Lightware UCX-Serie (FW: v2.12.0b3)
- oder Universal Matrix Switcher der UCX-BD-Serie (FW: v2.14.0b3) mit integriertem DSP
- Smart IP-Gerät, in diesem Beispielamplinks: Genelec 4410 Lautsprecher (FW: 44×0-1.4.0)
- Ethernet-Netzwerk-Switch
- Kabel
Bevor Sie beginnen, richten Sie den aktiven Lautsprecher von Genelec mit Smart IP Manager als Audiogerät ein.
Weitere Informationen finden Sie hier: https://www.genelec.com/smart-ip-manager
Bevor Sie ein LARA-Modul oder eine LARA-Konfiguration hochladen, laden Sie bitte die neueste Firmware von https://lightware.com/. Aktualisieren Sie Ihren Universal Matrix Switcher der UCX-Serie und aktivieren Sie LARA.
Weitere Informationen finden Sie in den Benutzerhandbüchern:
- https://lightware.com/pub/media/lightware/filedownloader/file/User-Manual/Taurus_UCX_series_Users_Manual.pdf
- https://lightware.com/lara/
- https://lightware.com/pub/media/lightware/filedownloader/file/User-Manual/LARA_Users_Manual.pdf
Konfiguration
LARA starten, Konfiguration hochladen
Öffnen Sie ein neues Browserfenster und geben Sie ein: https://192.168.1.88/lara, wobei die IP-Adresse lautet: Matrixgerät der UCX-Serie
Wählen: KONFIGURATION HOCHLADEN

Ausführliche Informationen finden Sie in Kapitel 5.7. Lightware Advanced Room Automation (LARA) in diesem Dokument: https://lightware.com/pub/media/lightware/filedownloader/file/User-Manual/Taurus_UCX_series_Users_Manual.pdf
Dashboard-Inhalt und definierte Parameter
Dashboard-Inhalt
Die folgende Statusanzeige wird auf der Statustafel in der Zeile der Instanz angezeigt:
- Verbindungsstatus des Geräts
- Produktdaten (Gerätetyp, FW-Version)
- Einschaltstatus, Stummschaltungsstatus, Lautstärkepegel, Zoneninformationen, Geräteinformationen

Definierte Parameter
- ipAddressOrHost: Die IP-Adresse oder der Hostname des Genelec Smart IP-Geräts, im Folgenden Lautsprecher in diesem Beispielample
- Benutzername: im Smart IP Manager definiert
- Passwort: im Smart IP Manager definiert
- Es können Min.-/Max.-Lautstärkepegel definiert werden. Diese werden zur späteren Verwendung im Logikmodul in Statusvariablen umgewandelt.
- Protokollnachrichten können im Protokollbereich der LARA-GUI aktiviert werden.

Definierte Ereignisse
Herzschlagperiode:
- Dieses Ereignis wird alle 5000 ms ausgelöst. Das bedeutet, dass die Dashboard-Informationen alle fünf Sekunden aktualisiert werden.
Lautsprecherfehler:
- Dieses Ereignis wird im Falle eines Verbindungsverlusts zwischen UCX und dem Genelec-Lautsprecher ausgegeben.
Fehler:
- zB Problem bei der Datenübertragung, zB falsch gesetzter Frame-Delimiter. In diesem Ereignis ist der Parameter `errormessage` für den Fehlercode definiert.
Antwort erhalten:
- In diesem Ereignis wird der empfangene String-Parameter `string` definiert. Er kann verwendet werden, um den Inhalt der vom Gerät empfangenen Antwort zu analysieren.
Definierte Statusvariablen:
- maxVolume
- minVolumen
- LautsprecherKommunikationStabil
- IdentifizierungAktiv
- profileListe
- Netzwerkdaten
- Messdaten
- audioInputData
- danteIPData
- danteIdentität
- versionString
- Stummschaltung
- Volumenwert
- Energiezustand
Der Inhalt dieser Statusvariablen basiert auf der Beschreibung der Genelec Smart IP API-Schnittstelle. Bitte beachten Sie dieses API-Handbuch. Dort finden Sie einige Beispiele.ampDateien im nächsten Kapitel.
Definierte Methoden
setzen, posten, erhalten, löschen
- Gängige REST-API-Methoden
Herzschlag
- Fragt regelmäßig Daten für das Dashboard von LARA vom Lautsprecher ab.
Stummschalten
- Legt den Stummschaltzustand des Lautsprechers fest. Bei „true“ ist der Lautsprecher stummgeschaltet, bei „false“ ist die Stummschaltung aufgehoben.
setVolume
- Legt die Lautstärke des Lautsprechers über den Parameter „level“ fest, der in diesem Bereich liegen kann: -133 .. 0 dB
setPowerSate
- Legt den Betriebszustand des Lautsprechers fest. Bei „ACTIVE“ ist das Gerät eingeschaltet, bei „STANDBY“ befindet es sich im Standby-Modus.
getDeviceInfo
Ruft die folgenden Geräteinformationen ab:

getAoIPIdent
Ruft die AV-over-IP-Informationen (Dante) ab:

getAoIPData
- Ruft die AV-over-IP-Netzwerkparameter (Dante) ab:
- Dante-Informationen: { IP: '192.168.5.70', Maske: '255.255.252.0', GW: '192.168.7.254'}
Messdaten abrufen
Ruft die gemessenen Parameter vom Lautsprecher ab.

Werde professoinellfileListe
- Ruft eine Liste der Profis abfiles im Lautsprecher gespeichert
- Profile Liste: { ausgewählt: 0, Start: 0, Liste: [] }
setProfileID
- Restore Profile von Flash und legen Sie es als aktives Profile.
getNetworkConfig
Ruft die Netzwerkkonfiguration ab.

getAudioInputData
- Ruft die Liste der ausgewählten Eingaben ab.
- Audio-Eingangsinformationen: { input: [ 'A', 'AoIP01', 'AoIP02' ] }
Identifikation
- Identifizieren Sie den Lautsprecher durch blinkende Front-LED
setLEDIntensity
- Stellt die Helligkeit der Front-LED des Lautsprechers ein
Definierte Regeln im Testlogikmodul
Im TEST-Logikmodul sind zwei Arten von Regeln definiert.
Um das System zu testen, suchen Sie bitte im Abschnitt „Systemsteuerung“ nach der Schaltfläche mit dem QR-Code-Link:

Nach dem Drücken dieser Taste öffnet sich ein neues Browserfenster mit einer einfachen Menüleiste. In dieser Menüleiste öffnet sich das Untermenü „Lautsprechersteuerung“ mit dem Bedienfeld:

Regeln zum Einstellen der Parameter des Lautsprechers:
- setVolume,
- Einschalten,
- Bereithalten,
- Lautsprecher Stumm gedrückt,
- profile Taste gedrückt
Diese Regeln werden durch Ereignisse ausgelöst, die vom Bedienfeld ausgegeben werden (Tastendruck, Schiebereglerbewegung).


Regeln zum Abrufen von Daten vom Lautsprecher
- Regeln werden durch Änderungen der entsprechenden Statusvariablen des Lautsprechermoduls ausgelöst und geben beispielsweise Feedback zum Ändern des Lautstärkewerts für den Lautsprecher.
- Die in diesen Regeln ausgeführten Aktionen sind sehr einfach. Sie protokollieren lediglich den Inhalt der angegebenen Statusvariable, wenn die Protokollierung im Parameterabschnitt aktiviert ist.
| Rev. | Veröffentlichungsdatum | Änderungen | Editor |
| Version 1.0.0 | 02-07-2028 | Erste Version | Péter Szabó 3 |
| Version 1.1.0 | 22-08-2024 | setLedIntensity, min./max. Lautstärke, integrierte DSP-Steuerung der UCX-BD-Serie hinzugefügt | Péter Szabó 3 |
Häufig gestellte Fragen
Was sind die definierten Parameter für den Genelec Smart IP-Treiber für LARA?
Zu den definierten Parametern gehören:
- ipAddressOrHost: Die IP-Adresse oder der Hostname des Genelec Smart IP-Geräts.
- Benutzername: Im Smart IP Manager definiert.
- Passwort: Im Smart IP Manager definiert.
- Der minimale/maximale Lautstärkepegel kann definiert und zur späteren Verwendung in Statusvariablen umgewandelt werden.
- Protokollnachrichten können im Protokollbereich der LARA-GUI aktiviert werden.
Was sind die definierten Ereignisse für den Genelec Smart IP-Treiber für LARA?
Zu den definierten Ereignissen gehören:
- Heartbeat_period: Aktualisiert die Dashboard-Informationen alle fünf Sekunden.
- Speakererror: Wird im Falle eines Verbindungsverlusts zwischen UCX und dem Genelec-Lautsprecher ausgegeben.
- Fehler: Zeigt Probleme bei der Datenübertragung an. Im Ereignis wird ein Fehlercode bereitgestellt.
- ResponseReceived: Stellt die empfangene Zeichenfolge zur Analyse der Antwort vom Gerät bereit.
Dokumente / Ressourcen
![]() |
LIGHTWARE Smart IP-Treiber [pdf] Bedienungsanleitung Smart IP-Treiber, IP-Treiber, Treiber |

