AT pˇríkazy ˇ PRÍRU ˇ ˇ APLIKACNÍ CKA
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, 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. Příklad ukázka použití daných funkcí, přikazů či skritpů. Conel s.r.o., Sokolská 71, 562 04 Ústi nad Orlicí, Česká Republika Příručka byla vydána v ČR, 9. prosince 2014 i
OBSAH Obsah 1 Popis jednotlivých AT příkazů 1 1.1 ATE.......................................... 1 1.2 AT+CMGF....................................... 1 1.3 AT+CMGS....................................... 1 1.4 AT+CMGL....................................... 2 1.5 AT+CMGR...................................... 2 1.6 AT+CMGD...................................... 3 1.7 AT+CPMS....................................... 3 1.8 AT+CSCA....................................... 3 1.9 AT+CSCS....................................... 3 1.10 AT+CPIN....................................... 4 1.11 AT+CREG....................................... 4 1.12 AT+CSQ........................................ 5 1.13 AT+CGMM...................................... 5 1.14 AT+CGMM...................................... 5 1.15 AT+GSN........................................ 5 1.16 AT+CIMI........................................ 5 1.17 ATI........................................... 6 1.18 AT+CGPADDR.................................... 6 1.19 AT+CMGW...................................... 6 1.20 AT+CMSS....................................... 6 1.21 AT+COPS?...................................... 6 1.22 AT+GMI........................................ 7 1.23 AT+CGMI....................................... 7 1.24 AT+GMR....................................... 7 1.25 AT+CGMR...................................... 7 1.26 AT+CGSN....................................... 7 2 Seznam AT příkazů 8 ii
1. Popis jednotlivých AT příkazů Po sestavení spojení s routerem přes sériové rozhraní či Ethernet je možné pomocí AT příkazů pracovat s SMS zprávami. V příručce jsou uvedeny pouze ty příkazy, které jsou podporovány routery firmy Conel. Na ostatní AT příkazy je vždy posílána odpověd. Není podporováno zpracování složených AT příkazu (oddělených středníkem), tudíž na ně router posílá odpověd ERROR. 1.1 ATE Příkazu ATE<value> se také někdy říká Příkaz ozvěny, nebot umožňuje vracet zadané příkazy zpět odesílateli (příkazy se tzv. ozývají). Standardně je tato funkce vypnuta, může však být užitečná například pro účely ladění. <value> je 0 funkce je vypnuta <value> je 1 funkce je zapnuta ATE1 1.2 AT+CMGF Pro nastavení režimu psaní SMS zpráv je používán příkaz AT+CMGF=<mode>. <mode> je 0 PDU formát <mode> je 1 textový režim AT+CMGF=1 1.3 AT+CMGS Tento příkaz umožňuje poslat SMS na uvedené telefonní číslo. Po zadaní příkazu ve tvaru AT+CMGS="číslo" a zmáčknutí klávesy se zobrazí znak >, za nějž je možné napsat vlastní text SMS zprávy. Pro odeslání se poté použije kombinace kláves CTRL+Z (odesílání SMS zprávy nějakou dobu trvá). Psaní zprávy se zruší klávesou Esc. AT+CMGS="465717171" >Hello World! CTRL+Z (klávesová zkratka) 1
1.4 AT+CMGL Pomocí tohoto příkazu lze vyčítat uložené SMS zprávy. Pokud příkaz použijeme ve tvaru AT+CMGL="ALL", získáme seznam všech uložených SMS zpráv. Má-li vyčítaná zpráva status přijatá nepřečtená, změní se na přijatá přečtená. Pro každou zprávu se zobrazí řetězec, který má následující podobu: +CMGL: <index>, <status>,<číslo odesílatele>,,<datum>,<čas> Text SMS zprávy Jednotlivé položky mají postupuně tento význam: <index> pořadové číslo SMS zprávy, <status> status SMS zprávy: REC UNREAD SMS zpráva nepřečtena REC READ SMS zpráva přečtena STO UNSENT uložená neodeslaná SMS zpráva STO SENT uložená odeslaná SMS zpráva ALL všechny SMS zprávy <číslo odesílatele> telefonní číslo, od kterého byla SMSka přijata, <datum> datum přijmutí SMS zprávy, <čas> čas přijmutí SMS zprávy. AT+CMGL="ALL" +CMGL: 1,"REC UNREAD","+420465717171",,"08/02/02, 10:33:26+04" Hello World! 1.5 AT+CMGR Použitím příkazu AT+CMGR=<index> je možné přečíst konkrétní SMS zprávu, jejíž umístění specifikuje <index>. Má-li vyčítaná zpráva status přijatá nepřečtená, změní se na přijatá přečtená. Pro každou zprávu se zobrazí řetězec, který má následující podobu: +CMGR: <index>,<status>,<číslo odesílatele>,,<datum>,<čas> Text SMS zprávy Význam jednotlivých položek je popsán v předchozím příkaze AT+CMGL. AT+CMGR=1 +CMGR: 1,"REC READ","+420465717171",,"08/01/12, 9:48:04+04" Hello World! 2
1.6 AT+CMGD Tímto příkazem lze smazat SMS zprávu ze specifikovaného umístění <index>. AT+CMGD=1 1.7 AT+CPMS AT+CPMS=<mem1>,<mem2>,<mem3> definuje typ paměti pro práci s SMS. Pro SIM kartu je použito označení "SM". Očekávanou odpovědí je řetězec ve formátu +CPMS: <used1>,<max1>,<used2>,<max2>,<used3>,<max3>, kde položky used udávají aktuální počet uložených SMS zpráv v dané paměti a položky max udávají maximální počet SMS zpráv, který na dané paměti může být uložen. AT+CPMS="SM","SM" +CPMS: 1,10,1,10 1.8 AT+CSCA Tento příkaz umožňuje změnit číslo servisního střediska pro SMS zprávy. AT+CSCA="+491710760000" 1.9 AT+CSCS Pro změnu používané znakové sady slouží příkaz AT+CSCS=<set>. Pokud tento příkaz zadáte ve tvaru AT+CSCS=?, získáte seznam podporovaných znakových sad. AT+CSCS=? +CSCS: ("GSM","IRA","HEX") AT+CSCS="HEX" 3
1.10 AT+CPIN AT příkaz AT+CPIN? se používá k dotazování, zda je očekáván PIN kód. Jestliže je odpověd +CPIN: READY, znamená to, že SIM karta nevyžaduje zadání PINu a je připravena k použití. Pokud SIM karta PIN kód vyžaduje (odpověd je +CPIN: SIM PIN), lze jej nastavit příkazem AT+CPIN=<PIN>. Jestliže je PIN kód zadán více než třikrát špatně, karta se zablokuje a je vyžadován kód PUK. Odpověd tak bude +CPIN: SIM PUK. AT+CPIN="2654" 1.11 AT+CREG Zobrazuje stav registrace v síti. Po zadání příkazu AT+CREG? přijde odpověd, která má následující tvar kde <n> odpovídá jedné z těchto hodnot: +CREG: <n>,<stat>, 0 zakázané automatické hlášení změny registrace 1 povolené automatické hlášení změny registrace a <stat> (stav registrace) odpovídá jedné z těchto hodnot: 0 neregistrováno, nový operátor se nehledá 1 registrováno, domácí sít 2 neregistrováno, hledá se nový operátor 3 registrace se nezdařila 4 neznámý stav 5 registrováno, zahrniční sít (roaming) Zadáme-li AT+CREG=<n>, kde parametr <n> je jedna z výše popsaných hodnot, zakážeme či povolíme automatické hlášení změny registrace. AT+CREG=1 4
1.12 AT+CSQ Pokud nás zajímá kvalita signálu, zadáme příkaz AT+CSQ. Dostaneme odpověd ve tvaru +CSQ: <rssi>,<ber>, kde <rssi> je úroveň přijmu a nabývá hodnot 0 (-113 dbm a nižší) až 31 (-51 dbm a vyšší), nebo 99 pokud nemohla být změřena. Parametr <ber> je četnost bitových chyb. Může být zjištěna pouze při hovoru, v ostatních případech vykazuje hodnotu 0 nebo 99 podle SIM karty. Pokud mohla být změřena, nabývá hodnot 0 až 7. AT+CSQ +CSQ: 28,99 1.13 AT+CGMM Použitím tohoto příkazu lze zobrazit identifikační označení zařízení. AT+CGMM +CGMM: "UCR11 v2" 1.14 AT+CGMM Viz předchozí příkaz AT+CGMM... 1.15 AT+GSN Pro zobrazení sériového čísla zařízení je používán příkaz AT+GSN. AT+GSN +GSN: "5700001" 1.16 AT+CIMI Tento příkaz vrací hodnotu čísla označovaného jako IMSI. Jedná se o unikátní číslo přidělené mobilním operátorem pro SIM kartu v mobilní síti. IMSI většinou obsahuje 15 číslic. První tři representují kód země (MCC), další kód mobilního operátora (MNC). MNC se skládá většinou ze dvou (v Evropě) nebo ze tří (Severní Amerika) číslic. Další cifry představují číslo zákazníka MSIN unikátní v rámci sítě mobilního operátora. Pro Českou republiku je určeno MCC 230. Jednotliví operátoři mají postupně přidělena tato MNC: 01 T-Mobile, 02 O2 a 03 Vodafone. 5
1.17 ATI Pomocí příkazu ATI<hodnota> lze získat základní informace poskytované výrobcem. Parametr <hodnota> slouží k volbě mezi více typy identifikačních údajů. K dispozici jsou číslice počínaje nulou, která odpovídá příkazu AT+GMM. 1.18 AT+CGPADDR Chceme-li vypsat IP adresu rozhraní ppp0, využijeme AT příkaz AT+CGPADDR. 1.19 AT+CMGW Příkaz AT+CMGW umožňuje ukládat SMS zprávy do paměti. Po zadaní tohoto příkazu ve tvaru AT+CMGW="delka" (parametr udává maximální délku zprávy v bytech) a zmáčknutí klávesy se zobrazí znak >, za nějž je možné napsat vlastní text SMS zprávy. Pro uložení je poté nutné použít kombinaci kláves CTRL+Z. Jako odpověd dostaneme informaci o pozici, na kterou byla zpráva uložena. Psaní zprávy se zruší klávesou Esc. AT+CMGW="140" >Hello World! +CMGW: 2 CTRL+Z (klávesová zkratka) 1.20 AT+CMSS Na základě zadaného indexu odesílá SMS zprávu uloženou v paměti na dané pozici. Tato pozice odpovídá hodnotě, kterou vrací příkaz AT+CMGW. Odpovědí pak je pořadové číslo přiřazené dané SMS zprávě. AT+CMSS=2 +CMSS: 12 1.21 AT+COPS? Pro identifikaci dostupných mobilních sítí slouží příkaz AT+COPS?. Po jeho zadání a stisknutí klávesy, se zobrazí výpis ve tvaru: +COPS: <mode><format><operator>, kde parametr <mode> specifikuje režim volby sítě: 6
0 automatický 1 manuální 2 neregistrováno (dokud nebude zvolena jiná hodnota) 4 manuální/automatický (selže-li manuální použije se automatický) a <operator> je označení operátora, jehož formát udává parametr <format>: 0 dlouhý alfanumerický formát 1 krátký alfanumerický formát 2 číselný formát AT+COPS? +COPS: 0,0,"O2 - CZ" 1.22 AT+GMI Použitím tohoto příkazu lze identifikovat výrobce daného zařízení. AT+GMI +GMI: CONEL 1.23 AT+CGMI Viz předchozí příkaz AT+GMI... 1.24 AT+GMR Tento příkaz vrací informaci o verzi systému. 1.25 AT+CGMR Viz předchozí příkaz AT+GMR... 1.26 AT+CGSN Viz příkaz AT+CGSN... 7
2. SEZNAM AT PŘÍKAZŮ 2. Seznam AT příkazů Příkazy jsou uvedeny v abecedním pořádku. AT příkaz AT+CGMI AT+CGMM AT+CGMR AT+CGPADDR AT+CGSN AT+CIMI AT+CMGD AT+CMGF AT+CMGL AT+CMGR AT+CMGS AT+CMGW AT+CMSS AT+COPS? AT+CPIN AT+CPMS AT+CREG AT+CSCA AT+CSCS AT+CSQ AT+GMI AT+GMM AT+GMR AT+GSN ATE ATI Popis Identifikuje výrobce daného zařízení Vypisuje identifikační označení zařízení Vypisuje informaci o verzi systému Vrací IP adresu rozhraní ppp0 Zobrazí sériové číslo zařízení Vrací hodnotu čísla označovaného jako IMSI (unikátní číslo pro SIM kartu) Mazání SMS zprávy podle jejího indexu Nastavuje režim psaní SMS zpráv Vypisuje seznam uložených SMS zpráv Čtení určité SMS zprávy (všechny SMS mají svůj index) Posílá SMS na uvedené telefonní číslo Ukládá zprávu do paměti Odesílá zprávu z paměti (na základě zadané pozice zprávy) Identifikuje aktuálně dostupné mobilní sítě Dotazování a zadávání PIN kódu SDefinuje pamět pro práci s SMS Zobrazuje stav registrace v síti Nastavuje číslo servisního střediska pro SMS zprávy Nastavuje používanou znakovou sadu Udává kvalitu přijímaného signálu Identifikuje výrobce daného zařízení Vypisuje identifikační označení zařízení Vypisuje informaci o verzi systému Zobrazí sériové číslo zařízení Stylem ozvěny vrací zadané příkazy odesílateli Zobrazuje základní informace poskytované výrobcem Tabulka 1: Seznam AT příkazů 8