GSM Tracker HELP v316

GSM Tracker Help

This is help for Aspicore GSM Tracker v3.16. It contains description of functions specific to that version.

For general features and instructions, please use also the help of a previous version.

Quick start

Download the following PDF files and follow the instructions there.

 Installation and configuration (Adobe PDF, 112 kB)

 Usage instructions (Adobe PDF, 100 kB)

***

Two alternative ways to integrate with GpsGate:

 Setup instructions for GpsGate.com service (Adobe PDF, 208 kB, for v3.1x only)

 Recommended. Setup as a GpsGate TrackerOne tracking unit (Adobe PDF, 463 kB, for v3.16)

Read more tips and requirements regarding TrackerOne configuration in this forum thread .

***

Recommended settings.

See also Support FAQ (Including installation and uninstallation instructions)

Function description

Options menu

Some items in the Options menu are described below.

Connect GPS Open a connection to a GPS Receiver.The used connection method depends on the value of the settings item Use Location API.(Skip the Bluetooth stuff below, if your phone has an integrated GPS chip.)

Bluetooth device selection dialog opens. Choose the Bluetooth name of your GPS device from the list.

Before you execute this command, make sure, that the Bluetooth radio is turned on in your handset and that your BT GPS device has been paired with your handset. (Pairing in beforehand is not necessary, if the setting Use Location APIhas been turned on.)

Pairing can be usually done from the second tab of the Connectivity / Bluetooth applet within your S60 device. (Many BT GPS devices work also without pairing, but why not pair them to be sure. Pairing is especially required with some BT GPS devices requiring a PIN code.)

When the Connect GPS command succeeds, the leftmost icon turns enabled. If the GPS receiver has good satellite visibility, the UTC time and GPS coordinates appear into the display. If the satellite signal is too weak, there is a question mark on top of the leftmost icon.

Hide Leave Aspicore GSM Tracker running in the background while using your handset to other purposes. (Turn on the System attribute in the settings, if you want to make sure that the memory management does not close down the background application.)
Packet data Connect Internet Open packet data connection.Option to specify IP address and port of the server in the Internet, which is listening to the UDP (or TCP) packets sent by GSM Tracker.When prompted, select an Internet access point. Do not use MMS or WAP access points!When the packet data connection succeeded, the middle icon of the main view turns enabled. (If not, a timeout may have occurred. Try again.)
Packet data Send current position This option sends immediately the current GPS coordinates to the server.
Packet data Enter and send label With this option, you can give a name (POI, Point of Interest) to your current location. You can find the coordinates of this location later from the database by this name. You can use this function to collect the locations of your favourite restaurants, post boxes etc. into your database.
Enter label for current location You can give any alphanumeric name you want for your current location. This name together with your current coordinates are sent to the server. You can use this label as you like in your server application.
Packet data Keep sending label Send the same name to all the subsequent locations as well. This is a way to name routes. (E.g. “Home to work”).
Packet data Send test msg This you can use to test that your GPRS/3G data connection works and the messages reach your server
Packet data Disconnect Internet Closes the GPRS/3G data connection.
Cell phone Show cell info Shows the current GSM network cell information. This is information about the GSM/3G base station tower, your phone is currently connected to. Data field explanation.
Cell phone Stop cell tracking Stop observing the GSM/3G network cell change (i.e. base station tower change) events. When you give command “Start cell tracking”, the application starts to react to network cell change events. “Stop Cell Tracking” deactivates these actions.
Cell phone Show IMEI Shows the phone model number and unique serial number (IMEI). In addition, you can see the IMSI number from the SIM card (International Mobile Subscriber Identity).

Usage hints

Keep the application running while using other applications

Turn on the System attribute in the settings, if you want to make sure that the memory management does not close down the background application.Side effect: If you set the system attribute ON, the application cannot be closed down by pressing the delete (C, backspace) key in the task list. You have to use the exit option in the application itself.

Switching between applications

If you have several applications open and want to switch from one application to another: Press and hold (Menu key). The application switching window opens showing a list of applications that are currently open. Scroll to an application and press to go to it.

See the collected location data

Go to http://www.toimii.com/gps/ to see your location data collected by Aspicore’s logging database server.Enter your phone’s IMEI and click Send.Soon you should see a table of stored location coordinates and links to various online maps.The MapPoint link shows 20 most recent locations simultaneously on a single map. This is useful, if you want to fine-tune the trigger settings in GSM Tracker.If you have Google Earth installed into your PC, try the Network Link with title “Snailtrail of 20 most recent valid positions”. It shows your route on top of satellite or aerial image.You can give your friends the URL of Google Earth Network Link to your latest position and then they can add a self-refreshing Network Link to their Google Earth to see your position moving!

User interface

Main screen

 

For the description of the icons and displayed data fields, use the help of a previous version.

Settings view

 


Figure 1. Settings view, GPS
This chapter explains the meaning of each configuration settings item.The GPS tab1 On startup GPS

  • On: Causes automatic execution of connect GPS command when the application is started and whenever the GPS connection is lost.

    (Dependency: Requires either (1) that the item Use Location API is On or (2) that the item Store GPS BT name has been turned on and the GPS has been connected at least once manually through the Options menu.)

  • Off: User must manually choose the connect GPS command from the Options menu to get connected with the GPS module.

2 Max fix wait, min

This setting determines how long the application waits for the GPS getting a good satellite signal before giving up. This timeout value is used, when making an automatic GPS connection. The timer can be disabled by setting the value to zero.

The setting max fix wait, min works only when the GPS is initially off and is then switched on. It can be used together with settings Powersave after fix and Retry after, min as instructed at Extended battery operation with internal GPS

The setting max fix wait, min has no effect, when the GPS is on and the GPS signal changes from good to bad. GPS stays on in this case even if the GPS signal remains bad for a long time.

3 Powersave after fix

    • On: Causes the application to turn off the GPS straight after getting a good satellite signal and sending the good fix to the server or enquirer. Note that some send action is needed before the GPS module goes sleeping. Next time the GPS is woken up again e.g. based on “Retry after, min” timer or when receiving a position enquiry SMS. This GPS powersave function has no effect if the charger is connected.

Off: The GPS stays on once activated even if the satellite signal disappears. The GPS is turned off, if manually switched off from the menu, the application is exited or the NMEA data from the GPS chip stops flowing.4 Retry after, min

If the value of this setting is greater than zero and On startup GPS is on, try reconnecting GPS every X minutes unless already connected.

Unless the GPS has been turned off due to the  Powersave after fix parameter described above, uses adaptive GPS reconnection interval to save battery power: first 10 minutes continuous retry (consumes Bluetooth transmission power or internal GPS power constantly), after that try reconnecting every X minutes, where X is set by this settings item (consumes extra power only once in X minutes).

If the value is zero, the GPS connection is continuously tried to keep on (provided that On startup GPS is on and the GPS has not been intentionally disconnected).


Figure 2. Settings view, GPS
5 Use Location API

  • On: Use operating system’s location acquisition services to get GPS data. This option is required to use an internal GPS chip within your phone, but it can also be used with an external Bluetooth GPS device. This option may enable you to run several location aware applications on your device at the same time.
  • Off: Use a direct Bluetooth serial port connection to an external Bluetooth GPS device.

NB. If your device has not got an internal GPS chip, the phone setting positioning method should be set toBluetooth GPS. (Don’t worry, it probably is by default.) If there are no Bluetooth GPS devices on your phone’spaired devices list, the system asks you select the device, when you first time issue the Connect GPS command. The selected device is automatically added into the paired devices list. If you later want to use a different Bluetooth GPS device, clear the old device from the paired deviceslist first. (This description concerns the Location acquisition API only.)

6 Store GPS BT name

  • On: Do not show the Bluetooth device selection dialog, when issuing the connect GPS command. Connect to the same Bluetooth device as on the previous time without asking the user to choose the device.
  • Off: Ask the user to choose the Bluetooth device, when theconnect GPS command is executed.

NB. This settings item has no effect, if the item Use Location API has been turned on.

7 GPS init string

This settings item is blank by default. If there is some text, the text suffixed with CR+LF is sent to the Bluetooth GPS, when a Bluetooth serial port connection is initiated. This settings item has no effect, if the item Use Location APIhas been turned on.


Figure 3. Settings view, Net
The Net tab1 Store Access Point

  • On: Do not show the Select access point dialog, when issuing theConnect Internet command. Connect to the same Internet access point (IAP) as on the previous time without asking the user to choose the IAP.
  • Off: Ask always the user to select access point, when theConnect Internet command is executed.

2 On startup conn.

  • On: Causes automatic execution of Connect Internet command when the application starts and whenever the packet data connection is lost. Use the stored Server IP address and Server Port numbers instead of asking them interactively. Opens an IP socket to the logging database server. The socket must be open before any information can be sent to the server. When Http protocol is used, the Server IP and port settings are redundant.
  • Off: User must manually execute the Connect Internet command from the Options / Packet data menu to open a socket to the logging database server IP and port. The packet data connection must be open before any data can be sent to the server.

3 Disable bill prompt

  • On: Don’t show Billable Events dialog, when connecting to the Internet or sending a text message.
  • Off: Show Billable Events dialog according to the Symbian Signed rules. (The dialog warns the user that making an Internet connection or sending a text message may cause charges to the phone bill).

NB. The settings items 4, 5 and 6 can be ignored, when using HTTP instead of plain TCP or UDP connection.

4 Server IP address

The IP address of the logging database server. The GSM Tracker application sends the GPS data and / or GSM cell data to this IP address as UDP datagram or TCP packet. You must have a GPRS/3G data service enabled in your carrier contract and a suitable Internet Access point created in you phone’s Connection settings.

This setting item can be ignored, when using HTTP instead of plain TCP or UDP connection.

Make sure, that the field “5 Optional Hostname” is empty, if you want that this IP address has an effect.

If you are using a public internet packet data access point, you can use Aspicore’s test server for testing purposes. Test server’s IP address is 217.152.56.226. You can see the data stored by Aspicore’s test server at URL  http://www.toimii.com/gps/. You need to submit your IMEI code to see the data collected from your phone.

 


Figure 4. Settings view, Net
Figure 5. Settings view, Net
5 Optional hostname

By default this field is empty. If you enter a DNS name here, it overrides the “Server IP address” above.

You can use this field e.g., if you haven’t got a fixed public IP address for your server. You can access a server behind a dynamic public IP by e.g. using services from www.dyndns.com.

Note, that you should not add any http:// prefix in this field. Enter just the DNS name. (See figure 5). You can check, that a name is in proper format by giving a command likenslookup <your DNS name> (e.g. nslookup aspicore.dyndns.org) in the command prompt of your computer. If you get a proper IP address as an answer, <your DNS name> is in a valid form.

This setting has effect only when the setting “On startup conn.” is switched on. (Manual Internet connects via the menu ask always an IP address.)

If you enter anything to this Optional Hostname field,please check that the packet data connection status icon changes to connected state. This shows, that your DNS name works.

If the DNS name is invalid and the “On startup conn.” is switched on, the packet data connection status icon does not ever change to connected. Still the application continuously tries to resolve the IP address. You can see this in the Log view. If you see there repetitive “Looking up” messages followed by a time-out message, there is something wrong in your DNS name (or DNS server settings within your Internet access point). Change  theOptional Hostname field to a working form or clear it entirely and use a raw IP address from the field Server IP address instead.

6 Server port

The UDP port (or TCP port), the logging database server is listening. Aspicore’s test server is currently listening on UDP port 1002.

7 Connection reset, min

Possibility to force Internet connection disconnect/reconnect every X minutes, where X is set by this settings item.

0 = disabled. (recommended value)

8 Transport protocol

  • TCP/IP: Use a TCP connection instead of connectionless UDP datagrams. The format of the message payload is the same as with UDP. The server address also for TCP is set byt the items Server IP addressOptional Hostname and Server port.
  • UDP/IP: Default value. UDP protocol is used with the GPRS/3G connection to send location data to a server in the Internet. (Or if the setting HTTP Protocol is on, then HTTP is used instead of plain UDP/TCP.)

Figure 6. Settings view, Net
9 Output buffer

  • On: Store waypoints if the data connection is lost and forward them once the connection is restored. Buffering is available, when using plain TCP/IP or UDP/IP connection. The buffering works best with a TCP/IP connection. The buffering is not implemented with HTTP connection.
  • Off: Do not store data into the buffer when there is no data connection.

In the main screen the bottom row shows a counter for the number of positions sent to the server. If the buffering is in use and the data connection is broken, the counter shows the number of stored positions in the buffer instead. In this case the number is prefixed with letter B.

If you are only using SMS only and not the packet data connection at all, then please turn off the output buffer to make sure it does not just consume memory.

10 User name

Used for GpsGate protocol to log in the server, when the application uploads real-time GPS data there. Also used in HTTP protocol, when URL param: uid is switched on.

NB. If you do not see this setting, turn HTTP protocol temporarily off or turn on the HTTP setting URL param: uid.

11 Password

Used for GpsGate protocol to log in the server, when the application uploads real-time GPS data there. Also used in HTTP protocol, when URL param: pwd is switched on.


Figure 6a. Settings view, Net
12 GpsGate protocol

  • On: Use GpsGate Server $FRLIN Protocol with TCP/IP communication as specified by Franson Technology AB. SendUser name and Password in $FRLIN login command. This protocol is selected by the settings wizard for GpsGate.com.
  • Off: Do not use GpsGate $FRLIN Protocol. Use generic GSM Tracker UDP/IP or TCP/IP communication or TrackerOne protocol (see below). Each message contains the IMEI code. Unless you are using TrackerOne protocol, the tracking data format is as described in the data format description.

13 TrackerOne protocol

  • On: Use GpsGate “TRACKER ONE” protocol. GSM Tracker appears to GpsGate Server as a generic GpsGate TrackerOne tracking unit as defined in Franson Technology AB reference design. This setting affects both the TCP/IP and the SMS message formats being used when sending location information to the server. (No effect on HTTP.)
  • Off: Do not use TrackerOne format when sending location data to the server.

Figure 7. Http settings view
Figure 8. Http settings view
The Http tab1 HTTP Protocol

  • On: Use Hypertext Transfer Protocol to periodically send the GPS coordinates to a web server. The data is sent to the server with a HTTP GET transaction. The GPS data is sent as URL parameters. The possible textual response from the server is shown in the Info tab.
  • Off: Use UDP datagrams to periodically send the GPS coordinates to a database server in the Internet. (Or TCP, if that transport protocol has been chosen.) UDP is usually faster, more reliable and cheaper to use than HTTP, but UDP is not possible with all carriers and setting up an UDP server with a custom port number may be more problematic than setting up an ordinary web server with TCP port 80. Aspicore GSM Tracker uses UDP for one way communication only. It does not wait for any receipt acknowledgement from the server. Successfully sending a UDP datagram does not guarantee that it actually reaches the server.

2 Internet page URL

The address of the web page, which is used to issue the HTTP GET transaction to upload the GPS data. The IMEI number of the phone (parameter ‘imei’) and selected GPS data values are appended to this web page address as URL parameters. Latitude and longitude are always sent (as decimal degrees with names ‘lat’ and ‘lon’), but the rest of the parameter values are optional.

See examples of the web page implementations in our ASP tools page and PHP tools page.

3 URL param: status

  • On: Append parameter called ‘status’ to the data upload URL. The possible values are ‘A’ and ‘V’. These values come directly from the GPS receiver. The letter A shows that the coordinates are valid. The letter V means, that there were too few satellites visible to make an accurate position fix.
  • Off: Do not send GPS status field to the web server.

Figure 9. Http settings view
4 URL param: speed

  • On: Append parameter called ‘speed’ to the data upload URL. The value is speed in knots.
  • Off: Do not send speed value to the web server.

5 URL param: course

  • On: Append parameter called ‘course’ to the data upload URL. The value is ‘true’ course from the GPS receiver in degrees. (‘True’ instead of ‘magnetic’, but not necessary accurate especially when the target is stationary.)
  • Off: Do not send course value to the web server.

6 URL param: time

  • On: Append parameter called ‘time’ to the data upload URL. The value is the GPS time (UTC, format: hhmmss.sss).
  • Off: Do not send time value to the web server.

Figure 10. Http settings view
7 URL param: date

  • On: Append parameter called ‘date’ to the data upload URL. The value is the GPS date (UTC, format: DDMMYY).
  • Off: Do not send time value to the web server.

8 URL param: altitude

  • On: Append parameter called ‘alt’ to the data upload URL. The value is Altitude in meters according to WGS-84 ellipsoid from the GPS NMEA message $GPGGA.
  • Off: Do not send altitude value to the web server.

9 URL param: HDOP

  • On: Append parameter called ‘hdop’ to the data upload URL. The value is Horizontal dilution of precision from the GPS NMEA message $GPGGA.
  • Off: Do not send time value to the web server.

10 URL param: uid

  • On: Append parameter called ‘uid’ to the data upload URL. The value is the setting User name from the Net tab. (User name is sent as such, without URL encoding. So please make sure it contains only such characters that can be used in an URL.)
  • Off: Do not send user name to the web server.

11 URL param: pwd

  • On: Append parameter called ‘pwd’ to the data upload URL. The value is the setting Password from the Net tab. (Password is sent as such, without URL encoding. So please make sure it contains only such characters that can be used in an URL.)
  • Off: Do not send password to the web server.

If the setting Cell trigger has been turned on and the cell tracking function started (rightmost status icon), the cell info is sent, when the current cell changes. Used parameter names in the http get request for the old and the new network cell are: ‘outcell’, ‘outlac’, ‘outnwname’, ‘outmcc’, ‘outmnc’, ‘outmode’, ‘incell’, ‘inlac’, ‘innwname’, ‘inmcc’, ‘inmnc’, ‘inmode’

There is some description about the meaning of current cell related querystring parameters at the F.A.Q. item 28) HTTP data upload querystring parameters.

See also the setting Send cell every time  for additional info about cell data parameter names in the http get request.

 


Figure 11. Settings view, Trig1
The Trig1 tab

The options below the Trig1 tab decide when the application sends data via the Internet connection or stores data to the output buffer (to be sent later via the Internet connection) or writes data to a capture file. If you want to send data as text messages, see the options below the SMS tab.

1 Time trigger

  • On: Send GPS coordinate data periodically to the logging database server (or a capture file) every <Time period, min>minutes plus <Time period, sec> seconds. Requirements: GPS and Internet must be connected, before this settings item has any effect. Exceptions: GPS is not needed, if Send cell every time is on. Internet connection is not needed, if a capture file is active.
  • Off: Do not use a timer based send data action.

2 Time period, min

The time interval in minutes for timer based GPS data send action. An integer value. Either of the time period fields must be greater than zero for the trigger to work. In addition, Time trigger must be switched On.

3 Time period, sec

The time interval in seconds for timer based GPS data send action. An integer value. Either of the time period fields must be greater than zero for the trigger to work. In addition, Time trigger must be switched On.

 


Figure 12. Settings view, Trig1
4 Distance trigger

  • On: Send GPS coordinate data to the logging database server (or a capture file), when the current position fix differs at least by<Distance, meters> from the previously sent position fix. Requirements: GPS and Internet must be connected, before this settings item has any effect. Exception: Internet connection is not needed, if a capture file is active.
  • Off: Do not use a distance based send data action.

5 Distance, meters

The threshold distance, which causes GPS data send action, when the distance trigger is set on. In addition,Distance trigger must be switched On.

6 Cell trigger

  • On: Send GPS coordinate data together with the network cell information to the logging database server (or a capture file) each time the network cell changes. Requirements: Internet must be connected and cell tracking must be activated, before this settings item has any effect. Exception: Internet connection is not needed, if a capture file is active.
  • Off: Do not use a GSM network cell based send data action.

Figure 13. Settings view, Trig2
The Trig2 tab

The options below the Trig2 tab decide when the application sends data via the Internet connection or stores data to the output buffer (to be sent later via the Internet connection) or writes data to a capture file. If you want to send data as text messages, see the options below the SMS tab.

1 Trig on start

  • On: Send GPS coordinate when vehicle starts moving. (Assumed moving, when speed is greather than 3 knots.)
  • Off: Ignore the “start moving” event.

2 Move time, second

If Trig on start is on, send position only, when moving has continued Move time seconds.

3 Trig on stop

  • On: Send GPS coordinate when vehicle stops. (Assumed stopped, when speed is zero.)
  • Off: Ignore the “stop moving” event.

4 Stop time, second

If Trig on stop is on, send position only, when the vehicle has been stationary Stop time seconds.


Figure 14. Settings view, Trig2
5 Turn trigger

  • On: Send GPS coordinate when the movement direction (course) changes.
  • Off: Ignore the course value.

6 Angle, degrees

If Turn trigger is on, the minimum change in direction, which causes a new data send action. The reference value is the course during the previous data send action.

7 GPS coverage trigger

  • On: Send GPS coordinate when the GPS fix status changes from bad to good or from good to bad. You can use this setting to communicate to the server that the vehicle has possibly driven into a tunnel or into a warehouse. The satellite fix may disappear for a while even if there is an open sky, so this event does not guarantee that the vehicle is in a covered area.
  • Off: GPS fix status change does not initiate data sending. This is the default value.

Figure 15. Settings view, Trig2
8 Tx hold, second

The minimum time between subsequent data send actions. With this parameter you can limit too frequent data transmissions.

This parameter is used as a second phase in the trigger logic. First all the other triggers are evaluated. If some trigger fires, a flag is set. Next the software checks that the previous data send action is older than the Tx hold value. If yes, a new position is sent and the flag is reset. If no, then the flag is kept set until Tx hold seconds have elapsed since the previous send action and then a new position is unconditionally sent without any further trigger examinations that time and the flag is reset.

NB. The Cell trigger is independent of this Tx holdparameter. If you have turned Cell trigger on and the cell tracking has been started, location data is always sent immediately when the cell changes.

9 Max HDOP, 0=ignore

Maximum Horizontal dilution of precision value, when the fix is still considered reliable.

You can use this field to try to filter out incorrect position fixes (“noise”) from your captured location data.

Distance triggerTrig on startTrig on stop and Turn trigger are effective only when the fix is considered reliable, i.e. the GPS device says the fix is valid and in addition this settings item is zero or the current HDOP value got from the GPS is less than or equal to the value of this settings item.


Figure 16. Settings view, Cell
The Cell tab1 On startup tracking

  • On: Causes automatic execution of Start Cell Trackingcommand when the application is started.
  • Off: User must manually execute the Start Cell Trackingcommand from the Options / Cell phone menu to enable some action based on mobile network cell change. Possible actions are: 1) show a note dialog with a beep tone each time the network cell changes, 2) send cell data possibly together with GPS coordinates to the database logging server each time the network cell changes.

2 Cell change beep

  • On: Show a note dialog with a beep tone each time the network cell changes. Add cell change information to the list in the log view.Cell tracking must be activated  or otherwise this settings item has no effect.
  • Off: Be silent about the cell changes. However, send data action may still be fired based on cell change even if this settings item is Off.

3 Send cell every time

  • On: The current cell info are sent in every transaction, when some GPS data is sent. The current cell info are sent also, when the time trigger fires even if there is no GPS data available. Used parameter names in the http get request for the current network cell are: ‘cell’, ‘lac’, ‘nwname’, ‘mcc’, ‘mnc’, ‘ssi’, ‘mode’
  • Off: Do not send current cell info in every transaction.

 


Figure 17. Settings view, File
The File tab1 Capture file

  • On: Store location data in a text file on the flash disk. The data to be stored is selected with the same trigger rules as the data to be sent via the packet data connection. The file is finalized and closed, when you exit the GSM Tracker application or when the day has been changed. Only then you can send the file to a PC e.g. with your phone’s File Manager and its Send via Bluetooth command.
  • Off: File capture function is disabled. (Still the capture file may stay open until you exit GSM Tracker.)

NB. The file is saved, when you exit the GSM Tracker application or when the day has been changed or periodically every 5 minutes (from v3.13). If the battery is removed while the application is still running or the power suddenly disappears, you may lose the data in the open file.

More information about using the capture file feature you can find from our F.A.Q. page at 69) How the capture file works?

2 Capture file path

Directory, where the capture file will be created.

The directory must already exist. GSM Tracker will not create the directory. Use phone’s File Manager to create a new directory, if desired.

The phone’s internal Flash is called disk drive C: and the memory card is called disk drive E:

All the files and folders on C-drive, which are visible with phone’s File Manager, seem to be under the folder C:\Data. (At least this is the case with our N73 and 5500d devices with English settings.)

The capture file itself is always named like trackYYYYMMDD.txt, where YYYY is the year, MM is the month and DD is the day.


Figure 18. Settings view, File
3 NMEA only

  • On: Capture file contains mainly NMEA messages received from the GPS.
  • Off: In addition to NMEA messages, the capture file may contain other messages, that GSM Tracker normally sends with the UDP protocol. Such other messages are e.g. cell ID information.

4 Add timestamp

  • On: Each message in the capture file is annotated with a line containing the current time (local time).
  • Off: Do not add timestamp lines into the capture file. (NMEA messages contain accurate time info anyway.)

5 Offline capture only

  • On: Write data to the capture file only, when the application is disconnected from the Internet. This way you can use the capture file as a backup to the real-time on-line tracking in case there is no cellular coverage in all areas.
  • Off: Write data to the capture file regardless of the online state of the Internet connection.

 


Figure 19. Settings view, SMS
The SMS tab1 Recipient number

Mobile number, where text messages are sent. Used e.g. when selecting Options -> Current position -> Send SMSfrom the menu or when Packet data warning or GPS warning has been turned on.

This number can be used also to check that the person enquiring the current location by SMS is authorized to do so. For more details, see Response target / Stored SMS number.

2 SMS template

Template for the text message, which is sent with the menu command Options -> Current position -> Send SMS. Also used, when responding to a position enquiry SMS.

The template is sent otherwise as such, but the placeholders <lat> and <lon> are replaced with the latest GPS coordinates. The coordinates are the original GPS coordinates converted into decimal degrees format with 6 decimals, e.g. 60.172515 and 24.761947. (Other placeholders, see below.)

We recommend inserting also <utctime> into the template as the sent latitude and longitude values may be old values from the last time GPS has been visible if there is no valid GPS connection in force just when the position enquiry SMS arrives. <utctime> reveals the real position fix time allowing you to verify that the latitude and longitude are fresh enough.

Other  optional fields available in the text message template:
<status>, <utcdate>, <speed>, <course>,
<cellid>, <lac>, <mcc>, <mnc>, <mode>, <ssi>, <imei>

UTC Time is in format hhmmss.sss. UTC Date is in format DDMMYY. Speed is in knots. Course is in degrees 0-360 from north. Read more at F.A.Q. 72) SMS template parameters .

By default, the coordinates sent via SMS are sent in the format “dd.dddddd” (decimal degrees, negative for the other hemisphere). The application version 3.23 supports also other format: “dd mm.mmmm” (degrees + minutes + hemisphere letter).

This new format is selected in the SMS template by using placeholders <lat1> and <lon1> instead of <lat> and <lon>. In this format the latitude degrees are prefixed with letter V, if the app has received a numeric coordinate value from the GPS, but the position fix has been classified as invalid. Empty fields are also possible (no numeric coordinates).

3 Autosend when offline

Offline meaning here that there is no open Internet connection. GSM network and SIM card are still needed to send the text message.

  • On: Enable automatic periodic SMS messages. When there is no packet data connection, send automatic SMS to Recipient
    number
     every Time period, min minutes. Note that the settingDisable bill prompt must be turned on or otherwise the application does not send any automatic text messages. Text message format is as set by SMS template.
  • Off: Do not send automatic periodic text messages.

4 Time period, min

The time interval in minutes for timer based text message send action. An integer value. The value must be greater than zero for the timer to work. In addition, Autosend when offline must be switched On.

 


Figure 20. Settings view, SMS
5 Packet data warning

  • On: Send message “Internet connection lost” as SMS, when the application notices that the GPS connection has been broken and when it cannot be restored within a period of one minute. Later on, when the reconnection succeeds, another SMS is sent: “Internet connection resumed”
  • Off: Do not send automatic text messages based on the Internet connection status.

6 GPS warning

  • On: Send message “GPS connection lost” as SMS, when the application notices that it has not received any data from the GPS within 5 minutes or there has been an unexpected break in the Bluetooth connection. Later on, when the reconnection succeeds, another SMS is sent: “GPS connection resumed”
  • Off: Do not send automatic text messages based on the GPS connection status.

7 Enquiry string

Enquiry string and Response target allow sending GPS data on request. The application responds with the current location, when it receives an SMS starting with the string specified in Enquiry string. The string can be e.g. “?loc”.

8 Response target

The purpose of this setting is to protect the privacy of the location data: who is permitted to enquire the location of the handset and where the data is sent. The alternatives are:

  • SMS requester: Whoever knowing the enquiry string can enquire the location. The application responds with an SMS message to the enquirer. The message format can be set with the setting SMS template.
  • Stored SMS number: Only the party specified by the setting Recipient number is allowed to enquire the location. The application responds with an SMS message to the enquirer. The message format can be set with the setting SMS template.
  • Stored server address: Whoever knowing the enquiry string can enquire the location. When the application receives an SMS matching the string specified in Enquiry string, it responds by sending the current location to the Internet server via the packet data connection. NB The data connection must be already open, so turn on the settings  Net / Store Access Point and Net / On startup conn. The protocol used for the sending is the same as with the menu command Options -> Current position -> Send to Internet. It is determined by the settings on the Net and Http tabs.

Figure 20a. Settings view, SMS
9 GPS activation by SMS

  • On: When the application receives a position enquiry by SMS, it connects the GPS automatically if not already connected. If you want that the GPS is switched back off after sending reply, remember to turn on also the setting “Powersave after fix”.
  • Off: Received SMS messages do not affect the power state of the GPS connection.

Figure 20b. Settings view, SMS
10 App start alert

  • On: Send message “Application started” (plus timestamp plus IMEI) as SMS to Recipient number, when Aspicore GSM Tracker is started. You can use this feature to recover a stolen phone. Remember to turn on also the settings Autostart and Disable bill prompt .
  • Off: Do not send automatic “Application started” text messages.

11 SIM change alert

  • On: Send message “SIM card changed” (plus timestamp plus IMEI) as SMS to Recipient number, when Aspicore GSM Tracker is started with a different SIM card change. This message reveals the new phone number. You can use this feature to recover a stolen phone. Remember to turn on also the settingsAutostart and  Disable bill prompt .
  • Off: Do not send automatic “SIM card changed” text messages.

12 Configure by SMS

  • On: Allow remote configuration  commands from the remote management server.
  • Off: Do not react to remote configuration commands.

13 Authorized number

Mobile number, which is allowed to send remote configuration commands to this mobile device. If empty, then allow any number.


Figure 21. Settings view, Misc
The Misc tab1 Calc speed in km/h

Convert the speed value in knots received from GPS into kilometers per hour.

2 Calc speed in mph

Convert the speed value in knots received from GPS into miles per hour.

If both km/h and mph are off, then the application shows the unconverted GPS speed value. It may be knots or km/h, depending on the GPS device and its settings.

3 Speed text emphasis

If this setting is ON, then the speed value is shown on a white background. It may be useful, if the red numbers are difficult to see on the background colour set by the active theme.

4 Diagnostics mode

Show additional debugging and diagnostics messages in the log view.

 


Figure 22. Settings view, Misc
5 On startup backlite

  • On: Causes automatic execution of keep backlight on command when the application is started.
  • Off: Backlight is in power save mode when the application is started. The backlight is de-activated after approximately 13 seconds of inactivity. You can still manually execute the keep backlight on command from the Options menu, but the command does not stay in force when you restart the application.

6 Global backlight

  • On: This setting makes the keep backlight on command to affect also other applications even when the Aspicore GSM Tracker is not in foreground. This setting does not turn the backlight on. It adjusts the scope of the keep backlight on command.
  • Off: This setting makes the keep backlight on command to work only locally, when Aspicore GSM Tracker is running in foreground. Backlight power save mode is always enabled, when the application is put to the background even if the keep backlight on command is active.

 


Figure 23. Settings view, Misc
7 System attribute

Possibility to set the system attribute in the settings. This prevents the OS memory management of closing this app down, when the other applications need more memory.

NB. Side effect: If you set the system attribute ON, the application cannot be closed down by pressing the C key in the task list. You have to use the exit option in the application itself.

8 Autostart

  • On: Start GSM Tracker automatically, when you switch the power on. This feature requires, that you have left the check box “Autostart possible” selected, when installing the application.
  • Off: Do not leave GSM Tracker automatically running after switching the power on. Due to technical reasons, the application starts anyway in the background after the device boot, if you left the check box “Autostart possible” selected, when installing the application. But if this setting item is OFF, the application exists by itself during the initialization period and GSM Tracker does not leave running. You have to restart the application manually.

9 Password on exit

  • On: User cannot exit GSM Tracker without entering the password. This ensures, that the application is not accidentally shut down, if it is supposed to be always running. The user is always able to put the application into background e.g. by pressing the red “end” key. Turn on also the System attribute, otherwise the application can be stopped through the task list. The password must be set through the Options menu within the “GSM Tracker Settings” view. Choose there the menu command “Settings password…”. (The same password is shared between the settings entry and the application exit functions.)
  • Off: Do not ask a password when leaving GSM Tracker.

10 Send also $GPGGA

  • On: Send the $GPGGA lines from the GPS to the Internet server (UDP or TCP protocol, no effect with HTTP) and to the possible capture file. $GPRMC lines are always sent. $GPGGA lines contain the number of satellites being used, horizontal dilution ofprecision and altitude values, among other fields. Even if you turn this setting on, GSM Tracker does not send $GPGGA sentences, if your GPS device does not output those sentences.
  • Off: Do not send the $GPGGA lines from the GPS to the Internet server and to the possible capture file. Send only the standard $GPRMC lines containing the core GPS fix data like time, latitude, longitude, speed and course.

 


Figure 24. Settings view, Misc
11 Map page URL

Template for the URL, which is sent to the browser, when the user chooses the menu option Current position ->Show in browser.

The placeholders <lat> and <lon> are replaced with the current latitude and longitude values before this URL is given to the browser.

NB. The last character of the URL must not be a space. Otherwise the browser does not load the page and the browser remains blank.

 


Figure 25. Settings view, Label
The Label tab1 Quick label 1

Text to be shown in the grid view position 1.

You can use these quick label fields to preset labels that are shown in the label tab. Then when the user presses the corresponding key (1-9), GSM Tracker sends that label (or its ordinal number) to the server. This is quicker way to send labels than by using the Options menu.

Preset label can be like “Job started”, “Job finished”, “Busy”, “Ready”, “Private”, “Help”, “Accident”, “Traffic jam” etc.


Figure 26. Settings view, Label
10 Send number only

  • On: Send only the number in the label field, when pressing a quick label key within the Label tab.
  • Off: Send the whole text in the label field, when pressing a quick label key within the Label tab.

Figure 27. Settings password
PasswordYou can set password for the settings menu through by choosing Settings password… from the Options menu within the Settings view. When the settings password has been set, you cannot enter the Settings view again without entering the correct password.Step by step instructions to set the password: When GSM Tracking is running and activated, first select menu Options->Settings. Then WITHOUT pressing “Back” select again Options and there should be “Settings password…” as the second menu item. Select “Settings password…” from the menu and the dialog of Fig. 27 appears.If you have set the password and want to remove it, you can do it by changing password to an empty string (blank).The same password is used as exit password, if enabled.

Recommended settings

Initial check

First we recommend that you manually try the following commands and check that your setup is working:

  • Options / GPS / Connect GPS
  • Options / Packet data / Connect Internet
  • Options / Packet data / Send current position

Verify, that everything works ok with Aspicore’s test server as described under title See the collected location data above .

Nokia integrated GPS

If you want to use the internal GPS of a Nokia phone, enable “Assisted GPS” (and optionally “Integrated GPS”) and disable “Network based” and “WiFi based” in phone positioning settings. Check that positioning server is supl.nokia.com.

Real-time GPS tracking

Then we recommend you to make the following settings, if you want to have continuous real-time position tracking and the power usage is not a problem:

  • GPS / On startup GPS: On
  • GPS / Use Location API: On
  • Net / Store Access Point: On
  • Net / On startup conn: On
  • Net / Disable bill prompt: On
  • Net / Server IP address: 217.152.56.226 (Aspicore’s test server)
  • Net / Server port: 1002 (Aspicore’s test server)
  • Trig1 / Time trigger: On
  • Trig1 / Time period, min: 10 (or other amount of minutes, if desired)
  • Trig1 / Distance trigger: On
  • Trig1 / Distance, meters: 200
  • Misc / System attribute: On (side effect: the application does not terminate from the task menu.)
  • Misc / Autostart: On

Next time you start the application, the GPS and data connections are created automatically and they stay on constantly. Data is sent every 10 minutes or whenever the device has moved 200 meters.

Extended battery operation with internal GPS

The GPS chip consumes much power. The GPS power can be automatically switched on and off as needed. If the application is set to report its GPS position every 10 minutes and to turn the GPS off in between, the battery time is about three times longer than when keeping the GPS chip constantly powered up.

Recommended settings for extended battery operation, when using integrated GPS:

  • GPS / On startup GPS: On
  • GPS / Max fix wait, min: 2
  • GPS / Powersave after fix: On
  • GPS / Retry after, Min: 10
  • GPS / Use Location API: On
  • Net  / Store Access Point: On
  • Net / On startup conn: On
  • Net / Disable bill prompt: On
  • Net / Server IP address: 217.152.56.226 (Aspicore’s test server)
  • Net / Server port: 1002 (Aspicore’s test server)
  • Trig1 / Time trigger: On
  • Trig1 / Time period, sec: 10
  • Misc / System attribute: On (side effect: the application does not terminate from the task menu.)
  • Misc / Autostart: On

With these settings the handset reports its GPS position every 10 minutes with minimal power usage. The GPS is switched off, when it is not used.

NB. The value of the trig1 time must be less than the GPS retry time!

Explanation: “Trig1 / Time period” should be clearly less than “GPS / Retry after, min”. Otherwise “GPS / Powersave after fix” does not work as expected. GSM Tracker sleeps the GPS module only after sending somevalid data with satellites visible. Data sending is controlled by the triggers. “GPS / Retry after, min” controls how often the GPS gets waked up.

More explanation: if you turn on the setting “GPS / Powersave after fix”, then the setting “Trig1 / Time period, sec” has no obvious effect to the user. In this case the setting “GPS / Retry after, Min” effectively determines how often the mobile sends the latitude and longitude to the server. But the internal program logic requires that also the time set by the setting “Trig1 / Time period, min” or “…, sec” has elapsed before the program actually sends the location.

It does not matter whether you use “Trig1 / Time period, min” or “Trig1 / Time period, sec”, the important thing is that the sum of Trig1 values is less than the value of the setting “GPS / Retry after, Min”. (This requirement is valid only when the setting “GPS / Powersave after fix” has been turned on.)

Maximum battery operation, position polling by SMS

If you have a GPS phone (integrated GPS chip) and you just want to keep Aspicore GSM Tracker running in the background with minimal power consumption and let your friends to ask your phone’s GPS coordinates by an automatic SMS, use the following settings:

  • GPS / On startup GPS: Off
  • GPS / Max fix wait, min: 2
  • GPS / Powersave after fix: On
  • GPS / Use Location API: On
  • Net / On startup conn: Off
  • Net / Disable bill prompt: On
  • SMS / SMS template: “Latitude, Longitude: <lat>, <lon>, <utctime>, <status>”  (more fields than shown here will do no harm)
  • SMS / Enquiry string: “?loc”
  • SMS / Response target: “SMS requester”
  • SMS / GPS activation by SMS: On
  • Misc / System attribute: On (side effect: the application does not terminate from the task menu.)
  • Misc / Autostart: On

With these settings the battery lasts up to five days (120 hours) without charging (Nokia 6110 Navigator, GSM Tracker continuously running in the background).

v3.16 … v3.18: Whenever the handset receives a text message “?loc”, it responds with two text messages: first to acknowledge that the command was received and second text, when it gets a valid GPS fix. The first text message contains cached GPS coordinates, which may be old, so please pay attention to the timestamp <utctime>.

Additional note for versions from 3.19 onwards: The latest version replies to the “?loc” inquiry with one or two reply messages. It sends two replies, when both the conditions below are true.

  • The GPS position fix is not valid at the moment, when the location inquiry text arrives.
  • Later the GPS chip succeeds to get a valid position fix within the time set by the settings item GPS / “Max fix wait, min”.

In other cases the latest version sends one reply only.

You can add cell tower data placeholders to the SMS template. Then you get at least the cell tower information if the target phone is online even if the GPS satellites were not visibile.

Theft protection

You can use the above settings to protect your GPS phone against loss. Set also Password on exit to On. If you happen to lose your phone, borrow your friend’s cell phone, send text message “?loc” to your phone number and your phone normally replies with its GPS coordinates.

Enable also the SMS settings App start alert and SIM change alert. These functions can be used to track a stolen phone. If they are turned on and SMS / Recipient number has been set, they send a text message to the preset number, when the application is started or when the SIM card has been changed, respectively. This text message reveals the new phone number, which you can then use to interrogate the phone’s location by further text messages. To use these features make sure that Net / Disable bill prompt is ON and Misc / Autostart is ON.

Related FAQ item: 65) How to send the latitude and longitude by SMS automaticly when the application is started?

(Disclaimer: Please note, that there are many reasons, why the enquiry chain might not work. We do not guarantee that you will always recover your lost phone.)

Contact:

Please use our support forum