3 * Copyright 2004 Free Software Foundation, Inc.
5 * This file is part of GNU Radio
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 3, or (at your option)
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.
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.
23 #ifndef INCLUDED_GR_CLOCK_RECOVERY_MM_CC_H
24 #define INCLUDED_GR_CLOCK_RECOVERY_MM_CC_H
27 #include <gr_complex.h>
29 class gri_mmse_fir_interpolator_cc;
31 class gr_clock_recovery_mm_cc;
32 typedef boost::shared_ptr<gr_clock_recovery_mm_cc> gr_clock_recovery_mm_cc_sptr;
35 gr_clock_recovery_mm_cc_sptr
36 gr_make_clock_recovery_mm_cc (float omega, float gain_omega, float mu, float gain_mu,
37 float omega_relative_limit=0.001);
40 * \brief Mueller and Müller (M&M) based clock recovery block with complex input, complex output.
43 * This implements the Mueller and Müller (M&M) discrete-time error-tracking synchronizer.
45 * See "Digital Communication Receivers: Synchronization, Channel
46 * Estimation and Signal Processing" by Heinrich Meyr, Marc Moeneclaey, & Stefan Fechtel.
49 class gr_clock_recovery_mm_cc : public gr_block
52 ~gr_clock_recovery_mm_cc ();
53 void forecast(int noutput_items, gr_vector_int &ninput_items_required);
54 int general_work (int noutput_items,
55 gr_vector_int &ninput_items,
56 gr_vector_const_void_star &input_items,
57 gr_vector_void_star &output_items);
58 float mu() const { return d_mu;}
59 float omega() const { return d_omega;}
60 float gain_mu() const { return d_gain_mu;}
61 float gain_omega() const { return d_gain_omega;}
62 void set_verbose (bool verbose) { d_verbose = verbose; }
64 void set_gain_mu (float gain_mu) { d_gain_mu = gain_mu; }
65 void set_gain_omega (float gain_omega) { d_gain_omega = gain_omega; }
66 void set_mu (float mu) { d_mu = mu; }
67 void set_omega (float omega) {
69 d_min_omega = omega*(1.0 - d_omega_relative_limit);
70 d_max_omega = omega*(1.0 + d_omega_relative_limit);
74 gr_clock_recovery_mm_cc (float omega, float gain_omega, float mu, float gain_mu,
75 float omega_relative_limi);
81 float d_min_omega; // minimum allowed omega
82 float d_max_omega; // maximum allowed omeg
83 float d_omega_relative_limit; // used to compute min and max omega
85 gr_complex d_last_sample;
86 gri_mmse_fir_interpolator_cc *d_interp;
97 gr_complex slicer_0deg (gr_complex sample);
98 gr_complex slicer_45deg (gr_complex sample);
100 friend gr_clock_recovery_mm_cc_sptr
101 gr_make_clock_recovery_mm_cc (float omega, float gain_omega, float mu, float gain_mu,
102 float omega_relative_limit);