4.2 SMS Konfigurace

V této kapitole je popsána konfigurace produktu 2N^® SmartCom PRO pomocí krátkých textových zpráv (SMS).

Tyto SMS slouží k základnímu nastavení terminálu. Seznámíme se s jejich základním použitím. Pro správnou funkci budete potřebovat znát telefonní číslo SIM karty vložené do 2N^® SmartCom PRO.

Popis funkce

2N^® SmartCom PRO je možné konfigurovat pomocí SMS zpráv. Tyto SMS zprávy odešlete na číslo SIM karty vložené do terminálu. Při použití této funkce je třeba dbát na několik parametrů. Pokud nebude souhlasit některý parametr zprávy, nebude SMS zpracována a bude odeslána chybová odpověď.

INFO SMS

V případě, že potřebujete zjistit operátora, IMSI, IMEI nebo sériové číslo 
2N^® SmartCom PRO, lze tak učinit odesláním zprávy ve tvaru:

SC INFO PWD=<heslo>

Na tuto SMS zprávu dostanete odpověď například v následujícím tvaru.

SIG=-71dBm OPER=T-Mobile CZ IMSI=230015001155344 IMEI=355915030750962 SN=50-0369-0080 LIP=89.24.0.141 FW=1.2.0.2.4 STAT=CONNECTED

Pro módy TCP a UDP client je odpověď následující:

SIG=<signal_level> OPER=<operator> IMSI=<sim_card_imsi> IMEI=<module_imei>
SN=<terminal_serial_number> LIP=<local_ip> FW=<terminal_fw_version> STAT=<current_terminal_status>

Pro STANDALONE mód je odpověď následující:

SIG=<signal_level> OPER=<operator> IMSI=<sim_card_imsi> IMEI=<module_imei> SN=<terminal_serial_number><br>LIP=<local_ip> FW=<terminal_fw_version> STAT=LISTENING

Jednotlivé parametry v odpovědní SMS mají následující význam.

• <password> – autentizační heslo. Heslo je nutné nejprve nastavit (konfigurační parametr AUTH_PASS).
• <signal_level> – aktuální úroveň signálu ve formátu „-XXXdBm".
• <operator> – název operátora v dlouhém formátu (jméno, ne číslo).
• <sim_card_imsi> – IMSI číslo vložené SIM karty.
• <module_imei> – IMEI číslo GSM/UMTS modulu.
• <terminal_serial-number> – výrobní číslo ve tvaru „xx-xxxx-xxxx".
• <local_ip> – lokální adresa terminálu. (přidělená operátorem)
• <terminal_fw_version> – verze firmwaru v terminálu.
• <current_terminal_status> – aktuální stav terminálu (jen v client módu).
  • CONNECTING – terminál se připojuje ke 2N^® SmartCOM Serveru.
  • CONNECTED – terminál je připojen ke 2N^® SmartCOM Serveru.
  • LISTENING – terminál je ve STANDALONE módu.
  • DATA-OFF – terminál je v DATA_OFF módu.

Základní nastavení

Parametry nastavované touto konfigurační SMS jsou důležité pro správnou funkci terminálu. Lze nastavovat parametry připojení k mobilnímu operátorovi, 
2N^® SmartCOM Serveru, měnit mód zařízení a aktivovat autorizaci na RS 232.

V případě, že potřebujete zjistit aktuální nastavení těchto parametrů, můžete tak učinit jednoduše pomocí následujícího příkazu:

SC CNF PWD=<heslo>

Na tuto SMS zprávu dostanete odpověď například v následujícím tvaru:

MODE=1 232LCK=0 APN=publicip.t-mobile.cz DUSR= DPWD= IPS=90.182.112.51 PORTS=1620 CHPRIM=GSM

Složení konfigurační SMS a všechny nepovinné parametry si popíšeme nyní. 

SC CNF PWD=<heslo> [MODE=<mode>] [232LCK=<rs232_lock>] [APN=<gprs_apn>] [DUSR=<gprs_data_user>] [DPWD=<gprs_data_password>]<br>[IPS=<server_ip_address>] [PORTS=<server_port>] [CHPRIM=<primary_channel>] [NPWD=<new_password>]

Parametry uvedené v hranatých závorkách je možné vynechat. Jsou nepovinné. Jediný povinný údaj je heslo! Význam jednotlivých parametrů příkazu CNF je následující:

• PWD=<heslo> – autentizační heslo. Heslo je nutné nejprve nastavit (konfigurační parametr AUTH_PASS). Tento parametr je jako jediný v této konfigurační SMS povinný!
• MODE=<mode> – příkaz provádí změnu módu. Zadává se v číselném tvaru:
  
  • 1 – TCP Client
  • 3 – STANDALONE
  • 4 – DATA OFF
• 232LCK=<rs232_lock> – nastaví autorizaci na RS232 portu. To znamená, že se bude, pro připojení přes tento port, nutné autorizovat zadáním hesla. 0 = vypnuto, 1 = zapnuto.
• APN=<gprs_apn> – název přístupového bodu daného operátora.
• DUSR=<gprs_data_user> – uživatelské jméno pro připojení k operátorovi.
• DPWD=<gprs_data_password> – heslo pro připojení k operátorovi.
• IPS=<server_ip_address> – IP adresa 2N^® SmartCOM Serveru (použije se v Client módu).
• PORTS=<server_port> – naslouchací port serveru pro připojení terminálu (použije se v Client módu).
• CHPRIM=<primary_channel> – nastaví primárně používaný kanál datového spojení. Zadává se jako text:
  • ETH
  • GSM
• NPWD=<new_password> – nové autorizační heslo.

Příklad konfigurační SMS

Chceme změnit výchozí heslo na nové (heslo1) a zároveň nastavit nové APN na „internet.open". Spolu s tím nastavíme také IP adresu serveru na 90.89.126.3 a naslouchací port na 1658. Toto je asi nejčastější způsob nastavení.

Odešleme tedy SMS v následujícím tvaru:

SC CNF PWD=heslo APN=internet.open IPS=90.89.126.3 PORTS=1658 NPWD=heslo1

Na tuto konfigurační SMS dostaneme, po zpracování, od terminálu následující odpověď:

MODE=1 232LCK=0 APN=internet.open DUSR= DPWD= IPS=90.89.126.3 PORTS=1658

Error buffer

Každý terminál má v sobě implementován buffer, do kterého zapisují chyby, ke kterým při jeho provozu došlo. Obsah tohoto zásobníku je možné zobrazit dvěma způsoby. Pomocí terminálu (AT příkazem) nebo SMS zprávou. V případě použití SMS bude zobrazeno posledních 10 chybových hlášení v pořadí od nejnovější po nejstarší. 

Použijeme SMS ve tvaru:

SC ERR PWD=<heslo> [CLR]

• CLR – smaže error buffer.

Na tuto SMS dostaneme, po zpracování, od terminálu následující odpověď:

1:8,10 2:3,10 1:1,0 7:8,10 6:8,7 5:7,40 4:11,848

V případě že v error bufferu není žádná chyba dostanete odpověď ve tvaru:

NO ERROR

Ovládání relé

Každý terminál je osazen dvěma reléovými výstupy. Obě relé lze ovládat pomocí SMS zpráv. Konfigurační SMS musí obsahovat parametr heslo a minimálně jeden ze čtyř konfigurovatelných parametrů. 

Jejich významy jsou následující:

• R1 nebo R2 – určuje, o která relé se jedná. Parametr může nabývat dvou hodnot:
  • 1 – relé je sepnuto
  • 0 – relé je rozepnuto
• S1 nebo S2 – určuje, v jakém stavu se má dané relé nacházet po restartu terminálu. Může nabývat následujících hodnot:
  • 1 – relé je po restartu sepnuto
  • 0 – relé je po restartu rozepnuto
  • 2 – relé si zapamatuje stav před restartem

Příklad:

Chceme přepnout relé jedna do stavu rozepnuto a po restartu ho chceme mít sepnuté, a zároveň chceme relé 2 sepnout a zapamatovat si jeho stav. Použijeme tedy konfigurační SMS ve tvaru:

SC REL PWD=heslo R1=0 R2=1 S1=1 S2=2

Příkaz se provede a Terminál odešle odpověď ve tvaru:

R1=0 R2=1 S1=1 S2=2

IP Access

Pomocí SMS zpráv lze nastavovat i autorizaci přístupu podle IP adres. Pokud bude IP Access zapnutý, bude omezen přístup do konfigurace terminálu. Pouze vyjmenované IP adresy se budou moci připojit. Je možné specifikovat až 5 různých IP adres.

Konfigurační SMS má následující tvar:

SC IPA PWD=<heslo> [AUTH=<ip_auth>][ADD=<ip_addr>] [DEL=<ip_id>] [REP=<ip_addr_1>,<ip_addr_2>,...<ip_addr_5>]

Složení konfigurační SMS a všechny nepovinné parametry si popíšeme nyní. 

Parametry uvedené v hranatých závorkách je možné vynechat. Jsou nepovinné. Jediný povinný údaj je heslo! Význam jednotlivých parametrů příkazu IPA je následující:

• PWD=<heslo> – autentizační heslo. Heslo je nutné nejprve nastavit (konfigurační parametr AUTH_PASS). Tento parametr je jako jediný v této konfigurační SMS povinný!
• AUTH=<ip_auth> – příkaz provádí změnu módu. Zadává se v číselném tvaru:
  
  • 0 – vypnuto
  • 1 – zapnuto
• ADD=<ip_addr> – parametr přidá na konec seznamu zvolenou IP adresu.

• DEL=<ip_id> – smaže IP adresu na dané pozici v seznamu.

• REP=<ip_addr_1>,<ip_addr_2>,…<ip_addr_5> – nahradí stávající seznam adres novým. 

Příklad:

Chceme zjistit, zda je IP access zapnutý. Odešleme SMS ve tvaru:

SC IPA PWD=<heslo>

Na kterou dostaneme např. následující odpověď:

AUTH=1 1:90.156.29.195 2:109.54.2.234

Nyní IP access vypneme a smažeme všechny IP adresy ze seznamu. Odešleme tedy SMSve tvaru:

SC IPA PWD=heslo AUTH=0 DEL=0

Načež dostaneme po zpracování od terminálu následující odpověď:

AUTH=0 NO IP

Nastavení AMS

Pomocí těchto SMS máte možnost provést detekci a přiřazení M-Bus měřičů do tabulky AMS a vyčtení aktuální tabulky měřičů. 

SC AMS PWD=<heslo>

Kontrola nainstalovaných měřičů.

• PWD=<heslo> – autentizační heslo. Heslo je nutné nejprve nastavit (konfigurační parametr AUTH_PASS). Tento parametr je v této konfigurační SMS povinný!
  

Po zpracování dostanete od terminálu následující odpověď:

<session>:<id_zpravy>> QTY=n address#1:protocol:port:interval address#2:protocol:port:interval,..., address#N:protocol:port:interval

Význam jednotlivých parametrů zprávy

• <session> – id vlákna komunikace – číslo 1–100
• <id_zpravy> – číslo zprávy v daném komunikačním vlákně 
• QTY – počet zařízení v tabulce měřičů
• address – primární_adresa
• *address – *sekundární_adresa
• ostatní parametry jsou popsány níže

SC AMSADD PWD=<heslo> QTY=<n> PORT=<port> PROTOCOL=<protocol> INT=<interval> BAUDRATE=<hodnota>

Automatická instalace měřičů.

Složení konfigurační SMS a její parametry si popíšeme nyní.

• PWD=<heslo> – autentizační heslo. Heslo je nutné nejprve nastavit (konfigurační parametr AUTH_PASS). Tento parametr je v této konfigurační SMS povinný!
• QTY=<n> – počet detekovaných zařízení – číslo
  • Udává počet zařízení, která by měla být připojena na sběrnici, a tudíž by měla být detekována. Tento počet musí souhlasit, pokud se detekuje jiný počet zařízení, bude vyhlášena chyba (65286).
• PORT=<port> – číslo fyzického portu, na které je dané zařízení připojeno – číslo
  • 1 – komunikační port RS232
  • 2 – komunikační port RS232/RS485/MBUS (konkrétní varianta dle HW provedení)
• PROTOCOL=<protocol> – jméno nebo číslo komunikačního protokolu, pomocí něhož se se zařízením komunikuje
  • pro číslo:
    
    • 2 – označuje protokol M-BUS
  • pro textový řetězec:
    
    • "MBUS" – označuje protokol M-BUS
• INT=<interval> – textový řetězec symbolu časového intervalu (počet minut nebo hodin nebo dnů), možné hodnoty jsou:
  • "1M", "2M", "3M", "4M", "5M", "6M", "10M", "12M", "15M", "20M", "30M", "1H", "2H", "3H", "4H", "6H", "8H", "12H", "1D" 
• BAUDRATE=<hodnota> – komunikační rychlost, číslo udávající baudovou komunikační rychlost. Není-li parametr uveden, bude použita výchozí rychlost: 9600. Možné hodnoty nastavení:
  • "300", "600", "1200", "2400", "4800", "9600", "19200", "38400"

Po přijetí příkazu dostanete od terminálu následující odpověď:

<session>:<id_zpravy>> AMSADD started

Význam jednotlivých parametrů zprávy

• <session> – id vlákna komunikace – číslo 1–100
• <id_zpravy> – číslo zprávy v daném komunikačním vlákně "1"

Po zpracování dostanete od terminálu následující odpověď:

<session>:<id_zpravy>> QTY=n ERR=error_code address#1, address#2,..., address#N

Význam jednotlivých parametrů zprávy:

• <session> – id vlákna komunikace – číslo 1–100
• <id_zpravy> – číslo zprávy v daném komunikačním vlákně "2"
• QTY – počet nalezených měřičů
• ERR – číslo chybového kódu (Jednotlivé kódy jsou popsány v tabulce Chyby zákaznického ONF v kapitole 3.8)
• address – primární_adresa
• *address – *sekundární_adresa 

SC AMSDEVADD PWD=<heslo> PORT=<port> PROTOCOL=<protocol> ADDR=<adresa> INT=<interval> [INIT=<init_value>]

Ruční instalace měřičů:

Složení konfigurační SMS a její parametry si popíšeme nyní.

• PWD=<heslo> – autentizační heslo. Heslo je nutné nejprve nastavit (konfigurační parametr AUTH_PASS). Tento parametr je v této konfigurační SMS povinný!
• PORT=<port> – číslo fyzického portu, na které je dané zařízení připojeno – číslo
  • 1 – komunikační port RS232
  • 2 – komunikační port RS232/RS485/MBUS (konkrétní varianta dle HW provedení)
  • 128 – komunikační port pro komunikaci s interním modulem A/D vstupů (modul analogových/digitálních vstupů)
    
• PROTOCOL=<protocol> – jméno nebo číslo komunikačního protokolu, pomocí něhož se se zařízením komunikuje
  • pro číslo:
    
    • 1 – označuje protokol IEC 62056-21
    • 2 – označuje protokol M-BUS
    • 128 – označuje protokol pro čtení A/D vstupů (protokol pro čtení dat z modulu analogových/digitálních vstupů)
  • pro textový řetězec:
    • "IEC62056-21" – označuje protokol IEC 62056-21
    • "MBUS" – označuje protokol M-BUS
    • "AIN_DIN" – označuje protokol A/D vstupů (protokol pro čtení dat z modulu analogových/digitálních vstupů)
• ADDR=<adresa> – adresa zařízení (shodná s adresami zadávanými pro AMS viz kapitola 3.8)
• INT=<interval> – textový řetězec symbolu časového intervalu (počet minut nebo hodin nebo dnů), možné hodnoty jsou:
  • "1M", "2M", "3M", "4M", "5M", "6M", "10M", "12M", "15M", "20M", "30M", "1H", "2H", "3H", "4H", "6H", "8H", "12H", "1D" 
• INIT=<init_value> – nepovinný parametr mající význam pouze u digitálních pulsních vstupů, kde se jedná o hodnotu, na kterou má být nastaven příslušný čítač pulsů na zvoleném vstupu.

Po přijetí příkazu dostanete od terminálu následující odpověď:

<session>:<id_zpravy>> AMS device added

Význam jednotlivých parametrů zprávy

• <session> – id vlákna komunikace – číslo 1–100
• <id_zpravy> – číslo zprávy v daném komunikačním vlákně "1"

Restart

Pomocí SMS zprávy lze provést systémový restart terminálu nebo hard restart GSM/UMTS modulu. Po zaslání této SMS a jejím přijetí budete informování odpovědí. Následně se příkaz provede. Systémový restart provede restart terminálu jako celku, podobně jako při odpojení napájení. Chcete-li provést reset pouze samotného GSM/UMTS modulu, který neovlivní funkci dalších periferií, použijte příkaz GSM Hard reset.

SMS pro systémový restart má následující tvar:

SC SRST PWD=<heslo>

• PWD=<heslo> – autentizační heslo. Heslo je nutné nejprve nastavit (konfigurační parametr AUTH_PASS). Tento parametr je v této konfigurační SMS povinný!

Načež dostaneme po zpracování od terminálu následující odpověď:

System Reset Initialized

SMS pro vynucený restart GSM/UMTS modulu má následující tvar:

SC GSMHRST PWD=<heslo>

• PWD=<heslo> – autentizační heslo. Heslo je nutné nejprve nastavit (konfigurační parametr AUTH_PASS). Tento parametr je v této konfigurační SMS povinný!

Načež dostaneme po zpracování od terminálu následující odpověď:

GSM Hard Reset Initialized

Factory reset

Pomocí SMS zprávy lze také iniciovat factory reset terminálu. Po zaslání této SMS a jejím přijetí budete informování odpovědí. Následně se provede reset do továrního nastavení.

SMS má následující tvar:

SC FRES PWD=<heslo>

• PWD=<heslo> – autentizační heslo. Heslo je nutné nejprve nastavit (konfigurační parametr AUTH_PASS). Tento parametr je v této konfigurační SMS povinný!

Načež dostaneme po zpracování od terminálu následující odpověď:

<session>:<id_zpravy> Factory Reset Initialized

Význam jednotlivých parametrů zprávy:

• <session> – id vlákna komunikace – číslo 1–100
• <id_zpravy> – číslo zprávy v daném komunikačním vlákně 

Chybové odpovědi

V případě, že je v konfigurační SMS chyba nebo došlo k chybě během zpracování příkazů, 2N^® SmartCom PRO vás na tuto chybu upozorní chybovou odpovědí. Pokud Terminál takovou odpověď vygeneroval, příkaz nebyl proveden!

Je možné se setkat s následujícími chybami:

• ERR Unknown command – byl zadán neznámý příkaz. Jsou povoleny pouze tyto příkazy (INFO, CNF, ERR, REL, IPA).
• ERR Password missing – konfigurační SMS neobsahuje heslo. Tím je míněn řetězec PWD="heslo".
• ERR Password incorrect – zadané heslo není správné.
• ERR Too many parameters – délka konfigurační SMS přesáhla povolených 160 znaků. Nebo byla odeslána jako 16bitová (s diakritikou nebo nestandardními znaky).
• ERR Unknown parameter – některý zadaný parametr příkazu neodpovídá povoleným parametrům. Všechny povolené parametry naleznete u jednotlivých příkazů.
• ERR Parameter value incorrect – hodnota parametru je mimo povolenou mez.