LG Webos Steuerung

Parameter

TV IP-Adresse (Pflichtfeld)

• Beschreibung: IP-Adresse des LG TVs im lokalen Netzwerk
• Format: IPv4-Adresse, z.B. 192.168.1.100
• Hinweis: Die IP-Adresse finden Sie im TV-Menü unter Einstellungen → Netzwerk → Netzwerkstatus

MAC-Adresse

• Beschreibung: MAC-Adresse des TVs für Wake-on-LAN (Einschaltfunktion)
• Format: AA:BB:CC:DD:EE:FF oder AA-BB-CC-DD-EE-FF
• Hinweis: Erforderlich für die Einschalt-Funktion. Zu finden im TV-Menü unter Einstellungen → Netzwerk → Netzwerkstatus

WebOS Client-Schlüssel

• Beschreibung: Authentifizierungsschlüssel für die TV-Kommunikation
• Hinweis: Wird beim ersten Pairing automatisch generiert und muss hier eingetragen werden. Nach dem Eintragen bleibt der Schlüssel dauerhaft gespeichert.

Abfrageintervall (s)

• Beschreibung: Intervall in Sekunden, in dem der TV-Status automatisch abgefragt wird
• Standardwert: 30 Sekunden
• Bereich: 5 – 300 Sekunden
• Hinweis: Kürzere Intervalle erhöhen die Netzwerklast, bieten aber aktuellere Statusdaten

---

Eingänge

Pairing & Power-Management

Pairing auslösen

• Typ: Binär (Trigger)
• Funktion: Startet den Pairing-Vorgang mit dem TV
• Ablauf:
  1. Trigger auf 1 setzen
  2. Am TV erscheint Dialog “Gerät zulassen?”
  3. Dialog am TV bestätigen
  4. Client-Schlüssel erscheint im Ausgang “Pairing-Status”
  5. Client-Schlüssel in Parameter “WebOS Client-Schlüssel” kopieren

Einschalten auslösen

• Typ: Binär (Trigger)
• Funktion: Schaltet den TV über Wake-on-LAN ein
• Voraussetzung: MAC-Adresse muss im Parameter eingetragen sein
• Hinweis: TV benötigt ca. 10-30 Sekunden zum Hochfahren

Ausschalten auslösen

• Typ: Binär (Trigger)
• Funktion: Schaltet den TV aus
• Hinweis: Ausgang “Ist an” wird sofort auf false gesetzt

Audio-Steuerung

Stumm auslösen

• Typ: Binär (Trigger)
• Funktion: Schaltet den TV stumm
• Hinweis: Zum Aufheben der Stummschaltung erneut triggern

Lautstärke setzen auslösen

• Typ: Binär (Trigger)
• Funktion: Setzt die Lautstärke auf den Wert aus “Lautstärke-Wert”
• Verwendung: Erst Zielwert bei “Lautstärke-Wert” eintragen, dann triggern

Lautstärke-Wert

• Typ: Integer (0-100)
• Funktion: Zielwert für die TV-Lautstärke
• Standardwert: 50
• Hinweis: Wird mit “Lautstärke setzen auslösen” an den TV gesendet

Lauter auslösen

• Typ: Binär (Trigger)
• Funktion: Erhöht die Lautstärke um einen Schritt

Leiser auslösen

• Typ: Binär (Trigger)
• Funktion: Verringert die Lautstärke um einen Schritt

Quellen & Apps

Quelle wechseln auslösen

• Typ: Binär (Trigger)
• Funktion: Wechselt zur Quelle aus “Quellen-ID”
• Verwendung: Erst Quellen-ID eintragen, dann triggern

Quellen-ID

• Typ: Text
• Funktion: HDMI-Eingang oder andere Eingabequelle
• Beispiele:
  • HDMI_1 – HDMI 1
  • HDMI_2 – HDMI 2
  • HDMI_3 – HDMI 3
  • HDMI_4 – HDMI 4 (falls vorhanden)

App starten auslösen

• Typ: Binär (Trigger)
• Funktion: Startet die App aus “App-ID”
• Verwendung: Erst App-ID eintragen, dann triggern

App-ID

• Typ: Text
• Funktion: Eindeutige ID der zu startenden App
• Gängige Apps:
  • netflix – Netflix
  • youtube.leanback.v4 – YouTube
  • amazon – Amazon Prime Video
  • com.webos.app.livetv – Live TV
  • com.webos.app.hdmi1 – HDMI 1
  • com.webos.app.hdmi2 – HDMI 2
  • com.webos.app.hdmi3 – HDMI 3
  • com.webos.app.browser – Web Browser
  • com.webos.app.photovideo – Foto & Video
  • com.webos.app.music – Musik

Media-Steuerung

Abspielen auslösen

• Typ: Binär (Trigger)
• Funktion: Play-Befehl (funktioniert bei laufenden Apps wie Netflix, YouTube)

Pause auslösen

• Typ: Binär (Trigger)
• Funktion: Pause-Befehl (funktioniert bei laufenden Apps wie Netflix, YouTube)

Erweiterte Funktionen (standardmäßig ausgeblendet)

Taste auslösen

• Typ: Binär (Trigger)
• Funktion: Sendet eine Fernbedienungstaste aus “Tastenname”

Tastenname

• Typ: Text
• Funktion: Name der zu sendenden Fernbedienungstaste
• Verfügbare Tasten:
  • Navigation: UP, DOWN, LEFT, RIGHT, ENTER
  • Menü: HOME, BACK, EXIT, MENU
  • Wiedergabe: PLAY, PAUSE, STOP, REWIND, FASTFORWARD
  • Kanal: CHANNELUP, CHANNELDOWN
  • Zahlen: 0 bis 9

Befehl auslösen

• Typ: Binär (Trigger)
• Funktion: Sendet benutzerdefinierten WebOS-Befehl
• Hinweis: Für fortgeschrittene Benutzer

Befehl-URI

• Typ: Text
• Funktion: WebOS SSAP-URI (z.B. ssap://system/turnOff)
• Hinweis: Siehe LG WebOS Developer Documentation

Befehl-Payload (JSON)

• Typ: Text
• Funktion: JSON-Payload für den benutzerdefinierten Befehl
• Hinweis: Muss gültiges JSON sein

---

Ausgänge

Ist an

• Typ: Binär
• Beschreibung: Zeigt an, ob der TV eingeschaltet ist
• Werte:
  • true (1) = TV ist eingeschaltet
  • false (0) = TV ist ausgeschaltet
• Aktualisierung: Automatisch alle 30 Sekunden (Polling-Intervall) oder 1 Sekunde nach Befehlen

Aktuelle Lautstärke

• Typ: Integer (0-100)
• Beschreibung: Aktuelle Lautstärke des TVs
• Werte: 0 = lautlos, 100 = maximale Lautstärke
• Hinweis: Wird auf 0 gesetzt wenn TV ausgeschaltet ist

Ist stumm

• Typ: Binär
• Beschreibung: Zeigt an, ob der TV stummgeschaltet ist
• Werte:
  • true (1) = TV ist stumm
  • false (0) = TV ist nicht stumm
• Hinweis: Wird auf false gesetzt wenn TV ausgeschaltet ist

Aktuelle Quelle

• Typ: Text
• Beschreibung: Aktuell aktive Eingabequelle
• Beispielwerte: HDMI_1, HDMI_2, LIVE_TV
• Hinweis: Wird geleert wenn TV ausgeschaltet ist

Aktuelle App

• Typ: Text
• Beschreibung: ID der aktuell laufenden App
• Beispielwerte: netflix, youtube.leanback.v4, com.webos.app.livetv
• Hinweis: Wird geleert wenn TV ausgeschaltet ist

Medienstatus

• Typ: Text
• Beschreibung: Status der Media-Wiedergabe
• Hinweis: Reserviert für zukünftige Funktionen

Tonausgabe

• Typ: Text
• Beschreibung: Aktuelle Audio-Ausgabe (TV-Lautsprecher, optisch, HDMI ARC, etc.)
• Hinweis: Reserviert für zukünftige Funktionen

Pairing-Status

• Typ: Text
• Beschreibung: Status des Pairing-Vorgangs
• Mögliche Werte:
  • No Client Key – Noch kein Pairing durchgeführt
  • Ready – Pairing erfolgreich, Baustein betriebsbereit
  • Pairing... – Pairing-Vorgang läuft
  • Connecting... – Verbindung zum TV wird aufgebaut
  • Registering - Accept on TV NOW! – Warte auf Bestätigung am TV
  • SUCCESS: [langer-schlüssel] – Pairing erfolgreich, Schlüssel angezeigt
  • Timeout waiting for key – Pairing fehlgeschlagen
  • Connection failed – TV nicht erreichbar

Fehlermeldung (standardmäßig ausgeblendet)

• Typ: Text
• Beschreibung: Zeigt Fehlermeldungen und Debug-Informationen an
• Hinweis: Normalerweise leer. Bei Problemen hier nachschauen.

---

Erste Inbetriebnahme

Schritt 1: Netzwerk-Konfiguration

1. TV IP-Adresse im TV-Menü ermitteln (Einstellungen → Netzwerk)
2. IP-Adresse im Parameter “TV IP-Adresse” eintragen
3. Wake-On-Lan am Fernseher aktivieren!
4. Optional: MAC-Adresse in Baustein eintragen für Wake-on-LAN

Schritt 2: Pairing durchführen

1. TV einschalten
2. Eingang “Pairing auslösen” auf 1 setzen
3. Am TV erscheint Dialog “Gerät zulassen?” oder ähnlich
4. Dialog am TV mit der Fernbedienung bestätigen
5. Im Ausgang “Pairing-Status” erscheint: SUCCESS: [langer-schlüssel]
6. Diesen langen Schlüssel kopieren

Schritt 3: Client-Schlüssel eintragen

1. Kopierten Schlüssel im Parameter “WebOS Client-Schlüssel” eintragen
2. Baustein ist jetzt betriebsbereit
3. “Pairing-Status” zeigt nun Ready

Schritt 4: Funktionstest

1. “Lautstärke-Wert” auf z.B. 20 setzen
2. “Lautstärke setzen auslösen” auf 1 setzen
3. TV-Lautstärke sollte sich ändern
4. Nach ~1 Sekunde zeigt “Aktuelle Lautstärke” den Wert 20

---

Troubleshooting

Pairing schlägt fehl

• Prüfen: Ist der TV eingeschaltet?
• Prüfen: Ist die IP-Adresse korrekt?
• Prüfen: Ist der TV im selben Netzwerk wie der Gira X1?
• Lösung: Dialog am TV innerhalb von 30 Sekunden bestätigen

Befehle funktionieren nicht

• Prüfen: Ist der Client-Schlüssel eingetragen?
• Prüfen: Ist der TV eingeschaltet?
• Prüfen: “Fehlermeldung”-Ausgang auf Hinweise prüfen
• Lösung: Pairing erneut durchführen

Status-Ausgänge werden nicht aktualisiert

• Prüfen: Ist “Abfrageintervall (s)” auf einen sinnvollen Wert gesetzt?
• Prüfen: Ist der TV erreichbar?
• Hinweis: Updates erfolgen automatisch, aber mit Verzögerung (Standard: 30 Sekunden)
• Lösung: Nach Befehlen erfolgt Update automatisch nach 1 Sekunde

Wake-on-LAN funktioniert nicht

• Prüfen: Ist die MAC-Adresse korrekt eingetragen?
• Prüfen: Ist Wake-on-LAN am TV aktiviert? (Einstellungen → Allgemein → Geräte-Verwaltung → Mobile TV On)
• Hinweis: TV benötigt 10-30 Sekunden zum Hochfahren