GNU Radio 3.7.1 C++ API
gr::fcd::source_c Class Reference

Funcube Dongle source block. More...

#include <source_c.h>

Inheritance diagram for gr::fcd::source_c:

List of all members.

Public Types

typedef boost::shared_ptr
< source_c
sptr

Public Member Functions

virtual void set_freq (int freq)=0
 Set frequency with Hz resolution.
virtual void set_freq (float freq)=0
 Set frequency with Hz resolution.
virtual void set_freq_khz (int freq)=0
 Set frequency with kHz resolution.
virtual void set_lna_gain (float gain)=0
 Set LNA gain.
virtual void set_mixer_gain (float gain)=0
 Set mixer gain.
virtual void set_freq_corr (int ppm)=0
 Set new frequency correction.
virtual void set_dc_corr (double _dci, double _dcq)=0
 Set DC offset correction.
virtual void set_iq_corr (double _gain, double _phase)=0
 Set IQ phase and gain balance.

Static Public Member Functions

static sptr make (const std::string device_name="")
 Return a shared_ptr to a new instance of fcd_source_c.

Detailed Description

Funcube Dongle source block.

This class provides a Funcube Dongle soure block by wrapping the USB audio interface and the USB HID control interface of the Funcube Dongle into one convenient source block.

The Funcube Dongle needs to have firmware 18f or later for the control interface to work properly. As of early 2011, FCDs still come with firmware 18b. You can use qthid 2.2 (not 3) to upgrade the firmware: http://qthid.sf.net


Member Typedef Documentation


Member Function Documentation

static sptr gr::fcd::source_c::make ( const std::string  device_name = "") [static]

Return a shared_ptr to a new instance of fcd_source_c.

This is effectively the public constructor. To avoid accidental use of raw pointers, fcd_source_c's constructor is private. fcd_make_source_c is the public interface for creating new instances.

virtual void gr::fcd::source_c::set_dc_corr ( double  _dci,
double  _dcq 
) [pure virtual]

Set DC offset correction.

Parameters:
_dciDC correction for I component (-1.0 to 1.0)
_dcqDC correction for Q component (-1.0 to 1.0)

Set DC offset correction in the device. Default is 0.0.

virtual void gr::fcd::source_c::set_freq ( int  freq) [pure virtual]

Set frequency with Hz resolution.

Parameters:
freqThe frequency in Hz

Set the frequency of the Funcube Dongle with 1 Hz resolution applying the frequency correction set by set_freq_corr().

See also:
set_freq_khz()
virtual void gr::fcd::source_c::set_freq ( float  freq) [pure virtual]

Set frequency with Hz resolution.

Parameters:
freqThe frequency in Hz

This is a convenience function that uses float parameter in order to allow using engineering notation in GRC.

See also:
set_freq_khz()
virtual void gr::fcd::source_c::set_freq_corr ( int  ppm) [pure virtual]

Set new frequency correction.

Parameters:
ppmThe new frequency correction in parts per million

Version 1.1 FCDs (S/N 810 or later) need a correction of -12 ppm. Earlier FCDs need roughly -120 ppm (default for gr-fcd).

Ref: http://www.funcubedongle.com/?p=617

virtual void gr::fcd::source_c::set_freq_khz ( int  freq) [pure virtual]

Set frequency with kHz resolution.

Parameters:
freqThe frequency in kHz

Sets the frequency of the Funcube Dongle with 1 kHz resolution applying the frequency correction set by set_freq_corr().

See also:
set_freq()
virtual void gr::fcd::source_c::set_iq_corr ( double  _gain,
double  _phase 
) [pure virtual]

Set IQ phase and gain balance.

Parameters:
_gainThe gain correction (-1.0 to 1.0)
_phaseThe phase correction (-1.0 to 1.0)

Set IQ phase and gain balance in the device. The default values are 0.0 for phase and 1.0 for gain.

virtual void gr::fcd::source_c::set_lna_gain ( float  gain) [pure virtual]

Set LNA gain.

Parameters:
gainThe new gain in dB.

Set the LNA gain in the FCD. Valid range is -5 to 30. Although the LNA gain in the FCD takes enumerated values corresponding to 2.5 dB steps, you can can call this method with any float value and it will be rounded to the nearest valid value.

By default the LNA gain is set to 20 dB and this is a good value for most cases. In noisy areas you may try to reduce the gain.

virtual void gr::fcd::source_c::set_mixer_gain ( float  gain) [pure virtual]

Set mixer gain.

Parameters:
gainThe new gain in dB.

Set the mixer gain in the FCD. Valid values are +4 and +12 dB.

By default the mixer gain is set to +12 dB and this is a good value for most cases. In noisy areas you may try to reduce the gain.


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