APNT-68 - iTachin käyttö VERA:n kanssa

iTach IR -sovittimet soveltuvat erinomaisesti AV-laitteiden (televisio, Blu-Ray, kotiteatteri) sekä minkä tahansa infrapunakomennoilla (IR) ohjattavan laitteen ohjaamiseen. Myös ilmastointilaitteiden ohjaamiseen.

Tässä oppaassa esitellään, miten iTach-sovittimia käytetään UI5-ohjelmistoa käyttävien VERA Lite- ja VERA3 Z-Wave -ohjainten kanssa.

iTachin käyttö VERAn kanssa

Jotta VERA voi käyttää iTach-laitteita, on ladattava VERA-laajennus ja luotava laitetiedostot kullekin IR-laitteelle, jota iTach ohjaa.

Tässä oppaassa käydään läpi, miten:

  • Ladataan ja määritetään oikein VERAn iTach (GC100) -laajennus
  • Luodaan laitetiedostot kullekin ohjattavalle laitteelle
  • Lisätään iTach IR -ohjauskoodit laitetiedostoihin
  • Luodaan laitteelle VERA-laite
  • Ohjataan laitteen toimintoja VERA-tilanteista

Vaihe 1 – Lataa tiedostot

VERA iTach (GC100) -laajennuksen asentamiseen ja iTach-laitteiden käyttöön tarvitaan useita tiedostoja. Olemme koonneet ne yhteen ZIP-tiedostoon lataamisen helpottamiseksi.

Ennen kuin teet mitään muuta, lataa Vesternet iTach -ZIP-tiedosto:

Vesternet iTach Files v2.0 (ZIP)

ZIP-tiedosto sisältää neljä tiedostoa, joita käytetään tämän oppaan myöhemmissä vaiheissa:

  • I_GC100.xml – GC100-laajennuksen päivitystiedosto
  • D_Bose_Sounddock.xml – laitteen kuvaustiedosto (Description, pohjana Bose Sounddock 2)
  • I_Bose_Sounddock.xml – laitteen toteutustiedosto (Implementation)
  • S_Bose_Sounddock.xml – laitteen palvelutiedosto (Service)

Vaihe 2 – Asenna ja määritä iTach/GC100-laajennus oikein

iTach/GC100-laajennuksen avulla voit käyttää ja määrittää iTach IR -sovitinta.

GC100-laajennuksen asentaminen

  • Siirry VERA-käyttöliittymässä välilehdelle 'APPS' ja valitse 'Install Apps'
  • Hae 'GC100'
  • Asenna sovellus, minkä jälkeen se näkyy välilehdellä My Apps
  • Välilehdellä DEVICES näkyy uusi GC100-laite
  • Napsauta laitteen jakoavainkuvaketta ('Wrench') ja siirry välilehdelle 'Advanced'
  • Syötä iTachin IP-osoite (katso APNT-65 - iTach Basic Configuration and Learning)
  • Sulje laiteikkuna ja napsauta punaista 'SAVE'-painiketta
  • GC100-laitteen pitäisi nyt näkyä VERAn välilehdellä DEVICES

iTach IP -osoitteen lisääminen GC100-laajennuslaitteeseenKuva 1: iTach IP -osoitteen lisääminen GC100-laajennuslaitteeseen

GC100-laajennus – tunnettu ongelma

GC100-laajennuksessa on tunnettu ongelma: se lähettää IR-komennot kaksi kertaa.

Tämä on helppo korjata lataamalla korjattu toteutustiedosto ('implementation').

  • Siirry kohtaan 'APPS' > 'Develop Apps'
  • Napsauta vasemman reunan sivupalkista 'LUUP Files'
  • Napsauta painiketta 'Choose File' ja valitse tiedosto I_GC100.xml (sisältyy Vesternet iTach -ZIP-tiedostoon)
  • Napsauta 'Go'
  • Kun lataus on valmis, Luup on käynnistettävä uudelleen
  • Siirry kohtaan SETUP > Net & Wi-fi ja napsauta 'Reboot'
  • Anna VERAn käynnistyä uudelleen
  • GC100-laajennus on nyt määritetty oikein ja toimintakunnossa

Määritetty GC100-laajennusKuva 2: Määritetty GC100-laajennus


Vaihe 3 – Luo ja lataa laitetiedostot

IR-ohjattavan laitteen luomiseksi VERA-järjestelmään on ensin luotava ja muokattava laitteen ohjaustiedostoja.

Tämä esimerkki perustuu tiedostoihin, jotka luotiin Bose Sounddock -laitteelle. Tämä opas näyttää XML-tiedostojen ne osat, joita on muokattava omaa laitettasi varten.

  • Pura .xml-tiedostot Vesternet iTach -ZIP-tiedostosta
  • Nimeä ne uudelleen siten, että tunnistat laitteen, johon ne viittaavat – esimerkiksi ”XYZ”, ”Yamaha RX675” jne.
  • Voit käyttää mitä tahansa nimeä – tämän oppaan loppuosassa tiedostoihin viitataan nimellä Bose_SoundDock.

Muokkaa palvelutiedostoa (S_-tiedosto)

Tiedosto S_Bose_SoundDock.xml on IR-laitteen palvelutiedosto (”Service”), joka ohjaa laitteen toimintoja. Tässä tapauksessa määritämme IR-toiminnot, jotka voidaan laukaista iTach IR -komennoilla.

  • Avaa tiedosto S_Bose_SoundDock.xml teksti- tai HTML-editorissa
  • Rivillä 7 on < actionList > -tunniste ja sen alla useita < action > -tunnisteita
  • Nämä viittaavat vastaaviin < action > -tunnisteisiin I_Bose_SoundDock.xml-tiedostossa, jotka sisältävät varsinaiset IR-koodit laitteen ohjaamiseen
  • Muokkaa näitä nimiä tiedostossa S_Bose_SoundDock.xml, poista tarpeettomat tai lisää uusia
  • Tässä esimerkissä tarvittiin vain kaksi SoundDock-ohjaustoimintoa – Bose Play ja Bose Off
  • Muista tallentaa muutokset, kun olet valmis
  • Valmis S_Bose_SoundDock.xml-tiedosto näkyy kuvassa 3

S_Bose_SoundDock.xml -laitetiedostoKuva 3: S_Bose_SoundDock.xml -laitetiedosto

Muokkaa toteutustiedostoa (I_-tiedosto)

Tiedosto I_Bose_SoundDock.xml on IR-laitteen toteutustiedosto (”Implementation”), joka sisältää toiminnot ja IR-koodit laitteen ohjaamiseksi.

  • Avaa tiedosto I_Bose_SoundDock.xml teksti- tai HTML-editorissa
  • Rivillä 3 on < actionList > -tunniste ja sen alla useita < action > -tunnisteita
  • Nämä sisältävät IR-koodit, jotka lähetetään kunkin toiminnon aktivoinnin yhteydessä
  • Nimeä < serviceId > uudelleen laitteeseen liittyväksi tunnisteeksi – < serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock< /serviceId >
  • Huomautus: samaa < serviceId > -tunnistetta käytetään kaikissa toiminnoissa I_Bose_SoundDock.xml-tiedostossa
  • Muokkaa < name > -tunnistetta siten, että se vastaa toiminnon kuvausta – < name >Bose Play < /name >

Lisää IR-koodi

Seuraavaksi iTach iLearn -sovelluksessa luotu IR-ohjauskoodi otetaan käyttöön toteutustiedostossa. Katso lisätietoja kohdasta APNT-65 - iTach-perusmääritykset ja oppiminen.

  • Tiedosto I_Bose_SoundDock.xml käyttää HEX IR Control -koodia – valitse iLearn-sovelluksessa muodoksi HEX
  • Liitä tämä koodi < ir > -tunnisteiden väliin
  • Voit muokata kaikkia muita toimintoja, poistaa tarpeettomat tai lisätä uusia

On suositeltavaa lisätä ensin yksi toiminto ja IR-koodi sekä testata se VERA-järjestelmässä ennen koko I_SoundDock.xml-tiedoston viimeistelyä.

I_Bose_SoundDock.xml -laitetiedostoKuva 4: I_Bose_SoundDock.xml -laitetiedosto korostetulla IR-koodilla

Muokkaa kuvausta (D_ -tiedosto)

D_Bose_SoundDock.xml -tiedosto on IR-laitteen ”Description”-tiedosto (kuvaustiedosto), ja se sisältää kaikki IR-laitteen tiedot. Sinun on lisättävä laitteen pääkuvaukset sekä linkit Implementation- ja Service-tiedostoihin.

Laitteen kuvaukset

  • Muokkaa kuvausrivejä vastaamaan paremmin laitetta, jota tämä IR-laite ohjaa (katso kuva 5):
    < friendlyName >, < manufacturer >, < manufacturerURL >, < modelDescription > ja < modelName >

Implementation File -rivi

  • Muokkaa < implementationFile > -tiedostonimeä (rivi 120) vastaamaan I_XML-tiedostoasi – I_Bose_SoundDock.xml

Service-tiedostot

  • Muokkaa viimeistä ”Service”-osiota (rivi 31) vastaamaan tiedostoa S_Bose_SoundDock.xml:

< 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>

  • Huomautus: Huomioi ”:1” ja ”1” tiedostonimen perässä kahdella ensimmäisellä rivillä
  • Muut Services-kohdat ovat geneerisiä VERA-palvelutiedostoja – voit säilyttää ne tai poistaa ne D_SoundDock.xml-tiedostosta.

Yksilöllinen laitenimi (UDN)

Tämä on tärkeä vaihe.

Jokaisella laitteella on oltava yksilöllinen UDN (Unique Device Name), jonka voit luoda jokaiselle IR-laitteelle erikseen.

  • Luo UDN siirtymällä osoitteeseen http://www.famkruithof.net/uuid/uuidgen
  • Napsauta Get
  • Sivun yläreunassa näkyy uusi UDN-tunnus (lihavoituna), jonka muoto on vastaava kuin b2f53800-b8ea-11e3-a5e2-0800200c9a66
  • Liitä tämä < UDN > -riville kohdan uuid: jälkeen

< UDN >uuid:b2f53800-b8ea-11e3-a5e2-0800200c9a66 </serviceType>

  • D_SoundDock.xml-tiedostosi pitäisi nyt näyttää samalta kuin kuvassa 5.

D_Bose_SoundDock.xml -laitetiedostoKuva 5: D_Bose_SoundDock.xml -laitetiedosto

Lataa tiedostot VERA-ohjaimeen

Nämä tiedostot on nyt ladattava VERA-ohjaimeen (vastaavalla tavalla kuin latasit GC100-liitännäispäivityksen vaiheessa 2).

  • Siirry kohtaan ”APPS” > ”Develop Apps”
  • Napsauta vasemman reunan sivupalkista ”LUUP Files”
  • Napsauta painiketta ”Choose File” ja valitse tiedostot D_Bose_SoundDock.xml, I_Bose_SoundDock.xml ja S_Bose_SoundDock.xml
  • Napsauta ”Go”
  • Kun lataus on valmis, Luup on käynnistettävä uudelleen
  • Siirry kohtaan SETUP > Net & Wi-fi ja napsauta ”Reboot”
  • Anna VERA-ohjaimen käynnistyä uudelleen
  • Laitetiedostot sisältyvät nyt VERA-ohjaimesi Luup-tiedostoihin

Vaihe 4 – Luo IR-laite (IR Appliance Device)

Voit nyt luoda VERA-laitteen, joka käyttää juuri luomiasi tiedostoja. Tämä laite toimii todellisen laitteen ”virtuaalilaitteena”, ja voit ohjata sen toimintoja VERA-tilanteista (scenes).

  • Siirry kohtaan ”APPS” > ”Develop Apps”
  • Napsauta vasemmanpuoleisessa sivupalkissa ”Create Device”
  • Kirjoita tiedostonimi ”D_Bose_SoundDock.xml” kenttään Upnp Device Filename
  • Napsauta ”Create Device”

Luo IR-laite VERAanKuva 6: Luo IR-laite VERAan

  • Uusi laite näkyy DEVICES-välilehdellä, mutta sen määritykset eivät ole vielä valmiit
  • Napsauta VERAn sinistä ”RELOAD”-painiketta (sivun yläreunassa) ja odota, että VERA latautuu uudelleen
  • Laitteella pitäisi nyt olla se ”friendlyName”, jonka valitsit Device Description -tiedostossa
  • Laitteen Advanced-välilehdellä tulisi olla oikea Description-tiedosto (D_Bose_SoundDock.xml) ja laitetyyppi (urn:schemas-micasaverde-com:device:IrDevice:1)
  • Jos näitä tietoja ei ole täytetty – napsauta ”RELOAD”-painiketta uudelleen ja odota, että VERA latautuu
  • Viimeinen vaihe on määrittää laitteelle oikea iTach IR -portti – iTachissa on kolme IR-porttia; tässä esimerkissä käytetään IR Blasteria (portti 3) – katso APNT-65 - iTach Basic Configuration and Learning
  • Siirry laitteen ”Settings”-välilehdelle ja valitse oikea portti avattavasta valikosta
  • Sulje laite ja napsauta punaista ”SAVE”-painiketta (sivun yläreunassa)
  • Kun VERA on suorittanut uudelleenlatauksen, laite on valmis testattavaksi

Valitse oikea IR-porttiKuva 6: Valitse laitteelle oikea IR-portti


Vaihe 5 – Testaa infrapunalaitetta

Nyt on aika testata uusi laite ja varmistaa, että se toimii oikein.

  • Kirjoita selaimeesi http://VERAs_IP_address:3480/data_request?id=lu_invoke – korvaa ”VERAs_IP_address” oman VERA-laitteesi IP-osoitteella
  • Napsauta laitetta luettelosta – omassa esimerkissäni se oli #200 Bose SoundDock
  • Tämä tuo näkyviin luettelon käytettävissä olevista komennoista
  • Varmista, että iTachin IR blaster/emitteri on sijoitettu laitteen eteen
  • Napsauta jotakin toiminnoista selaimessa – tämän pitäisi saada laite suorittamaan kyseinen toiminto
  • Jos se ei toimi oikein, tarkista laitetiedostot, korjaa ne ja lataa ne uudelleen järjestelmään

Luettelo laitteen toiminnoista selaimessaKuva 7: Selain näyttää luettelon IR-laitteelle saatavilla olevista toiminnoista


Vaihe 6 – Käytä infrapunalaitetta tilanteissa (Scenes)

Kun laitteen toiminnot toimivat oikein iTachin kautta, voit käyttää VERA-tilanteita laitteen toimintojen ohjaamiseen.

Tätä varten sinun on käytettävä VERAn Advanced Scene -välilehteä

  • Luo uusi tilanne (scene) – katso APNT-34: Creating Scenes in VERA
  • Siirry tilanteen 'Advanced'-välilehdelle
  • Valitse IR Appliance -laite pudotusvalikosta 'Pick a device'
  • Napsauta 'Add'
  • Laite on nyt lisätty tilanteeseen
  • Valitse toiminto laitteen vieressä olevasta pudotusvalikosta 'Please select'
  • Napsauta vihreää painiketta 'Confirm changes' (sivun yläreunassa)
  • Napsauta punaista painiketta 'SAVE' (sivun yläreunassa)
  • Sinulla on nyt tilanne, joka voidaan laukaista tapahtumasta, ajastaa tai suorittaa manuaalisesti laitteen toimintojen ohjaamiseksi

Luettelo laitteen toiminnoista selaimessaKuva 8: IR-laitteen käyttö tilanteessa


Tämä opas on melko laaja. Kun olet tehnyt tämän kerran, huomaat prosessin olevan johdonmukainen ja seuraavan iTach-ohjatun laitteen määrittäminen sujuu huomattavasti nopeammin.

Viitteet

Tämä sovellusohje perustuu Vesternet-yhtiön tekemiin testeihin sekä useisiin hyödyllisiin keskusteluihin VERA Forum -yhteisössä. Erityiskiitokset foorumin jäsenille 'a-lurker' ja 'konradwalsh'.

Liittyvät tiedot


iTach IR -sovittimet soveltuvat erinomaisesti AV-laitteiden (TV, Blu-Ray, kotiteatteri) ja kaikkien infrapunakomennoilla (IR) ohjattavien laitteiden – mukaan lukien ilmastointilaitteiden – hallintaan.

Tässä oppaassa esitellään, miten iTach-sovittimia käytetään UI5-ohjelmistoa käyttävien VERA Lite- ja VERA3 Z-Wave -ohjainten kanssa.

iTachin käyttö VERA-järjestelmän kanssa

Jotta VERA voi käyttää iTach-laitteita, järjestelmään on ladattava VERA-laajennus (plugin) ja luotava laitetiedostot kullekin iTachin ohjaamalle IR-laitteelle.

Tässä oppaassa käydään läpi:

  • VERA iTach (GC100) -laajennuksen lataaminen ja asianmukainen konfigurointi
  • Laitetiedostojen luominen kullekin ohjattavalle laitteelle
  • iTach IR Control -merkkijonojen lisääminen laitetiedostoihin
  • VERA-laitteen luominen laitteelle
  • Laitteen toimintojen ohjaaminen VERA-tilanteista (scenes)

Vaihe 1 – Lataa tiedostot

VERA iTach (GC100) -laajennuksen onnistuneeseen asennukseen ja iTach-laitteiden käyttöön tarvitaan useita tiedostoja. Olemme koonneet ne yhteen ZIP-tiedostoon lataamisen helpottamiseksi.

Lataa siis ensin Vesternet iTach -ZIP-tiedosto ennen muiden toimenpiteiden aloittamista:

Vesternet iTach Files v2.0 (ZIP)

ZIP-tiedosto sisältää neljä tiedostoa, joita käytetään tämän oppaan myöhemmissä vaiheissa:

  • I_GC100.xml – GC100-laajennuksen päivitystiedosto
  • D_Bose_Sounddock.xml – Laitteen kuvaustiedosto ("Description", perustuu malliin Bose Sounddock 2)
  • I_Bose_Sounddock.xml – Laitteen toteutustiedosto ("Implementation")
  • S_Bose_Sounddock.xml – Laitteen palvelutiedosto ("Service")

Vaihe 2 – Asenna ja määritä iTach/GC100-laajennus oikein

iTach/GC100-laajennus mahdollistaa iTach IR -sovittimen käytön ja konfiguroinnin.

Asenna GC100-laajennus

  • Siirry VERA-käyttöliittymässä välilehdelle 'APPS' ja valitse 'Install Apps'
  • Hae hakusanalla 'GC100'
  • Asenna sovellus, minkä jälkeen se näkyy välilehdellä My Apps
  • Välilehdellä DEVICES näkyy uusi GC100-laite
  • Napsauta laitteen jakoavainkuvaketta ('Wrench') ja siirry välilehdelle 'Advanced'
  • Syötä iTach IP -osoite (katso APNT-65 - iTach-perusmääritykset ja oppiminen)
  • Sulje laiteikkuna ja napsauta punaista 'SAVE'-painiketta
  • GC100-laitteen pitäisi nyt näkyä VERAn DEVICES-välilehdellä

iTach IP -osoitteen lisääminen GC100-laajennuslaitteeseenKuva 1: iTach IP -osoitteen lisääminen GC100-laajennuslaitteeseen

GC100-laajennus – tunnettu ongelma

GC100-laajennuksessa on tunnettu ongelma – se lähettää IR-komennot kaksi kertaa.

Tämä on helppo korjata lataamalla korjattu toteutustiedosto ("implementation").

  • Siirry kohtaan 'APPS' > 'Develop Apps'
  • Napsauta vasemman reunan sivupalkista 'LUUP Files'
  • Napsauta 'Choose File' -painiketta ja valitse tiedosto I_GC100.xml (sisältyy Vesternet iTach -ZIP-tiedostoon)
  • Napsauta 'Go'
  • Kun lataus on valmis, Luup on käynnistettävä uudelleen
  • Siirry kohtaan SETUP > Net & Wi-fi ja napsauta 'Reboot'
  • Anna VERAn käynnistyä uudelleen
  • GC100-laajennus on nyt määritetty oikein ja toimintakunnossa

Määritetty GC100-laajennusKuva 2: Määritetty GC100-laajennus


Vaihe 3 – Luo ja lataa laitetiedostot

IR-ohjattavan laitteen luomiseksi VERAan on ensin luotava ja muokattava laitteen ohjaustiedostoja.

Tämä esimerkki perustuu tiedostoihin, jotka on luotu Bose Sounddock -laitteelle; tämä opas näyttää XML-tiedostojen kohdat, joita on muokattava kyseistä laitetta varten.

  • Pura .xml-tiedostot Vesternet iTach -ZIP-tiedostosta
  • Nimeä ne uudelleen niin, että tunnistat kyseisen laitteen – esimerkiksi 'XYZ', 'Yamaha RX675' jne.
  • Nimen voi valita vapaasti – tämän oppaan loppuosassa tiedostoihin viitataan nimellä Bose_SoundDock.

Muokkaa palvelutiedostoa (S_-tiedosto)

S_Bose_SoundDock.xml -tiedosto on IR-laitteen ”Service”-tiedosto (palvelutiedosto); se ohjaa laitteen toimintoja. Tässä tapauksessa määritämme IR-toiminnot, jotka voidaan laukaista iTach IR -komennoilla.

  • Avaa S_Bose_SoundDock.xml -tiedosto teksti- tai HTML-editorissa
  • Näet rivillä 7 < actionList > -tagin ja sen alapuolella useita < action > -tageja
  • Nämä viittaavat vastaaviin < action > -tageihin I_Bose_SoundDock.xml-tiedostossa, jotka sisältävät varsinaiset laitteen ohjaukseen käytettävät IR-koodit
  • Muokkaa näitä nimiä S_Bose_SoundDock.xml -tiedostossa, poista tarpeettomat tai lisää uusia
  • Tässä esimerkissä SoundDock-laitteelle tarvittiin vain kaksi ohjaustoimintoa – Bose Play ja Bose Off
  • Muista tallentaa muutokset, kun olet valmis
  • Lopullinen S_Bose_SoundDock.xml-tiedosto näkyy kuvassa 3

S_Bose_SoundDock.xml -laitetiedostoKuva 3: S_Bose_SoundDock.xml-laitetiedosto

Muokkaa toteutustiedostoa (I_ -tiedosto)

I_Bose_SoundDock.xml -tiedosto on IR-laitteen ”Implementation”-tiedosto (toteutustiedosto); se sisältää toiminnot ja IR-koodit, joilla laitetta ohjataan.

  • Avaa I_Bose_SoundDock.xml -tiedosto teksti- tai HTML-editorissa
  • Näet rivillä 3 < actionList > -tagin ja sen alapuolella useita < action > -tageja
  • Nämä sisältävät IR-koodit, jotka lähetetään kunkin toiminnon aktivoinnin yhteydessä
  • Muuta < serviceId > vastaamaan laitetta – < serviceId >urn:a-lurker-com:serviceId:Bose_SoundDock< /serviceId >
  • Huomautus: samaa < serviceId > -tunnistetta käytetään kaikissa I_Bose_SoundDock.xml-tiedoston toiminnoissa
  • Muokkaa < name > -tagia siten, että se vastaa toiminnon kuvausta – < name >Bose Play < /name >

Lisää IR-koodi

Nyt sinun tulee ottaa iTach iLearn -sovelluksessa luomasi IR-ohjauskoodi ja käyttää sitä toteutustiedostossa. Katso lisätietoja ohjeesta APNT-65 - iTach-perusmääritykset ja oppiminen.

  • I_Bose_SoundDock.xml-tiedosto käyttää HEX IR Control -koodia – valitse iLearn-sovelluksessa HEX-muoto
  • Liitä tämä koodi < ir > -tagien väliin
  • Voit muokata kaikkia muita toimintoja, poistaa tarpeettomat tai lisätä uusia

On suositeltavaa lisätä ensin yksi toiminto ja IR-koodi sekä testata se VERA-järjestelmässä ennen koko I_SoundDock.xml-tiedoston viimeistelyä.

I_Bose_SoundDock.xml -laitetiedostoKuva 4: I_Bose_SoundDock.xml-laitetiedosto IR-koodi korostettuna

Muokkaa kuvaustiedostoa (D_ -tiedosto)

D_Bose_SoundDock.xml -tiedosto on IR-laitteen ”Description”-tiedosto (kuvaustiedosto); se sisältää kaikki IR-laitteen tiedot. Sinun tulee lisätä laitteen pääkuvaukset sekä linkit toteutus- ja palvelutiedostoihin.

Laitteen kuvaukset

  • Muokkaa kuvausrivejä kuvaamaan paremmin laitetta, jota tämä IR-laite ohjaa (katso kuva 5):
    < friendlyName >, < manufacturer >, < manufacturerURL >, < modelDescription > ja < modelName >

Implementation-tiedoston rivi

  • Muokkaa < implementationFile > -tiedostonimi (rivi 120) vastaamaan I_XML-tiedostoasi – I_Bose_SoundDock.xml

Service-tiedostot

  • Muokkaa viimeinen ”Service”-osio (rivi 31) vastaamaan S_Bose_SoundDock.xml-tiedostoa:

< 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>

  • Huomautus: ”:1” ja ”1” tiedostonimen perässä kahdella ensimmäisellä rivillä
  • Muut Services-osiot ovat yleisiä VERA-palvelutiedostoja – voit säilyttää ne tai poistaa ne D_SoundDock.xml-tiedostosta.

Yksilöllinen laitenimi (UDN)

Tämä on tärkeä vaihe.

Jokaisella laitteella on oltava yksilöllinen UDN (Unique Device Name); voit luoda oman kullekin IR-laitteelle.

  • Luo UDN siirtymällä osoitteeseen http://www.famkruithof.net/uuid/uuidgen
  • Napsauta Get
  • Sivun yläreunassa näet uuden UDN-tunnisteen (lihavoituna), joka on muodoltaan samankaltainen kuin b2f53800-b8ea-11e3-a5e2-0800200c9a66
  • Liitä tämä < UDN > -riville kohdan uuid: jälkeen

< UDN >uuid:b2f53800-b8ea-11e3-a5e2-0800200c9a66 </serviceType>

  • D_SoundDock.xml-tiedostosi tulisi nyt näyttää kuvan 5 mukaiselta.

D_Bose_SoundDock.xml-laitetiedostoKuva 5: D_Bose_SoundDock.xml-laitetiedosto

Lataa tiedostot VERA-ohjaimeen

Nämä tiedostot on nyt ladattava VERA-ohjaimeen (vastaavasti kuin latasit GC100-laajennuksen päivityksen vaiheessa 2).

  • Siirry kohtaan ”APPS” > ”Develop Apps”
  • Napsauta vasemmanpuoleisesta sivupalkista ”LUUP Files”
  • Napsauta ”Choose File” -painiketta ja valitse tiedostot D_Bose_SoundDock.xml, I_Bose_SoundDock.xml ja S_Bose_SoundDock.xml
  • Napsauta ”Go”
  • Kun lataus on valmis, Luup on käynnistettävä uudelleen
  • Siirry kohtaan SETUP > Net & Wi-fi ja napsauta ”Reboot”
  • Anna VERA-laitteen käynnistyä uudelleen
  • Laitetiedostot sisältyvät nyt VERA-ohjaimesi Luup-tiedostoihin

Vaihe 4 – Luo IR-laite laitteelle

Voit nyt luoda VERA-laitteen, joka käyttää juuri luomiasi tiedostoja. Tämä laite toimii fyysisen laitteen ”virtuaalilaitteena”, ja voit ohjata sen toimintoja VERA-tilanteista.

  • Siirry kohtaan ”APPS” > ”Develop Apps”
  • Napsauta vasemmanpuoleisesta sivupalkista ”Create Device”
  • Kirjoita tiedostonimi ”D_Bose_SoundDock.xml” kenttään Upnp Device Filename
  • Napsauta ”Create Device”

Luo IR-laite VERAanKuva 6: Luo IR-laite VERAan

  • Uusi laite näkyy DEVICES-välilehdellä, mutta sen määrityksiä ei ole vielä viimeistelty
  • Napsauta VERAn sinistä 'RELOAD'-painiketta (sivun yläreunassa) ja odota, että VERA latautuu uudelleen
  • Laitteella pitäisi nyt olla 'friendlyName', jonka valitsit 'Device Description' -tiedostossa
  • Laitteen Advanced-välilehdellä tulisi olla oikea Description-tiedosto (D_Bose_SoundDock.xml) ja laitetyyppi (urn:schemas-micasaverde-com:device:IrDevice:1)
  • Jos näitä tietoja ei ole täytetty, napsauta 'RELOAD'-painiketta uudelleen ja odota VERAn latautumista
  • Viimeinen vaihe on määrittää laitteelle oikea iTach IR -portti – iTachissa on kolme IR-porttia, ja tässä esimerkissä käytetään IR Blasteria (portti 3) – katso APNT-65 - iTach Perusmääritykset ja oppiminen
  • Siirry laitteen 'Settings'-välilehdelle ja valitse oikea portti pudotusvalikosta
  • Sulje laite ja napsauta punaista 'SAVE'-painiketta (sivun yläreunassa)
  • Kun VERA on suorittanut uudelleenlatauksen, laite on valmis testattavaksi

Valitse oikea IR-porttiKuva 6: Valitse oikea IR-portti laitteelle


Vaihe 5 – Testaa IR-laite

Nyt on aika testata uusi laite ja varmistaa, että se toimii oikein.

  • Kirjoita selaimeesi http://VERAs_IP_address:3480/data_request?id=lu_invoke – korvaa 'VERAs_IP_address' omalla VERA IP-osoitteellasi
  • Napsauta laitetta luettelosta – tässä esimerkissä #200 Bose SoundDock
  • Tämä tuo näkyviin luettelon käytettävissä olevista komennoista
  • Varmista, että iTachin IR blaster/lähetin on sijoitettu laitteen eteen
  • Napsauta jotakin toiminnoista selaimessa – tämän pitäisi saada laite suorittamaan kyseinen toiminto
  • Jos se ei toimi oikein, tarkista laitetiedostot, korjaa ne ja lataa ne uudelleen palvelimelle

Luettelo laitteen toiminnoista selaimessaKuva 7: Selain näyttää luettelon IR-laitteelle saatavilla olevista toiminnoista


Vaihe 6 – Käytä IR-laitetta tilanteissa (Scenes)

Kun laitteen toiminnot toimivat oikein iTachin kautta, voit ohjata laitteen toimintoja VERA-tilanteiden (Scenes) avulla.

Tätä varten sinun on käytettävä VERAn Advanced Scene -välilehteä

  • Luo uusi tilanne – katso APNT-34: Tilanteiden luominen VERA-järjestelmässä
  • Siirry tilanteen 'Advanced'-välilehdelle
  • Valitse IR-laite pudotusvalikosta 'Pick a device'
  • Napsauta 'Add'
  • Laite on nyt lisätty tilanteeseen
  • Valitse toiminto laitteen vieressä olevasta 'Please select' -pudotusvalikosta
  • Napsauta vihreää 'Confirm changes' -painiketta (sivun yläreunassa)
  • Napsauta punaista 'SAVE'-painiketta (sivun yläreunassa)
  • Käytössäsi on nyt tilanne, joka voidaan laukaista tapahtumasta, ajastaa tai suorittaa manuaalisesti laitteen toiminnon tai toimintojen ohjaamiseksi

Luettelo laitteen toiminnoista selaimessaKuva 8: IR-laitteen käyttäminen tilanteessa


Tämä opas on melko laaja. Kun olet kuitenkin tehnyt tämän kerran, huomaat kokonaisuuden olevan looginen ja pystyt luomaan seuraavan iTach-ohjatun laitteen huomattavasti nopeammin.

Viitteet

Tämä sovellusohje perustuu Vesternet-yrityksen suorittamiin testeihin sekä useisiin hyödyllisiin foorumijulkaisuihin VERA Forum -yhteisössä; erityiskiitokset foorumin jäsenille 'a-lurker' ja ''konradwalsh'.

Liittyvät tiedot