Imported Upstream version 3.0
[debian/gnuradio] / gnuradio-core / src / lib / general / gr_costas_loop_cc.h
1 /* -*- c++ -*- */
2 /*
3  * Copyright 2006 Free Software Foundation, Inc.
4  * 
5  * This file is part of GNU Radio
6  * 
7  * GNU Radio is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2, or (at your option)
10  * any later version.
11  * 
12  * GNU Radio is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  * 
17  * You should have received a copy of the GNU General Public License
18  * along with GNU Radio; see the file COPYING.  If not, write to
19  * the Free Software Foundation, Inc., 51 Franklin Street,
20  * Boston, MA 02110-1301, USA.
21  */
22
23
24 #ifndef INCLUDED_GR_COSTAS_LOOP_CC_H
25 #define INCLUDED_GR_COSTAS_LOOP_CC_H
26
27 #include <gr_sync_block.h>
28 #include <stdexcept>
29 #include <fstream>
30
31 class gr_costas_loop_cc;
32 typedef boost::shared_ptr<gr_costas_loop_cc> gr_costas_loop_cc_sptr;
33
34 gr_costas_loop_cc_sptr 
35 gr_make_costas_loop_cc (float alpha, float beta,
36                         float max_freq, float min_freq, 
37                         int order
38                         ) throw (std::invalid_argument);
39
40
41 /*!
42  * \brief Carrier tracking PLL for QPSK
43  * input: complex; output: complex
44  *
45  * \p order must be 2 or 4.
46  */
47 class gr_costas_loop_cc : public gr_sync_block
48 {
49   friend gr_costas_loop_cc_sptr gr_make_costas_loop_cc (float alpha, float beta,
50                                                         float max_freq, float min_freq, 
51                                                         int order
52                                                         ) throw (std::invalid_argument);
53
54   float d_alpha, d_beta, d_max_freq, d_min_freq, d_phase, d_freq;
55   int d_order;
56
57   gr_costas_loop_cc (float alpha, float beta,
58                      float max_freq, float min_freq, 
59                      int order
60                      ) throw (std::invalid_argument);
61
62   float phase_detector_4(gr_complex sample) const;    // for QPSK
63   float phase_detector_2(gr_complex sample) const;    // for BPSK
64   float (gr_costas_loop_cc::*d_phase_detector)(gr_complex sample) const;
65
66 public:
67
68   int work (int noutput_items,
69             gr_vector_const_void_star &input_items,
70             gr_vector_void_star &output_items);
71 };
72
73 #endif