APNT-68 - Utilizzo di iTach con VERA

Gli adattatori IR iTach sono ideali per controllare apparecchiature come dispositivi AV (TV, Blu-Ray, Home Cinema) e qualsiasi dispositivo gestibile tramite comandi a infrarossi (IR). Compresi i sistemi di climatizzazione.

Questa guida illustra come utilizzare gli adattatori iTach con i controller Z-Wave VERA Lite e VERA3 con UI5.

Utilizzo di iTach con VERA

Per consentire a VERA di utilizzare i dispositivi iTach, è necessario scaricare un plugin per VERA e creare quindi i file di dispositivo per ciascun apparecchio IR che iTach dovrà controllare.

Questa guida spiega come:

• Scaricare e configurare correttamente il plugin VERA iTach (GC100)
• Creare i file di dispositivo per ciascun apparecchio da controllare
• Aggiungere le stringhe di controllo IR iTach ai file di dispositivo
• Creare un dispositivo VERA per l'apparecchio
• Controllare le funzioni dell'apparecchio tramite gli scenari VERA

Passaggio 1 - Download dei file

Per installare correttamente il plugin VERA iTach (GC100) e utilizzare i dispositivi iTach, sono necessari diversi file. Per agevolare l'operazione, li abbiamo raccolti in un unico file ZIP da scaricare.

Prima di procedere con qualsiasi altra operazione, scaricare il file zip Vesternet iTach:

Vesternet iTach Files v2.0 (ZIP)

Il file ZIP contiene quattro file che verranno utilizzati nel corso della presente guida:

• I_GC100.xml - File di aggiornamento del plugin GC100
• D_Bose_Sounddock.xml - File di "descrizione" del dispositivo (basato su Bose Sounddock 2)
• I_Bose_Sounddock.xml - File di "implementazione" del dispositivo
• S_Bose_Sounddock.xml - File di "servizio" del dispositivo

Passaggio 2 - Installare e configurare correttamente il plugin iTach/GC100

Il plugin iTach/GC100 consente di utilizzare e configurare l'adattatore IR iTach.

Installazione del plugin GC100

• Nell'interfaccia utente di VERA, accedere alla scheda "APPS" e selezionare "Install Apps"
• Cercare "GC100"
• Installare l'applicazione, che comparirà nella scheda My Apps
• Nella scheda DEVICES verrà visualizzato un nuovo dispositivo GC100
• Fare clic sull'icona a forma di "chiave inglese" del dispositivo e passare alla scheda "Advanced"
• Inserire l'indirizzo IP di iTach (vedere APNT-65 - iTach Basic Configuration and Learning)
• Chiudere la finestra del dispositivo e fare clic sul pulsante rosso "SAVE"
• Il dispositivo GC100 dovrebbe ora essere visibile nella scheda DEVICES di VERA

Figura 1: Aggiunta dell'indirizzo IP di iTach al dispositivo con plugin GC100

Plugin GC100 - Problema noto

È presente un problema noto relativo al plugin GC100: invia i comandi IR due volte.

La risoluzione è semplice: è sufficiente caricare un file di "implementazione" corretto.

• Accedere a "APPS" > "Develop Apps"
• Nella barra laterale sinistra, fare clic su "LUUP Files"
• Fare clic sul pulsante "Choose File" e selezionare il file I_GC100.xml (incluso nel file ZIP Vesternet iTach)
• Fare clic su "Go"
• Al termine del caricamento, è necessario riavviare Luup
• Accedere a SETUP > Net & Wi-fi e fare clic su "Reboot"
• Attendere il riavvio di VERA
• Il plugin GC100 risulterà ora configurato correttamente e funzionante

Figura 2: Plugin GC100 configurato

Passo 3 - Creare e caricare i file del dispositivo

Per creare un dispositivo controllabile tramite IR in VERA, è prima necessario creare e modificare i file di controllo del dispositivo.

Questo esempio si basa su un set di file creati per un Bose SoundDock; questa guida mostra le sezioni dei file XML che sarà necessario modificare per il proprio apparecchio.

• Estrarre i file .xml dal file ZIP di Vesternet iTach
• Rinominarli in modo da riconoscere il dispositivo a cui si riferiscono, ad esempio "XYZ", "Yamaha RX675", ecc.
• È possibile utilizzare qualsiasi nome desiderato; per il resto di questa guida faremo riferimento ai file con il nome Bose_SoundDock.

Modificare il file di servizio (File S_)

Il file S_Bose_SoundDock.xml è il file di "Servizio" per il dispositivo IR e controlla le azioni dell'apparecchio. In questo caso definiremo le azioni IR che possono essere attivate dai comandi IR di iTach.

• Aprire il file S_Bose_SoundDock.xml in un editor di testo o HTML
• Alla riga 7 è presente un tag < actionList > e, al di sotto, una serie di tag < action >
• Questi fanno riferimento a tag < action > analoghi nel file I_Bose_SoundDock.xml, che contengono i codici IR effettivi per controllare l'apparecchio
• Nel file S_Bose_SoundDock.xml, modificare questi nomi, eliminare quelli non necessari o aggiungerne di nuovi
• Per questo esempio sono stati necessari solo due comandi per il SoundDock: Bose Play e Bose Off
• Ricordarsi di salvare le modifiche al termine
• Il file S_Bose_SoundDock.xml finale è mostrato nella Figura 3

Figura 3: File del dispositivo S_Bose_SoundDock.xml

Modificare il file di implementazione (File I_)

Il file I_Bose_SoundDock.xml è il file di "Implementazione" per il dispositivo IR e contiene le azioni e i codici IR che controlleranno l'apparecchio.

• Aprire il file I_Bose_SoundDock.xml in un editor di testo o HTML
• Alla riga 3 è presente un tag < actionList > e, al di sotto, una serie di tag < action >
• Questi contengono i codici IR che verranno trasmessi all'attivazione di ciascuna azione
• Rinominare il tag < serviceId > con un identificativo correlato all'apparecchio: < serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock< /serviceId >
• Nota: lo stesso < serviceId > viene utilizzato per tutte le azioni nel file I_Bose_SoundDock.xml
• Modificare il tag < name > in modo che corrisponda alla descrizione della relativa azione: < name >Bose Play < /name >

È consigliabile aggiungere una singola azione e il relativo codice IR ed eseguirne il test in VERA prima di completare l'intero file I_SoundDock.xml.

Figura 4: File dispositivo I_Bose_SoundDock.xml con codice IR evidenziato

Modificare la descrizione (file D_)

Il file D_Bose_SoundDock.xml è il file di "Descrizione" per il dispositivo IR e contiene tutte le informazioni relative al dispositivo IR. È necessario aggiungere le descrizioni principali del dispositivo e i collegamenti ai file di implementazione e di servizio.

Passaggio 4 - Creare il dispositivo apparecchio IR

È ora possibile creare un dispositivo VERA che utilizzerà i file appena creati. Questo dispositivo fungerà da "dispositivo virtuale" dell'apparecchio reale, consentendo di controllarne le funzioni tramite le scene di VERA.

• Accedere a 'APPS' > 'Develop Apps'
• Nella barra laterale sinistra fare clic su 'Create Device'
• Inserire il nome del file 'D_Bose_SoundDock.xml' nel campo Upnp Device Filename
• Fare clic su 'Create Device'

Figura 6: Creare il dispositivo IR in VERA

• Il nuovo dispositivo sarà presente nella scheda DEVICES, ma non risulterà ancora completamente configurato
• Fare clic sul pulsante blu 'RELOAD' di VERA (in alto nella pagina) e attendere il ricaricamento di VERA
• Il dispositivo dovrebbe ora presentare il 'friendlyName' definito nel file 'Device Description'
• Nella scheda Advanced del dispositivo devono risultare il file Description corretto (D_Bose_SoundDock.xml) e il tipo di dispositivo appropriato (urn:schemas-micasaverde-com:device:IrDevice:1)
• Se tali campi non risultano compilati, fare nuovamente clic sul pulsante 'RELOAD' e attendere il riavvio di VERA
• L'ultimo passaggio consiste nel configurare il dispositivo con la porta IR iTach corretta. iTach dispone di tre porte IR; per questo esempio viene utilizzato l'IR Blaster (porta 3) - fare riferimento a APNT-65 - Configurazione di base e apprendimento di iTach
• Accedere alla scheda 'Settings' del dispositivo e selezionare la porta appropriata dal menu a discesa
• Chiudere il dispositivo e fare clic sul pulsante rosso 'SAVE' (in alto nella pagina)
• Al termine del ricaricamento di VERA, il dispositivo sarà pronto per il test

Figura 6: Selezionare la porta IR corretta per il dispositivo appliance

Passaggio 5 - Testare il dispositivo appliance IR

È ora possibile procedere al collaudo del nuovo dispositivo per verificarne il corretto funzionamento.

• Nel browser, inserire l'indirizzo http://indirizzo_IP_VERA:3480/data_request?id=lu_invoke - sostituendo 'indirizzo_IP_VERA' con l'effettivo indirizzo IP del proprio VERA
• Selezionare il dispositivo appliance dall'elenco - ad esempio #200 Bose SoundDock
• Verrà visualizzato l'elenco dei comandi disponibili
• Assicurarsi che l'emettitore/blaster IR di iTach sia posizionato di fronte all'apparecchio
• Fare clic su una delle azioni nel browser: l'apparecchio dovrebbe eseguire il comando corrispondente
• In caso di malfunzionamento, verificare i file del dispositivo, apportare le correzioni necessarie e caricarli nuovamente

Figura 7: Finestra del browser che mostra l'elenco delle azioni disponibili per il dispositivo IR

Passaggio 6 - Utilizzare il dispositivo appliance IR nelle scene

Una volta confermata la corretta esecuzione delle azioni del dispositivo tramite iTach, è possibile configurare le scene di VERA per automatizzare il controllo dell'apparecchio.

A tale scopo, è necessario accedere alla scheda Advanced Scene di VERA.

• Creare una nuova scena - consultare APNT-34: Creazione di scene in VERA
• Accedere alla scheda 'Advanced' della scena
• Selezionare il dispositivo IR Appliance dal menu a discesa 'Pick a device'
• Fare clic su 'Add'
• Il dispositivo risulterà ora aggiunto alla scena
• Selezionare l'azione dal menu a discesa 'Please select' accanto al dispositivo
• Fare clic sul pulsante verde 'Confirm changes' (in alto nella pagina)
• Fare clic sul pulsante rosso 'SAVE' (in alto nella pagina)
• A questo punto la scena è pronta per essere attivata mediante trigger, programmata o eseguita manualmente per controllare una o più azioni dell'apparecchio

Figura 8: Utilizzo del dispositivo IR in una scena

Si tratta di una guida piuttosto articolata. Tuttavia, una volta completata la procedura la prima volta, tutti i passaggi risulteranno chiari e sarà possibile configurare il successivo dispositivo controllato tramite iTach molto più rapidamente.

Riferimenti

Questa nota applicativa si basa sui test condotti da Vesternet e sui numerosi e utili post pubblicati dagli utenti del VERA Forum, con un ringraziamento particolare ai membri del forum 'a-lurker' e 'konradwalsh'.

Informazioni correlate

• APNT-65: Configurazione di base e apprendimento di iTach
• APNT-66: Utilizzo di iTach con Fibaro Home Center
• APNT-34: Creazione di scene VERA
• APNT-35: Controllo delle scene VERA mediante trigger
• APNT-36: Controllo delle scene VERA mediante programmazione
• KB-35: Differenza tra i cavi emitter e blaster iTach
• KB-36: Informazioni sulle API iTach
• Download e documentazione Global Cache

Gli adattatori IR iTach sono ideali per il controllo di apparecchiature quali dispositivi AV (TV, Blu-Ray, Home Cinema) e qualsiasi dispositivo gestibile tramite comandi a infrarossi (IR), inclusi i sistemi di climatizzazione.

Questa guida illustra come utilizzare gli adattatori iTach con i controller Z-Wave VERA Lite e VERA3 dotati di interfaccia UI5.

Utilizzo di iTach con VERA

Per consentire a VERA di interfacciarsi con i dispositivi iTach, è necessario scaricare un plugin VERA e successivamente creare i file di dispositivo per ciascun apparecchio IR che iTach dovrà gestire.

Questa guida illustra come:

• Scaricare e configurare correttamente il plugin VERA iTach (GC100)
• Creare i file di dispositivo per ciascun apparecchio da controllare
• Aggiungere le stringhe di controllo IR di iTach ai file di dispositivo
• Creare un dispositivo VERA dedicato all'apparecchio
• Controllare le funzioni dell'apparecchio mediante le scene di VERA

Passaggio 1 - Scaricare i file

Per installare correttamente il plugin VERA iTach (GC100) e utilizzare i dispositivi iTach sono necessari diversi file. Per agevolare l'operazione, sono stati raccolti in un unico file ZIP pronto per il download.

Prima di procedere con qualsiasi altra operazione, scaricare il file ZIP Vesternet iTach:

Vesternet iTach Files v2.0 (ZIP)

Il file ZIP include quattro file da utilizzare nel corso di questa guida:

• I_GC100.xml - File di aggiornamento del plugin GC100
• D_Bose_Sounddock.xml - File di "descrizione" del dispositivo (basato su Bose Sounddock 2)
• I_Bose_Sounddock.xml - File di "implementazione" del dispositivo
• S_Bose_Sounddock.xml - File di "servizio" del dispositivo

Passaggio 2 - Installare e configurare correttamente il plugin iTach/GC100

Il plugin iTach/GC100 consente di utilizzare e configurare l'adattatore IR iTach.

Installare il plugin GC100

• Nell'interfaccia utente di VERA, accedere alla scheda 'APPS' e selezionare 'Install Apps'
• Cercare 'GC100'
• Installare l'applicazione; comparirà quindi nella scheda My Apps
• Nella scheda DEVICES sarà visualizzato un nuovo dispositivo GC100
• Fare clic sull'icona della 'Chiave inglese' del dispositivo e accedere alla scheda 'Advanced'
• Inserire l'indirizzo IP dell'iTach (vedere APNT-65 - iTach Basic Configuration and Learning)
• Chiudere la finestra del dispositivo e fare clic sul pulsante rosso 'SAVE'
• Il dispositivo GC100 dovrebbe ora comparire nella scheda DEVICES di VERA

Figura 1: Aggiunta dell'indirizzo IP di iTach al dispositivo con plugin GC100

Plugin GC100 - Problema noto

È presente un problema noto con il plugin GC100: invia i comandi IR due volte.

La risoluzione è semplice: è sufficiente caricare un file di "implementazione" corretto.

• Accedere a 'APPS' > 'Develop Apps'
• Nella barra laterale sinistra fare clic su 'LUUP Files'
• Fare clic sul pulsante 'Choose File' e selezionare il file I_GC100.xml (incluso nel file ZIP Vesternet iTach)
• Fare clic su 'Go'
• Al termine del caricamento è necessario riavviare Luup
• Accedere a SETUP > Net & Wi-fi e fare clic su 'Reboot'
• Attendere il riavvio di VERA
• Il plugin GC100 sarà ora correttamente configurato e funzionante

Figura 2: Plugin GC100 configurato

Passaggio 3 - Creare e caricare i file del dispositivo

Per creare un dispositivo controllabile tramite IR in VERA, è prima necessario creare e modificare i file di controllo del dispositivo.

Questo esempio si basa su una serie di file creati per un Bose Sounddock; la presente guida illustra le parti dei file XML da modificare per il proprio apparecchio.

• Estrarre i file .xml dal file ZIP Vesternet iTach
• Rinominarli in modo da poter identificare il dispositivo a cui fanno riferimento (ad esempio 'XYZ', 'Yamaha RX675', ecc.)
• È possibile utilizzare qualsiasi nome desiderato; per il resto della presente guida si farà riferimento ai file con il nome Bose_SoundDock.

Modificare il file di servizio (file S_)

Il file S_Bose_SoundDock.xml è il file 'Service' per il dispositivo IR e controlla le azioni dell'apparecchio. In questo caso definiremo le azioni IR che possono essere attivate dai comandi IR di iTach.

• Aprire il file S_Bose_SoundDock.xml in un editor di testo o HTML
• Alla riga 7 è presente un tag < actionList > e, al di sotto di esso, una serie di tag < action >
• Questi fanno riferimento a tag < action > analoghi nel file I_Bose_SoundDock.xml, che contengono i codici IR effettivi per controllare l'apparecchio
• Nel file S_Bose_SoundDock.xml modificare questi nomi, eliminare quelli non necessari o aggiungerne di nuovi
• Per questo esempio sono stati necessari solo due comandi per il SoundDock: Bose Play e Bose Off
• Ricordarsi di salvare le modifiche una volta terminato
• Il file S_Bose_SoundDock.xml finale è mostrato nella Figura 3

Figura 3: File del dispositivo S_Bose_SoundDock.xml

Modificare l'implementazione (file I_)

Il file I_Bose_SoundDock.xml è il file di 'Implementation' per il dispositivo IR e contiene le azioni e i codici IR che controlleranno l'apparecchio.

• Aprire il file I_Bose_SoundDock.xml in un editor di testo o HTML
• Alla riga 3 è presente un tag < actionList > e, al di sotto di esso, una serie di tag < action >
• Questi contengono i codici IR che verranno trasmessi all'attivazione di ciascuna azione
• Rinominare < serviceId > con un identificativo correlato all'apparecchio: < serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock< /serviceId >
• Nota: lo stesso < serviceId > viene utilizzato per tutte le azioni nel file I_Bose_SoundDock.xml
• Modificare il tag < name > in modo che corrisponda alla descrizione della relativa azione: < name >Bose Play < /name >

Si consiglia di aggiungere una singola azione con il relativo codice IR e testarla in VERA prima di completare l'intero file I_SoundDock.xml.

Figura 4: File del dispositivo I_Bose_SoundDock.xml con codice IR evidenziato

Modificare la descrizione (file D_)

Il file D_Bose_SoundDock.xml è il file di 'Description' per il dispositivo IR e contiene tutte le informazioni relative al dispositivo IR. È necessario aggiungere le descrizioni principali del dispositivo e i collegamenti ai file di implementazione e di servizio.

Passaggio 4 - Creare il dispositivo IR dell'apparecchio

È ora possibile creare un dispositivo VERA che utilizzerà i file appena generati. Questo dispositivo sarà un 'dispositivo virtuale' dell'apparecchio reale, consentendo di controllarne le funzioni tramite le scene VERA.

• Andare su 'APPS' > 'Develop Apps'
• Nella barra laterale sinistra fare clic su 'Create Device'
• Inserire il nome del file 'D_Bose_SoundDock.xml' nella casella Upnp Device Filename
• Fare clic su 'Create Device'

Figura 6: Creare il dispositivo IR in VERA

• Il nuovo dispositivo sarà presente nella scheda DEVICES, ma non sarà ancora completamente configurato
• Fare clic sul pulsante blu "RELOAD" di VERA (nella parte superiore della pagina) e attendere il ricaricamento di VERA
• Il dispositivo dovrebbe ora mostrare il "friendlyName" scelto nel file "Device Description"
• Nella scheda Advanced del dispositivo devono essere presenti il file Description corretto (D_Bose_SoundDock.xml) e il tipo di dispositivo corretto (urn:schemas-micasaverde-com:device:IrDevice:1)
• Se questi campi non sono compilati, fare nuovamente clic sul pulsante "RELOAD" e attendere il ricaricamento di VERA
• L'ultimo passaggio consiste nel configurare il dispositivo con la porta IR corretta di iTach: iTach dispone di tre porte IR; per questo esempio si utilizza l'IR Blaster (porta 3) - consultare APNT-65 - Configurazione di base e apprendimento di iTach
• Accedere alla scheda "Settings" del dispositivo e selezionare la porta corretta dal menu a discesa
• Chiudere il dispositivo e fare clic sul pulsante rosso "SAVE" (nella parte superiore della pagina)
• Al termine del ricaricamento di VERA, il dispositivo sarà pronto per il test

Figura 6: Selezionare la porta IR corretta per il dispositivo appliance

Passaggio 5 - Testare il dispositivo IR appliance

È ora possibile testare il nuovo dispositivo e verificarne il corretto funzionamento.

• Nel browser, inserire http://VERAs_IP_address:3480/data_request?id=lu_invoke, sostituendo "VERAs_IP_address" con l'indirizzo IP del proprio VERA
• Fare clic sul dispositivo appliance nell'elenco (ad esempio #200 Bose SoundDock)
• Verrà visualizzato l'elenco dei comandi disponibili
• Assicurarsi che l'IR blaster/emettitore di iTach sia posizionato di fronte all'apparecchio
• Fare clic su una delle azioni nel browser per far eseguire l'operazione all'apparecchio
• In caso di malfunzionamento, verificare i file del dispositivo, correggerli e caricarli nuovamente

Figura 7: Finestra del browser con l'elenco delle azioni disponibili per il dispositivo IR

Passaggio 6 - Utilizzare il dispositivo IR appliance nelle scene

Dopo aver verificato il corretto funzionamento delle azioni del dispositivo tramite iTach, è possibile utilizzare le scene di VERA per controllarne le operazioni.

A tale scopo, è necessario accedere alla scheda Advanced Scene di VERA

• Creare una nuova scena - consultare APNT-34: Creazione di scene in VERA
• Accedere alla scheda "Advanced" della scena
• Selezionare il dispositivo IR appliance nel menu a discesa "Pick a device"
• Fare clic su "Add"
• Il dispositivo risulterà ora aggiunto alla scena
• Selezionare l'azione dal menu a discesa "Please select" accanto al dispositivo
• Fare clic sul pulsante verde "Confirm changes" (nella parte superiore della pagina)
• Fare clic sul pulsante rosso "SAVE" (nella parte superiore della pagina)
• La scena è ora configurata e pronta per essere attivata tramite trigger, pianificazione o avvio manuale per controllare una o più azioni dell'apparecchio

Figura 8: Utilizzo del dispositivo IR in una scena

Questa guida è piuttosto dettagliata. Tuttavia, una volta completata la procedura la prima volta, risulterà tutto chiaro e sarà possibile configurare il dispositivo controllato da iTach successivo molto più rapidamente.

Riferimenti

Questa nota applicativa si basa sui test condotti da Vesternet e sui numerosi e utili post degli utenti del VERA Forum; un ringraziamento particolare va ai membri del forum "a-lurker" e "konradwalsh".

Informazioni correlate

• APNT-65: Configurazione di base e apprendimento di iTach
• APNT-66: Utilizzo di iTach con Fibaro Home Center
• APNT-34: Creazione di scene VERA
• APNT-35: Controllo delle scene VERA tramite trigger
• APNT-36: Controllo delle scene VERA tramite programmazione oraria
• KB-35: Differenza tra cavi iTach Emitter e Blaster
• KB-36: Informazioni sulle API iTach
• Download e documentazione Global Cache