2020-06-08 19:32:52 +00:00
/*!
* \ file galileo_e5b_pcps_acquisition_fpga . cc
* \ brief Adapts a PCPS acquisition block to an AcquisitionInterface for
* Galileo E5b data and pilot Signals for the FPGA
* \ author Piyush Gupta , 2020. piyush04111999 @ gmail . com
* \ note Code added as part of GSoC 2020 Program .
*
2020-07-28 14:57:15 +00:00
* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2020-06-08 19:32:52 +00:00
*
2020-12-30 12:35:06 +00:00
* GNSS - SDR is a Global Navigation Satellite System software - defined receiver .
2020-06-08 19:32:52 +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-06-08 19:32:52 +00:00
* SPDX - License - Identifier : GPL - 3.0 - or - later
*
2020-07-28 14:57:15 +00:00
* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2020-06-08 19:32:52 +00:00
*/
# include "galileo_e5b_pcps_acquisition_fpga.h"
# include "Galileo_E5b.h"
# include "configuration_interface.h"
2020-11-07 21:43:19 +00:00
# include "galileo_e5_signal_replica.h"
2021-01-15 12:39:26 +00:00
# include "gnss_sdr_fft.h"
2020-06-08 19:32:52 +00:00
# include "gnss_sdr_flags.h"
2020-11-26 16:07:15 +00:00
# include "uio_fpga.h"
2020-06-08 19:32:52 +00:00
# include <glog/logging.h>
# include <gnuradio/gr_complex.h> // for gr_complex
# include <volk/volk.h> // for volk_32fc_conjugate_32fc
2021-10-11 16:31:16 +00:00
# include <algorithm> // for copy_n
# include <cmath> // for abs, pow, floor
# include <complex> // for complex
2020-06-08 19:32:52 +00:00
2020-07-11 11:06:32 +00:00
GalileoE5bPcpsAcquisitionFpga : : GalileoE5bPcpsAcquisitionFpga ( const ConfigurationInterface * configuration ,
2020-06-08 19:32:52 +00:00
const std : : string & role ,
unsigned int in_streams ,
2021-10-11 16:31:16 +00:00
unsigned int out_streams ) : gnss_synchro_ ( nullptr ) ,
role_ ( role ) ,
doppler_center_ ( 0 ) ,
channel_ ( 0 ) ,
doppler_step_ ( 0 ) ,
2020-06-08 19:32:52 +00:00
in_streams_ ( in_streams ) ,
out_streams_ ( out_streams )
{
pcpsconf_fpga_t acq_parameters ;
std : : string default_dump_filename = " ../data/acquisition.dat " ;
DLOG ( INFO ) < < " Role " < < role ;
2020-07-11 11:06:32 +00:00
int64_t fs_in_deprecated = configuration - > property ( " GNSS-SDR.internal_fs_hz " , 32000000 ) ;
int64_t fs_in = configuration - > property ( " GNSS-SDR.internal_fs_sps " , fs_in_deprecated ) ;
2020-06-08 19:32:52 +00:00
2020-07-11 11:06:32 +00:00
acq_parameters . repeat_satellite = configuration - > property ( role + " .repeat_satellite " , false ) ;
2020-06-08 19:32:52 +00:00
DLOG ( INFO ) < < role < < " satellite repeat = " < < acq_parameters . repeat_satellite ;
2020-07-11 11:06:32 +00:00
uint32_t downsampling_factor = configuration - > property ( role + " .downsampling_factor " , 1 ) ;
2020-06-08 19:32:52 +00:00
acq_parameters . downsampling_factor = downsampling_factor ;
fs_in = fs_in / downsampling_factor ;
acq_parameters . fs_in = fs_in ;
2020-07-11 11:06:32 +00:00
doppler_max_ = configuration - > property ( role + " .doppler_max " , 5000 ) ;
2020-06-08 19:32:52 +00:00
if ( FLAGS_doppler_max ! = 0 )
{
doppler_max_ = FLAGS_doppler_max ;
}
acq_parameters . doppler_max = doppler_max_ ;
2020-07-11 11:06:32 +00:00
acq_pilot_ = configuration - > property ( role + " .acquire_pilot " , false ) ;
acq_iq_ = configuration - > property ( role + " .acquire_iq " , false ) ;
2020-06-08 19:32:52 +00:00
if ( acq_iq_ )
{
acq_pilot_ = false ;
}
auto code_length = static_cast < uint32_t > ( std : : round ( static_cast < double > ( fs_in ) / GALILEO_E5B_CODE_CHIP_RATE_CPS * static_cast < double > ( GALILEO_E5B_CODE_LENGTH_CHIPS ) ) ) ;
acq_parameters . code_length = code_length ;
// The FPGA can only use FFT lengths that are a power of two.
2020-07-11 11:06:32 +00:00
float nbits = ceilf ( log2f ( static_cast < float > ( code_length ) * 2.0F ) ) ;
2020-06-08 19:32:52 +00:00
uint32_t nsamples_total = pow ( 2 , nbits ) ;
2020-07-11 11:06:32 +00:00
uint32_t select_queue_Fpga = configuration - > property ( role + " .select_queue_Fpga " , 1 ) ;
2020-06-08 19:32:52 +00:00
acq_parameters . select_queue_Fpga = select_queue_Fpga ;
2020-11-26 16:07:15 +00:00
// UIO device file
std : : string device_io_name ;
2020-11-27 11:04:27 +00:00
// find the uio device file corresponding to the acquisition
if ( find_uio_dev_file_name ( device_io_name , acquisition_device_name , 0 ) < 0 )
2020-11-26 16:07:15 +00:00
{
2020-11-27 11:04:27 +00:00
std : : cout < < " Cannot find the FPGA uio device file corresponding to device name " < < acquisition_device_name < < std : : endl ;
2020-11-26 16:07:15 +00:00
throw std : : exception ( ) ;
}
acq_parameters . device_name = device_io_name ;
2020-06-08 19:32:52 +00:00
2020-11-26 16:07:15 +00:00
acq_parameters . samples_per_code = nsamples_total ;
2020-06-08 19:32:52 +00:00
acq_parameters . excludelimit = static_cast < unsigned int > ( 1 + ceil ( ( 1.0 / GALILEO_E5B_CODE_CHIP_RATE_CPS ) * static_cast < float > ( fs_in ) ) ) ;
// compute all the GALILEO E5b PRN Codes (this is done only once in the class constructor in order to avoid re-computing the PRN codes every time
// a channel is assigned)
2021-01-15 12:39:26 +00:00
auto fft_if = gnss_fft_fwd_make_unique ( nsamples_total ) ; // Direct FFT
volk_gnsssdr : : vector < std : : complex < float > > code ( nsamples_total ) ; // Buffer for local code
2020-06-08 19:32:52 +00:00
volk_gnsssdr : : vector < std : : complex < float > > fft_codes_padded ( nsamples_total ) ;
2021-10-11 16:31:16 +00:00
d_all_fft_codes_ = volk_gnsssdr : : vector < uint32_t > ( nsamples_total * GALILEO_E5B_NUMBER_OF_CODES ) ; // memory containing all the possible fft codes for PRN 0 to 32
2020-06-08 19:32:52 +00:00
float max ; // temporary maxima search
int32_t tmp ;
int32_t tmp2 ;
int32_t local_code ;
int32_t fft_data ;
for ( uint32_t PRN = 1 ; PRN < = GALILEO_E5B_NUMBER_OF_CODES ; PRN + + )
{
std : : array < char , 3 > signal_ ;
signal_ [ 0 ] = ' 7 ' ;
signal_ [ 2 ] = ' \0 ' ;
if ( acq_iq_ )
{
signal_ [ 1 ] = ' X ' ;
}
else if ( acq_pilot_ )
{
signal_ [ 1 ] = ' Q ' ;
}
else
{
signal_ [ 1 ] = ' I ' ;
}
galileo_e5_b_code_gen_complex_sampled ( code , PRN , signal_ , fs_in , 0 ) ;
for ( uint32_t s = code_length ; s < 2 * code_length ; s + + )
{
code [ s ] = code [ s - code_length ] ;
}
// fill in zero padding
for ( uint32_t s = 2 * code_length ; s < nsamples_total ; s + + )
{
code [ s ] = std : : complex < float > ( 0.0 , 0.0 ) ;
}
std : : copy_n ( code . data ( ) , nsamples_total , fft_if - > get_inbuf ( ) ) ; // copy to FFT buffer
fft_if - > execute ( ) ; // Run the FFT of local code
volk_32fc_conjugate_32fc ( fft_codes_padded . data ( ) , fft_if - > get_outbuf ( ) , nsamples_total ) ; // conjugate values
max = 0 ; // initialize maximum value
for ( uint32_t i = 0 ; i < nsamples_total ; i + + ) // search for maxima
{
if ( std : : abs ( fft_codes_padded [ i ] . real ( ) ) > max )
{
max = std : : abs ( fft_codes_padded [ i ] . real ( ) ) ;
}
if ( std : : abs ( fft_codes_padded [ i ] . imag ( ) ) > max )
{
max = std : : abs ( fft_codes_padded [ i ] . imag ( ) ) ;
}
}
// map the FFT to the dynamic range of the fixed point values an copy to buffer containing all FFTs
// and package codes in a format that is ready to be written to the FPGA
for ( uint32_t i = 0 ; i < nsamples_total ; i + + )
{
tmp = static_cast < int32_t > ( floor ( fft_codes_padded [ i ] . real ( ) * ( pow ( 2 , quant_bits_local_code - 1 ) - 1 ) / max ) ) ;
tmp2 = static_cast < int32_t > ( floor ( fft_codes_padded [ i ] . imag ( ) * ( pow ( 2 , quant_bits_local_code - 1 ) - 1 ) / max ) ) ;
local_code = ( tmp & select_lsbits ) | ( ( tmp2 * shl_code_bits ) & select_msbits ) ; // put together the real part and the imaginary part
fft_data = local_code & select_all_code_bits ;
d_all_fft_codes_ [ i + ( nsamples_total * ( PRN - 1 ) ) ] = fft_data ;
}
}
acq_parameters . all_fft_codes = d_all_fft_codes_ . data ( ) ;
// reference for the FPGA FFT-IFFT attenuation factor
2020-07-11 11:06:32 +00:00
acq_parameters . total_block_exp = configuration - > property ( role + " .total_block_exp " , 13 ) ;
2020-06-08 19:32:52 +00:00
2020-07-11 11:06:32 +00:00
acq_parameters . num_doppler_bins_step2 = configuration - > property ( role + " .second_nbins " , 4 ) ;
acq_parameters . doppler_step2 = configuration - > property ( role + " .second_doppler_step " , static_cast < float > ( 125.0 ) ) ;
acq_parameters . make_2_steps = configuration - > property ( role + " .make_two_steps " , false ) ;
acq_parameters . max_num_acqs = configuration - > property ( role + " .max_num_acqs " , 2 ) ;
2020-06-08 19:32:52 +00:00
acquisition_fpga_ = pcps_make_acquisition_fpga ( acq_parameters ) ;
if ( in_streams_ > 1 )
{
LOG ( ERROR ) < < " This implementation only supports one input stream " ;
}
if ( out_streams_ > 0 )
{
LOG ( ERROR ) < < " This implementation does not provide an output stream " ;
}
}
void GalileoE5bPcpsAcquisitionFpga : : stop_acquisition ( )
{
// this command causes the SW to reset the HW.
acquisition_fpga_ - > reset_acquisition ( ) ;
}
void GalileoE5bPcpsAcquisitionFpga : : set_threshold ( float threshold )
{
DLOG ( INFO ) < < " Channel " < < channel_ < < " Threshold = " < < threshold ;
acquisition_fpga_ - > set_threshold ( threshold ) ;
}
void GalileoE5bPcpsAcquisitionFpga : : set_doppler_max ( unsigned int doppler_max )
{
doppler_max_ = doppler_max ;
acquisition_fpga_ - > set_doppler_max ( doppler_max_ ) ;
}
void GalileoE5bPcpsAcquisitionFpga : : set_doppler_step ( unsigned int doppler_step )
{
doppler_step_ = doppler_step ;
acquisition_fpga_ - > set_doppler_step ( doppler_step_ ) ;
}
void GalileoE5bPcpsAcquisitionFpga : : set_doppler_center ( int doppler_center )
{
doppler_center_ = doppler_center ;
acquisition_fpga_ - > set_doppler_center ( doppler_center_ ) ;
}
void GalileoE5bPcpsAcquisitionFpga : : set_gnss_synchro ( Gnss_Synchro * gnss_synchro )
{
gnss_synchro_ = gnss_synchro ;
acquisition_fpga_ - > set_gnss_synchro ( gnss_synchro_ ) ;
}
signed int GalileoE5bPcpsAcquisitionFpga : : mag ( )
{
return acquisition_fpga_ - > mag ( ) ;
}
void GalileoE5bPcpsAcquisitionFpga : : init ( )
{
acquisition_fpga_ - > init ( ) ;
}
void GalileoE5bPcpsAcquisitionFpga : : set_local_code ( )
{
acquisition_fpga_ - > set_local_code ( ) ;
}
void GalileoE5bPcpsAcquisitionFpga : : reset ( )
{
acquisition_fpga_ - > set_active ( true ) ;
}
void GalileoE5bPcpsAcquisitionFpga : : set_state ( int state )
{
acquisition_fpga_ - > set_state ( state ) ;
}
void GalileoE5bPcpsAcquisitionFpga : : connect ( gr : : top_block_sptr top_block )
{
if ( top_block )
{
/* top_block is not null */
} ;
// Nothing to connect
}
void GalileoE5bPcpsAcquisitionFpga : : disconnect ( gr : : top_block_sptr top_block )
{
if ( top_block )
{
/* top_block is not null */
} ;
// Nothing to disconnect
}
gr : : basic_block_sptr GalileoE5bPcpsAcquisitionFpga : : get_left_block ( )
{
return nullptr ;
}
gr : : basic_block_sptr GalileoE5bPcpsAcquisitionFpga : : get_right_block ( )
{
return nullptr ;
}