[ENG] 7. [DKSF 707.2 IU] Example of Setting a NetPing SMS Gateway to Control NetPing Devices Using SMS Messages

To control NetPing devices using SMS notifications, perform the next configuration:

1. Go to the tab «AGENTS» of a device web interface. Agent is a device controlled or requested via an SNMP protocol. When NetPing SMS receives SMS messages of a certain format, it sends either SNMP SET command or SNMP GET request to an agent;

2. Add a new agent. To do this, click the on a field «click here to add new data»:
   
   Add for instance UniPing v3 device as an agent to manage it using SMS messages in a window that appeared:
   
   

   where:

   Short Name – is an agent name, which will be used in SMS messages, up to 15 Latin letters. Using spaces is prohibited. On default: empty row

   IP Address or Domain Name – is an address of an agent, where SNMP SET commands and SNMP GET requests will be sent. It is possible to indicate a domain name as well as an IP address. In the example, an IP address of a UniPing v3 device is specified, which is in the same local network with a gateway NetPing SMS. Its size cannot exceed 62 characters. On default: empty row

   Port – is a UDP port of an agent, where an SNMP notification will be sent. On default: 161

   Community – is used in SNMP packages. It must coincide with Community of an agent, configured at the page «SETUP». On default: empty row

   To delete an agent, there is a need to click on it and then click the button «Delete Record» in a window that appeared. To change parameters of an agent, click on it and edit its parameters in a window that opens. Click the button «Save». To cancel an action, click the button «Cancel»;

3. Specify SNMP variables at the page «VARIABLES» of a device web interface. Devices are managed using SNMP variables. Which parameters will be able to control a device via SMS messaging depends on which SNMP variables will be added to the page «VARIABLES» of NetPing SMS gateway.

   In the example, variables will be added to receive temperature values from a temperature sensor № 3 of a UniPing v3 device, a status of a temperature sensor № 3 and manage IO line № 3 in the mode «output».

   To add a new variable, it is necessary to click on the field «click here to add new data» and add the following data into the window that opens:
   

   Short Name – is a variable name, which will be used in SMS messages. A name must consist of no more than 31 character. Using spaces is prohibited. On default: empty row

   OID – is SNMP OID of a variable. It consists of no more than 62 characters and always begins with a dot. For example:

   .1.3.6.1.4.1.25728.8800.1.1.2.1
   .1.3.6.1.4.1.25728.911.1.0

   It is possible to use the NetPing MIB reference (works for NetPing devices only) to fill in this field. On default: empty row

   Agent – is a drop-down list of short names of SNMP agents, configured at the page «AGENTS». On default: agent is not selected

   Dictionary – is a table that consists of pairs «Numeric Value - Textual Label». It is not required to be filled in and is used to link numeric values of SNMP variables to their textual description, understandable for a human. Later the text description can be used in SNMP commands for a corresponding value. The value must be integer. Deciphering uses Latin letters without spaces and underlining, and takes a case into account as well. Total dictionary length is 127. Only special delimiting characters are used to save them in a memory of a device. They are included when a dictionary length is counted. Usually, each pair «Numeric Value - Textual Label» needs near 4 symbols on average. Remember this when filling the dictionary with the information. On default: dictionary is empty

   As long as the example represents a configuration of a UniPing v3 device, it is possible to use the tool «NetPing MIB Reference» to add SNMP OIDs. The NetPing MIB Reference makes adding new SNMP OIDs easier if a NetPing device is an agent. Click the button «NetPing MIB Reference» to run it in the window for adding a new SNMP variable. 

   To add an SNMP variable, which allows to receive a current temperature (°С), choose the next ones:

   • OID npThermoValue;
   • temperature sensor number.
   
   

   To add an SNMP variable, which allows to receive a status of a temperature sensor № 3, choose as follows:

   • OID npThermoStatus;
   • a temperature sensor number;
   • check a checkbox «add name of this variable» to decipher numeric values of SNMP variables into textual description, understandable for a human.
     
     
   
   

   To add an SNMP variable, which allows to manage an IO line № 3 in the mode «output» choose the next ones:

   • OID npIoLevelOut;
   • a temperature sensor number.
   
4. As a result of the configuration of the page «VARIABLES» of a device web interface described above, we get three adjusted variables:
   
   

   A variable «T3» is used to receive a current temperature from a temperature sensor № 3 of UniPing v3 device.

   A variable «T3Status» is used to receive a status of a temperature sensor № 3 of UniPing v3 device.

   A variable «IoLevelOut3» is used to manage an IO line № 3 in a mode «output» of UniPing v3 device.

   For variables «T3Status» and «IoLevelOut3» a table with pairs «Numeric Value - Textual Label» is configured to link numeric values of SNMP variables to textual description, understandable for a human.

5. There is a need to use the section «4.6. [DKSF 707.2 IU] What SMS Commands and SMS Notifications Are Supported by a Device?» of this user guide to send SMS commands.

As a result of settings described above, NetPing SMS allows controlling devices using SMS notifications.

Here is an example of sending an SMS command to receive a current temperature from a temperature sensor №3, fulfilled successfully:

Here is an example of sending an SMS command to receive a status of a temperature sensor № 3, performed successfully:

Here is an example of sending an SMS command to manage an IO line № 3 in a mode «output», performed successfully: