[DKSF 54.1 IU] Page SMS web interface
In the SMS menu, it is possible to configure different functions of a GSM-module to react to various events. Destination Phone Number for SMS - phone numbers are indicated where SMS will be sent. A number is entered in the following format Country code - Operator's code - Phone number. USSD Command for request of GSM account status - is a code, where USSD-commandwillbesend to request a balance. Log communication with GSM modem - on the page "Logfile" an information about all AT commands will appear, which are exchanged between CPU and a GSM-modem. Registration in GSM Network - a registration status in a cell network is indicated. GSM Signal Strength - a signal status is indicated. In the section "Pinger" it is possible to configure an address for testing availability of a host via an IP address (Network address to ping) and a polling period (Polling period, s (30-9999)). If it is unavailable, an SMS message will be sent to the numbers indicated above. Operation parameters of the module «Pinger» at the page «SMS» are as follows: 1. Polling of a specified IP address starts once in an indicated period of time (a parameter «Polling Period, s (30-9999)»); In the section "Events for SMS notifications" it is possible to configure sending SMS-notifications to the numbers if the following events are triggered: In the section "GSM Modem Troubleshooting" the last error of a modem is indicated, and there is a button "Restart GSM" that restarts a module: SMS-notification looks like np_name (q) information, where: np_name - a name of a device for identification of SMS-notifications up to 30 Latin characters. It is specified on the page SMS settings. When not specified (empty), a name NETPING is used. q - a sequential number of a message. It is nonvolatile - and it is not zeroed when powering off. It is used to register missed (lost) messages. Information - an informational part of a message (see below). An informational part of SMS-messages that are sent by a NetPingdevice,looks like the following: PWR n “label” SWITCHED ON|OFF A message about switching on or switching off a built-in relay through a web interface or SNMP n relay number - 1 label relay tag, enclosed in quotation marks in a text of a message. If a tag is not specified (empty), then it is not included into SMS. Cyrillic characters are displayed in ‘?’’ PINGER STATUS: OK|FAILED A message about losing and restoring a connection with an indicated IP address (see “Pinger”). POWERED FROM 220V/BATTERY A message about switching a power supply to electricity or a battery BATTERY CHARGE <10%% A message about a low battery A maximum length of SMS notifications cannot exceed 140 characters. Cyrillic letters are not supported in SMS messages. A device has a function of a remote management using SMS-messages. A general text format of an SMS-command is NETPING fff community_w kkkkkk , where: fff - is a code of a command, for example, Р1+ (see below). community_w - is a password corresponding to an SNMP community to write. It is specified on the page “Settings” of a web-interface. It is possible to use Latin letters, numbers, _, without quotes and spaces. kkkkk - is a request identifier (a random number from 3 to 9 numbers). It is repeated in a responsetoestablishcorrelation between a request and a response. It is an optional element of a command. If there is no identifier in a command then it is none in a response. A command text is not case sensitive, so it is possible to use both uppercase and lowercase letters. Elements of a command are splitted by spaces. It is not acceptable to use the characters ‘ (apostrophe), “ (quote), @. Including these characters cancausefirmwaretofail. Fulfilling a command is confirmed by a response message (see below). Codes of Commands A code of a command is specified as a solid word, without spaces. Reload a relay n, where n is a number of a relay A polarity (direction) of switching a relay when resetting must correspond to a specified one in the settings of the module «Watchdog» (reset mode). If a relay is not in a reset mode anymore, a reset command will not have any effect despite a sender receives a notification about a successful fulfilling of «NP DONE PnR» in a response. Examples of SMS Commands A command to turn on a relay 1 of a device: netping P1+ SWITCH A command to turn off a relay 2 of a device: netping P2- SWITCH Response messages to an SMS-command NP DONE fff kkkkkk Confirmation of fulfilling a command, such as switching a relay or changing a discrete output line status. fff - is a code of an output command, fulfilling which is confirmed by a given message. For example, Р1+ NP WRONG CMD: “output command” It is a failure when analysing a command by a device. Most probably, an incorrect text of an output command .“Output command” - is a text of an initial command that is totally enclosed into quotes. NP WRONG PASSWD IN kkkkkk Wrong password in an output command (Community). NP REPLY P1+ (0 RESETS, 0 REP.RESETS) kkkkkk A response to a request about a relay status (NETPING Pn? kkkkkk). P1+ - is a relay status. Concrete values of status are given for an example. A relay status is encoded by characters + (switched on), L (managed by Logic). Inparentheses you can find a general counter of resets and a counter of repeated unsuccessful resets, that are initiated by a Watchdog. NP REPLY P1+ kkkkkk A response about a relay status request, if a request misses a relay number (NETPING P? kkkkkk). P1+ - is a relay status. Concrete values of statuses are given for an example. A relay status is encoded the same as in SMS command and a relay management command. Reset counters are not included into a response. NP REPLY N=1 kkkkkk A response to a request about a pingerstatus that is built-into an SMS module (NETPING N? kkkkkk). N=1 – a specified IP responses, N=0 – is silent. NP REPLY Tn? SENSOR FAILED kkkkkk A response to requesting readings of temperature status. A status with a number n failed or is not connected. NP REPLY Tn=tC BELOW/IN/ABOVE SAFE RANGE (10..60C) kkkkkk Response to displaying readings of a temperature sensor. tC – current readings of a temperature sensor. BELOW/IN/ABOVE SAFE RANGE (10..60C) – a sensor status (readings relative to a safe range) NP REPLY H=? SENSOR FAILED kkkkkk Response to requesting readings of a humidity sensor. A humidity sensor is neither working nor connected. NP REPLY H=hum% BELOW/IN/ABOVE SAFE RANGE (10..60%) NP REPLY T4=26C hum – current readings of a humidity sensor BELOW/IN/ABOVE SAFE RANGE – a sensor status (readings status relative to a safe range)
2. Period of waiting for a response from an IP address is 2 seconds;
3. Number of request repeats for an IP address is 8;
4. If there is no response from a requested host after 8 repeats, «Pinger» reports that a connection with an indicated IP address is lost;
5. If during the next polling period a response from a requested host appears, «Pinger» reports that a connection with a specified IP address is restored;SMS Notifications
SMS Commands
Code of a command Description Pn+ Turn on a relay n, where n is a number of a relay Pn- Turn off a relay n, where n is a number of a relay PnR PnL Switch a relay under the management of a Logic module, where n is a relay number Pn? Request a status of a relay n, where n is a relay number P? Request a status of all relays in a brief form Lm+ Switch a line m into a status logic 1, where m is an IO line number (1..8) Lm- Switch a line m into a status logic 0, where m is an IO line number (1..8) LmP Issue a pulse to a line m, where m is an IO line number (1..8) Lm? Request a status of a relay m, where m is an IO line number (1..8) L? Request a status of all relays in a brief form N? Request apingerstatus Ka Transfer an IR command through a module IRC-TRv2, where a is a command number Tb? Request readings of a temperature sensor b, where b is a temperature sensor number