NAME¶

gnss-sdr - GNSS Software Defined Receiver.

SYNOPSIS¶

gnss-sdr -c=<path-to-configuration-file> [OPTION]...

DESCRIPTION¶

gnss-sdr is a Global Navigation Satellite Systems Software Defined Receiver written in C++. It implements all the signal processing chain, taking as input raw samples coming from the output of an Analog-to-Digital Converter, and processing them up to the computation of the Position-Velocity-Time solution, including the generation of code and phase measurements.

gnss-sdr is able to work with raw data files or, if there is computational power enough, in real time with suitable radio frequency front-ends. The whole receiver is defined in a single configuration file, and therefore users can define theirs.

There is some flexibility in how flags may be specified. The following examples are equivalent:

OPTIONS¶

gnss-sdr takes the following options:

-c=<path-to-configuration-file> or -config_file=<path-to-configuration-file>

Set the configuration file. This flag is mandatory.

-s=<path-to-raw-signal-file> or -signal_source=<path-to-raw-signal-file>

If defined, path to the file containing the signal samples (overrides the data file specified in the configuration file).

-log_dir=<path-to-directory>

If defined, overrides the default directory where logs are saved.

-doppler_max=<doppler_max>

If defined, maximum Doppler value in the search grid, in Hz (overrides the configuration file).

-doppler_step=<doppler_step>

If defined, sets the frequency step in the search grid, in Hz (overrides the configuration file).

-cn0_samples=<samples>

Number of correlators outputs (one per integration time) used for CN0 estimation. It defaults to 20 outputs.

-cn0_min=<cn0_min>

Minimum valid CN0 (in dB-Hz). It defaults to 25 dB-Hz. If set, it overrides the configuration file.

-max_lock_fail=<max_lock_fail>

Maximum number of lock failures before dropping a satellite. It defaults to 50 failures. If set, it overrides the configuration file.

-carrier_lock_th=<carrier_lock_th>

Carrier lock error threshold (in rad). It defaults to 0.85 rad (48.7 degrees). If set, it overrides the configuration file.

-dll_bw_hz=<dll_bw_hz>

If defined, bandwidth of the DLL low pass filter, in Hz (overrides the configuration file).

-pll_bw_hz=<pll_bw_hz>

If defined, bandwidth of the PLL low pass filter, in Hz (overrides the configuration file).

-RINEX_version=<version>

If defined, specifies the RINEX version (2.11 or 3.02). Default: "3.02". Overrides the configuration file.

-version

Print program version and exit.

-help

Print all the available commandline flags and exit.

SEE ALSO¶

volk_gnsssdr_profile(1)

Examples of configuration files available at: ${prefix}/share/gnss-sdr/conf, where ${prefix} uses to be /usr or /usr/local.

Check https://gnss-sdr.org for more information.

BUGS¶

Please report bugs at https://github.com/gnss-sdr/gnss-sdr/issues

AUTHOR¶

Carles Fernandez-Prades (carles.fernandez@cttc.es)

This software package has been developed at CTTC (Centre Tecnologic de Telecomunicacions de Catalunya, https://www.cttc.cat) with contributions from around the world.