//
// Copyright 2017 Ettus Research
//
// 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 .
//
#ifndef INCLUDED_LIBUHD_RFNOC_MAGNESIUM_RADIO_CTRL_IMPL_HPP
#define INCLUDED_LIBUHD_RFNOC_MAGNESIUM_RADIO_CTRL_IMPL_HPP
#include "radio_ctrl_impl.hpp"
#include "rpc_block_ctrl.hpp"
#include "magnesium_cpld_ctrl.hpp"
#include "magnesium_cpld_regs.hpp"
#include "magnesium_ad9371_iface.hpp"
#include "adf435x.hpp"
#include "gpio_atr_3000.hpp"
#include
#include
#include
#include
namespace uhd {
namespace rfnoc {
/*! \brief Provide access to an Magnesium radio.
*/
class magnesium_radio_ctrl_impl : public radio_ctrl_impl, public rpc_block_ctrl
{
public:
typedef boost::shared_ptr sptr;
/************************************************************************
* Structors
***********************************************************************/
UHD_RFNOC_RADIO_BLOCK_CONSTRUCTOR_DECL(magnesium_radio_ctrl)
virtual ~magnesium_radio_ctrl_impl();
/************************************************************************
* API calls
***********************************************************************/
// Note: We use the cached values in radio_ctrl_impl, so most getters are
// not reimplemented here
double set_rate(double rate);
void set_tx_antenna(const std::string &ant, const size_t chan);
void set_rx_antenna(const std::string &ant, const size_t chan);
double set_tx_frequency(const double freq, const size_t chan);
double set_rx_frequency(const double freq, const size_t chan);
double get_rx_frequency(const size_t chan);
double get_tx_frequency(const size_t chan);
double set_tx_bandwidth(const double bandwidth, const size_t chan);
double set_rx_bandwidth(const double bandwidth, const size_t chan);
// RX LO
std::vector get_rx_lo_names(const size_t chan);
std::vector get_rx_lo_sources(
const std::string &name,
const size_t chan
);
freq_range_t get_rx_lo_freq_range(
const std::string &name,
const size_t chan
);
void set_rx_lo_source(
const std::string &src,
const std::string &name,
const size_t chan
);
const std::string get_rx_lo_source(
const std::string &name,
const size_t chan
);
double set_rx_lo_freq(
double freq,
const std::string &name,
const size_t chan
);
double get_rx_lo_freq(const std::string &name, const size_t chan);
// TX LO
std::vector get_tx_lo_names(const size_t chan);
std::vector get_tx_lo_sources(
const std::string &name,
const size_t chan
);
freq_range_t get_tx_lo_freq_range(
const std::string &name,
const size_t chan
);
void set_tx_lo_source(
const std::string &src,
const std::string &name,
const size_t chan
);
const std::string get_tx_lo_source(
const std::string &name,
const size_t chan
);
double set_tx_lo_freq(
double freq,
const std::string &name,
const size_t chan
);
double get_tx_lo_freq(const std::string &name, const size_t chan);
// gain
double set_tx_gain(const double gain, const size_t chan);
double set_rx_gain(const double gain, const size_t chan);
size_t get_chan_from_dboard_fe(const std::string &fe, const direction_t dir);
std::string get_dboard_fe_from_chan(const size_t chan, const direction_t dir);
void set_rpc_client(
uhd::rpc_client::sptr rpcc,
const uhd::device_addr_t &block_args
);
private:
/**************************************************************************
* Helpers
*************************************************************************/
//! Initialize all the peripherals connected to this block
void _init_peripherals();
//! Set state of this class to sensible defaults
void _init_defaults();
//! Init a subtree for the RF frontends
void _init_frontend_subtree(
uhd::property_tree::sptr subtree,
const size_t chan_idx
);
//! Initialize property tree
void _init_prop_tree();
void _init_mpm_sensors(
const direction_t dir,
const size_t chan_idx
);
/**************************************************************************
* Sensors
*************************************************************************/
//! Return LO lock status. Factors in current band (low/high) and
// direction (TX/RX)
bool get_lo_lock_status(
const direction_t dir
);
/**************************************************************************
* Gain Controls (implemented in magnesium_radio_ctrl_gain.cpp)
*************************************************************************/
//! Set the attenuation of the DSA
double _dsa_set_att(
const double att,
const size_t chan,
const direction_t dir
);
double _dsa_get_att(
const size_t chan,
const direction_t dir
);
//! Write the DSA word
void _set_dsa_val(
const size_t chan,
const direction_t dir,
const uint32_t dsa_val
);
double _set_all_gain(
const double gain,
const double freq,
const size_t chan,
const direction_t dir
);
double _get_all_gain(
const size_t chan,
const direction_t dir
);
void _update_gain(const size_t chan, direction_t dir);
void _update_freq(
const size_t chan,
const uhd::direction_t dir
);
/**************************************************************************
* CPLD Controls (implemented in magnesium_radio_ctrl_cpld.cpp)
*************************************************************************/
//! Blink the front-panel LEDs for \p identify_duration, then reset CPLD
// and resume normal operation.
void _identify_with_leds(
const int identify_duration
);
void _update_rx_freq_switches(
const double freq,
const bool bypass_lnas,
const magnesium_cpld_ctrl::chan_sel_t chan_sel
);
void _update_tx_freq_switches(
const double freq,
const bool bypass_amps,
const magnesium_cpld_ctrl::chan_sel_t chan_sel
);
void _update_atr_switches(
const magnesium_cpld_ctrl::chan_sel_t chan,
const direction_t dir,
const std::string &ant
);
double _set_rx_lo_freq(
const std::string source,
const std::string name,
const double freq,
const size_t chan
);
double _set_tx_lo_freq(
const std::string source,
const std::string name,
const double freq,
const size_t chan
);
/**************************************************************************
* Private attributes
*************************************************************************/
//! Locks access to setter APIs
std::mutex _set_lock;
//! Letter representation of the radio we're currently running
std::string _radio_slot;
//! Prepended for all dboard RPC calls
std::string _rpc_prefix;
//! If true, this is a master radio. This attribute will go away when we
// move back to 1 radio block per dboard.
bool _master;
//! Additional block args; gets set during set_rpc_client()
uhd::device_addr_t _block_args;
//! Reference to the RPC client
uhd::rpc_client::sptr _rpcc;
//! Reference to the SPI core
uhd::spi_iface::sptr _spi;
//! Reference to the TX LO
adf435x_iface::sptr _tx_lo;
//! Reference to the RX LO
adf435x_iface::sptr _rx_lo;
//! Reference to the CPLD controls. Even if there's multiple radios,
// there's only one CPLD control.
std::shared_ptr _cpld;
//! Reference to the AD9371 controls
magnesium_ad9371_iface::uptr _ad9371;
//! ATR controls. These control the external DSA and the AD9371 gain
// up/down bits. They do *not* control the ATR state of the CPLD, the
// tx/rx run states are hooked up directly to the CPLD.
//
// Every radio channel gets its own ATR state register.
std::vector _gpio;
//! Front panel GPIO controller. Note that only one radio block per
// module can be the FP-GPIO master.
usrp::gpio_atr::gpio_atr_3000::sptr _fp_gpio;
//! Sampling rate, and also ref clock frequency for the lowband LOs.
double _master_clock_rate = 1.0;
//! Desired RF frequency
std::map _desired_rf_freq = { {RX_DIRECTION, 2.44e9}, {TX_DIRECTION, 2.44e9} };
//! Coerced adf4351 frequency
//! Coerced ad9371 frequency
std::map _ad9371_freq = { {RX_DIRECTION, 2.44e9}, {TX_DIRECTION, 2.44e9} };
//! Coerced adf4351 frequency
std::map _adf4351_freq = { {RX_DIRECTION, 2.44e9}, {TX_DIRECTION, 2.44e9} };
//! Low band enable
std::map _is_low_band = { {RX_DIRECTION, false}, {TX_DIRECTION, false} };
//! AD9371 gain
double _ad9371_rx_gain = 0.0;
double _ad9371_tx_gain = 0.0;
//! DSA attenuation
double _dsa_rx_att = 0.0;
double _dsa_tx_att = 0.0;
//! All gain
double _all_rx_gain = 0.0;
double _all_tx_gain = 0.0;
bool _rx_bypass_lnas = true;
bool _tx_bypass_amp = true;
//! TRX switch state of 2 channels
std::map _sw_trx = {
{magnesium_cpld_ctrl::CHAN1,
magnesium_cpld_ctrl::SW_TRX_FROMLOWERFILTERBANKTXSW1},
{magnesium_cpld_ctrl::CHAN2,
magnesium_cpld_ctrl::SW_TRX_FROMLOWERFILTERBANKTXSW1}
};
//! RX LO SOURCE
// NOTE for magnesium only ad9371 LO that can be connected to the external LO so we only need one var here
std::string _rx_lo_source = "internal";
}; /* class radio_ctrl_impl */
}} /* namespace uhd::rfnoc */
#endif /* INCLUDED_LIBUHD_RFNOC_MAGNESIUM_RADIO_CTRL_IMPL_HPP */
// vim: sw=4 et: