lib command types cs CZ

Typy příkazů

Adeon využívá dva různé typy příkazů - textový (pro použití s komerčními GSM zařízeními) a parametrický (pro vývojáře, pro použití s vestavnými programovatelnými kity).

Textový příkaz

Tento typ je určen pro použití s komerčními GSM zařízeními, která mají definovaný seznam SMS příkazů. Pomocí nich lze zařízení ovládat či zjišťovat jeho stav. Některé GSM moduly umožňují zkombinovat i více příkazů a následně je odeslat v jedné SMS zprávě. Takové (samostatné či kombinované) příkazy je možné do aplikace Adeon uložit, pojmenovat a následně je opakovaně používat. Tyto předdefinované zprávy můžou mít max. délku 160 znaků.

Příklad použití textového příkazu pro GSM relé RTU5024

V ukázce je cílem zapnout GSM relé na 30 sekund. Dle dokumentace RTU5024 je příkaz definován následovně:

Obecný příkaz:                     <heslo>GOT<čas>#
Konkrétní příkaz s heslem "1234":  1234GOT30#

V aplikaci Adeon uživatel může definovat příkaz například takto:

Popis příkazu: Zapni relé na 30 sekund
Text:          1234GOT30#

Parametrický příkaz

Tento typ je určen pro vývojáře pro použití s vestavnými systémy (např. Arduino, Raspberry Pi, Nucleo). Na rozdíl od textového příkazu, kde je formát zprávy libovolný (pouze omezený délkou 160 znaků), je parametrický příkaz definován jménem a číselnou hodnotou s těmito omezeními:

• Maximální délka názvu parametru je 16 znaků
• Název parametru může obsahovat pouze písmena (velká i malá) a čísla bez mezer
• Hodnota čísla může být v rozmezí 0-65535 (uint16_t)

Formát SMS zprávy

Je-li vybrán parametrický typ příkazu, aplikace Adeon využívá specifické formátování SMS zprávy:

Část	1		2		3		4		5		6		7
Obecný tvar	hash md5	:_	název parametru 1	_=_	hodnota 1	;	název parametru 2	_=_	hodnota 2	;	název parametru N	_=_	hodnota N	;
Příklad 1	503b2	:_	param1	_=_	125	;	param2	_=_	42	;	param176	_=_	65131	;
Příklad 2	9e8df	:_	nazev1	_=_	68	;	nazev2	_=_	7452	;

Poznámka: Symbol „_" v tabulce značí mezeru.

• První část obsahuje posledních 5 znaků z hashe md5. Hash je vypočítán z formátovaného textu od části #2 do části #N (vč. mezer, středníků a dvojteček), kde část #N obsahuje poslední hodnotu posledního parametru vygenerovaného textu (SMS zprávy). Následuje dvojtečka a mezera.
• Druhá část obsahuje název prvního parametru. Následuje mezera, symbol „=" a mezera.
• Třetí část obsahuje hodnotu prvního parametru. Následuje středník.
• Čtvrtá část (pokud je odesíláno více příkazů v jedné SMS zprávě) obsahuje název druhého parametru. Následuje mezera, symbol „=" a mezera.
• Pátá část obsahuje hodnotu druhého parametru. Následuje středník.
• (N–1)-tá část (pokud je odesíláno N příkazů v jedné SMS zprávě) obsahuje název Ntého parametru. Následuje mezera, symbol „=" a mezera.
• N-tá část obsahuje hodnotu N-tého parametru. Následuje středník.