# RtkGps

**Repository Path**: arhee/RtkGps

## Basic Information

- **Project Name**: RtkGps
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2024-12-11
- **Last Updated**: 2025-11-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

RtkGps+
=======

RTKLIB rtknavi port on android.


### Features

#### [rtklib][rtklib] features:

* Version pre 2.4.3b29d
* GPS, GLONASS, Galileo, QZSS, BeiDou and SBAS Navigation systems
* Single, DGPS/DGNSS, Kinematic, Static, Moving-Baseline, Fixed,
  PPP-Kinematic, PPP-Static and PPP-Fixed positioning modes.
* RTK and PPP integer ambiguities resolution (PPP AR is experimental)
* GNSS formats: 
  RINEX 2.10,2.11,2.12 OBS/NAV/GNAV/HNAV/LNAV/QNAV, RINEX 3.00,3.01,3.02
    OBS/NAV,RINEX 3.02 CLK,RTCM ver.2.3,RTCM ver.3.1 (with amendment 1-5),
    RTCM ver.3.2, BINEX, NTRIP 1.0, NMEA 0183, SP3-c, ANTEX 1.4, IONEX 1.0,
    NGS PCV and EMS 2.0.
* Proprietary protocotols: 
  NovAtel: OEM4/V/6,OEM3,OEMStar,Superstar II, Hemisphere: Eclipse,Crescent,
    u-blox: LEA-4T/5T/6T, SkyTraq: S1315F, JAVAD GRIL/GREIS, Furuno
    GW-10-II/III, NVS NV08C BINR, SiRF III/IV, and Trimble RT17.
* TCP/IP, NTRIP, local log file
* Support for multiple geoids (see explanation)

#### Android features:

* Test mode for obtaining positions from internal GPS (without any RTKLIB function)
* Bluetooth communication
* Support for internal Trimble / Spectra Precision MobileMapper 50 internal receiver (U-Blox M8N) 
* USB OTG communication with speed/parity/stop configuration (ACM, PL2303 chips and alpha for FTDI chips)
* SiRF IV protocol (experimental)
* Show altitude in status view if Height/Geodetic is choosen
* Send mock location to other applications if the checkbox is ticked in the solution option screen. (Not working yet with apps using Google Maps api)
* Upload Log/Solution to Dropbox if Sync to Dropbox is ticked in the FileSettings screen. (the sync occurs after the stop of the server)
* Ability to zip files before uploading to Dropbox for reducing the data volume.
* Generate a GPX track (Output view/GPX Track tab)
* Show UTM coordinates in solution view
* Support for french Geoportail maps (cadastral parcels, roads and satellite) - needs api license key see src/gpsplus/rtkgps/geoportail/License.java.sample 

#### Proj4
* Due to multiple issues (error in projection and lacks of features) Proj4J was removed and C lib proj4 was added
* All conversion are done with proj4 5.1.0
* French projections are done with IGN certified method, Lambert II extended is computed with IGN certified grid ntf_r93.gsb
* One custom proj4 specification string can be specified (take care of exact syntax).  
* all standard proj4 formats and grids are included, all grids from http://download.osgeo.org/proj/proj-datumgrid-1.7.zip are also included. In other words you have access to this external files: alaska, chenyx06etrs.gsb, conus, epsg,esri, esri.extra, FL, GL27, hawaii, IGNF, MD, nad27, nad83, ntf_r93.gsb, ntv1_can.dat, null, nzgd2kgrid0005.gsb, other.extra, proj_def.dat, prvi, stgeorge, strlnc, stpaul, TN, WI, WO, world, BETA2007.gsb, egm96_15.gtx
* If you need another specific "free" or freely distributable grid or definition file, do not hesitate to drop me an email.

#### Geoids
* you can select different geoid model in "Solution Option"/Geoid model but except for embedded model (EGM96 1°x1°)  
     
  After receiving some emails for asking me how to install the geoid model, I added a new menu "Tools" in this menu you can automatically download and install
  some geoid models. Take attention to the size! I think you may prefer to download this models via a Wifi connection rather than with your data plan!  
    

  you will need to place the corresponding model in the RtkGps storage (probably /storage/sdcard0/RtkGps)  
  the model format is RTKLIB dependent, check jni/RTKLIB/src/geoid.c  
  the model file MUST be one of:  
  ```
    EGM96_M150.geoid  
    EGM2008_M25.geoid  
    EGM2008_M10.geoid  
    GSI2000_M15.geoid
    RAF09_M15x20.geoid  
  ```
  
  for example if you want to use EGM2008 2.5'x2.5' model you need:
  ```
    1.  download from National Geospatial Intelligence Agency the model  
  			  on august 2014 file can be found http://earth-info.nga.mil/GandG/wgs84/gravitymod/egm2008/Small_Endian/Und_min2.5x2.5_egm2008_isw=82_WGS84_TideFree_SE.gz   
    2.  extract the Und_min2.5x2.5_egm2008_isw=82_WGS84_TideFree_SE file and rename it EGM2008_M25.geoid (149Mo)   
    3.  place this model in RtkGps storage path (where all the trace and log go), on my tools it is /storage/sdcard0/RtkGps/
  ```

  for example if you want to use IGN RAF09 1.5'x2.5' model you need:
  ```
    1.  download from IGN wich is the french national geographical institute the model  
  			  on august 2014 file can be found http://geodesie.ign.fr/contenu/fichiers/documentation/grilles/metropole/RAF09.mnt   
    2.  rename it RAF09_M15x20.geoid    
    3.  place this model in RtkGps storage path (where all the trace and log go), on my tools it is /storage/sdcard0/RtkGps/
  ```
   
  if you do not have the correct model or if model is inconsistent it will not show an error, rather than it will use the EGM96 1°x1° embedded model or it use ellipsoidal height.
  				
#### Precise ephemeris
If you need precise ephemeris you have 2 ways for using them:  
* Manualy: In the correction tab you select "File" and type SP3 , in the filename you put the filename of the file you provide in RtkGps directory (ending with .SP3)  
* Automatically: When the server is running, hit the "Tools" menu, here you have an option to download and inject automatically the latest ultra-rapid ephemeris from IGS or simply inject them if you already have the good file.  
  
#### NTRIP Caster  
This is highly experimental, but I embedded NTRIP Caster 0.1.5. It works but I'm not satisfied of the implementation. Because it cannot shutdown cleanly.  
Why?  
* 1- because closing connections does not work at 100% (even in original soft), so thread do not end at 100%  
* 2- because by conception of the original Caster the end is not clean, it waits for Control-C for ending and ends with exit(1)!!!    
* 3- because Android lacks some pthread functions (ie: real pthread_cancel...)  

So I locked the ability to stop the NTRIP Caster without closing RTKGPS+.  
But if you want to test it works, on the first launch 2 files are created in RtkGps/ntripcaster/  ,you can edit them, But as is it works and can provide 3 streams:  
```
/GNSS0
/GNSS1
/GNSS2
(all three sources have rtkgps as password)
```
for using with the log streams you need to set them:  
```
server: 127.0.0.1
mountpoint: GNSSx
password: rtkgps (please change it)  
```
On your wifi network you can use your stream on:
```
ntrip://username:password@ip_shown_in_caster_options:2101/GNSSx
(please change the login and the password) 
```
#### Building on Windows
Android is Unix so it is easier to build under an Unix system. Personnaly I use MacOSX but it can be done under Windows (tested under 8.1 x86_64).  
You need a correctly installed ndk (under windows I use ndk-r9d), a correctly Installed ADT (I use x86_64-20140702).  
Also you will need a working Cygwin installation with make, gcc-core gcc-c++ bash at least.  
Define ANDOID_NDK and ANDROID_SDK variable to their correct paths, also add ANDROID_NDK path in PATH
```  
copy RtkGps\jni\simonlynen_android_libs\lapack\jni\clapack\INCLUDE\*.h to:  
 RtkGps\jni\simonlynen_android_libs\lapack\jni\clapack\SRC  
 RtkGps\jni\simonlynen_android_libs\lapack\jni\clapack\INSTALL  
 RtkGps\jni\simonlynen_android_libs\lapack\jni\clapack\BLAS\SRC  
```   
This is a workaround for the symlinks.  
You also need to deactivate the use of lapack since it cannot be build under windows.  
For that please modify RtkGps/jni/rtklib.mk and Android.mk for removing LAPACK flag and clapck module import (with performance issues).  
now under a cygwin terminal move to your RtkGps directory and build with ```ndk-build``` command.  
Under Eclipse be sure that you do not set to build the native library since it fails.  
  
#### Translations
Contributors are welcomed for translating RTKGPS+, the translation can be easily managed on [Crowdin](https://crowdin.com/project/gpsplusrtkgps).   
You can freely create a translator account and with it you will be able request for a new translation.  
Today target languages are English, French, Spanish, Polish, German and Russian  
Current translation to this target languages [![Crowdin](https://d322cqt584bo4o.cloudfront.net/gpsplusrtkgps/localized.png)](https://crowdin.com/project/gpsplusrtkgps)  
[If you want this in your native language or if you want to contribute to one of the current translation, you are welcome.](https://crowdin.com/project/gpsplusrtkgps/invite)  
I already made this translations:
* English (source language)
* French  
* Chinese (fully translated by Yong Zhang)
* Spanish (I and Enoc Sanz Ablanedo)
* Polish (fully translated by Tomasz Robak)
* German (translated by Hagen Felix)


### Requirements

* android > 4.0
* Bluetooth or USB OTG GPS receiver supported by rtklib
* Allow mock locations in your device developer settings (optional but required for sending mock locations)
* A Dropbox account for uploading log/solution. (you will be asked for authorizing this app by Dropbox)

###### Download original version from Alexey Illarionov.
[original version](https://github.com/illarionov/RtkGps)

### Download alpha version (1.0apha23) from Google Play.

![qr](https://raw.githubusercontent.com/eltorio/RtkGps/master/qr_googleplay.png)

[Google play](https://play.google.com/store/apps/details?id=gpsplus.rtkgps)


[rtklib]: http://www.rtklib.com/

###### Binary distribution

* the latest apk with Mobile Mapper 50 and proj4 5.1.0 wich is maybe very instable can be found in bin directory, but prefer the Google Play version

###### Beta distribution

* the build 18 / 08 / 2018 (1.0alpha26) has been deployed as "BETA" on Google Play Store it is an open beta… If you want try it, but don't blame if it does not work.
Ronan