====== Přijímání SMS pomocí FUPLA ======

{{:cs:mervis-ide:35-help:receivesms_fbd.png?direct|Blok ReceiveSMS_fbd}}

==== Celé jméno ====

ReceiveSMS_fbd

===== Knihovna =====

Lib\Unipi

===== Verze =====

V1.0

===== Popis =====

S náběžnou hranou na vstupu **readSMS** přečte funkční blok poslední přijatou SMS zprávu. Tento blok je určen **pouze pro FUPLA** a nedoporučuje se jej spouštět příliš často, vhodným intervalem je např. 5 sekund.
===== Vstupy =====

| Vstup    | Typ   | Význam                          |
| ReadSMS  | BOOL  | Náběžná hrana spustí čtení SMS  |

===== Výstupy =====

|Výstup       |Typ    |Význam                                                  |
|result       |INT    |číselný status; výsledek kontroly nastavení systému     |
|sms_channel  |STRING |kanál, na kterém je připojen modem, který obdržel zprávu|
|sender       |STRING |odesílatel                                              |
|message      |STRING |přijatá SMS zpráva (základní ASCII znaky)               |
|receive_time |DT     |čas, kdy byla SMS zpráva přijata                        |

===== Funkce =====

Při každém spuštení bloku ReceiveSMS_fbd v programu se doptává připojených modemů na přijaté SMS zprávy. Výstupem je název kanálu //channel//, ze kterého byla SMS zpráva vyčtena, odesílatel //sender//, čas přijetí zprávy //receivetime//, samotná SMS zpráva //message// a výsledek čtení z daného místa.

Proměnná //channel// odkazuje na definované komunikační spojení. To je třeba vytvořit v možnostech PLC: Dvojklikem na PLC zobrazte jeho nabídku a vyberte záložku //Definice hlášení// a pravým kliknutím zobrazíte nabídku, ve které vyberete //Přidat alarmový kanál//.

{{:cs:mervis-ide:35-help:sendmail_1.png}}

Nyní definujete název, který se zobrazí na výstupu //channel//. Dále definujete typ spojení //GSM//. Kliknutím vyberete kanál a v jeho vlastnostech nastavíte port, na kterém bude RT komunikovat s modemem. Dále se definují komunikační vlastnosti kanálu. V případě zabezpečené SIM karty je třeba zadat PIN kód. Nakonec potvrdíte všechny změny kliknutím na OK v červeně označeném dialogu.

{{:cs:mervis-ide:35-help:sendsms_1.png}}

V případě použití některého ze standardně dodávaných modemů (Siemens TC-35, Wavecom), nebo kontroléru Unipi, je možné vybrat v //Nastavení AT příkazů// předdefinované příkazy pro nastavení modemu. Následně klikněte na tlačítko //Použít//. Potřebné AT příkazy se následně doplní do tabulky. Zmáčkněte tlačítko //Zavřít// a potvrďte změny kliknutím na OK v červeně označeném dialogu. V případě jiného typu modemu, je třeba nastavit modem jeho příslušnými AT příkazy.

{{:cs:mervis-ide:35-help:sendsms_2.png}}

Výstupní proměnná result hlásí výsledek kontroly nastavení systému.

|Číselný status|Význam                                                                               |
|0             |OK                                                                                   |
|16            |Neznámý kanál                                                                        |
|24            |Chyba - hodnota číselného statusu nelze určit                                        |
|25            |Nemožnost otevřít port nebo inicializovat GSM modem (např. chybně zadané číslo portu)|
|26            |Timeout při provádění AT příkazu (default 2 s)                                       |
|31            |Není k dispozici žádná zpráva                                                        |
|42            |Chyba GSM kanálu (např. špatný PIN, nedostupnost sítě, …)                            |