This is help for Aspicore GSM Tracker v3.15. It contains description of
functions specific to that version.
|
|
Settings view
|
|

Figure 1.
Settings view, GPS
|
This chapter explains the meaning of each configuration
settings item.
1 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 to Bluetooth GPS. (Don't worry, it probably is by default.)
If there are no Bluetooth GPS devices on your phone's paired 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 devices list 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 the
connect 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 API has been turned on.
|
|

Figure 3.
Settings view, Net
|
1 Store Access Point
-
On: Do not show the Select access point
dialog, when issuing the Connect 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 the
Connect 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 like nslookup <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 the Optional 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 address,
Optional 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.
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.
12 GpsGate protocol
- On: Use GpsGate Server Protocol with TCP/IP communication as specified by Franson Technology AB.
Send User name and Password in $FRLIN login command.
- Off: Do not use the dedicated Use GpsGate Server Protocol.
Use either UDP/IP or TCP/IP communication. Each packet contains the IMEI code and tracking data as described in the
data format description.
|
|

Figure 7.
Http settings view

Figure 8.
Http settings view
|
1 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.
12 Send cell every time
- On:
The current cell info are sent in every http 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 http transaction.
Regardless of the status of the above item, the rest of the cell info http transmission logic is as follows:
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.
|
|

Figure 11.
Settings view, Trig1
|
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

Figure 14.
Settings view, Trig2

Figure 15.
Settings view, Trig2
|
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.
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.
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 hold
parameter. 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 trigger, Trig on start, Trig 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
|
1 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 / 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.
|
|

Figure 17.
Settings view, File
|
1 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.
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
29) NMEA logging
and
46) Export log file into Google Earth format (KML)
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
|
1 Recipient number
Mobile number, where text messages are sent.
Used e.g. when selecting Options -> Current position -> Send SMS from 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. Cell ID related acronyms are explained in F.A.Q.
28) HTTP data upload querystring parameters
.
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
setting Disable 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
settings Autostart 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
|
1 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 of precision
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.
|
|

Figure 25.
Settings view, Label
|
1 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
|
Password
You 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.
|
First we recommend that you manually try the following commands and check that your setup is working:
Verify, that everything works ok with Aspicore's test server as described under title
See the collected location data above .
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:
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.
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:
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.
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 some valid data with satellites
visible. Data sending is controlled
by the triggers. "GPS / Retry after, min" controls how often the GPS gets waked up.
Known issue in v3.15.
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:
With these settings the battery lasts up to five days (120 hours) without charging (Nokia 6110 Navigator,
GSM Tracker continuously running in the background).
Whenever the handset receives an SMS "?loc", it responds with two SMS messages: first to acknowledge
that the command was received and second SMS, when it gets a valid GPS fix. The first SMS contains
cached GPS coordinates, which may be old, so please pay attention to the timestamp <utctime>.