// // 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 . // #include "apply_corrections.hpp" #include #include #include #include #include #include #include #include #include #include #include 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 > fe_cal_cache; static std::complex get_fe_dc_correction( const std::string &key, const double lo_freq ){ const std::vector &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(datas[lo_index].iq_corr_real, datas[lo_index].iq_corr_imag); if (hi_index == lo_index) return std::complex(datas[hi_index].iq_corr_real, datas[hi_index].iq_corr_imag); //interpolation time return std::complex( 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 get_fe_iq_correction( const std::string &key, const double lo_freq ){ const std::vector &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(datas[lo_index].iq_corr_real, datas[lo_index].iq_corr_imag); if (hi_index == lo_index) return std::complex(datas[hi_index].iq_corr_real, datas[hi_index].iq_corr_imag); const std::complex lo_val(datas[lo_index].iq_corr_real, datas[lo_index].iq_corr_imag); const std::complex hi_val(datas[hi_index].iq_corr_real, datas[hi_index].iq_corr_imag); //interpolation time return std::polar( 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(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 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 >(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 >(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; } }