ExtGPS User Guide
ExtGPS User Guide
ExtGPS
Page 1 (17)
User Guide
Version 1.0
ExtGPS
Contents
1. 2.
Page 2 (17)
DISCLAIMER / TERMS OF SERVICE ........................................................ 3 GENERAL INFORMATION ....................................................................... 4 Introduction ..................................................................................... 4 Working configuration ..................................................................... 4
2.1. 2.2. 3. 4.
BASIC USAGE - SHARING GPS ............................................................... 5 APPLICATION FEATURES ....................................................................... 7 Idle state ......................................................................................... 7 Start and Stop service ...................................................................... 7 Positioning ....................................................................................... 8 Bluetooth connectivity ..................................................................... 9 USB connectivity ............................................................................ 10 Home screen .................................................................................. 11 Bluetooth pairing ........................................................................... 11 Speed-up positioning ..................................................................... 12 Bluetooth communication with PC ................................................. 13 USB communication with PC .......................................................... 15 Close USB debugging tools ............................................................. 16 USB reconnection ........................................................................... 17 Orientation switch during splash screen ........................................ 17 Application close ............................................................................ 17 Exit ................................................................................................ 17
4.1. 4.2. 4.3. 4.4. 4.5. 5. 5.1. 5.2. 5.3. 5.4. 5.5. 5.6. 6. 6.1. 6.2. 6.3. 6.4.
ExtGPS
1. DISCLAIMER / TERMS OF SERVICE
Page 3 (17)
Disclaimer for ExtGPS Application later referred as Software. This material, including, but not limited to, documentation and/or any related computer programs, is protected and copyright controlled by Symarctic Solutions Ltd referred as Company. By installing Software you automatically accept these terms of service. Before Software installation it's assumed by Company that these terms are fully read and understood. Using the Software impacts the phone battery consumption, and with some phone models the increased battery consumption may heat the phone when Software is used continually for longer periods of time. Company is not liable for any such impact of use of the Software. Software shares location data which is get from phones built-in positioning system, accuracy of location is not better than what is provided by phone and location data can be incorrect and inaccuracy. Company is not liable for any direct, indirect, incidental, misuse, mal-functionality, compatibility, special or consequential damages or costs of or inability to use the Software. You may not distribute or sublicense software to any other party without written license agreement with Company. There is no guarantee and no warranty. By using the Software you accept the Software "as is" and understand that the Software may contain errors.
ExtGPS
2. GENERAL INFORMATION
2.1. Introduction
Page 4 (17)
Purpose of this document is to describe the basic usage of ExtGPS application. ExtGPS is an application that allows end users to share their mobiles built-in GPS module via Bluetooth and/or USB connection. Location details received from GPS are shared as NMEA data.
MUST have requirements for the application to work properly on device are: Bluetooth and/or USB connectivity built-in GPS module JAVA runtime supports J2ME MIDP version 2.0 and CLDC-1.1
Application has been primarily tested and developed by using following platforms/devices (the actual device support is not limited to models below): S40 6th Edition (Nokia 2710-c2) S60 3rd Edition FP1 (Nokia 6210 Navigator, E71) S60 3rd Edition FP2 (Nokia E5, N96) S60 5th Edition (Nokia 5800 Express Music) Symbian^3 / Anna update (Nokia N8, E7, E6)
ExtGPS
3. BASIC USAGE - SHARING GPS
Page 5 (17)
Following steps-by-step guide will introduce how to use the application for the first time and how to start GPS sharing.
ExtGPS
Page 6 (17)
ExtGPS
4. APPLICATION FEATURES
Page 7 (17)
All features of ExtGPS are quite simple and easy to use and also the application lifecycle is quite straight-forward. The main user interface is used to show status general service status and also the status details for all sub-systems: GPS, Bluetooth and USB.
ExtGPS
4.3. Positioning
Page 8 (17)
Check that your mobile phone is equipped with built-in GPS and positioning methods are activated. If GPS positioning is not activated, then the position cannot be shared. The screenshot below illustrates the situation when GPS positioning services was disabled from the mobile.
Tip: Check the positioning methods on your device and activate positioning for Integrated GPS.
ExtGPS
4.4. Bluetooth connectivity
Page 9 (17)
ExtGPS will not share data until Bluetooth (or USB) is connected and GPS sharing is activated. Additional Bluetooth activation query is shown right after the GPS sharing has been started if the BT is switched OFF. In general the Bluetooth can be activated from the system settings. Notice! Some mobile phones will show query like below to turn on the Bluetooth and some phones will just skip it.
After Bluetooth has been activated the ExtGPS sets mobiles Bluetooth to discoverable state and yellow icon with text Bluetooth: Discoverable is shown on user interface. After sharing has been started and remote device has been connected successfully, the Bluetooth icon will be green and status text is: Bluetooth: <remote device name>. Bluetooth client can be changed during the runtime without first closing the sharing session. Just disconnect the remote device and use another Bluetooth device. Bluetooth will be changed back into discoverable state if the client connection is lost. If the Bluetooth has been deactivated from device, then interface will show red BT icon with text: Bluetooth: Not available.
ExtGPS
4.5. USB connectivity
Page 10 (17)
ExtGPS will not share data until USB (or BT) is connected and GPS sharing is activated. After sharing has been started, the USB icon will be green and status text is: USB: Connected. If mobile supports USB connectivity then user needs to know the actual port number which is managed by PCs operating system. To get the correct port number, please check your PCs device manager and validate that mobile is recognized properly. Then use your GIS software and select USB communication port for source of NMEA data. Notice! ExtGPS will show red icon with text USB: not connected if USB-cable is not connected/not recognized or it is unsupported in your mobile phone. Check example screenshots below.
ExtGPS
5. TIPS AND TRICKS
5.1. Home screen
Page 11 (17)
Shorten the time to access ExtGPS by inserting the shortcut to home screen. Although it should be noted that home screen is not necessarily supported in all devices.
ExtGPS
5.3. Speed-up positioning
Page 12 (17)
In some mobile phones the initial positioning can take a lot of time. To be able to get position faster first ensure that the mobile has a clear view to the sky. It is also possible to speed-up the positioning by using advanced network positioning mechanisms that mobile supports, an example of these mechanisms are AGPS, 3G network based or Wi-Fi/Network. Notice: if network assisted positioning has been used; it may cause extra costs from network operator side for applications end user. Do not use external Bluetooth GPS positioning while ExtGPS is used to share GPS data.
ExtGPS
5.4. Bluetooth communication with PC
Page 13 (17)
To share positioning data over the Bluetooth quickly, create a trusted Bluetooth pair with the mobile, so that communication starts without security pin code query. To be able to communicate with mobile you need to find the Serial port (SPP) 'Symarctic ExtGPS' COM(xx) and use those details with your GIS software. The correct serial port can be fetched from the device manager of your PC or via Bluetooth settings.
Below is a screenshot where E7 BT service discovery results are shown and Symarctic ExtGPS is found.
ExtGPS
Page 14 (17)
Select Symarctic ExtGPS and click next, after that COM46 is automatically defined to be used for communication.
Then just click next and finish the wizard. Communication via Bluetooth COM port is now ready.
Notice! ExtGPS will recognize Bluetooth client when user connects to service via COM-port. If normal Bluetooth connection is done between devices and ExtGPS service is not used: ExtGPS UI will show Bluetooth in discoverable mode. Now start/connect your positioning software and start use GPS data which is received via Bluetooth link. Below is a screenshot from telnet application.
ExtGPS
5.5. USB communication with PC
Page 15 (17)
To be able to connect mobile phone with PC via USB, it is mandatory that the PC has a suitable device drivers installed for target device (Nokia PC suite). Connect mobile with USB-cable and select PC Suite mode or equivalent selection to create a connection from mobile to PC. NOTICE! S40 USB-connectivity On some S40 devices it seems to be a problem to maintain USB-status permanently. Also there seems to be problems to get status information when USB-cable is removed and also a notification when data writing has failed. If youre using S40 device, make sure you have connected the device via USBcable and that your operating system recognizes the device and when using the ExtGPS via USB, it is highly recommended to close PC Suite/Ovi Suite. Example configuration with Windows Start the GIS application that you like to use and use the connected serial COM port to receive the GPS data. In this example, Nokia 2710 mobile communicates via COM19-port. Below is a screenshot from telnet application that catches data from COM19.
ExtGPS
Page 16 (17)
ExtGPS
6. KNOWN ISSUES
6.1. USB reconnection
Page 17 (17)
If USB-cable is removed while GPS sharing session is active, it will not end the sharing with Bluetooth (if also connected), but sharing via USB-cable will be stopped. If you plug-unplug-plug the USB-cable during the sharing session, ExtGPS will not start sharing data again. To restart share again, session needs to be stopped and started again: in some devices there might be a problem with starting it again. Workaround if USB-cable detection fails; please restart the ExtGPS with USB-cable connected. S40 devices might not update USB status correctly if USB-cable is removed.
6.4. Exit
In some rare situations USB connection may hang the application even if sharing has been stopped and UI is updated to idle state. Then it seems that Exit command doesnt do anything. Workaround for current version is that USB-cable is unplugged.