5.7.1 Příkazy
Záložka Příkazy slouží k povolení jednotlivých příkazů zasílaných pomocí SMS. Uživatel musí být přihlášen.
 |
- Čtení informací (INF) – příkaz pro zaslání SMS obsahující základní informace (signál, použitá technologie mobilní sítě, kód a jméno operátora, stav baterie).
- Čtení parametrů (GET) – příkaz pro zaslání SMS obsahující informace vybraných parametrů.
- Změna parametrů (SET) – příkaz pro změnu parametrů v nastavení.
- Změna hesla (PWD) – příkaz pro změnu hesla zařízení.
- Tovární nastavení (DEF) – příkaz pro obnovení továrního nastavení zařízení.
- Restart (RST) – příkaz pro provedení restartu zařízení.
| SMS příkaz | Formát SMS | Poznámka |
|---|---|---|
| Čtení informací (INF) | EG INF <pwd> | Odpověď příkazu obsahuje informace o sériovém číslu zařízení, verzi FW, čísla IMEI a IMSI, roamingu, síle signálu, stavu síťového napájení, stavu baterie a doby do výměny baterií. Obsah odpovědi lze nastavit pomocí parametru Formát INF zprávy. V případě použití 2 SIM karet v zařízení budou v SMS odpovědi zaslány obě znění IMSI, ostatní informace se týkají pouze aktivní SIM karty. |
| Čtení parametrů (GET) | EG GET <pwd> <p1> [<p2> [<p3> …]] | Např.: EG GET initial_pasword 150 swg_enable sim1_pin (příkaz pro získání informace o nastavení My2N, funkce SMS na zařízení a PIN kódu SIM 1) |
| Změna parametrů (SET) | EG SET <pwd> <p1>=<v1> [<p2>=<v2> [<p3>=<v3> …]] | Tento příkaz umožňuje změnu hodnot parametrů, konfigurovatelným parametrům musí být přiřazena čísla. Pokud je zadáván parametr jako text, musí být uzavřen v kulatých závorkách. Např.: EG SET initial_pasword 150=1 sgw_period=60 sim1=1234 243=(internet.t-mobile.cz) (příkaz pro povolení služby My2N, nastavení periody INF zprávy na každých 60 minut, změna PIN kódu SIM 1 na 1234 a nastavení APN) |
| Změna hesla (PWD) | EG PWD <pwd> <new_pwd> | Např.: EG PWD initial_pasword amber Nové znění počátečního hesla bude nastaveno jako amber. |
| Tovární nastavení (DEF) | EG DEF <pwd> | Např.: EG DEF amber Zasláním příkazu dojde k obnovení továrního nastavení, po kterém bude následovat restart zařízení. |
| Restart zařízení (RST) | EG RST <pwd> | Např.: EG RST amber Dojde k restartu zařízení. |
| Odezva (OK / ERR) | EG [OK|ERR] msg=<msg> cmd=<cmd> seq=<seq> | |
| Odezva se zadanou hodnotou (VAL / INF) | EG [VAL|INF] <p1>=<v1> [<p2>=<v2> …] |
| Události |
|---|
| EG EVT power=[charge|backup|fully|error] |
| EG EVT start |
| EG EVT slot=[1|2] |
| EG EVT input=[0|1] missed=<num> |
| Popisy | ||
|---|---|---|
| <pwd> | heslo pro autorizaci | |
| <new_pwd> | nové heslo pro autorizaci | |
| <pn> | parametr (viz param nebo param_id) | |
| <vn> | číselná hodnota nebo textová hodnota v závorkách | |
| <msg> | Detailní popisy | |
| úspěšný | ||
| neznámý příkaz | ||
| nesprávně zadané heslo | ||
| nesprávně zadaný parametr | ||
| nesprávně zadaná syntaxe | ||
| bez odezvy | ||
| nepovoleno | ||
| časový limit | ||
| chyba | ||
| <cmd> | příkaz, který reaguje (DEF, RST, INF, PWD, SET, GET) | |
| <seq> | sekvenční počítadlo | |
| <num> | číselná hodnota | |
Příklad nastavení parametrů:
- EG SET pwd 100=0 sgw_ident=(EGIP 1)
Příklad čtení parametrů:
- EG GET pwd 100 sgw_ident
| Zpětná hlášení pro příkazy | |
|---|---|
| EG SET OK | Nastavení proběhlo v pořádku |
| EG ERR Unknown Command | Použit jiný příkaz než SET, GET, DEF, RST, INF |
| EG ERR Password | Neplatné heslo |
| EG ERR Invalid Parameters | Neplatný parametr v příkazu |
| EG ERR invalid Syntax | Nedodržení znaků (mezer, rovnítek apod.) |
Upozornění
SMS příkazy
- Příkazy jsou platné pouze velkými písmeny.
- Pomocí SMS lze zadat pouze vždy jeden druh příkazu.
- Pro příkazy GET a SET je možné použít více parametrů najednou, oddělujícím znakem jednotlivých parametrů je mezera. Parametry se zadávají číselným nebo textovým identifikátorem a lze je kombinovat. Doporučujeme používat identifikátory číselné, které obsahují méně znaků.
- Maximální délka SMS je 140–160 znaků, pokud je požadováno nastavení mimo povolený rozsah hodnot nebo je ve zprávě jiná chyba, nastavení se neprovede u žádného parametru.
Tip
- Přehledný seznam parametrů a jejich identifikátorů naleznete v podkapitole 5.6.1.1.