2015-02-17 01:34:14 +00:00
.\" Manpage for gnss\-sdr.
2020-02-08 00:20:02 +00:00
.\" SPDX-License-Identifier: GPL-3.0-or-later
.\" SPDX-FileCopyrightText: Carles Fernandez-Prades <carles.fernandez(at)cttc.es>
2014-11-14 14:01:57 +00:00
.\" Contact carles.fernandez@cttc.es to correct errors or typos.
2024-01-23 13:49:19 +00:00
.TH gnss\-sdr 1 "23 Jan 2024" "0.0.19" "gnss\-sdr man page"
2014-11-14 14:01:57 +00:00
.SH NAME
2015-02-17 01:34:14 +00:00
\fBgnss\-sdr\fR \- GNSS Software Defined Receiver.
2014-11-14 14:01:57 +00:00
.SH SYNOPSIS
2018-02-24 18:34:46 +00:00
\fBgnss\-sdr \-c=\fR\fI<path\-to\-configuration\-file>\fR [OPTION]...
2014-11-14 14:01:57 +00:00
.SH DESCRIPTION
2018-05-09 18:20:57 +00:00
\fBgnss\-sdr\fR 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.
2014-11-15 19:40:58 +00:00
\.TP
2015-02-17 01:34:14 +00:00
\fBgnss\-sdr\fR 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.
2018-02-25 21:10:07 +00:00
\.TP
There is some flexibility in how flags may be specified. The following examples are equivalent:
\.RS 8
\.TP
gnss\-sdr \-c=/home/user/rx.conf
\.TP
gnss\-sdr \-\-c=/home/user/rx.conf
\.TP
gnss\-sdr \-c /home/user/rx.conf
\.TP
gnss\-sdr \-\-c /home/user/rx.conf
\.RE
2014-11-14 14:01:57 +00:00
.SH OPTIONS
2015-02-17 01:34:14 +00:00
\fBgnss\-sdr\fR takes the following options:
2014-11-14 14:01:57 +00:00
.TP
2018-02-24 18:34:46 +00:00
\fB\-c=\fR\fI<path\-to\-configuration\-file>\fR or \fB\-config_file=\fR\fI<path\-to\-configuration\-file>\fR
2018-02-25 21:10:07 +00:00
Set the configuration file. This flag is mandatory.
2018-05-09 18:20:57 +00:00
.TP
\fB\-s=\fR\fI<path\-to\-raw\-signal\-file>\fR or \fB\-signal_source=\fR\fI<path\-to\-raw\-signal\-file>\fR
2018-02-24 18:34:46 +00:00
If defined, path to the file containing the signal samples (overrides the data file specified in the configuration file).
2018-05-09 18:20:57 +00:00
.TP
2018-02-24 18:34:46 +00:00
\fB\-log_dir=\fR\fI<path\-to\-directory>\fR
If defined, overrides the default directory where logs are saved.
2014-11-14 18:20:33 +00:00
.TP
2018-02-25 00:41:18 +00:00
\fB\-doppler_max=\fR\fI<doppler_max>\fR
2018-02-24 18:34:46 +00:00
If defined, maximum Doppler value in the search grid, in Hz (overrides the configuration file).
2018-02-18 18:47:09 +00:00
.TP
2018-02-25 00:41:18 +00:00
\fB\-doppler_step=\fR\fI<doppler_step>\fR
If defined, sets the frequency step in the search grid, in Hz (overrides the configuration file).
2018-02-18 18:47:09 +00:00
.TP
2018-02-25 00:41:18 +00:00
\fB\-cn0_samples=\fR\fI<samples>\fR
Number of correlators outputs (one per integration time) used for CN0 estimation. It defaults to 20 outputs.
2018-02-18 18:47:09 +00:00
.TP
2018-02-25 00:41:18 +00:00
\fB\-cn0_min=\fR\fI<cn0_min>\fR
2018-05-09 18:20:57 +00:00
Minimum valid CN0 (in dB-Hz). It defaults to 25 dB-Hz. If set, it overrides the configuration file.
2018-02-18 18:47:09 +00:00
.TP
2018-02-25 00:41:18 +00:00
\fB\-max_lock_fail=\fR\fI<max_lock_fail>\fR
2018-05-09 18:20:57 +00:00
Maximum number of lock failures before dropping a satellite. It defaults to 50 failures. If set, it overrides the configuration file.
2018-02-18 18:47:09 +00:00
.TP
2018-02-25 00:41:18 +00:00
\fB\-carrier_lock_th=\fR\fI<carrier_lock_th>\fR
2018-05-09 18:20:57 +00:00
Carrier lock error threshold (in rad). It defaults to 0.85 rad (48.7 degrees). If set, it overrides the configuration file.
2018-02-25 00:41:18 +00:00
.TP
\fB\-dll_bw_hz=\fR\fI<dll_bw_hz>\fR
2018-02-24 18:34:46 +00:00
If defined, bandwidth of the DLL low pass filter, in Hz (overrides the configuration file).
2018-02-18 18:47:09 +00:00
.TP
2018-02-25 00:41:18 +00:00
\fB\-pll_bw_hz=\fR\fI<pll_bw_hz>\fR
2018-02-24 18:34:46 +00:00
If defined, bandwidth of the PLL low pass filter, in Hz (overrides the configuration file).
2018-02-18 18:47:09 +00:00
.TP
2018-02-24 18:34:46 +00:00
\fB\-RINEX_version=\fI<version>\fR
2018-02-25 00:41:18 +00:00
If defined, specifies the RINEX version (2.11 or 3.02). Default: "3.02". Overrides the configuration file.
2014-11-14 18:20:33 +00:00
.TP
2018-02-24 18:34:46 +00:00
\fB\-version\fR
Print program version and exit.
2014-11-14 18:20:33 +00:00
.TP
2018-02-24 18:34:46 +00:00
\fB\-help\fR
Print all the available commandline flags and exit.
2014-11-14 14:01:57 +00:00
.SH SEE ALSO
2014-11-15 19:40:58 +00:00
.BR volk_gnsssdr_profile (1)
\.TP
2015-02-17 01:34:14 +00:00
Examples of configuration files available at: ${prefix}/share/gnss\-sdr/conf, where ${prefix} uses to be /usr or /usr/local.
2014-11-15 19:40:58 +00:00
\.TP
2018-05-09 18:20:57 +00:00
Check https://gnss\-sdr.org for more information.
2014-11-14 14:01:57 +00:00
.SH BUGS
2015-09-01 22:38:46 +00:00
Please report bugs at https://github.com/gnss-sdr/gnss-sdr/issues
2014-11-14 14:01:57 +00:00
.SH AUTHOR
2015-02-17 01:34:14 +00:00
Carles Fernandez\-Prades (carles.fernandez@cttc.es)
2014-11-15 19:40:58 +00:00
\.TP
2022-04-14 17:33:02 +00:00
This software package has been developed at CTTC (Centre Tecnologic de Telecomunicacions de Catalunya, https://www.cttc.cat) with contributions from around the world.
