User Manual Running Source Code

This package have been developed completely in java on Android Studio IDE. This section is your step by step guide running the source code on the Android Studio.

Download and Install the Android Studio

Download the source code from the repository window

Exract the downloaded repository i.e by default GNSSLogger-Master

Open Android Studio Application

Go to file -> Open -> location of your repository -> click on GNSSLogger-Master Android icon

Wait for the Gradle Sync to finish

Go to Build tab on the top panel of Android studio and click Rebuild Project

Connect the desired Smartphone where you want to install the Android Application

Make sure your Smartphone is displayed in the Available device list in the Android Studio window

Once the 'successful build message is displayed', Click on Run tab -> Run App

User Manual Android Application Version v2.1.0.0

This section is your step by step guide for logging different data types available.

About the App

• Supports GNSS data from GPS/GALILEO/ BEIDOU for L1/L5/E1B/E1C/E5A (as supported by the device)
• Log GNSS measurements in the RINEX 3.03 format (Pseudorange, Carrier-Phase, Doppler and Noise level)
• Log RAW GNSS Measurements with Navigation Message and/or NMEA Message
• Logs Accelerometer (m/s2), Gyroscope (rad/s) and Magnetometer (μT) data
• Real-Time Visualization of Code Minus Carrier (CMC) plot

Logging the Sensor Data

• Go to Settings Tab
• Turn on the "Screen Always ON" Switch
• Go to Sensor Tab
• Turn ON the "Log Sensor Data" Switch
• Accelerometer, Gyroospcope and Magnetometer measurements will be logged in ASCII format
• Turn OFF the "Log Sensor Data" Switch to stop logging
• Go to your device storage root directory
• Open "GNSS-IMU Logger" folder
• Open "IMU_Log" folder inside "GNSS-IMU Logger" folder
• Your log file will be located inside this folder in the format devicename_IMU_YearMonthDayHourMinuteSecond
• Convert the Sensor out file (ASCII) to .mif format or .imr format to process with MuSNAT or Inertial Explorer respectively using MATLAB Tool

Logging the RINEX Data

• Go to Settings Tab
• Turn on the "Location" and "Measurement" Switch
• Wait for the Display Message "GNSS Measurement are Available" (displayed when more than 4 satellites are available for logging)
• Go to GNSS Tab and Press "RNX LOG" button to start the logging
• Stop & Send button: Stops logging and shows dialog to send the file via email or other options
• Go to your device storage root directory
• Open "GNSS-IMU Logger" folder
• Open "Rinex_Log" folder inside "GNSS-IMU Logger" folder

Logging the RAW GNSS Measurements

• Go to Settings Tab
• Turn on the "Location" and "Measurement" Switch
• Wait for the Display Message "GNSS Measurement are Available" (displayed when more than 4 satellites are available for logging)
• Go to GNSS Tab and press "RAW LOG" button for logging RAW GNSS Measurements
• Turn ON "Navigation Message" and or "NMEA" Switch to include Navigation message or NMEA message respectively inside the RAW Measurements
• Stop & Send button: Stops logging and shows dialog to send the file via email or other options
• Go to your device storage root directory
• Open "GNSS-IMU Logger" folder
• Open "Raw_Log" folder or "Rinex_Log" folder inside "GNSS-IMU Logger" folder
• Your log file will be located inside the "Raw_Log" folder in the format devicename_Raw_YearMonthDayHourMinuteSecond

Logging the RINEX + Sensor Data

• Go to Settings Tab
• Turn on the Location and Measurement Switch
• Turn on the "Screen Always ON" Switch
• Wait for the Display Message "GNSS Measurement are Available" (displayed when more than 4 satellites are available for logging)
• Go to Sensor Tab
• Turn ON the "Log RNX + Sensor Data" Switch
• Turn OFF the "Log RNX + Sensor Data" Switch to stop logging
• Go to your device storage root directory
• Open "GNSS-IMU Logger" folder
• Open "IMU_Log" folder inside "GNSS-IMU Logger" folder and your IMU log file is located there
• Open "Rinex_Log" folder inside "GNSS-IMU Logger" folder and your Rinex log file is located there
• Convert the Sensor output file (ASCII) to .mif format or .imr format using MATLAB Tool to process with MuSNAT or Inertial Explorer respectively

Code Minus Carrier Plot

• Go to Settings Tab
• Turn on the Location and Measurement Switch
• Turn on the "Screen Always ON" Switch
• Wait for the Display Message "GNSS Measurement are Available" (displayed when more than 4 satellites are available for logging)
• Go to GNSS Tab and Press "RNX LOG" button to start the logging
• Go to the CMC Plot tab for visualization
• "Code Minus Carrier (m)" plot shows a "line" for each satellite without any cycle slip on the current epoch. If a cycle slip occur, it will be indicated by a "sphere" and will reset.
• "Code Minus Carrier Normalized (m)" plot shows a "line" for each satellite without any cycle slip on the current epoch. the cycle slip is indicated by a a gap in the line. All the CMC values are normalized with first CMC values (no-cycle slip) for each individual satellite.

Note : For continuous logging of GNSS data with the Smartphone, we encourage user to have "Force full GNSS measurements" ON from developer options during logging.

Clock Error Plot

• Go to Settings Tab
• Turn on the Location and Measurement Switch
• Turn on the "Screen Always ON" Switch
• Wait for the Display Message "GNSS Measurement are Available" (displayed when more than 4 satellites are available for logging)
• Turn ON the "Log RNX + Sensor Data" Switch
• Go to the CLOCKOFFSET Plot tab for visualization
• "Clock offset" plot shows a an offset between between the GPSTime (from GnssClock Class) used for logging RINEX data and ElapsedRealTime (from SystemClock) used for logging Sensor data.
• The Moving Average offset indicate the normalized value (with first epoch) using dedicated averaging window.