GSM Tracker Help

This is help for Aspicore GSM Tracker v1.00 - 1.03.

See also Support FAQ (Including installation instructions)

Contents

1) User interface

1.1) Main screen

1.2) Settings view

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. On startup tracking setting is available only in Symbian OS v6.1 phones like Nokia N-Gage. More info in the known issues chapter.

 


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.

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.

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 Symbian OS 7.0

The GSM cell tracking feature of this program relies on the GSM network cell ID information when detecting the current location. Unfortunately the GSM cell tracking feature is not supported by Symbian OS 7.0 phones, because Symbian has not published the required APIs for third-party developers.

You can still use Aspicore GSM Tracker application with a Symbian OS 7.0 phone connected to a GPS device.

The GSM cell tracking feature uses a couple of unofficial APIs, which work fine in Series 60 phones with Symbian OS 6.1 like Nokia 3650 and Nokia N-Gage.

Send current position

If you give command Options -> GPRS data -> Send current position and the GPS is not connected, the program v1.00 closes. The Send current position command works properly when the GPS is connected and in v1.01 and above is otherwise hidden.

Cell tracking with GPS

If you have cell tracking activated, "cell trigger" on and GPS connected, program v1.00 may not send the cell and coordinate information to the database. "GSM Tracker: System error(-9)" appears instead. This is due to a GPRS buffer overflow, because the message size is a little more than 200 bytes. In v1.02 the problem is solved by increased send buffer size.

Memory full error when GPS is out of range

If you have the Store GPS BT name setting on and On startup GPS setting on, and you take your phone out of the Bluetooth range of your GPS device for a long time, the repeated unsuccessful BT connection attempts may cause the application memory getting temporarily full. If this happens, the Symbian OS closes the AcGsmTrckr application and you have to start it again.

In v1.02 the problem is solved by increased send buffer size.

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

Unable to use currently active connection. Establish new connection?
Figure 10. 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 do not reach the server!

To re-establish your positioning data connection, you must end your WAP session, exit the Aspicore GSM Tracker application, wait until the little square disappears around the letter G below the signal strength indicator, and then start Aspicore GSM Tracker again. Now the phone asks you to select access point. When you select Internet instead of WAP, the UDP packets get delivered to the server in a normal way.

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.00. 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 6260, 6600, 6620, 6630, 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

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.

Contact:

Please use our support forum

www.aspicore.com