APNT-68 - Brug af iTach med VERA

iTach IR-adapterne er ideelle til styring af apparater som AV-udstyr (tv, Blu-Ray, hjemmebiograf) samt ethvert apparat, der kan styres via infrarøde (IR) kommandoer. Selv klimaanlæg.

Denne vejledning viser, hvordan du anvender iTach-adapterne sammen med VERA Lite og VERA3 Z-Wave-controllere, der kører UI5.

Brug af iTach med VERA

For at gøre det muligt for VERA at anvende iTach-enhederne skal vi downloade et VERA-plugin og derefter oprette enhedsfiler for hvert IR-apparat, som iTach skal styre.

Denne vejledning viser dig, hvordan du:

• Downloader og konfigurerer VERA iTach-pluginnet (GC100) korrekt
• Opretter enhedsfilerne for hvert apparat, der skal styres
• Tilføjer iTach IR-kontrolstrengene til enhedsfilerne
• Opretter en VERA-enhed for apparatet
• Styrer apparatets funktioner fra VERA-scener

Trin 1 – Download filer

For at installere VERA iTach-pluginnet (GC100) korrekt og anvende iTach-enhederne skal du bruge en række filer. Vi har gjort det nemt og samlet dem i en enkelt ZIP-fil, som du kan downloade.

Så før du gør andet, skal du downloade Vesternet iTach-zip-filen:

Vesternet iTach Files v2.0 (ZIP)

ZIP-filen indeholder fire filer, som du vil bruge i resten af denne vejledning:

• I_GC100.xml – GC100-plugin-opdateringsfil
• D_Bose_Sounddock.xml – Enhedsbeskrivelsesfil ('Description', baseret på Bose Sounddock 2)
• I_Bose_Sounddock.xml – Enhedsimplementeringsfil ('Implementation')
• S_Bose_Sounddock.xml – Enhedsservicefil ('Service')

Trin 2 – Installer og konfigurer iTach/GC100-pluginnet korrekt

iTach/GC100-pluginnet gør det muligt at anvende og konfigurere iTach IR-adapteren.

Installer GC100-pluginnet

• I VERA UI går du til fanen 'APPS' og vælger 'Install Apps'
• Søg efter 'GC100'
• Installer appen; den vil derefter blive vist under fanen My Apps
• Under fanen DEVICES vil du se en ny GC100-enhed
• Klik på enhedens skruenøgle-ikon og gå til fanen 'Advanced'
• Indtast iTach IP-adressen (se APNT-65 - iTach Basic Configuration and Learning)
• Luk enhedsvinduet og klik på den røde 'SAVE'-knap
• Du bør nu kunne se GC100-enheden under VERAs fane DEVICES

Figur 1: Tilføjelse af iTach IP-adressen til GC100-plugin-enheden

GC100-plugin – Kendt problem

Der er et kendt problem med GC100-pluginnet – det sender IR-kommandoer to gange.

Dette kan nemt rettes ved at uploade en korrigeret 'implementation'-fil.

• Gå til 'APPS' > 'Develop Apps'
• I venstre sidepanel klikkes på 'LUUP Files'
• Klik på knappen 'Choose File' og vælg filen I_GC100.xml (indeholdt i Vesternet iTach-ZIP-filen)
• Klik på 'Go'
• Når uploaden er fuldført, skal du genstarte Luup
• Gå til SETUP > Net & Wi-fi og klik på 'Reboot'
• Lad VERA genstarte
• Du har nu et korrekt konfigureret og fungerende GC100-plugin

Figur 2: Konfigureret GC100-plugin

Trin 3 – Opret og upload enhedsfiler

For at oprette en IR-styrbar enhed i VERA skal vi først oprette og redigere enhedens kontrolfiler.

Dette eksempel er baseret på et sæt filer, jeg oprettede til en Bose Sounddock; denne vejledning viser de dele af XML-filerne, som du skal ændre til dit apparat.

• Udpak .xml-filerne fra Vesternet iTach-ZIP-filen
• Omdøb dem, så du kan genkende den enhed, de refererer til – for eksempel 'XYZ', 'Yamaha RX675' osv.
• Du kan bruge et hvilket som helst navn – i resten af denne vejledning vil jeg referere til filerne med navnet Bose_SoundDock.

Rediger Service (S_-filen)

Filen S_Bose_SoundDock.xml er 'Service'-filen til IR-enheden; den styrer apparatets handlinger. I dette tilfælde definerer vi de IR-handlinger, der kan udløses af iTach IR-kommandoerne.

• Åbn filen S_Bose_SoundDock.xml i en tekst- eller HTML-editor
• Du vil se et < actionList >-tag på linje 7 og under dette en række < action >-tags
• Disse refererer til tilsvarende < action >-tags i I_Bose_SoundDock.xml, som indeholder de faktiske IR-koder til styring af apparatet
• I filen S_Bose_SoundDock.xml redigeres disse navne, slet eventuelle unødvendige eller tilføj nye
• Til dette eksempel havde jeg kun brug for to funktioner til SoundDock – Bose Play og Bose Off
• Husk at gemme ændringerne, når du er færdig
• Den færdige S_Bose_SoundDock.xml-fil er vist i Figur 3

Figur 3: S_Bose_SoundDock.xml-enhedsfil

Rediger Implementation (I_-filen)

Filen I_Bose_SoundDock.xml er 'Implementation'-filen til IR-enheden; den indeholder handlingerne og IR-koderne, der styrer apparatet.

• Åbn filen I_Bose_SoundDock.xml i en tekst- eller HTML-editor
• Du vil se et < actionList >-tag på linje 3 og under dette en række < action >-tags
• Disse indeholder de IR-koder, der sendes, når du aktiverer hver enkelt handling
• Omdøb < serviceId > til et, der relaterer sig til apparatet – < serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock< /serviceId >
• Bemærk: Det samme < serviceId > anvendes til alle handlinger i filen I_Bose_SoundDock.xml
• Rediger tagget < name >, så det svarer til handlingens beskrivelse – < name >Bose Play < /name >

Det er en fordel at tilføje én handling og IR-kode og teste den i VERA, før hele I_SoundDock.xml-filen færdiggøres.

Figur 4: I_Bose_SoundDock.xml-enhedsfil med fremhævet IR-kode

Rediger beskrivelsen (D_-filen)

Filen D_Bose_SoundDock.xml er 'Description'-filen (beskrivelsesfilen) til IR-enheden; den indeholder alle oplysninger om IR-enheden. Du skal tilføje de primære enhedsbeskrivelser og links til implementations- og servicefilerne.

Trin 4 – Opret IR-apparat-enheden

Du kan nu oprette en VERA-enhed, der vil anvende de filer, du netop har oprettet. Denne enhed vil være en 'virtuel enhed' for det fysiske apparat, og du vil kunne styre dens funktioner fra VERA-scener.

• Gå til 'APPS' > 'Develop Apps'
• I sidepanelet til venstre klikkes på 'Create Device'
• Indtast filnavnet 'D_Bose_SoundDock.xml' i feltet Upnp Device Filename
• Klik på 'Create Device'

Figur 6: Opret IR-enheden i VERA

• Den nye enhed vises under fanen DEVICES, men er endnu ikke fuldt konfigureret
• Klik på VERA's blå knap 'RELOAD' (øverst på siden), og vent på, at VERA genindlæser
• Enheden bør nu have det 'friendlyName', du valgte i filen 'Device Description'
• Under enhedens fane Advanced bør den korrekte Description-fil (D_Bose_SoundDock.xml) og enhedstype (urn:schemas-micasaverde-com:device:IrDevice:1) fremgå
• Hvis disse felter ikke er udfyldt, klikkes igen på knappen 'RELOAD', hvorefter der ventes på, at VERA genindlæser
• Det sidste trin er at konfigurere enheden med den korrekte iTach-IR-port – iTach har tre IR-porte, og i dette eksempel anvendes IR Blaster (port 3) – se APNT-65 - iTach Basic Configuration and Learning
• Gå til enhedens fane 'Settings', og vælg den korrekte port fra rullemenuen
• Luk enheden, og klik på den røde knap 'SAVE' (øverst på siden)
• Når VERA er færdig med at genindlæse, bør enheden være klar til test

Figur 6: Vælg den korrekte IR-port til apparatenheden

Trin 5 – Test IR-apparatenheden

Nu skal den nye enhed testes for at verificere, at den fungerer korrekt.

• Indtast http://VERAs_IP_address:3480/data_request?id=lu_invoke i din browser – erstat 'VERAs_IP_address' med din VERA-IP-adresse
• Klik på apparatenheden på listen – for eksempel hed min #200 Bose SoundDock
• Dette viser en liste over tilgængelige kommandoer
• Sørg for, at iTach'ens IR-blaster/-emitter er placeret foran apparatet
• Klik på en af handlingerne i browseren – dette bør få apparatet til at udføre handlingen
• Hvis det ikke fungerer korrekt, skal enhedsfilerne kontrolleres, rettes og uploades igen

Figur 7: Browser, der viser en liste over tilgængelige handlinger for IR-enheden

Trin 6 – Anvend IR-apparatenheden i scener

Nu hvor enhedshandlingerne fungerer korrekt via iTach, kan VERA-scener anvendes til at styre apparatets funktioner.

For at gøre dette skal fanen Advanced Scene i VERA anvendes

• Opret en ny scene – se APNT-34: Creating Scenes in VERA
• Gå til scenens faneblad 'Advanced'
• Vælg IR Appliance-enheden i rullemenuen 'Pick a device'
• Klik på 'Add'
• Enheden er nu tilføjet til scenen
• Vælg handlingen i rullemenuen 'Please select' ud for enheden
• Klik på den grønne knap 'Confirm changes' (øverst på siden)
• Klik på den røde knap 'SAVE' (øverst på siden)
• Du har nu en scene, der kan udløses, tidsplanlægges eller køres manuelt for at styre én eller flere af apparatets handlinger

Figur 8: Anvendelse af IR-enheden i en scene

Dette er en forholdsvis omfattende vejledning. Når du først har udført processen én gang, vil det hele dog give god mening, og du vil kunne opsætte den næste iTach-styrede enhed væsentligt hurtigere.

Reference

Denne applikationsnote er baseret på test udført af Vesternet samt adskillige nyttige forumposter fra brugere på VERA Forum, med en særlig tak til forummedlemmerne 'a-lurker' og 'konradwalsh'.

Relaterede oplysninger

• 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

iTach IR adaptors er ideelle til styring af udstyr som f.eks. AV-apparater (tv, Blu-ray, hjemmebiograf) samt ethvert apparat, der kan styres via infrarøde (IR) kommandoer – herunder også klimaanlæg.

Denne vejledning viser, hvordan iTach-adapterne anvendes sammen med VERA Lite og VERA3 Z-Wave-controllere, der kører UI5.

Anvendelse af iTach med VERA

For at gøre VERA i stand til at anvende iTach-enhederne er det nødvendigt at downloade et VERA-plugin og derefter oprette enhedsfiler for hvert enkelt IR-apparat, som iTach skal styre.

Denne vejledning gennemgår, hvordan du:

• Downloader og konfigurerer VERA iTach-pluginet (GC100) korrekt
• Opretter enhedsfilerne for hvert apparat, der skal styres
• Tilføjer iTach IR-kontrolstrengene til enhedsfilerne
• Opretter en VERA-enhed for apparatet
• Styrer apparatets funktioner fra VERA-scener

Trin 1 - Download filer

For at installere VERA iTach (GC100)-pluginet korrekt og anvende iTach-enhederne skal du bruge en række filer. Vi har gjort det nemt og samlet dem i en enkelt ZIP-fil, som du kan downloade.

Før du foretager dig andet, skal du downloade Vesternet iTach-zip-filen:

Vesternet iTach Files v2.0 (ZIP)

ZIP-filen indeholder fire filer, som du skal bruge i resten af denne vejledning:

• I_GC100.xml - GC100-plugin-opdateringsfil
• D_Bose_Sounddock.xml - Enheds-'beskrivelsesfil' (baseret på Bose Sounddock 2)
• I_Bose_Sounddock.xml - Enheds-'implementeringsfil'
• S_Bose_Sounddock.xml - Enheds-'tjenestefil'

Trin 2 - Installer og konfigurer iTach/GC100-pluginet korrekt

iTach/GC100-pluginet gør det muligt at anvende og konfigurere iTach IR-adapteren.

Installer GC100-pluginet

• I VERA UI gå til fanen 'APPS' og 'Install Apps'
• Søg efter 'GC100'
• Installer appen; den vil derefter blive vist under fanen My Apps
• Under fanen DEVICES vises en ny GC100-enhed
• Klik på enhedens 'Skruenøgle'-ikon, og gå til fanen 'Advanced'
• Indtast iTach IP-adressen (se APNT-65 - iTach Basic Configuration and Learning)
• Luk enhedsvinduet, og klik på den røde knap 'SAVE'
• Du bør nu kunne se GC100-enheden under fanen DEVICES i VERA

Figur 1: Tilføjelse af iTach IP-adressen til GC100 Plugin-enheden

GC100-plugin - Kendt problem

Der er et kendt problem med GC100-pluginet - det sender IR-kommandoer to gange.

Dette løses nemt ved at uploade en korrigeret 'implementeringsfil'.

• Gå til 'APPS' > 'Develop Apps'
• I sidepanelet til venstre klikkes på 'LUUP Files'
• Klik på knappen 'Choose File', og vælg filen I_GC100.xml (inkluderet i Vesternet iTach-ZIP-filen)
• Klik på 'Go'
• Når overførslen er fuldført, skal Luup genstartes
• Gå til SETUP > Net & Wi-fi, og klik på 'Reboot'
• Lad VERA genstarte
• Du har nu et korrekt konfigureret og fungerende GC100-plugin

Figur 2: Konfigureret GC100-plugin

Trin 3 - Opret og upload enhedsfiler

For at oprette en IR-styret enhed i VERA skal vi først oprette og redigere enhedens kontrolfiler.

Dette eksempel er baseret på et sæt filer, der er oprettet til en Bose Sounddock; denne vejledning viser de dele af XML-filerne, som skal tilpasses til det pågældende apparat.

• Udpak .xml-filerne fra Vesternet iTach-ZIP-filen
• Omdøb dem, så den tilknyttede enhed let kan identificeres - for eksempel 'XYZ', 'Yamaha RX675' osv.
• Et vilkårligt navn kan benyttes - i resten af denne vejledning omtales filerne med navnet Bose_SoundDock.

Rediger tjenesten (S_-filen)

Filen S_Bose_SoundDock.xml er 'Service'-filen til IR-enheden; den styrer apparatets handlinger. I dette tilfælde definerer vi de IR-handlinger, der kan udløses af iTach IR-kommandoerne.

• Åbn filen S_Bose_SoundDock.xml i en tekst- eller HTML-editor
• Du vil se et < actionList >-tag på linje 7 og derunder en række < action >-tags
• Disse refererer til tilsvarende < action >-tags i I_Bose_SoundDock.xml, som indeholder de faktiske IR-koder til styring af apparatet
• Rediger disse navne i filen S_Bose_SoundDock.xml, slet eventuelle unødvendige koder, eller tilføj nye
• I dette eksempel var der kun brug for to funktioner til SoundDock – Bose Play og Bose Off
• Husk at gemme ændringerne, når du er færdig
• Den færdige S_Bose_SoundDock.xml-fil er vist i figur 3

Figur 3: S_Bose_SoundDock.xml-enhedsfil

Rediger implementeringen (I_-filen)

Filen I_Bose_SoundDock.xml er 'Implementation'-filen til IR-enheden; den indeholder handlingerne og IR-koderne, der styrer apparatet.

• Åbn filen I_Bose_SoundDock.xml i en tekst- eller HTML-editor
• Du vil se et < actionList >-tag på linje 3 og derunder en række < action >-tags
• Disse indeholder de IR-koder, der transmitteres, når du aktiverer hver handling
• Omdøb < serviceId > til en værdi, der relaterer sig til apparatet – < serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock< /serviceId >
• Bemærk: Det samme < serviceId > anvendes til alle handlinger i filen I_Bose_SoundDock.xml
• Rediger < name >-tagget, så det matcher handlingens beskrivelse – < name >Bose Play < /name >

Det er en fordel at tilføje én handling og IR-kode ad gangen og teste den i VERA, før hele I_SoundDock.xml-filen færdiggøres.

Figur 4: I_Bose_SoundDock.xml-enhedsfil med fremhævet IR-kode

Rediger beskrivelsen (D_-filen)

Filen D_Bose_SoundDock.xml er 'Description'-filen til IR-enheden; den indeholder alle oplysninger om IR-enheden. Du skal tilføje de primære enhedsbeskrivelser samt links til Implementation- og Service-filerne.

Trin 4 - Opret IR-apparat-enheden

Du kan nu oprette en VERA-enhed, der vil anvende de filer, du netop har oprettet. Denne enhed vil være en 'virtuel enhed' af det virkelige apparat, og du vil kunne styre dens funktioner fra VERA-scener.

• Gå til 'APPS' > 'Develop Apps'
• Klik på 'Create Device' i sidepanelet til venstre
• Indtast filnavnet 'D_Bose_SoundDock.xml' i feltet Upnp Device Filename
• Klik på 'Create Device'

Figur 6: Opret IR-enheden i VERA

• Den nye enhed vil findes under fanen DEVICES, men den vil endnu ikke være fuldt konfigureret
• Klik på VERAs blå 'RELOAD'-knap (øverst på siden) og vent på, at VERA genindlæser
• Enheden bør nu have det 'friendlyName', du valgte i filen 'Device Description'
• I enhedens Advanced-fane bør den have den korrekte Description-fil (D_Bose_SoundDock.xml) og enhedstype (urn:schemas-micasaverde-com:device:IrDevice:1)
• Hvis disse felter ikke er udfyldt – klik på 'RELOAD'-knappen igen og vent på, at VERA genindlæser
• Det sidste trin er at konfigurere enheden med den korrekte iTach IR-port – iTach har tre IR-porte, og i dette eksempel bruger jeg IR Blasteren (port 3) – se APNT-65 - Grundlæggende konfiguration og indlæring for iTach
• Gå til enhedens fane 'Settings', og vælg den korrekte port fra rullemenuen
• Luk enheden, og klik på den røde 'SAVE'-knap (øverst på siden)
• Når VERA er færdig med at genindlæse, bør enheden være klar til test

Figur 6: Vælg den korrekte IR-port til apparatenheden

Trin 5 - Test IR-apparatenheden

Nu er det tid til at teste den nye enhed og kontrollere, at den fungerer korrekt.

• I din browser indtaster du http://VERAs_IP_address:3480/data_request?id=lu_invoke – erstat 'VERAs_IP_address' med din VERA IP-adresse
• Klik på apparatenheden på listen – i mit tilfælde var det for eksempel #200 Bose SoundDock
• Dette viser en liste over tilgængelige kommandoer
• Sørg for, at iTachs IR-blaster/emitter er placeret foran apparatet
• Klik på en af handlingerne i browseren – dette bør få apparatet til at udføre den pågældende handling
• Hvis det ikke fungerer korrekt, skal du kontrollere enhedsfilerne, rette dem og uploade dem igen

Figur 7: Browser, der viser en liste over tilgængelige handlinger for IR-enheden

Trin 6 - Brug IR-apparatenheden i scener

Nu hvor enhedshandlingerne fungerer korrekt via iTach, kan du bruge VERA-scener til at styre apparatets funktioner.

For at gøre dette skal du bruge VERAs Advanced Scene-fane

• Opret en ny scene – se APNT-34: Oprettelse af scener i VERA
• Gå til scenens fane 'Advanced'
• Vælg IR-apparatenheden i rullemenuen 'Pick a device'
• Klik på 'Add'
• Enheden er nu blevet tilføjet til scenen
• Vælg handlingen fra rullemenuen 'Please select' ud for enheden
• Klik på den grønne 'Confirm changes'-knap (øverst på siden)
• Klik på den røde 'SAVE'-knap (øverst på siden)
• Du har nu en scene, der kan udløses, tidsplanlægges eller køres manuelt til at styre en eller flere handlinger på apparatet

Figur 8: Anvendelse af IR-enheden i en scene

Dette er en lidt lang vejledning. Men når du først har prøvet det én gang, vil du opdage, at det hele giver god mening, og du vil være i stand til at konfigurere den næste iTach-styrede enhed væsentligt hurtigere.

Reference

Denne applikationsnote er baseret på test udført af Vesternet samt adskillige nyttige forumindlæg fra brugere på VERA Forum, med en særlig tak til forummedlemmerne 'a-lurker' og ''konradwalsh'.

Relaterede oplysninger

• 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

Aktivér understøttelse af skærmlæser Tryk på Ctrl+Alt+Z for at aktivere understøttelse af skærmlæser. Tryk på Ctrl+skråstreg for at få mere at vide om tastaturgenveje