diff options
Diffstat (limited to 'gnuradio-examples/python/hier/sounder')
-rw-r--r-- | gnuradio-examples/python/hier/sounder/Makefile.am | 30 | ||||
-rw-r--r-- | gnuradio-examples/python/hier/sounder/sounder_rx.py | 78 | ||||
-rw-r--r-- | gnuradio-examples/python/hier/sounder/sounder_tx.py | 70 | ||||
-rw-r--r-- | gnuradio-examples/python/hier/sounder/usrp_sink.py | 120 | ||||
-rwxr-xr-x | gnuradio-examples/python/hier/sounder/usrp_sounder_rx.py | 69 | ||||
-rwxr-xr-x | gnuradio-examples/python/hier/sounder/usrp_sounder_tx.py | 69 | ||||
-rw-r--r-- | gnuradio-examples/python/hier/sounder/usrp_source.py | 126 |
7 files changed, 562 insertions, 0 deletions
diff --git a/gnuradio-examples/python/hier/sounder/Makefile.am b/gnuradio-examples/python/hier/sounder/Makefile.am new file mode 100644 index 000000000..ecbbb4718 --- /dev/null +++ b/gnuradio-examples/python/hier/sounder/Makefile.am @@ -0,0 +1,30 @@ +# +# Copyright 2007 Free Software Foundation, Inc. +# +# This file is part of GNU Radio +# +# GNU Radio is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2, or (at your option) +# any later version. +# +# GNU Radio is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with GNU Radio; see the file COPYING. If not, write to +# the Free Software Foundation, Inc., 51 Franklin Street, +# Boston, MA 02110-1301, USA. +# + +EXTRA_DIST = \ + usrp_sounder_rx.py \ + usrp_sounder_tx.py \ + usrp_source.py \ + usrp_sink.py \ + sounder_rx.py \ + sounder_tx.py + +MOSTLYCLEANFILES = *.pyc *~ diff --git a/gnuradio-examples/python/hier/sounder/sounder_rx.py b/gnuradio-examples/python/hier/sounder/sounder_rx.py new file mode 100644 index 000000000..6c8154baf --- /dev/null +++ b/gnuradio-examples/python/hier/sounder/sounder_rx.py @@ -0,0 +1,78 @@ +#!/usr/bin/env python +# +# Copyright 2007 Free Software Foundation, Inc. +# +# This file is part of GNU Radio +# +# GNU Radio is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2, or (at your option) +# any later version. +# +# GNU Radio is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with GNU Radio; see the file COPYING. If not, write to +# the Free Software Foundation, Inc., 51 Franklin Street, +# Boston, MA 02110-1301, USA. +# + +from gnuradio import gr, usrp, eng_notation +from usrp_source import usrp_source_c +import math + +n2s = eng_notation.num_to_str + +class sounder_rx(gr.hier_block2): + """ + Creates a top-level channel sounder block with the given parameters. + """ + + def __init__(self, subdev_spec, freq, cal, verbose, max_delay, chip_rate, gain): + + # Call hierarchical block constructor + # Top-level blocks have no inputs or outputs + gr.hier_block2.__init__(self, + "sounder_rx", # Block typename + gr.io_signature(0,0,0), # Input signature + gr.io_signature(0,0,0)) # Output signature + self._freq = freq + self._cal = cal + self._verbose = verbose + self._max_delay = max_delay + + self._u = usrp_source_c(0, subdev_spec, gain, chip_rate, self._freq, self._cal, verbose) + self.define_component("usrp", self._u) + + self._chip_rate = self._u._if_rate + self._resolution = 1.0/self._chip_rate + + min_chips = int(math.ceil(2.0*self._max_delay * self._chip_rate)) + degree = int(math.ceil(math.log(min_chips)/math.log(2))) + self._length = 2**degree-1 + self._seq_per_sec = self._chip_rate/self._length + self._tap = 0.0001 + + if self._verbose: + print "Actual chip rate is", n2s(self._chip_rate), "chips/sec" + print "Resolution is", n2s(self._resolution), "sec" + print "Using specified maximum delay spread of", self._max_delay, "sec" + print "Mininum sequence length needed is", n2s(min_chips), "chips" + print "Using PN sequence of degree", degree, "length", self._length + print "Sequences per second is", self._seq_per_sec + print "IIR tap is", self._tap + + self.define_component("s2v", gr.stream_to_vector(gr.sizeof_gr_complex, self._length)) + self.define_component("fft", gr.fft_vcc(self._length, True, ())) # No window needed + self.define_component("avg", gr.single_pole_iir_filter_cc(self._tap, self._length)) + self.define_component("keep", gr.keep_one_in_n(gr.sizeof_gr_complex*self._length, int(self._seq_per_sec))) + self.define_component("sink", gr.file_sink(gr.sizeof_gr_complex*self._length, "FFT.dat")) + + self.connect("usrp", 0, "s2v", 0) + self.connect("s2v", 0, "fft", 0) + self.connect("fft", 0, "avg", 0) + self.connect("avg", 0, "keep", 0) + self.connect("keep", 0, "sink", 0) diff --git a/gnuradio-examples/python/hier/sounder/sounder_tx.py b/gnuradio-examples/python/hier/sounder/sounder_tx.py new file mode 100644 index 000000000..e6a3e84f8 --- /dev/null +++ b/gnuradio-examples/python/hier/sounder/sounder_tx.py @@ -0,0 +1,70 @@ +#!/usr/bin/env python +# +# Copyright 2007 Free Software Foundation, Inc. +# +# This file is part of GNU Radio +# +# GNU Radio is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2, or (at your option) +# any later version. +# +# GNU Radio is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with GNU Radio; see the file COPYING. If not, write to +# the Free Software Foundation, Inc., 51 Franklin Street, +# Boston, MA 02110-1301, USA. +# + +from gnuradio import gr, usrp, eng_notation +from usrp_sink import usrp_sink_c +import math + +n2s = eng_notation.num_to_str + +class sounder_tx(gr.hier_block2): + """ + Creates a top-level channel sounder block with the given parameters. + """ + + def __init__(self, subdev_spec, freq, cal, verbose, max_delay, chip_rate, amplitude): + + # Call hierarchical block constructor + # Top-level blocks have no inputs or outputs + gr.hier_block2.__init__(self, + "sounder_tx", # Block typename + gr.io_signature(0,0,0), # Input signature + gr.io_signature(0,0,0)) # Output signature + self._freq = freq + self._cal = cal + self._verbose = verbose + self._max_delay = max_delay + + self._u = usrp_sink_c(0, subdev_spec, chip_rate, self._freq, self._cal, verbose) + self._chip_rate = self._u._if_rate + self._resolution = 1.0/self._chip_rate + + min_chips = int(math.ceil(2.0*self._max_delay * self._chip_rate)) + degree = int(math.ceil(math.log(min_chips)/math.log(2))) + self._length = 2**degree-1 + + self._glfsr = gr.glfsr_source_b(degree) + self._mapper = gr.chunks_to_symbols_bc((-amplitude+0j, amplitude+0j), 1) + + if self._verbose: + print "Actual chip rate is", n2s(self._chip_rate), "chips/sec" + print "Resolution is", n2s(self._resolution), "sec" + print "Using specified maximum delay spread of", self._max_delay, "sec" + print "Mininum sequence length needed is", n2s(min_chips), "chips" + print "Using PN sequence of degree", degree, "length", self._length + print "Output amplitude is", amplitude + + self.define_component("glfsr", self._glfsr) + self.define_component("mapper", self._mapper) + self.define_component("usrp", self._u) + self.connect("glfsr", 0, "mapper", 0) + self.connect("mapper", 0, "usrp", 0) diff --git a/gnuradio-examples/python/hier/sounder/usrp_sink.py b/gnuradio-examples/python/hier/sounder/usrp_sink.py new file mode 100644 index 000000000..000b831f5 --- /dev/null +++ b/gnuradio-examples/python/hier/sounder/usrp_sink.py @@ -0,0 +1,120 @@ +#!/usr/bin/env python +# +# Copyright 2007 Free Software Foundation, Inc. +# +# This file is part of GNU Radio +# +# GNU Radio is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2, or (at your option) +# any later version. +# +# GNU Radio is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with GNU Radio; see the file COPYING. If not, write to +# the Free Software Foundation, Inc., 51 Franklin Street, +# Boston, MA 02110-1301, USA. +# + +from gnuradio import gr, usrp, eng_notation +n2s = eng_notation.num_to_str + +# Hierarchical block implementing a USRP sink for complex floats, +# with convenience functions for tuning, interpolation, etc. +# +class usrp_sink_c(gr.hier_block2): + """ + Create a USRP sink object accepting complex floats. + """ + def __init__(self, which=0, subdev_spec=None, if_rate=None, + freq=0.0, calibration=0.0, verbose=False): + # Call hierarchical block constructor + gr.hier_block2.__init__(self, + "usrp_sink_c", # Block typename + gr.io_signature(1,1,gr.sizeof_gr_complex), # Input signature + gr.io_signature(0,0,0)) # Output signature + + self._verbose = verbose + self._u = usrp.sink_c(which) + if self._verbose: + print 'DAC sample rate is', n2s(self._u.dac_rate()), "sps" + self.set_subdev(subdev_spec) + self.set_if_rate(if_rate) + self.set_calibration(calibration) + self.tune(freq) + + self.define_component("usrp", self._u) + self.connect("self", 0, "usrp", 0) + + + def set_subdev(self, subdev_spec): + if subdev_spec is None: + subdev_spec = self.pick_subdevice() + self._subdev = usrp.selected_subdev(self._u, subdev_spec) + self._u.set_mux(usrp.determine_tx_mux_value(self._u, subdev_spec)) + if self._verbose: + print 'TX using', self._subdev.name(), 'daughterboard' + + def pick_subdevice(self): + """ + The user didn't specify a subdevice. + If there's a daughterboard on A, select A. + If there's a daughterboard on B, select B. + Otherwise, select A. + """ + if self._u.db[0][0].dbid() >= 0: # dbid is < 0 if there's no d'board or a problem + return (0, 0) + if self._u.db[1][0].dbid() >= 0: + return (1, 0) + return (0, 0) + + def set_if_rate(self, if_rate): + # If no IF rate specified, set to maximum interpolation + if if_rate is None: + self._interp = 512 + else: + self._interp = 4*int(self._u.dac_rate()/(4.0*if_rate)+0.5) + + + self._if_rate = self._u.dac_rate()/self._interp + self._u.set_interp_rate(self._interp) + + if self._verbose: + print "USRP interpolation rate is", self._interp + print "USRP IF rate is", n2s(self._if_rate), "sps" + + def set_calibration(self, calibration): + self._cal = calibration + if self._verbose: + print "Using frequency calibration offset of", n2s(calibration), "Hz" + + def tune(self, freq): + """ + Set the center frequency we're interested in. + + @param target_freq: frequency in Hz + @type: bool + + Tuning is a two step process. First we ask the front-end to + tune as close to the desired frequency as it can. Then we use + the result of that operation and our target_frequency to + determine the value for the digital down converter. + """ + self._tune_result = self._u.tune(self._subdev._which, self._subdev, freq+self._cal) + if self._tune_result: + if self._verbose: + print "Baseband frequency is", n2s(self._tune_result.baseband_freq), "Hz" + print "DXC frequency is", n2s(self._tune_result.dxc_freq), "Hz" + print "Center frequency is", n2s(freq), "Hz" + print "Residual frequency is", n2s(self._tune_result.residual_freq), "Hz" + return True + + return False + +if __name__ == '__main__': + sink = usrp_sink_c(verbose=True) + diff --git a/gnuradio-examples/python/hier/sounder/usrp_sounder_rx.py b/gnuradio-examples/python/hier/sounder/usrp_sounder_rx.py new file mode 100755 index 000000000..dd8007cbb --- /dev/null +++ b/gnuradio-examples/python/hier/sounder/usrp_sounder_rx.py @@ -0,0 +1,69 @@ +#!/usr/bin/env python +# +# Copyright 2007 Free Software Foundation, Inc. +# +# This file is part of GNU Radio +# +# GNU Radio is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2, or (at your option) +# any later version. +# +# GNU Radio is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with GNU Radio; see the file COPYING. If not, write to +# the Free Software Foundation, Inc., 51 Franklin Street, +# Boston, MA 02110-1301, USA. +# + +from gnuradio import gr, eng_notation +from gnuradio.eng_option import eng_option +from optparse import OptionParser +from sounder_rx import sounder_rx + +def main(): + parser = OptionParser(option_class=eng_option) + + # Receive path options + parser.add_option("-R", "--rx-subdev-spec", type="subdev", default=None, + help="select USRP Rx side A or B (default=first found)") + parser.add_option("-f", "--freq", type="eng_float", default=0.0, + help="set center frequency (default=%default)") + parser.add_option("-c", "--cal", type="eng_float", default=0.0, + help="set frequency calibration offset (default=%default)") + parser.add_option("-v", "--verbose", action="store_true", default=False, + help="print extra debugging info") + parser.add_option("-d", "--max-delay", type="eng_float", default=10e-6, + help="set maximum delay spread (default=%default)") + parser.add_option("-r", "--chip-rate", type="eng_float", default=8e6, + help="set sounder chip rate (default=%default)") + parser.add_option("-g", "--gain", type="eng_float", default=None, + help="set output amplitude (default=%default)") + (options, args) = parser.parse_args() + + if len(args) != 0: + parser.print_help() + sys.exit(1) + + # Create an instance of a hierarchical block + top_block = sounder_rx(options.rx_subdev_spec, options.freq, options.cal, + options.verbose, options.max_delay, options.chip_rate, + options.gain) + + # Create an instance of a runtime, passing it the top block + # to process + runtime = gr.runtime(top_block) + + try: + # Run forever + runtime.run() + except KeyboardInterrupt: + # Ctrl-C exits + pass + +if __name__ == '__main__': + main () diff --git a/gnuradio-examples/python/hier/sounder/usrp_sounder_tx.py b/gnuradio-examples/python/hier/sounder/usrp_sounder_tx.py new file mode 100755 index 000000000..c96313c67 --- /dev/null +++ b/gnuradio-examples/python/hier/sounder/usrp_sounder_tx.py @@ -0,0 +1,69 @@ +#!/usr/bin/env python +# +# Copyright 2007 Free Software Foundation, Inc. +# +# This file is part of GNU Radio +# +# GNU Radio is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2, or (at your option) +# any later version. +# +# GNU Radio is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with GNU Radio; see the file COPYING. If not, write to +# the Free Software Foundation, Inc., 51 Franklin Street, +# Boston, MA 02110-1301, USA. +# + +from gnuradio import gr, eng_notation +from gnuradio.eng_option import eng_option +from optparse import OptionParser +from sounder_tx import sounder_tx + +def main(): + parser = OptionParser(option_class=eng_option) + + # Transmit path options + parser.add_option("-T", "--tx-subdev-spec", type="subdev", default=None, + help="select USRP Rx side A or B (default=first found)") + parser.add_option("-f", "--freq", type="eng_float", default=0.0, + help="set center frequency (default=%default)") + parser.add_option("-c", "--cal", type="eng_float", default=0.0, + help="set frequency calibration offset (default=%default)") + parser.add_option("-v", "--verbose", action="store_true", default=False, + help="print extra debugging info") + parser.add_option("-d", "--max-delay", type="eng_float", default=10e-6, + help="set maximum delay spread (default=%default)") + parser.add_option("-r", "--chip-rate", type="eng_float", default=8e6, + help="set sounder chip rate (default=%default)") + parser.add_option("-g", "--amplitude", type="eng_float", default=32000.0, + help="set output amplitude (default=%default)") + (options, args) = parser.parse_args() + + if len(args) != 0: + parser.print_help() + sys.exit(1) + + # Create an instance of a hierarchical block + top_block = sounder_tx(options.tx_subdev_spec, options.freq, options.cal, + options.verbose, options.max_delay, options.chip_rate, + options.amplitude) + + # Create an instance of a runtime, passing it the top block + # to process + runtime = gr.runtime(top_block) + + try: + # Run forever + runtime.run() + except KeyboardInterrupt: + # Ctrl-C exits + pass + +if __name__ == '__main__': + main () diff --git a/gnuradio-examples/python/hier/sounder/usrp_source.py b/gnuradio-examples/python/hier/sounder/usrp_source.py new file mode 100644 index 000000000..16949998b --- /dev/null +++ b/gnuradio-examples/python/hier/sounder/usrp_source.py @@ -0,0 +1,126 @@ +#!/usr/bin/env python +# +# Copyright 2007 Free Software Foundation, Inc. +# +# This file is part of GNU Radio +# +# GNU Radio is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2, or (at your option) +# any later version. +# +# GNU Radio is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with GNU Radio; see the file COPYING. If not, write to +# the Free Software Foundation, Inc., 51 Franklin Street, +# Boston, MA 02110-1301, USA. +# + +from gnuradio import gr, usrp, eng_notation +n2s = eng_notation.num_to_str + +# Hierarchical block implementing a USRP source for complex floats, +# with convenience functions for gain, tune, decimation, etc. +# +class usrp_source_c(gr.hier_block2): + """ + Create a USRP source object supplying complex floats. + """ + def __init__(self, which=0, subdev_spec=None, gain=None, if_rate=None, + freq=0.0, calibration=0.0, verbose=False): + # Call hierarchical block constructor + gr.hier_block2.__init__(self, + "usrp_source_c", # Block typename + gr.io_signature(0,0,0), # Input signature + gr.io_signature(1,1,gr.sizeof_gr_complex)) # Output signature + + self._verbose = verbose + self._u = usrp.source_c(which) + if self._verbose: + print 'ADC sample rate is', n2s(self._u.adc_rate()), "sps" + self.set_subdev(subdev_spec) + self.set_if_rate(if_rate) + self.set_gain(gain) + self.set_calibration(calibration) + self.tune(freq) + + self.define_component("usrp", self._u) + self.connect("usrp", 0, "self", 0) + + def set_subdev(self, subdev_spec): + if subdev_spec is None: + subdev_spec = self.pick_subdevice() + self._subdev = usrp.selected_subdev(self._u, subdev_spec) + self._u.set_mux(usrp.determine_rx_mux_value(self._u, subdev_spec)) + if self._verbose: + print 'RX using', self._subdev.name(), 'daughterboard' + + def pick_subdevice(self): + """ + The user didn't specify a subdevice. + If there's a daughterboard on A, select A. + If there's a daughterboard on B, select B. + Otherwise, select A. + """ + if self._u.db[0][0].dbid() >= 0: # dbid is < 0 if there's no d'board or a problem + return (0, 0) + if self._u.db[1][0].dbid() >= 0: + return (1, 0) + return (0, 0) + + def set_if_rate(self, if_rate): + # If no IF rate specified, set to maximum decimation + if if_rate is None: + self._decim = 256 + else: + self._decim = int(self._u.adc_rate()/if_rate) + + self._u.set_decim_rate(self._decim) + self._if_rate = self._u.adc_rate()/self._decim + + if self._verbose: + print "USRP decimation rate is", self._decim + print "USRP IF rate is", n2s(self._if_rate), "sps" + + def set_gain(self, gain): + # If no gain specified, set to midrange + if gain is None: + g = self._subdev.gain_range() + gain = (g[0]+g[1])/2.0 + self._gain = gain + self._subdev.set_gain(self._gain) + + def set_calibration(self, calibration): + self._cal = calibration + if self._verbose: + print "Using frequency calibration offset of", n2s(calibration), "Hz" + + def tune(self, freq): + """ + Set the center frequency we're interested in. + + @param target_freq: frequency in Hz + @type: bool + + Tuning is a two step process. First we ask the front-end to + tune as close to the desired frequency as it can. Then we use + the result of that operation and our target_frequency to + determine the value for the digital down converter. + """ + self._tune_result = usrp.tune(self._u, 0, self._subdev, freq+self._cal) + if self._tune_result: + if self._verbose: + print "Baseband frequency is", n2s(self._tune_result.baseband_freq), "Hz" + print "DXC frequency is", n2s(self._tune_result.dxc_freq), "Hz" + print "Center frequency is", n2s(freq), "Hz" + print "Residual frequency is", n2s(self._tune_result.residual_freq), "Hz" + return True + + return False + +if __name__ == '__main__': + src = usrp_source_c(verbose=True) |