GNU Radio's TEST Package
uhd_sink_c Class Reference

#include <uhd_sink_c.h>

Inheritance diagram for uhd_sink_c:
sink_iface

Public Member Functions

 ~uhd_sink_c ()
 
std::string name ()
 
size_t get_num_channels (void)
 
osmosdr::meta_range_t get_sample_rates (void)
 
double set_sample_rate (double rate)
 
double get_sample_rate (void)
 
osmosdr::freq_range_t get_freq_range (size_t chan=0)
 
double set_center_freq (double freq, size_t chan=0)
 
double get_center_freq (size_t chan=0)
 
double set_freq_corr (double ppm, size_t chan=0)
 
double get_freq_corr (size_t chan=0)
 
std::vector< std::string > get_gain_names (size_t chan=0)
 
osmosdr::gain_range_t get_gain_range (size_t chan=0)
 
osmosdr::gain_range_t get_gain_range (const std::string &name, size_t chan=0)
 
double set_gain (double gain, size_t chan=0)
 
double set_gain (double gain, const std::string &name, size_t chan=0)
 
double get_gain (size_t chan=0)
 
double get_gain (const std::string &name, size_t chan=0)
 
std::vector< std::string > get_antennas (size_t chan=0)
 
std::string set_antenna (const std::string &antenna, size_t chan=0)
 
std::string get_antenna (size_t chan=0)
 
void set_dc_offset (const std::complex< double > &offset, size_t chan=0)
 
void set_iq_balance (const std::complex< double > &balance, size_t chan=0)
 
double set_bandwidth (double bandwidth, size_t chan=0)
 
double get_bandwidth (size_t chan=0)
 
osmosdr::freq_range_t get_bandwidth_range (size_t chan=0)
 
void set_time_source (const std::string &source, const size_t mboard=0)
 
std::string get_time_source (const size_t mboard)
 
std::vector< std::string > get_time_sources (const size_t mboard)
 
void set_clock_source (const std::string &source, const size_t mboard=0)
 
std::string get_clock_source (const size_t mboard)
 
std::vector< std::string > get_clock_sources (const size_t mboard)
 
double get_clock_rate (size_t mboard=0)
 
void set_clock_rate (double rate, size_t mboard=0)
 
::osmosdr::time_spec_t get_time_now (size_t mboard=0)
 
::osmosdr::time_spec_t get_time_last_pps (size_t mboard=0)
 
void set_time_now (const ::osmosdr::time_spec_t &time_spec, size_t mboard=0)
 
void set_time_next_pps (const ::osmosdr::time_spec_t &time_spec)
 
void set_time_unknown_pps (const ::osmosdr::time_spec_t &time_spec)
 
- Public Member Functions inherited from sink_iface
virtual bool set_gain_mode (bool automatic, size_t chan=0)
 
virtual bool get_gain_mode (size_t chan=0)
 
virtual double set_if_gain (double gain, size_t chan=0)
 
virtual double set_bb_gain (double gain, size_t chan=0)
 
virtual ::osmosdr::time_spec_t get_time_now (size_t mboard=0)
 
virtual ::osmosdr::time_spec_t get_time_last_pps (size_t mboard=0)
 

Static Public Member Functions

static std::vector< std::string > get_devices ()
 

Friends

uhd_sink_c_sptr make_uhd_sink_c (const std::string &args)
 

Constructor & Destructor Documentation

◆ ~uhd_sink_c()

uhd_sink_c::~uhd_sink_c ( )

Member Function Documentation

◆ get_antenna()

std::string uhd_sink_c::get_antenna ( size_t  chan = 0)
virtual

Get the actual underlying radio hardware antenna setting.

Parameters
chanthe channel index 0 to N-1
Returns
the actual antenna's name

Implements sink_iface.

◆ get_antennas()

std::vector< std::string > uhd_sink_c::get_antennas ( size_t  chan = 0)
virtual

Get the available antennas of the underlying radio hardware.

Parameters
chanthe channel index 0 to N-1
Returns
a vector of strings containing the names of available antennas

Implements sink_iface.

◆ get_bandwidth()

double uhd_sink_c::get_bandwidth ( size_t  chan = 0)
virtual

Get the actual bandpass filter setting on the radio frontend.

Parameters
chanthe channel index 0 to N-1
Returns
the actual filter bandwidth in Hz

Reimplemented from sink_iface.

◆ get_bandwidth_range()

osmosdr::freq_range_t uhd_sink_c::get_bandwidth_range ( size_t  chan = 0)
virtual

Get the possible bandpass filter settings on the radio frontend.

Parameters
chanthe channel index 0 to N-1
Returns
a range of bandwidths in Hz

Reimplemented from sink_iface.

◆ get_center_freq()

double uhd_sink_c::get_center_freq ( size_t  chan = 0)
virtual

Get the center frequency the underlying radio hardware is tuned to. This is the actual frequency and may differ from the frequency set.

Parameters
chanthe channel index 0 to N-1
Returns
the frequency in Hz

Implements sink_iface.

◆ get_clock_rate()

double uhd_sink_c::get_clock_rate ( size_t  mboard = 0)
virtual

Get the master clock rate.

Parameters
mboardthe motherboard index 0 to M-1
Returns
the clock rate in Hz

Reimplemented from sink_iface.

◆ get_clock_source()

std::string uhd_sink_c::get_clock_source ( const size_t  mboard)
virtual

Get the currently set clock source.

Parameters
mboardwhich motherboard to get the config
Returns
the string representing the clock source

Reimplemented from sink_iface.

◆ get_clock_sources()

std::vector<std::string> uhd_sink_c::get_clock_sources ( const size_t  mboard)
virtual

Get a list of possible clock sources.

Parameters
mboardwhich motherboard to get the list
Returns
a vector of strings for possible settings

Reimplemented from sink_iface.

◆ get_devices()

static std::vector< std::string > uhd_sink_c::get_devices ( )
static

◆ get_freq_corr()

double uhd_sink_c::get_freq_corr ( size_t  chan = 0)
virtual

Get the frequency correction value.

Parameters
chanthe channel index 0 to N-1
Returns
correction value in parts per million

Implements sink_iface.

◆ get_freq_range()

osmosdr::freq_range_t uhd_sink_c::get_freq_range ( size_t  chan = 0)
virtual

Get the tunable frequency range for the underlying radio hardware.

Parameters
chanthe channel index 0 to N-1
Returns
the frequency range in Hz

Implements sink_iface.

◆ get_gain() [1/2]

double uhd_sink_c::get_gain ( const std::string &  name,
size_t  chan = 0 
)
virtual

Get the actual gain setting of a named stage.

Parameters
namethe name of the gain stage
chanthe channel index 0 to N-1
Returns
the actual gain in dB

Implements sink_iface.

◆ get_gain() [2/2]

double uhd_sink_c::get_gain ( size_t  chan = 0)
virtual

Get the actual gain setting of the underlying radio hardware.

Parameters
chanthe channel index 0 to N-1
Returns
the actual gain in dB

Implements sink_iface.

◆ get_gain_names()

std::vector<std::string> uhd_sink_c::get_gain_names ( size_t  chan = 0)
virtual

Get the gain stage names of the underlying radio hardware.

Parameters
chanthe channel index 0 to N-1
Returns
a vector of strings containing the names of gain stages

Implements sink_iface.

◆ get_gain_range() [1/2]

osmosdr::gain_range_t uhd_sink_c::get_gain_range ( const std::string &  name,
size_t  chan = 0 
)
virtual

Get the settable gain range for a specific gain stage.

Parameters
namethe name of the gain stage
chanthe channel index 0 to N-1
Returns
the gain range in dB

Implements sink_iface.

◆ get_gain_range() [2/2]

osmosdr::gain_range_t uhd_sink_c::get_gain_range ( size_t  chan = 0)
virtual

Get the settable overall gain range for the underlying radio hardware.

Parameters
chanthe channel index 0 to N-1
Returns
the gain range in dB

Implements sink_iface.

◆ get_num_channels()

size_t uhd_sink_c::get_num_channels ( void  )
virtual

Get the number of channels the underlying radio hardware offers.

Returns
the number of available channels

Implements sink_iface.

◆ get_sample_rate()

double uhd_sink_c::get_sample_rate ( void  )
virtual

Get the sample rate for the underlying radio hardware. This is the actual sample rate and may differ from the rate set.

Returns
the actual rate in Sps

Implements sink_iface.

◆ get_sample_rates()

osmosdr::meta_range_t uhd_sink_c::get_sample_rates ( void  )
virtual

Get the possible sample rates for the underlying radio hardware.

Returns
a range of rates in Sps

Implements sink_iface.

◆ get_time_last_pps()

::osmosdr::time_spec_t uhd_sink_c::get_time_last_pps ( size_t  mboard = 0)

◆ get_time_now()

::osmosdr::time_spec_t uhd_sink_c::get_time_now ( size_t  mboard = 0)

◆ get_time_source()

std::string uhd_sink_c::get_time_source ( const size_t  mboard)
virtual

Get the currently set time source.

Parameters
mboardwhich motherboard to get the config
Returns
the string representing the time source

Reimplemented from sink_iface.

◆ get_time_sources()

std::vector<std::string> uhd_sink_c::get_time_sources ( const size_t  mboard)
virtual

Get a list of possible time sources.

Parameters
mboardwhich motherboard to get the list
Returns
a vector of strings for possible settings

Reimplemented from sink_iface.

◆ name()

std::string uhd_sink_c::name ( )

◆ set_antenna()

std::string uhd_sink_c::set_antenna ( const std::string &  antenna,
size_t  chan = 0 
)
virtual

Select the active antenna of the underlying radio hardware.

Parameters
antennathe antenna name
chanthe channel index 0 to N-1
Returns
the actual antenna's name

Implements sink_iface.

◆ set_bandwidth()

double uhd_sink_c::set_bandwidth ( double  bandwidth,
size_t  chan = 0 
)
virtual

Set the bandpass filter on the radio frontend.

Parameters
bandwidththe filter bandwidth in Hz, set to 0 for automatic selection
chanthe channel index 0 to N-1
Returns
the actual filter bandwidth in Hz

Reimplemented from sink_iface.

◆ set_center_freq()

double uhd_sink_c::set_center_freq ( double  freq,
size_t  chan = 0 
)
virtual

Tune the underlying radio hardware to the desired center frequency. This also will select the appropriate RF bandpass.

Parameters
freqthe desired frequency in Hz
chanthe channel index 0 to N-1
Returns
the actual frequency in Hz

Implements sink_iface.

◆ set_clock_rate()

void uhd_sink_c::set_clock_rate ( double  rate,
size_t  mboard = 0 
)
virtual

Set the master clock rate.

Parameters
ratethe new rate in Hz
mboardthe motherboard index 0 to M-1

Reimplemented from sink_iface.

◆ set_clock_source()

void uhd_sink_c::set_clock_source ( const std::string &  source,
const size_t  mboard = 0 
)
virtual

Set the clock source for the device. This sets the source for a 10 Mhz reference clock. Typical options for source: internal, external, MIMO.

Parameters
sourcea string representing the clock source
mboardwhich motherboard to set the config

Reimplemented from sink_iface.

◆ set_dc_offset()

void uhd_sink_c::set_dc_offset ( const std::complex< double > &  offset,
size_t  chan = 0 
)
virtual

Set the TX frontend DC offset value. The value is complex to control both I and Q.

Parameters
offsetthe dc offset (1.0 is full-scale)
chanthe channel index 0 to N-1

Reimplemented from sink_iface.

◆ set_freq_corr()

double uhd_sink_c::set_freq_corr ( double  ppm,
size_t  chan = 0 
)
virtual

Set the frequency correction value in parts per million.

Parameters
ppmthe desired correction value in parts per million
chanthe channel index 0 to N-1
Returns
correction value in parts per million

Implements sink_iface.

◆ set_gain() [1/2]

double uhd_sink_c::set_gain ( double  gain,
const std::string &  name,
size_t  chan = 0 
)
virtual

Set the named gain on the underlying radio hardware.

Parameters
gainthe gain in dB
namethe name of the gain stage
chanthe channel index 0 to N-1
Returns
the actual gain in dB

Implements sink_iface.

◆ set_gain() [2/2]

double uhd_sink_c::set_gain ( double  gain,
size_t  chan = 0 
)
virtual

Set the gain for the underlying radio hardware. This function will automatically distribute the desired gain value over available gain stages in an appropriate way and return the actual value.

Parameters
gainthe gain in dB
chanthe channel index 0 to N-1
Returns
the actual gain in dB

Implements sink_iface.

◆ set_iq_balance()

void uhd_sink_c::set_iq_balance ( const std::complex< double > &  balance,
size_t  chan = 0 
)
virtual

Set the TX frontend IQ balance correction. Use this to adjust the magnitude and phase of I and Q.

Parameters
balancethe complex correction value
chanthe channel index 0 to N-1

Reimplemented from sink_iface.

◆ set_sample_rate()

double uhd_sink_c::set_sample_rate ( double  rate)
virtual

Set the sample rate for the underlying radio hardware. This also will select the appropriate IF bandpass, if applicable.

Parameters
ratea new rate in Sps

Implements sink_iface.

◆ set_time_next_pps()

void uhd_sink_c::set_time_next_pps ( const ::osmosdr::time_spec_t time_spec)
virtual

Set the time registers at the next pps.

Parameters
time_specthe new time

Reimplemented from sink_iface.

◆ set_time_now()

void uhd_sink_c::set_time_now ( const ::osmosdr::time_spec_t time_spec,
size_t  mboard = 0 
)
virtual

Sets the time registers immediately.

Parameters
time_specthe new time
mboardthe motherboard index 0 to M-1

Reimplemented from sink_iface.

◆ set_time_source()

void uhd_sink_c::set_time_source ( const std::string &  source,
const size_t  mboard = 0 
)
virtual

Set the time source for the device. This sets the method of time synchronization, typically a pulse per second or an encoded time. Typical options for source: external, MIMO.

Parameters
sourcea string representing the time source
mboardwhich motherboard to set the config

Reimplemented from sink_iface.

◆ set_time_unknown_pps()

void uhd_sink_c::set_time_unknown_pps ( const ::osmosdr::time_spec_t time_spec)
virtual

Sync the time registers with an unknown pps edge.

Parameters
time_specthe new time

Reimplemented from sink_iface.

Friends And Related Function Documentation

◆ make_uhd_sink_c

uhd_sink_c_sptr make_uhd_sink_c ( const std::string &  args)
friend

The documentation for this class was generated from the following file: