GNSS-SDR  0.0.13
An Open Source GNSS Software Defined Receiver
serdes_gnss_synchro.h
Go to the documentation of this file.
1 /*!
2  * \file serdes_gnss_synchro.h
3  * \brief Serialization / Deserialization of Gnss_Synchro objects using
4  * Protocol Buffers
5  * \author Carles Fernandez-Prades, 2019. cfernandez(at)cttc.es
6  *
7  * -----------------------------------------------------------------------------
8  *
9  * Copyright (C) 2010-2020 (see AUTHORS file for a list of contributors)
10  *
11  * GNSS-SDR is a software defined Global Navigation
12  * Satellite Systems receiver
13  *
14  * This file is part of GNSS-SDR.
15  *
16  * SPDX-License-Identifier: GPL-3.0-or-later
17  *
18  * -----------------------------------------------------------------------------
19  */
20 
21 #ifndef GNSS_SDR_SERDES_GNSS_SYNCHRO_H
22 #define GNSS_SDR_SERDES_GNSS_SYNCHRO_H
23 
24 #include "gnss_synchro.h"
25 #include "gnss_synchro.pb.h" // file created by Protocol Buffers at compile time
26 #include <array>
27 #include <string>
28 #include <utility>
29 #include <vector>
30 
31 /*!
32  * \brief This class implements serialization and deserialization of
33  * Gnss_Synchro objects using Protocol Buffers.
34  */
36 {
37 public:
39  {
40  // Verify that the version of the library that we linked against is
41  // compatible with the version of the headers we compiled against.
42  GOOGLE_PROTOBUF_VERIFY_VERSION;
43  }
44 
46  {
47  google::protobuf::ShutdownProtobufLibrary();
48  }
49 
50  inline Serdes_Gnss_Synchro(const Serdes_Gnss_Synchro& other) noexcept //!< Copy constructor
51  {
52  this->observables = other.observables;
53  }
54 
55  inline Serdes_Gnss_Synchro& operator=(const Serdes_Gnss_Synchro& rhs) noexcept //!< Copy assignment operator
56  {
57  this->observables = rhs.observables;
58  return *this;
59  }
60 
61  inline Serdes_Gnss_Synchro(Serdes_Gnss_Synchro&& other) noexcept //!< Move constructor
62  {
63  this->observables = std::move(other.observables);
64  }
65 
66  inline Serdes_Gnss_Synchro& operator=(Serdes_Gnss_Synchro&& other) noexcept //!< Move assignment operator
67  {
68  if (this != &other)
69  {
70  this->observables = std::move(other.observables);
71  }
72  return *this;
73  }
74 
75  inline std::string createProtobuffer(const std::vector<Gnss_Synchro>& vgs) //!< Serialization into a string
76  {
77  observables.Clear();
78  std::string data;
79  for (auto gs : vgs)
80  {
81  gnss_sdr::GnssSynchro* obs = observables.add_observable();
82  char c = gs.System;
83  const std::string sys(1, c);
84 
85  std::array<char, 2> cc;
86  cc[0] = gs.Signal[0];
87  cc[1] = gs.Signal[1];
88  const std::string sig(cc.cbegin(), cc.cend());
89 
90  obs->set_system(sys);
91  obs->set_signal(sig);
92  obs->set_prn(gs.PRN);
93  obs->set_channel_id(gs.Channel_ID);
94 
95  obs->set_acq_delay_samples(gs.Acq_delay_samples);
96  obs->set_acq_doppler_hz(gs.Acq_doppler_hz);
97  obs->set_acq_samplestamp_samples(gs.Acq_samplestamp_samples);
98  obs->set_acq_doppler_step(gs.Acq_doppler_step);
99  obs->set_flag_valid_acquisition(gs.Flag_valid_acquisition);
100 
101  obs->set_fs(gs.fs);
102  obs->set_prompt_i(gs.Prompt_I);
103  obs->set_prompt_q(gs.Prompt_Q);
104  obs->set_cn0_db_hz(gs.CN0_dB_hz);
105  obs->set_carrier_doppler_hz(gs.Carrier_Doppler_hz);
106  obs->set_code_phase_samples(gs.Code_phase_samples);
107  obs->set_tracking_sample_counter(gs.Tracking_sample_counter);
108  obs->set_flag_valid_symbol_output(gs.Flag_valid_symbol_output);
109  obs->set_correlation_length_ms(gs.correlation_length_ms);
110 
111  obs->set_flag_valid_word(gs.Flag_valid_word);
112  obs->set_tow_at_current_symbol_ms(gs.TOW_at_current_symbol_ms);
113 
114  obs->set_pseudorange_m(gs.Pseudorange_m);
115  obs->set_rx_time(gs.RX_time);
116  obs->set_flag_valid_pseudorange(gs.Flag_valid_pseudorange);
117  obs->set_interp_tow_ms(gs.interp_TOW_ms);
118  }
119  observables.SerializeToString(&data);
120  return data;
121  }
122 
123  inline std::vector<Gnss_Synchro> readProtobuffer(const gnss_sdr::Observables& obs) const //!< Deserialization
124  {
125  std::vector<Gnss_Synchro> vgs;
126  vgs.reserve(obs.observable_size());
127  for (int i = 0; i < obs.observable_size(); ++i)
128  {
129  const gnss_sdr::GnssSynchro& gs_read = obs.observable(i);
130  Gnss_Synchro gs = Gnss_Synchro();
131  gs.System = gs_read.system()[0];
132  gs.Signal[0] = gs_read.signal()[0];
133  gs.Signal[1] = gs_read.signal()[1];
134  gs.Signal[2] = '\0';
135  gs.PRN = gs_read.prn();
136  gs.Channel_ID = gs_read.channel_id();
137 
138  gs.Acq_delay_samples = gs_read.acq_delay_samples();
139  gs.Acq_doppler_hz = gs_read.acq_doppler_hz();
140  gs.Acq_samplestamp_samples = gs_read.acq_samplestamp_samples();
141  gs.Acq_doppler_step = gs_read.acq_doppler_step();
142  gs.Flag_valid_acquisition = gs_read.flag_valid_acquisition();
143 
144  gs.fs = gs_read.fs();
145  gs.Prompt_I = gs_read.prompt_i();
146  gs.Prompt_Q = gs_read.prompt_q();
147  gs.CN0_dB_hz = gs_read.cn0_db_hz();
148  gs.Carrier_Doppler_hz = gs_read.carrier_doppler_hz();
149  gs.Tracking_sample_counter = gs_read.tracking_sample_counter();
150  gs.Flag_valid_symbol_output = gs_read.flag_valid_symbol_output();
151  gs.correlation_length_ms = gs_read.correlation_length_ms();
152 
153  gs.Flag_valid_word = gs_read.flag_valid_word();
154  gs.TOW_at_current_symbol_ms = gs_read.tow_at_current_symbol_ms();
155 
156  gs.Pseudorange_m = gs_read.pseudorange_m();
157  gs.RX_time = gs_read.rx_time();
158  gs.Flag_valid_pseudorange = gs_read.flag_valid_pseudorange();
159  gs.interp_TOW_ms = gs_read.interp_tow_ms();
160 
161  vgs.push_back(gs);
162  }
163  return vgs;
164  }
165 
166 private:
167  gnss_sdr::Observables observables{};
168 };
169 
170 #endif // GNSS_SDR_SERDES_GNSS_SYNCHRO_H
double Prompt_Q
Set by Tracking processing block.
Definition: gnss_synchro.h:55
double Pseudorange_m
Set by Observables processing block.
Definition: gnss_synchro.h:67
Serdes_Gnss_Synchro(Serdes_Gnss_Synchro &&other) noexcept
< Move constructor
int32_t Channel_ID
Set by Channel constructor.
Definition: gnss_synchro.h:44
char Signal[3]
Set by Channel::set_signal(Gnss_Signal gnss_signal)
Definition: gnss_synchro.h:42
uint32_t PRN
Set by Channel::set_signal(Gnss_Signal gnss_signal)
Definition: gnss_synchro.h:43
Serdes_Gnss_Synchro & operator=(Serdes_Gnss_Synchro &&other) noexcept
< Move assignment operator
bool Flag_valid_pseudorange
Set by Observables processing block.
Definition: gnss_synchro.h:75
uint32_t TOW_at_current_symbol_ms
Set by Telemetry Decoder processing block.
Definition: gnss_synchro.h:64
int32_t correlation_length_ms
Set by Tracking processing block.
Definition: gnss_synchro.h:61
char System
Set by Channel::set_signal(Gnss_Signal gnss_signal)
Definition: gnss_synchro.h:41
This is the class that contains the information that is shared by the processing blocks.
Definition: gnss_synchro.h:33
double Acq_delay_samples
Set by Acquisition processing block.
Definition: gnss_synchro.h:47
uint64_t Acq_samplestamp_samples
Set by Acquisition processing block.
Definition: gnss_synchro.h:49
double Carrier_Doppler_hz
Set by Tracking processing block.
Definition: gnss_synchro.h:57
bool Flag_valid_symbol_output
Set by Tracking processing block.
Definition: gnss_synchro.h:73
double Acq_doppler_hz
Set by Acquisition processing block.
Definition: gnss_synchro.h:48
Serdes_Gnss_Synchro & operator=(const Serdes_Gnss_Synchro &rhs) noexcept
< Copy assignment operator
std::string createProtobuffer(const std::vector< Gnss_Synchro > &vgs)
double RX_time
Set by Observables processing block.
Definition: gnss_synchro.h:68
double CN0_dB_hz
Set by Tracking processing block.
Definition: gnss_synchro.h:56
This class implements serialization and deserialization of Gnss_Synchro objects using Protocol Buffer...
int64_t fs
Set by Tracking processing block.
Definition: gnss_synchro.h:53
Serdes_Gnss_Synchro(const Serdes_Gnss_Synchro &other) noexcept
< Copy constructor
double Prompt_I
Set by Tracking processing block.
Definition: gnss_synchro.h:54
uint64_t Tracking_sample_counter
Set by Tracking processing block.
Definition: gnss_synchro.h:60
double interp_TOW_ms
Set by Observables processing block.
Definition: gnss_synchro.h:69
std::vector< Gnss_Synchro > readProtobuffer(const gnss_sdr::Observables &obs) const
< Deserialization
uint32_t Acq_doppler_step
Set by Acquisition processing block.
Definition: gnss_synchro.h:50
bool Flag_valid_acquisition
Set by Acquisition processing block.
Definition: gnss_synchro.h:72
Interface of the Gnss_Synchro class.
bool Flag_valid_word
Set by Telemetry Decoder processing block.
Definition: gnss_synchro.h:74