Skip to content

Latest commit

 

History

History
173 lines (118 loc) · 12.6 KB

FAQ.md

File metadata and controls

173 lines (118 loc) · 12.6 KB

Frequently Asked Questions (FAQ)

Want to know more about the data that GPSTest collects? See some common questions below.

What's the purpose of GPSTest?

The purpose of GPSTest is to give application developers and platform implementers an open-source reference application that demonstrates how GNSS works on Android devices. Its goal is to advance the quality and smart use of GNSS technology in mobile devices and mobile apps. It also allows curious users to better understand GPS on their Android device.

More details are in the European Global Navigation Satellite System Agency (GSA)'s publication Understanding GNSS performance on Android using the GPSTest App.

What satellite constellations does GPSTest support?

  • GPS (USA Navstar)
  • GLONASS (Russia)
  • QZSS (Japan)
  • BeiDou/COMPASS (China)
  • Galileo (European Union)
  • Various satellite-based augmentation systems (SBAS):
    • Wide Area Augmentation System (WAAS) (USA)
    • European Geostationary Navigation Overlay Service (EGNOS) (European Union)
    • GPS-aided GEO augmented navigation (GAGAN) (India)
    • Multi-functional Satellite Augmentation System (MSAS) (Japan)
    • System for Differential Corrections and Monitoring (SDCM) (Russia)
    • Satellite Navigation Augmentation System (SNAS) (China)
    • Soluciόn de Aumentaciόn para Caribe, Centro y Sudamérica (SACCSA) (ICAO)

For a list of upcoming satellite launches, see http://gpsworld.com/resources/upcoming-gnss-satellite-launches/.

Real-time satellites status:

If you see one of these satellites in GPSTest without a flag label, open an issue and let us know!

How do I know if my device supports Galileo?

An official list of devices that support Galileo can be found at: https://www.usegalileo.eu

Galileo support has also been confirmed using GPSTest on the following devices:

  • BQ Aquaris X5 Plus (See this post)
  • Huawei Mate 9 (See this post)
  • Samsung Galaxy S8 and S8+ (See this post and official specs which say "Location (GPS, Galileo, Glonass, BeiDou) *Galileo and BeiDou coverage may be limited.")
  • OnePlus 5 (Android 7.1.1 / OxygenOS 4.5.8) (See this post)
  • Huawei P10 (See this post - Android 7.0, firmware version L29C432B171)
  • OnePlus 5T (See this post)

Note that the U.S. FCC currently restricts use of Galileo when in the United States, so even if your device supports Galileo you won't see any Galileo satellites in GPSTest when in the United States.

Does GPSTest support dual-frequency GNSS?

Yes! Look for the "CF" column on the "Status" screen. For more detailed information on GPSTest support see my article "Dual-frequency GNSS on Android devices".

Here's a nice table (Source: Rohde & Schwarz) that shows all of the frequency labels you can see in GPSTest, along with their correponding frequencies:

image

For more information on dual-frequency GNSS in general, see the EU GSA article "Dual-frequency Q&As".

What Android devices does GPSTest run on?

Android 1.5 and up, in its simplest form. More advanced versions with an updated user interface and better maps interface (based on Android Maps API v2) is available on Android 2.2 and up. NMEA logging is available on Android 2.3 and up. GNSS measurements and navigation message logging is available on Android 7.0 and up. Carrier frequencies are available on supported devices Android 8.0 and higher - all devices with GNSS hardware year 2018 and higher should include them.

What are the menu buttons for?

  • Start/Stop - Start/stop the GPS hardware
  • Send Location - After a latitude and longitude has been acquired, you can share this info
  • Inject Time - Injects Time assistance data for GPS into the platform, using information from a Network Time Protocol (NTP) server. Note that some devices don't use an NTP server for time data - if this is your device, you'll see a message saying "Platform does not support injecting time data".
  • Inject XTRA Data - Injects XTRA assistance data for GPS into the platform, using information from a XTRA server. Note that some devices don't use XTRA for assistance data - if this is your device, you'll see a message saying "Platform does not support injecting XTRA data".
  • Clear Aiding Data - Clears all assistance data used for GPS, including NTP and XTRA data (Note: if you select this option to fix broken GPS on your device, for GPS to work again you may need to ‘Inject Time’ and ‘Inject XTRA’ data). Note that some devices don't support clearing assistance data - if this is your device, you'll see a message saying "Platform does not support deleting aiding data".
  • Settings - Set map tile type

What information is shown for each location fix?

  • Latitude and Longitude (in decimal degrees), and Altitude (in meters)
  • Timestamp (Relative to the current time)
  • Speed (meters/sec)
  • Bearing (i.e., Heading) in 0-359 degrees
  • Estimated Horizontal Accuracy (i.e., how accurate the positioning technology thinks the position is)
  • For each satellite observed by the device:
    • Pseudorandom Noise (PRN) code, or satellite ID
    • Signal-to-Noise Ratio (SNR) on Android 6.0 and lower, and carrier-to-noise density (C/N0) on Android 7.0 and up
    • Elevation (in degrees)
    • Azimuth (in degrees)
    • Flags - "E"-flag is shown if the GNSS engine has the ephemeris data for the satellite, the "A"-flag is shown if the GPS engine has almanac data for the satellite, and the "U"-flag is shown if the satellite was used by the GPS engine when calculating the most recent GPS fix

See the Android GpsSatellite documentation for more information on each field shown for each satellite for Android 6.0 and lower, and GnssStatus for Android 7.0 and higher.

What's the difference between SNR and C/N0?

See http://www.insidegnss.com/auto/novdec10-Solutions.pdf for details.

Can I record any information with some type of logging tool using GPSTest?

You can view the data output from GPSTest, including NMEA (Android 2.3 and higher) and pseudorange measurements and navigation messages (Android 7.0 and higher) in log format by using Android Monitor, which is included with Android Studio. Check out our Data Output and Logging page for more info.

What Android 7.0 and higher devices support logging raw pseudorange and navigation messages?

Google is keeping a list on the Raw GNSS Measurements page.

What devices support the various functionality shown in GPSTest?

The below table is compiled from users of GPSTest, based on sending feedback via the "Send feedback" feature. An "x" indicates that the feature is supported for a device, a blank value means the feature is not supported for a device, and a "?" means that support is unknown (no one has submitted data for this feature yet).

Manufacturer Model Android version GNSS HW Year Raw measurements Navigation messages NMEA Inject XTRA Inject time Delete assist
Google Pixel 2 9 / 28 2017 ? ? x   x ?
HTC One M9 7.1.2 / 25 2015 ? ? x ? ? ?
Motorola XT1028 (Moto G 2013) 4.4.4 / 19 N/A N/A N/A x x x x
Samsung SM-A520F (Galaxy A5 2017) 8.0.0 / 26 2015 or older x x x x x  
Samsung SM-G955U (Galaxy S8+) 8.0.0 / 26 2015     x   x  
Samsung SM-G965F (Galaxy S9+) 8.0.0 / 26 2016 ? ? x ? ? ?
Sony G8342 (Xperia XZ1) 8.0.0 / 26 2016 x   x   x ?
Sony H8266 (Xperia XZ2) 8.0.0 / 26 2017 x   x   x x
Wileyfox Spark 7.1.2 / 25 2015 or older     x x x x
Xiaomi MI 3W 6.0.1 / 23 N/A N/A N/A x x ? ?
Xiaomi MI 8 8.1.0 / 27 2018 ? ? x x x x
Xiaomi Redmi 4A 7.1.2 / 25 2015     x   ? ?

Is your device not above, or does it still have some question marks?

By default the "Send feedback" email only contains the support information for features that the user has enabled/tried.

If you want to provide a full record for your device, in the navigation drawer first tap on:

  • Inject xtra
  • Inject time
  • Clear assist (Caution - some devices take a while to recover from this. I'd confirm you can inject the above before trying to clear the data)

...and in Settings, you can check logging for the following features:

  • GNSS measurement data
  • Navigation messages
  • NMEA data

Then tap on "Send feedback", and GPSTest it will capture success/failure for all the above.

Does GPSTest collect any personal information about me?

No. See our Privacy Policy for more details.

I'm getting a weird value for Time-to-First-Fix. What's up?

On Android 4.1 and below, your system clock must be accurate to calculate an accurate Time-To-First-Fix (TTFF) value

When I swipe from the Map tab to another tab, I see a brief black flash. Why is this there?

This is apparently a limitation of the implementation of the Android Maps API v2 on certain devices. On the devices we've seen it on (HTC EVO 4G LTE, Nexus S 4G), it only appears briefly and doesn't interfere with the operation of the app. If this issue prevents you from using GPSTest, please contact us on the support forum.

I'd like to publish my own app based on GPSTest source code. Is this allowed?

The GPSTest source code is licensed under Apache v2.0 so there are no legal restrictions to using the code in other apps. Ideally, if you're missing features in GPSTest that you think would generally be useful, please consider contributing those features to GPSTest rather than launching your own app.

If you do launch your own app, I would ask that you do the following when publishing your own app using source code from GPSTest:

  • Use different theme colors for your app - These can easily be changed via the top three values in colors.xml. Looking at any screenshot of the app, it should be easy to distinguish between the two apps based on color.
  • Use a different name for your app - Something not close to "GPSTest"
  • Use a different logo for your app - Again, something not close to the GPSTest logo
  • If your app collects data from users, clearly explain to users within your app on first startup that the app is collecting data, who you are, and how the data will be used
  • Clearly explain to users that your app is not endorsed by me or GPSTest
  • Clearly explain to users that your app uses source code from GPSTest
  • Let me know when you publish the app, and a link to the app on Google Play or another app store
  • If you're using GPSTest for research, if possible I'd be interested in seeing the results of your research
  • If possible, publish your own code as open-source

My question wasn't answered here. What's the next step?

You can ask questions by: