usrp1: implemented multi-channel dsp control of shift freq

usrp: simple usrp calls into single usrp and prints deprecation warning

usrp: tune helper now supports multi-channel dsps

3 files changed, 20 insertions, 12 deletions

diff --git a/host/include/uhd/usrp/dsp_props.hpp b/host/include/uhd/usrp/dsp_props.hpp
index 75d8c0a60..54ea5666b 100644
--- a/host/include/uhd/usrp/dsp_props.hpp
+++ b/host/include/uhd/usrp/dsp_props.hpp
@@ -37,11 +37,12 @@ namespace uhd{ namespace usrp{
      *   Set the shift property and read it back to get actual shift.
      */
     enum dsp_prop_t{
-        DSP_PROP_NAME         = 'n', //ro, std::string
-        DSP_PROP_OTHERS       = 'o', //ro, prop_names_t
-        DSP_PROP_FREQ_SHIFT   = 'f', //rw, double Hz
-        DSP_PROP_CODEC_RATE   = 'c', //ro, double Sps
-        DSP_PROP_HOST_RATE    = 'h'  //rw, double Sps
+        DSP_PROP_NAME              = 'n', //ro, std::string
+        DSP_PROP_OTHERS            = 'o', //ro, prop_names_t
+        DSP_PROP_FREQ_SHIFT        = 'f', //rw, double Hz
+        DSP_PROP_FREQ_SHIFT_NAMES  = 'F', //ro, prop_names_t
+        DSP_PROP_CODEC_RATE        = 'c', //ro, double Sps
+        DSP_PROP_HOST_RATE         = 'h'  //rw, double Sps
     };
 
 }} //namespace
diff --git a/host/include/uhd/usrp/simple_usrp.hpp b/host/include/uhd/usrp/simple_usrp.hpp
index 169411f19..6149f739c 100644
--- a/host/include/uhd/usrp/simple_usrp.hpp
+++ b/host/include/uhd/usrp/simple_usrp.hpp
@@ -33,7 +33,8 @@
 namespace uhd{ namespace usrp{
 
 /*!
- * The simple USRP device class:
+ * The simple USRP device class (DEPRECATED):
+ * This interface has been deprecated in favor of the single USRP interface.
  * A simple usrp facilitates ease-of-use for most use-case scenarios.
  * The wrapper provides convenience functions to tune the devices
  * as well as to set the dboard gains, antennas, and other properties.
diff --git a/host/include/uhd/usrp/tune_helper.hpp b/host/include/uhd/usrp/tune_helper.hpp
index df3907b3e..ec133fa08 100644
--- a/host/include/uhd/usrp/tune_helper.hpp
+++ b/host/include/uhd/usrp/tune_helper.hpp
@@ -31,12 +31,13 @@ namespace uhd{ namespace usrp{
      * The ddc cordic is setup to bring the IF down to baseband.
      * \param subdev the dboard subdevice object with properties
      * \param ddc the mboard dsp object with properties
+     * \param chan the channel of the dsp to tune
      * \param target_freq the desired center frequency
      * \param lo_offset an offset for the subdevice IF from center
      * \return a tune result struct
      */
     UHD_API tune_result_t tune_rx_subdev_and_dsp(
-        wax::obj subdev, wax::obj ddc,
+        wax::obj subdev, wax::obj ddc, size_t chan,
         double target_freq, double lo_offset
     );
 
@@ -46,17 +47,19 @@ namespace uhd{ namespace usrp{
      * is calculated based on the subdevice and BW.
      */
     UHD_API tune_result_t tune_rx_subdev_and_dsp(
-        wax::obj subdev, wax::obj ddc, double target_freq
+        wax::obj subdev, wax::obj ddc,
+        size_t chan, double target_freq
     );
 
     /*!
      * Calculate the overall frequency from the combination of dboard IF and DDC shift.
      * \param subdev the dboard subdevice object with properties
      * \param ddc the mboard dsp object with properties
+     * \param chan the channel of the dsp to tune
      * \return the overall tune frequency of the system in Hz
      */
     UHD_API double derive_freq_from_rx_subdev_and_dsp(
-        wax::obj subdev, wax::obj ddc
+        wax::obj subdev, wax::obj ddc, size_t chan
     );
 
     /*!
@@ -66,12 +69,13 @@ namespace uhd{ namespace usrp{
      * The duc cordic is setup to bring the baseband up to IF.
      * \param subdev the dboard subdevice object with properties
      * \param duc the mboard dsp object with properties
+     * \param chan the channel of the dsp to tune
      * \param target_freq the desired center frequency
      * \param lo_offset an offset for the subdevice IF from center
      * \return a tune result struct
      */
     UHD_API tune_result_t tune_tx_subdev_and_dsp(
-        wax::obj subdev, wax::obj duc,
+        wax::obj subdev, wax::obj duc, size_t chan,
         double target_freq, double lo_offset
     );
 
@@ -81,17 +85,19 @@ namespace uhd{ namespace usrp{
      * is calculated based on the subdevice and BW.
      */
     UHD_API tune_result_t tune_tx_subdev_and_dsp(
-        wax::obj subdev, wax::obj duc, double target_freq
+        wax::obj subdev, wax::obj duc,
+        size_t chan, double target_freq
     );
 
     /*!
      * Calculate the overall frequency from the combination of dboard IF and DUC shift.
      * \param subdev the dboard subdevice object with properties
      * \param duc the mboard dsp object with properties
+     * \param chan the channel of the dsp to tune
      * \return the overall tune frequency of the system in Hz
      */
     UHD_API double derive_freq_from_tx_subdev_and_dsp(
-        wax::obj subdev, wax::obj duc
+        wax::obj subdev, wax::obj duc, size_t chan
     );
 
 }}