diff options
Diffstat (limited to 'host/lib/usrp/common')
| -rw-r--r-- | host/lib/usrp/common/CMakeLists.txt | 1 | ||||
| -rw-r--r-- | host/lib/usrp/common/apply_corrections.cpp | 217 | ||||
| -rw-r--r-- | host/lib/usrp/common/apply_corrections.hpp | 41 | 
3 files changed, 259 insertions, 0 deletions
| diff --git a/host/lib/usrp/common/CMakeLists.txt b/host/lib/usrp/common/CMakeLists.txt index ec8b60fec..9abd34afa 100644 --- a/host/lib/usrp/common/CMakeLists.txt +++ b/host/lib/usrp/common/CMakeLists.txt @@ -29,6 +29,7 @@ ENDIF(ENABLE_USB)  INCLUDE_DIRECTORIES(${CMAKE_CURRENT_SOURCE_DIR})  LIBUHD_APPEND_SOURCES( +    ${CMAKE_CURRENT_SOURCE_DIR}/apply_corrections.cpp      ${CMAKE_CURRENT_SOURCE_DIR}/validate_subdev_spec.cpp      ${CMAKE_CURRENT_SOURCE_DIR}/recv_packet_demuxer.cpp  ) diff --git a/host/lib/usrp/common/apply_corrections.cpp b/host/lib/usrp/common/apply_corrections.cpp new file mode 100644 index 000000000..6aee00753 --- /dev/null +++ b/host/lib/usrp/common/apply_corrections.cpp @@ -0,0 +1,217 @@ +// +// Copyright 2011 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 +// the Free Software Foundation, either version 3 of the License, or +// (at your option) any later version. +// +// This program is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the +// GNU General Public License for more details. +// +// You should have received a copy of the GNU General Public License +// along with this program.  If not, see <http://www.gnu.org/licenses/>. +// + +#include "apply_corrections.hpp" +#include <uhd/usrp/dboard_eeprom.hpp> +#include <uhd/utils/paths.hpp> +#include <uhd/utils/msg.hpp> +#include <uhd/utils/csv.hpp> +#include <uhd/types/dict.hpp> +#include <boost/filesystem.hpp> +#include <boost/foreach.hpp> +#include <boost/thread/mutex.hpp> +#include <cstdio> +#include <complex> +#include <fstream> + +namespace fs = boost::filesystem; + +boost::mutex corrections_mutex; + +/*********************************************************************** + * Helper routines + **********************************************************************/ +static double linear_interp(double x, double x0, double y0, double x1, double y1){ +    return y0 + (x - x0)*(y1 - y0)/(x1 - x0); +} + +/*********************************************************************** + * FE apply corrections implementation + **********************************************************************/ +struct fe_cal_t{ +    double lo_freq; +    double iq_corr_real; +    double iq_corr_imag; +}; + +static bool fe_cal_comp(fe_cal_t a, fe_cal_t b){ +    return (a.lo_freq < b.lo_freq); +} + +static uhd::dict<std::string, std::vector<fe_cal_t> > fe_cal_cache; + +static std::complex<double> get_fe_dc_correction( +    const std::string &key, const double lo_freq +){ +    const std::vector<fe_cal_t> &datas = fe_cal_cache[key]; +    if (datas.empty()) throw uhd::runtime_error("empty calibration table " + key); + +    //search for lo freq +    size_t lo_index = 0; +    size_t hi_index = datas.size()-1; +    for (size_t i = 0; i < datas.size(); i++){ +        if (datas[i].lo_freq > lo_freq){ +            hi_index = i; +            break; +        } +        lo_index = i; +    } + +    if (lo_index == 0) return std::complex<double>(datas[lo_index].iq_corr_real, datas[lo_index].iq_corr_imag); +    if (hi_index == lo_index) return std::complex<double>(datas[hi_index].iq_corr_real, datas[hi_index].iq_corr_imag); + +    //interpolation time +    return std::complex<double>( +        linear_interp(lo_freq, datas[lo_index].lo_freq, datas[lo_index].iq_corr_real, datas[hi_index].lo_freq, datas[hi_index].iq_corr_real), +        linear_interp(lo_freq, datas[lo_index].lo_freq, datas[lo_index].iq_corr_imag, datas[hi_index].lo_freq, datas[hi_index].iq_corr_imag) +    ); +} + +static std::complex<double> get_fe_iq_correction( +    const std::string &key, const double lo_freq +){ +    const std::vector<fe_cal_t> &datas = fe_cal_cache[key]; +    if (datas.empty()) throw uhd::runtime_error("empty calibration table " + key); + +    //search for lo freq +    size_t lo_index = 0; +    size_t hi_index = datas.size()-1; +    for (size_t i = 0; i < datas.size(); i++){ +        if (datas[i].lo_freq > lo_freq){ +            hi_index = i; +            break; +        } +        lo_index = i; +    } + +    if (lo_index == 0) return std::complex<double>(datas[lo_index].iq_corr_real, datas[lo_index].iq_corr_imag); +    if (hi_index == lo_index) return std::complex<double>(datas[hi_index].iq_corr_real, datas[hi_index].iq_corr_imag); + +    const std::complex<double> lo_val(datas[lo_index].iq_corr_real, datas[lo_index].iq_corr_imag); +    const std::complex<double> hi_val(datas[hi_index].iq_corr_real, datas[hi_index].iq_corr_imag); + +    //interpolation time +    return std::polar<double>( +        linear_interp(lo_freq, datas[lo_index].lo_freq, std::abs(lo_val), datas[hi_index].lo_freq, std::abs(hi_val)), +        linear_interp(lo_freq, datas[lo_index].lo_freq, std::arg(lo_val), datas[hi_index].lo_freq, std::arg(hi_val)) +    ); +} + +static void apply_fe_corrections( +    uhd::property_tree::sptr sub_tree, +    const uhd::fs_path &db_path, +    const uhd::fs_path &fe_path, +    const std::string &file_prefix, +    const double lo_freq +){ +    //extract eeprom serial +    const uhd::usrp::dboard_eeprom_t db_eeprom = sub_tree->access<uhd::usrp::dboard_eeprom_t>(db_path).get(); + +    //make the calibration file path +    const fs::path cal_data_path = fs::path(uhd::get_app_path()) / ".uhd" / "cal" / (file_prefix + db_eeprom.serial + ".csv"); +    if (not fs::exists(cal_data_path)) return; + +    //parse csv file or get from cache +    if (not fe_cal_cache.has_key(cal_data_path.string())){ +        std::ifstream cal_data(cal_data_path.string().c_str()); +        const uhd::csv::rows_type rows = uhd::csv::to_rows(cal_data); + +        bool read_data = false, skip_next = false;; +        std::vector<fe_cal_t> datas; +        BOOST_FOREACH(const uhd::csv::row_type &row, rows){ +            if (not read_data and not row.empty() and row[0] == "DATA STARTS HERE"){ +                read_data = true; +                skip_next = true; +                continue; +            } +            if (not read_data) continue; +            if (skip_next){ +                skip_next = false; +                continue; +            } +            fe_cal_t data; +            std::sscanf(row[0].c_str(), "%lf" , &data.lo_freq); +            std::sscanf(row[1].c_str(), "%lf" , &data.iq_corr_real); +            std::sscanf(row[2].c_str(), "%lf" , &data.iq_corr_imag); +            datas.push_back(data); +        } +        std::sort(datas.begin(), datas.end(), fe_cal_comp); +        fe_cal_cache[cal_data_path.string()] = datas; +        UHD_MSG(status) << "Loaded " << cal_data_path.string() << std::endl; + +    } + +    if (file_prefix.find("dc_cal") != std::string::npos){ +        sub_tree->access<std::complex<double> >(fe_path) +            .set(get_fe_dc_correction(cal_data_path.string(), lo_freq)); +    } +    else if (file_prefix.find("iq_cal") != std::string::npos){ +        sub_tree->access<std::complex<double> >(fe_path) +            .set(get_fe_iq_correction(cal_data_path.string(), lo_freq)); +    } +    else throw uhd::runtime_error("could not determine interpolation function"); +} + +/*********************************************************************** + * Wrapper routines with nice try/catch + print + **********************************************************************/ +void uhd::usrp::apply_tx_fe_corrections( +    property_tree::sptr sub_tree, //starts at mboards/x +    const std::string &slot, //name of dboard slot +    const double lo_freq //actual lo freq +){ +    boost::mutex::scoped_lock l(corrections_mutex); +    try{ +        apply_fe_corrections( +            sub_tree, +            "dboards/" + slot + "/tx_eeprom", +            "tx_frontends/" + slot + "/iq_balance/value", +            "tx_iq_cal_v0.1_", +            lo_freq +        ); +        apply_fe_corrections( +            sub_tree, +            "dboards/" + slot + "/tx_eeprom", +            "tx_frontends/" + slot + "/dc_offset/value", +            "tx_dc_cal_v0.1_", +            lo_freq +        ); +    } +    catch(const std::exception &e){ +        UHD_MSG(error) << "Failure in apply_tx_fe_corrections: " << e.what() << std::endl; +    } +} + +void uhd::usrp::apply_rx_fe_corrections( +    property_tree::sptr sub_tree, //starts at mboards/x +    const std::string &slot, //name of dboard slot +    const double lo_freq //actual lo freq +){ +    boost::mutex::scoped_lock l(corrections_mutex); +    try{ +        apply_fe_corrections( +            sub_tree, +            "dboards/" + slot + "/rx_eeprom", +            "rx_frontends/" + slot + "/iq_balance/value", +            "rx_iq_cal_v0.1_", +            lo_freq +        ); +    } +    catch(const std::exception &e){ +        UHD_MSG(error) << "Failure in apply_rx_fe_corrections: " << e.what() << std::endl; +    } +} diff --git a/host/lib/usrp/common/apply_corrections.hpp b/host/lib/usrp/common/apply_corrections.hpp new file mode 100644 index 000000000..c516862d1 --- /dev/null +++ b/host/lib/usrp/common/apply_corrections.hpp @@ -0,0 +1,41 @@ +// +// Copyright 2011 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 +// the Free Software Foundation, either version 3 of the License, or +// (at your option) any later version. +// +// This program is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the +// GNU General Public License for more details. +// +// You should have received a copy of the GNU General Public License +// along with this program.  If not, see <http://www.gnu.org/licenses/>. +// + +#ifndef INCLUDED_LIBUHD_USRP_COMMON_APPLY_CORRECTIONS_HPP +#define INCLUDED_LIBUHD_USRP_COMMON_APPLY_CORRECTIONS_HPP + +#include <uhd/config.hpp> +#include <uhd/property_tree.hpp> +#include <string> + +namespace uhd{ namespace usrp{ + +    void apply_tx_fe_corrections( +        property_tree::sptr sub_tree, //starts at mboards/x +        const std::string &slot, //name of dboard slot +        const double tx_lo_freq //actual lo freq +    ); + +    void apply_rx_fe_corrections( +        property_tree::sptr sub_tree, //starts at mboards/x +        const std::string &slot, //name of dboard slot +        const double rx_lo_freq //actual lo freq +    ); + +}} //namespace uhd::usrp + +#endif /* INCLUDED_LIBUHD_USRP_COMMON_APPLY_CORRECTIONS_HPP */ | 
