//
// 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;
}
}