GNU Radio Manual and C++ API Reference
3.7.5
The Free & Open Software Radio Ecosystem
All
Classes
Namespaces
Files
Functions
Variables
Typedefs
Enumerations
Enumerator
Properties
Friends
Macros
Groups
Pages
constellation_receiver_cb.h
Go to the documentation of this file.
1
/* -*- c++ -*- */
2
/*
3
* Copyright 2011,2012 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 3, 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
#ifndef INCLUDED_DIGITAL_CONSTELLATION_RECEIVER_CB_H
24
#define INCLUDED_DIGITAL_CONSTELLATION_RECEIVER_CB_H
25
26
#include <
gnuradio/digital/api.h
>
27
#include <
gnuradio/digital/constellation.h
>
28
#include <
gnuradio/block.h
>
29
30
namespace
gr {
31
namespace
digital {
32
33
/*!
34
* \brief This block makes hard decisions about the received
35
* symbols (using a constellation object) and also fine tunes
36
* phase synchronization.
37
*
38
* \details
39
*
40
* The phase and frequency synchronization are based on a Costas
41
* loop that finds the error of the incoming signal point compared
42
* to its nearest constellation point. The frequency and phase of
43
* the NCO are updated according to this error.
44
*
45
* Message Ports:
46
*
47
* set_constellation (input):
48
* Receives a PMT any containing a new gr::digital::constellation object.
49
* The PMT is cast back to a gr::digital::constellation_sptr
50
* and passes this to set_constellation.
51
*
52
* rotate_phase (input):
53
* Receives a PMT double to update the phase.
54
* The phase value passed in the message is added to the
55
* current phase of the receiver.
56
*/
57
class
DIGITAL_API
constellation_receiver_cb
58
:
virtual
public
block
59
{
60
public
:
61
// gr::digital::constellation_receiver_cb::sptr
62
typedef
boost::shared_ptr<constellation_receiver_cb>
sptr
;
63
64
/*!
65
* \brief Constructs a constellation receiver that (phase/fine
66
* freq) synchronizes and decodes constellation points specified
67
* by a constellation object.
68
*
69
* \param constellation constellation of points for generic modulation
70
* \param loop_bw Loop bandwidth of the Costas Loop (~ 2pi/100)
71
* \param fmin minimum normalized frequency value the loop can achieve
72
* \param fmax maximum normalized frequency value the loop can achieve
73
*/
74
static
sptr
make(
constellation_sptr
constellation
,
75
float
loop_bw,
float
fmin,
float
fmax);
76
77
virtual
void
phase_error_tracking(
float
phase_error) = 0;
78
};
79
80
}
/* namespace digital */
81
}
/* namespace gr */
82
83
#endif
/* INCLUDED_DIGITAL_CONSTELLATION_RECEIVER_CB_H */
gr-digital
include
gnuradio
digital
constellation_receiver_cb.h
Generated on Fri Oct 3 2014 00:33:50 for GNU Radio Manual and C++ API Reference by
1.8.1.2