Uživatelský modul. AT Modem Emulator

Uživatelský modul AT Modem Emulator APLIKAC NÍ PR ÍRUC KA

POUŽITÉ SYMBOLY Použité symboly Nebezpečí důležité upozornění, které může mít vliv na bezpečí osoby nebo funkčnost přístroje. Pozor upozornění na možné problémy, ke kterým může dojít ve specifických případech. Informace, poznámka informace, které obsahují užitečné rady, nebo zajímavé poznámky. Conel s.r.o., Sokolská 71, 562 04 Ústi nad Orlicí, Česká Republika Příručka byla vydána v ČR, 8. června 2015 i

OBSAH Obsah 1 Popis uživatelského modulu 1 2 Status 2 2.1 AT Modem Emulator Status............................. 2 2.2 System Log...................................... 3 3 Konfigurace 4 3.1 Konfigurační skript.................................. 6 4 AT Modem Emulator protokol 7 4.1 Přehled AT příkazů.................................. 7 4.2 Počáteční stav a sestavení spojení......................... 10 4.3 Komunikace a režimy už. modulu AT Modem Emulator.............. 11 4.4 Ukončení spojení................................... 11 5 Doporučená literatura 12 ii

SEZNAM OBRÁZKŮ Seznam obrázků 1 AT Modem Emulator v routeru umožňuje komunikaci zařízení (DTE)...... 1 2 Menu už. modulu................................... 1 3 AT Modem Emulator Status............................. 2 4 AT příkazy pro přepínání režimů už. modulu AT Modem Emulator........ 3 5 System Log...................................... 3 6 Konfigurace už. modulu AT Modem Emulator................... 4 7 Typický průběh sestavení spojení.......................... 10 Seznam tabulek 1 Konfigurace už. modulu AT Modem Emulator................... 5 2 Přehled AT příkazů.................................. 9 iii

1. POPIS UŽIVATELSKÉHO MODULU 1. Popis uživatelského modulu Uživatelský modul AT Modem Emulator není součástí standardního firmware routeru. Způsob, jakým jej lze nahrát, je popsán v Konfiguračním manuálu (viz [1, 2]). Uživatelský modul je kompatibilní s v2 i v3 routery. Pro správnou funkci už. modulu je nutné mít v routeru port sériové linky RS-232 nebo RS-485/232. Uživatelský modul AT Modem Emulator umožňuje Conel routeru simulovat chování telefonního modemu přijímat vytáčená spojení po sériové lince a převádět je na TCP/IP datovou komunikaci a naopak. Připojené koncové zařízení (DTE) vidí router jako HAYES kompatibilní modem. Zařízení tak může posílat standardní AT příkazy pro sestavení spojení, nastavení komunikačních parametrů či ukončení spojení. Uživatelský modul AT Modem Emulator umožňuje na straně TCP/IP spojení s jiným AT Modem Emulator v Conel routeru, nebo s jakýmkoli TCP serverem naslouchajícím na příslušném portu. Pro podporované AT příkazy a specifikace protokolu viz kapitolu 4. Obrázek 1: AT Modem Emulator v routeru umožňuje komunikaci zařízení (DTE) Uživatelský modul je určen pro připojení distribuovaných částí systému, jejichž software nemůže být jednoduše upraven pro TCP/IP komunikaci. Typicky jde o zařízení, která jsou již v terénu, slouží dobře, ale mohou komunikovat pouze pomocí RS-232 (např. zařízení v úpravnách vody apod.). Dalšími příklady využití je zabezpečený přenos dat mezi obchodem a vzdáleným skladem, aktualizace databáze na vzdáleném pracovišti apod. Pro přístup k webovému rozhraní už. modulu klikněte ve webovém rozhraní routeru na User Modules a pak na AT Modem Emulator. Menu už. modulu je na obr. 2. Obrázek 2: Menu už. modulu V sekci Status je přehled o stavu modulu a systémová log (viz kap. 2). V sekci Configuration (kap. 3) je možné konfigurovat sériové i TCP parametry komunikace, nastavit některé S-registry, akci na pokles DTR signálu a definovat substituční pravidla v konfiguračním skriptu jde o speciální vlastnost pro nahrazení např. telefonního čísla IP adresou pro zařízení, která neumí vytáčet IP adresu apod., lze také definovat vlastní odezvy na některé příkazy viz kap. 3.1. V sekci Customization můžete zvolit položku Return pro návrat do webového rozhraní routeru. 1

2. STATUS 2. Status 2.1 AT Modem Emulator Status Obrázek 3: AT Modem Emulator Status Na stránce Status jsou zobrazeny tyto informace: Firmware Versions verze firmware Verze FW v routeru. Připojené zařízení může zjistit AT příkazem ATI2. verze uživatelského modulu. Připojené zařízení může zjistit AT příkazem ATI3. Status Variables and S-registers stavové proměnné a S-registry Stavové proměnné E (ECHO), Q (odezvy), V (formát odezvy), &D (akce na pokles DTR signálu může být nastavena v konfiguraci). tyto stavové proměnné mohou být nastaveny z připojeného zařízení pomocí AT příkazů viz kap. 4 pro více informací. S-registry S0 až S25 definují chování už. modulu AT Modem Emulator (automatické přijetí spojení, používané znaky a časové intervaly) některé mohou být nastaveny v konfiguraci, všechny mohou být nastaveny pomocí AT příkazů viz tabulku v kap. 4. Connection Status stav připojení On-line: No Operační režim (odpojeno), nebo Příkazový režim pouze pro AT příkazy (offline pro datovou komunikaci). Yes On-line režim pro datovou komunikaci. Viz obr. 4 pro vysvětlení režimů a způsobů přepínání mezi nimi. Connected připojeno: No pro Operační režim (odpojeno), IP adresa pro On-line režim a Příkazový režim (připojeno). Viz obr. 4. 2

2. STATUS Režimy už. modulu AT Modem Emulator vysvětluje obrázek níže. Operační režim je počáteční stav, ve kterém se AT Modem Emulator nachází po aktivaci. V obrázku jsou také AT příkazy, kterými je možné režimy přepínat a stav, který je zobrazen na stránce Status. Pro detaily k AT příkazům viz kap. 4. Obrázek 4: AT příkazy pro přepínání režimů už. modulu AT Modem Emulator 2.2 System Log Obrázek 5: System Log Na stránce System Log jsou zobrazeny zprávy logu. Jedná se o stejnou stránku systémového logu, jako je v hlavním menu webového rozhraní routeru. Zprávy uživatelského modulu jsou uvozeny řetězcem atmodemd. Log umožňuje kontrolovat činnost uživatelského modulu, zprávy jsou užitečné při problémech s konfigurací. Zprávy logu je možno stáhnout do počítače jako textový soubor (.log) kliknutím na tlačítko Save Log. Kliknutím na tlačítko Save Report je možné uložit podrobnou zprávu o nastavení (.txt) pro komunikaci s podporou. 3

3. KONFIGURACE 3. Konfigurace Konfigurace už. modulu AT Modem Emulator je přístupná pod položkou AT Modem Emulator v sekci Configuration. Je to také úvodní stránka, která se zobrazí při přístupu z hlavního menu routeru. Pro aktivaci modulu zaškrtněte Enable AT Modem úplně nahoře a dole potvrd te kliknutím na tlačítko Apply. Všechny provedené změny se projeví až po kliknutí na tlačítko Apply. Jednotlivé položky konfigurace jsou popsány v tabulce níže. Položka Expansion Port Obrázek 6: Konfigurace už. modulu AT Modem Emulator Popis Vyberte rozšiřující PORT1 nebo PORT2 routeru (RS-232 or RS- 485/422), na němž bude AT Modem Emulator aktivní. Baudrate Rychlost sériové komunikace. Rozsah 300 až 115200. Data Bits Počet datových bitů u sériové komunikace. 7 nebo 8. Parity Paritní bit u sériové komunikace. None (žádný), even nebo odd. Stop Bits Počet stop bitů u sériové komunikace. 1 nebo 2. Pokračování na následující straně 4

3. KONFIGURACE Položka TCP Port Check TCP connection Keepalive Time Keepalive Interval Keepalive Probes Drop DTR Action S0 (Auto-answer) Pokračování z předchozí strany Popis Port, na němž bude na TCP/IP straně probíhat komunikace. Protější strana nebo TCP server musí komunikovat na stejném portu. Disabled nebo TCP Keepalive. Pokud je nastaveno TCP Keepalive, bude prováděna kontrola TCP spojení za účelem prevence výpadku dle následujících Keepalive parametrů. Interval mezi kontrolami spojení. Jak dlouho čekat, pokud protější strana neodpovídá. Počet pokusů při kontrole spojení, po kterých je hlášeno, že protější strana je nedostupná Výběr akce při poklesu DTR signálu. None (žádná), Off-line (Příkazový režim) nebo Disconnect (zavěšení). Toto může být nastaveno i pomocí AT příkazu &Dn (AT&Dn) viz kap. 4. Automatická kladná odpověd ATA na zprávu o vyzvánění RING. Manual (ručně), Auto 1 (po jedné zprávě RING výchozí) až Auto 5 (po 5 zazvoněních). Více v tab. AT příkazů v kap. 4. S6 (RING Interval) Čas v s mezi zprávami vyzvánění RING. Výchozí hodnota je 5 s, rozsah 2 až 255 s. Více v tab. AT příkazů v kap. 4. S7 (CONNECT timeout) S10 (Hang-up delay) S11 (Split Timeout) S12 (Esc Delays) S25 (DTR Ignore) Configuration Script Syslog Level Čas čekání v s na kladnou odpověd o spojení CONNECT. Výchozí hodnota 10 s, rozsah 1 až 255 s. Více v tab. AT příkazů v kap. 4. Interval, po němž dojde k zavěšení, pokud neprobíhá žádná datová komunikace. Jednotkou jsou desítky s, výchozí hodnotou je 60 x 10 s, rozsah 1 až 255. Více v tab. AT příkazů v kap. 4. Maximální prodleva mezi znaky, aby byly ještě odeslány jako jedna zpráva. Výchozí hodnota je 10 ms, rozsah 0 až 255 ms. Více v tab. AT příkazů v kap. 4. Prodleva před a po Escape sekvenci pro přechod do Příkazového režimu. Jednotkou jsou 1/50 s (20 ms), výchozí hodnotou je 8 x 20 ms, rozsah 0 až 255. Více v tab. AT příkazů v kap. 4. Prodleva v desítkách ms, po kterou jsou ignorovány změny DTR signálu. Nastavená akce se projeví až po tomto čase. Výchozí hodnota 5 x 10 ms, rozsah 0 až 255. Více AT příkazy v kap. 4. Konfigurační skript pro definice substitučních pravidel. Informace v kap. 3.1 níže. Množství logovaných informací (System Log). Warning (nejméně), Notification, Informational, Debugging a Verbose debugging (nejvíce). Tabulka 1: Konfigurace už. modulu AT Modem Emulator. 5

3. KONFIGURACE 3.1 Konfigurační skript Díky konfiguračnímu skriptu je možné definovat substituční pravidla, která pozmění některé přijaté příkazy od připojeného zařízení (DTE) nebo změní standardní odpovědi na některé přijaté AT příkazy. Je tak možné AT Modem Emulator přizpůsobit sériově komunikující aplikaci, jejíž chování někdy nejde (u starších zařízení) upravit. Některá zařízení např. neumějí vytáčet IP adresu. Pokud je zde ale nastavena substituce telefonního čísla za IP adresu, i takové zařízení se pak k dané IP adrese dokáže připojit. Každý řádek konfiguračního skriptu odpovídá jednomu substitučnímu pravidlu. Jsou možné dva typy substitučních pravidel: Substituční pravidlo typu "I": Obecný formát: Ii:text i index - celé číslo v rozsahu od 0 do 9 text znaky od dvojtečky ":" do konce řádku Příklad substitučního pravidla: I4: I am modem emulator Vstup v terminálu (od uživatele nebo aplikace): ATI4 (+ Enter) Výstup v terminálu (od AT Modem Emulator): I am modem emulator OK Substituční pravidlo typu "D": Obecný formát: Dpn:IP pn phone number - telefonní číslo, bez písmen IP IP adresa jako 12 číslic Příklad substitučního pravidla: D+420 123 256:010000002145 Vstup v terminálu (od uživatele nebo aplikace): ATD+420123256 (+ Enter) Výsledek AT Modem Emulator se připojuje k 10.0.2.145 Obecné poznámky k substitučním pravidlům: Substituční pravidla mají přednost před standardním chováním. Příklad 1: AT Modem Emulator je naprogramovaný, aby po zadání příkazu ATI3 zaslal zpět verzi už. modulu. Pokud je ale definování substituční pravidlo I3: a b c, potom zadání příkazu ATI3 vrátí řetězec "a b c". Příklad 2: Standardní odpověd na příkaz ATD010000002145 je pokus o spojení na IP adresu 10.0.2.145. Pokud je ale definováno substituční pravidlo D010000002145:010000002146, je místo toho výsledkem pokus o spojení na IP adresu 10.0.2.146. V definicích substitučních pravidel může být libovolné množství mezer. Mezery mohou být i při zadávání AT příkazů v terminálu nebo aplikací. Konfigurační skript může obsahovat maximálně 100 definic (řádků) substitučních pravidel. 6

4. AT MODEM EMULATOR PROTOKOL 4. AT Modem Emulator protokol Tabulka níže obsahuje přehled podporovaných AT příkazů. Následuje popis sestavení a ukončení spojení a obecné poznámky k použití AT Modem Emulator protokolu. 4.1 Přehled AT příkazů Poznámka: Jiné AT příkazy než v tabulce nejsou už. modulem AT Modem Emulator využity, protože by neměly praktický význam. Přestože odezvou na ně může být zpráva "OK", jsou ignorovány. To je z důvodu kompatibility a možnosti využití standardních programů pro datové (telefonní) modemy. Rozsahy hodnot zadávaných AT příkazy (S-registry) nejsou nijak omezeny. Příkaz Popis Příklad AT Attention pozor řetězec, který je na začátku každého příkazu, kromě +++ a A/. A Answer odpověd na příchozí volání, které je indikováno ATA zprávou RING z protější stanice. A/ Zopakuj poslední příkaz, není nutné vkládat Enter <CR>. A/ D Dial vytočit telefonní číslo nebo IP adresu (12 číslic). ATD10 Číslo/adresa protější stanice následuje po příkazu. E0 Echo příkazy nejsou vypisovány (ECHO OFF). Modem ATE0 nevypisuje zpět do terminálu znaky přijaté od počítače. E1 Echo příkazy jsou vypisovány (ECHO ON) výchozí nastavení. ATE1 Modem vypisuje znaky přijaté od počítače (vidíte co napíšete). H Hangup zavěšení ukončení spojení. Viz obrázek 4. ATH I2 Vrací verzi firmware routeru. ATI2 I3 Vrací verzi uživatelského modulu AT Modem Emulator. ATI3 O Návrat z Příkazového režimu (off-line) do On-line režimu. Viz ATO obrázek 4. Spojení je stále sestaveno. Q0 Quiet mode OFF vypnutí režimu mlčení odpovědi na ATQ0 příkazy jsou odesílány a zobrazeny. Např. OK nebo ERROR. Výchozí nastavení. Q1 Quiet mode ON zapnutí režimu mlčení odpovědi na příkazy ATQ1 nejsou zobrazeny (vraceny) zprávy o výsledcích potlačeny. V0 Verbose OFF zprávy o výsledcích jsou vraceny pouze ve formě čísel návratových kódů. ATV0 Pokračování na následující straně 7

4. AT MODEM EMULATOR PROTOKOL Pokračování z předchozí strany Příkaz Popis Příklad V1 Verbose ON zprávy o výsledcích jsou vraceny ve formě textu ATV1 v angličtině (např. CONNECT, BUSY). Výchozí nastavení. Sr=n Nastavení hodnoty S-registru: ATS0=1 r číslo nastavovaného S-registru, n nová hodnota nastavovaného S-registru. Sr? Vrátí (vypíše) hodnotu r-tého S-registru. ATS10? Z Běžně slouží k resetu modemu před sestavením spojení. Zde ATZ neprovádí reset ani reboot celého routeru, ale pouze reset uživatelského modulu nastavení uložených výchozích hodnot. Odpověd je OK. +++ ESCAPE sekvence pro přepnutí z On-line režimu do příkazového +++ režimu bez přerušení spojení. Viz obrázek 4. Před a po sekvenci musí být odmlčení - časový interval definovaný registrem S12. Znak Escape sekvence lze nastavit v registru S2. Zpět do On-line režimu se lze přepnout příkazem ATO command. &Dn Nastavení akce, kterou AT Modem Emulator provede při poklesu AT&D1 DTR signálu. n udává: 0 AT Modem Emulator ignoruje DTR signál. 1 Přepnutí do Příkazového režimu (spojení stále sestaveno). Stejný efekt má Escape sekvence. 2 Zavěšení (odpojení). 3 Reset už. modulu AT Modem Emulator (stejné jako ATZ). Výsledkem bude také zavěšení. &V Zobrazí aktuální hodnoty stavových proměnných a S-registrů. AT&V Stejně jak jsou zobrazeny na stránce Status ve webovém rozhraní už. modulu. &W Uloží aktuální hodnoty proměnných a S-registrů do konfiguračního AT&W souboru routeru. Tato uložená konfigurace bude použita při resetu modemu příkazem (ATZ) nebo při zapnutí routeru. S0 Tento S-registr určuje způsob reakce na zprávu o volání. Nastavená hodnota určuje počet zpráv RING, po nichž AT Modem Emulator automaticky hovor přijme. 0 je nutné ruční přijetí hovoru odesláním zprávy ATA 1 automatické přijetí hovoru po prvním zazvonění 2 automatické přijetí hovoru po druhém zazvonění atd. ATS0=1 Pokračování na následující straně 8

4. AT MODEM EMULATOR PROTOKOL Pokračování z předchozí strany Příkaz Popis Příklad S1 Počítadlo zazvonění tento S-registr je inkrementován po ATS1 každém přijetí "RING" signálu. Rozsah, který dává smysl je 0 až 255. S2 Znak Escape sekvence speciální znak, který je použit v ATS2=43 sekvenci pro přepnutí z On-line režimu do Příkazového režimu. Viz obrázek 4. Výchozí hodnota je + (43). S3 Definuje netisknutelný znak Enteru (návratu kurzoru na začátek ATS3=13 nového řádku). Výchozí hodnota je CR (13) (klávesa Enter). S4 Definuje znak nové řádky (line feed). Výchozí hodnota je LF ATS4=10 (10). S5 Definuje znak pro mazání (Backspace). Výchozí hodnota je 8 ATS5=8 (klávesa Backspace). S6 Nastavení času v s mezi opakováními zprávy RING když je detekováno ATS6=5 volání od protější strany. Výchozí hodnota je 5 s. S7 Nastavení času, po který AT Modem Emulator čeká na úspěšnou odpověd CONNECT (připojeno). Po tomto intervalu modem pošle zprávu NO RESPONSE (neodpovídá) připojenému zařízení. Výchozí hodnota je 10 s. ATS7=10 S10 S11 S12 S25 Čas v desítkách sekund, po němž bude spojení ukončeno, pokud neprobíhá žádná datová komunikace. 0 znamená, že spojení není automaticky ukončeno. Výchozí hodnota je 60 x 10 s. Maximální časová prodleva mezi dvěma znaky v ms. Zpráva je ukončena a odeslána, pokud tento interval vyprší. Výchozí hodnota je 10 ms, smysluplný rozsah je 0 až 255 ms. Časová prodleva v 1/50 s (20 ms) před a po Escape sekvenci třech znaků pro přepnutí modemu do Příkazového režimu (offline). Výchozí hodnota je 8 x 20 msec. Interval v desítkách ms, po který jsou ignorovány změny DTR signálu. Akce nastavená příkazem AT&D na pokles DTR signálu se projeví až po tomto čase. Výchozí hodnota je 5 x 10 ms. Tabulka 2: Přehled AT příkazů ATS10=60 ATS11=10 ATS12=50 ATS25=5 9

4. AT MODEM EMULATOR PROTOKOL 4.2 Počáteční stav a sestavení spojení Po aktivaci uživatelského modulu AT Modem Emulator (nebo po naběhnutí routeru s aktivovaným už. modulem) je AT Modem Emulator v Operačním režimu viz obr. 4. CD signál je rezervován a modem přijímá AT příkazy od připojeného zařízení nebo počítače (DTE). Typický průběh sestavení spojení: počítačpa ATPModem EmulatorPA ATPModem EmulatorPB počítačpb kontrolapspojení apsynchronizace AT OK resetpmodemu ATZ OK konfigurace parametrůppomocí ATPpříkazů vytáčenípippadresy ATD010000002126 TCP komunikace RING ATA odpověďpnapvolání připojenoppro datovoupkomunikaci CONNECT CONNECT připojenoppro datovoupkomunikaci Obrázek 7: Typický průběh sestavení spojení Nyní je AT Modem Emulator v On-line režimu. CD signál je aktivní a probíhá datová komunikace. Pokud není protější strana na komunikaci připravena, zpráva RING je opakována podle nastavení v registru S1. Po intervalu nastaveném v registru S7 je pak připojenému počítači doručena zpráva NO CARRIER (druhá strana nepřijímá). Pokud protější strana má již sestavené spojení s jiným modemem, je doručena zpráva BUSY (obsazeno). Poznámka Příkaz ATZ vede pouze na reset výchozích hodnot už. modulu AT Modem Emulator, ne na reboot celého routeru. 10

4. AT MODEM EMULATOR PROTOKOL 4.3 Komunikace a režimy už. modulu AT Modem Emulator Pro porozumění režimům ve kterých může AT Modem Emulator operovat a jak se leze mezi režimy přepínat viz obrázek 4 v kap. 2 (AT příkazy jsou naznačeny v obrázku a popsány v tabulce výše). Z připojeného On-line režimu je možné se do Příkazového režimu přepnout pomocí Escape sekvence, spojení bude zachováno. Viz příkaz +++ pro více detailů. Připojená aplikace či počítač (DTE) pak může provádět nastavení parametrů a S-registrů pomocí AT příkazů uvedených v tabulce výše. Návrat do On-line režimu je možný pomocí příkazu ATO. Zavěšení je možné pomocí příkazu ATH. 4.4 Ukončení spojení Existuje více způsobů, jak ukončit spojení: Standardní metodou ukončení spojení je přechod do Příkazového režimu pomocí Escape sekvence "+++" a následné zavěšení příkazem ATH (přépadně ATH0). Je potřeba dodržet časovou prodlevu před a po Escape sekvenci, definovanou v registru S12. Zpráva o ukončení spojení je poslána protějšímu modemu a ten zašle připojenému počítači zprávu NO CARRIER. Další možností je nastavit akci na pokles DTR signálu. Viz příkaz &D v tabulce výše (AT&D2). Pokud je detekován pokles DTR signálu v On-line režimu, AT Modem Emulator bude čekat čas S25 a potom se odpojí (zavěsí). Pokud neprobíhá již žádná datová komunikace, dojde k automatickému odpojení (zavěšení) po čase S10. 11

5. DOPORUČENÁ LITERATURA 5. Doporučená literatura [1] Conel: Konfigurační manuál pro v2 routery [2] Conel: Konfigurační manuál pro v3 routery 12