Návod pro používání IO modulů řady YAT-IOQ-IP (Ethernet)

Návod pro používání IO modulů řady YAT-IOQ-IP (Ethernet) Úvod... 2 Možné aplikace... 2 Připojení IO modulů ke Control4... 3 Parametry modulů... 3 Konfigurace ovladače v Composeru Pro... 4 Ruční změna parametrů modulu... 6 Chybová hlášení a signalizace chybových stavů... 7 Diagnostický režim ovladače... 7 Chování driveru při ztrátě spojení s modulem... 8 Signalizace chybových stavů... 9 Název a verze ovladače Název Creator Created (verze) IOQ IP Yatun 6/10/2010 03:00 AM Litevská 8, Praha 100 00, Czech Republic 1 z 10 www.control4.cz

Úvod Driver je určen pro řízení rozšiřovacích modulů řady IOQ-IP. Moduly IOQ-IP se připojují k řídícím jednotkám Control4 (HC200,HC300,HC500,HC1000) pomocí sítí LAN/WAN (rozhraním Ethernet) a umožňují zvětšit počet použitelných dvoustavových vstupů a výstupů. Poznámka driver pro připojení typu modulů připojovaných rozhraním RS232 viz aktuální drivery na ftp dodavatele nebo WWW.YATUN.CZ). Připojení rozšiřujícího modulu k řídící jednotce Control4 umožňuje zvýšit počet použitelných dvoustavových vstupů a výstupních nízkonapěťových relé v systému. Používá se, vyžaduje-li aplikace systému Control4 vyšší počet vstupů, nebo výstupních relé než je k dispozici na použité jednotce, a je-li možno využít síť LAN/WAN pro připojení rozšiřujícího modulu. Omezení počtu připojených modulů je dáno pouze akceptovatelným zpomalením odezvy jednotky které by bylo způsobeno SW zátěží při provozování velkého počtu driverů. Každý připojený modul IOQ-IP potřebuje jeden driver, reprezentovaný ikonou driveru v stromu seznamu zařízení v projektu v programu Composer Pro. Driver je vybaven autodetekcí připojeného typu připojeného modulu aktivovanou při nastavování vlastností v programu ComposerPro v záložce vlastnosti-properties (automatické načtení adresy modulu, počtu dostupných vstupů a výstupů). Moduly mohou být vybaveny teploměrem o měřícím rozsahu -55 až +125 C. Změny na vstupech jsou sledovány a indikovány v uživatelském rozhraní systému Control4 současně tak jak nastávají. (tj. bez omezení počtu indikovaných současně aktivovaných vstupů). Možné aplikace Ovládání garážových vrat, krytů bazénů, zámků Spínání ovládacích kontaktů žaluzií Spínání stykačů čerpadel, vzduchotechniky. Ovládání jednotlivých podsystémů u ústředen zabezpečovací signalizace EZS s více podsystémy pomocí zón typu Keyswitch Snímání stavu zón a podsystémů ústředen zabezpečovacích systémů Snímání stavu poplachových výstupu digitálních video detektorů pohybu na jednotkách DVR (Digital Video Recorder) Kontaktní ovládání zón topných systémů Ovládání osvětlení - vysílačů dálkově ovládaných zásuvek a spínačů osvětlení jiných výrobců (Elektro Bock, Jablotron, Schneider..) v interiéru i exteriéru při řízení většího počtu dálkově ovládaných svítidel Litevská 8, Praha 100 00, Czech Republic 2 z 10 www.control4.cz

Připojení IO modulů ke Control4 Moduly IOQ-IP se připojují k síti LAN/WAN standardním ethernetovým kabelem s konektory RJ45. Na modulu je zásuvka do které se kabel přímo připojí a indikační LED na připojovacím konektoru signalizují stav připojení a komunikaci. Parametry modulů Připojovací rozhraní: Typ... Ethernet 10/100 Konektor... RJ45 F Napájení...7 až 35 V ss,má ochranu proti přepólování. (standardní verze 12V) Konektory pro I/O a napájení... svorkovnice Wago 236, max. průřez vodiče 2.5 mm Typ digitálních výstupů... přepínací kontakt relé Maximální spínané napětí... střídavé: 120 V, stejnosměrné 60 V Maximální spínaný proud... 5 A Ochranný varistor... UAC=60 V, EMAX=5 J Vstupy ( verze s napájením 12V) Řízení ovládacím napětím nebo pro spínací kontakt (s přívodem ext. napětí),optické galvanické oddělení Vstupní proud... 4 ma Vstupní napětí pro stav Log 1... 8 20 V Vstupní napětí pro stav Log 0... 0 4 V Maximální vstupní napětí... 24 V Indikátory Indikační LED dioda napájení na desce modulu PWR svítí zeleně = přiloženo vstupní napětí Indikační LED dioda komunikace na desce modulu - COM bliká žlutě při odeslání potvrzení o přijetí správného příkazu modulem, nebo při odeslání dat z modulu. Indikační LED dioda stavu pro každé relé červená = relé napájeno Indikační LED diody komunikace po Ethernetu LINK a ACT na konektoru XPort-pro moduly řady IP LINK Nesvítí... nepřipojeno Litevská 8, Praha 100 00, Czech Republic 3 z 10 www.control4.cz

ACT Žlutá... připojeno k síti Ethernet rychlostí 10Mbps Zelená... připojeno k síti Ethernet rychlostí 100Mbps Nesvítí... komunikace neprobíhá Zeleně bliká při komunikaci modulu s řídící jednotkou Control4. Stavy vstupů se do systému Control4 aktualizují vždy v okamžiku jejich změny. Konfigurace ovladače v Composeru Pro Po volbě položky System design ( vlevo dole) klikněte na záložku Properties v prostředním okně vlastností driveru (Properties). Zobrazí se výpis polí s parametry modulu na následujícím obrázku je formulář s výchozími hodnotami kdy systém ještě automaticky neidentifikoval typ modulu. POZNÁMKA: V tomto okně se mohou zobrazit i jiné (aktuální) hodnoty neboť proces detekce typu modulu driverem probíhá automaticky a již mohl proběhnout. 1. Přepněte se do volby Conections,do záložky Control A/V a v seznamu zařízení vyberte nejprve modul IOQ IP, a potom libovolné jiné zařízení (např. řídící jednotku HC xxx) ) a poté opět modul IOQ IP protože teprve při opětovném zvolení se zaktualizují automaticky identifikované hodnoty parametrů!!! Tímto se automaticky detekují příslušné hodnoty a vyplní se příslušná pole vlastností modulu v záložce Properties. Na následujícím obrázku je formulář s vyplněnými hodnotami parametrů poté co systém automaticky identifikoval typ a možnosti modulu. (zobrazit přes System design ( vlevo dole) a záložku Properties (uprostřed nahoře). Litevská 8, Praha 100 00, Czech Republic 4 z 10 www.control4.cz

V záložce Properties můžete v poli Thermometer Refresh nastavit periodu aktualizace měřené teploty (čtení z modulu) v rozsahu 1-180 min a potvrdit ji kliknutím na tlačítko Set dočasně zobrazené vedle upravovaného pole. Poznámka Výchozí hodnoty před provedením identifikace: adresa je 1 a perioda čtení teploty je 1 min. Adresa modulu se zobrazuje jako dekadická hodnota ASCII kódu číslice adresy. Tj. např. pro modul č 1 = hex 31 = dec 49. Není-li modul vybaven teploměrem v poli Thermometers se vypíše hodnota 0. Je- li modul vybaven teploměrem v poli Thermometers se vypíše hodnota 1.!!! Poté se přepněte se do volby Conections a v seznamu zařízení vyberte nejprve libovolné jiné zařízení a poté opět modul IOQ RS protože teprve při opětovném zvolení se zaktualizují identifikované hodnoty parametrů!!! 2. Po kliknutí na volbu Conections (levá záložka Control/AV) se pak v střední sekci obrazovky nadepsané Control & Audio Video Connections se vypíše seznam dostupných vstupů a výstupů na modulu připravený pro vytvoření logických připojení s zvolenými zařízeními. POZNÁMKA: Při používání relé jako PULSE (impuls po daný časový okamžik) je nutné počítat s tím, že IOQ moduly musí vysílat impulsy pouze v násobcích 500 ms (zadaný údaj je automaticky zaokrouhlen). Příklad obrazovky připravené k vytvoření vazeb relé modulu na zvolená zařízení. Litevská 8, Praha 100 00, Czech Republic 5 z 10 www.control4.cz

Má li modul teploměr, je možno jej od této chvíle používat v sekci Programming prostřednictvím proměnné Q_THERM_1. V této proměnné se objevuje hodnota naměřené teploty v intervalech dle nastavené periody aktualizace. Teplota je zobrazována s přesností na desetiny stupně. Příklad zobrazení proměnné Q_THERM_1 v sekci Programming. Prostřednictvím proměnné LASTERROR je v sekci Programming dostupná i informace o poslední detekované chybě při komunikaci s modulem. Viz předchozí obr. a následující kapitoly. Proměnná DISCONNECTED typu STRING obsahuje stav spojení mezi řídící jednotkou Control4 a modulem IOQ-IP. Hodnota 1 znamená odpojeno, hodnota 0 znamená připojeno. Ruční změna parametrů modulu V případě, že chcete změnit dodatečně některé parametry modulu (např. přidat nebo odebrat teploměr, změnit periodu čtení teploty apod.), připojit nový modul, kterým jste nahradili původní typ modulu můžete tuto úpravu provést ručně. Poznámka V případě připojení nového modulu musí mít tento stejnou IP adresu, jinak jej musíte vymazat ze seznamu zařízení a projít celý postup přidání od začátku. Po volbě položky System design (vlevo dole) klikněte na záložku Actions v prostředním okně vlastností driveru (Properties). Zobrazí se dvě tlačítka. Klikněte nejprve na tlačítko Get address pro automatické zjištění aktuální adresy modulu (může být libovolná v rozsahu 0-255). Poté klikněte na tlačítko Get availableios pro automatické zjištění počtu dostupných vstupů/výstupů a teploměrů na připojeném modulu. Přepněte se do volby Conections a v seznamu zařízení vyberte nejprve modul IOQ IP, a potom libovolné jiné zařízení (např. řídící jednotku HC xxx) ) a poté opět modul IOQ IP protože teprve při opětovném zvolení se zaktualizují automaticky identifikované hodnoty parametrů!!! Litevská 8, Praha 100 00, Czech Republic 6 z 10 www.control4.cz

Chybová hlášení a signalizace chybových stavů Diagnostický režim ovladače V záložce Properties (volby System Design) se dají zapnout následující volby Off záznam činnosti vypnut LOG záznam činnosti se ukládá do systémového logu Print záznam činnosti se vypisuje a je k dispozici Print +Log záznam činnosti se ukládá do systémového logu a vypisuje Systémový Debug log je dostupný v souborovém systému příslušné řídící jednotky v adresáři Log. UPOZORNĚNÍ: Po ¾ hod záznamu se volby jak Print tak Log automaticky vypnou jako prevence proti přeplnění logu na disku řídící jednotky. Maximální kapacita diskového prostoru pro diagnostický log je 5 MB. Po volbě položky System design (vlevo dole) klikněte na záložku Properties v prostředním okně vlastností driveru (Properties) můžete nastavit v poli Debug Mode hodnotu parametru na Print a poté potvrdit kliknutím na dočasně zobrazené tlačítko Set Tímto zapnete diagnostické zobrazování průběhu komunikace driveru, které je dostupné v poli Lua output v záložce Lua v prostředním okně vlastností driveru (Properties). Zobrazuje zachycené povely, periodické čtení teplot a chybové texty, které Vám mohou identifikovat případnou příčinu potíží popřípadě ověřit, jestli driver komunikuje s modulem Po zprovoznění/ověření funkce driveru doporučujeme opět diagnostické okno vypnout nastavením parametru Debug Mode na Off. Je-li zapnuta volba obsahující Log, data jsou zapisována do systémové oblasti řídící jednotky pro pozdější přečtení. Odesláním obsahu okna Lua output jako textu dodavateli je možno v případě problému usnadnit diagnostiku problému. Litevská 8, Praha 100 00, Czech Republic 7 z 10 www.control4.cz

Příkladem použití diagnostického výpisu v okně Lua je následující hlášení : GetTemperatures called. Received something from network on binding 6001 00000000 2A 61 00 05 31 DE 05 5B 0D.a..1... Device Error -- inner error in IOQ - inicialization, peripheral or memory error (thermometer not connected?) které signalizuje, že modul nemůže poskytovat teplotu protože není připojeno/selhalo teplotní čidlo. Po zprovoznění/ověření funkce driveru doporučujeme opět diagnostické okno vypnout nastavením parametru Debug Mode na Off. Je-li zapnuta volba obsahující Log, data jsou zapisována do systémové oblasti řídící jednotky pro pozdější přečtení. Chování driveru při ztrátě spojení s modulem Dojde li ke ztrátě spojení mezi řídící jednotkou a I/O modulem: Nebudou se hlásit změny stavu vstupů a ovládaná relé nebudou přepínat. Hodnota teploty v proměnné teploměru zůstane na poslední naměřené hodnotě. Nastaví se chybová hlášení a příznaky pomocí kterých je možno jako od událostí (Events) aktivovat hlášení a případně změnit chování systému. Hodnota proměnné DISCONNECTED se nastaví na 1. Každé 3 minuty se zkusí ověřit, zda je IO modul dostupný. Pokud ano, připojí se a relé se uvedou do stavu před odpojením IO modulu. Hodnota proměnné DISCONNECTED se nastaví na 0. Litevská 8, Praha 100 00, Czech Republic 8 z 10 www.control4.cz

Signalizace chybových stavů Zachytí li driver chybu, naplní proměnnou LASTERROR textovým popisem chyby a nastaví příznak umožňující v sekci Programming spustit událost ošetřující příslušný stav/chybu. 1. Ztráta spojení s jednotkou - vyhodnocuje se rozpad TCP spojení s modulem IOQ IP, identifikovaný typicky do 16 minut od vzniku příčiny (obvykle přerušení kabelu, vypnutí napájení switche routeru nebo samotného modulu IOQ IP). V sekci Programming klikněte na ikonu modulu a v poli IOQ IP Events vyberte událost Communication error. Této události pak v sloupci Actions přiřaďte požadované činnosti- reakci na událost. 2. Přijata poškozená data během přenosu došlo k poškození dat (obvyklou příčinou je špatné nastavení modulu IOQ IP, poškození kabelů, a rušení je-li v komunikační trase část přenášející data po linkách RS 232, RS485 apod.) V sekci Programming klikněte na ikonu modulu a v poli IOQ IP Events vyberte událost Invalid format error. Této události pak v sloupci Actions přiřaďte požadované činnosti- reakci na událost. 3. Porucha HW modulu IOQ IP (Např. nepřipojen/odpojen externí teploměr u modulu která jej podporuje). V sekci Programming klikněte na ikonu modulu a v poli IOQ IP Events vyberte událost Error exception. Této události pak v sloupci Actions přiřaďte požadované činnosti- reakci na událost. Litevská 8, Praha 100 00, Czech Republic 9 z 10 www.control4.cz

Pro případnou další diagnostiku systém pro každý chybový stav naplní popisem chyby proměnnou LASTERROR SEZNAM CHYBOVÝCH HLÁŠENÍ v proměnné Last error Pro událost/event Communication Error TEXT: Disconnected from IOQ. Pro událost/event Error exception TEXT: No thermometer connected. TEXT: Device Error -- inner error in IOQ - inicialization, peripheral or memory Pro událost/event Invalid format error TEXTY: 1. Error in communication -- expected 2 bytes of data in response but there are... 2. Error in communication -- malformed response string:... 3. Error in communication -- expected at least 25 bytes of data in response but there are... 4. Error in communication -- NUM must be at least 5 5. Error in communication -- expected PRE to be 0x2A but it is... 6. Error in communication -- expected FRM to be 0x61 but it is... 7. Error in communication -- expected SUMA to be... but it is... 8. Error in communication -- answer to unsent command - SIG =... 9. Error in communication -- unknown INST =... 10. Error in communication -- ACK in answer is 11. Error in communication -- message must end with 0x0D Poznámka V některých textech uvedených chybových hlášeních se místo vkládají automaticky identifikační data (takže tyto řetězce není možné jednoduše z proměnné Last error obecně porovnat metodou porovnáváním textů, protože je nutno porovnávat známý-očekávaný obsah řetězce) Litevská 8, Praha 100 00, Czech Republic 10 z 10 www.control4.cz