Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Product page: https://vutlan.com/modems/165-vt740-lte-slot-modem.html

Datasheet page: https://vutlan.atlassian.net/wiki/spaces/DEN/pages/2735931393/VT740+LTE+slot+modem

Usage

Allows to receive and send SMS messages (2G, 3G). Provides Ethernet over LTE (4G). Can be installed in VT335t, VT336t, VT825t, VT855t, and VT960t monitoring systems. Power cycling is an embedded function.

The same PCB of VT740 is used for i and t series (e.g. VT335i and VT335t). But The metal enclosures use a different metal panel for holding the modem. t series have an additional screw to hold the panel. Thus the installation is slightly different. But in all other regards, it is the same.

Package content

Unable to render {include} The included page could not be found.

Panel

  1. "Main antenna" - Connector, used when the modem is installed inside of the appliance to connect the LTE main antenna. ( The main antenna is supplied together with the modem).

  2. "SIM card" - SIM card slot with an injector.

  3. "Status" - displays modem status. Blinking = working.

  4. "Auxiliary" - Connector, used when the modem is installed inside of the appliance to connect LTE auxiliary antenna. The additional antenna helps to strengthen the signal level. ( Auxiliary LTE antenna is supplied together with the modem).

Technical specifications

Specifications

GSM/GPRS/EDGE 900/1800 MHz

Control Via AT Commands

GNSS gpsOne Gen 8B;standalone;assisted,XTRA

Uplink up to 5Mbps, Downlink up to 10Mbps

ROHS, REACH, CE

Installation

You can install the modem while the system is turned On. You may wait up to 3 minutes until the Telecom operator information is renewed.

Step 1

Unscrew the M3 screw from the LTE metal panel.

Step 2

Use the wire cutter tool to cut off the metal inserts.

You can dispose of the metal inserts.

Step 3

Plug the VT740 slot modem as shown on the picture into the opening. The board should slide into the guide rails (marked as “1”) and plug into the jack (marked as “2”).

Step 4

Put the LTE metal panel back in (marked as “1”).

Screw the M3 screw back in fixating the LTE metal panel (marked as “2”).

Step 5

Screw the main LTE antenna into “Main” antenna” jack.

If you want to strengthen the signal, you can screw in the second auxiliary antenna into “Auxiliary” jack.

Step 6

Plug in the micro SIM card. The SIM card slot has an injector.

Step 7

You are ready to go! Turn on the system.

You can install the modem while the system is turned On. You may wait up to 3 minutes until the Telecom operator information is renewed.

Setting up GSM modem

The modem is used in the system to send SMS notifications and receive SMS commands.

To operate with a modem:

  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):

image-20240226-090435.png

Fields characterizing the properties of the modem element in a system:

  • Status – the state of the cellular network;

  • Operator – the state of the cellular network;

  • Signal level – the signal level;

  • 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;

    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;

    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.

The "List of SMS messages" contains up to 100 recent SMS messages (1000 for VT9xx systems) that the system or user attempted to send. When the device is rebooted, the list is not saved.

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

Attention!

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

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.

If it is not possible to set up the connection with the network of the selected operator, then the modem switches to the automatic selection mode.

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.

image-20240226-090555.png

  • 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:

  • Name – name of the notification. Can be arbitrary (name, the position of the recipient, ...);

  • Phone number – the telephone number to which the notification has to be sent.  

  • Message text – text messages can be in any language. Also in this field, you can use various macros (%1 - %8), which insert the current values of variables into the text.

To apply the settings, click the "Save" button. To test SMS, click the "Test" button.

When You press "Test", the system sends a message to test if the SMS is sent correctly. Test SMS may contain incorrect information about sensors (macros %1 and %2) for testing purposes only.

After filling in the notification parameters, you must specify the event (events) by which the SMS message will be sent. To do this, open the Preferences → Logic schemes → Add window and specify the condition for sending the SMS message in the logic. In one logic, it is possible to send SMS notifications to not more than 15 recipients for one or more events. If you need to send SMS notifications to more than 15 recipients in the same logic, then create new logic with the same input condition.

SMS messages are sent to the queue, which allows you not to wait until the end of sending the previous message. The information about the sent messages is displayed in the monitoring system log. The capacity of the queue is 100 messages, if overflowed, the sent messages are automatically deleted.

If an error occurs while the message is being sent, the message with the status of SMS send error is displayed in the log, the reasons of which may be:

  • the negative balance on the SIM card account.

  • low signal level;

  • the wrong format or nonexistent recipient phone number.

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.

To send an SMS, use the following command in the console:

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

In case of errors, leave comments below on the page or at our forum. Please indicate in the message the current version of the firmware of the monitoring system (System menu → About this system → Firmware version).

LTE modem mode

Check if the modem is operational.

  1. Make sure the SIM card is inserted into the modem. Make sure you have sufficient funds on the card or a contract for an LTE connection.

  2. Make sure the external antennas are mounted onto the modem. Both "MAIN" and "AUXILIARY".

  3. Turn on the system. When the system loads, the modem will appear in the system automatically.

  4. If you inserted the SIM card while the system was already "ON", it may take up to 15 minutes for the operator to register.

  5. If the modem is installed, the panel "SMS messages" should appear in the menu panel.

  6. Check the strength of the signal. E.g. in the window below the strength of the signal is 48%.

  7. See the image below:

  1. You can test if the modem is working correctly with your SIM card. press "+" to the right of "List of SMS messages". A model window should appear.

  2. See the image below:

  1. Fill in your mobile number and a text message and press "OK".

  2. You should receive a message on this mobile phone number.

  3. See the image below:

  1. You should see a confirmation that the message has been sent.

  2. See image below:

Connecting to the Internet

From version 2.7.4, when installing an LTE modem, it becomes possible to use an LTE connection to connect to Internet services (VPN, SMTP, FTP, etc.) and access the device.

LTE settings are available in the "Preferences" menu, in the "LTE" tab.

Here are the following items available for configuration:

  • Enable LTE modem - allows you to enable or disable the LTE modem if the installed modem support it;

  • Connect at startup - working mode of LTE connection, always maintaining connection (at startup) or setting up a connection only when necessary;

  • APN - Access point name;

  • PIN - PIN code, if modem uses it;

  • Authorization type - set authorization type if needed, supported PAP, CHAP or 'none' authorization modes;

  • User name - user name for provider authentication, if needed;

  • Password - user password, if needed;

  • Enable routing for the internal network - allow devices in the internal network to use this connection like a gateway for internet access (if available);

  • Enable Watchdog - use watchdog ping to verify connection status;

  • Watchdog period - watchdog ping frequency, in seconds;

  • Watchdog timeout - if during this time there is no ping, the connection is considered to be broken, in seconds;

  • IP Address or hostname of ping destination - address to verify the LTE connection;

  • Enable logging - set this checkbox to enable the connection log. Use this only to find out the cause of a failed connection, don't keep the log enabled on all the time;

  • Save the log to disk - button for connection log downloading.

LTE modem operation mode is used as a failover connection. If the checkbox Connect at startup is clear, then the LTE connection is automatically established when there is no response (ICMP ping via the Ethernet interface) from the DNS servers specified in the "Network" settings. The established connection is terminated if at least access to one of the DNS servers is restored via the Ethernet interface. Thus, for normal failover, the DNS must be located outside the local network.

If the checkbox Connect at startup is set, then the LTE connection is established right after the modem initialization and the unit uses it as the primary connection for internet domains (like e-mail servers, etc.). VT900 unit only supports this mode of LTE connection.

Watchdog Ping can be used to restore the LTE connection. When setting a timeout, it is recommended that it be at least 3 times longer than the ping period. If during the timeout period, no successful ping passes to the specified address, the connection is considered to be broken and the modem will attempt to establish a new LTE connection.

If the device requires constant access to the Internet, then you can use the OpenVPN client. The connection to the VPN server will be maintained when connected via Ethernet or LTE (if the connection to the Internet via Ethernet is lost) and thus it ensures permanent access to the protected private network and the device’s permanent IP address (with the appropriate settings of the VPN server).

Warning

Don't forget that access to the unit by LTE also is open for SNMP. Set up passwords or disable these protocol for security purposes if using LTE access.

Connecting to the device from the Internet using LTE

If the installed SIM card supports a personal APN with a static IP address, then the unit can be accessed by this IP address directly. To obtain these SIM cards contact your mobile service provider.

You can find this LTE IP address in the Network tab when it is assigned (LTE IP address field). Or use the Determination of IP-address procedure: Network settings.

By default, a regular LTE connection does not provide an static IP address to access the device.

By default, a regular LTE connection does not provide a static IP address to access the device. You need to request GSM LTE provider to give you a static IP address on LTE connection.

Description

MAC address

A MAC (Media Access Control) address, sometimes referred to as a hardware or physical address, is a unique, 12-character alphanumeric attribute that is used to identify individual electronic devices on a network.

This is a MAC address of the ethernet network.

Current IP address

Actual IP address of the ethernet network specified as static or assigning by the DHCP server (if DHCP is enabled).

LTE IP address

The IP address of the mobile network assigned by the telecom operator.

Your LTE IP address can be Static or Dynamic

By default, a regular LTE connection does not provide a static IP address to access the device. You need to request telecom provider to give you a static IP address on LTE connection.

A Static IP address is always Whitelisted. Whitelisted means that ports 80, 443 and others are open for entry, and you can access the device using this IP address.

A Dynamic IP address can be Whitelisted or Greylisted. Greylisted means that ports are closed by NAT provider, and you can not access the device using this IP address.

If you can access the Vutlan system’s Web Interface using this IP address, the IP is Whitelisted.

Vutlan systems may not check if the IP address is Whitelisted or Greylisted. Can not check if the IP address is Static or Dynamic. It all depends on your telecom provider and the service you ordered (e.g. your telecom contract).

Other articles of interest

Sending SMS via another Vutlan device equipped with a GSM modem (SMS Gate) (link)

Incoming SMS forwarding and SMS commands

How to use SMS commands

Send SMS through the Vutlan device

Frequently asked questions:

  • No labels