Houston, we have a trunk.

git-svn-id: http://gnuradio.org/svn/gnuradio/trunk@3122 221aa14e-8319-0410-a670-987f0aec2ac5
author: jcorgan <jcorgan@221aa14e-8319-0410-a670-987f0aec2ac5> 2006-08-03 04:51:51 +0000
committer: jcorgan <jcorgan@221aa14e-8319-0410-a670-987f0aec2ac5> 2006-08-03 04:51:51 +0000
commit: 5d69a524f81f234b3fbc41d49ba18d6f6886baba (patch)
tree: b71312bf7f1e8d10fef0f3ac6f28784065e73e72 /gr-usrp/src/db_basic.py
1 files changed, 252 insertions, 0 deletions
diff --git a/gr-usrp/src/db_basic.py b/gr-usrp/src/db_basic.py
new file mode 100644
index 0000000000..e9139466ef
--- /dev/null
+++ b/gr-usrp/src/db_basic.py
@@ -0,0 +1,252 @@
+#
+# Copyright 2005 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., 59 Temple Place - Suite 330,
+# Boston, MA 02111-1307, USA.
+# 
+
+import sys
+import usrp_dbid
+import db_base
+import db_instantiator
+
+class db_basic_tx(db_base.db_base):
+    def __init__(self, usrp, which):
+        """
+        Handler for Basic Tx daughterboards.
+        
+        @param usrp: instance of usrp.source_c
+        @param which: which side: 0 or 1 corresponding to TX_A or TX_B respectively
+        """
+        # sets _u and _which
+        db_base.db_base.__init__(self, usrp, which)
+
+        if 0:        # Doing this would give us a different default than the historical values...
+            g = self.gain_range()                  # initialize gain
+            self.set_gain(float(g[0]+g[1]) / 2)
+
+
+    def freq_range(self):
+        """
+        Return range of frequencies in Hz that can be tuned by this d'board.
+
+        @returns (min_freq, max_freq, step_size)
+        @rtype tuple
+
+        We say we can do pretty much anything...
+        """
+        return (-90e9, 90e9, 1e-6)
+
+    def set_freq(self, target_freq):
+        """
+        Set the frequency.
+
+        @param freq:  target RF frequency in Hz
+        @type freq:   float
+
+        @returns (ok, actual_baseband_freq) where:
+           ok is True or False and indicates success or failure,
+           actual_baseband_freq is the RF frequency that corresponds to DC in the IF.
+        """
+        return (True, 0)
+
+    def gain_range(self):
+        """
+        Return range of gain that can be set by this d'board.
+
+        @returns (min_gain, max_gain, step_size)
+        Where gains are expressed in decibels (your mileage may vary)
+        """
+        return (self._u.pga_min(), self._u.pga_max(), self._u.pga_db_per_step())
+
+    def set_gain(self, gain):
+        """
+        Set the gain.
+
+        @param gain:  gain in decibels
+        @returns True/False
+        """
+        ok = self._u.set_pga(self._which * 2 + 0, gain)
+        ok = ok and self._u.set_pga(self._which * 2 + 1, gain)
+        return ok
+
+    def is_quadrature(self):
+        """
+        Return True if this board requires both I & Q analog channels.
+        """
+        return True
+    
+
+class db_basic_rx(db_base.db_base):
+    def __init__(self, usrp, which, subdev):
+        """
+        Handler for Basic Rx daughterboards.
+        
+        @param usrp: instance of usrp.source_c
+        @param which: which side: 0 or 1 corresponding to RX_A or RX_B respectively
+        @param subdev: which analog i/o channel: 0 or 1
+        @type subdev: int
+        """
+        # sets _u and _which
+        db_base.db_base.__init__(self, usrp, which)
+        self._subdev = subdev
+
+        self.bypass_adc_buffers(True)
+
+        if 0:        # Doing this would give us a different default than the historical values...
+            g = self.gain_range()                  # initialize gain
+            self.set_gain(float(g[0]+g[1]) / 2)
+
+
+    def freq_range(self):
+        """
+        Return range of frequencies in Hz that can be tuned by this d'board.
+
+        @returns (min_freq, max_freq, step_size)
+        @rtype tuple
+
+        We say we can do pretty much anything...
+        """
+        return (0, 90e9, 1e-6)
+
+    def set_freq(self, target_freq):
+        """
+        Set the frequency.
+
+        @param freq:  target RF frequency in Hz
+        @type freq:   float
+
+        @returns (ok, actual_baseband_freq) where:
+           ok is True or False and indicates success or failure,
+           actual_baseband_freq is the RF frequency that corresponds to DC in the IF.
+        """
+        return (True, 0)
+        
+
+    def gain_range(self):
+        """
+        Return range of gain that can be set by this d'board.
+
+        @returns (min_gain, max_gain, step_size)
+        Where gains are expressed in decibels (your mileage may vary)
+        """
+        return (self._u.pga_min(), self._u.pga_max(), self._u.pga_db_per_step())
+
+    def set_gain(self, gain):
+        """
+        Set the gain.
+
+        @param gain:  gain in decibels
+        @returns True/False
+        """
+        return self._u.set_pga(self._which * 2 + self._subdev, gain)
+
+    def is_quadrature(self):
+        """
+        Return True if this board requires both I & Q analog channels.
+
+        This bit of info is useful when setting up the USRP Rx mux register.
+        """
+        return False
+    
+class db_lf_rx(db_basic_rx):
+    def __init__(self, usrp, which, subdev):
+        """
+        Handler for Low Freq Rx daughterboards.
+        
+        @param usrp: instance of usrp.source_c
+        @param which: which side: 0 or 1 corresponding to RX_A or RX_B respectively
+        @param subdev: which analog i/o channel: 0 or 1
+        @type subdev: int
+        """
+        # sets _u and _which
+        db_basic_rx.__init__(self, usrp, which, subdev)
+
+    def freq_range(self):
+        """
+        Return range of frequencies in Hz that can be tuned by this d'board.
+
+        @returns (min_freq, max_freq, step_size)
+        @rtype tuple
+
+        We cover the first nyquist zone only
+        """
+        return (0, 32e6, 1e-6)
+
+class db_lf_tx(db_basic_tx):
+    def __init__(self, usrp, which):
+        """
+        Handler for Low Freq Tx daughterboards.
+        
+        @param usrp: instance of usrp.source_c
+        @param which: which side: 0 or 1 corresponding to RX_A or RX_B respectively
+        """
+        # sets _u and _which
+        db_basic_tx.__init__(self, usrp, which)
+
+    def freq_range(self):
+        """
+        Return range of frequencies in Hz that can be tuned by this d'board.
+
+        @returns (min_freq, max_freq, step_size)
+        @rtype tuple
+
+        We cover the first nyquist zone only
+        """
+        return (-32e6, 32e6, 1e-6)
+
+
+# hook these daughterboard classes into the auto-instantiation framework
+
+def _basic_rx_instantiator(usrp, which):
+    # two single channel subdevices
+    return (db_basic_rx(usrp, which, 0), db_basic_rx(usrp, which, 1))
+
+def _lf_rx_instantiator(usrp, which):
+    # two single channel subdevices
+    return (db_lf_rx(usrp, which, 0), db_lf_rx(usrp, which, 1))
+
+def _basic_tx_instantiator(usrp, which):
+    # one quadrature subdevice
+    return (db_basic_tx(usrp, which),)
+
+def _lf_tx_instantiator(usrp, which):
+    # one quadrature subdevice
+    return (db_lf_tx(usrp, which),)
+
+def _no_db_instantiator(usrp, which):
+    if hasattr(usrp, 'tx_freq'):   # is this a tx or rx daughterboard?
+        return (_basic_tx_instantiator(usrp, which))
+    else:
+        return (_basic_rx_instantiator(usrp, which))
+    
+def _invalid_instantiator(usrp, which):
+    if hasattr(usrp, 'tx_freq'):   # is this a tx or rx daughterboard?
+        sys.stderr.write('\n\aWarning: Treating daughterboard with invalid EEPROM contents as if it were a "Basic Tx."\n')
+        sys.stderr.write('Warning: This is almost certainly wrong...  Use appropriate burn-*-eeprom utility.\n\n')
+        return _basic_tx_instantiator(usrp, which)
+    else:
+        sys.stderr.write('\n\aWarning: Treating daughterboard with invalid EEPROM contents as if it were a "Basic Rx."\n')
+        sys.stderr.write('Warning: This is almost certainly wrong...  Use appropriate burn-*-eeprom utility.\n\n')
+        return _basic_rx_instantiator(usrp, which)
+
+db_instantiator.add(-1, _no_db_instantiator)                  # no daughterboard
+db_instantiator.add(-2, _invalid_instantiator)                # invalid eeprom contents
+db_instantiator.add(usrp_dbid.BASIC_TX, _basic_tx_instantiator)
+db_instantiator.add(usrp_dbid.BASIC_RX, _basic_rx_instantiator)
+db_instantiator.add(usrp_dbid.LF_TX, _lf_tx_instantiator)
+db_instantiator.add(usrp_dbid.LF_RX, _lf_rx_instantiator)
author	jcorgan <jcorgan@221aa14e-8319-0410-a670-987f0aec2ac5>	2006-08-03 04:51:51 +0000
committer	jcorgan <jcorgan@221aa14e-8319-0410-a670-987f0aec2ac5>	2006-08-03 04:51:51 +0000
commit	5d69a524f81f234b3fbc41d49ba18d6f6886baba (patch)
tree	b71312bf7f1e8d10fef0f3ac6f28784065e73e72 /gr-usrp/src/db_basic.py