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