//
// Copyright 2010 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 "codec_ctrl.hpp"
#include "ad9862_regs.hpp"
#include
#include
#include
#include
#include
#include
#include "usrp_e_regs.hpp" //spi slave constants
#include
#include
using namespace uhd;
static const bool codec_debug = true;
const gain_range_t usrp_e_codec_ctrl::tx_pga_gain_range(-20, 0, float(0.1));
const gain_range_t usrp_e_codec_ctrl::rx_pga_gain_range(0, 20, 1);
/***********************************************************************
* Codec Control Implementation
**********************************************************************/
class usrp_e_codec_ctrl_impl : public usrp_e_codec_ctrl{
public:
//structors
usrp_e_codec_ctrl_impl(usrp_e_iface::sptr iface);
~usrp_e_codec_ctrl_impl(void);
//aux adc and dac control
float read_aux_adc(aux_adc_t which);
void write_aux_dac(aux_dac_t which, float volts);
//pga gain control
void set_tx_pga_gain(float);
float get_tx_pga_gain(void);
void set_rx_pga_gain(float, char);
float get_rx_pga_gain(char);
private:
usrp_e_iface::sptr _iface;
ad9862_regs_t _ad9862_regs;
aux_adc_t _last_aux_adc_a, _last_aux_adc_b;
void send_reg(boost::uint8_t addr);
void recv_reg(boost::uint8_t addr);
};
/***********************************************************************
* Codec Control Structors
**********************************************************************/
usrp_e_codec_ctrl_impl::usrp_e_codec_ctrl_impl(usrp_e_iface::sptr iface){
_iface = iface;
//soft reset
_ad9862_regs.soft_reset = 1;
this->send_reg(0);
//initialize the codec register settings
_ad9862_regs.sdio_bidir = ad9862_regs_t::SDIO_BIDIR_SDIO_SDO;
_ad9862_regs.lsb_first = ad9862_regs_t::LSB_FIRST_MSB;
_ad9862_regs.soft_reset = 0;
//setup rx side of codec
_ad9862_regs.byp_buffer_a = 1;
_ad9862_regs.byp_buffer_b = 1;
_ad9862_regs.buffer_a_pd = 1;
_ad9862_regs.buffer_b_pd = 1;
_ad9862_regs.rx_pga_a = 0;//0x1f; //TODO bring under api control
_ad9862_regs.rx_pga_b = 0;//0x1f; //TODO bring under api control
_ad9862_regs.rx_twos_comp = 1;
_ad9862_regs.rx_hilbert = ad9862_regs_t::RX_HILBERT_DIS;
//setup tx side of codec
_ad9862_regs.two_data_paths = ad9862_regs_t::TWO_DATA_PATHS_BOTH;
_ad9862_regs.interleaved = ad9862_regs_t::INTERLEAVED_INTERLEAVED;
_ad9862_regs.tx_retime = ad9862_regs_t::TX_RETIME_CLKOUT2;
_ad9862_regs.tx_pga_gain = 199; //TODO bring under api control
_ad9862_regs.tx_hilbert = ad9862_regs_t::TX_HILBERT_DIS;
_ad9862_regs.interp = ad9862_regs_t::INTERP_2;
_ad9862_regs.tx_twos_comp = 1;
_ad9862_regs.fine_mode = ad9862_regs_t::FINE_MODE_BYPASS;
_ad9862_regs.coarse_mod = ad9862_regs_t::COARSE_MOD_BYPASS;
_ad9862_regs.dac_a_coarse_gain = 0x3;
_ad9862_regs.dac_b_coarse_gain = 0x3;
_ad9862_regs.edges = ad9862_regs_t::EDGES_NORMAL;
//setup the dll
_ad9862_regs.input_clk_ctrl = ad9862_regs_t::INPUT_CLK_CTRL_EXTERNAL;
_ad9862_regs.dll_mult = ad9862_regs_t::DLL_MULT_2;
_ad9862_regs.dll_mode = ad9862_regs_t::DLL_MODE_FAST;
//write the register settings to the codec
for (uint8_t addr = 0; addr <= 25; addr++){
this->send_reg(addr);
}
//aux adc clock
_ad9862_regs.clk_4 = ad9862_regs_t::CLK_4_1_4;
this->send_reg(34);
}
usrp_e_codec_ctrl_impl::~usrp_e_codec_ctrl_impl(void){
//set aux dacs to zero
this->write_aux_dac(AUX_DAC_A, 0);
this->write_aux_dac(AUX_DAC_B, 0);
this->write_aux_dac(AUX_DAC_C, 0);
this->write_aux_dac(AUX_DAC_D, 0);
//power down
_ad9862_regs.all_rx_pd = 1;
this->send_reg(1);
_ad9862_regs.tx_digital_pd = 1;
_ad9862_regs.tx_analog_pd = ad9862_regs_t::TX_ANALOG_PD_BOTH;
this->send_reg(8);
}
/***********************************************************************
* Codec Control Gain Control Methods
**********************************************************************/
void usrp_e_codec_ctrl_impl::set_tx_pga_gain(float gain){
int gain_word = int(255*(gain - tx_pga_gain_range.min)/(tx_pga_gain_range.max - tx_pga_gain_range.min));
_ad9862_regs.tx_pga_gain = std::clip(gain_word, 0, 255);
this->send_reg(16);
}
float usrp_e_codec_ctrl_impl::get_tx_pga_gain(void){
return (_ad9862_regs.tx_pga_gain*(tx_pga_gain_range.max - tx_pga_gain_range.min)/63) + tx_pga_gain_range.min;
}
void usrp_e_codec_ctrl_impl::set_rx_pga_gain(float gain, char which){
int gain_word = int(0x14*(gain - rx_pga_gain_range.min)/(rx_pga_gain_range.max - rx_pga_gain_range.min));
gain_word = std::clip(gain_word, 0, 0x14);
switch(which){
case 'A':
_ad9862_regs.rx_pga_a = gain_word;
this->send_reg(2);
return;
case 'B':
_ad9862_regs.rx_pga_b = gain_word;
this->send_reg(3);
return;
default: UHD_THROW_INVALID_CODE_PATH();
}
}
float usrp_e_codec_ctrl_impl::get_rx_pga_gain(char which){
int gain_word;
switch(which){
case 'A': gain_word = _ad9862_regs.rx_pga_a; break;
case 'B': gain_word = _ad9862_regs.rx_pga_b; break;
default: UHD_THROW_INVALID_CODE_PATH();
}
return (gain_word*(rx_pga_gain_range.max - rx_pga_gain_range.min)/0x14) + rx_pga_gain_range.min;
}
/***********************************************************************
* Codec Control AUX ADC Methods
**********************************************************************/
static float aux_adc_to_volts(boost::uint8_t high, boost::uint8_t low){
return float((boost::uint16_t(high) << 2) | low)*3.3/0x3ff;
}
float usrp_e_codec_ctrl_impl::read_aux_adc(aux_adc_t which){
//check to see if the switch needs to be set
bool write_switch = false;
switch(which){
case AUX_ADC_A1:
case AUX_ADC_A2:
if (which != _last_aux_adc_a){
_ad9862_regs.select_a = (which == AUX_ADC_A1)?
ad9862_regs_t::SELECT_A_AUX_ADC1: ad9862_regs_t::SELECT_A_AUX_ADC2;
_last_aux_adc_a = which;
write_switch = true;
}
break;
case AUX_ADC_B1:
case AUX_ADC_B2:
if (which != _last_aux_adc_b){
_ad9862_regs.select_b = (which == AUX_ADC_B1)?
ad9862_regs_t::SELECT_B_AUX_ADC1: ad9862_regs_t::SELECT_B_AUX_ADC2;
_last_aux_adc_b = which;
write_switch = true;
}
break;
}
//write the switch if it changed
if(write_switch) this->send_reg(34);
//map aux adcs to register values to read
static const uhd::dict aux_dac_to_addr = boost::assign::map_list_of
(AUX_ADC_A2, 26) (AUX_ADC_A1, 28)
(AUX_ADC_B2, 30) (AUX_ADC_B1, 32)
;
//read the value
this->recv_reg(aux_dac_to_addr[which]+0);
this->recv_reg(aux_dac_to_addr[which]+1);
//return the value scaled to volts
switch(which){
case AUX_ADC_A1: return aux_adc_to_volts(_ad9862_regs.aux_adc_a1_9_2, _ad9862_regs.aux_adc_a1_1_0);
case AUX_ADC_A2: return aux_adc_to_volts(_ad9862_regs.aux_adc_a2_9_2, _ad9862_regs.aux_adc_a2_1_0);
case AUX_ADC_B1: return aux_adc_to_volts(_ad9862_regs.aux_adc_b1_9_2, _ad9862_regs.aux_adc_b1_1_0);
case AUX_ADC_B2: return aux_adc_to_volts(_ad9862_regs.aux_adc_b2_9_2, _ad9862_regs.aux_adc_b2_1_0);
}
UHD_ASSERT_THROW(false);
}
/***********************************************************************
* Codec Control AUX DAC Methods
**********************************************************************/
void usrp_e_codec_ctrl_impl::write_aux_dac(aux_dac_t which, float volts){
//special case for aux dac d (aka sigma delta word)
if (which == AUX_DAC_D){
boost::uint16_t dac_word = std::clip(boost::math::iround(volts*0xfff/3.3), 0, 0xfff);
_ad9862_regs.sig_delt_11_4 = boost::uint8_t(dac_word >> 4);
_ad9862_regs.sig_delt_3_0 = boost::uint8_t(dac_word & 0xf);
this->send_reg(42);
this->send_reg(43);
return;
}
//calculate the dac word for aux dac a, b, c
boost::uint8_t dac_word = std::clip(boost::math::iround(volts*0xff/3.3), 0, 0xff);
//setup a lookup table for the aux dac params (reg ref, reg addr)
typedef boost::tuple dac_params_t;
uhd::dict aux_dac_to_params = boost::assign::map_list_of
(AUX_DAC_A, dac_params_t(&_ad9862_regs.aux_dac_a, 36))
(AUX_DAC_B, dac_params_t(&_ad9862_regs.aux_dac_b, 37))
(AUX_DAC_C, dac_params_t(&_ad9862_regs.aux_dac_c, 38))
;
//set the aux dac register
UHD_ASSERT_THROW(aux_dac_to_params.has_key(which));
boost::uint8_t *reg_ref, reg_addr;
boost::tie(reg_ref, reg_addr) = aux_dac_to_params[which];
*reg_ref = dac_word;
this->send_reg(reg_addr);
}
/***********************************************************************
* Codec Control SPI Methods
**********************************************************************/
void usrp_e_codec_ctrl_impl::send_reg(boost::uint8_t addr){
boost::uint32_t reg = _ad9862_regs.get_write_reg(addr);
if (codec_debug) std::cout << "codec control write reg: " << std::hex << reg << std::endl;
_iface->transact_spi(
UE_SPI_SS_AD9862,
spi_config_t::EDGE_RISE,
reg, 16, false /*no rb*/
);
}
void usrp_e_codec_ctrl_impl::recv_reg(boost::uint8_t addr){
boost::uint32_t reg = _ad9862_regs.get_read_reg(addr);
if (codec_debug) std::cout << "codec control read reg: " << std::hex << reg << std::endl;
boost::uint32_t ret = _iface->transact_spi(
UE_SPI_SS_AD9862,
spi_config_t::EDGE_RISE,
reg, 16, true /*rb*/
);
if (codec_debug) std::cout << "codec control read ret: " << std::hex << ret << std::endl;
_ad9862_regs.set_reg(addr, boost::uint16_t(ret));
}
/***********************************************************************
* Codec Control Make
**********************************************************************/
usrp_e_codec_ctrl::sptr usrp_e_codec_ctrl::make(usrp_e_iface::sptr iface){
return sptr(new usrp_e_codec_ctrl_impl(iface));
}