Changeset 9733

Show
Ignore:
Timestamp:
10/07/08 17:07:37
Author:
eb
Message:

Rolled feature branch mods into a new copy of trunk.
Merged 9655:9732 of features/cppdb into eb/updated-cppdb.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • gnuradio/branches/developers/eb/updated-cppdb/config/grc_gnuradio_examples.m4

    r9569 r9733  
    2727        gnuradio-examples/Makefile \ 
    2828        gnuradio-examples/c++/Makefile \ 
     29        gnuradio-examples/c++/dial_tone/Makefile \ 
     30        gnuradio-examples/c++/usrp_test/Makefile \ 
    2931        gnuradio-examples/python/Makefile \ 
    3032        gnuradio-examples/python/apps/hf_explorer/Makefile \ 

  • gnuradio/branches/developers/eb/updated-cppdb/gnuradio-examples/c++/Makefile.am

    r6187 r9733  
    11# 
    2 # Copyright 2006 Free Software Foundation, Inc. 
     2# Copyright 2006,2008 Free Software Foundation, Inc. 
    33#  
    44# This file is part of GNU Radio 
    …… 
    2121 
    2222include $(top_srcdir)/Makefile.common 
    23 # SUBDIRS = dial_tone  
     23SUBDIRS = dial_tone usrp_test 

  • gnuradio/branches/developers/eb/updated-cppdb/gr-usrp/src

    • Property svn:ignore changed from Makefile Makefile.in .la .lo .deps .libs *.la *.lo usrp0.cc usrp0.h usrp1.h usrp1.cc usrp1.py usrp0.py run_tests usrp_dbids.py *.pyc to Makefile Makefile.in .la .lo .deps .libs *.la *.lo usrp0.cc usrp0.h usrp1.h usrp1.cc usrp1.py usrp0.py usrp.py run_tests usrp_dbids.py *.pyc

  • gnuradio/branches/developers/eb/updated-cppdb/gr-usrp/src/Makefile.am

    r9396 r9733  
    3232TESTS = run_tests 
    3333 
    34 LOCAL_IFILES =                          \ 
    35         $(top_srcdir)/gr-usrp/src/usrp1.i                                
     34LOCAL_IFILES =          \ 
     35        usrp1.i         \ 
     36        usrp1_base.i    \ 
     37        usrp1_source.i  \ 
     38        usrp1_sink.i 
    3639 
    3740NON_LOCAL_IFILES = $(GNURADIO_I) 
    …… 
    4346BUILT_SOURCES =                         \ 
    4447        usrp1.cc                        \ 
    45         usrp1.py                       
     48        usrp.py        
    4649 
    4750ourpython_PYTHON =                      \ 
    48         db_base.py                      \ 
    49         db_basic.py                     \ 
    50         db_dbs_rx.py                    \ 
    51         db_flexrf.py                    \ 
    52         db_flexrf_mimo.py               \ 
    53         db_wbx.py                       \ 
    54         db_xcvr2450.py                  \ 
    55         db_instantiator.py              \ 
    56         db_tv_rx.py                     \ 
    57         db_dtt754.py                    \ 
    58         db_dtt768.py                    \ 
    59         flexrf_debug_gui.py             \ 
    60         tx_debug_gui.py                 \ 
    61         usrp.py                         \ 
    62         usrp1.py                        \ 
    63         usrp_multi.py                    
    64  
     51        usrp.py 
    6552 
    6653AM_CPPFLAGS = $(STD_DEFINES_AND_INCLUDES)  \ 
    …… 
    7663 
    7764grinclude_HEADERS =                     \ 
     65        usrp1_base.h                    \ 
    7866        usrp1_sink_base.h               \ 
    7967        usrp1_sink_c.h                  \ 
    …… 
    8169        usrp1_source_base.h             \ 
    8270        usrp1_source_c.h                \ 
    83         usrp1_source_s.h                
     71        usrp1_source_s.h 
    8472 
    85 swiginclude_HEADERS =                   \ 
    86         $(LOCAL_IFILES) 
    87  
    88  
    89 ourlib_LTLIBRARIES = _usrp1.la 
    90  
    91  
    92 _usrp1_la_SOURCES =                     \ 
    93         usrp1.cc                        \ 
     73USRP_SOURCES =                          \ 
     74        usrp1_base.cc                   \ 
    9475        usrp1_sink_base.cc              \ 
    9576        usrp1_sink_c.cc                 \ 
    …… 
    9778        usrp1_source_base.cc            \ 
    9879        usrp1_source_c.cc               \ 
    99         usrp1_source_s.cc               
     80        usrp1_source_s.cc 
    10081 
     82swiginclude_HEADERS =                   \ 
     83        $(LOCAL_IFILES) 
    10184 
    102 _usrp1_la_LIBADD =                      \ 
     85ourlib_LTLIBRARIES =                    \ 
     86        _usrp.la 
     87 
     88_usrp_la_SOURCES =                      \ 
     89        usrp1.cc                        \ 
     90        $(USRP_SOURCES) 
     91 
     92_usrp_la_LIBADD =                       \ 
    10393        $(PYTHON_LDFLAGS)               \ 
    10494        $(GNURADIO_CORE_LA)             \ 
    …… 
    10696        -lstdc++ 
    10797 
     98_usrp_la_LDFLAGS = $(NO_UNDEFINED) -module -avoid-version 
    10899 
    109 _usrp1_la_LDFLAGS = $(NO_UNDEFINED) -module -avoid-version 
     100_usrp_la_CXXFLAGS = @swig_CXXFLAGS@ 
    110101 
    111 _usrp1_la_CXXFLAGS = @swig_CXXFLAGS@ 
    112  
    113 usrp1.cc usrp1.py: usrp1.i $(NON_LOCAL_IFILES) $(LOCAL_IFILES) 
    114         $(SWIG) $(SWIGPYTHONARGS) -module usrp1 -o usrp1.cc $(LOCAL_IFILES) 
     102usrp1.cc usrp.py: $(NON_LOCAL_IFILES) $(LOCAL_IFILES) 
     103        $(SWIG) $(SWIGPYTHONARGS) -module usrp -o usrp1.cc $(srcdir)/usrp1.i 
    115104 
    116105 
    117 noinst_PYTHON =                         \ 
     106lib_LTLIBRARIES = libusrp1.la 
     107libusrp1_la_SOURCES = $(USRP_SOURCES) 
     108libusrp1_la_LDFLAGS = $(NO_UNDEFINED) -version-info 0:0:0 
     109libusrp1_la_LIBADD  = $(_usrp_la_LIBADD) 
     110 
     111 
     112noinst_PYTHON = \ 
    118113        qa_usrp.py                       
    119114 
    …… 
    122117 
    123118 
     119 
    124120# Don't distribute output of swig 
    125121dist-hook: 

  • gnuradio/branches/developers/eb/updated-cppdb/gr-usrp/src/qa_usrp.py

    r7045 r9733  
    2222 
    2323from gnuradio import gr, gr_unittest 
    24 import usrp1 
     24import usrp 
    2525 
    2626class qa_usrp (gr_unittest.TestCase): 

  • gnuradio/branches/developers/eb/updated-cppdb/gr-usrp/src/usrp1.i

    r6465 r9733  
    11/* -*- c++ -*- */ 
    22/* 
    3  * Copyright 2004 Free Software Foundation, Inc. 
     3 * Copyright 2004,2008 Free Software Foundation, Inc. 
    44 *  
    55 * This file is part of GNU Radio 
    …… 
    2727 
    2828%{ 
    29  
    3029#include "gnuradio_swig_bug_workaround.h"       // mandatory bug fix 
     30#include "usrp1_base.h" 
     31#include "usrp1_source_base.h" 
     32#include "usrp1_source_c.h" 
     33#include "usrp1_source_s.h" 
     34#include "usrp1_sink_base.h" 
    3135#include "usrp1_sink_c.h" 
    3236#include "usrp1_sink_s.h" 
    33 #include "usrp1_source_c.h" 
    34 #include "usrp1_source_s.h" 
     37#include "usrp_standard.h" 
     38#include "usrp_spi_defs.h" 
     39#include <db_base.h> 
    3540#include <stdexcept> 
    36 #include <usrp_standard.h> 
    37 #include <usrp_spi_defs.h> 
    3841%} 
    3942 
    4043%include <usrp_spi_defs.h> 
     44%include <usrp1_base.i> 
     45%include <usrp1_source.i> 
     46%include <usrp1_sink.i> 
     47 
     48%include <db_base.i> 
    4149 
    4250%constant int FPGA_MODE_NORMAL   = usrp_standard_rx::FPGA_MODE_NORMAL; 
    …… 
    4452%constant int FPGA_MODE_COUNTING = usrp_standard_rx::FPGA_MODE_COUNTING; 
    4553 
    46 // ================================================================ 
    47 //                         abstract classes 
    48 // ================================================================ 
    4954 
    50 class usrp1_sink_base : public gr_sync_block { 
    51 protected: 
    52   usrp1_sink_base (const std::string &name, 
    53                    gr_io_signature_sptr input_signature, 
    54                    int which_board, 
    55                    unsigned int interp_rate, 
    56                    int nchan, 
    57                    int mux, 
    58                    int fusb_block_size, 
    59                    int fusb_nblocks, 
    60                    const std::string fpga_filename, 
    61                    const std::string firmware_filename 
    62                    ) throw (std::runtime_error); 
     55%pythoncode %{ 
     56  import re 
     57  def selected_subdev(u, spec): 
     58      return u.selected_subdev(spec) 
     59  def determine_rx_mux_value(u, spec): 
     60      return u.determine_rx_mux_value(spec) 
     61  def determine_tx_mux_value(u, spec): 
     62      return u.determine_tx_mux_value(spec) 
    6363 
    64   virtual void copy_to_usrp_buffer (gr_vector_const_void_star &input_items, 
    65                                     int  input_index, 
    66                                     int  input_items_available, 
    67                                     int  &input_items_consumed, 
    68                                     void *usrp_buffer, 
    69                                     int  usrp_buffer_length, 
    70                                     int  &bytes_written) = 0; 
    71  public: 
    72   ~usrp1_sink_base (); 
     64  # This fakes out the source_c(*args) that swig generates and adds **kwargs to it. 
     65  # I wish I knew a cleaner way to convert the list, but I dont. 
     66  # This problem might be fixable by using the "-keyword" option passed to swig during compile time. 
     67  # However, this function is not well documented and can cause errors with overloaded function 
     68  # (like in shared_ptr.i). While this is kludgey, it solves the keyword argument problem. 
    7369 
    74   /*! 
    75    * \brief Set interpolator rate.  \p rate must be in [4, 1024] and a multiple of 4. 
    76    * 
    77    * The final complex sample rate across the USB is 
    78    *   dac_freq () * nchannels () / interp_rate () 
    79    */ 
    80   bool set_interp_rate (unsigned int rate); 
    81   bool set_nchannels (int nchan); 
    82   bool set_mux (int mux); 
     70  def process_args(argslist): 
     71    # process the doc string to get the argument names and default values 
     72    p = re.compile("\w+=\S*") 
     73    m = p.findall(argslist) 
     74    argslist = list() 
     75    argsvals = list() 
     76    for val in m: 
     77      key = val.split("=")[0] 
     78      value = val.split("=")[1].strip(",)") 
     79      try: 
     80        v = int(value) 
     81      except ValueError: # convert the hex value 
     82        try: 
     83          v = int(value,16) 
     84        except ValueError, e: 
     85          v = value.strip("\"") 
     86      argslist.append(key) 
     87      argsvals.append(v) 
    8388 
    84   /*! 
    85    * \brief set the frequency of the digital up converter. 
    86    * 
    87    * \p channel must be 0 or 1.  \p freq is the center frequency in Hz. 
    88    * It must be in the range [-44M, 44M].  The frequency specified is 
    89    * quantized.  Use tx_freq to retrieve the actual value used. 
    90    */ 
    91   bool set_tx_freq (int channel, double freq); 
     89    return (argslist, argsvals) 
    9290 
    93   void set_verbose (bool verbose); 
     91  def source_c(*args, **kwargs): 
     92    constructor_args = _usrp.source_c.__doc__ 
     93    constructor_args = constructor_args.split("->")[0] 
     94    argslist, argsvals = process_args(constructor_args) 
     95    i = 0 
     96    for a in argslist: 
     97        if(kwargs.has_key(a)): 
     98            argsvals[i] = kwargs[a] 
     99        i += 1 
     100    return _usrp.source_c(*argsvals) 
     101  
     102  def source_s(*args, **kwargs): 
     103    constructor_args = _usrp.source_s.__doc__ 
     104    constructor_args = constructor_args.split("->")[0] 
     105    argslist, argsvals = process_args(constructor_args) 
     106    i = 0 
     107    for a in argslist: 
     108        if(kwargs.has_key(a)): 
     109            argsvals[i] = kwargs[a] 
     110        i += 1 
     111    return _usrp.source_s(*argsvals) 
    94112 
    95   // ACCESSORS 
     113  def sink_c(*args, **kwargs): 
     114    constructor_args = _usrp.sink_c.__doc__ 
     115    constructor_args = constructor_args.split("->")[0] 
     116    argslist, argsvals = process_args(constructor_args) 
     117    i = 0 
     118    for a in argslist: 
     119        if(kwargs.has_key(a)): 
     120            argsvals[i] = kwargs[a] 
     121        i += 1 
     122    return _usrp.sink_c(*argsvals) 
    96123 
    97   long fpga_master_clock_freq() const; 
    98   long converter_rate() const;      // D/A sample rate 
    99   long dac_rate() const;            // alias 
    100   long dac_freq () const;           // deprecated name.  Use converter_rate() or dac_rate(). 
    101  
    102   unsigned int interp_rate () const; 
    103   double tx_freq (int channel) const; 
    104   int nunderruns () const { return d_nunderruns; } 
    105  
    106   /*! 
    107    * \brief Set Programmable Gain Amplifier (PGA) 
    108    * 
    109    * \param which       which D/A [0,3] 
    110    * \param gain_in_db  gain value (linear in dB) 
    111    * 
    112    * gain is rounded to closest setting supported by hardware. 
    113    * Note that DAC 0 and DAC 1 share a gain setting as do DAC 2 and DAC 3. 
    114    * Setting DAC 0 affects DAC 1 and vice versa.  Same with DAC 2 and DAC 3. 
    115    * 
    116    * \returns true iff sucessful. 
    117    * 
    118    * \sa pga_min(), pga_max(), pga_db_per_step() 
    119    */ 
    120   bool set_pga (int which, double gain_in_db); 
    121  
    122   /*! 
    123    * \brief Return programmable gain amplifier gain in dB. 
    124    * 
    125    * \param which       which D/A [0,3] 
    126    */ 
    127   double pga (int which) const; 
    128  
    129   /*! 
    130    * \brief Return minimum legal PGA gain in dB. 
    131    */ 
    132   double pga_min () const; 
    133  
    134   /*! 
    135    * \brief Return maximum legal PGA gain in dB. 
    136    */ 
    137   double pga_max () const; 
    138  
    139   /*! 
    140    * \brief Return hardware step size of PGA (linear in dB). 
    141    */ 
    142   double pga_db_per_step () const; 
    143  
    144   /*! 
    145    * \brief Return daughterboard ID for given Tx daughterboard slot [0,1]. 
    146    * 
    147    * \return daughterboard id >= 0 if successful 
    148    * \return -1 if no daugherboard 
    149    * \return -2 if invalid EEPROM on daughterboard 
    150    */ 
    151   int daughterboard_id (int which_dboard) const; 
    152  
    153   /*! 
    154    * \brief Set ADC offset correction 
    155    * \param which       which ADC[0,3]: 0 = RX_A I, 1 = RX_A Q... 
    156    * \param offset      16-bit value to subtract from raw ADC input. 
    157    */ 
    158   bool set_adc_offset (int which, int offset); 
    159  
    160   /*! 
    161    * \brief Set DAC offset correction 
    162    * \param which       which DAC[0,3]: 0 = TX_A I, 1 = TX_A Q... 
    163    * \param offset      10-bit offset value (ambiguous format:  See AD9862 datasheet). 
    164    * \param offset_pin  1-bit value.  If 0 offset applied to -ve differential pin; 
    165    *                                  If 1 offset applied to +ve differential pin. 
    166    */ 
    167   bool set_dac_offset (int which, int offset, int offset_pin); 
    168  
    169   /*! 
    170    * \brief Control ADC input buffer 
    171    * \param which       which ADC[0,3] 
    172    * \param bypass      if non-zero, bypass input buffer and connect input 
    173    *                    directly to switched cap SHA input of RxPGA. 
    174    */ 
    175   bool set_adc_buffer_bypass (int which, bool bypass); 
    176  
    177   /*! 
    178    * \brief return the usrp's serial number. 
    179    * 
    180    * \returns non-zero length string iff successful. 
    181    */ 
    182   std::string serial_number(); 
    183  
    184   /*! 
    185    * \brief Write direction register (output enables) for pins that go to daughterboard. 
    186    * 
    187    * \param which_dboard        [0,1] which d'board 
    188    * \param value               value to write into register 
    189    * \param mask                which bits of value to write into reg 
    190    * 
    191    * Each d'board has 16-bits of general purpose i/o. 
    192    * Setting the bit makes it an output from the FPGA to the d'board. 
    193    * 
    194    * This register is initialized based on a value stored in the 
    195    * d'board EEPROM.  In general, you shouldn't be using this routine 
    196    * without a very good reason.  Using this method incorrectly will 
    197    * kill your USRP motherboard and/or daughterboard. 
    198    */ 
    199   bool _write_oe (int which_dboard, int value, int mask); 
    200  
    201   /*! 
    202    * \brief Write daughterboard i/o pin value 
    203    * 
    204    * \param which_dboard        [0,1] which d'board 
    205    * \param value               value to write into register 
    206    * \param mask                which bits of value to write into reg 
    207    */ 
    208   bool write_io (int which_dboard, int value, int mask); 
    209  
    210   /*! 
    211    * \brief Read daughterboard i/o pin value 
    212    * 
    213    * \param which_dboard        [0,1] which d'board 
    214    * \returns register value if successful, else READ_FAILED 
    215    */ 
    216   int read_io (int which_dboard); 
    217  
    218   bool write_aux_dac (int which_dboard, int which_dac, int value); 
    219   int read_aux_adc (int which_dboard, int which_adc); 
    220   bool write_eeprom (int i2c_addr, int eeprom_offset, const std::string buf); 
    221   std::string read_eeprom (int i2c_addr, int eeprom_offset, int len); 
    222   bool write_i2c (int i2c_addr, const std::string buf); 
    223   std::string read_i2c (int i2c_addr, int len); 
    224  
    225   bool _write_fpga_reg (int regno, int value);  //< 7-bit regno, 32-bit value 
    226   int  _read_fpga_reg (int regno); 
    227   bool _write_9862 (int which_codec, int regno, unsigned char value); 
    228   int  _read_9862 (int which_codec, int regno) const; 
    229  
    230   /*! 
    231    * \brief Write data to SPI bus peripheral. 
    232    * 
    233    * \param optional_header     0,1 or 2 bytes to write before buf. 
    234    * \param enables             bitmask of peripherals to write. See usrp_spi_defs.h 
    235    * \param format              transaction format.  See usrp_spi_defs.h SPI_FMT_* 
    236    * \param buf                 the data to write 
    237    * \returns true iff successful 
    238    * Writes are limited to a maximum of 64 bytes. 
    239    * 
    240    * If \p format specifies that optional_header bytes are present, they are 
    241    * written to the peripheral immediately prior to writing \p buf. 
    242    */ 
    243   bool _write_spi (int optional_header, int enables, int format, std::string buf); 
    244  
    245   /* 
    246    * \brief Read data from SPI bus peripheral. 
    247    * 
    248    * \param optional_header     0,1 or 2 bytes to write before buf. 
    249    * \param enables             bitmask of peripheral to read. See usrp_spi_defs.h 
    250    * \param format              transaction format.  See usrp_spi_defs.h SPI_FMT_* 
    251    * \param len                 number of bytes to read.  Must be in [0,64]. 
    252    * \returns the data read if sucessful, else a zero length string. 
    253    * 
    254    * Reads are limited to a maximum of 64 bytes. 
    255    * 
    256    * If \p format specifies that optional_header bytes are present, they 
    257    * are written to the peripheral first.  Then \p len bytes are read from 
    258    * the peripheral and returned. 
    259    */ 
    260   std::string _read_spi (int optional_header, int enables, int format, int len); 
    261 }; 
    262  
    263 // ---------------------------------------------------------------- 
    264  
    265 class usrp1_source_base : public gr_sync_block { 
    266  protected: 
    267  
    268   usrp1_source_base (const std::string &name, 
    269                      gr_io_signature_sptr input_signature, 
    270                      int which_board, 
    271                      unsigned int interp_rate, 
    272                      int nchan, 
    273                      int mux, 
    274                      int fusb_block_size, 
    275                      int fusb_nblocks, 
    276                      const std::string fpga_filename, 
    277                      const std::string firmware_filename 
    278                      ) throw (std::runtime_error); 
    279  
    280   virtual int ninput_bytes_reqd_for_noutput_items (int noutput_items) = 0; 
    281  
    282   virtual void copy_from_usrp_buffer (gr_vector_void_star &output_items, 
    283                                       int output_index, 
    284                                       int output_items_available, 
    285                                       int &output_items_produced, 
    286                                       const void *usrp_buffer, 
    287                                       int usrp_buffer_length, 
    288                                       int &bytes_read) = 0; 
    289  public: 
    290   ~usrp1_source_base (); 
    291  
    292  
    293   /*! 
    294    * \brief Set decimator rate.  \p rate must be EVEN and in [8, 256]. 
    295    * 
    296    * The final complex sample rate across the USB is 
    297    *   adc_freq () / decim_rate () 
    298    */ 
    299   bool set_decim_rate (unsigned int rate); 
    300   bool set_nchannels (int nchan); 
    301   bool set_mux (int mux); 
    302  
    303   /*! 
    304    * \brief set the center frequency of the digital down converter. 
    305    * 
    306    * \p channel must be 0.  \p freq is the center frequency in Hz. 
    307    * It must be in the range [-FIXME, FIXME].  The frequency specified is 
    308    * quantized.  Use rx_freq to retrieve the actual value used. 
    309    */ 
    310   bool set_rx_freq (int channel, double freq); 
    311  
    312   /*! 
    313    * \brief set fpga special modes 
    314    */ 
    315   bool set_fpga_mode (int mode); 
    316  
    317   /*! 
    318    * \brief Set the digital down converter phase register. 
    319    * 
    320    * \param channel     which ddc channel [0, 3] 
    321    * \param phase       32-bit integer phase value. 
    322    */ 
    323   bool set_ddc_phase(int channel, int phase); 
    324  
    325  
    326   void set_verbose (bool verbose); 
    327  
    328   // ACCESSORS 
    329  
    330   long fpga_master_clock_freq() const; 
    331   long converter_rate() const;  // A/D sample rate 
    332   long adc_rate() const;        // alias 
    333   long adc_freq() const;        // Deprecated name.  Use converter_rate() or adc_rate(). 
    334  
    335   unsigned int decim_rate () const; 
    336   double rx_freq (int channel) const; 
    337   int noverruns () const { return d_noverruns; } 
    338  
    339  
    340   // PGA stuff 
    341   /*! 
    342    * \brief Set Programmable Gain Amplifier (PGA) 
    343    * 
    344    * \param which       which A/D [0,3] 
    345    * \param gain_in_db  gain value (linear in dB) 
    346    * 
    347    * gain is rounded to closest setting supported by hardware. 
    348    * 
    349    * \returns true iff sucessful. 
    350    * 
    351    * \sa pga_min(), pga_max(), pga_db_per_step() 
    352    */ 
    353   bool set_pga (int which, double gain_in_db); 
    354  
    355   /*! 
    356    * \brief Return programmable gain amplifier gain setting in dB. 
    357    * 
    358    * \param which       which A/D [0,3] 
    359    */ 
    360   double pga (int which) const; 
    361  
    362   /*! 
    363    * \brief Return minimum legal PGA setting in dB. 
    364    */ 
    365   double pga_min () const; 
    366  
    367   /*! 
    368    * \brief Return maximum legal PGA setting in dB. 
    369    */ 
    370   double pga_max () const; 
    371  
    372   /*! 
    373    * \brief Return hardware step size of PGA (linear in dB). 
    374    */ 
    375   double pga_db_per_step () const; 
    376  
    377   /*! 
    378    * \brief Return daughterboard ID for given Rx daughterboard slot [0,1]. 
    379    * 
    380    * \return daughterboard id >= 0 if successful 
    381    * \return -1 if no daugherboard 
    382    * \return -2 if invalid EEPROM on daughterboard 
    383    */ 
    384   int daughterboard_id (int which_dboard) const; 
    385  
    386   /*! 
    387    * \brief Set ADC offset correction 
    388    * \param which       which ADC[0,3]: 0 = RX_A I, 1 = RX_A Q... 
    389    * \param offset      16-bit value to subtract from raw ADC input. 
    390    */ 
    391   bool set_adc_offset (int which, int offset); 
    392  
    393   /*! 
    394    * \brief Set DAC offset correction 
    395    * \param which       which DAC[0,3]: 0 = TX_A I, 1 = TX_A Q... 
    396    * \param offset      10-bit offset value (ambiguous format:  See AD9862 datasheet). 
    397    * \param offset_pin  1-bit value.  If 0 offset applied to -ve differential pin; 
    398    *                                  If 1 offset applied to +ve differential pin. 
    399    */ 
    400   bool set_dac_offset (int which, int offset, int offset_pin); 
    401  
    402   /*! 
    403    * \brief Control ADC input buffer 
    404    * \param which       which ADC[0,3] 
    405    * \param bypass      if non-zero, bypass input buffer and connect input 
    406    *                    directly to switched cap SHA input of RxPGA. 
    407    */ 
    408   bool set_adc_buffer_bypass (int which, bool bypass); 
    409  
    410   /*! 
    411    * \brief return the usrp's serial number. 
    412    * 
    413    * \returns non-zero length string iff successful. 
    414    */ 
    415   std::string serial_number(); 
    416  
    417   /*! 
    418    * \brief Write direction register (output enables) for pins that go to daughterboard. 
    419    * 
    420    * \param which_dboard        [0,1] which d'board 
    421    * \param value               value to write into register 
    422    * \param mask                which bits of value to write into reg 
    423    * 
    424    * Each d'board has 16-bits of general purpose i/o. 
    425    * Setting the bit makes it an output from the FPGA to the d'board. 
    426    * 
    427    * This register is initialized based on a value stored in the 
    428    * d'board EEPROM.  In general, you shouldn't be using this routine 
    429    * without a very good reason.  Using this method incorrectly will 
    430    * kill your USRP motherboard and/or daughterboard. 
    431    */ 
    432   bool _write_oe (int which_dboard, int value, int mask); 
    433  
    434   /*! 
    435    * \brief Write daughterboard i/o pin value 
    436    * 
    437    * \param which_dboard        [0,1] which d'board 
    438    * \param value               value to write into register 
    439    * \param mask                which bits of value to write into reg 
    440    */ 
    441   bool write_io (int which_dboard, int value, int mask); 
    442  
    443   /*! 
    444    * \brief Read daughterboard i/o pin value 
    445    * 
    446    * \param which_dboard        [0,1] which d'board 
    447    * \returns register value if successful, else READ_FAILED 
    448    */ 
    449   int read_io (int which_dboard); 
    450  
    451   /*! 
    452    * \brief Enable/disable automatic DC offset removal control loop in FPGA 
    453    * 
    454    * \param bits  which control loops to enable 
    455    * \param mask  which \p bits to pay attention to 
    456    * 
    457    * If the corresponding bit is set, enable the automatic DC 
    458    * offset correction control loop. 
    459    * 
    460    * <pre> 
    461    * The 4 low bits are significant: 
    462    * 
    463    *   ADC0 = (1 << 0) 
    464    *   ADC1 = (1 << 1) 
    465    *   ADC2 = (1 << 2) 
    466    *   ADC3 = (1 << 3) 
    467    * </pre> 
    468    * 
    469    * By default the control loop is enabled on all ADC's. 
    470    */ 
    471   bool set_dc_offset_cl_enable(int bits, int mask); 
    472  
    473   /*! 
    474    * \brief Specify Rx data format. 
    475    * 
    476    * \param format      format specifier 
    477    * 
    478    * Rx data format control register 
    479    * 
    480    *     3                   2                   1                        
    481    *   1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0 
    482    *  +-----------------------------------------+-+-+---------+-------+ 
    483    *  |          Reserved (Must be zero)        |B|Q|  WIDTH  | SHIFT | 
    484    *  +-----------------------------------------+-+-+---------+-------+ 
    485    * 
    486    *  SHIFT specifies arithmetic right shift [0, 15] 
    487    *  WIDTH specifies bit-width of I & Q samples across the USB [1, 16] (not all valid) 
    488    *  Q     if set deliver both I & Q, else just I 
    489    *  B     if set bypass half-band filter. 
    490    * 
    491    * Right now the acceptable values are: 
    492    * 
    493    *   B  Q  WIDTH  SHIFT 
    494    *   0  1    16     0 
    495    *   0  1     8     8 
    496    * 
    497    * More valid combos to come. 
    498    * 
    499    * Default value is 0x00000300  16-bits, 0 shift, deliver both I & Q. 
    500    */ 
    501   bool set_format(unsigned int format); 
    502  
    503   /*! 
    504    * \brief return current format 
    505    */ 
    506   unsigned int format () const; 
    507  
    508   static unsigned int make_format(int width=16, int shift=0, 
    509                                   bool want_q=true, bool bypass_halfband=false); 
    510   static int format_width(unsigned int format); 
    511   static int format_shift(unsigned int format); 
    512   static bool format_want_q(unsigned int format); 
    513   static bool format_bypass_halfband(unsigned int format); 
    514  
    515  
    516  
    517  
    518   bool write_aux_dac (int which_dboard, int which_dac, int value); 
    519   int read_aux_adc (int which_dboard, int which_adc); 
    520   bool write_eeprom (int i2c_addr, int eeprom_offset, const std::string buf); 
    521   std::string read_eeprom (int i2c_addr, int eeprom_offset, int len); 
    522   bool write_i2c (int i2c_addr, const std::string buf); 
    523   std::string read_i2c (int i2c_addr, int len); 
    524   bool _write_fpga_reg (int regno, int value);  //< 7-bit regno, 32-bit value 
    525   bool _write_fpga_reg_masked (int regno, int value, int mask); //< 7-bit regno, 16-bit value, 16-bit mask 
    526   int  _read_fpga_reg (int regno); 
    527   bool _write_9862 (int which_codec, int regno, unsigned char value); 
    528   int  _read_9862 (int which_codec, int regno) const; 
    529  
    530   bool _write_spi (int optional_header, int enables, int format, std::string buf); 
    531  
    532   /* 
    533    * \brief Read data from SPI bus peripheral. 
    534    * 
    535    * \param optional_header     0,1 or 2 bytes to write before buf. 
    536    * \param enables             bitmask of peripheral to read. See usrp_spi_defs.h 
    537    * \param format              transaction format.  See usrp_spi_defs.h SPI_FMT_* 
    538    * \param len                 number of bytes to read.  Must be in [0,64]. 
    539    * \returns the data read if sucessful, else a zero length string. 
    540    * 
    541    * Reads are limited to a maximum of 64 bytes. 
    542    * 
    543    * If \p format specifies that optional_header bytes are present, they 
    544    * are written to the peripheral first.  Then \p len bytes are read from 
    545    * the peripheral and returned. 
    546    */ 
    547   std::string _read_spi (int optional_header, int enables, int format, int len); 
    548 }; 
    549  
    550  
    551 // ================================================================ 
    552 //                      concrete sinks 
    553 // ================================================================ 
    554  
    555  
    556 GR_SWIG_BLOCK_MAGIC(usrp1,sink_c) 
    557  
    558 usrp1_sink_c_sptr 
    559 usrp1_make_sink_c (int which_board, 
    560                    unsigned int interp_rate, 
    561                    int nchan, 
    562                    int mux, 
    563                    int fusb_block_size, 
    564                    int fusb_nblocks, 
    565                    const std::string fpga_filename, 
    566                    const std::string firmware_filename 
    567                    ) throw (std::runtime_error); 
    568  
    569  
    570 class usrp1_sink_c : public usrp1_sink_base { 
    571  protected: 
    572   usrp1_sink_c (int which_board, unsigned int interp_rate, 
    573                 int nchan, int mux); 
    574  
    575  public: 
    576   ~usrp1_sink_c (); 
    577 }; 
    578  
    579 // ---------------------------------------------------------------- 
    580  
    581 GR_SWIG_BLOCK_MAGIC(usrp1,sink_s) 
    582  
    583 usrp1_sink_s_sptr 
    584 usrp1_make_sink_s (int which_board, 
    585                    unsigned int interp_rate, 
    586                    int nchan, 
    587                    int mux, 
    588