GNSS-SDR  0.0.19
An Open Source GNSS Software Defined Receiver
glonass_l2_ca_dll_pll_c_aid_tracking_cc.h
Go to the documentation of this file.
1 /*!
2  * \file glonass_l2_ca_dll_pll_c_aid_tracking_cc.h
3  * \brief Implementation of a code DLL + carrier PLL tracking block
4  * \author Damian Miralles, 2018. dmiralles2009(at)gmail.com
5  *
6  *
7  * Code DLL + carrier PLL according to the algorithms described in:
8  * K.Borre, D.M.Akos, N.Bertelsen, P.Rinder, and S.H.Jensen,
9  * A Software-Defined GPS and Galileo Receiver. A Single-Frequency
10  * Approach, Birkha user, 2007
11  *
12  * -----------------------------------------------------------------------------
13  *
14  * GNSS-SDR is a Global Navigation Satellite System software-defined receiver.
15  * This file is part of GNSS-SDR.
16  *
17  * Copyright (C) 2010-2020 (see AUTHORS file for a list of contributors)
18  * SPDX-License-Identifier: GPL-3.0-or-later
19  *
20  * -----------------------------------------------------------------------------
21  */
22 
23 #ifndef GNSS_SDR_GLONASS_L2_CA_DLL_PLL_C_AID_TRACKING_CC_H
24 #define GNSS_SDR_GLONASS_L2_CA_DLL_PLL_C_AID_TRACKING_CC_H
25 
26 #include "cpu_multicorrelator.h"
27 #include "gnss_block_interface.h"
28 #include "gnss_synchro.h"
31 #include <gnuradio/block.h>
32 #include <pmt/pmt.h>
33 #include <volk_gnsssdr/volk_gnsssdr_alloc.h> // for volk_gnsssdr::vector
34 #include <deque>
35 #include <fstream>
36 #include <map>
37 #include <string>
38 
39 /** \addtogroup Tracking
40  * \{ */
41 /** \addtogroup Tracking_gnuradio_blocks
42  * \{ */
43 
44 
46 
47 using glonass_l2_ca_dll_pll_c_aid_tracking_cc_sptr = gnss_shared_ptr<glonass_l2_ca_dll_pll_c_aid_tracking_cc>;
48 
49 glonass_l2_ca_dll_pll_c_aid_tracking_cc_sptr
50 glonass_l2_ca_dll_pll_c_aid_make_tracking_cc(
51  int64_t fs_in, uint32_t vector_length,
52  bool dump,
53  const std::string& dump_filename,
54  float pll_bw_hz,
55  float dll_bw_hz,
56  float pll_bw_narrow_hz,
57  float dll_bw_narrow_hz,
58  int32_t extend_correlation_ms,
59  float early_late_space_chips);
60 
61 
62 /*!
63  * \brief This class implements a DLL + PLL tracking loop block
64  */
66 {
67 public:
69 
70  void set_channel(uint32_t channel);
71  void set_gnss_synchro(Gnss_Synchro* p_gnss_synchro);
72  void start_tracking();
73 
74  int general_work(int noutput_items, gr_vector_int& ninput_items,
75  gr_vector_const_void_star& input_items, gr_vector_void_star& output_items);
76 
77  void forecast(int noutput_items, gr_vector_int& ninput_items_required);
78 
79 private:
80  friend glonass_l2_ca_dll_pll_c_aid_tracking_cc_sptr
81  glonass_l2_ca_dll_pll_c_aid_make_tracking_cc(
82  int64_t fs_in, uint32_t vector_length,
83  bool dump,
84  const std::string& dump_filename,
85  float pll_bw_hz,
86  float dll_bw_hz,
87  float pll_bw_narrow_hz,
88  float dll_bw_narrow_hz,
89  int32_t extend_correlation_ms,
90  float early_late_space_chips);
91 
93  int64_t fs_in, uint32_t vector_length,
94  bool dump,
95  const std::string& dump_filename,
96  float pll_bw_hz,
97  float dll_bw_hz,
98  float pll_bw_narrow_hz,
99  float dll_bw_narrow_hz,
100  int32_t extend_correlation_ms,
101  float early_late_space_chips);
102 
103  void msg_handler_preamble_index(const pmt::pmt_t& msg);
104 
105  void check_carrier_phase_coherent_initialization();
106 
107  int32_t save_matfile() const;
108 
109  volk_gnsssdr::vector<gr_complex> d_ca_code;
110  volk_gnsssdr::vector<float> d_local_code_shift_chips;
111  volk_gnsssdr::vector<gr_complex> d_correlator_outs;
112  volk_gnsssdr::vector<gr_complex> d_Prompt_buffer;
113 
114  Cpu_Multicorrelator multicorrelator_cpu;
115 
116  // PLL and DLL filter library
117  // Tracking_2nd_DLL_filter d_code_loop_filter;
118  Tracking_2nd_DLL_filter d_code_loop_filter;
119  Tracking_FLL_PLL_filter d_carrier_loop_filter;
120 
121  // symbol history to detect bit transition
122  std::deque<gr_complex> d_E_history;
123  std::deque<gr_complex> d_P_history;
124  std::deque<gr_complex> d_L_history;
125 
126  // file dump
127  std::string d_dump_filename;
128  std::ofstream d_dump_file;
129 
130  std::map<std::string, std::string> systemName;
131  std::string sys;
132 
133  Gnss_Synchro* d_acquisition_gnss_synchro;
134 
135  // tracking configuration vars
136  int64_t d_fs_in;
137  double d_glonass_freq_ch;
138  double d_early_late_spc_chips;
139  uint32_t d_vector_length;
140  uint32_t d_channel;
141  int32_t d_n_correlator_taps;
142 
143  // remaining code phase and carrier phase between tracking loops
144  double d_rem_code_phase_samples;
145  double d_rem_code_phase_chips;
146  double d_rem_carrier_phase_rad;
147  int32_t d_rem_code_phase_integer_samples;
148 
149  // acquisition
150  double d_acq_code_phase_samples;
151  double d_acq_carrier_doppler_hz;
152 
153  // tracking vars
154  float d_dll_bw_hz;
155  float d_pll_bw_hz;
156  float d_dll_bw_narrow_hz;
157  float d_pll_bw_narrow_hz;
158  double d_code_freq_chips;
159  double d_code_phase_step_chips;
160  double d_carrier_doppler_hz;
161  double d_carrier_frequency_hz;
162  double d_carrier_frequency_old_hz;
163  double d_carrier_phase_step_rad;
164  double d_acc_carrier_phase_cycles;
165  double d_code_phase_samples;
166  double d_pll_to_dll_assist_secs_Ti;
167  double d_code_error_chips_Ti;
168  double d_code_error_filt_chips_s;
169  double d_code_error_filt_chips_Ti;
170  double d_carr_phase_error_secs_Ti;
171  double d_preamble_timestamp_samples;
172  int32_t d_extend_correlation_ms;
173 
174  // Integration period in samples
175  int32_t d_correlation_length_samples;
176 
177  // processing samples counters
178  uint64_t d_sample_counter;
179  uint64_t d_acq_sample_stamp;
180 
181  // CN0 estimation and lock detector
182  int32_t d_cn0_estimation_counter;
183  double d_carrier_lock_test;
184  double d_CN0_SNV_dB_Hz;
185  double d_carrier_lock_threshold;
186  int32_t d_carrier_lock_fail_counter;
187 
188  bool d_enable_extended_integration;
189  bool d_preamble_synchronized;
190 
191  // control vars
192  bool d_enable_tracking;
193  bool d_pull_in;
194  bool d_acc_carrier_phase_initialized;
195 
196  bool d_dump;
197 };
198 
199 
200 /** \} */
201 /** \} */
202 #endif // GNSS_SDR_GLONASS_L1_CA_DLL_PLL_C_AID_TRACKING_CC_H
High optimized CPU vector multiTAP correlator class.
This class implements a 2nd order DLL filter for code tracking loop.
Class that implements carrier wipe-off and correlators.
This class implements a hybrid FLL and PLL filter for tracking carrier loop.
This is the class that contains the information that is shared by the processing blocks.
Definition: gnss_synchro.h:38
This interface represents a GNSS block.
Interface of a 2nd order DLL filter for code tracking loop.
This class implements a DLL + PLL tracking loop block.
Interface of a hybrid FLL and PLL filter for tracking carrier loop.
Interface of the Gnss_Synchro class.