1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
/* -*- c++ -*- */
/*
* Copyright 2011-2012 Free Software Foundation, Inc.
*
* GNU Radio 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, or (at your option)
* any later version.
*
* GNU Radio 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 GNU Radio; see the file COPYING. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street,
* Boston, MA 02110-1301, USA.
*/
#ifndef INCLUDED_FCD_SOURCE_C_H
#define INCLUDED_FCD_SOURCE_C_H
#include <fcd_api.h>
#include <gr_hier_block2.h>
class fcd_source_c;
typedef boost::shared_ptr<fcd_source_c> fcd_source_c_sptr;
/*!
* \brief 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.
*/
FCD_API fcd_source_c_sptr fcd_make_source_c(const std::string device_name = "");
/*! \brief 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
*/
class FCD_API fcd_source_c : virtual public gr_hier_block2
{
public:
/*! \brief Set frequency with Hz resolution.
* \param freq The frequency in Hz
*
* Set the frequency of the Funcube Dongle with 1 Hz resolution applying
* the frequency correction set by set_freq_corr().
*
* \see set_freq_khz()
*/
virtual void set_freq(int freq) = 0;
/*! \brief Set frequency with Hz resolution.
* \param freq The frequency in Hz
*
* This is a convenience function that uses float parameter in order to allow
* using engineering notation in GRC.
*
* \see set_freq_khz()
*/
virtual void set_freq(float freq) = 0;
/*! \brief Set frequency with kHz resolution.
* \param freq The frequency in kHz
*
* Sets the frequency of the Funcube Dongle with 1 kHz resolution
* applying the frequency correction set by set_freq_corr().
*
* \see set_freq()
*/
virtual void set_freq_khz(int freq) = 0;
/*! \brief Set LNA gain.
* \param gain The 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 set_lna_gain(float gain) = 0;
/*! \brief Set mixer gain.
* \param gain The 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.
*/
virtual void set_mixer_gain(float gain) = 0;
/*! \brief Set new frequency correction.
* \param ppm The 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 set_freq_corr(int ppm) = 0;
/*! \brief Set DC offset correction.
* \param _dci DC correction for I component (-1.0 to 1.0)
* \param _dcq DC correction for Q component (-1.0 to 1.0)
*
* Set DC offset correction in the device. Default is 0.0.
*/
virtual void set_dc_corr(double _dci, double _dcq) = 0;
/*! \brief Set IQ phase and gain balance.
* \param _gain The gain correction (-1.0 to 1.0)
* \param _phase The 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 set_iq_corr(double _gain, double _phase) = 0;
};
#endif /* INCLUDED_FCD_SOURCE_C_H */
|
