Merge r6461:6464 from jcorgan/t162-staging into trunk.
[debian/gnuradio] / gnuradio-examples / python / digital / transmit_path_lb.py
1 #
2 # Copyright 2005, 2006, 2007 Free Software Foundation, Inc.
3
4 # This file is part of GNU Radio
5
6 # GNU Radio is free software; you can redistribute it and/or modify
7 # it under the terms of the GNU General Public License as published by
8 # the Free Software Foundation; either version 3, or (at your option)
9 # any later version.
10
11 # GNU Radio is distributed in the hope that it will be useful,
12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 # GNU General Public License for more details.
15
16 # You should have received a copy of the GNU General Public License
17 # along with GNU Radio; see the file COPYING.  If not, write to
18 # the Free Software Foundation, Inc., 51 Franklin Street,
19 # Boston, MA 02110-1301, USA.
20
21
22 from gnuradio import gr, gru, blks2
23 from gnuradio import eng_notation
24
25 import copy
26 import sys
27
28 # /////////////////////////////////////////////////////////////////////////////
29 #                              transmit path
30 # /////////////////////////////////////////////////////////////////////////////
31
32 class transmit_path(gr.hier_block2):
33     def __init__(self, modulator_class, options):
34         '''
35         See below for what options should hold
36         '''
37         gr.hier_block2.__init__(self, "transmit_path",
38                                 gr.io_signature(0, 0, 0),                    # Input signature
39                                 gr.io_signature(1, 1, gr.sizeof_gr_complex)) # Output signature
40         
41         options = copy.copy(options)    # make a copy so we can destructively modify
42
43         self._verbose            = options.verbose
44         self._tx_amplitude       = options.tx_amplitude    # digital amplitude sent to USRP
45         self._bitrate            = options.bitrate         # desired bit rate
46         self._samples_per_symbol = options.samples_per_symbol  # desired samples/baud
47
48         self._modulator_class = modulator_class         # the modulator_class we are using
49
50         # Get mod_kwargs
51         mod_kwargs = self._modulator_class.extract_kwargs_from_options(options)
52     
53         # transmitter
54         print self._modulator_class
55         print mod_kwargs
56         modulator = self._modulator_class(**mod_kwargs)
57         self.packet_transmitter = \
58             blks2.mod_pkts(modulator,
59                            access_code=None,
60                            msgq_limit=4,
61                            pad_for_usrp=True)
62
63         self.amp = gr.multiply_const_cc(1)
64         self.set_tx_amplitude(self._tx_amplitude)
65
66         # Display some information about the setup
67         if self._verbose:
68             self._print_verbage()
69
70         # Connect components in the flowgraph
71         self.connect(self.packet_transmitter, self.amp, self)
72
73     def set_tx_amplitude(self, ampl):
74         """
75         Sets the transmit amplitude sent to the USRP
76         @param: ampl 0 <= ampl < 32768.  Try 8000
77         """
78         self._tx_amplitude = max(0.0, min(ampl, 32767.0))
79         self.amp.set_k(self._tx_amplitude)
80         
81     def send_pkt(self, payload='', eof=False):
82         """
83         Calls the transmitter method to send a packet
84         """
85         return self.packet_transmitter.send_pkt(payload, eof)
86         
87     def bitrate(self):
88         return self._bitrate
89
90     def samples_per_symbol(self):
91         return self._samples_per_symbol
92
93     def add_options(normal, expert):
94         """
95         Adds transmitter-specific options to the Options Parser
96         """
97         if not normal.has_option('--bitrate'):
98             normal.add_option("-r", "--bitrate", type="eng_float", default=100e3,
99                               help="specify bitrate [default=%default].")
100         normal.add_option("", "--tx-amplitude", type="eng_float", default=12000, metavar="AMPL",
101                           help="set transmitter digital amplitude: 0 <= AMPL < 32768 [default=%default]")
102         normal.add_option("-v", "--verbose", action="store_true", default=False)
103
104         expert.add_option("-S", "--samples-per-symbol", type="int", default=2,
105                           help="set samples/symbol [default=%default]")
106         expert.add_option("", "--log", action="store_true", default=False,
107                           help="Log all parts of flow graph to file (CAUTION: lots of data)")
108
109     # Make a static method to call before instantiation
110     add_options = staticmethod(add_options)
111
112     def _print_verbage(self):
113         """
114         Prints information about the transmit path
115         """
116         print "Tx amplitude     %s"    % (self._tx_amplitude)
117         print "modulation:      %s"    % (self._modulator_class.__name__)
118         print "bitrate:         %sb/s" % (eng_notation.num_to_str(self._bitrate))
119         print "samples/symbol:  %3d"   % (self._samples_per_symbol)
120