APNT-68 - Använda iTach med VERA

iTach IR-adaptrar är idealiska för att styra apparater som AV-utrustning (TV, Blu-Ray, hemmabiosystem) och alla enheter som kan styras via infraröda (IR) kommandon. Även luftkonditioneringsenheter.

Denna guide visar hur du använder iTach-adaptrar tillsammans med VERA Lite och VERA3 Z-Wave-kontrollers som kör UI5.

Använda iTach med VERA

För att VERA ska kunna använda iTach-enheterna måste vi ladda ner ett VERA-insticksprogram och sedan skapa enhetsfiler för varje IR-apparat som iTach ska styra.

Denna guide visar hur du:

• Laddar ner och konfigurerar VERA iTach (GC100)-insticksprogrammet korrekt
• Skapar enhetsfilerna för varje apparat som ska styras
• Lägger till iTach IR-kontrollsträngar i enhetsfilerna
• Skapar en VERA-enhet för apparaten
• Styr apparatens funktioner från VERA-scener

Steg 1 – Ladda ner filer

För att installera VERA iTach (GC100)-insticksprogrammet och använda iTach-enheterna behöver du ett antal filer. Vi har underlättat detta genom att samla dem i en enda ZIP-fil för nedladdning.

Så innan du gör något annat, ladda ner Vesternet iTach-zip-filen:

Vesternet iTach Files v2.0 (ZIP)

ZIP-filen innehåller fyra filer som du kommer att använda under resten av denna guide:

• I_GC100.xml – Uppdateringsfil för GC100-insticksprogrammet
• D_Bose_Sounddock.xml – Enhetsbeskrivningsfil ('Description', baserad på Bose Sounddock 2)
• I_Bose_Sounddock.xml – Enhetsimplementeringsfil ('Implementation')
• S_Bose_Sounddock.xml – Enhetstjänstfil ('Service')

Steg 2 – Installera och konfigurera iTach/GC100-insticksprogrammet korrekt

Insticksprogrammet iTach/GC100 gör det möjligt att använda och konfigurera iTach IR-adaptern.

Installera GC100-insticksprogrammet

• I VERA UI, gå till fliken 'APPS' och 'Install Apps'
• Sök efter 'GC100'
• Installera appen, varpå den visas under fliken My Apps
• Under fliken DEVICES ser du en ny GC100-enhet
• Klicka på enhetens skiftnyckelsikon ('Wrench') och gå till fliken 'Advanced'
• Ange iTach IP-adressen (se APNT-65 - iTach Basic Configuration and Learning)
• Stäng enhetsfönstret och klicka på den röda knappen 'SAVE'
• Du bör nu se GC100-enheten under VERA:s flik DEVICES

Figur 1: Lägga till iTach IP-adressen i GC100-pluginenheten

GC100-insticksprogram – känt problem

Det finns ett känt problem med GC100-insticksprogrammet – det skickar IR-kommandon två gånger.

Detta åtgärdas enkelt genom att ladda upp en korrigerad implementeringsfil.

• Gå till 'APPS' > 'Develop Apps'
• Klicka på 'LUUP Files' i vänster sidofält
• Klicka på knappen 'Choose File' och välj filen I_GC100.xml (ingår i Vesternet iTach-ZIP-filen)
• Klicka på 'Go'
• När uppladdningen är klar behöver du starta om Luup
• Gå till SETUP > Net & Wi-fi och klicka på 'Reboot'
• Låt VERA starta om
• Du har nu ett korrekt konfigurerat och fungerande GC100-insticksprogram

Figur 2: Konfigurerat GC100-plugin

Steg 3 – Skapa och ladda upp enhetsfiler

För att skapa en IR-styrbar enhet i VERA måste vi först skapa och redigera enhetens kontrollfiler.

Detta exempel baseras på en uppsättning filer som jag skapade för en Bose Sounddock. Denna guide visar de delar av XML-filerna som du behöver ändra för din apparat.

• Extrahera .xml-filerna från Vesternet iTach ZIP-filen
• Byt namn på dem så att du känner igen enheten de avser – till exempel ”XYZ”, ”Yamaha RX675” etc.
• Du kan använda vilket namn du vill – under resten av denna guide kommer jag att referera till filerna med namnet Bose_SoundDock.

Redigera tjänsten (S_-filen)

Filen S_Bose_SoundDock.xml är ”Service”-filen för IR-enheten, den styr apparatens åtgärder. I detta fall definierar vi de IR-åtgärder som kan utlösas av iTach IR-kommandona.

• Öppna filen S_Bose_SoundDock.xml i en text- eller HTML-redigerare
• Du kommer att se en < actionList >-tagg på rad 7, och under den ett antal < action >-taggar
• Dessa refererar till liknande < action >-taggar i I_Bose_SoundDock.xml som innehåller de faktiska IR-koderna för att styra apparaten
• I filen S_Bose_SoundDock.xml redigerar du dessa namn, tar bort de du inte behöver eller lägger till nya
• För detta exempel behövde jag bara två kontroller för SoundDock – Bose Play och Bose Off
• Kom ihåg att spara ändringarna när du är klar
• Den slutgiltiga S_Bose_SoundDock.xml-filen visas i Figur 3

Figur 3: S_Bose_SoundDock.xml-enhetsfil

Redigera implementeringen (I_-filen)

Filen I_Bose_SoundDock.xml är ”Implementation”-filen för IR-enheten; den innehåller de åtgärder och IR-koder som styr apparaten.

• Öppna filen I_Bose_SoundDock.xml i en text- eller HTML-redigerare
• Du kommer att se en < actionList >-tagg på rad 3, och under den ett antal < action >-taggar
• Dessa innehåller de IR-koder som sänds när du aktiverar respektive åtgärd
• Byt namn på < serviceId > till ett som relaterar till apparaten – < serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock< /serviceId >
• Obs: samma < serviceId > används för alla åtgärder i filen I_Bose_SoundDock.xml
• Redigera taggen < name > så att den matchar åtgärdens beskrivning – < name >Bose Play < /name >

Det är förmodligen klokt att lägga till en åtgärd och IR-kod samt testa den i VERA innan du slutför hela filen I_SoundDock.xml.

Figur 4: I_Bose_SoundDock.xml-enhetsfil med IR-kod markerad

Redigera beskrivningen (D_-filen)

Filen D_Bose_SoundDock.xml är ”Beskrivningsfilen” (Description) för IR-enheten; den innehåller all information för IR-enheten. Du behöver lägga till de huvudsakliga enhetsbeskrivningarna samt länkar till implementerings- och tjänstefilerna.

Steg 4 – Skapa IR-apparatenheten

Du kan nu skapa en VERA-enhet som använder filerna du just har skapat. Denna enhet blir en ”virtuell enhet” av den fysiska apparaten, och du kommer att kunna styra dess funktioner från VERA-scener.

• Gå till ”APPS” > ”Develop Apps”
• Klicka på ”Create Device” i det vänstra sidofältet
• Ange filnamnet ”D_Bose_SoundDock.xml” i fältet Upnp Device Filename
• Klicka på ”Create Device”

Figur 6: Skapa IR-enheten i VERA

• Den nya enheten kommer att visas under fliken DEVICES, men den har ännu inte konfigurerats fullständigt
• Klicka på VERAs blå knapp ”RELOAD” (högst upp på sidan) och vänta på att VERA laddas om
• Enheten bör nu ha det ”friendlyName” som du valde i filen ”Device Description”
• Under enhetens Advanced-flik ska den ha korrekt Description-fil (D_Bose_SoundDock.xml) och enhetstyp (urn:schemas-micasaverde-com:device:IrDevice:1)
• Om dessa fält inte är ifyllda – klicka på knappen ”RELOAD” igen och vänta på att VERA laddas om
• Det sista steget är att konfigurera enheten med rätt iTach IR-port – iTach har tre IR-portar; i detta exempel används IR Blaster (port 3) – se APNT-65 - Grundläggande konfiguration och inlärning för iTach
• Gå till enhetens flik ”Settings” och välj rätt port i rullgardinsmenyn
• Stäng enheten och klicka på den röda knappen ”SAVE” (högst upp på sidan)
• När VERA har laddats om klart bör enheten vara redo för testning

Figur 6: Välj rätt IR-port för apparatenheten

Steg 5 – Testa IR-apparatenheten

Nu är det dags att testa den nya enheten och kontrollera att den fungerar korrekt.

• I din webbläsare, ange http://VERAs_IP_address:3480/data_request?id=lu_invoke – ersätt ”VERAs_IP_address” med din VERA-IP-adress
• Klicka på apparatenheten i listan – i mitt fall var det exempelvis #200 Bose SoundDock
• Detta visar en lista över tillgängliga kommandon
• Säkerställ att iTachs IR-blaster/sändare är placerad framför apparaten
• Klicka på en av åtgärderna i webbläsaren – detta bör få apparaten att utföra åtgärden
• Om det inte fungerar korrekt, kontrollera enhetsfilerna, korrigera dem och ladda upp dem på nytt

Figur 7: Webbläsare som visar en lista över tillgängliga åtgärder för IR-enheten

Steg 6 – Använd IR-apparatenheten i scener

Nu när enhetens åtgärder fungerar korrekt via iTach kan du använda VERA-scener för att styra apparatens funktioner.

För att göra detta behöver du använda VERAs Advanced Scene-flik

• Skapa en ny scen – se APNT-34: Skapa scener i VERA
• Gå till scenens flik 'Advanced'
• Välj IR Appliance-enheten i rullgardinsmenyn 'Pick a device'
• Klicka på 'Add'
• Enheten har nu lagts till i scenen
• Välj åtgärd i rullgardinsmenyn 'Please select' bredvid enheten
• Klicka på den gröna knappen 'Confirm changes' (längst upp på sidan)
• Klicka på den röda knappen 'SAVE' (längst upp på sidan)
• Du har nu en scen som kan triggas, schemaläggas eller köras manuellt för att styra en eller flera funktioner hos apparaten

Figur 8: Använda IR-enheten i en scen

Detta är en ganska omfattande guide. Men när du väl har gjort detta en gång kommer allt att falla på plats, och du kommer att kunna konfigurera nästa iTach-styrda enhet betydligt snabbare.

Referens

Denna applikationsnotis baseras på tester utförda av Vesternet samt ett flertal användbara foruminlägg från användare på VERA Forum, med ett särskilt tack till forummedlemmarna 'a-lurker' och 'konradwalsh'.

Relaterad information

• APNT-65: Grundläggande konfiguration och inlärning för iTach
• APNT-66: Använda iTach med Fibaro Home Center
• APNT-34: Skapa VERA-scener
• APNT-35: Styra VERA-scener med en trigger
• APNT-36: Schemalägga VERA-scener
• KB-35: Skillnaden mellan iTach Emitter- och Blaster-kablar
• KB-36: Information om iTach API
• Global Cache – Nedladdningar och dokument

iTach IR-adaptrar är idealiska för att styra apparater såsom AV-utrustning (TV, Blu-Ray, hemmabio) och alla enheter som kan kontrolleras via infraröda (IR) kommandon – även luftkonditioneringsaggregat.

Denna guide visar hur iTach-adaptrar används tillsammans med Z-Wave-kontrollerna VERA Lite och VERA3 som kör UI5.

Använda iTach med VERA

För att VERA ska kunna kommunicera med iTach-enheterna behöver vi ladda ner en VERA-plugin och därefter skapa enhetsfiler för varje IR-apparat som iTach ska styra.

Denna guide visar hur du:

• Laddar ner och konfigurerar VERA iTach (GC100)-pluginen korrekt
• Skapar enhetsfilerna för varje apparat som ska styras
• Lägger till iTach IR-kontrollsträngar i enhetsfilerna
• Skapar en VERA-enhet för apparaten
• Styr apparatens funktioner via VERA-scener

Steg 1 – Ladda ner filer

För att kunna installera plugin-programmet VERA iTach (GC100) och använda iTach-enheterna behöver du ett antal filer. Vi har gjort det enkelt och samlat dem i en enda ZIP-fil som du kan ladda ner.

Så innan du gör något annat, ladda ner Vesternet iTach Zip-filen:

Vesternet iTach Files v2.0 (ZIP)

ZIP-filen innehåller fyra filer som du kommer att använda under resten av denna guide:

• I_GC100.xml – Uppdateringsfil för plugin-programmet GC100
• D_Bose_Sounddock.xml – Enhetsbeskrivningsfil (”Description”, baserad på Bose Sounddock 2)
• I_Bose_Sounddock.xml – Enhetsimplementeringsfil (”Implementation”)
• S_Bose_Sounddock.xml – Enhetstjänstfil (”Service”)

Steg 2 – Installera och konfigurera iTach/GC100-plugin-programmet korrekt

Plugin-programmet iTach/GC100 gör det möjligt att använda och konfigurera iTach IR-adaptern.

Installera GC100-plugin-programmet

• I VERA-användargränssnittet, gå till fliken ”APPS” och välj ”Install Apps”
• Sök efter ”GC100”
• Installera appen, så visas den därefter under fliken My Apps
• Under fliken DEVICES visas en ny GC100-enhet
• Klicka på enhetens skiftnyckelsikon (”Wrench”) och gå till fliken ”Advanced”
• Ange iTach IP-adressen (se APNT-65 - iTach Basic Configuration and Learning)
• Stäng enhetsfönstret och klicka på den röda ”SAVE”-knappen
• Du bör nu se GC100-enheten under fliken DEVICES i VERA

Figur 1: Lägga till iTach IP-adressen till GC100-plugin-enheten

GC100-plugin – Känt problem

Det finns ett känt problem med GC100-plugin-programmet – det skickar IR-kommandon två gånger.

Detta åtgärdas enkelt genom att ladda upp en korrigerad implementeringsfil.

• Gå till ”APPS” > ”Develop Apps”
• I sidofältet till vänster klickar du på ”LUUP Files”
• Klicka på knappen ”Choose File” och välj filen I_GC100.xml (ingår i Vesternet iTach ZIP-filen)
• Klicka på ”Go”
• När uppladdningen är klar måste du starta om Luup
• Gå till SETUP > Net & Wi-fi och klicka på ”Reboot”
• Låt VERA starta om
• Du har nu ett korrekt konfigurerat och fungerande GC100-plugin-program

Figur 2: Konfigurerat GC100-plugin

Steg 3 – Skapa och ladda upp enhetsfiler

För att skapa en IR-styrbar enhet i VERA måste vi först skapa och redigera enhetens kontrollfiler.

Detta exempel baseras på en uppsättning filer som skapats för en Bose Sounddock; denna guide visar de delar av XML-filerna som du behöver ändra för din apparat.

• Extrahera .xml-filerna från Vesternet iTach ZIP-filen
• Byt namn på dem så att du känner igen vilken enhet de avser – till exempel ”XYZ”, ”Yamaha RX675” osv.
• Du kan använda vilket namn du vill – under resten av denna guide kommer filerna att refereras till med namnet Bose_SoundDock.

Redigera tjänstfilen (S_-filen)

Filen S_Bose_SoundDock.xml är ”Service”-filen för IR-enheten; den styr enhetens åtgärder. I det här fallet definierar vi de IR-åtgärder som kan utlösas av iTach IR-kommandona.

• Öppna filen S_Bose_SoundDock.xml i en text- eller HTML-redigerare
• Du ser en < actionList >-tagg på rad 7, och under den ett antal < action >-taggar
• Dessa refererar till liknande < action >-taggar i I_Bose_SoundDock.xml som innehåller de faktiska IR-koderna för att styra enheten
• Redigera dessa namn i filen S_Bose_SoundDock.xml, ta bort eventuella taggar du inte behöver eller lägg till nya
• I detta exempel behövde jag endast två kontroller för SoundDock – Bose Play och Bose Off
• Kom ihåg att spara ändringarna när du är klar
• Den slutliga filen S_Bose_SoundDock.xml visas i figur 3

Figur 3: S_Bose_SoundDock.xml enhetsfil

Redigera implementeringen (I_-filen)

Filen I_Bose_SoundDock.xml är ”Implementation”-filen för IR-enheten; den innehåller de åtgärder och IR-koder som styr enheten.

• Öppna filen I_Bose_SoundDock.xml i en text- eller HTML-redigerare
• Du ser en < actionList >-tagg på rad 3, och under den ett antal < action >-taggar
• Dessa innehåller de IR-koder som överförs när du aktiverar respektive åtgärd
• Byt namn på < serviceId > till ett som relaterar till enheten – < serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock< /serviceId >
• Obs! Samma < serviceId > används för samtliga åtgärder i filen I_Bose_SoundDock.xml
• Redigera taggen < name > så att den matchar åtgärdens beskrivning – < name >Bose Play < /name >

Det är oftast klokt att lägga till en åtgärd och IR-kod och testa den i VERA innan du slutför hela filen I_SoundDock.xml.

Figur 4: I_Bose_SoundDock.xml enhetsfil med markerad IR-kod

Redigera beskrivningen (D_-filen)

Filen D_Bose_SoundDock.xml är ”Description”-filen för IR-enheten; den innehåller all information för IR-enheten. Du behöver lägga till de huvudsakliga enhetsbeskrivningarna och länkar till implementerings- och servicefilerna.

Steg 4 – Skapa IR-apparatens enhet

Du kan nu skapa en VERA-enhet som använder filerna du nyss skapat. Denna enhet blir en "virtuell enhet" av den faktiska apparaten, och du kommer att kunna styra dess funktioner från VERA-scener.

• Gå till 'APPS' > 'Develop Apps'
• Klicka på 'Create Device' i det vänstra sidofältet
• Ange filnamnet 'D_Bose_SoundDock.xml' i rutan Upnp Device Filename
• Klicka på 'Create Device'

Figur 6: Skapa IR-enheten i VERA

• Den nya enheten kommer att finnas under fliken DEVICES, men den har ännu inte konfigurerats fullständigt
• Klicka på VERA:s blå knapp ”RELOAD” (längst upp på sidan) och vänta på att VERA laddas om
• Enheten bör nu ha det ”friendlyName” som du angav i filen ”Device Description”
• Under enhetens flik Advanced bör den ha korrekt Description-fil (D_Bose_SoundDock.xml) och enhetstyp (urn:schemas-micasaverde-com:device:IrDevice:1)
• Om dessa fält inte är ifyllda – klicka på knappen ”RELOAD” igen och vänta på att VERA laddas om
• Det sista steget är att konfigurera enheten med rätt iTach IR-port – iTach har tre IR-portar; i detta exempel används IR Blaster (port 3) – se APNT-65 – iTach Basic Configuration and Learning
• Gå till enhetens flik ”Settings” och välj rätt port i rullgardinsmenyn
• Stäng enhetsvyn och klicka på den röda knappen ”SAVE” (längst upp på sidan)
• När VERA har laddats om klart bör enheten vara redo för testning

Figur 6: Välj rätt IR-port för apparatenheten

Steg 5 – Testa IR-apparatenheten

Nu är det dags att testa den nya enheten och kontrollera att den fungerar korrekt.

• Ange http://VERAs_IP_address:3480/data_request?id=lu_invoke i din webbläsare – ersätt ”VERAs_IP_address” med din VERA-IP-adress
• Klicka på apparatenheten i listan – i mitt fall var det #200 Bose SoundDock
• Detta visar en lista över tillgängliga kommandon
• Säkerställ att iTach IR-blaster/emitter är placerad framför apparaten
• Klicka på en av åtgärderna i webbläsaren – detta bör få apparaten att utföra åtgärden
• Om det inte fungerar korrekt, kontrollera enhetsfilerna, korrigera dem och ladda upp dem igen

Figur 7: Webbläsare som visar en lista över tillgängliga åtgärder för IR-enheten

Steg 6 – Använd IR-apparatenheten i scener

Nu när enhetsåtgärderna fungerar korrekt via iTach kan du använda VERA-scener för att styra apparatens funktioner.

För att göra detta behöver du använda VERA:s flik Advanced Scene

• Skapa en ny scen – se APNT-34: Creating Scenes in VERA
• Gå till scenens flik ”Advanced”
• Välj IR-apparatenheten i rullgardinsmenyn ”Pick a device”
• Klicka på ”Add”
• Enheten har nu lagts till i scenen
• Välj åtgärd i rullgardinsmenyn ”Please select” bredvid enheten
• Klicka på den gröna knappen ”Confirm changes” (längst upp på sidan)
• Klicka på den röda knappen ”SAVE” (längst upp på sidan)
• Du har nu en scen som kan utlösas via trigger, schemaläggas eller köras manuellt för att styra apparatens åtgärd(er)

Figur 8: Användning av IR-enheten i en scen

Detta är en något längre guide. Men när du väl har gjort detta en gång kommer du att märka att allt är logiskt, och du kommer att kunna skapa nästa iTach-styrda enhet mycket snabbare.

Referens

Denna applikationsnotis baseras på tester utförda av Vesternet samt många användbara foruminlägg från användarna i VERA Forum, med ett särskilt tack till forummedlemmarna 'a-lurker' och 'konradwalsh'.

Relaterad information

• APNT-65: Grundläggande konfiguration och inlärning för iTach
• APNT-66: Använda iTach med Fibaro Home Center
• APNT-34: Skapa VERA-scener
• APNT-35: Styra VERA-scener med en trigger
• APNT-36: Styra VERA-scener med ett schema
• KB-35: Skillnad mellan iTach Emitter- och Blaster-kablar
• KB-36: iTach API-information
• Global Cache Downloads and Documents

Aktivera stöd för skärmläsare Tryck på Ctrl+Alt+Z om du vill aktivera skärmläsarstöd. Tryck på Ctrl+snedstreck om du vill veta mer om kortkommandon.