Merging OFDM features branch r5661:5759 into trunk. OFDM works over the air with...
[debian/gnuradio] / gnuradio-examples / python / ofdm / receive_path.py
1 #!/usr/bin/env python
2 #
3 # Copyright 2005,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 from gnuradio import gr, gru, blks
24 from gnuradio import usrp
25 from gnuradio import eng_notation
26 import copy
27 import sys
28
29 # from current dir
30 from pick_bitrate import pick_rx_bitrate
31
32 # /////////////////////////////////////////////////////////////////////////////
33 #                              receive path
34 # /////////////////////////////////////////////////////////////////////////////
35
36 class receive_path(gr.hier_block):
37     def __init__(self, fg, rx_callback, options):
38
39         options = copy.copy(options)    # make a copy so we can destructively modify
40
41         self._verbose     = options.verbose
42         self._log         = options.log
43         self._rx_callback = rx_callback      # this callback is fired when there's a packet available
44
45         # receiver
46         self.ofdm_rx = \
47                      blks.ofdm_demod(fg, options, callback=self._rx_callback)
48
49         # Carrier Sensing Blocks
50         #alpha = 0.001
51         #thresh = 30   # in dB, will have to adjust
52         #self.probe = gr.probe_avg_mag_sqrd_c(thresh,alpha)
53         #fg.connect(self.chan_filt, self.probe)
54
55         # Display some information about the setup
56         if self._verbose:
57             self._print_verbage()
58         
59         gr.hier_block.__init__(self, fg, self.ofdm_rx, None)
60
61     def carrier_sensed(self):
62         """
63         Return True if we think carrier is present.
64         """
65         #return self.probe.level() > X
66         return self.probe.unmuted()
67
68     def carrier_threshold(self):
69         """
70         Return current setting in dB.
71         """
72         return self.probe.threshold()
73
74     def set_carrier_threshold(self, threshold_in_db):
75         """
76         Set carrier threshold.
77
78         @param threshold_in_db: set detection threshold
79         @type threshold_in_db:  float (dB)
80         """
81         self.probe.set_threshold(threshold_in_db)
82     
83         
84     def add_options(normal, expert):
85         """
86         Adds receiver-specific options to the Options Parser
87         """
88         normal.add_option("-v", "--verbose", action="store_true", default=False)
89         expert.add_option("", "--log", action="store_true", default=False,
90                           help="Log all parts of flow graph to files (CAUTION: lots of data)")
91
92     # Make a static method to call before instantiation
93     add_options = staticmethod(add_options)
94
95
96     def _print_verbage(self):
97         """
98         Prints information about the receive path
99         """
100         pass