Die iTach IR-Adapter eignen sich ideal zur Steuerung von Geräten wie AV-Equipment (TV, Blu-Ray, Heimkino) sowie sämtlichen Geräten, die über Infrarot-(IR)-Befehle gesteuert werden können – sogar Klimaanlagen.
Diese Anleitung zeigt, wie Sie die iTach-Adapter mit den Z-Wave-Controllern VERA Lite und VERA3 unter UI5 verwenden.
Verwendung von iTach mit VERA
Damit VERA die iTach-Geräte nutzen kann, muss ein VERA-Plugin heruntergeladen und anschließend Gerätedateien für jedes IR-Gerät erstellt werden, das über den iTach gesteuert werden soll.
Diese Anleitung zeigt Ihnen, wie Sie:
- Das VERA iTach (GC100) Plugin herunterladen und korrekt konfigurieren
- Die Gerätedateien für jedes zu steuernde Gerät erstellen
- Die iTach-IR-Steuerstrings zu den Gerätedateien hinzufügen
- Ein VERA-Gerät für das jeweilige Endgerät anlegen
- Die Funktionen des Geräts über VERA-Szenen steuern
Schritt 1 – Dateien herunterladen
Für die erfolgreiche Installation des VERA iTach (GC100) Plugins und die Verwendung der iTach-Geräte werden verschiedene Dateien benötigt. Um dies zu vereinfachen, haben wir diese in einer einzigen ZIP-Datei zum Download zusammengefasst.
Laden Sie daher vor allen weiteren Schritten die Vesternet iTach-ZIP-Datei herunter:
Vesternet iTach Files v2.0 (ZIP)
Die ZIP-Datei enthält vier Dateien, die Sie im weiteren Verlauf dieser Anleitung benötigen:
- I_GC100.xml – Update-Datei für das GC100-Plugin
- D_Bose_Sounddock.xml – Geräte-Beschreibungsdatei („Description“, basierend auf Bose Sounddock 2)
- I_Bose_Sounddock.xml – Geräte-Implementierungsdatei („Implementation“)
- S_Bose_Sounddock.xml – Geräte-Servicedatei („Service“)
Schritt 2 – iTach/GC100-Plugin installieren und korrekt konfigurieren
Das iTach/GC100-Plugin ermöglicht die Nutzung und Konfiguration des iTach IR-Adapters.
GC100-Plugin installieren
- Navigieren Sie in der VERA-Benutzeroberfläche zur Registerkarte „APPS“ und wählen Sie „Install Apps“
- Suchen Sie nach „GC100“
- Installieren Sie die App; sie wird anschließend unter der Registerkarte My Apps angezeigt
- Unter der Registerkarte DEVICES finden Sie nun ein neues GC100-Gerät
- Klicken Sie auf das „Schraubenschlüssel“-Symbol des Geräts und wechseln Sie zur Registerkarte „Advanced“
- Geben Sie die iTach-IP-Adresse ein (siehe APNT-65 – iTach Basic Configuration and Learning)
- Schließen Sie das Gerätefenster und klicken Sie auf die rote Schaltfläche „SAVE“
- Das GC100-Gerät sollte nun in der Registerkarte DEVICES von VERA angezeigt werden
Abbildung 1: Hinzufügen der iTach-IP-Adresse zum GC100-Plugin-Gerät
GC100-Plugin – Bekanntes Problem
Beim GC100-Plugin besteht ein bekanntes Problem: IR-Befehle werden doppelt gesendet.
Dies lässt sich einfach beheben, indem eine korrigierte Implementierungsdatei hochgeladen wird.
- Gehen Sie zu „APPS“ > „Develop Apps“
- Klicken Sie in der linken Seitenleiste auf „LUUP Files“
- Klicken Sie auf die Schaltfläche „Choose File“ und wählen Sie die Datei I_GC100.xml aus (in der Vesternet iTach-ZIP-Datei enthalten)
- Klicken Sie auf „Go“
- Nach Abschluss des Uploads muss Luup neu gestartet werden
- Gehen Sie zu SETUP > Net & Wi-fi und klicken Sie auf „Reboot“
- Warten Sie, bis VERA neu gestartet ist
- Das GC100-Plugin ist nun korrekt konfiguriert und betriebsbereit
Abbildung 2: Konfiguriertes GC100-Plugin
Schritt 3 – Gerätedateien erstellen und hochladen
Um ein IR-steuerbares Gerät in VERA zu erstellen, müssen wir zunächst die Steuerungsdateien des Geräts anlegen und bearbeiten.
Dieses Beispiel basiert auf einem Satz von Dateien, die ich für ein Bose Sounddock erstellt habe. Diese Anleitung zeigt Ihnen die Abschnitte der XML-Dateien, die Sie für Ihr Gerät anpassen müssen.
- Extrahieren Sie die .xml-Dateien aus der ZIP-Datei des Vesternet iTach
- Benennen Sie sie um, sodass Sie das zugehörige Gerät erkennen können – zum Beispiel „XYZ“, „Yamaha RX675“ usw.
- Sie können einen beliebigen Namen verwenden – im weiteren Verlauf dieser Anleitung werde ich die Dateien mit dem Namen Bose_SoundDock bezeichnen.
Service-Datei (S_-Datei) bearbeiten
Die Datei S_Bose_SoundDock.xml ist die „Service“-Datei für das IR-Gerät; sie steuert die Aktionen des Geräts. In diesem Fall definieren wir die IR-Aktionen, die durch die iTach-IR-Befehle ausgelöst werden können.
- Öffnen Sie die Datei S_Bose_SoundDock.xml in einem Text- oder HTML-Editor
- In Zeile 7 finden Sie ein < actionList >-Tag und darunter mehrere < action >-Tags
- Diese verweisen auf entsprechende < action >-Tags in der Datei I_Bose_SoundDock.xml, welche die eigentlichen IR-Codes zur Steuerung des Geräts enthalten
- Bearbeiten Sie in der Datei S_Bose_SoundDock.xml diese Namen, löschen Sie nicht benötigte Einträge oder fügen Sie neue hinzu
- Für dieses Beispiel benötigte ich lediglich zwei Steuerungsbefehle für das SoundDock – Bose Play und Bose Off
- Denken Sie daran, die Änderungen nach Abschluss zu speichern
- Die fertige Datei S_Bose_SoundDock.xml ist in Abbildung 3 dargestellt
Abbildung 3: S_Bose_SoundDock.xml-Gerätedatei
Implementierungsdatei (I_-Datei) bearbeiten
Die Datei I_Bose_SoundDock.xml ist die „Implementation“-Datei für das IR-Gerät; sie enthält die Aktionen und IR-Codes, die das Gerät steuern.
- Öffnen Sie die Datei I_Bose_SoundDock.xml in einem Text- oder HTML-Editor
- In Zeile 3 finden Sie ein < actionList >-Tag und darunter mehrere < action >-Tags
- Diese enthalten die IR-Codes, die bei Aktivierung der jeweiligen Aktion gesendet werden
- Benennen Sie die < serviceId > passend zum jeweiligen Gerät um – < serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock< /serviceId >
- Hinweis: Dieselbe < serviceId > wird für alle Aktionen in der Datei I_Bose_SoundDock.xml verwendet
- Bearbeiten Sie das < name >-Tag so, dass es der Beschreibung der Aktion entspricht – < name >Bose Play < /name >
IR-Code hinzufügen
Nun müssen Sie den IR-Steuercode verwenden, den Sie in der iTach-App iLearn erstellt haben, und ihn in die Implementierungsdatei einfügen. Weitere Informationen finden Sie unter APNT-65 - iTach Basic Configuration and Learning.
- Die Datei I_Bose_SoundDock.xml verwendet den HEX IR Control-Code – wählen Sie in iLearn das HEX-Format aus
- Fügen Sie diesen Code zwischen den < ir >-Tags ein
- Sie können alle weiteren Aktionen bearbeiten, nicht benötigte Einträge löschen oder neue hinzufügen
Es empfiehlt sich, zunächst eine Aktion und einen IR-Code hinzuzufügen und in VERA zu testen, bevor Sie die gesamte Datei I_SoundDock.xml fertigstellen.
Abbildung 4: I_Bose_SoundDock.xml-Gerätedatei mit hervorgehobenem IR-Code
Bearbeiten der Beschreibung (D_-Datei)
Die Datei D_Bose_SoundDock.xml ist die „Description“-Datei (Beschreibungsdatei) für das IR-Gerät; sie enthält alle Informationen für das IR-Gerät. Sie müssen die Hauptgerätebeschreibungen sowie Links zu den Implementation- und Service-Dateien hinzufügen.
Gerätebeschreibungen
- Bearbeiten Sie die Beschreibungszeilen, um das Gerät, das über dieses IR-Gerät gesteuert werden soll, genauer zu beschreiben (siehe Abbildung 5):
< friendlyName >, < manufacturer >, < manufacturerURL >, < modelDescription > und < modelName >
Zeile der Implementation-Datei
- Bearbeiten Sie den Dateinamen in < implementationFile > (Zeile 120), sodass er mit Ihrer I_XML-Datei übereinstimmt – I_Bose_SoundDock.xml
Service-Dateien
- Bearbeiten Sie den letzten „Service“-Abschnitt (Zeile 31), sodass er mit der Datei S_Bose_SoundDock.xml übereinstimmt:
< serviceType >urn:a-lurker-com:service:Bose_SoundDock:1 </serviceType>
< serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock1 </serviceId>
< SCPDURL >S_Bose_SoundDock.xml </SCPDURL>
- Hinweis: Beachten Sie das „:1“ und „1“ nach dem Dateinamen in den ersten beiden Zeilen
- Die anderen Services sind generische VERA-Service-Dateien – Sie können diese beibehalten oder aus der Datei D_SoundDock.xml löschen.
Eindeutiger Gerätename (UDN)
Dies ist ein wichtiger Schritt.
Jedes Gerät muss über einen eindeutigen UDN (Unique Device Name) verfügen; Sie können für jedes IR-Gerät einen eigenen erstellen.
- Erstellen Sie einen UDN unter http://www.famkruithof.net/uuid/uuidgen
- Klicken Sie auf Get
- Oben auf der Seite sehen Sie eine neue UDN-Nummer (fettgedruckt), die ein Format ähnlich wie b2f53800-b8ea-11e3-a5e2-0800200c9a66 aufweist
- Fügen Sie diese in die Zeile < UDN > nach uuid: ein
< UDN >uuid:b2f53800-b8ea-11e3-a5e2-0800200c9a66 </serviceType>
- Ihre Datei D_SoundDock.xml sollte nun wie in Abbildung 5 aussehen.
Abbildung 5: D_Bose_SoundDock.xml-Gerätedatei
Dateien auf VERA hochladen
Diese Dateien müssen nun auf die VERA hochgeladen werden (ähnlich wie Sie das GC100-Plugin-Update in Schritt 2 hochgeladen haben).
- Gehen Sie zu „APPS“ > „Develop Apps“
- Klicken Sie in der linken Seitenleiste auf „LUUP Files“
- Klicken Sie auf die Schaltfläche „Choose File“ und wählen Sie die Dateien D_Bose_SoundDock.xml, I_Bose_SoundDock.xml und S_Bose_SoundDock.xml aus
- Klicken Sie auf „Go“
- Sobald der Upload abgeschlossen ist, müssen Sie Luup neu starten
- Gehen Sie zu SETUP > Net & Wi-fi und klicken Sie auf „Reboot“
- Warten Sie, bis VERA neu gestartet ist
- Die Gerätedateien sind nun in den Luup-Dateien Ihrer VERA enthalten
Schritt 4 – Erstellen des IR-Geräts
Sie können nun ein VERA-Gerät erstellen, das die soeben erstellten Dateien verwendet. Dieses Gerät fungiert als „virtuelles Gerät“ des realen Geräts; Sie können dessen Funktionen über VERA-Szenen steuern.
- Gehen Sie zu „APPS“ > „Develop Apps“
- Klicken Sie in der linken Seitenleiste auf „Create Device“
- Geben Sie den Dateinamen „D_Bose_SoundDock.xml“ in das Feld Upnp Device Filename ein
- Klicken Sie auf „Create Device“
Abbildung 6: IR-Gerät in VERA erstellen
- Das neue Gerät befindet sich auf der Registerkarte DEVICES, ist jedoch noch nicht vollständig konfiguriert
- Klicken Sie auf die blaue Schaltfläche „RELOAD“ von VERA (oben auf der Seite) und warten Sie, bis VERA neu geladen wurde
- Das Gerät sollte nun den „friendlyName“ aufweisen, den Sie in der Datei „Device Description“ festgelegt haben
- Auf der Registerkarte „Advanced“ des Geräts sollten die korrekte Description-Datei (D_Bose_SoundDock.xml) und der Gerätetyp (urn:schemas-micasaverde-com:device:IrDevice:1) hinterlegt sein
- Falls diese Felder nicht ausgefüllt sind, klicken Sie erneut auf die Schaltfläche „RELOAD“ und warten Sie, bis VERA neu geladen wurde
- Als Letztes muss das Gerät mit dem korrekten iTach-IR-Port konfiguriert werden – iTach verfügt über drei IR-Ports; in diesem Beispiel wird der IR-Blaster (Port 3) verwendet – siehe APNT-65 – iTach Grundkonfiguration und Anlernen
- Gehen Sie auf die Registerkarte „Settings“ des Geräts und wählen Sie den korrekten Port aus dem Dropdown-Menü aus
- Schließen Sie das Gerät und klicken Sie auf die rote Schaltfläche „SAVE“ (oben auf der Seite)
- Sobald VERA den Neuladevorgang abgeschlossen hat, ist das Gerät für Tests bereit
Abbildung 6: Korrekten IR-Port für das Geräte-Device auswählen
Schritt 5 – Das IR-Gerät testen
Nun können Sie das neue Gerät testen und überprüfen, ob es ordnungsgemäß funktioniert.
- Geben Sie in Ihrem Browser http://VERAs_IP_address:3480/data_request?id=lu_invoke ein – ersetzen Sie „VERAs_IP_address“ durch die IP-Adresse Ihrer VERA-Zentrale
- Klicken Sie in der Liste auf das entsprechende Gerät – in diesem Beispiel #200 Bose SoundDock
- Daraufhin wird eine Liste der verfügbaren Befehle angezeigt
- Stellen Sie sicher, dass der IR-Blaster/Emitter des iTach vor dem Gerät positioniert ist
- Klicken Sie im Browser auf eine der Aktionen – das Gerät sollte den entsprechenden Befehl nun ausführen
- Funktioniert dies nicht ordnungsgemäß, überprüfen Sie die Gerätedateien, korrigieren Sie diese und laden Sie sie erneut hoch
Abbildung 7: Browseransicht mit einer Liste der für das IR-Gerät verfügbaren Aktionen
Schritt 6 – Das IR-Gerät in Szenen verwenden
Nachdem die Geräteaktionen über iTach ordnungsgemäß funktionieren, können Sie VERA-Szenen zur Steuerung der Gerätefunktionen nutzen.
Hierzu verwenden Sie die Registerkarte „Advanced Scene“ in VERA.
- Erstellen Sie eine neue Szene – siehe APNT-34: Creating Scenes in VERA
- Wechseln Sie zur Registerkarte „Advanced“ der Szene
- Wählen Sie das IR-Gerät im Dropdown-Menü „Pick a device“ aus
- Klicken Sie auf „Add“
- Das Gerät ist nun zur Szene hinzugefügt
- Wählen Sie die Aktion aus dem Dropdown-Menü „Please select“ neben dem Gerät aus
- Klicken Sie auf die grüne Schaltfläche „Confirm changes“ (oben auf der Seite)
- Klicken Sie auf die rote Schaltfläche „SAVE“ (oben auf der Seite)
- Sie verfügen nun über eine Szene, die ausgelöst, zeitgesteuert oder manuell ausgeführt werden kann, um eine oder mehrere Aktionen des Geräts zu steuern
Abbildung 8: Verwendung des IR-Geräts in einer Szene
Dies ist eine etwas ausführlichere Anleitung. Wenn Sie diesen Vorgang jedoch einmal durchgeführt haben, werden Sie feststellen, dass alles schlüssig ist und Sie das nächste über iTach gesteuerte Gerät deutlich schneller einrichten können.
Referenz
Diese Application Note basiert auf Tests von Vesternet sowie auf zahlreichen hilfreichen Forumsbeiträgen der Nutzer des VERA-Forums, mit besonderem Dank an die Forumsmitglieder „a-lurker“ und „konradwalsh“.
Verwandte Informationen
- APNT-65: iTach Basic Configuration and Learning
- APNT-66: Using iTach with Fibaro Home Center
- APNT-34: Creating VERA Scenes
- APNT-35: Controlling VERA Scenes with a Trigger
- APNT-36: Controlling VERA Scenes with a Schedule
- KB-35: Difference between iTach Emitter and Blaster Cables
- KB-36: iTach API Information
- Global Cache Downloads and Documents
Die iTach-IR-Adapter eignen sich ideal zur Steuerung von Geräten wie AV-Equipment (TV, Blu-Ray, Heimkino) sowie jedem Gerät, das über Infrarot-(IR)-Befehle angesteuert werden kann – einschließlich Klimaanlagen.
Diese Anleitung beschreibt die Verwendung der iTach-Adapter mit den Z-Wave-Controllern VERA Lite und VERA3 unter UI5.
Verwendung von iTach mit VERA
Damit VERA die iTach-Geräte ansprechen kann, muss ein VERA-Plugin heruntergeladen und anschließend Gerätedateien für jedes IR-Gerät erstellt werden, das über den iTach gesteuert werden soll.
Diese Anleitung erläutert:
- Das Herunterladen und korrekte Konfigurieren des VERA iTach (GC100)-Plugins
- Das Erstellen der Gerätedateien für jedes zu steuernde Gerät
- Das Hinzufügen der iTach-IR-Steuerstrings zu den Gerätedateien
- Das Erstellen eines VERA-Geräts für die entsprechende Einheit
- Die Steuerung der Gerätefunktionen über VERA-Szenen
Schritt 1 – Dateien herunterladen
Um das VERA iTach (GC100)-Plugin erfolgreich zu installieren und die iTach-Geräte zu verwenden, benötigen Sie eine Reihe von Dateien. Wir haben dies vereinfacht und alle Dateien in einer einzigen ZIP-Datei für Sie zum Download bereitgestellt.
Laden Sie daher vor allen anderen Schritten die Vesternet iTach-ZIP-Datei herunter:
Vesternet iTach Files v2.0 (ZIP)
Die ZIP-Datei enthält vier Dateien, die Sie im weiteren Verlauf dieser Anleitung verwenden werden:
- I_GC100.xml – GC100-Plugin-Aktualisierungsdatei
- D_Bose_Sounddock.xml – Geräte-„Beschreibungsdatei“ (Description-Datei, basierend auf Bose Sounddock 2)
- I_Bose_Sounddock.xml – Geräte-„Implementierungsdatei“ (Implementation-Datei)
- S_Bose_Sounddock.xml – Geräte-„Dienstdatei“ (Service-Datei)
Schritt 2 – iTach/GC100-Plugin installieren und korrekt konfigurieren
Das iTach/GC100-Plugin ermöglicht es Ihnen, den iTach-IR-Adapter zu verwenden und zu konfigurieren.
GC100-Plugin installieren
- Gehen Sie in der VERA-Benutzeroberfläche auf die Registerkarte „APPS“ und wählen Sie „Install Apps“
- Suchen Sie nach „GC100“
- Installieren Sie die App; sie wird anschließend auf der Registerkarte My Apps angezeigt
- Auf der Registerkarte DEVICES wird nun ein neues GC100-Gerät angezeigt
- Klicken Sie auf das „Schraubenschlüssel“-Symbol des Geräts und wechseln Sie zur Registerkarte „Advanced“
- Geben Sie die iTach IP-Adresse ein (siehe APNT-65 - iTach Basic Configuration and Learning)
- Schließen Sie das Gerätefenster und klicken Sie auf die rote Schaltfläche „SAVE“
- Sie sollten das GC100-Gerät nun auf der VERA-Registerkarte DEVICES sehen
Abbildung 1: Hinzufügen der iTach-IP-Adresse zum GC100-Plugin-Gerät
GC100-Plugin – Bekanntes Problem
Es gibt ein bekanntes Problem mit dem GC100-Plugin – es sendet IR-Befehle doppelt.
Dies lässt sich leicht beheben, indem eine korrigierte „Implementation“-Datei hochgeladen wird.
- Gehen Sie zu „APPS“ > „Develop Apps“
- Klicken Sie in der linken Seitenleiste auf „LUUP Files“
- Klicken Sie auf die Schaltfläche „Choose File“ und wählen Sie die Datei I_GC100.xml aus (in der Vesternet iTach-ZIP-Datei enthalten)
- Klicken Sie auf „Go“
- Sobald der Upload abgeschlossen ist, müssen Sie Luup neu starten
- Gehen Sie zu SETUP > Net & Wi-fi und klicken Sie auf „Reboot“
- Warten Sie, bis VERA neu gestartet ist
- Sie verfügen nun über ein korrekt konfiguriertes und funktionierendes GC100-Plugin
Abbildung 2: Konfiguriertes GC100-Plugin
Schritt 3 – Gerätedateien erstellen und hochladen
Um ein IR-steuerbares Gerät in VERA anzulegen, müssen zunächst die Steuerungsdateien des Geräts erstellt und bearbeitet werden.
Dieses Beispiel basiert auf einem Dateisatz, den ich für ein Bose Sounddock erstellt habe; diese Anleitung zeigt Ihnen die Abschnitte der XML-Dateien, die Sie für Ihr jeweiliges Gerät anpassen müssen.
- Entpacken Sie die .xml-Dateien aus der Vesternet iTach-ZIP-Datei
- Benennen Sie sie so um, dass Sie das zugehörige Gerät erkennen können – zum Beispiel „XYZ“, „Yamaha RX675“ usw.
- Sie können einen beliebigen Namen wählen – im weiteren Verlauf dieser Anleitung beziehe ich mich auf die Dateien mit dem Namen Bose_SoundDock.
Bearbeiten der Dienstdatei (S_-Datei)
Die Datei S_Bose_SoundDock.xml ist die „Service“-Datei für das IR-Gerät; sie steuert die Aktionen des Geräts. In diesem Fall definieren wir die IR-Aktionen, die durch die iTach-IR-Befehle ausgelöst werden können.
- Öffnen Sie die Datei S_Bose_SoundDock.xml in einem Text- oder HTML-Editor
- In Zeile 7 finden Sie ein < actionList >-Tag und darunter mehrere < action >-Tags
- Diese verweisen auf ähnliche < action >-Tags in der Datei I_Bose_SoundDock.xml, welche die eigentlichen IR-Codes zur Steuerung des Geräts enthalten
- Bearbeiten Sie diese Namen in der Datei S_Bose_SoundDock.xml, löschen Sie nicht benötigte oder fügen Sie neue hinzu
- Für dieses Beispiel waren nur zwei Bedienelemente für das SoundDock erforderlich – Bose Play und Bose Off
- Denken Sie daran, die Änderungen nach Abschluss zu speichern
- Die fertige Datei S_Bose_SoundDock.xml ist in Abbildung 3 dargestellt
Abbildung 3: S_Bose_SoundDock.xml-Gerätedatei
Bearbeiten der Implementierung (I_-Datei)
Die Datei I_Bose_SoundDock.xml ist die „Implementation“-Datei für das IR-Gerät; sie enthält die Aktionen und IR-Codes, die das Gerät steuern.
- Öffnen Sie die Datei I_Bose_SoundDock.xml in einem Text- oder HTML-Editor
- In Zeile 3 finden Sie ein < actionList >-Tag und darunter mehrere < action >-Tags
- Diese enthalten die IR-Codes, die beim Aktivieren der jeweiligen Aktion übertragen werden
- Benennen Sie die < serviceId > passend zum Gerät um – < serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock< /serviceId >
- Hinweis: Dieselbe < serviceId > wird für alle Aktionen in der Datei I_Bose_SoundDock.xml verwendet
- Bearbeiten Sie das < name >-Tag so, dass es der Beschreibung der Aktion entspricht – < name >Bose Play < /name >
IR-Code hinzufügen
Nun müssen Sie den in der iTach-App iLearn erstellten IR-Steuercode verwenden und in die Implementierungsdatei einfügen. Weitere Informationen finden Sie unter APNT-65 – iTach Grundkonfiguration und Anlernen.
- Die Datei I_Bose_SoundDock.xml verwendet den HEX-IR-Steuercode – wählen Sie in iLearn das HEX-Format
- Fügen Sie diesen Code zwischen den < ir >-Tags ein
- Sie können alle weiteren Aktionen bearbeiten, nicht benötigte löschen oder neue hinzufügen
Es empfiehlt sich, zunächst eine Aktion und einen IR-Code hinzuzufügen und in VERA zu testen, bevor die vollständige Datei I_SoundDock.xml fertiggestellt wird.
Abbildung 4: I_Bose_SoundDock.xml-Gerätedatei mit hervorgehobenem IR-Code
Bearbeiten der Beschreibung (D_-Datei)
Die Datei D_Bose_SoundDock.xml ist die „Description“-Datei für das IR-Gerät; sie enthält alle Informationen für das IR-Gerät. Sie müssen die Hauptgerätebeschreibungen sowie Verknüpfungen zu den Implementierungs- und Service-Dateien hinzufügen.
Gerätebeschreibungen
- Bearbeiten Sie die Beschreibungszeilen, um das Gerät, das über dieses IR-Gerät gesteuert werden soll, genauer zu beschreiben (siehe Abbildung 5):
< friendlyName >, < manufacturer >, < manufacturerURL >, < modelDescription > und < modelName >
Zeile der Implementierungsdatei
- Passen Sie den Dateinamen unter < implementationFile > (Zeile 120) an Ihre I_XML-Datei an – I_Bose_SoundDock.xml
Service-Dateien
- Bearbeiten Sie den letzten Abschnitt „Service“ (Zeile 31), damit er mit der Datei S_Bose_SoundDock.xml übereinstimmt:
< serviceType >urn:a-lurker-com:service:Bose_SoundDock:1 </serviceType>
< serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock1 </serviceId>
< SCPDURL >S_Bose_SoundDock.xml </SCPDURL>
- Hinweis: Beachten Sie das „:1“ und die „1“ nach dem Dateinamen in den ersten beiden Zeilen
- Bei den übrigen Services handelt es sich um generische VERA-Service-Dateien – Sie können diese beibehalten oder aus der Datei D_SoundDock.xml entfernen.
Unique Device Name (UDN)
Dies ist ein wichtiger Schritt.
Jedes Gerät muss über einen eindeutigen UDN (Unique Device Name) verfügen; Sie können für jedes IR-Gerät einen eigenen erstellen.
- Erstellen Sie eine UDN unter http://www.famkruithof.net/uuid/uuidgen
- Klicken Sie auf Get
- Am Seitenanfang wird eine neue UDN-Nummer (fettgedruckt) angezeigt, deren Format diesem Beispiel ähnelt: b2f53800-b8ea-11e3-a5e2-0800200c9a66
- Fügen Sie diese in die Zeile < UDN > nach uuid: ein
< UDN >uuid:b2f53800-b8ea-11e3-a5e2-0800200c9a66 </serviceType>
- Ihre Datei D_SoundDock.xml sollte nun wie in Abbildung 5 aussehen.
Abbildung 5: Gerätedatei D_Bose_SoundDock.xml
Dateien auf VERA hochladen
Diese Dateien müssen nun auf das VERA-Gateway hochgeladen werden (ähnlich wie das Hochladen des GC100-Plugin-Updates in Schritt 2).
- Gehen Sie zu „APPS“ > „Develop Apps“
- Klicken Sie in der linken Seitenleiste auf „LUUP Files“
- Klicken Sie auf die Schaltfläche „Choose File“ und wählen Sie die Dateien D_Bose_SoundDock.xml, I_Bose_SoundDock.xml und S_Bose_SoundDock.xml aus
- Klicken Sie auf „Go“
- Sobald der Upload abgeschlossen ist, müssen Sie Luup neu starten
- Gehen Sie zu SETUP > Net & Wi-fi und klicken Sie auf „Reboot“
- Warten Sie, bis VERA neu gestartet ist
- Die Gerätedateien sind nun in den Luup-Dateien Ihres VERA-Gateways enthalten
Schritt 4 – IR-Haushaltsgerät anlegen
Sie können nun ein VERA-Gerät anlegen, das die soeben erstellten Dateien nutzt. Dieses Gerät dient als „virtuelles Gerät“ des realen Geräts; seine Funktionen können Sie anschließend über VERA-Szenen steuern.
- Gehen Sie zu „APPS“ > „Develop Apps“
- Klicken Sie in der linken Seitenleiste auf „Create Device“
- Geben Sie den Dateinamen „D_Bose_SoundDock.xml“ in das Feld Upnp Device Filename ein
- Klicken Sie auf „Create Device“
Abbildung 6: IR-Gerät in VERA erstellen
- Das neue Gerät befindet sich auf der Registerkarte DEVICES, ist jedoch noch nicht vollständig konfiguriert
- Klicken Sie auf die blaue Schaltfläche „RELOAD“ von VERA (oben auf der Seite) und warten Sie, bis VERA neu geladen wurde
- Das Gerät sollte nun den „friendlyName“ aufweisen, den Sie in der Datei „Device Description“ festgelegt haben
- Auf der Registerkarte „Advanced“ des Geräts sollten die korrekte Description-Datei (D_Bose_SoundDock.xml) und der Gerätetyp (urn:schemas-micasaverde-com:device:IrDevice:1) hinterlegt sein
- Falls diese Felder nicht ausgefüllt sind, klicken Sie erneut auf die Schaltfläche „RELOAD“ und warten Sie, bis VERA neu geladen wurde
- Als Letztes muss das Gerät mit dem korrekten iTach-IR-Port konfiguriert werden – iTach verfügt über drei IR-Ports; in diesem Beispiel wird der IR-Blaster (Port 3) verwendet – siehe APNT-65 – Grundkonfiguration und Anlernen des iTach
- Wechseln Sie zur Registerkarte „Settings“ des Geräts und wählen Sie den passenden Port aus dem Dropdown-Menü aus
- Schließen Sie das Gerät und klicken Sie auf die rote Schaltfläche „SAVE“ (oben auf der Seite)
- Nachdem VERA den Neuladevorgang abgeschlossen hat, ist das Gerät für Tests bereit
Abbildung 6: Den korrekten IR-Port für das Endgerät auswählen
Schritt 5 – Das IR-Endgerät testen
Nun kann das neue Gerät getestet und auf ordnungsgemäße Funktion überprüft werden.
- Geben Sie im Browser http://VERAs_IP_address:3480/data_request?id=lu_invoke ein – ersetzen Sie dabei „VERAs_IP_address“ durch die IP-Adresse Ihrer VERA-Zentrale
- Klicken Sie in der Liste auf das Endgerät – in diesem Fall beispielsweise #200 Bose SoundDock
- Daraufhin wird eine Liste der verfügbaren Befehle angezeigt
- Stellen Sie sicher, dass sich der IR-Blaster/-Emitter des iTach vor dem Endgerät befindet
- Klicken Sie im Browser auf eine der Aktionen – das Endgerät sollte diese Aktion nun ausführen
- Funktioniert dies nicht ordnungsgemäß, überprüfen Sie die Gerätedateien, korrigieren Sie diese und laden Sie sie erneut hoch
Abbildung 7: Browser mit einer Liste der für das IR-Gerät verfügbaren Aktionen
Schritt 6 – Das IR-Endgerät in Szenen verwenden
Nachdem die Geräteaktionen über iTach ordnungsgemäß funktionieren, können die Aktionen des Endgeräts über VERA-Szenen gesteuert werden.
Hierzu wird die Registerkarte „Advanced Scene“ in VERA benötigt
- Erstellen Sie eine neue Szene – siehe APNT-34: Erstellen von Szenen in VERA
- Wechseln Sie zur Registerkarte „Advanced“ der Szene
- Wählen Sie das IR-Endgerät im Dropdown-Menü „Pick a device“ aus
- Klicken Sie auf „Add“
- Das Gerät ist nun zur Szene hinzugefügt
- Wählen Sie die gewünschte Aktion aus dem Dropdown-Menü „Please select“ neben dem Gerät aus
- Klicken Sie auf die grüne Schaltfläche „Confirm changes“ (oben auf der Seite)
- Klicken Sie auf die rote Schaltfläche „SAVE“ (oben auf der Seite)
- Nun steht eine Szene zur Verfügung, die über Trigger, Zeitpläne oder manuell ausgelöst werden kann, um eine oder mehrere Aktionen des Endgeräts zu steuern
Abbildung 8: Verwendung des IR-Geräts in einer Szene
Dies ist eine etwas längere Anleitung. Sobald Sie diesen Vorgang jedoch einmal durchgeführt haben, wird alles verständlich sein, und Sie werden das nächste per iTach gesteuerte Gerät deutlich schneller anlegen können.
Referenz
Diese Anwendungshinweis basiert auf Tests von Vesternet sowie auf vielen nützlichen Forenbeiträgen der Benutzer des VERA Forums, mit besonderem Dank an die Forenmitglieder „a-lurker“ und „konradwalsh“.
Weiterführende Informationen
- APNT-65: iTach Grundkonfiguration und Anlernen
- APNT-66: Verwendung von iTach mit Fibaro Home Center
- APNT-34: Erstellen von VERA-Szenen
- APNT-35: Steuern von VERA-Szenen mit einem Trigger
- APNT-36: Steuern von VERA-Szenen über einen Zeitplan
- KB-35: Unterschied zwischen iTach Emitter- und Blaster-Kabeln
- KB-36: iTach API-Informationen
- Downloads und Dokumente von Global Caché