2018-03-02 16:40:13 +00:00
/*!
2018-05-22 10:25:14 +00:00
* \ file gps_l1_ca_dll_pll_tracking_fpga . cc
2018-03-02 16:40:13 +00:00
* \ brief Implementation of an adapter of a DLL + PLL tracking loop block
2018-05-03 08:38:21 +00:00
* for GPS L1 C / A to a TrackingInterface that uses the FPGA
* \ author Marc Majoral , 2018 , mmajoral ( at ) cttc . es
* Carlos Aviles , 2010. carlos . avilesr ( at ) googlemail . com
2018-03-02 16:40:13 +00:00
* Javier Arribas , 2011. jarribas ( at ) cttc . es
*
* Code DLL + carrier PLL according to the algorithms described in :
* K . Borre , D . M . Akos , N . Bertelsen , P . Rinder , and S . H . Jensen ,
* A Software - Defined GPS and Galileo Receiver . A Single - Frequency
* Approach , Birkhauser , 2007
*
* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
*
* Copyright ( C ) 2010 - 2015 ( see AUTHORS file for a list of contributors )
*
* GNSS - SDR is a software defined Global Navigation
* Satellite Systems receiver
*
* This file is part of GNSS - SDR .
*
* GNSS - SDR is free software : you can redistribute it and / or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation , either version 3 of the License , or
* ( at your option ) any later version .
*
* GNSS - SDR is distributed in the hope that it will be useful ,
* but WITHOUT ANY WARRANTY ; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE . See the
* GNU General Public License for more details .
*
* You should have received a copy of the GNU General Public License
* along with GNSS - SDR . If not , see < http : //www.gnu.org/licenses/>.
*
* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
*/
2018-05-03 08:38:21 +00:00
# include "gps_l1_ca_dll_pll_tracking_fpga.h"
# include "GPS_L1_CA.h"
2018-12-09 21:00:09 +00:00
# include "configuration_interface.h"
2018-05-03 08:38:21 +00:00
# include "display.h"
2018-12-09 21:00:09 +00:00
# include "gnss_sdr_flags.h"
# include "gps_sdr_signal_processing.h"
# include <glog/logging.h>
2018-05-03 08:38:21 +00:00
# define NUM_PRNs 32
2018-03-02 16:40:13 +00:00
using google : : LogMessage ;
2018-10-28 10:07:53 +00:00
void GpsL1CaDllPllTrackingFpga : : stop_tracking ( )
{
}
2018-03-02 16:40:13 +00:00
GpsL1CaDllPllTrackingFpga : : GpsL1CaDllPllTrackingFpga (
2018-12-10 21:59:10 +00:00
ConfigurationInterface * configuration , const std : : string & role ,
2018-10-28 10:07:53 +00:00
unsigned int in_streams , unsigned int out_streams ) : role_ ( role ) , in_streams_ ( in_streams ) , out_streams_ ( out_streams )
2018-03-02 16:40:13 +00:00
{
2018-10-28 10:07:53 +00:00
Dll_Pll_Conf_Fpga trk_param_fpga = Dll_Pll_Conf_Fpga ( ) ;
2018-03-02 16:40:13 +00:00
DLOG ( INFO ) < < " role " < < role ;
2018-10-28 10:07:53 +00:00
2018-03-02 16:40:13 +00:00
//################# CONFIGURATION PARAMETERS ########################
//std::string default_item_type = "gr_complex";
2018-05-09 09:11:12 +00:00
//std::string item_type = configuration->property(role + ".item_type", default_item_type);
2018-03-02 16:40:13 +00:00
int fs_in_deprecated = configuration - > property ( " GNSS-SDR.internal_fs_hz " , 2048000 ) ;
2018-05-03 08:38:21 +00:00
int fs_in = configuration - > property ( " GNSS-SDR.internal_fs_sps " , fs_in_deprecated ) ;
trk_param_fpga . fs_in = fs_in ;
bool dump = configuration - > property ( role + " .dump " , false ) ;
trk_param_fpga . dump = dump ;
2018-10-29 23:47:12 +00:00
std : : string default_dump_filename = " ./track_ch " ;
std : : string dump_filename = configuration - > property ( role + " .dump_filename " , default_dump_filename ) ;
trk_param_fpga . dump_filename = dump_filename ;
bool dump_mat = configuration - > property ( role + " .dump_mat " , true ) ;
trk_param_fpga . dump_mat = dump_mat ;
2018-05-03 08:38:21 +00:00
float pll_bw_hz = configuration - > property ( role + " .pll_bw_hz " , 50.0 ) ;
if ( FLAGS_pll_bw_hz ! = 0.0 ) pll_bw_hz = static_cast < float > ( FLAGS_pll_bw_hz ) ;
trk_param_fpga . pll_bw_hz = pll_bw_hz ;
float pll_bw_narrow_hz = configuration - > property ( role + " .pll_bw_narrow_hz " , 20.0 ) ;
trk_param_fpga . pll_bw_narrow_hz = pll_bw_narrow_hz ;
float dll_bw_narrow_hz = configuration - > property ( role + " .dll_bw_narrow_hz " , 2.0 ) ;
trk_param_fpga . dll_bw_narrow_hz = dll_bw_narrow_hz ;
float dll_bw_hz = configuration - > property ( role + " .dll_bw_hz " , 2.0 ) ;
if ( FLAGS_dll_bw_hz ! = 0.0 ) dll_bw_hz = static_cast < float > ( FLAGS_dll_bw_hz ) ;
trk_param_fpga . dll_bw_hz = dll_bw_hz ;
float early_late_space_chips = configuration - > property ( role + " .early_late_space_chips " , 0.5 ) ;
trk_param_fpga . early_late_space_chips = early_late_space_chips ;
float early_late_space_narrow_chips = configuration - > property ( role + " .early_late_space_narrow_chips " , 0.5 ) ;
trk_param_fpga . early_late_space_narrow_chips = early_late_space_narrow_chips ;
int vector_length = std : : round ( fs_in / ( GPS_L1_CA_CODE_RATE_HZ / GPS_L1_CA_CODE_LENGTH_CHIPS ) ) ;
trk_param_fpga . vector_length = vector_length ;
int symbols_extended_correlator = configuration - > property ( role + " .extend_correlation_symbols " , 1 ) ;
if ( symbols_extended_correlator < 1 )
2018-03-02 16:40:13 +00:00
{
2018-05-03 08:38:21 +00:00
symbols_extended_correlator = 1 ;
std : : cout < < TEXT_RED < < " WARNING: GPS L1 C/A. extend_correlation_symbols must be bigger than 1. Coherent integration has been set to 1 symbol (1 ms) " < < TEXT_RESET < < std : : endl ;
2018-03-02 16:40:13 +00:00
}
2018-05-03 08:38:21 +00:00
else if ( symbols_extended_correlator > 20 )
2018-03-02 16:40:13 +00:00
{
2018-05-03 08:38:21 +00:00
symbols_extended_correlator = 20 ;
std : : cout < < TEXT_RED < < " WARNING: GPS L1 C/A. extend_correlation_symbols must be lower than 21. Coherent integration has been set to 20 symbols (20 ms) " < < TEXT_RESET < < std : : endl ;
}
trk_param_fpga . extend_correlation_symbols = symbols_extended_correlator ;
bool track_pilot = configuration - > property ( role + " .track_pilot " , false ) ;
if ( track_pilot )
{
std : : cout < < TEXT_RED < < " WARNING: GPS L1 C/A does not have pilot signal. Data tracking has been enabled " < < TEXT_RESET < < std : : endl ;
}
if ( ( symbols_extended_correlator > 1 ) and ( pll_bw_narrow_hz > pll_bw_hz or dll_bw_narrow_hz > dll_bw_hz ) )
{
std : : cout < < TEXT_RED < < " WARNING: GPS L1 C/A. PLL or DLL narrow tracking bandwidth is higher than wide tracking one " < < TEXT_RESET < < std : : endl ;
2018-03-02 16:40:13 +00:00
}
2018-05-03 08:38:21 +00:00
trk_param_fpga . very_early_late_space_chips = 0.0 ;
trk_param_fpga . very_early_late_space_narrow_chips = 0.0 ;
trk_param_fpga . track_pilot = false ;
trk_param_fpga . system = ' G ' ;
char sig_ [ 3 ] = " 1C " ;
std : : memcpy ( trk_param_fpga . signal , sig_ , 3 ) ;
2018-05-09 09:11:12 +00:00
int cn0_samples = configuration - > property ( role + " .cn0_samples " , 20 ) ;
if ( FLAGS_cn0_samples ! = 20 ) cn0_samples = FLAGS_cn0_samples ;
trk_param_fpga . cn0_samples = cn0_samples ;
int cn0_min = configuration - > property ( role + " .cn0_min " , 25 ) ;
if ( FLAGS_cn0_min ! = 25 ) cn0_min = FLAGS_cn0_min ;
trk_param_fpga . cn0_min = cn0_min ;
int max_lock_fail = configuration - > property ( role + " .max_lock_fail " , 50 ) ;
if ( FLAGS_max_lock_fail ! = 50 ) max_lock_fail = FLAGS_max_lock_fail ;
trk_param_fpga . max_lock_fail = max_lock_fail ;
double carrier_lock_th = configuration - > property ( role + " .carrier_lock_th " , 0.85 ) ;
if ( FLAGS_carrier_lock_th ! = 0.85 ) carrier_lock_th = FLAGS_carrier_lock_th ;
trk_param_fpga . carrier_lock_th = carrier_lock_th ;
2018-05-03 08:38:21 +00:00
// FPGA configuration parameters
std : : string default_device_name = " /dev/uio " ;
std : : string device_name = configuration - > property ( role + " .devicename " , default_device_name ) ;
trk_param_fpga . device_name = device_name ;
unsigned int device_base = configuration - > property ( role + " .device_base " , 1 ) ;
trk_param_fpga . device_base = device_base ;
2018-08-01 13:55:40 +00:00
//unsigned int multicorr_type = configuration->property(role + ".multicorr_type", 0);
2018-10-28 10:07:53 +00:00
trk_param_fpga . multicorr_type = 0 ; //multicorr_type : 0 -> 3 correlators, 1 -> 5 correlators
2018-05-03 08:38:21 +00:00
//################# PRE-COMPUTE ALL THE CODES #################
2018-10-28 10:07:53 +00:00
d_ca_codes = static_cast < int * > ( volk_gnsssdr_malloc ( static_cast < int > ( GPS_L1_CA_CODE_LENGTH_CHIPS * NUM_PRNs ) * sizeof ( int ) , volk_gnsssdr_get_alignment ( ) ) ) ;
2018-05-03 08:38:21 +00:00
for ( unsigned int PRN = 1 ; PRN < = NUM_PRNs ; PRN + + )
2018-10-28 10:07:53 +00:00
{
gps_l1_ca_code_gen_int ( & d_ca_codes [ ( int ( GPS_L1_CA_CODE_LENGTH_CHIPS ) ) * ( PRN - 1 ) ] , PRN , 0 ) ;
}
2018-05-03 08:38:21 +00:00
trk_param_fpga . ca_codes = d_ca_codes ;
2018-08-01 13:55:40 +00:00
trk_param_fpga . code_length_chips = GPS_L1_CA_CODE_LENGTH_CHIPS ;
2018-10-28 10:07:53 +00:00
trk_param_fpga . code_samples_per_chip = 1 ; // 1 sample per chip
2018-05-03 08:38:21 +00:00
//################# MAKE TRACKING GNURadio object ###################
tracking_fpga_sc = dll_pll_veml_make_tracking_fpga ( trk_param_fpga ) ;
2018-03-02 16:40:13 +00:00
channel_ = 0 ;
DLOG ( INFO ) < < " tracking( " < < tracking_fpga_sc - > unique_id ( ) < < " ) " ;
}
GpsL1CaDllPllTrackingFpga : : ~ GpsL1CaDllPllTrackingFpga ( )
2018-05-03 08:38:21 +00:00
{
delete [ ] d_ca_codes ;
}
2018-03-02 16:40:13 +00:00
void GpsL1CaDllPllTrackingFpga : : start_tracking ( )
{
tracking_fpga_sc - > start_tracking ( ) ;
}
/*
* Set tracking channel unique ID
*/
void GpsL1CaDllPllTrackingFpga : : set_channel ( unsigned int channel )
{
channel_ = channel ;
tracking_fpga_sc - > set_channel ( channel ) ;
}
void GpsL1CaDllPllTrackingFpga : : set_gnss_synchro ( Gnss_Synchro * p_gnss_synchro )
{
tracking_fpga_sc - > set_gnss_synchro ( p_gnss_synchro ) ;
}
void GpsL1CaDllPllTrackingFpga : : connect ( gr : : top_block_sptr top_block )
{
2018-10-28 10:07:53 +00:00
if ( top_block )
{ /* top_block is not null */
} ;
2018-05-03 08:38:21 +00:00
//nothing to connect
2018-03-02 16:40:13 +00:00
}
void GpsL1CaDllPllTrackingFpga : : disconnect ( gr : : top_block_sptr top_block )
{
2018-10-28 10:07:53 +00:00
if ( top_block )
{ /* top_block is not null */
} ;
2018-05-03 08:38:21 +00:00
//nothing to disconnect
2018-03-02 16:40:13 +00:00
}
gr : : basic_block_sptr GpsL1CaDllPllTrackingFpga : : get_left_block ( )
{
return tracking_fpga_sc ;
}
gr : : basic_block_sptr GpsL1CaDllPllTrackingFpga : : get_right_block ( )
{
return tracking_fpga_sc ;
}