Versions Compared

Version Old Version 23 New Version Current
Changes made by

Vladimir Tayzhev

Vladimir Tayzhev

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Install the SIM card in the mobile phone and make sure that it is functional, check the PIN code;

  2. Insert the SIM card in the modem;

  3. Turn on the power of the monitoring system;

  4. Configure the modem;

  5. Add SMS notifications and configure the logic or group notifications.

Configuring the modem for sending and receiving SMS

To configure the modem, use the modem settings tab (Main Menu→SMS messages):

...

  • Status – the state of the cellular network;

  • Operator – the state of the cellular network;

  • Signal level – the signal level;

  • IMEI - The International Mobile Equipment Identity number is a unique identifier assigned to LTE modems and other cellular devices. Uniquely identifies the LTE modem on the cellular network. It allows mobile operators to verify the type of device and its compatibility with the network. The IMEI will show in the Vutlan web interface only after you insert the SIM card in the modem and wait for the information to update (up to 5 minutes).

Info

  • Ensure the SIM card is inserted correctly, and the modem is powered on.

  • Open the Vutlan system's interface and navigate to the modem settings or device information section.

  • Locate the IMEI number physically printed on the modem itself.

  • Copy the IMEI number and provide it to your Telecom provider, requesting them to register the device on their network.

  • PIN code – pin-code of sim-card;

  • Choose an operator – an actual list of operators present on the GSM network and the button for refreshing this list;

  • SMS center number – SMS service center number, leave it blank to auto-detect;

    Warning

    We highly recommend writing the SMS center number in this field manually. Some SIM cards have problems with auto-detect features.

  • Request current balance – the number on which the account balance is requested, to see the answer, click on the "OK" button and wait for an answer, which will be shown in the log;

    Info

    USSD is not supported in LTE mode. The USSD query has a specific format, usually starts with an asterisk, for example: *111# or *222*
    Do not enter the phone number in this field.
    Some operators abandoned the use of USSD and do not support it.

  • Clear SMS list – clear list of SMS messages.

...

If the sim card has a pin, you must specify this pin in the corresponding field in the configuration form.

Info

Attention!

After 3 incorrect attempts, you must remove the sim card and use the PUK code to unlock it.

Warning

If an error occurs during the operation of the modem, or the SIM card is not installed, or the PIN code is not correct, the message written into the log queue ("GSM modem: Error, check your SIM card and PIN code" or "GSM modem: modem error, restart smsd"). The message is displayed only 5 times in order not to overflow the log.

GSM operators list

The list of operators is updated once a few minutes after the system is turned on. Next time the list can be updated by the button. Getting the list is a long procedure and can take several minutes. When successfully receiving the list the corresponding message is displayed in the log.

...

The name of the operator on the network that works the modem is shown in the Operator field.

GSM modem elements

The “System Tree” menu has elements corresponding to the status of the modem. These elements do not affect the state of the element "System". Elements can be used in logical schemes.

...

  • GSM Signal Level - analog value, shows the signal level in percent from 0 to 100%;

  • GSM State - discrete value, shows the state of the GSM network:

    • Not connected - if the connection has not yet been established;

    • Alarm - if an error has occurred;

    • Normal - if the connection is established successfully.

  • LTE State - discrete value, shows the state of the LTE connection if the modem supports it:

    • Not connected - if the connection has not yet been established or disabled;

    • Alarm - if an error has occurred;

    • Normal - if the connection is established successfully.

SMS messages

To add an SMS notification recipient, first, open the System Tree menu, further open the window →SMS:

...

If these items do not fit your situation, try to restart the monitoring system. Also, check the sending of messages from your mobile phone.

Sending SMS using third-party programs

To send SMS, you can use, for example, the cURL utility. Either other programs with similar functionality.

...

Code Block
gcc -O2 -o sendsms sendsms.c

Script for sending SMS

#!/bin/bash

# SMS sending script for version 2.4.x and higher

 

usage()

{

cat << EOF

usage: $0 options

 

OPTIONS:

   -?,-h   Show this message

   -H      Hostname or IP address

   -u      User name

   -p      Password

   -P      Phone for sending

   -m      Message for sending

EOF

}

 

HOSTIP=

USERNAME=

PASSWORD=

TOPHONE=

MESSAGE='Test'

 

while getopts “hH:u:p:P:m:” OPTION

do

     case $OPTION in

         h)

             usage

             exit 1

             ;;

         H)

             HOSTIP=$OPTARG

             ;;

         u)

             USERNAME=$OPTARG

             ;;

         p)

             PASSWORD=$OPTARG

             ;;

         P)

             TOPHONE=$OPTARG

             ;;

         m)

             MESSAGE=$OPTARG

             ;;

         ?)

             usage

             exit

             ;;

     esac

done

 

if [[ -z $HOSTIP ]] || [[ -z $USERNAME ]] || [[ -z $PASSWORD ]] || [[ -z $TOPHONE ]] || [[ -z $MESSAGE ]]

then

     usage

     exit 1

fi

 

# 1) password hash

HASH=`echo -n ${PASSWORD} | openssl dgst -sha1 | awk '{print $NF}'`

 

# 2) authorization

RESPONSE=`curl -s -d "querytype=auth&name=${USERNAME}&h=${HASH}" "${HOSTIP}/engine.htm"`

# or for HTTPS case

#RESPONSE=`curl -s -d "querytype=auth&name=${USERNAME}&h=${HASH}" -k "https://${HOSTIP}/engine.htm"`

 

# 3) session key

KEY=`echo -n  ${RESPONSE} | awk -F"\"" '{print $4}'`

 

# 4) send SMS

curl -d "querytype=send_sms_message&k=${KEY}" --data-urlencode "to_phone=${TOPHONE}" --data-urlencode "message=${MESSAGE}" ${HOSTIP}/engine.htm > /dev/null 2>&1

# or for HTTPS case

#curl -d "querytype=send_sms_message&k=${KEY}" --data-urlencode "to_phone=${TOPHONE}" --data-urlencode "message=${MESSAGE}" -k https://${HOSTIP}/engine.htm > /dev/null 2>&1

...