2011-10-01 18:45:20 +00:00
|
|
|
/*!
|
|
|
|
* \file gnss_block_factory.h
|
2014-04-13 00:51:00 +00:00
|
|
|
* \brief Interface of a factory that returns smart pointers to GNSS blocks.
|
2011-10-01 18:45:20 +00:00
|
|
|
* \author Carlos Aviles, 2010. carlos.avilesr(at)googlemail.com
|
- Major changes:
- The executable file and the default configuration file is now changed from "./install/mercurio" and "./conf/mercurio.conf" to "./install/gnss-sdr" and "./conf/gnss-sdr.conf", respectively.
- Configuration file structure changed to define in a single entry the internal sampling frequency (after the signal conditioner). NOTICE that this change affects the all the adapters (acquisition, tracking, telemetry_decoder, observables, and PVT). All the adapters are now modified to work with this feature.
- Moved several in-line GPS L1 CA parameters (a.k.a magic numbers..) to ./src/core/system_parameters/GPS_L1_CA.h definition file.
- Tracking blocks now uses DOUBLE values in their outputs.
- Observables and PVT now are separated. PVT and their associated libraries are moved to ./src/algorithms/PVT
- Temporarily disabled the RINEX output (I am working on that!)
- GNSS-SDR screen output now gives extended debug information of the receiver status and events. In the future, this output will be redirected to a log file.
- Bug fixes:
- FILE_SIGNAL_SOURCE now works correctly when the user configures GNSS-SDR to process the entire file.
- GPS_L1_CA_DLL_PLL now computes correctly the PRN start values.
- GPS_L1_CA_DLL_FLL_PLL now computes correctly the PRN start values.
- Several modifications in GPS_L1_CA_Telemetry_Decoder, GPS_L1_CA_Observables, and GPS_L1_CA_PVT modules to fix the GPS position computation.
- New features
- Tracking blocks perform a signal integrity check against NaN outliers before the correlation process.
- Tracking and PVT binary dump options are now documented and we provide MATLAB libraries and sample files to read it. Available in ./utils/matlab" and "./utils/matlab/libs"
- Observables output rate can be configured. This option enables the GPS L1 CA PVT computation at a maximum rate of 1ms.
- GPS_L1_CA_PVT now can perform a moving average Latitude, Longitude, and Altitude output for each of the Observables output. It is configurable using the configuration file.
- Added Google Earth compatible Keyhole Markup Language (KML) output writer class (./src/algorithms/PVT/libs/kml_printer.h and ./src/algorithms/PVT/libs/kml_printer.cc ). You can see the receiver position directly using Google Earth.
- We provide a master configuration file which includes an in-line documentation with all the new (and old) options. It can be found in ./conf/master.conf
git-svn-id: https://svn.code.sf.net/p/gnss-sdr/code/trunk@84 64b25241-fba3-4117-9849-534c7e92360d
2011-12-07 17:59:34 +00:00
|
|
|
* Luis Esteve, 2011. luis(at)epsilon-formacion.com
|
|
|
|
* Javier Arribas, 2011. jarribas(at)cttc.es
|
2020-06-18 09:49:28 +00:00
|
|
|
* Carles Fernandez-Prades, 2014-2020. cfernandez(at)cttc.es
|
2011-10-01 18:45:20 +00:00
|
|
|
*
|
|
|
|
* This class encapsulates the complexity behind the instantiation
|
|
|
|
* of GNSS blocks.
|
|
|
|
*
|
|
|
|
*
|
2020-06-18 09:49:28 +00:00
|
|
|
* -----------------------------------------------------------------------------
|
|
|
|
*
|
2020-12-30 12:35:06 +00:00
|
|
|
* GNSS-SDR is a Global Navigation Satellite System software-defined receiver.
|
2011-10-01 18:45:20 +00:00
|
|
|
* This file is part of GNSS-SDR.
|
|
|
|
*
|
2020-12-30 12:35:06 +00:00
|
|
|
* Copyright (C) 2010-2020 (see AUTHORS file for a list of contributors)
|
2020-02-08 00:20:02 +00:00
|
|
|
* SPDX-License-Identifier: GPL-3.0-or-later
|
2011-10-01 18:45:20 +00:00
|
|
|
*
|
2020-06-18 09:49:28 +00:00
|
|
|
* -----------------------------------------------------------------------------
|
2011-10-01 18:45:20 +00:00
|
|
|
*/
|
|
|
|
|
2020-02-08 09:10:46 +00:00
|
|
|
#ifndef GNSS_SDR_BLOCK_FACTORY_H
|
|
|
|
#define GNSS_SDR_BLOCK_FACTORY_H
|
2011-10-01 18:45:20 +00:00
|
|
|
|
2019-07-16 15:41:12 +00:00
|
|
|
#include "concurrent_queue.h"
|
|
|
|
#include <pmt/pmt.h>
|
2020-06-18 09:49:28 +00:00
|
|
|
#include <memory> // for unique_ptr
|
2019-07-16 15:41:12 +00:00
|
|
|
#include <string> // for string
|
|
|
|
#include <vector> // for vector
|
2018-02-26 02:15:53 +00:00
|
|
|
|
2020-11-01 12:37:19 +00:00
|
|
|
/** \addtogroup Core
|
|
|
|
* \{ */
|
|
|
|
/** \addtogroup Core_Receiver
|
|
|
|
* \{ */
|
|
|
|
|
2011-10-01 18:45:20 +00:00
|
|
|
|
|
|
|
class ConfigurationInterface;
|
|
|
|
class GNSSBlockInterface;
|
2021-02-09 22:47:34 +00:00
|
|
|
class SignalSourceInterface;
|
2014-04-11 18:18:59 +00:00
|
|
|
class AcquisitionInterface;
|
|
|
|
class TrackingInterface;
|
|
|
|
class TelemetryDecoderInterface;
|
2011-10-01 18:45:20 +00:00
|
|
|
|
2013-01-28 23:50:09 +00:00
|
|
|
/*!
|
|
|
|
* \brief Class that produces all kinds of GNSS blocks
|
|
|
|
*/
|
2011-10-01 18:45:20 +00:00
|
|
|
class GNSSBlockFactory
|
|
|
|
{
|
|
|
|
public:
|
2019-07-21 17:32:52 +00:00
|
|
|
GNSSBlockFactory() = default;
|
|
|
|
~GNSSBlockFactory() = default;
|
2019-04-27 11:35:50 +00:00
|
|
|
|
2021-02-09 22:47:34 +00:00
|
|
|
std::unique_ptr<SignalSourceInterface> GetSignalSource(const ConfigurationInterface* configuration,
|
2020-07-12 21:08:58 +00:00
|
|
|
Concurrent_Queue<pmt::pmt_t>* queue, int ID = -1);
|
2014-04-23 23:53:55 +00:00
|
|
|
|
2020-06-29 07:07:41 +00:00
|
|
|
std::unique_ptr<GNSSBlockInterface> GetSignalConditioner(const ConfigurationInterface* configuration, int ID = -1);
|
2014-04-23 23:53:55 +00:00
|
|
|
|
2020-06-29 07:07:41 +00:00
|
|
|
std::unique_ptr<std::vector<std::unique_ptr<GNSSBlockInterface>>> GetChannels(const ConfigurationInterface* configuration,
|
2020-07-12 21:08:58 +00:00
|
|
|
Concurrent_Queue<pmt::pmt_t>* queue);
|
2014-04-23 23:53:55 +00:00
|
|
|
|
2020-06-29 07:07:41 +00:00
|
|
|
std::unique_ptr<GNSSBlockInterface> GetObservables(const ConfigurationInterface* configuration);
|
2014-04-23 23:53:55 +00:00
|
|
|
|
2020-06-29 07:07:41 +00:00
|
|
|
std::unique_ptr<GNSSBlockInterface> GetPVT(const ConfigurationInterface* configuration);
|
2015-05-10 10:35:49 +00:00
|
|
|
|
2019-04-27 11:35:50 +00:00
|
|
|
/*!
|
2020-07-28 14:57:15 +00:00
|
|
|
* \brief Returns the block with the required role implementation and its configuration parameters
|
2015-05-10 10:35:49 +00:00
|
|
|
*/
|
2020-06-29 07:07:41 +00:00
|
|
|
std::unique_ptr<GNSSBlockInterface> GetBlock(const ConfigurationInterface* configuration,
|
2020-07-13 13:17:15 +00:00
|
|
|
const std::string& role,
|
|
|
|
unsigned int in_streams,
|
|
|
|
unsigned int out_streams,
|
2020-07-12 21:08:58 +00:00
|
|
|
Concurrent_Queue<pmt::pmt_t>* queue = nullptr);
|
2015-05-10 10:35:49 +00:00
|
|
|
|
|
|
|
private:
|
2020-07-12 21:08:58 +00:00
|
|
|
std::unique_ptr<GNSSBlockInterface> GetChannel(
|
|
|
|
const ConfigurationInterface* configuration,
|
|
|
|
const std::string& signal,
|
|
|
|
int channel,
|
2020-06-18 09:49:28 +00:00
|
|
|
Concurrent_Queue<pmt::pmt_t>* queue);
|
2019-01-25 21:43:00 +00:00
|
|
|
|
2014-04-11 18:18:59 +00:00
|
|
|
std::unique_ptr<AcquisitionInterface> GetAcqBlock(
|
2020-06-29 07:07:41 +00:00
|
|
|
const ConfigurationInterface* configuration,
|
2019-02-05 00:31:09 +00:00
|
|
|
const std::string& role,
|
2020-07-12 21:08:58 +00:00
|
|
|
unsigned int in_streams,
|
2018-03-03 01:03:39 +00:00
|
|
|
unsigned int out_streams);
|
2014-04-23 23:53:55 +00:00
|
|
|
|
2014-04-11 18:18:59 +00:00
|
|
|
std::unique_ptr<TrackingInterface> GetTrkBlock(
|
2020-06-29 07:07:41 +00:00
|
|
|
const ConfigurationInterface* configuration,
|
2019-02-05 00:31:09 +00:00
|
|
|
const std::string& role,
|
2020-07-12 21:08:58 +00:00
|
|
|
unsigned int in_streams,
|
2018-03-03 01:03:39 +00:00
|
|
|
unsigned int out_streams);
|
2014-04-23 23:53:55 +00:00
|
|
|
|
2014-04-11 18:18:59 +00:00
|
|
|
std::unique_ptr<TelemetryDecoderInterface> GetTlmBlock(
|
2020-06-29 07:07:41 +00:00
|
|
|
const ConfigurationInterface* configuration,
|
2019-02-05 00:31:09 +00:00
|
|
|
const std::string& role,
|
2020-07-12 21:08:58 +00:00
|
|
|
unsigned int in_streams,
|
2018-03-03 01:03:39 +00:00
|
|
|
unsigned int out_streams);
|
2011-10-01 18:45:20 +00:00
|
|
|
};
|
|
|
|
|
2020-11-01 12:37:19 +00:00
|
|
|
|
|
|
|
/** \} */
|
|
|
|
/** \} */
|
2020-02-08 09:10:46 +00:00
|
|
|
#endif // GNSS_SDR_BLOCK_FACTORY_H
|