/Symcon_JVC_Projector_Control

IP-Symcon Modul zur Steuerung eines JVC Projektors.

Primary LanguagePHP

SymconJvcProjector

SymconJvcProjector ist ein Erweiterungsmodul für IP-Symcon und dient dazu, einen JVC Projektor über das Netzwerk zu steuern.

Fragen und Diskussion zum Modul bitte im Symcon Forum. Link zum Thread

Inhalt

  1. Funktionsumfang
  2. Voraussetzungen
  3. Installation
  4. Konfiguration
  5. Variablen und Variablenprofile
  6. PHP-Befehlsreferenz
  7. Anhang

1. Funktionsumfang

Derzeit ist folgende Basisfunktionalität implementiert:

  • Ein- und Ausschalten
  • Umschalten des Eingangs
  • Lampenmodus einstellen
  • Zugriff auf wesentliche Projektorinformationen

Mehr brauche ich persönlich in der täglichen Nutzung nicht. Ich kann aber bei Bedarf weitere Aktionen implementieren, da das mit verhältnismäßig wenig Aufwand möglich ist. Was der Projektor grundsätzlich zulässt, kann der JVC Doku (siehe Link im Anhang) entnommen werden.

2. Voraussetzungen

  • IP-Symcon ab Version 5.0
  • kompatibler JVC Beamer mit aktivierter Netzwerkschnittstelle

3. Installation

Die Einrichtung erfolgt über die Modulverwaltung von Symcon.

Über das Modul-Control folgende URL hinzufügen: git://github.com/bernd70/SymconJvcProjectorControl.git

Danach können JVC Projektor Instanzen erstellt werden.

Besonderheiten beim Update

V1.0 --> V1.1

  • Die Variable PowerState wurde in PowerStatus umbenannt, um den Begriff Status konsistent zu verwednen. Daher sollte die alte Variable PowerState bei jeder Instanz gelöscht werden. Ebenso das Variablenprofil JvcProjector.PowerState.
  • Der Zwischenzustand Switching wurde für den aktuellen Eingang ergänzt. Daruch muss das Variablenprofil JvcProjector.Input aktualisiert werden.

Der einfachste Weg ist, die JVC Projektor Instanzen neu anzulegen.

V1.1 --> V1.2

  • Umbenennung von SymconJvcProjectorControl in SymconJvcProjector, daher muss nach dem Update IP Symcon neu gestartet werden und ggfs. auch das Prefix SymconJvcProjector_ in eigenen Skripten in JvcProjector_ geändert werden.

4. Konfiguration

Konfigurationsseite

Name Beschreibung
Hostname Netzwerkname oder IP Adresse des JVC Projektors
Port TVP Port des Pojektors (Default: 20554)
Abfrageintervall In welchem Abstand soll der Projektor abgefragt werden. (Default: 10 Sekunden)
Button "Einschalten" Schaltet den Projektor ein
Button "Ausschalten" Schaltet den Projektor in den Standby.

5. Variablen und Variablenprofile

Die Variablen und Variablenprofile werden automatisch angelegt.

Variablen

Die nachfolgenden Variablen stehen zur Verfügung und werden zyklisch aktualisiert. Teilweise besteht eine Voraussetzung für das Lesen der Information.

Name Typ Beschreibung Lese-Voraussetzung Anmerkung
Model String Projektormodell Wird einmalig nach Ändern der Modulkonfiguration gelesen
Power Boolean Variable zum Schalten der Projektor Die Variable "Power" dient zum einfachen ein- und ausschalten über das UI. Der Zustand ist true, wenn der PowerStatus "Powered On" ist, ansonsten ist sie false.
PowerStatus JvcProjector.PowerStatus Power Status
MACAddress string MAC Adresse
CurrentInput JvcProjector.Input Aktueller Eingang PowerStatus == PoweredOn
SourceStatus JvcProjector.SourceStatus Status der Quelle PowerStatus == PoweredOn
Signal string Anliegendes Signal PowerStatus == PoweredOn
LampHours Integer Laufzeit der Lampe in Stunden PowerStatus == PoweredOn
Version string Firmware Version PowerStatus == PoweredOn
ColroModel string Farbmodell und Farbtiefe SourceStatus == Okay
ColorSpace string Farbraum SourceStatus == Okay
HDRMode string HDR Modus SourceStatus == Okay

Variablenprofile

JvcProjector.PowerStatus

Wert Bezeichnung Anmerkung
0 Unbekannt Der Zustand wurde noch nicht ermittelt oder kann nicht ermittelt werden
1 Standby Der Projekor ist ausgeschaltet
2 Hochfahren Zwischenzustand zwischen Standby und Eingeschaltet
3 Eingeschaltet Der Projekor ist eingeschaltet
4 Abkühlen Zwischenzustand zwischen Eingeschaltet und Standby
5 Notfall Notfallzustand

JvcProjector.Input

Wert Bezeichnung
0 Unbekannt
1 HDMI 1
2 HDMI 2
3 Component
4 PC
5 Video
6 SVideo
99 Swiching (wird gerade umgesachaltet)

JvcProjector.SourceStatus

Wert Bezeichnung Anmerkung
0 Unbekannt Der Zustand wurde noch nicht ermittelt oder kann nicht ermittelt werden (z.B. Projektor ist aus)
1 JVC Logo Das JVC Logo wird angezeigt
2 Okay Ein gültiges Signal liegt an
3 Kein gültiges Signal Es liegt kein gültiges Signal an

6. PHP-Befehlsreferenz

Soweit nicht anders angegeben, liefern die Funktionen keinen Rückgabewert.

JvcProjector_GetProjectorStatus(integer $InstanzID);

Liest den Status des Projektors mit der InstanzID $InstanzID und setzt alle Symcon Variablen.

JvcProjector_PowerOn(integer $InstanzID);

Schaltet den Projektor mit der InstanzID $InstanzID ein. Der Befehl kann nur ausgeführt werden, wenn der Projektor aus ist (PowerStatus = "Standby").

JvcProjector_PowerOff(integer $InstanzID);

Schaltet den Projektor mit der InstanzID $InstanzID aus. Der Befehl kann nur ausgeführt werden, wenn der Projektor an ist (PowerStatus = "PoweredOn").

JvcProjector_SwitchInput(integer $InstanzID, integer $input);

Schaltet den Projektor mit der InstanzID $InstanzID auf einen bestimmten Eingang. Der Befehl kann nur ausgeführt werden, wenn der Projektor an ist (PowerStatus = "PoweredOn").

JvcProjector_SetLampPower(integer $InstanzID, bool $high);

Schaltet den Lampenmodus des Projektors mit der InstanzID $InstanzID auf Normal ($high = False) oder Hoch ($high = True) Der Befehl kann nur ausgeführt werden, wenn der Projektor an ist (PowerStatus = "PoweredOn").

7. Anhang

Quellen