Home > Diplomat Navigator End User Knowledge base > Navlite > Introduction to Diplomat Navigator SMS GW

Introduction to Diplomat Navigator SMS GW

Using Android SMSGW

The screenshots were taken on an Alcatel One-Touch device.

Firstly, Android SMSGW should not be used on a phone with a PAYG SIM.  (Phones with a PAYG SIM have a tendency to pop-up a “credit remaining” message which interferes with the SMSGW operation).

The device should be constantly powered on.

Wifi should be enabled to minimise mobile data usage.

When you start the app, the configuration screen appears with some notes:

These notes will be covered in the following sections.  Before using the SMSGW, there are a number of settings that may need to be adjusted.

Android Settings

You need to enable the “Developer Options” (tap “About Phone” a dozen times):

Go into Developer Options and enable “stay awake” or “do not sleep”.  If the phone goes into sleep mode then it may turn off the incoming SMS notifications.

Also in the Developer Options or Security Options you will need to allow “unknown sources”

Check there is no scheduled power on and off:

Guest Mode is off:

Also disable Battery Saving (which may turn off the phone’s GSM radio).

Minimise the backlight (screen) brightness.   Turn off “auto-rotate”.

Set sleep (inactivity period) to “Never”:

SMS Settings

You also need to open the Messaging app and check a few settings:

Go into General Settings:

Make sure “Delete old messages” is ticked.  Also keep the text message limit reasonably low (e.g. 100).

Ensure Notifications are off:

Enable Delivery Reports:

Brose the link below to download the SMS GW apk http://diplomat.co.uk/downloads/SMSGW/SMSGW_191016.apk

Install the application.

Configuration Parameters

Finally, with the device set up, you need to set the SMSGW parameters.  You can have more than 1 SMSGW connected to a Navigator system, in which case you would need to set the Identifiers such that they are distinct.

If a MQ System Name is given, the Host Address is not used.

Once you set the MQ System Name, click “Set Parameters” and the values are stored and used by the service.  If the configuration activity is dismissed (using the “back” or “home” button) the service continues to run.

Note That HANDICABS is an example of a companies MQ system name so please ensure that you enter the correct name for your company.

Checking connectivity

  1. Turn off the SMS Module services.
  2. If the SMS GW is running on the server, disable it.
  3. Navigate to Diplomat >>Navigate >> Settings >> SMS Module
  4. See if the server ip pointed is correct. Then see the IP address for the TC 35s. see underlined example below.
  5. Restart the SMS Module.
  6. Start the SMS Module service.
  7. The SMS Module should start running automatically

Once configured the SMSGW reports in every minute or so.  You should see this on the “NavSvr-UDP-Client” (“NUC”) Java applet if it’s visible, with new entries appearing on the SMS log:

Finally, on the Navigator Client, if a SMSGW has reported in, it appears as an option on various send-SMS dialogs:

Client Usage

On the Client, you can generate a SMS using the ad-hoc method as shown below:


If the SMSGW has been offline for more than 10 minutes, it will not appear as a “channel”:


When the SPNG messages are received, the Gateway endpoint is reactivated, and it appears in the list of channels:


The red “No SMS Gateway” text is there because the SMS Module is not running.  The MQ SMS does not require the SMS Module to be operational.


Test Scenarios

  1. Send Ad-hoc SMS from the SMS tab on the Despatch Screen.
  2. Send a reply (i.e. incoming SMS) to the SMSGW – it should appear on the SMS tab on the Despatch Screen.
  3. Use “Reply” on the received message on the SMS tab on the Despatch Screen.
  4. Despatch Screen, Jobs Tab, right-click on a booking, SMS -> SMS Confirmation.
  5. Drivers and Vehicles – Driver Details – Send SMS
  6. On the ranks view on the Despatch Screen.Right click on a driver – SMS – send SMS to driver.The SMS status icon should update when the send and delivered notifications arrive.
  7. Despatch job to a voice driver.On the “Check Voice” form (captioned “Remember to Radio the driver the job!”), use the “Send details by SMS > Driver” button.
  8. The driver will show as on-route.Check the phone number on the booking, and whether textback is enabled.Right-click on the driver and choose “Soon to POB”.This should send a textback.
  9. Check SMS-On-Despatch (again an option in the booking)
  10. Despatch a job to a data driver, again checking SMS-On-Despatch and SMS Textback.