GSM Tracker Help

This is help for Aspicore GSM Tracker for Series 60 v1.10 - v1.14. For other versions, click here.

See also Support FAQ (Including installation instructions)

Contents

1) User interface

1.1) Main screen

1.2) Settings view

1.3) Options Menu

2) Usage hints

3) Configuring the GPRS Internet access point

4) Pairing your phone with the Bluetooth GPS

5) Diagnostics

6) Known issues

7) Specifications

8) Purchase

User interface

Main screen


Figure 1. State view, no connection


Figure 2. State view, connected


Figure 3. State view, satellites out of sight

The main screen contains two tabs: State and Log. You can navigate between the tabs with left and right arrow keys.

The State view contains three icons showing the connection state and a few dynamic text fields showing most important GPS data values.

The leftmost  icon shows whether the Bluetooth connection to the GPS receiver is active or not. Explanation:

  • Figure 1: GPS not connected.
  • Figure 2: GPS connected, three satellites in sight
  • Figure 3: GPS connected, but the satellites are out of sight and thus the position fix is not valid (Note the letter V before the latitude degrees).

The middle icon   shows the GPRS connection status. Explanation:

  • Figure 1: GSM tracker is not connected to the database server.
  • Figure 2 and 3: GSM tracker is connected to the database server. (Actually GSM tracker has requested the system to open an UDP socket to the logging database server IP and port. Because the server does not confirm the connection, this icon does not guarantee that the connection works.)

The rightmost  icon shows whether the GSM network cell tracking has been activated or not. Explanation:

  • Figure 1: Cell tracking is not active
  • Figure 2 and 3: Cell tracking has been activated

The active cell tracking means, that the program has asked the Symbian OS to inform it about changes in the current network cell. Whenever the cell changes and the cell tracking is active, the program does the following:

  • If the setting "Cell change beep" is on, the program beeps, shows a short note dialog and adds cell information to the log.
  • If the setting "Cell trigger" is on and GPRS connection has been opened, the program transmits network cell data together with possible GPS location data to the database server.

The UTC time field shows the time from the latest interpreted data read from the Bluetooth GPS. UTC time should go on in real time with a few seconds interval. This is a good indication that the Bluetooth GPS connection is working and is in sync. The number of currently visible satellites is shown at the end of the UTC time row.

The data row with label Msg at the bottom of the state view shows counters for the NMEA messages received from the Bluetooth GPS. The first counter is the total count of all the received NMEA messages since the application start. The second counter shows the number of NMEA messages received since the previous display refresh. The display is periodically redrawn with a few seconds interval.


Figure 4. Log view

 

The log view shows a list of latest application status change messages. You can see the whole message and the associated timestamp by clicking the line with the selection key.

Settings view


Figure 5. Settings view

This chapter explains the meaning of each configuration settings item.

1 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 the connect GPS command is executed.

2 On startup GPS

  • On: Causes automatic execution of connect GPS command when the application is started and whenever the GPS connection is lost.
  • Off: User must manually choose the connect GPS command from the Options menu to get connected with the Bluetooth GPS.

3 On startup GPRS

  • On: Causes automatic execution of connect GPRS command when the application is started and whenever the GPRS connection is lost. Use the stored GPRS Server IP and GPRS Server Port numbers instead of asking them interactively. Opens an UDP socket to the logging database server. The socket must be open before any information can be sent to the server.
  • Off: User must manually execute the connect GPRS command from the Options / GPRS data menu to open an UDP socket to the logging database server IP and port. The UDP socket must be open before any data


Figure 6. Settings view

4 On startup tracking

  • On: Causes automatic execution of Start Cell Tracking command when the application is started.
  • Off: User must manually execute the Start Cell Tracking command from the Options / GSM menu to enable some action based on GSM 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.

NB. Series 60 version 2.x phone owners Please read known issues before switching this setting on.

 


Figure 7. Settings view

5 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.

6 Time trigger

  • On: Send GPS coordinate data periodically to the logging database server every <Time period, min> minutes. Requirements: GPS and GPRS must be connected, before this settings item has any effect.
  • Off: Do not use a timer based send data action.

7 Time period, min

The time interval in minutes for timer based GPS data send action. Must be greater than zero for the trigger to work. In addition, Time trigger must be switched On.

 


Figure 8. Settings view

8 Cell trigger

  • On: Send GPS coordinate data together with the GSM cell information  to the logging database server each time the network cell changes. Requirements: GPRS must be connected and cell tracking must be activated, before this settings item has any effect. If this trigger is switched on and the GPRS is connected before the cell tracking is activated, the current network cell at the activation time gets immediately transmitted to the server.
  • Off: Do not use a GSM network cell based send data action.

9 Distance trigger

  • On: Send GPS coordinate data to the logging database server, when the current position fix differs at least by <Distance, meters> from the previously sent position fix. Requirements: GPS and GPRS must be connected, before this settings item has any effect.
  • Off: Do not use a distance based send data action.

10 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.


Figure 9. Settings view

11 GPRS Server IP

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. You must have a GPRS service subscription from your GSM service provider and a suitable Internet Access point created in you phone's Connection settings.

If you are using a public internet GPRS access point, you can use Aspicore's test server for testing purposes. Aspicore's IP address is shown in Figure 9. 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. 

12 GPRS Server Port

The UDP port, the logging database server is listening. Aspicore's test server is currently listening on port 1002.


Figure 10. Settings view

13 Diagnostics mode

Show additional debugging and diagnostics messages in the log view.

14 Store Access Point

  • On: Do not show the Select access point dialog, when issuing the connect GPRS 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 the connect GPRS command is executed.


Figure 11. Settings view

15 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.

16 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.

Options menu

Some items in the Options menu are described below.

GPRS data Send current position This option sends immediately the current GPS coordinates to the server.
GPRS 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.
GPRS 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").
GPRS data Send GPRS test msg This you can use to test that your GPRS connection works and the UDP datagrams reach your server
GPRS data Disconnect GRPS Closes the GPRS connection. (This has no useful effect, if your setting "On startup GPRS" is on, because after a while the system automatically reconnects.)
GSM Show Cell Id Shows the current GSM network cell information. This is information about the GSM base station tower, your phone is currently connected to.
GSM Stop Cell Tracking Stop observing the GSM network cell change (i.e. base station tower change) events. When you give command "Start cell tracking", our application requests the Symbian OS to give a signal (event) each time the GSM cell changes. "Stop Cell Tracking" cancels this request.
GSM Show IMEI Shows the phone model number and unique serial number (IMEI).

Usage hints

Put running in the background

Press the (End key, i.e. Red phone key) to leave Aspicore GSM Tracker running in the background while using your phone to other purposes.

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.

Cannot connect GPS

If Aspicore GSM Tracker does not manage to get the GPS connection established, although the GPS device should be in range and powered up, try power-cycling the GPS device (switch the power off and on again).

If this does not help, try power-cycling you phone. (It seems, that sometimes the Bluetooth stack in either of the devices gets into such a state, that you must boot the device to get the Bluetooth connection working again.)

Configuring the GPRS Internet access point

Aspicore GSM Tracker sends the GPS data and / or GSM cell data to the logging database server via UDP/IP messages. To be able to send data, you must have a GPRS service subscription from your GSM service provider and a corresponding Access point created in your phone's Connection settings. You can find instructions to configure the connection settings from here.

Pairing your phone with the Bluetooth GPS

It is recommended that you pair you Bluetooth GPS device with your phone before you make the Bluetooth connection from the Aspicore GSM Tracker application. You can find instructions to  pair your Bluetooth GPS device from here.

Diagnostics

You can find step-by-step installation, troubleshooting and diagnostics information from here.

Known issues

Cell Tracking and Series 60 version 2.x

The GSM cell tracking feature of this program relies on the GSM network cell ID information when detecting the current location.  The feature uses a couple of unofficial APIs, which belong to the Series 60 version 1.x phones like Nokia 3650 and Nokia N-Gage. Symbian has not published these APIs for third-party developers.

According to our tests, the current version of Aspicore GSM Tracker (v1.10) uses only such GSM network cell APIs, which work also in Series 60 version 2.0 phones like Nokia 6600 and 7610. Still the APIs are unofficial and may not work in other Series 60 version 2.x phones.

Please be careful and test first that the cell tracking works, before switching on the On startup tracking setting in a Series 60 version 2.x phone. If, however, your phone freezes, while using cell tracking, we would appreciate, if you could inform us at support@aspicore.com, so that we can make the necessary changes to the future versions.

GPRS Internet and WAP are mutually exclusive in Series 60 v1.0

Unable to use currently active connection. Establish new connection?
Figure 12. Using WAP simultaneously with AcGsmTrckr in S60 1.0

Series 60 1.x allows only one network interface to be active at a time. This means that you may not access many services, such as MMS, Internet and WAP, simultaneously.

If you have Aspicore GSM Tracker running with GPRS connection activated in a Series 60 1.x phone and you try to initiate a WAP session, a note dialog like in figure 9 is shown. (Unable to use currently active connection. Establish new connection?)

If you answer Yes, you can start using WAP, but Aspicore GSM Tracker will not be able to send data to the server in the Internet via UDP/IP. This may seem confusing, since Aspicore GSM Tracker seems to work as usual, but the sent UDP packets still do not necessarily reach the server! The confusing behaviour can be avoided by keeping  the setting Store Access Point switched on.

This limitation does not apply, if you have a Series 60 version 2.0 phone. Series 60 2.x supports multihoming, which means that several network interfaces can be active at one time.

We are not aware of any additional bugs or problems in Aspicore GSM Tracker v1.10. If you find a bug in our program, we would be grateful, if you inform us at support@aspicore.com.

Specifications

Supported phones

Any Series 60 smartphone.

Series 60 version 1.0 (Symbian OS v6.1)

  • Nokia 3600, 3620, 3650, 3660, 7650,  N-Gage™,  N-Gage QD™
  • Sendo X
  • Siemens SX-1

Series 60 version 2.0 (Symbian OS v7.0)

  • Nokia 3230, 6260, 6600, 6620, 6630, 6670, 7610
  • Panasonic X700

Supported GPS devices

Any NMEA-0183 compliant Bluetooth GPS. Tested with

  • Socket Bluetooth GPS receiver (technically identical to Emtac)
  • Holux GR-230 Bluetooth GPS
  • Anycom GP-600 BC79 Bluetooth GPS
  • TomTom Wireless GPS
  • Belkin Bluetooth GPS Receiver (resembles Fortuna Clip-On)
  • Bluei Wireless GPS Receiver
  • Falcom NAVI-1
  • Pretec BluetoothGPS
  • Pretec BluetoothGPS Mini

Memory requirements

  • RAM 92 kB
  • C-drive (phone's internal Flash memory): 1 kB
  • Installation drive (internal or card): 80 kB

Purchase

Unregistered trial version runs 10 minutes at a time. To register Aspicore GSM Tracker, you have to purchase it. It can be purchased at www.handango.com. During purchase you will be asked for a Symbian Device ID (IMEI). This can be displayed by entering *#06# into the phone keypad in the phone standby mode.

Once this serial number is entered, a registration code will be generated. This can be entered into Aspicore GSM Tracker application by selecting Options -> Registration and pressing the soft key Set Code.

If there are any problems entering the registration code, please send us an e-mail with your devices IMEI code, the registration code and the Reference Number of your Handango purchase.

Aspicore GSM Tracker is now available also at softwaremarket.nokia.com. In this case the registration code will be e-mailed to you in a few days after your purchase.

Contact:

Please use our support forum

www.aspicore.com