diff options
| author | michael-west <michael.west@ettus.com> | 2014-10-23 19:03:58 -0700 | 
|---|---|---|
| committer | Martin Braun <martin.braun@ettus.com> | 2015-01-16 08:46:21 +0100 | 
| commit | 734180c44b438cf707c4ff48bf4b11a8c5a94136 (patch) | |
| tree | bbff55a4c092588766a7a90f42e8c796eadcad01 /host | |
| parent | b02fadef4af427cc06286a50cb0528a1f2aa2676 (diff) | |
| download | uhd-734180c44b438cf707c4ff48bf4b11a8c5a94136.tar.gz uhd-734180c44b438cf707c4ff48bf4b11a8c5a94136.tar.bz2 uhd-734180c44b438cf707c4ff48bf4b11a8c5a94136.zip  | |
UHD: Fixes for dboard calibration utilities.
Diffstat (limited to 'host')
| -rw-r--r-- | host/utils/uhd_cal_rx_iq_balance.cpp | 160 | ||||
| -rw-r--r-- | host/utils/uhd_cal_tx_dc_offset.cpp | 172 | ||||
| -rw-r--r-- | host/utils/uhd_cal_tx_iq_balance.cpp | 169 | ||||
| -rw-r--r-- | host/utils/usrp_cal_utils.hpp | 231 | 
4 files changed, 483 insertions, 249 deletions
diff --git a/host/utils/uhd_cal_rx_iq_balance.cpp b/host/utils/uhd_cal_rx_iq_balance.cpp index 3188e02a0..2414ef007 100644 --- a/host/utils/uhd_cal_rx_iq_balance.cpp +++ b/host/utils/uhd_cal_rx_iq_balance.cpp @@ -1,5 +1,5 @@  // -// Copyright 2010,2012 Ettus Research LLC +// Copyright 2010,2012,2014 Ettus Research LLC  //  // This program is free software: you can redistribute it and/or modify  // it under the terms of the GNU General Public License as published by @@ -37,7 +37,8 @@ namespace po = boost::program_options;  /***********************************************************************   * Transmit thread   **********************************************************************/ -static void tx_thread(uhd::usrp::multi_usrp::sptr usrp, const double tx_wave_ampl){ +static void tx_thread(uhd::usrp::multi_usrp::sptr usrp, const double tx_wave_ampl) +{      uhd::set_thread_priority_safe();      //create a transmit streamer @@ -50,10 +51,10 @@ static void tx_thread(uhd::usrp::multi_usrp::sptr usrp, const double tx_wave_amp      std::vector<samp_type> buff(tx_stream->get_max_num_samps()*10);      //fill buff and send until interrupted -    while (not boost::this_thread::interruption_requested()){ -        for (size_t i = 0; i < buff.size(); i++){ +    while (not boost::this_thread::interruption_requested()) +    { +        for (size_t i = 0; i < buff.size(); i++)              buff[i] = float(tx_wave_ampl); -        }          tx_stream->send(&buff.front(), buff.size(), md);      } @@ -65,26 +66,34 @@ static void tx_thread(uhd::usrp::multi_usrp::sptr usrp, const double tx_wave_amp  /***********************************************************************   * Tune RX and TX routine   **********************************************************************/ -static double tune_rx_and_tx(uhd::usrp::multi_usrp::sptr usrp, const double rx_lo_freq, const double tx_offset){ +static double tune_rx_and_tx(uhd::usrp::multi_usrp::sptr usrp, const double rx_lo_freq, const double tx_offset) +{      //tune the receiver with no cordic      uhd::tune_request_t rx_tune_req(rx_lo_freq);      rx_tune_req.dsp_freq_policy = uhd::tune_request_t::POLICY_MANUAL;      rx_tune_req.dsp_freq = 0;      usrp->set_rx_freq(rx_tune_req); -    //tune the transmitter with no cordic -    uhd::tune_request_t tx_tune_req(usrp->get_rx_freq() - tx_offset); +    //tune the transmitter +    double tx_freq = usrp->get_rx_freq() + tx_offset; +    double min_fe_tx_freq = usrp->get_fe_tx_freq_range().start(); +    double max_fe_tx_freq = usrp->get_fe_tx_freq_range().stop(); +    uhd::tune_request_t tx_tune_req(tx_freq);      tx_tune_req.dsp_freq_policy = uhd::tune_request_t::POLICY_MANUAL;      tx_tune_req.dsp_freq = 0; +    if (tx_freq < min_fe_tx_freq) +        tx_tune_req.dsp_freq = tx_freq - min_fe_tx_freq; +    else if (tx_freq > max_fe_tx_freq) +        tx_tune_req.dsp_freq = tx_freq - max_fe_tx_freq;      usrp->set_tx_freq(tx_tune_req);      //wait for the LOs to become locked      boost::this_thread::sleep(boost::posix_time::milliseconds(50));      boost::system_time start = boost::get_system_time(); -    while (not usrp->get_tx_sensor("lo_locked").to_bool() or not usrp->get_rx_sensor("lo_locked").to_bool()){ -        if (boost::get_system_time() > start + boost::posix_time::milliseconds(100)){ +    while (not usrp->get_tx_sensor("lo_locked").to_bool() or not usrp->get_rx_sensor("lo_locked").to_bool()) +    { +        if (boost::get_system_time() > start + boost::posix_time::milliseconds(100))              throw std::runtime_error("timed out waiting for TX and/or RX LO to lock"); -        }      }      return usrp->get_rx_freq(); @@ -93,11 +102,13 @@ static double tune_rx_and_tx(uhd::usrp::multi_usrp::sptr usrp, const double rx_l  /***********************************************************************   * Main   **********************************************************************/ -int UHD_SAFE_MAIN(int argc, char *argv[]){ +int UHD_SAFE_MAIN(int argc, char *argv[]) +{      std::string args, subdev, serial;      double tx_wave_ampl, tx_offset;      double freq_start, freq_stop, freq_step;      size_t nsamps; +    double precision;      po::options_description desc("Allowed options");      desc.add_options() @@ -110,7 +121,8 @@ int UHD_SAFE_MAIN(int argc, char *argv[]){          ("freq_start", po::value<double>(&freq_start), "Frequency start in Hz (do not specify for default)")          ("freq_stop", po::value<double>(&freq_stop), "Frequency stop in Hz (do not specify for default)")          ("freq_step", po::value<double>(&freq_step)->default_value(default_freq_step), "Step size for LO sweep in Hz") -        ("nsamps", po::value<size_t>(&nsamps)->default_value(default_num_samps), "Samples per data capture") +        ("nsamps", po::value<size_t>(&nsamps), "Samples per data capture") +        ("precision", po::value<double>(&precision)->default_value(default_precision), "Correction precision (default=0.0001)")      ;      po::variables_map vm; @@ -130,6 +142,9 @@ int UHD_SAFE_MAIN(int argc, char *argv[]){      // Create a USRP device      uhd::usrp::multi_usrp::sptr usrp = setup_usrp_for_cal(args, subdev, serial); +    if (not vm.count("nsamps")) +        nsamps = size_t(usrp->get_rx_rate() / default_fft_bin_size); +      //create a receive streamer      uhd::stream_args_t stream_args("fc32"); //complex floats      uhd::rx_streamer::sptr rx_stream = usrp->get_rx_stream(stream_args); @@ -144,11 +159,35 @@ int UHD_SAFE_MAIN(int argc, char *argv[]){      //store the results here      std::vector<result_t> results; -    if (not vm.count("freq_start")) freq_start = usrp->get_rx_freq_range().start() + 50e6; -    if (not vm.count("freq_stop")) freq_stop = usrp->get_rx_freq_range().stop() - 50e6; +    if (not vm.count("freq_start")) freq_start = usrp->get_fe_rx_freq_range().start(); +    if (not vm.count("freq_stop")) freq_stop = usrp->get_fe_tx_freq_range().stop(); + +    //check start and stop frequencies +    if (freq_start < usrp->get_fe_rx_freq_range().start()) +    { +        std::cerr << "freq_start must be " << usrp->get_fe_rx_freq_range().start() << " or greater for this daughter board" << std::endl; +        return EXIT_FAILURE; +    } +    if (freq_stop > usrp->get_fe_rx_freq_range().stop()) +    { +        std::cerr << "freq_stop must be " << usrp->get_fe_rx_freq_range().stop() << " or less for this daughter board" << std::endl; +        return EXIT_FAILURE; +    } + +    //check tx_offset +    double min_tx_offset = usrp->get_tx_freq_range().start() - usrp->get_fe_rx_freq_range().start(); +    double max_tx_offset = usrp->get_tx_freq_range().stop() - usrp->get_fe_rx_freq_range().stop(); +    if (tx_offset < min_tx_offset or tx_offset > max_tx_offset) +    { +        std::cerr << "tx_offset must be between " << min_tx_offset << " and " +            << max_tx_offset << " for this daughter board" << std::endl; +        return EXIT_FAILURE; +    } +      UHD_MSG(status) << boost::format("Calibration frequency range: %d MHz -> %d MHz") % (freq_start/1e6) % (freq_stop/1e6) << std::endl; -    for (double rx_lo_i = freq_start; rx_lo_i <= freq_stop; rx_lo_i += freq_step){ +    for (double rx_lo_i = freq_start; rx_lo_i <= freq_stop; rx_lo_i += freq_step) +    {          const double rx_lo = tune_rx_and_tx(usrp, rx_lo_i, tx_offset);          //frequency constants for this tune event @@ -158,73 +197,78 @@ int UHD_SAFE_MAIN(int argc, char *argv[]){          const double bb_tone_freq = actual_tx_freq - actual_rx_freq;          const double bb_imag_freq = -bb_tone_freq; -        //capture initial uncorrected value +        //reset RX IQ balance          usrp->set_rx_iq_balance(0.0); + +        //set optimal RX gain setting for this frequency +        set_optimal_rx_gain(usrp, rx_stream); + +        //capture initial uncorrected value          capture_samples(usrp, rx_stream, buff, nsamps);          const double initial_suppression = compute_tone_dbrms(buff, bb_tone_freq/actual_rx_rate) - compute_tone_dbrms(buff, bb_imag_freq/actual_rx_rate);          //bounds and results from searching -        std::complex<double> best_correction; -        double phase_corr_start = -.3, phase_corr_stop = .3, phase_corr_step; -        double ampl_corr_start = -.3, ampl_corr_stop = .3, ampl_corr_step; -        double best_suppression = 0, best_phase_corr = 0, best_ampl_corr = 0; - -        for (size_t i = 0; i < num_search_iters; i++){ - -            phase_corr_step = (phase_corr_stop - phase_corr_start)/(num_search_steps-1); -            ampl_corr_step = (ampl_corr_stop - ampl_corr_start)/(num_search_steps-1); - -            for (double phase_corr = phase_corr_start; phase_corr <= phase_corr_stop + phase_corr_step/2; phase_corr += phase_corr_step){ -            for (double ampl_corr = ampl_corr_start; ampl_corr <= ampl_corr_stop + ampl_corr_step/2; ampl_corr += ampl_corr_step){ - -                const std::complex<double> correction(ampl_corr, phase_corr); -                usrp->set_rx_iq_balance(correction); - -                //receive some samples -                capture_samples(usrp, rx_stream, buff, nsamps); - -                const double tone_dbrms = compute_tone_dbrms(buff, bb_tone_freq/actual_rx_rate); -                const double imag_dbrms = compute_tone_dbrms(buff, bb_imag_freq/actual_rx_rate); -                const double suppression = tone_dbrms - imag_dbrms; - -                if (suppression > best_suppression){ -                    best_correction = correction; -                    best_suppression = suppression; -                    best_phase_corr = phase_corr; -                    best_ampl_corr = ampl_corr; +        double phase_corr_start = -1.0; +        double phase_corr_stop = 1.0; +        double phase_corr_step = (phase_corr_stop - phase_corr_start)/(num_search_steps+1); +        double ampl_corr_start = -1.0; +        double ampl_corr_stop = 1.0; +        double ampl_corr_step = (ampl_corr_stop - ampl_corr_start)/(num_search_steps+1); +        double best_suppression = 0; +        double best_phase_corr = 0; +        double best_ampl_corr = 0; +        while (phase_corr_step >= precision or ampl_corr_step >= precision) +        { +            for (double phase_corr = phase_corr_start + phase_corr_step; phase_corr <= phase_corr_stop - phase_corr_step; phase_corr += phase_corr_step) +            { +                for (double ampl_corr = ampl_corr_start + ampl_corr_step; ampl_corr <= ampl_corr_stop - ampl_corr_step; ampl_corr += ampl_corr_step) +                { +                    const std::complex<double> correction(ampl_corr, phase_corr); +                    usrp->set_rx_iq_balance(correction); + +                    //receive some samples +                    capture_samples(usrp, rx_stream, buff, nsamps); +                    const double tone_dbrms = compute_tone_dbrms(buff, bb_tone_freq/actual_rx_rate); +                    const double imag_dbrms = compute_tone_dbrms(buff, bb_imag_freq/actual_rx_rate); +                    const double suppression = tone_dbrms - imag_dbrms; + +                    if (suppression > best_suppression) +                    { +                        best_suppression = suppression; +                        best_phase_corr = phase_corr; +                        best_ampl_corr = ampl_corr; +                    }                  } - -            }} - -            //std::cout << "best_phase_corr " << best_phase_corr << std::endl; -            //std::cout << "best_ampl_corr " << best_ampl_corr << std::endl; -            //std::cout << "best_suppression " << best_suppression << std::endl; +            }              phase_corr_start = best_phase_corr - phase_corr_step;              phase_corr_stop = best_phase_corr + phase_corr_step; +            phase_corr_step = (phase_corr_stop - phase_corr_start)/(num_search_steps+1);              ampl_corr_start = best_ampl_corr - ampl_corr_step;              ampl_corr_stop = best_ampl_corr + ampl_corr_step; +            ampl_corr_step = (ampl_corr_stop - ampl_corr_start)/(num_search_steps+1);          } -        if (best_suppression > 30){ //most likely valid, keep result +        if (best_suppression > initial_suppression) //keep result +        {              result_t result;              result.freq = rx_lo; -            result.real_corr = best_correction.real(); -            result.imag_corr = best_correction.imag(); +            result.real_corr = best_ampl_corr; +            result.imag_corr = best_phase_corr;              result.best = best_suppression;              result.delta = best_suppression - initial_suppression;              results.push_back(result); -            if (vm.count("verbose")){ +            if (vm.count("verbose"))                  std::cout << boost::format("RX IQ: %f MHz: best suppression %f dB, corrected %f dB") % (rx_lo/1e6) % result.best % result.delta << std::endl; -            } -            else std::cout << "." << std::flush; +            else +                std::cout << "." << std::flush;          } -      }      std::cout << std::endl;      //stop the transmitter      threads.interrupt_all(); +    boost::this_thread::sleep(boost::posix_time::milliseconds(500));    //wait for threads to finish      threads.join_all();      store_results(results, "RX", "rx", "iq", serial); diff --git a/host/utils/uhd_cal_tx_dc_offset.cpp b/host/utils/uhd_cal_tx_dc_offset.cpp index b5c5293f0..8aa505010 100644 --- a/host/utils/uhd_cal_tx_dc_offset.cpp +++ b/host/utils/uhd_cal_tx_dc_offset.cpp @@ -1,5 +1,5 @@  // -// Copyright 2010,2012 Ettus Research LLC +// Copyright 2010,2012,2014 Ettus Research LLC  //  // This program is free software: you can redistribute it and/or modify  // it under the terms of the GNU General Public License as published by @@ -35,9 +35,13 @@ namespace po = boost::program_options;  /***********************************************************************   * Transmit thread   **********************************************************************/ -static void tx_thread(uhd::usrp::multi_usrp::sptr usrp, const double tx_wave_freq, const double tx_wave_ampl){ +static void tx_thread(uhd::usrp::multi_usrp::sptr usrp, const double tx_wave_freq, const double tx_wave_ampl) +{      uhd::set_thread_priority_safe(); +    // set max TX gain +    usrp->set_tx_gain(usrp->get_tx_gain_range().stop()); +      //create a transmit streamer      uhd::stream_args_t stream_args("fc32"); //complex floats      uhd::tx_streamer::sptr tx_stream = usrp->get_tx_stream(stream_args); @@ -50,14 +54,14 @@ static void tx_thread(uhd::usrp::multi_usrp::sptr usrp, const double tx_wave_fre      //values for the wave table lookup      size_t index = 0;      const double tx_rate = usrp->get_tx_rate(); -    const size_t step = boost::math::iround(wave_table_len * tx_wave_freq/tx_rate); +    const size_t step = boost::math::iround(wave_table_len * tx_wave_freq / tx_rate);      wave_table table(tx_wave_ampl);      //fill buff and send until interrupted -    while (not boost::this_thread::interruption_requested()){ -        for (size_t i = 0; i < buff.size(); i++){ +    while (not boost::this_thread::interruption_requested()) +    { +        for (size_t i = 0; i < buff.size(); i++)              buff[i] = table(index += step); -        }          tx_stream->send(&buff.front(), buff.size(), md);      } @@ -69,7 +73,8 @@ static void tx_thread(uhd::usrp::multi_usrp::sptr usrp, const double tx_wave_fre  /***********************************************************************   * Tune RX and TX routine   **********************************************************************/ -static double tune_rx_and_tx(uhd::usrp::multi_usrp::sptr usrp, const double tx_lo_freq, const double rx_offset){ +static double tune_rx_and_tx(uhd::usrp::multi_usrp::sptr usrp, const double tx_lo_freq, const double rx_offset) +{      //tune the transmitter with no cordic      uhd::tune_request_t tx_tune_req(tx_lo_freq);      tx_tune_req.dsp_freq_policy = uhd::tune_request_t::POLICY_MANUAL; @@ -77,15 +82,25 @@ static double tune_rx_and_tx(uhd::usrp::multi_usrp::sptr usrp, const double tx_l      usrp->set_tx_freq(tx_tune_req);      //tune the receiver -    usrp->set_rx_freq(usrp->get_tx_freq() - rx_offset); +    double rx_freq = usrp->get_tx_freq() - rx_offset; +    double min_fe_rx_freq = usrp->get_fe_rx_freq_range().start(); +    double max_fe_rx_freq = usrp->get_fe_rx_freq_range().stop(); +    uhd::tune_request_t rx_tune_req(rx_freq); +    rx_tune_req.dsp_freq_policy = uhd::tune_request_t::POLICY_MANUAL; +    rx_tune_req.dsp_freq = 0; +    if (rx_freq < min_fe_rx_freq) +        rx_tune_req.dsp_freq = rx_freq - min_fe_rx_freq; +    else if (rx_freq > max_fe_rx_freq) +        rx_tune_req.dsp_freq = rx_freq - max_fe_rx_freq; +    usrp->set_rx_freq(rx_tune_req);      //wait for the LOs to become locked      boost::this_thread::sleep(boost::posix_time::milliseconds(50));      boost::system_time start = boost::get_system_time(); -    while (not usrp->get_tx_sensor("lo_locked").to_bool() or not usrp->get_rx_sensor("lo_locked").to_bool()){ -        if (boost::get_system_time() > start + boost::posix_time::milliseconds(100)){ +    while (not usrp->get_tx_sensor("lo_locked").to_bool() or not usrp->get_rx_sensor("lo_locked").to_bool()) +    { +        if (boost::get_system_time() > start + boost::posix_time::milliseconds(100))              throw std::runtime_error("timed out waiting for TX and/or RX LO to lock"); -        }      }      return usrp->get_tx_freq(); @@ -94,11 +109,13 @@ static double tune_rx_and_tx(uhd::usrp::multi_usrp::sptr usrp, const double tx_l  /***********************************************************************   * Main   **********************************************************************/ -int UHD_SAFE_MAIN(int argc, char *argv[]){ +int UHD_SAFE_MAIN(int argc, char *argv[]) +{      std::string args, subdev, serial;      double tx_wave_freq, tx_wave_ampl, rx_offset;      double freq_start, freq_stop, freq_step;      size_t nsamps; +    double precision;      po::options_description desc("Allowed options");      desc.add_options() @@ -112,7 +129,8 @@ int UHD_SAFE_MAIN(int argc, char *argv[]){          ("freq_start", po::value<double>(&freq_start), "Frequency start in Hz (do not specify for default)")          ("freq_stop", po::value<double>(&freq_stop), "Frequency stop in Hz (do not specify for default)")          ("freq_step", po::value<double>(&freq_step)->default_value(default_freq_step), "Step size for LO sweep in Hz") -        ("nsamps", po::value<size_t>(&nsamps)->default_value(default_num_samps), "Samples per data capture") +        ("nsamps", po::value<size_t>(&nsamps), "Samples per data capture") +        ("precision", po::value<double>(&precision)->default_value(default_precision), "Correction precision (default=0.0001)")      ;      po::variables_map vm; @@ -132,6 +150,9 @@ int UHD_SAFE_MAIN(int argc, char *argv[]){      // Create a USRP device      uhd::usrp::multi_usrp::sptr usrp = setup_usrp_for_cal(args, subdev, serial); +    if (not vm.count("nsamps")) +        nsamps = size_t(usrp->get_rx_rate() / default_fft_bin_size); +      //create a receive streamer      uhd::stream_args_t stream_args("fc32"); //complex floats      uhd::rx_streamer::sptr rx_stream = usrp->get_rx_stream(stream_args); @@ -146,11 +167,38 @@ int UHD_SAFE_MAIN(int argc, char *argv[]){      //store the results here      std::vector<result_t> results; -    if (not vm.count("freq_start")) freq_start = usrp->get_tx_freq_range().start() + 50e6; -    if (not vm.count("freq_stop")) freq_stop = usrp->get_tx_freq_range().stop() - 50e6; +    if (not vm.count("freq_start")) freq_start = usrp->get_fe_tx_freq_range().start(); +    if (not vm.count("freq_stop")) freq_stop = usrp->get_fe_tx_freq_range().stop(); + +    //check start and stop frequencies +    if (freq_start < usrp->get_fe_tx_freq_range().start()) +    { +        std::cerr << "freq_start must be " << usrp->get_fe_tx_freq_range().start() << " or greater for this daughter board" << std::endl; +        return EXIT_FAILURE; +    } +    if (freq_stop > usrp->get_fe_tx_freq_range().stop()) +    { +        std::cerr << "freq_stop must be " << usrp->get_fe_tx_freq_range().stop() << " or less for this daughter board" << std::endl; +        return EXIT_FAILURE; +    } + +    //check rx_offset +    double min_rx_offset = usrp->get_rx_freq_range().start() - usrp->get_fe_tx_freq_range().start(); +    double max_rx_offset = usrp->get_rx_freq_range().stop() - usrp->get_fe_tx_freq_range().stop(); +    if (rx_offset < min_rx_offset or rx_offset > max_rx_offset) +    { +        std::cerr << "rx_offset must be between " << min_rx_offset << " and " +            << max_rx_offset << " for this daughter board" << std::endl; +        return EXIT_FAILURE; +    } +      UHD_MSG(status) << boost::format("Calibration frequency range: %d MHz -> %d MHz") % (freq_start/1e6) % (freq_stop/1e6) << std::endl; -    for (double tx_lo_i = freq_start; tx_lo_i <= freq_stop; tx_lo_i += freq_step){ +    //set RX gain +    usrp->set_rx_gain(0); + +    for (double tx_lo_i = freq_start; tx_lo_i <= freq_stop; tx_lo_i += freq_step) +    {          const double tx_lo = tune_rx_and_tx(usrp, tx_lo_i, rx_offset);          //frequency constants for this tune event @@ -159,69 +207,75 @@ int UHD_SAFE_MAIN(int argc, char *argv[]){          const double actual_rx_freq = usrp->get_rx_freq();          const double bb_dc_freq = actual_tx_freq - actual_rx_freq; -        //capture initial uncorrected value +        //reset TX DC offset          usrp->set_tx_dc_offset(std::complex<double>(0, 0)); + +        //capture initial uncorrected value          capture_samples(usrp, rx_stream, buff, nsamps);          const double initial_dc_dbrms = compute_tone_dbrms(buff, bb_dc_freq/actual_rx_rate);          //bounds and results from searching -        double dc_i_start = -.01, dc_i_stop = .01, dc_i_step; -        double dc_q_start = -.01, dc_q_stop = .01, dc_q_step; -        double lowest_offset = 0, best_dc_i = 0, best_dc_q = 0; - -        for (size_t i = 0; i < num_search_iters; i++){ - -            dc_i_step = (dc_i_stop - dc_i_start)/(num_search_steps-1); -            dc_q_step = (dc_q_stop - dc_q_start)/(num_search_steps-1); - -            for (double dc_i = dc_i_start; dc_i <= dc_i_stop + dc_i_step/2; dc_i += dc_i_step){ -            for (double dc_q = dc_q_start; dc_q <= dc_q_stop + dc_q_step/2; dc_q += dc_q_step){ - -                const std::complex<double> correction(dc_i, dc_q); -                usrp->set_tx_dc_offset(correction); - -                //receive some samples -                capture_samples(usrp, rx_stream, buff, nsamps); - -                const double dc_dbrms = compute_tone_dbrms(buff, bb_dc_freq/actual_rx_rate); - -                if (dc_dbrms < lowest_offset){ -                    lowest_offset = dc_dbrms; -                    best_dc_i = dc_i; -                    best_dc_q = dc_q; +        double i_corr_start = -1.0; +        double i_corr_stop = 1.0; +        double i_corr_step = (i_corr_stop - i_corr_start)/(num_search_steps+1); +        double q_corr_start = -1.0; +        double q_corr_stop = 1.0; +        double q_corr_step= (q_corr_stop - q_corr_start)/(num_search_steps+1); +        double best_dc_dbrms = initial_dc_dbrms; +        double best_i_corr = 0; +        double best_q_corr = 0; +        while (i_corr_step >= precision or q_corr_step >= precision) +        { +            for (double i_corr = i_corr_start + i_corr_step; i_corr <= i_corr_stop - i_corr_step; i_corr += i_corr_step) +            { +                for (double q_corr = q_corr_start + q_corr_step; q_corr <= q_corr_stop - q_corr_step; q_corr += q_corr_step) +                { +                    const std::complex<double> correction(i_corr, q_corr); +                    usrp->set_tx_dc_offset(correction); + +                    //receive some samples +                    capture_samples(usrp, rx_stream, buff, nsamps); +                    const double dc_dbrms = compute_tone_dbrms(buff, bb_dc_freq/actual_rx_rate); + +                    if (dc_dbrms < best_dc_dbrms) +                    { +                        best_dc_dbrms = dc_dbrms; +                        best_i_corr = i_corr; +                        best_q_corr = q_corr; +                    }                  } +            } -            }} - -            //std::cout << "best_dc_i " << best_dc_i << std::endl; -            //std::cout << "best_dc_q " << best_dc_q << std::endl; -            //std::cout << "lowest_offset " << lowest_offset << std::endl; - -            dc_i_start = best_dc_i - dc_i_step; -            dc_i_stop = best_dc_i + dc_i_step; -            dc_q_start = best_dc_q - dc_q_step; -            dc_q_stop = best_dc_q + dc_q_step; +            i_corr_start = best_i_corr - i_corr_step; +            i_corr_stop = best_i_corr + i_corr_step; +            i_corr_step = (i_corr_stop - i_corr_start)/(num_search_steps+1); +            q_corr_start = best_q_corr - q_corr_step; +            q_corr_stop = best_q_corr + q_corr_step; +            q_corr_step = (q_corr_stop - q_corr_start)/(num_search_steps+1);          } -        if (lowest_offset < initial_dc_dbrms){ //most likely valid, keep result +        if (best_dc_dbrms < initial_dc_dbrms)   //keep result +        {              result_t result;              result.freq = tx_lo; -            result.real_corr = best_dc_i; -            result.imag_corr = best_dc_q; -            result.best = lowest_offset; -            result.delta = initial_dc_dbrms - lowest_offset; +            result.real_corr = best_i_corr; +            result.imag_corr = best_q_corr; +            result.best = best_dc_dbrms; +            result.delta = initial_dc_dbrms - best_dc_dbrms;              results.push_back(result); -            if (vm.count("verbose")){ +            if (vm.count("verbose"))                  std::cout << boost::format("TX DC: %f MHz: lowest offset %f dB, corrected %f dB") % (tx_lo/1e6) % result.best % result.delta << std::endl; -            } -            else std::cout << "." << std::flush; +            else +                std::cout << "." << std::flush;          }      } +      std::cout << std::endl;      //stop the transmitter      threads.interrupt_all(); +    boost::this_thread::sleep(boost::posix_time::milliseconds(500));    //wait for threads to finish      threads.join_all();      store_results(results, "TX", "tx", "dc", serial); diff --git a/host/utils/uhd_cal_tx_iq_balance.cpp b/host/utils/uhd_cal_tx_iq_balance.cpp index 6461b3d71..5952cccc4 100644 --- a/host/utils/uhd_cal_tx_iq_balance.cpp +++ b/host/utils/uhd_cal_tx_iq_balance.cpp @@ -1,5 +1,5 @@  // -// Copyright 2010,2012 Ettus Research LLC +// Copyright 2010,2012,2014 Ettus Research LLC  //  // This program is free software: you can redistribute it and/or modify  // it under the terms of the GNU General Public License as published by @@ -31,9 +31,13 @@ namespace po = boost::program_options;  /***********************************************************************   * Transmit thread   **********************************************************************/ -static void tx_thread(uhd::usrp::multi_usrp::sptr usrp, const double tx_wave_freq, const double tx_wave_ampl){ +static void tx_thread(uhd::usrp::multi_usrp::sptr usrp, const double tx_wave_freq, const double tx_wave_ampl) +{      uhd::set_thread_priority_safe(); +    // set max TX gain +    usrp->set_tx_gain(usrp->get_tx_gain_range().stop()); +      //create a transmit streamer      uhd::stream_args_t stream_args("fc32"); //complex floats      uhd::tx_streamer::sptr tx_stream = usrp->get_tx_stream(stream_args); @@ -46,14 +50,14 @@ static void tx_thread(uhd::usrp::multi_usrp::sptr usrp, const double tx_wave_fre      //values for the wave table lookup      size_t index = 0;      const double tx_rate = usrp->get_tx_rate(); -    const size_t step = boost::math::iround(wave_table_len * tx_wave_freq/tx_rate); +    const size_t step = boost::math::iround(wave_table_len * tx_wave_freq / tx_rate);      wave_table table(tx_wave_ampl);      //fill buff and send until interrupted -    while (not boost::this_thread::interruption_requested()){ -        for (size_t i = 0; i < buff.size(); i++){ +    while (not boost::this_thread::interruption_requested()) +    { +        for (size_t i = 0; i < buff.size(); i++)              buff[i] = table(index += step); -        }          tx_stream->send(&buff.front(), buff.size(), md);      } @@ -65,7 +69,8 @@ static void tx_thread(uhd::usrp::multi_usrp::sptr usrp, const double tx_wave_fre  /***********************************************************************   * Tune RX and TX routine   **********************************************************************/ -static double tune_rx_and_tx(uhd::usrp::multi_usrp::sptr usrp, const double tx_lo_freq, const double rx_offset){ +static double tune_rx_and_tx(uhd::usrp::multi_usrp::sptr usrp, const double tx_lo_freq, const double rx_offset) +{      //tune the transmitter with no cordic      uhd::tune_request_t tx_tune_req(tx_lo_freq);      tx_tune_req.dsp_freq_policy = uhd::tune_request_t::POLICY_MANUAL; @@ -73,15 +78,25 @@ static double tune_rx_and_tx(uhd::usrp::multi_usrp::sptr usrp, const double tx_l      usrp->set_tx_freq(tx_tune_req);      //tune the receiver -    usrp->set_rx_freq(usrp->get_tx_freq() - rx_offset); +    double rx_freq = usrp->get_tx_freq() - rx_offset; +    double min_fe_rx_freq = usrp->get_fe_rx_freq_range().start(); +    double max_fe_rx_freq = usrp->get_fe_rx_freq_range().stop(); +    uhd::tune_request_t rx_tune_req(rx_freq); +    rx_tune_req.dsp_freq_policy = uhd::tune_request_t::POLICY_MANUAL; +    rx_tune_req.dsp_freq = 0; +    if (rx_freq < min_fe_rx_freq) +        rx_tune_req.dsp_freq = rx_freq - min_fe_rx_freq; +    else if (rx_freq > max_fe_rx_freq) +        rx_tune_req.dsp_freq = rx_freq - max_fe_rx_freq; +    usrp->set_rx_freq(rx_tune_req);      //wait for the LOs to become locked      boost::this_thread::sleep(boost::posix_time::milliseconds(50));      boost::system_time start = boost::get_system_time(); -    while (not usrp->get_tx_sensor("lo_locked").to_bool() or not usrp->get_rx_sensor("lo_locked").to_bool()){ -        if (boost::get_system_time() > start + boost::posix_time::milliseconds(100)){ +    while (not usrp->get_tx_sensor("lo_locked").to_bool() or not usrp->get_rx_sensor("lo_locked").to_bool()) +    { +        if (boost::get_system_time() > start + boost::posix_time::milliseconds(100))              throw std::runtime_error("timed out waiting for TX and/or RX LO to lock"); -        }      }      return usrp->get_tx_freq(); @@ -90,11 +105,13 @@ static double tune_rx_and_tx(uhd::usrp::multi_usrp::sptr usrp, const double tx_l  /***********************************************************************   * Main   **********************************************************************/ -int UHD_SAFE_MAIN(int argc, char *argv[]){ +int UHD_SAFE_MAIN(int argc, char *argv[]) +{      std::string args, subdev, serial;      double tx_wave_freq, tx_wave_ampl, rx_offset;      double freq_start, freq_stop, freq_step;      size_t nsamps; +    double precision;      po::options_description desc("Allowed options");      desc.add_options() @@ -108,7 +125,8 @@ int UHD_SAFE_MAIN(int argc, char *argv[]){          ("freq_start", po::value<double>(&freq_start), "Frequency start in Hz (do not specify for default)")          ("freq_stop", po::value<double>(&freq_stop), "Frequency stop in Hz (do not specify for default)")          ("freq_step", po::value<double>(&freq_step)->default_value(default_freq_step), "Step size for LO sweep in Hz") -        ("nsamps", po::value<size_t>(&nsamps)->default_value(default_num_samps), "Samples per data capture") +        ("nsamps", po::value<size_t>(&nsamps), "Samples per data capture") +        ("precision", po::value<double>(&precision)->default_value(default_precision), "Correction precision (default=0.0001)")      ;      po::variables_map vm; @@ -116,7 +134,8 @@ int UHD_SAFE_MAIN(int argc, char *argv[]){      po::notify(vm);      //print the help message -    if (vm.count("help")){ +    if (vm.count("help")) +    {          std::cout << boost::format("USRP Generate TX IQ Balance Calibration Table %s") % desc << std::endl;          std::cout <<              "This application measures leakage between RX and TX on a transceiver daughterboard to self-calibrate.\n" @@ -128,6 +147,9 @@ int UHD_SAFE_MAIN(int argc, char *argv[]){      // Create a USRP device      uhd::usrp::multi_usrp::sptr usrp = setup_usrp_for_cal(args, subdev, serial); +    if (not vm.count("nsamps")) +        nsamps = size_t(usrp->get_rx_rate() / default_fft_bin_size); +      //create a receive streamer      uhd::stream_args_t stream_args("fc32"); //complex floats      uhd::rx_streamer::sptr rx_stream = usrp->get_rx_stream(stream_args); @@ -142,11 +164,35 @@ int UHD_SAFE_MAIN(int argc, char *argv[]){      //store the results here      std::vector<result_t> results; -    if (not vm.count("freq_start")) freq_start = usrp->get_tx_freq_range().start() + 50e6; -    if (not vm.count("freq_stop")) freq_stop = usrp->get_tx_freq_range().stop() - 50e6; +    if (not vm.count("freq_start")) freq_start = usrp->get_fe_tx_freq_range().start(); +    if (not vm.count("freq_stop")) freq_stop = usrp->get_fe_tx_freq_range().stop(); + +    //check start and stop frequencies +    if (freq_start < usrp->get_fe_tx_freq_range().start()) +    { +        std::cerr << "freq_start must be " << usrp->get_fe_tx_freq_range().start() << " or greater for this daughter board" << std::endl; +        return EXIT_FAILURE; +    } +    if (freq_stop > usrp->get_fe_tx_freq_range().stop()) +    { +        std::cerr << "freq_stop must be " << usrp->get_fe_tx_freq_range().stop() << " or less for this daughter board" << std::endl; +        return EXIT_FAILURE; +    } + +    //check rx_offset +    double min_rx_offset = usrp->get_rx_freq_range().start() - usrp->get_fe_tx_freq_range().start(); +    double max_rx_offset = usrp->get_rx_freq_range().stop() - usrp->get_fe_tx_freq_range().stop(); +    if (rx_offset < min_rx_offset or rx_offset > max_rx_offset) +    { +        std::cerr << "rx_offset must be between " << min_rx_offset << " and " +            << max_rx_offset << " for this daughter board" << std::endl; +        return EXIT_FAILURE; +    } +      UHD_MSG(status) << boost::format("Calibration frequency range: %d MHz -> %d MHz") % (freq_start/1e6) % (freq_stop/1e6) << std::endl; -    for (double tx_lo_i = freq_start; tx_lo_i <= freq_stop; tx_lo_i += freq_step){ +    for (double tx_lo_i = freq_start; tx_lo_i <= freq_stop; tx_lo_i += freq_step) +    {          const double tx_lo = tune_rx_and_tx(usrp, tx_lo_i, rx_offset);          //frequency constants for this tune event @@ -156,73 +202,78 @@ int UHD_SAFE_MAIN(int argc, char *argv[]){          const double bb_tone_freq = actual_tx_freq + tx_wave_freq - actual_rx_freq;          const double bb_imag_freq = actual_tx_freq - tx_wave_freq - actual_rx_freq; -        //capture initial uncorrected value +        //reset TX IQ balance          usrp->set_tx_iq_balance(0.0); + +        //set optimal RX gain setting for this frequency +        set_optimal_rx_gain(usrp, rx_stream, tx_wave_freq); + +        //capture initial uncorrected value          capture_samples(usrp, rx_stream, buff, nsamps);          const double initial_suppression = compute_tone_dbrms(buff, bb_tone_freq/actual_rx_rate) - compute_tone_dbrms(buff, bb_imag_freq/actual_rx_rate);          //bounds and results from searching -        std::complex<double> best_correction; -        double phase_corr_start = -.3, phase_corr_stop = .3, phase_corr_step; -        double ampl_corr_start = -.3, ampl_corr_stop = .3, ampl_corr_step; -        double best_suppression = 0, best_phase_corr = 0, best_ampl_corr = 0; - -        for (size_t i = 0; i < num_search_iters; i++){ - -            phase_corr_step = (phase_corr_stop - phase_corr_start)/(num_search_steps-1); -            ampl_corr_step = (ampl_corr_stop - ampl_corr_start)/(num_search_steps-1); - -            for (double phase_corr = phase_corr_start; phase_corr <= phase_corr_stop + phase_corr_step/2; phase_corr += phase_corr_step){ -            for (double ampl_corr = ampl_corr_start; ampl_corr <= ampl_corr_stop + ampl_corr_step/2; ampl_corr += ampl_corr_step){ - -                const std::complex<double> correction(ampl_corr, phase_corr); -                usrp->set_tx_iq_balance(correction); - -                //receive some samples -                capture_samples(usrp, rx_stream, buff, nsamps); - -                const double tone_dbrms = compute_tone_dbrms(buff, bb_tone_freq/actual_rx_rate); -                const double imag_dbrms = compute_tone_dbrms(buff, bb_imag_freq/actual_rx_rate); -                const double suppression = tone_dbrms - imag_dbrms; - -                if (suppression > best_suppression){ -                    best_correction = correction; -                    best_suppression = suppression; -                    best_phase_corr = phase_corr; -                    best_ampl_corr = ampl_corr; +        double phase_corr_start = -1.0; +        double phase_corr_stop = 1.0; +        double phase_corr_step = (phase_corr_stop - phase_corr_start)/(num_search_steps+1); +        double ampl_corr_start = -1.0; +        double ampl_corr_stop = 1.0; +        double ampl_corr_step = (ampl_corr_stop - ampl_corr_start)/(num_search_steps+1); +        double best_suppression = 0; +        double best_phase_corr = 0; +        double best_ampl_corr = 0; +        while (phase_corr_step >= precision or ampl_corr_step >= precision) +        { +            for (double phase_corr = phase_corr_start + phase_corr_step; phase_corr <= phase_corr_stop - phase_corr_step; phase_corr += phase_corr_step) +            { +                for (double ampl_corr = ampl_corr_start + ampl_corr_step; ampl_corr <= ampl_corr_stop - ampl_corr_step; ampl_corr += ampl_corr_step) +                { +                    const std::complex<double> correction(ampl_corr, phase_corr); +                    usrp->set_tx_iq_balance(correction); + +                    //receive some samples +                    capture_samples(usrp, rx_stream, buff, nsamps); +                    const double tone_dbrms = compute_tone_dbrms(buff, bb_tone_freq/actual_rx_rate); +                    const double imag_dbrms = compute_tone_dbrms(buff, bb_imag_freq/actual_rx_rate); +                    const double suppression = tone_dbrms - imag_dbrms; + +                    if (suppression > best_suppression) +                    { +                        best_suppression = suppression; +                        best_phase_corr = phase_corr; +                        best_ampl_corr = ampl_corr; +                    }                  } - -            }} - -            //std::cout << "best_phase_corr " << best_phase_corr << std::endl; -            //std::cout << "best_ampl_corr " << best_ampl_corr << std::endl; -            //std::cout << "best_suppression " << best_suppression << std::endl; +            }              phase_corr_start = best_phase_corr - phase_corr_step;              phase_corr_stop = best_phase_corr + phase_corr_step; +            phase_corr_step = (phase_corr_stop - phase_corr_start)/(num_search_steps+1);              ampl_corr_start = best_ampl_corr - ampl_corr_step;              ampl_corr_stop = best_ampl_corr + ampl_corr_step; +            ampl_corr_step = (ampl_corr_stop - ampl_corr_start)/(num_search_steps+1);          } -        if (best_suppression > 30){ //most likely valid, keep result +        if (best_suppression > initial_suppression) //keep result +        {              result_t result;              result.freq = tx_lo; -            result.real_corr = best_correction.real(); -            result.imag_corr = best_correction.imag(); +            result.real_corr = best_ampl_corr; +            result.imag_corr = best_phase_corr;              result.best = best_suppression;              result.delta = best_suppression - initial_suppression;              results.push_back(result); -            if (vm.count("verbose")){ +            if (vm.count("verbose"))                  std::cout << boost::format("TX IQ: %f MHz: best suppression %f dB, corrected %f dB") % (tx_lo/1e6) % result.best % result.delta << std::endl; -            } -            else std::cout << "." << std::flush; +            else +                std::cout << "." << std::flush;          } -      }      std::cout << std::endl;      //stop the transmitter      threads.interrupt_all(); +    boost::this_thread::sleep(boost::posix_time::milliseconds(500));    //wait for threads to finish      threads.join_all();      store_results(results, "TX", "tx", "iq", serial); diff --git a/host/utils/usrp_cal_utils.hpp b/host/utils/usrp_cal_utils.hpp index 9e7f4c469..6673b6329 100644 --- a/host/utils/usrp_cal_utils.hpp +++ b/host/utils/usrp_cal_utils.hpp @@ -1,5 +1,5 @@  // -// Copyright 2011-2012 Ettus Research LLC +// Copyright 2011-2012,2014 Ettus Research LLC  //  // This program is free software: you can redistribute it and/or modify  // it under the terms of the GNU General Public License as published by @@ -41,82 +41,77 @@ typedef std::complex<float> samp_type;   * Constants   **********************************************************************/  static const double tau = 6.28318531; -static const size_t wave_table_len = 8192; +static const size_t wave_table_len = 65536;  static const size_t num_search_steps = 5; -static const size_t num_search_iters = 7; +static const double default_precision = 0.0001;  static const double default_freq_step = 7.3e6; -static const size_t default_num_samps = 10000; +static const size_t default_fft_bin_size = 1000;  /***********************************************************************   * Set standard defaults for devices   **********************************************************************/ -static inline void set_optimum_defaults(uhd::usrp::multi_usrp::sptr usrp){ +static inline void set_optimum_defaults(uhd::usrp::multi_usrp::sptr usrp) +{      uhd::property_tree::sptr tree = usrp->get_device()->get_tree();      // Will work on 1st subdev, top-level must make sure it's the right one      uhd::usrp::subdev_spec_t subdev_spec = usrp->get_rx_subdev_spec();      const uhd::fs_path mb_path = "/mboards/0";      const std::string mb_name = tree->access<std::string>(mb_path / "name").get(); -    if (mb_name.find("USRP2") != std::string::npos or mb_name.find("N200") != std::string::npos or mb_name.find("N210") != std::string::npos  or mb_name.find("X300") != std::string::npos  or mb_name.find("X310") != std::string::npos){ +    if (mb_name.find("USRP2") != std::string::npos or +        mb_name.find("N200") != std::string::npos or +        mb_name.find("N210") != std::string::npos or +        mb_name.find("X300") != std::string::npos or +        mb_name.find("X310") != std::string::npos) +    {          usrp->set_tx_rate(12.5e6);          usrp->set_rx_rate(12.5e6);      } -    else if (mb_name.find("B100") != std::string::npos){ +    else if (mb_name.find("B100") != std::string::npos) +    {          usrp->set_tx_rate(4e6);          usrp->set_rx_rate(4e6);      } -    else if (mb_name.find("E100") != std::string::npos or mb_name.find("E110") != std::string::npos){ +    else if (mb_name.find("E100") != std::string::npos or mb_name.find("E110") != std::string::npos) +    {          usrp->set_tx_rate(4e6);          usrp->set_rx_rate(8e6);      } -    else{ -        throw std::runtime_error("self-calibration is not supported for this hardware"); +    else +    { +        throw std::runtime_error("self-calibration is not supported for this device");      }      const uhd::fs_path tx_fe_path = "/mboards/0/dboards/" + subdev_spec[0].db_name + "/tx_frontends/0";      const std::string tx_name = tree->access<std::string>(tx_fe_path / "name").get(); -    if (tx_name.find("WBX") != std::string::npos){ -        usrp->set_tx_gain(0); -    } -    else if (tx_name.find("SBX") != std::string::npos){ -        usrp->set_tx_gain(0); -    } -    else if (tx_name.find("CBX") != std::string::npos){ -        usrp->set_tx_gain(0); -    } -    else if (tx_name.find("RFX") != std::string::npos){ -        usrp->set_tx_gain(0); -    } -    else{ -        throw std::runtime_error("self-calibration is not supported for this hardware"); +    if (tx_name.find("WBX") == std::string::npos and +        tx_name.find("SBX") == std::string::npos and +        tx_name.find("CBX") == std::string::npos and +        tx_name.find("RFX") == std::string::npos +        ) +    { +        throw std::runtime_error("self-calibration is not supported for this TX dboard");      } +    usrp->set_tx_gain(0);      const uhd::fs_path rx_fe_path = "/mboards/0/dboards/" + subdev_spec[0].db_name + "/rx_frontends/0";      const std::string rx_name = tree->access<std::string>(rx_fe_path / "name").get(); -    if (rx_name.find("WBX") != std::string::npos){ -        usrp->set_rx_gain(25); -    } -    else if (rx_name.find("SBX") != std::string::npos){ -        usrp->set_rx_gain(25); +    if (rx_name.find("WBX") == std::string::npos and +        rx_name.find("SBX") == std::string::npos and +        rx_name.find("CBX") == std::string::npos and +        rx_name.find("RFX") == std::string::npos +        ) +    { +        throw std::runtime_error("self-calibration is not supported for this RX dboard");      } -    else if (rx_name.find("CBX") != std::string::npos){ -        usrp->set_rx_gain(25); -    } -    else if (rx_name.find("RFX") != std::string::npos){ -        usrp->set_rx_gain(25); -    } -    else{ -        throw std::runtime_error("self-calibration is not supported for this hardware"); -    } - +    usrp->set_rx_gain(0);  }  /***********************************************************************   * Check for empty serial   **********************************************************************/ -void check_for_empty_serial( -    uhd::usrp::multi_usrp::sptr usrp -){ +void check_for_empty_serial(uhd::usrp::multi_usrp::sptr usrp) +{      // Will work on 1st subdev, top-level must make sure it's the right one      uhd::usrp::subdev_spec_t subdev_spec = usrp->get_rx_subdev_spec(); @@ -127,22 +122,25 @@ void check_for_empty_serial(      const uhd::usrp::dboard_eeprom_t db_eeprom = tree->access<uhd::usrp::dboard_eeprom_t>(db_path).get();      std::string error_string = "This dboard has no serial!\n\nPlease see the Calibration documentation for details on how to fix this."; -    if (db_eeprom.serial.empty()) throw std::runtime_error(error_string); +    if (db_eeprom.serial.empty()) +        throw std::runtime_error(error_string);  }  /***********************************************************************   * Sinusoid wave table   **********************************************************************/ -class wave_table{ +class wave_table +{  public: -    wave_table(const double ampl){ +    wave_table(const double ampl) +    {          _table.resize(wave_table_len); -        for (size_t i = 0; i < wave_table_len; i++){ +        for (size_t i = 0; i < wave_table_len; i++)              _table[i] = samp_type(std::polar(ampl, (tau*i)/wave_table_len)); -        }      } -    inline samp_type operator()(const size_t index) const{ +    inline samp_type operator()(const size_t index) const +    {          return _table[index % wave_table_len];      } @@ -154,15 +152,14 @@ private:   * Compute power of a tone   **********************************************************************/  static inline double compute_tone_dbrms( -    const std::vector<samp_type > &samples, -    const double freq //freq is fractional -){ +    const std::vector<samp_type> &samples, +    const double freq)  //freq is fractional +{      //shift the samples so the tone at freq is down at DC      //and average the samples to measure the DC component      samp_type average = 0; -    for (size_t i = 0; i < samples.size(); i++){ +    for (size_t i = 0; i < samples.size(); i++)          average += samp_type(std::polar(1.0, -freq*tau*i)) * samples[i]; -    }      return 20*std::log10(std::abs(average/float(samples.size())));  } @@ -171,8 +168,8 @@ static inline double compute_tone_dbrms(   * Write a dat file   **********************************************************************/  static inline void write_samples_to_file( -    const std::vector<samp_type > &samples, const std::string &file -){ +    const std::vector<samp_type > &samples, const std::string &file) +{      std::ofstream outfile(file.c_str(), std::ofstream::binary);      outfile.write((const char*)&samples.front(), samples.size()*sizeof(samp_type));      outfile.close(); @@ -184,8 +181,8 @@ static inline void write_samples_to_file(   **********************************************************************/  static std::string get_serial(      uhd::usrp::multi_usrp::sptr usrp, -    const std::string &tx_rx -){ +    const std::string &tx_rx) +{      uhd::property_tree::sptr tree = usrp->get_device()->get_tree();      // Will work on 1st subdev, top-level must make sure it's the right one      uhd::usrp::subdev_spec_t subdev_spec = usrp->get_rx_subdev_spec(); @@ -202,17 +199,16 @@ static void store_results(      const std::string &XX, // "TX" or "RX"      const std::string &xx, // "tx" or "rx"      const std::string &what, // Type of test, e.g. "iq", -    const std::string &serial -){ +    const std::string &serial) +{      //make the calibration file path      fs::path cal_data_path = fs::path(uhd::get_app_path()) / ".uhd";      fs::create_directory(cal_data_path);      cal_data_path = cal_data_path / "cal";      fs::create_directory(cal_data_path);      cal_data_path = cal_data_path / str(boost::format("%s_%s_cal_v0.2_%s.csv") % xx % what % serial); -    if (fs::exists(cal_data_path)){ +    if (fs::exists(cal_data_path))          fs::rename(cal_data_path, cal_data_path.string() + str(boost::format(".%d") % time(NULL))); -    }      //fill the calibration file      std::ofstream cal_data(cal_data_path.string().c_str()); @@ -223,7 +219,8 @@ static void store_results(      cal_data << boost::format("DATA STARTS HERE\n");      cal_data << "lo_frequency, correction_real, correction_imag, measured, delta\n"; -    for (size_t i = 0; i < results.size(); i++){ +    for (size_t i = 0; i < results.size(); i++) +    {          cal_data              << results[i].freq << ", "              << results[i].real_corr << ", " @@ -243,31 +240,50 @@ static void capture_samples(      uhd::usrp::multi_usrp::sptr usrp,      uhd::rx_streamer::sptr rx_stream,      std::vector<samp_type > &buff, -    const size_t nsamps_requested -){ +    const size_t nsamps_requested) +{      buff.resize(nsamps_requested);      uhd::rx_metadata_t md; +    // Right after the stream is started, there will be transient data. +    // That transient data is discarded and only "good" samples are returned. +    size_t nsamps_to_discard = usrp->get_rx_rate() * 0.001; // 1ms to be discarded +    std::vector<samp_type> discard_buff(nsamps_to_discard); +      uhd::stream_cmd_t stream_cmd(uhd::stream_cmd_t::STREAM_MODE_NUM_SAMPS_AND_DONE); -    stream_cmd.num_samps = buff.size(); +    stream_cmd.num_samps = buff.size() + nsamps_to_discard;      stream_cmd.stream_now = true;      usrp->issue_stream_cmd(stream_cmd); -    const size_t num_rx_samps = rx_stream->recv(&buff.front(), buff.size(), md); +    size_t num_rx_samps = 0; + +    // Discard the transient samples. +    rx_stream->recv(&discard_buff.front(), discard_buff.size(), md); +    if (md.error_code != uhd::rx_metadata_t::ERROR_CODE_NONE) +    { +        throw std::runtime_error(str(boost::format( +            "Receiver error: %s" +        ) % md.strerror())); +    } + +    // Now capture the data we want +    num_rx_samps = rx_stream->recv(&buff.front(), buff.size(), md);      //validate the received data -    if (md.error_code != uhd::rx_metadata_t::ERROR_CODE_NONE){ +    if (md.error_code != uhd::rx_metadata_t::ERROR_CODE_NONE) +    {          throw std::runtime_error(str(boost::format(              "Receiver error: %s"          ) % md.strerror()));      } +      //we can live if all the data didnt come in -    if (num_rx_samps > buff.size()/2){ +    if (num_rx_samps > buff.size()/2) +    {          buff.resize(num_rx_samps);          return;      } -    if (num_rx_samps != buff.size()){ +    if (num_rx_samps != buff.size())          throw std::runtime_error("did not get all the samples requested"); -    }  }  /*********************************************************************** @@ -280,7 +296,8 @@ static uhd::usrp::multi_usrp::sptr setup_usrp_for_cal(std::string &args, std::st      uhd::usrp::multi_usrp::sptr usrp = uhd::usrp::multi_usrp::make(args);      // Configure subdev -    if (!subdev.empty()) { +    if (!subdev.empty()) +    {          usrp->set_tx_subdev_spec(subdev);          usrp->set_rx_subdev_spec(subdev);      } @@ -289,9 +306,8 @@ static uhd::usrp::multi_usrp::sptr setup_usrp_for_cal(std::string &args, std::st      UHD_MSG(status) << "Daughterboard serial: " << serial << std::endl;      //set the antennas to cal -    if (not uhd::has(usrp->get_rx_antennas(), "CAL") or not uhd::has(usrp->get_tx_antennas(), "CAL")){ +    if (not uhd::has(usrp->get_rx_antennas(), "CAL") or not uhd::has(usrp->get_tx_antennas(), "CAL"))          throw std::runtime_error("This board does not have the CAL antenna option, cannot self-calibrate."); -    }      usrp->set_rx_antenna("CAL");      usrp->set_tx_antenna("CAL"); @@ -304,3 +320,72 @@ static uhd::usrp::multi_usrp::sptr setup_usrp_for_cal(std::string &args, std::st      return usrp;  } +/*********************************************************************** + * Function to find optimal RX gain setting (for the current frequency) + **********************************************************************/ +UHD_INLINE void set_optimal_rx_gain( +    uhd::usrp::multi_usrp::sptr usrp, +    uhd::rx_streamer::sptr rx_stream, +    double wave_freq = 0.0) +{ +    const double gain_step = 3.0; +    const double gain_compression_threshold = gain_step * 0.5; +    const double actual_rx_rate = usrp->get_rx_rate(); +    const double actual_tx_freq = usrp->get_tx_freq(); +    const double actual_rx_freq = usrp->get_rx_freq(); +    const double bb_tone_freq = actual_tx_freq - actual_rx_freq + wave_freq; +    const size_t nsamps = size_t(actual_rx_rate / default_fft_bin_size); + +    std::vector<samp_type> buff(nsamps); +    uhd::gain_range_t rx_gain_range = usrp->get_rx_gain_range(); +    double rx_gain = rx_gain_range.start() + gain_step; +    double curr_dbrms = 0.0; +    double prev_dbrms = 0.0; +    double delta = 0.0; + +    // No sense in setting the gain where this is no gain range +    if (rx_gain_range.stop() - rx_gain_range.start() < gain_step) +        return; + +    // The algorithm below cycles through the RX gain range +    // looking for the point where the signal begins to get +    // clipped and the gain begins to be compressed.  It does +    // this by looking for the gain setting where the increase +    // in the tone is less than the gain step by more than the +    // gain compression threshold (curr - prev < gain - threshold). + +    // Initialize prev_dbrms value +    usrp->set_rx_gain(rx_gain); +    capture_samples(usrp, rx_stream, buff, nsamps); +    prev_dbrms = compute_tone_dbrms(buff, bb_tone_freq/actual_rx_rate); +    rx_gain += gain_step; + +    // Find RX gain where signal begins to clip +    while (rx_gain <= rx_gain_range.stop()) +    { +        usrp->set_rx_gain(rx_gain); +        capture_samples(usrp, rx_stream, buff, nsamps); +        curr_dbrms = compute_tone_dbrms(buff, bb_tone_freq/actual_rx_rate); +        delta = curr_dbrms - prev_dbrms; + +        // check if the gain is compressed beyone the threshold +        if (delta < gain_step - gain_compression_threshold) +            break;  // if so, we are done + +        prev_dbrms = curr_dbrms; +        rx_gain += gain_step; +    } + +    // The rx_gain value at this point is the gain setting where clipping +    // occurs or the gain setting that is just beyond the gain range. +    // The gain is reduced by 2 steps to make sure it is within the range and +    // under the point where it is clipped with enough room to make adjustments. +    rx_gain -= 2 * gain_step; + +    // Make sure the gain is within the range. +    rx_gain = rx_gain_range.clip(rx_gain); + +    // Finally, set the gain. +    usrp->set_rx_gain(rx_gain); +} +  | 
