GNSS-SDR  0.0.13
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  * Copyright (C) 2010-2020 (see AUTHORS file for a list of contributors)
15  *
16  * GNSS-SDR is a software defined Global Navigation
17  * Satellite Systems receiver
18  *
19  * This file is part of GNSS-SDR.
20  *
21  * SPDX-License-Identifier: GPL-3.0-or-later
22  *
23  * -----------------------------------------------------------------------------
24  */
25 
26 #ifndef GNSS_SDR_GLONASS_L2_CA_DLL_PLL_C_AID_TRACKING_CC_H
27 #define GNSS_SDR_GLONASS_L2_CA_DLL_PLL_C_AID_TRACKING_CC_H
28 
29 #include "cpu_multicorrelator.h"
30 #include "gnss_synchro.h"
33 #include <gnuradio/block.h>
34 #include <pmt/pmt.h>
35 #include <volk_gnsssdr/volk_gnsssdr_alloc.h> // for volk_gnsssdr::vector
36 #include <deque>
37 #include <fstream>
38 #include <map>
39 #include <string>
40 #if GNURADIO_USES_STD_POINTERS
41 #include <memory>
42 #else
43 #include <boost/shared_ptr.hpp>
44 #endif
45 
47 
48 #if GNURADIO_USES_STD_POINTERS
49 using glonass_l2_ca_dll_pll_c_aid_tracking_cc_sptr = std::shared_ptr<glonass_l2_ca_dll_pll_c_aid_tracking_cc>;
50 #else
51 using glonass_l2_ca_dll_pll_c_aid_tracking_cc_sptr = boost::shared_ptr<glonass_l2_ca_dll_pll_c_aid_tracking_cc>;
52 #endif
53 
54 glonass_l2_ca_dll_pll_c_aid_tracking_cc_sptr
55 glonass_l2_ca_dll_pll_c_aid_make_tracking_cc(
56  int64_t fs_in, uint32_t vector_length,
57  bool dump,
58  const std::string& dump_filename,
59  float pll_bw_hz,
60  float dll_bw_hz,
61  float pll_bw_narrow_hz,
62  float dll_bw_narrow_hz,
63  int32_t extend_correlation_ms,
64  float early_late_space_chips);
65 
66 
67 /*!
68  * \brief This class implements a DLL + PLL tracking loop block
69  */
71 {
72 public:
74 
75  void set_channel(uint32_t channel);
76  void set_gnss_synchro(Gnss_Synchro* p_gnss_synchro);
77  void start_tracking();
78 
79  int general_work(int noutput_items, gr_vector_int& ninput_items,
80  gr_vector_const_void_star& input_items, gr_vector_void_star& output_items);
81 
82  void forecast(int noutput_items, gr_vector_int& ninput_items_required);
83 
84 private:
85  friend glonass_l2_ca_dll_pll_c_aid_tracking_cc_sptr
86  glonass_l2_ca_dll_pll_c_aid_make_tracking_cc(
87  int64_t fs_in, uint32_t vector_length,
88  bool dump,
89  const std::string& dump_filename,
90  float pll_bw_hz,
91  float dll_bw_hz,
92  float pll_bw_narrow_hz,
93  float dll_bw_narrow_hz,
94  int32_t extend_correlation_ms,
95  float early_late_space_chips);
96 
98  int64_t fs_in, uint32_t vector_length,
99  bool dump,
100  const std::string& dump_filename,
101  float pll_bw_hz,
102  float dll_bw_hz,
103  float pll_bw_narrow_hz,
104  float dll_bw_narrow_hz,
105  int32_t extend_correlation_ms,
106  float early_late_space_chips);
107 
108  void msg_handler_preamble_index(const pmt::pmt_t& msg);
109 
110  void check_carrier_phase_coherent_initialization();
111 
112  int32_t save_matfile() const;
113 
114  volk_gnsssdr::vector<gr_complex> d_ca_code;
115  volk_gnsssdr::vector<float> d_local_code_shift_chips;
116  volk_gnsssdr::vector<gr_complex> d_correlator_outs;
117  volk_gnsssdr::vector<gr_complex> d_Prompt_buffer;
118 
119  Cpu_Multicorrelator multicorrelator_cpu;
120 
121  // PLL and DLL filter library
122  // Tracking_2nd_DLL_filter d_code_loop_filter;
123  Tracking_2nd_DLL_filter d_code_loop_filter;
124  Tracking_FLL_PLL_filter d_carrier_loop_filter;
125 
126  // symbol history to detect bit transition
127  std::deque<gr_complex> d_E_history;
128  std::deque<gr_complex> d_P_history;
129  std::deque<gr_complex> d_L_history;
130 
131  // file dump
132  std::string d_dump_filename;
133  std::ofstream d_dump_file;
134 
135  std::map<std::string, std::string> systemName;
136  std::string sys;
137 
138  Gnss_Synchro* d_acquisition_gnss_synchro;
139 
140  // tracking configuration vars
141  int64_t d_fs_in;
142  double d_glonass_freq_ch;
143  double d_early_late_spc_chips;
144  uint32_t d_vector_length;
145  uint32_t d_channel;
146  int32_t d_n_correlator_taps;
147 
148  // remaining code phase and carrier phase between tracking loops
149  double d_rem_code_phase_samples;
150  double d_rem_code_phase_chips;
151  double d_rem_carrier_phase_rad;
152  int32_t d_rem_code_phase_integer_samples;
153 
154  // acquisition
155  double d_acq_code_phase_samples;
156  double d_acq_carrier_doppler_hz;
157 
158  // tracking vars
159  float d_dll_bw_hz;
160  float d_pll_bw_hz;
161  float d_dll_bw_narrow_hz;
162  float d_pll_bw_narrow_hz;
163  double d_code_freq_chips;
164  double d_code_phase_step_chips;
165  double d_carrier_doppler_hz;
166  double d_carrier_frequency_hz;
167  double d_carrier_doppler_old_hz;
168  double d_carrier_phase_step_rad;
169  double d_acc_carrier_phase_cycles;
170  double d_code_phase_samples;
171  double d_pll_to_dll_assist_secs_Ti;
172  double d_code_error_chips_Ti;
173  double d_code_error_filt_chips_s;
174  double d_code_error_filt_chips_Ti;
175  double d_carr_phase_error_secs_Ti;
176  double d_preamble_timestamp_s;
177  int32_t d_extend_correlation_ms;
178 
179  // Integration period in samples
180  int32_t d_correlation_length_samples;
181 
182  // processing samples counters
183  uint64_t d_sample_counter;
184  uint64_t d_acq_sample_stamp;
185 
186  // CN0 estimation and lock detector
187  int32_t d_cn0_estimation_counter;
188  double d_carrier_lock_test;
189  double d_CN0_SNV_dB_Hz;
190  double d_carrier_lock_threshold;
191  int32_t d_carrier_lock_fail_counter;
192 
193  bool d_enable_extended_integration;
194  bool d_preamble_synchronized;
195 
196  // control vars
197  bool d_enable_tracking;
198  bool d_pull_in;
199  bool d_acc_carrier_phase_initialized;
200 
201  bool d_dump;
202 };
203 
204 #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:33
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.