Návod pro používání GSM modemu YATUN TC35i

Návod pro používání GSM modemu YATUN TC35i Úvod... 2 Možné aplikace... 2 Připojení GSM modemu ke Control4... 3 Postup... 3 Konfigurace ovladače v Composeru Pro... 3 Použití ovladače v Composeru Pro... 4 Detekce zvonění... 4 Příjem textu SMS zpráv (SMS received)... 5 Odesílání SMS zpráv (SMS send)... 6 Chybová hlášení a signalizace chybových stavů... 8 Seznam chybových hlášení... 8 Diagnostický režim ovladače... 9 Název a verze ovladače Název Creator Created (verze) GSM Gateway TC35i Yatun 8/23/2009 03:00 AM Název souboru ovladače: gsm_gateway_232_yatun_tc35i.c4i

Úvod Driver je určen pro řízení modulu GSM komunikace umožňujícímu řídící jednotce Control4 přijímat povely od uživatele příjmem stanoveného počtu zvonění, příjmem SMS zpráv a informovat uživatele o událostech odesíláním SMS zpráv. Driver je určen pro GSM modul YATUN TC35i dodávaný společností YATUN. Moduly TC35i se připojují k řídícím jednotkám Control4 pomocí rozhraní RS-232. Pro správnou funkci musí být modem vybaven SIM kartou s odpovídajícím tarifem nebo výší kreditu. Není omezen počet připojených modulů k řídící jednotce, omezení je dáno pouze počtem dostupných portů RS232. Každý připojený modul TC35i potřebuje jeden driver, reprezentovaný ikonou driveru v stromu seznamu zařízení v projektu v programu Composer Pro. Možné aplikace Ovládání garážových vrat, krytů bazénů, zámků Spínání ovládacích kontaktů žaluzií, ovládání osvětlení Posílání zpráv uživatelům z mobilního telefonu a emailu na TV a dotykové panely Spínání stykačů čerpadel, vzduchotechniky. Ovládání jednotlivých podsystémů u ústředen zabezpečovací signalizace EZS Snímání stavu zón a poplachů a podsystémů ústředen zabezpečovacích systémů Ovládání zón topných systémů Informování uživatelů o stavu a hodnotách parametrů systému pomocí SMS zpráv a emailů Vytvoření záložní komunikační trasy pro případ, že je systém nedostupný přes internet Litevská 8, Praha 100 00, Czech Republic 2 z 10 www.control4.cz

Připojení GSM modemu ke Control4 Moduly TC35i se připojují k řídícím jednotkám standardním prodlužovacím kabelem RS232 (přímý) s konektory DB9F (k PC) a DB9M (k modemu). Na modulu je zásuvka, do které se kabel přímo připojí a indikační LED diody signalizující stav připojení a komunikaci. Postup 1. Vložení SIM karty do GSM modemu a připojení GSM antény. 2. Připojení GSM modemu pomocí RS-232 k řídící jednotce Control4 nebo jinému RS-232 portu (GlobalCaché, Vlinx servery). 3. Zapnutí GSM modemu do napájení. 4. Přidání a konfigurace ovladače v Composeru Pro. 5. Reakce na události v Programming (zasílání sms, příjem sms, reakce na prozvánění). Konfigurace ovladače v Composeru Pro Je-li u SIM karty použito zabezpečení PIN kódem, je nutno jej nastavit. Pokud chcete změnit dodatečně kód SIM karty, proveďte toto nastavení následujícím způsobem. 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í Debug Mode a PIN, na následujícím obrázku je formulář s již vyplněnou hodnotou PIN kódu. Nepoužívá-li SIM karta PIN kód, ponechte pole PIN prázdné. Pro zadání PIN kódu klikněte na tlačítko PIN, zadejte hodnotu PIN kódu (4 číslice) a poté potvrďte kliknutím na dočasně zobrazené tlačítko Set. Přepněte se do volby Conections,do záložky Control A/V a v seznamu zařízení vyberte nejprve modul GSM Gateway TC35i, tím se zobrazí u horního okraje obrazovky v sekci Control Inputs řádek se sériovým portem, který propojíte se zvoleným sériovým portem přetažením na řádek zvoleného sériového portu v dolní části obrazovky nadepsané RS_232 Output Devices. Litevská 8, Praha 100 00, Czech Republic 3 z 10 www.control4.cz

Použití ovladače v Composeru Pro Driver umožňuje následující činnosti 1. Detekci zvonění (Event) a vyhodnocení počtu zvonění. (v proměnné typ číslo) 2. Příjem textu SMS zpráv do řetězcové proměnné a oznámení o přijetí SMS zprávy (Event) 3. Odesílání SMS zpráv (z řetězcové proměnné) na nastavená čísla (Akce) 4. Poskytování chybových hlášení a kontrolu spojení s modemem. (jako Event a řetězcové proměnné) Telefonní číslo volajícího nebo odesilatele SMS se předává v proměnné typu řetězec jako třináct znaků bez mezer včetně kódu země a úvodního znaku +. Tj. pro čísla z ČR +420739514431 nebo např. z Anglie +447772804586. Čísla, na která mají být odesílány SMS zprávy, je rovněž možno zadat pomocí řetězcových proměnných. Driver kontroluje spojení s modemem po RS232. Driver nekontroluje přihlášení SIM do sítě GSM a dostupnost GSM signálu. Detekce zvonění Driver sleduje signál modemu oznamující zvonění příchozího hovoru a v proměnné RING_COUNT ukládá počet zvoněni. V okamžiku, kdy příchozí hovor přestane vyzvánět (zjišťuje se tak že 6 sekund nepřijde signál Ring protože rozestup mezi signály Ringy je 4s), tak se vyvolá událost (Event) "Ringing". V proměnné RING_COUNT (typ proměnné číslo) je k dispozici počet zjištěných zvonění a v proměnné RING_NUMBER (typ proměnné řetězec) číslo volajícího. UPOZORNĚNÍ: Je-li třeba zobrazit obsah proměnné RING_COUNT pomocí Agenta Announcement, je nutné její obsah převést nejprve na řetězcovou proměnnou přiřazením do libovolné pomocné řetězcové proměnné, protože Agent Announcement umí zobrazovat pouze řetězcové proměnné. Příklad okna v menu Programming s nastavením spuštění akce (Eventem) po ukončení zvonění. Litevská 8, Praha 100 00, Czech Republic 4 z 10 www.control4.cz

Příklad okna v menu Programming s nastavením spuštění akce (Eventem) v případě, že se změnila hodnota proměnné RING_COUNT. (ještě v průběhu zvonění) Příklad okna v menu Programming s nastavením spuštění akce (Eventem) v případě že se změnila hodnota proměnné RING_NUMBER identifikující číslo volajícího. (ještě v průběhu zvonění) Příjem textu SMS zpráv (SMS received) Příchozí SMS do modemu je driverem zjištěna a vyvolá událost (Event) "SMS received". V řetězcové proměnné SMS_NUMBER bude uloženo číslo, z nějž byla SMS zpráva odeslána a v řetězcové proměnné SMS_TEXT bude uložen text došlé SMS zprávy převedený na velká písmena. Na příchozí SMS se reaguje okamžitě, modem oznamuje příchozí SMS, hned jak přijdou. Po vyzvednuti SMS z modemu je zpráva z modemu smazána (modem obsahuje buffer došlých a nevyzvednutých zpráv pro případ rychlého příchodu několika zpráv rychle za sebou). Litevská 8, Praha 100 00, Czech Republic 5 z 10 www.control4.cz

Příklad okna v menu Programming s nastavením spuštění akce (Eventem) po přijetí SMS zprávy. Příklad okna v menu Programming s nastavením spuštění akce (Eventem) v případě, že se změnila hodnota proměnné SMS_NUMBER identifikující číslo odesilatele SMS zprávy. Příklad okna v menu Programming s nastavením spuštění akce (Eventem) v případě, že se změnil obsah proměnné SMS_TEXT obsahující text naposledy přijaté SMS zprávy. Odesílání SMS zpráv (SMS send) Pro odeslání SMS zprávy ze systému Control4 řídící jednotkou existuje v menu Programming akce (Action) Send SMS, která má jako parametry číslo, na nějž se SMS posílá a pět textových proměnných, z nichž se složí seřazením za sebe výsledná odesílaná zpráva. Ta se ořízne na 160 znaků. Pokud v okamžiku vzniku požadavku na odeslání SMS zprávy není připojen modem, dojde k vyvolání události (Event) "Error exception" a v proměnné ERROR_TYPE bude číselná hodnota ERROR_TYPE_DISCONNECTED. Litevská 8, Praha 100 00, Czech Republic 6 z 10 www.control4.cz

SMS zpráva nicméně zůstane ve frontě a v okamžiku, kdy bude modem opět dostupný, se odešle. Pro zadávání parametrů je nutno zaškrtnout volbu Device Specific Command, poté se zpřístupní pole s parametry. Příklad okna se zadáváním parametrů odesílané SMS zprávy. Čísla, na která mají být odesílány SMS zprávy, je rovněž možno zadat v řetězcových proměnných, která se zobrazí v rozbalovacím seznamu dostupném pod šipkou vedle pole NUMBER. Příklad okna s zobrazeným výběrem proměnných, které je možno použít pro sestavení obsahu zprávy. Poznámka: V příkladu použitá uživatelská proměnná t je proměnná typu řetězec, jinak by se v nabídce nezobrazila. Pro zahrnutí číselných proměnných do zpráv je nutno je nejprve převést na řetězcovou proměnnou přiřazením do libovolné pomocné řetězcové proměnné. Litevská 8, Praha 100 00, Czech Republic 7 z 10 www.control4.cz

Chybová hlášení a signalizace chybových stavů Zachytí-li driver chybu, vyvolá se událost (Event) "Error exception. Do proměnných ERROR_DESCR (textový popis ), ERROR_TYPE (typ chybového hlášení ) a ERROR_MSG (upřesňující hodnota závislá na typu chyby ERROR_TYPE) se zapíší příslušné hodnoty umožňující identifikovat chybu a její příčinu a řídit podle toho další chod programu. Každých 30 sekund se posílá modemu kontrolní dotaz (Echo), pokud modem neodpoví do 20 sekund, pošle se mu druhé. Pokud neodpoví ani na to druhé, považuje se modem za odpojený a vyvolá se událost (Event) "Error exception" s nastavením proměnné ERROR_TYPE na ERROR_TYPE_DISCONNECTED. Echa se posílají dále, a v okamžiku, kdy modem začne odpovídat, se mu odešlou znovu inicializační nastavení. V driveru lze nastavit jeden parametr (property) PIN kód karty, což je PIN použité SIM karty. Pokud SIM karta vyžaduje PIN a ten není v parametrech driveru nastaven, vyvolá se událost (Event) Error exception, stejně jako v případě, kdy je SIM karta zablokována a vyžaduje zadání přístupového kódu PUK. V této verzi driveru není kontrolována funkčnost připojení modemu k GSM síti, ani síla GSM signálu. Je tedy zodpovědností uživatele zajistit, aby SIM karta měla možnost se přihlásit do sítě GSM (zaplacen paušální poplatek, dostatečný kredit, dostatečná aktivita karty bránící vypršení platnosti předplacených karet) a aby měla dostačující signál (externí anténa) pro spolehlivý provoz. Příklad okna v menu Programming s nastavením spuštění akce (Event) po přijetí výskytu libovolné chyby. Příklad okna v menu Programming s nastavením spuštění akce (Event) po změně textu popisu chyby v řetězcové proměnné ERROR_DESCR. Seznam chybových hlášení Seznam typů chyb (hodnot v ERROR_TYPE): Číslo Význam Popis 1 ERROR_TYPE_UNKNOWN Neznámá chyba 11 ERROR_TYPE_COMMUNICATION Chyba při komunikaci s modulem po sériovém portu Litevská 8, Praha 100 00, Czech Republic 8 z 10 www.control4.cz

12 ERROR_TYPE_DISCONNECTED Modul není připojen k sériovému portu 20 ERROR_TYPE_SMS_READ Chyba při čtení SMS 21 ERROR_TYPE_SMS_SEND Chyba při odesílání SMS 30 ERROR_TYPE_DRIVER Vnitřní chyba driveru Poznámka Je-li GSM modem odpojen od napájení po dobu kratší než 1 minuta, nebude po opětovném připojení správně inicializován (pakliže není zároveň odpojena i řídící jednotka HC ta provádí inicializaci při svém startu). Pro správnou inicializaci GSM modemu jej odpojte na dobu delší než 1 minuta a poté znovu zapojte do napájení. Tyto zprávy mohou být v ERROR_DESCR: "Disconnected from GSM gateway - no response on ECHO", "Timeout - GSM gateway has not responded in reasonable time." "Received rubbish on serial port. Is the GSM gateway connected?" "Not conntected to GSM gateway - postponing sending of SMS", "Error reading SMS" "Could not parse received SMS." "GSM Gateway requires PIN, but it is not set" "GSM Gateway requires PUK (PIN blocked?)" "GSM Gateway messed the answer to echo (wtf?)" "Error setting up CLIP" "Error setting text mode" "Error setting SMS indication messages - SMS will not be received!!" "Error sending SMS" "Error checking PIN status" "Error setting PIN" 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 Litevská 8, Praha 100 00, Czech Republic 9 z 10 www.control4.cz

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 10 z 10 www.control4.cz