// // Copyright 2011-2016 Ettus Research LLC // Copyright 2018 Ettus Research, a National Instruments Company // // SPDX-License-Identifier: GPL-3.0-or-later // #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 bool is_same_freq(const double f1, const double f2) { const double epsilon = 0.1; return ((f1 - epsilon) < f2 and (f1 + epsilon) > f2); } static std::complex get_fe_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 (is_same_freq(datas[i].lo_freq, lo_freq)) { hi_index = i; lo_index = i; break; } 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 void apply_fe_corrections(uhd::property_tree::sptr sub_tree, const std::string& db_serial, const uhd::fs_path& fe_path, const std::string& file_prefix, const double lo_freq) { // make the calibration file path const fs::path cal_data_path = fs::path(uhd::get_app_path()) / ".uhd" / "cal" / (file_prefix + db_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; for (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_LOGGER_INFO("CAL") << "Calibration data loaded: " << cal_data_path.string(); } sub_tree->access>(fe_path).set( get_fe_correction(cal_data_path.string(), lo_freq)); } /*********************************************************************** * Wrapper routines with nice try/catch + print **********************************************************************/ void uhd::usrp::apply_tx_fe_corrections( // overloading to work according to rfnoc tree // struct property_tree::sptr sub_tree, // starts at mboards/x const std::string& db_serial, const uhd::fs_path tx_fe_corr_path, const double lo_freq // actual lo freq ) { boost::mutex::scoped_lock l(corrections_mutex); try { apply_fe_corrections(sub_tree, db_serial, tx_fe_corr_path + "/iq_balance/value", "tx_iq_cal_v0.2_", lo_freq); apply_fe_corrections(sub_tree, db_serial, tx_fe_corr_path + "/dc_offset/value", "tx_dc_cal_v0.2_", lo_freq); } catch (const std::exception& e) { UHD_LOGGER_ERROR("CAL") << "Failure in apply_tx_fe_corrections: " << e.what(); } } 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); // extract eeprom serial const uhd::fs_path db_path = "dboards/" + slot + "/tx_eeprom"; const std::string db_serial = sub_tree->access(db_path).get().serial; try { apply_fe_corrections(sub_tree, db_serial, "tx_frontends/" + slot + "/iq_balance/value", "tx_iq_cal_v0.2_", lo_freq); apply_fe_corrections(sub_tree, db_serial, "tx_frontends/" + slot + "/dc_offset/value", "tx_dc_cal_v0.2_", lo_freq); } catch (const std::exception& e) { UHD_LOGGER_ERROR("CAL") << "Failure in apply_tx_fe_corrections: " << e.what(); } } void uhd::usrp::apply_rx_fe_corrections( // overloading to work according to rfnoc tree // struct property_tree::sptr sub_tree, // starts at mboards/x const std::string& db_serial, const uhd::fs_path rx_fe_corr_path, const double lo_freq // actual lo freq ) { boost::mutex::scoped_lock l(corrections_mutex); try { apply_fe_corrections(sub_tree, db_serial, rx_fe_corr_path + "/iq_balance/value", "rx_iq_cal_v0.2_", lo_freq); } catch (const std::exception& e) { UHD_LOGGER_ERROR("CAL") << "Failure in apply_tx_fe_corrections: " << e.what(); } } 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); const uhd::fs_path db_path = "dboards/" + slot + "/rx_eeprom"; const std::string db_serial = sub_tree->access(db_path).get().serial; try { apply_fe_corrections(sub_tree, db_serial, "rx_frontends/" + slot + "/iq_balance/value", "rx_iq_cal_v0.2_", lo_freq); } catch (const std::exception& e) { UHD_LOGGER_ERROR("CAL") << "Failure in apply_rx_fe_corrections: " << e.what(); } }