GSM Setup

The GSM task is part of the GSM optional add-on module. You will need to have your software re-registered with the GSM task enabled before it can be installed.

The GSM task uses a GSM modem to send and receive SMS messages. Please contact Patriot sales or Patriot support for a list of supported modems.

A SIM card will be required for the modem. As the modem will be sending and receiving SMS messages only, a pre pay SIM card or a contract with low SMS rates is preferred.

GSM Modem

A GSM Modem is required to communicate with the GSM service provider. Our currently supported GSM modems are the 4G LTE Sierra FX30S LTE M1 and the 3G Sierra GL8200 modem.

This modem is multi band, so will work in all countries. It supports both USB and direct serial communication. Drivers must be installed for use by USB. .This modem has also been successfully installed and used on a virtual server running VMWare.

If you are using any other type of GSM modem, these may or may not work correctly with the Patriot GSM task. We generally won't provide support on any other types of modems.

The Sierra GL8200 and FX30S LTE M1 modems use a default baud rate of 115200.

Installing the GSM Task

The GSM task can be run on any machine running the Patriot Task Service. Ordinarily, the task should run on the primary Patriot server.

System Menu Item -> Tasks -> Task Settings

Please read TASK SETTINGS for general information about adding tasks.

add Add a new instance of the GSM task by selecting it from the Task Type drop down list.

nextClick the next button to continue. The GSM task settings form will be displayed.

GSM_TaskSettingGSM task settings form - many settings are common between Patriot's various messaging tasks.

GSM Task Settings

Enter a Description of the task, e.g. SMS

The Task No. will default to the next free task number.

Select the Computer that this task is to be run on. This will default to the computer you are currently on. The chosen computer must be equipped with the GSM hardware.

Backup: Check this box if you wish this task to be defined as a backup task.

Text log Filter level can be use for task troubleshooting purposes. It should be left to the default None.

Enter a System Account No. The system account number is used to log any task errors and other system generated signals. The default is GSMF000101. If this account does not already exist you will need to set it up as a template under Maintenance -> Clients -> Templates, and import the System Generated Event Types.

Header Message is short text message prepended to all automated SMS messages

Number to Use specifies which user contact number to use when sending automated messages

Prefix is prepended to the destination number of all automated SMS messages - usually a country or area code

Init Parameters (IMPORTANT). Leave this as default, except for the +CSCA="..." section. You will need to change the number in quotes to the Short Message Service Center (SMSC) number of the service provider you are using. Patriot Support may be able to provide this for you, otherwise an internet search should provide it. The number must be in full international format, beginning with a +.

Attempts is the maximum number of times the system will attempt to send an SMS message if the first attempt is not successful. If all attempts fail, the system will wait the time specified in the Retry Wait field before trying again. This cycle will be repeated a maximum number times as set in the Retries field. Check the box to continue trying indefinitely.

Set the Comm Port and other serial port settings according to those specified by the GSM modem driver software.

Send Open/Close With Recent Alarm

Causes any set and unset signals received from a client to trigger automated messages to response members when received within a short period Within Time (Min) of an alarm event, the time can be set in System Wide Settings -> Data Service Settings -> Within Time(Min).

Note: for this option to work you must enable the system setting Send Open/Close With Recent Alarm in System Wide Settings and also enable this setting in GSM task settings.

Recv. Message Type

The GSM task supports a few different received message formats. These can be used by mobile users and devices to acknowledge alarms, or to report alarm and location data.

Save Click Save to save task settings

Testing the GSM Task

Restart Patriot.

Then click onto the text log browse or diagnostic window for the task, it will take approximately 20 seconds to initialise the modem, then you should see something similar in your text log,

Modem Initialized

<0A>+CSQ: 31,0<0D>

<0D>

AT+CSDH=1;+CMGF=1;+CSCA="+6421600600";+CMEE=1;+CSQ

<0A>AT+CSDH=1;+CMGF=1;+CSCA="+6421600600";+CMEE=1;+CSQ<0D>

AT+CSDH=1;+CMGF=1;+CSCA="+6421600600";+CMEE=1;+CSQ

Registered

OK

<0A>OK<0D>

<0A><0D>

+CREG: 0,1

<0A>+CREG: 0,1<0D>

<0D>

AT+CREG?

<0A>AT+CREG?<0D>

Pin OK

+CPIN: READY

<0A>+CPIN: READY<0D>

<0D>

AT+CPIN?

AT+CPIN?<0D>

If your text log appears different, and contains error messages, there may be an error in the task settings, or there may be a problem with your modem. See - If the Modem Won't Initialise in the GSM FAQ.

With the modem initialised correctly, next check the signal strength. Bring up the Task Manager program, select Active Tasks, highlight the GSM task, then press the raw data button, then verify that the signal strength is showing Acceptable or Excellent. If it shows Bad or Marginal, you probably have a signal strength problem. Try moving the aerial (or SAMBA modem) to a different spot

Next, manually test sending a SMS message. Go into the Database administrator, into the Paging Queue, and manually insert a GMS message. Then watch the text log to see if the message is successfully sent. If you see errors in the text log, these can sometimes come from the service provider. The definition of the errors can be found in the Falcom and SAMBA manuals, otherwise contact Patriot support at support@patriotsystems.com for help.

Once you have GSM setup correctly and sending out message successfully, remember to turn off the Log to Text File in the GSM task if this has been enabled.

Related Pages