uhd

//

// Copyright 2010-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 <http://www.gnu.org/licenses/>.

//

#include "usrp2_impl.hpp"

#include "fw_common.h"

#include <uhd/utils/log.hpp>

#include <uhd/utils/msg.hpp>

#include <uhd/exception.hpp>

#include <uhd/transport/if_addrs.hpp>

#include <uhd/transport/udp_zero_copy.hpp>

#include <uhd/types/ranges.hpp>

#include <uhd/exception.hpp>

#include <uhd/utils/static.hpp>

#include <uhd/utils/byteswap.hpp>

#include <uhd/utils/safe_call.hpp>

#include <boost/format.hpp>

#include <boost/foreach.hpp>

#include <boost/lexical_cast.hpp>

#include <boost/bind.hpp>

#include <boost/assign/list_of.hpp>

#include <boost/asio/ip/address_v4.hpp>

#include <boost/asio.hpp> //used for htonl and ntohl

using namespace uhd;

using namespace uhd::usrp;

using namespace uhd::transport;

namespace asio = boost::asio;

/***********************************************************************

 * Discovery over the udp transport

 **********************************************************************/

static device_addrs_t usrp2_find(const device_addr_t &hint_){

    //handle the multi-device discovery

    device_addrs_t hints = separate_device_addr(hint_);

    if (hints.size() > 1){

        device_addrs_t found_devices;

        BOOST_FOREACH(const device_addr_t &hint_i, hints){

            device_addrs_t found_devices_i = usrp2_find(hint_i);

            if (found_devices_i.size() != 1) throw uhd::value_error(str(boost::format(

                "Could not resolve device hint \"%s\" to a single device."

            ) % hint_i.to_string()));

            found_devices.push_back(found_devices_i[0]);

        }

        return device_addrs_t(1, combine_device_addrs(found_devices));

    }

    //initialize the hint for a single device case

    UHD_ASSERT_THROW(hints.size() <= 1);

    hints.resize(1); //in case it was empty

    device_addr_t hint = hints[0];

    device_addrs_t usrp2_addrs;

    //return an empty list of addresses when type is set to non-usrp2

    if (hint.has_key("type") and hint["type"] != "usrp2") return usrp2_addrs;

    //if no address was specified, send a broadcast on each interface

    if (not hint.has_key("addr")){

        BOOST_FOREACH(const if_addrs_t &if_addrs, get_if_addrs()){

            //avoid the loopback device

            if (if_addrs.inet == asio::ip::address_v4::loopback().to_string()) continue;

            //create a new hint with this broadcast address

            device_addr_t new_hint = hint;

            new_hint["addr"] = if_addrs.bcast;

            //call discover with the new hint and append results

            device_addrs_t new_usrp2_addrs = usrp2_find(new_hint);

            usrp2_addrs.insert(usrp2_addrs.begin(),

                new_usrp2_addrs.begin(), new_usrp2_addrs.end()

            );

        }

        return usrp2_addrs;

    }

    //create a udp transport to communicate

    std::string ctrl_port = boost::lexical_cast<std::string>(USRP2_UDP_CTRL_PORT);

    udp_simple::sptr udp_transport = udp_simple::make_broadcast(

        hint["addr"], ctrl_port

    );

    //send a hello control packet

    usrp2_ctrl_data_t ctrl_data_out = usrp2_ctrl_data_t();

    ctrl_data_out.proto_ver = uhd::htonx<boost::uint32_t>(USRP2_FW_COMPAT_NUM);

    ctrl_data_out.id = uhd::htonx<boost::uint32_t>(USRP2_CTRL_ID_WAZZUP_BRO);

    udp_transport->send(boost::asio::buffer(&ctrl_data_out, sizeof(ctrl_data_out)));

    //loop and recieve until the timeout

    boost::uint8_t usrp2_ctrl_data_in_mem[udp_simple::mtu]; //allocate max bytes for recv

    const usrp2_ctrl_data_t *ctrl_data_in = reinterpret_cast<const usrp2_ctrl_data_t *>(usrp2_ctrl_data_in_mem);

    while(true){

        size_t len = udp_transport->recv(asio::buffer(usrp2_ctrl_data_in_mem));

        if (len > offsetof(usrp2_ctrl_data_t, data) and ntohl(ctrl_data_in->id) == USRP2_CTRL_ID_WAZZUP_DUDE){

            //make a boost asio ipv4 with the raw addr in host byte order

            boost::asio::ip::address_v4 ip_addr(ntohl(ctrl_data_in->data.ip_addr));

            device_addr_t new_addr;

            new_addr["type"] = "usrp2";

            new_addr["addr"] = ip_addr.to_string();

            //Attempt to read the name from the EEPROM and perform filtering.

            //This operation can throw due to compatibility mismatch.

            try{

                usrp2_iface::sptr iface = usrp2_iface::make(udp_simple::make_connected(

                    new_addr["addr"], BOOST_STRINGIZE(USRP2_UDP_CTRL_PORT)

                ));

                if (iface->is_device_locked()) continue; //ignore locked devices

                mboard_eeprom_t mb_eeprom = iface->mb_eeprom;

                new_addr["name"] = mb_eeprom["name"];

                new_addr["serial"] = mb_eeprom["serial"];

            }

            catch(const std::exception &){

                //set these values as empty string so the device may still be found

                //and the filter's below can still operate on the discovered device

                new_addr["name"] = "";

                new_addr["serial"] = "";

            }

            //filter the discovered device below by matching optional keys

            if (

                (not hint.has_key("name")   or hint["name"]   == new_addr["name"]) and

                (not hint.has_key("serial") or hint["serial"] == new_addr["serial"])

            ){

                usrp2_addrs.push_back(new_addr);

            }

            //dont break here, it will exit the while loop

            //just continue on to the next loop iteration

        }

        if (len == 0) break; //timeout

    }

    return usrp2_addrs;

}

/***********************************************************************

 * Make

 **********************************************************************/

static device::sptr usrp2_make(const device_addr_t &device_addr){

    return device::sptr(new usrp2_impl(device_addr));

}

UHD_STATIC_BLOCK(register_usrp2_device){

    device::register_device(&usrp2_find, &usrp2_make);

}

/***********************************************************************

 * MTU Discovery

 **********************************************************************/

struct mtu_result_t{

    size_t recv_mtu, send_mtu;

};

static mtu_result_t determine_mtu(const std::string &addr, const mtu_result_t &user_mtu){

    udp_simple::sptr udp_sock = udp_simple::make_connected(

        addr, BOOST_STRINGIZE(USRP2_UDP_CTRL_PORT)

    );

    //The FPGA offers 4K buffers, and the user may manually request this.

    //However, multiple simultaneous receives (2DSP slave + 2DSP master),

    //require that buffering to be used internally, and this is a safe setting.

    std::vector<boost::uint8_t> buffer(std::max(user_mtu.recv_mtu, user_mtu.send_mtu));

    usrp2_ctrl_data_t *ctrl_data = reinterpret_cast<usrp2_ctrl_data_t *>(&buffer.front());

    static const double echo_timeout = 0.020; //20 ms

    //test holler - check if its supported in this fw version

    ctrl_data->id = htonl(USRP2_CTRL_ID_HOLLER_AT_ME_BRO);

    ctrl_data->proto_ver = htonl(USRP2_FW_COMPAT_NUM);

    ctrl_data->data.echo_args.len = htonl(sizeof(usrp2_ctrl_data_t));

    udp_sock->send(boost::asio::buffer(buffer, sizeof(usrp2_ctrl_data_t)));

    udp_sock->recv(boost::asio::buffer(buffer), echo_timeout);

    if (ntohl(ctrl_data->id) != USRP2_CTRL_ID_HOLLER_BACK_DUDE)

        throw uhd::not_implemented_error("holler protocol not implemented");

    size_t min_recv_mtu = sizeof(usrp2_ctrl_data_t), max_recv_mtu = user_mtu.recv_mtu;

    size_t min_send_mtu = sizeof(usrp2_ctrl_data_t), max_send_mtu = user_mtu.send_mtu;

    while (min_recv_mtu < max_recv_mtu){

        size_t test_mtu = (max_recv_mtu/2 + min_recv_mtu/2 + 3) & ~3;

        ctrl_data->id = htonl(USRP2_CTRL_ID_HOLLER_AT_ME_BRO);

        ctrl_data->proto_ver = htonl(USRP2_FW_COMPAT_NUM);

        ctrl_data->data.echo_args.len = htonl(test_mtu);

        udp_sock->send(boost::asio::buffer(buffer, sizeof(usrp2_ctrl_data_t)));

        size_t len = udp_sock->recv(boost::asio::buffer(buffer), echo_timeout);

        if (len >= test_mtu) min_recv_mtu = test_mtu;

        else                 max_recv_mtu = test_mtu - 4;

    }

    while (min_send_mtu < max_send_mtu){

        size_t test_mtu = (max_send_mtu/2 + min_send_mtu/2 + 3) & ~3;

        ctrl_data->id = htonl(USRP2_CTRL_ID_HOLLER_AT_ME_BRO);

        ctrl_data->proto_ver = htonl(USRP2_FW_COMPAT_NUM);

        ctrl_data->data.echo_args.len = htonl(sizeof(usrp2_ctrl_data_t));

        udp_sock->send(boost::asio::buffer(buffer, test_mtu));

        size_t len = udp_sock->recv(boost::asio::buffer(buffer), echo_timeout);

        if (len >= sizeof(usrp2_ctrl_data_t)) len = ntohl(ctrl_data->data.echo_args.len);

        if (len >= test_mtu) min_send_mtu = test_mtu;

        else                 max_send_mtu = test_mtu - 4;

    }

    mtu_result_t mtu;

    mtu.recv_mtu = min_recv_mtu;

    mtu.send_mtu = min_send_mtu;

    return mtu;

}

/***********************************************************************

 * Helpers

 **********************************************************************/

static void init_xport(zero_copy_if::sptr xport){

    //Send a small data packet so the usrp2 knows the udp source port.

    //This setup must happen before further initialization occurs

    //or the async update packets will cause ICMP destination unreachable.

    static const boost::uint32_t data[2] = {

        uhd::htonx(boost::uint32_t(0 /* don't care seq num */)),

        uhd::htonx(boost::uint32_t(USRP2_INVALID_VRT_HEADER))

    };

    transport::managed_send_buffer::sptr send_buff = xport->get_send_buff();

    std::memcpy(send_buff->cast<void*>(), &data, sizeof(data));

    send_buff->commit(sizeof(data));

}

/***********************************************************************

 * Structors

 **********************************************************************/

usrp2_impl::usrp2_impl(const device_addr_t &_device_addr){

    UHD_MSG(status) << "Opening a USRP2/N-Series device..." << std::endl;

    device_addr_t device_addr = _device_addr;

    //setup the dsp transport hints (default to a large recv buff)

    if (not device_addr.has_key("recv_buff_size")){

        #if defined(UHD_PLATFORM_MACOS) || defined(UHD_PLATFORM_BSD)

            //limit buffer resize on macos or it will error

            device_addr["recv_buff_size"] = "1e6";

        #elif defined(UHD_PLATFORM_LINUX) || defined(UHD_PLATFORM_WIN32)

            //set to half-a-second of buffering at max rate

            device_addr["recv_buff_size"] = "50e6";

        #endif

    }

    device_addrs_t device_args = separate_device_addr(device_addr);

    //extract the user's requested MTU size or default

    mtu_result_t user_mtu;

    user_mtu.recv_mtu = size_t(device_addr.cast<double>("recv_frame_size", udp_simple::mtu));

    user_mtu.send_mtu = size_t(device_addr.cast<double>("send_frame_size", udp_simple::mtu));

    try{

        //calculate the minimum send and recv mtu of all devices

        mtu_result_t mtu = determine_mtu(device_args[0]["addr"], user_mtu);

        for (size_t i = 1; i < device_args.size(); i++){

            mtu_result_t mtu_i = determine_mtu(device_args[i]["addr"], user_mtu);

            mtu.recv_mtu = std::min(mtu.recv_mtu, mtu_i.recv_mtu);

            mtu.send_mtu = std::min(mtu.send_mtu, mtu_i.send_mtu);

        }

        device_addr["recv_frame_size"] = boost::lexical_cast<std::string>(mtu.recv_mtu);

        device_addr["send_frame_size"] = boost::lexical_cast<std::string>(mtu.send_mtu);

        UHD_MSG(status) << boost::format("Current recv frame size: %d bytes") % mtu.recv_mtu << std::endl;

        UHD_MSG(status) << boost::format("Current send frame size: %d bytes") % mtu.send_mtu << std::endl;

    }

    catch(const uhd::not_implemented_error &){

        //just ignore this error, makes older fw work...

    }

    device_args = separate_device_addr(device_addr); //update args for new frame sizes

    ////////////////////////////////////////////////////////////////////

    // create controller objects and initialize the properties tree

    ////////////////////////////////////////////////////////////////////

    _tree = property_tree::make();

    _tree->create<std::string>("/name").set("USRP2 / N-Series Device");

    for (size_t mbi = 0; mbi < device_args.size(); mbi++){

        const device_addr_t device_args_i = device_args[mbi];

        const std::string mb = boost::lexical_cast<std::string>(mbi);

        const std::string addr = device_args_i["addr"];

        const property_tree::path_type mb_path = "/mboards/" + mb;

        ////////////////////////////////////////////////////////////////

        // construct transports for dsp and async errors

        ////////////////////////////////////////////////////////////////

        UHD_LOG << "Making transport for DSP0..." << std::endl;

        _mbc[mb].dsp_xports.push_back(udp_zero_copy::make(

            addr, BOOST_STRINGIZE(USRP2_UDP_DSP0_PORT), device_args_i

        ));

        init_xport(_mbc[mb].dsp_xports.back());

        UHD_LOG << "Making transport for DSP1..." << std::endl;

        _mbc[mb].dsp_xports.push_back(udp_zero_copy::make(

            addr, BOOST_STRINGIZE(USRP2_UDP_DSP1_PORT), device_args_i

        ));

        init_xport(_mbc[mb].dsp_xports.back());

        UHD_LOG << "Making transport for ERR0..." << std::endl;

        _mbc[mb].err_xports.push_back(udp_zero_copy::make(

            addr, BOOST_STRINGIZE(USRP2_UDP_ERR0_PORT), device_addr_t()

        ));

        init_xport(_mbc[mb].err_xports.back());

        ////////////////////////////////////////////////////////////////

        // create the iface that controls i2c, spi, uart, and wb

        ////////////////////////////////////////////////////////////////

        _mbc[mb].iface = usrp2_iface::make(udp_simple::make_connected(

            addr, BOOST_STRINGIZE(USRP2_UDP_CTRL_PORT)

        ));

        _tree->create<std::string>(mb_path / "name").set(_mbc[mb].iface->get_cname());

        ////////////////////////////////////////////////////////////////

        // setup the mboard eeprom

        ////////////////////////////////////////////////////////////////

        _tree->create<mboard_eeprom_t>(mb_path / "eeprom")

            .set(_mbc[mb].iface->mb_eeprom)

            .subscribe(boost::bind(&usrp2_impl::set_mb_eeprom, this, mb, _1));

        ////////////////////////////////////////////////////////////////

        // create clock control objects

        ////////////////////////////////////////////////////////////////

        _mbc[mb].clock = usrp2_clock_ctrl::make(_mbc[mb].iface);

        _tree->create<double>(mb_path / "tick_rate")

            .publish(boost::bind(&usrp2_clock_ctrl::get_master_clock_rate, _mbc[mb].clock))

            .subscribe(boost::bind(&usrp2_impl::update_tick_rate, this, _1));

        ////////////////////////////////////////////////////////////////

        // create codec control objects

        ////////////////////////////////////////////////////////////////

        const property_tree::path_type rx_codec_path = mb_path / "rx_codecs/A";

        const property_tree::path_type tx_codec_path = mb_path / "tx_codecs/A";

        _tree->create<int>(rx_codec_path / "gains"); //phony property so this dir exists

        _tree->create<int>(tx_codec_path / "gains"); //phony property so this dir exists

        _mbc[mb].codec = usrp2_codec_ctrl::make(_mbc[mb].iface);

        switch(_mbc[mb].iface->get_rev()){

        case usrp2_iface::USRP_N200:

        case usrp2_iface::USRP_N210:

        case usrp2_iface::USRP_N200_R4:

        case usrp2_iface::USRP_N210_R4:{

            _tree->create<std::string>(rx_codec_path / "name").set("ads62p44");

            _tree->create<meta_range_t>(rx_codec_path / "gains/digital/range").set(meta_range_t(0, 6.0, 0.5));

            _tree->create<double>(rx_codec_path / "gains/digital/value")

                .subscribe(boost::bind(&usrp2_codec_ctrl::set_rx_digital_gain, _mbc[mb].codec, _1)).set(0);

            _tree->create<meta_range_t>(rx_codec_path / "gains/fine/range").set(meta_range_t(0, 0.5, 0.05));

            _tree->create<double>(rx_codec_path / "gains/fine/value")

                .subscribe(boost::bind(&usrp2_codec_ctrl::set_rx_digital_fine_gain, _mbc[mb].codec, _1)).set(0);

        }break;

        case usrp2_iface::USRP2_REV3:

        case usrp2_iface::USRP2_REV4:

            _tree->create<std::string>(rx_codec_path / "name").set("ltc2284");

            break;

        case usrp2_iface::USRP_NXXX:

            _tree->create<std::string>(rx_codec_path / "name").set("??????");

            break;

        }

        _tree->create<std::string>(tx_codec_path / "name").set("ad9777");

        ////////////////////////////////////////////////////////////////

        // create gpsdo control objects

        ////////////////////////////////////////////////////////////////

        if (_mbc[mb].iface->mb_eeprom["gpsdo"] == "internal"){

            _mbc[mb].gps = gps_ctrl::make(

                _mbc[mb].iface->get_gps_write_fn(),

                _mbc[mb].iface->get_gps_read_fn()

            );

            BOOST_FOREACH(const std::string &name, _mbc[mb].gps->get_sensors()){

                _tree->create<sensor_value_t>(mb_path / "sensors" / name)

                    .publish(boost::bind(&gps_ctrl::get_sensor, _mbc[mb].gps, name));

            }

        }

        ////////////////////////////////////////////////////////////////

        // and do the misc mboard sensors

        ////////////////////////////////////////////////////////////////

        _tree->create<sensor_value_t>(mb_path / "sensors/mimo_locked")

            .publish(boost::bind(&usrp2_impl::get_mimo_locked, this, mb));

        _tree->create<sensor_value_t>(mb_path / "sensors/ref_locked")

            .publish(boost::bind(&usrp2_impl::get_ref_locked, this, mb));

        ////////////////////////////////////////////////////////////////

        // create frontend control objects

        ////////////////////////////////////////////////////////////////

        _mbc[mb].rx_fe = rx_frontend_core_200::make(

            _mbc[mb].iface, U2_REG_SR_ADDR(SR_RX_FRONT)

        );

        _mbc[mb].tx_fe = tx_frontend_core_200::make(

            _mbc[mb].iface, U2_REG_SR_ADDR(SR_TX_FRONT)

        );

        //TODO lots of properties to expose here for frontends

        _tree->create<subdev_spec_t>(mb_path / "rx_subdev_spec")

            .subscribe(boost::bind(&usrp2_impl::update_rx_subdev_spec, this, mb, _1));

        _tree->create<subdev_spec_t>(mb_path / "tx_subdev_spec")

            .subscribe(boost::bind(&usrp2_impl::update_tx_subdev_spec, this, mb, _1));

        ////////////////////////////////////////////////////////////////

        // create rx dsp control objects

        ////////////////////////////////////////////////////////////////

        _mbc[mb].rx_dsps.push_back(rx_dsp_core_200::make(

            _mbc[mb].iface, U2_REG_SR_ADDR(SR_RX_DSP0), U2_REG_SR_ADDR(SR_RX_CTRL0), USRP2_RX_SID_BASE + 0, true

        ));

        _mbc[mb].rx_dsps.push_back(rx_dsp_core_200::make(

            _mbc[mb].iface, U2_REG_SR_ADDR(SR_RX_DSP1), U2_REG_SR_ADDR(SR_RX_CTRL1), USRP2_RX_SID_BASE + 1, true

        ));

        for (size_t dspno = 0; dspno < _mbc[mb].rx_dsps.size(); dspno++){

            _tree->access<double>(mb_path / "tick_rate")

                .subscribe(boost::bind(&rx_dsp_core_200::set_tick_rate, _mbc[mb].rx_dsps[dspno], _1));

            //This is a hack/fix for the lingering packet problem.

            //The dsp core starts streaming briefly... now we flush

            _mbc[mb].dsp_xports[dspno]->get_recv_buff(0.01).get(); //recv with timeout for lingering

            _mbc[mb].dsp_xports[dspno]->get_recv_buff(0.01).get(); //recv with timeout for expected

            property_tree::path_type rx_dsp_path = mb_path / str(boost::format("rx_dsps/%u") % dspno);

            _tree->create<double>(rx_dsp_path / "rate/value")

                .coerce(boost::bind(&rx_dsp_core_200::set_host_rate, _mbc[mb].rx_dsps[dspno], _1))

                .subscribe(boost::bind(&usrp2_impl::update_rx_samp_rate, this, _1));

            _tree->create<double>(rx_dsp_path / "freq/value")

                .coerce(boost::bind(&rx_dsp_core_200::set_freq, _mbc[mb].rx_dsps[dspno], _1));

            _tree->create<meta_range_t>(rx_dsp_path / "freq/range")

                .publish(boost::bind(&rx_dsp_core_200::get_freq_range, _mbc[mb].rx_dsps[dspno]));

            _tree->create<stream_cmd_t>(rx_dsp_path / "stream_cmd")

                .subscribe(boost::bind(&rx_dsp_core_200::issue_stream_command, _mbc[mb].rx_dsps[dspno], _1));

        }

        ////////////////////////////////////////////////////////////////

        // create tx dsp control objects

        ////////////////////////////////////////////////////////////////

        _mbc[mb].tx_dsp = tx_dsp_core_200::make(

            _mbc[mb].iface, U2_REG_SR_ADDR(SR_TX_DSP), U2_REG_SR_ADDR(SR_TX_CTRL), USRP2_TX_ASYNC_SID

        );

        _tree->access<double>(mb_path / "tick_rate")

            .subscribe(boost::bind(&tx_dsp_core_200::set_tick_rate, _mbc[mb].tx_dsp, _1));

        _tree->create<double>(mb_path / "tx_dsps/0/rate/value")

            .coerce(boost::bind(&tx_dsp_core_200::set_host_rate, _mbc[mb].tx_dsp, _1))

            .subscribe(boost::bind(&usrp2_impl::update_tx_samp_rate, this, _1));

        _tree->create<double>(mb_path / "tx_dsps/0/freq/value")

            .coerce(boost::bind(&usrp2_impl::set_tx_dsp_freq, this, mb, _1));

        _tree->create<meta_range_t>(mb_path / "tx_dsps/0/freq/range")

            .publish(boost::bind(&usrp2_impl::get_tx_dsp_freq_range, this, mb));

        //setup dsp flow control

        const double ups_per_sec = device_args_i.cast<double>("ups_per_sec", 20);

        const size_t send_frame_size = _mbc[mb].dsp_xports.front()->get_send_frame_size();

        const double ups_per_fifo = device_args_i.cast<double>("ups_per_fifo", 8.0);

        _mbc[mb].tx_dsp->set_updates(

            (ups_per_sec > 0.0)? size_t(100e6/*approx tick rate*//ups_per_sec) : 0,

            (ups_per_fifo > 0.0)? size_t(USRP2_SRAM_BYTES/ups_per_fifo/send_frame_size) : 0

        );

        ////////////////////////////////////////////////////////////////

        // create time control objects

        ////////////////////////////////////////////////////////////////

        time64_core_200::readback_bases_type time64_rb_bases;

        time64_rb_bases.rb_secs_now = U2_REG_TIME64_SECS_RB_IMM;

        time64_rb_bases.rb_ticks_now = U2_REG_TIME64_TICKS_RB_IMM;

        time64_rb_bases.rb_secs_pps = U2_REG_TIME64_SECS_RB_PPS;

        time64_rb_bases.rb_ticks_pps = U2_REG_TIME64_TICKS_RB_PPS;

        _mbc[mb].time64 = time64_core_200::make(

            _mbc[mb].iface, U2_REG_SR_ADDR(SR_TIME64), time64_rb_bases, mimo_clock_sync_delay_cycles

        );

        _tree->access<double>(mb_path / "tick_rate")

            .subscribe(boost::bind(&time64_core_200::set_tick_rate, _mbc[mb].time64, _1));

        _tree->create<time_spec_t>(mb_path / "time/now")

            .publish(boost::bind(&time64_core_200::get_time_now, _mbc[mb].time64))

            .subscribe(boost::bind(&time64_core_200::set_time_now, _mbc[mb].time64, _1));

        _tree->create<time_spec_t>(mb_path / "time/pps")

            .publish(boost::bind(&time64_core_200::get_time_last_pps, _mbc[mb].time64))

            .subscribe(boost::bind(&time64_core_200::set_time_next_pps, _mbc[mb].time64, _1));

        //setup time source props

        _tree->create<std::string>(mb_path / "time_source/value")

            .subscribe(boost::bind(&time64_core_200::set_time_source, _mbc[mb].time64, _1));

        _tree->create<std::vector<std::string> >(mb_path / "time_source/options")

            .publish(boost::bind(&time64_core_200::get_time_sources, _mbc[mb].time64));

        //setup reference source props

        _tree->create<std::string>(mb_path / "clock_source/value")

            .subscribe(boost::bind(&usrp2_impl::update_clock_source, this, mb, _1));

        static const std::vector<std::string> clock_sources = boost::assign::list_of("internal")("external")("mimo");

        _tree->create<std::vector<std::string> >(mb_path / "clock_source/options").set(clock_sources);

        ////////////////////////////////////////////////////////////////

        // create dboard control objects

        ////////////////////////////////////////////////////////////////

        //read the dboard eeprom to extract the dboard ids

        dboard_eeprom_t rx_db_eeprom, tx_db_eeprom, gdb_eeprom;

        rx_db_eeprom.load(*_mbc[mb].iface, USRP2_I2C_ADDR_RX_DB);

        tx_db_eeprom.load(*_mbc[mb].iface, USRP2_I2C_ADDR_TX_DB);

        gdb_eeprom.load(*_mbc[mb].iface, USRP2_I2C_ADDR_TX_DB ^ 5);

        //create the properties and register subscribers

        _tree->create<dboard_eeprom_t>(mb_path / "dboards/A/rx_eeprom")

            .set(rx_db_eeprom)

            .subscribe(boost::bind(&usrp2_impl::set_db_eeprom, this, mb, "rx", _1));

        _tree->create<dboard_eeprom_t>(mb_path / "dboards/A/tx_eeprom")

            .set(tx_db_eeprom)

            .subscribe(boost::bind(&usrp2_impl::set_db_eeprom, this, mb, "tx", _1));

        _tree->create<dboard_eeprom_t>(mb_path / "dboards/A/gdb_eeprom")

            .set(gdb_eeprom)

            .subscribe(boost::bind(&usrp2_impl::set_db_eeprom, this, mb, "gdb", _1));

        //create a new dboard interface and manager

        _mbc[mb].dboard_iface = make_usrp2_dboard_iface(_mbc[mb].iface, _mbc[mb].clock);

        _tree->create<dboard_iface::sptr>(mb_path / "dboards/A/iface").set(_mbc[mb].dboard_iface);

        _mbc[mb].dboard_manager = dboard_manager::make(

            rx_db_eeprom.id,

            ((gdb_eeprom.id == dboard_id_t::none())? tx_db_eeprom : gdb_eeprom).id,

            _mbc[mb].dboard_iface

        );

        BOOST_FOREACH(const std::string &name, _mbc[mb].dboard_manager->get_rx_subdev_names()){

            dboard_manager::populate_prop_tree_from_subdev(

                _tree, mb_path / "dboards/A/rx_frontends" / name,

                _mbc[mb].dboard_manager->get_rx_subdev(name)

            );

        }

        BOOST_FOREACH(const std::string &name, _mbc[mb].dboard_manager->get_tx_subdev_names()){

            dboard_manager::populate_prop_tree_from_subdev(

                _tree, mb_path / "dboards/A/tx_frontends" / name,

                _mbc[mb].dboard_manager->get_tx_subdev(name)

            );

        }

    }

    //initialize io handling

    this->io_init();

    //do some post-init tasks

    BOOST_FOREACH(const std::string &mb, _mbc.keys()){

        property_tree::path_type root = "/mboards/" + mb;

        _tree->access<double>(root / "tick_rate").update();

        //and now that the tick rate is set, init the host rates to something

        BOOST_FOREACH(const std::string &name, _tree->list(root / "rx_dsps")){

            _tree->access<double>(root / "rx_dsps" / name / "rate" / "value").set(1e6);

        }

        BOOST_FOREACH(const std::string &name, _tree->list(root / "tx_dsps")){

            _tree->access<double>(root / "tx_dsps" / name / "rate" / "value").set(1e6);

        }

        _tree->access<subdev_spec_t>(root / "rx_subdev_spec").set(subdev_spec_t("A:"+_mbc[mb].dboard_manager->get_rx_subdev_names()[0]));

        _tree->access<subdev_spec_t>(root / "tx_subdev_spec").set(subdev_spec_t("A:"+_mbc[mb].dboard_manager->get_tx_subdev_names()[0]));

        _tree->access<std::string>(root / "clock_source/value").set("internal");

        _tree->access<std::string>(root / "time_source/value").set("none");

        //GPS installed: use external ref, time, and init time spec

        if (_mbc[mb].gps.get() != NULL){

            _tree->access<std::string>(root / "time_source/value").set("external");

            _tree->access<std::string>(root / "clock_source/value").set("external");

            _mbc[mb].time64->set_time_next_pps(time_spec_t(time_t(_mbc[mb].gps->get_sensor("gps_time").to_int()+1)));

        }

    }

}

usrp2_impl::~usrp2_impl(void){UHD_SAFE_CALL(

    BOOST_FOREACH(const std::string &mb, _mbc.keys()){

        _mbc[mb].tx_dsp->set_updates(0, 0);

    }

)}

void usrp2_impl::set_mb_eeprom(const std::string &mb, const uhd::usrp::mboard_eeprom_t &mb_eeprom){

    mb_eeprom.commit(*(_mbc[mb].iface), mboard_eeprom_t::MAP_N100);

}

void usrp2_impl::set_db_eeprom(const std::string &mb, const std::string &type, const uhd::usrp::dboard_eeprom_t &db_eeprom){

    if (type == "rx") db_eeprom.store(*_mbc[mb].iface, USRP2_I2C_ADDR_RX_DB);

    if (type == "tx") db_eeprom.store(*_mbc[mb].iface, USRP2_I2C_ADDR_TX_DB);

    if (type == "gdb") db_eeprom.store(*_mbc[mb].iface, USRP2_I2C_ADDR_TX_DB ^ 5);

}

sensor_value_t usrp2_impl::get_mimo_locked(const std::string &mb){

    const bool lock = (_mbc[mb].iface->peek32(U2_REG_IRQ_RB) & (1<<10)) != 0;

    return sensor_value_t("MIMO", lock, "locked", "unlocked");

}

sensor_value_t usrp2_impl::get_ref_locked(const std::string &mb){

    const bool lock = (_mbc[mb].iface->peek32(U2_REG_IRQ_RB) & (1<<11)) != 0;

    return sensor_value_t("Ref", lock, "locked", "unlocked");

}

#include <boost/math/special_functions/round.hpp>

#include <boost/math/special_functions/sign.hpp>

double usrp2_impl::set_tx_dsp_freq(const std::string &mb, const double freq_){

    double new_freq = freq_;

    const double tick_rate = _tree->access<double>("/mboards/"+mb+"/tick_rate").get();

    //calculate the DAC shift (multiples of rate)

    const int sign = boost::math::sign(new_freq);

    const int zone = std::min(boost::math::iround(new_freq/tick_rate), 2);

    const double dac_shift = sign*zone*tick_rate;

    new_freq -= dac_shift; //update FPGA DSP target freq

    //set the DAC shift (modulation mode)

    if (zone == 0) _mbc[mb].codec->set_tx_mod_mode(0); //no shift

    else _mbc[mb].codec->set_tx_mod_mode(sign*4/zone); //DAC interp = 4

    return _mbc[mb].tx_dsp->set_freq(new_freq) + dac_shift; //actual freq

}

meta_range_t usrp2_impl::get_tx_dsp_freq_range(const std::string &mb){

    const double tick_rate = _tree->access<double>("/mboards/"+mb+"/tick_rate").get();

    const meta_range_t dsp_range = _mbc[mb].tx_dsp->get_freq_range();

    return meta_range_t(dsp_range.start() - tick_rate*2, dsp_range.stop() + tick_rate*2, dsp_range.step());

}

void usrp2_impl::update_clock_source(const std::string &mb, const std::string &source){

    //clock source ref 10mhz

    switch(_mbc[mb].iface->get_rev()){

    case usrp2_iface::USRP_N200:

    case usrp2_iface::USRP_N210:

    case usrp2_iface::USRP_N200_R4:

    case usrp2_iface::USRP_N210_R4:

        if (source == "internal")       _mbc[mb].iface->poke32(U2_REG_MISC_CTRL_CLOCK, 0x12);

        else if (source == "external")  _mbc[mb].iface->poke32(U2_REG_MISC_CTRL_CLOCK, 0x1C);

        else if (source == "mimo")      _mbc[mb].iface->poke32(U2_REG_MISC_CTRL_CLOCK, 0x15);

        else throw uhd::value_error("unhandled clock configuration reference source: " + source);

        _mbc[mb].clock->enable_external_ref(true); //USRP2P has an internal 10MHz TCXO

        break;

    case usrp2_iface::USRP2_REV3:

    case usrp2_iface::USRP2_REV4:

        if (source == "internal")       _mbc[mb].iface->poke32(U2_REG_MISC_CTRL_CLOCK, 0x10);

        else if (source == "external")  _mbc[mb].iface->poke32(U2_REG_MISC_CTRL_CLOCK, 0x1C);

        else if (source == "mimo")      _mbc[mb].iface->poke32(U2_REG_MISC_CTRL_CLOCK, 0x15);

        else throw uhd::value_error("unhandled clock configuration reference source: " + source);

        _mbc[mb].clock->enable_external_ref(source != "internal");

        break;

    case usrp2_iface::USRP_NXXX: break;

    }

    //always drive the clock over serdes if not locking to it

    _mbc[mb].clock->enable_mimo_clock_out(source != "mimo");

    //set the mimo clock delay over the serdes

    if (source != "mimo"){

        switch(_mbc[mb].iface->get_rev()){

        case usrp2_iface::USRP_N200:

        case usrp2_iface::USRP_N210:

        case usrp2_iface::USRP_N200_R4:

        case usrp2_iface::USRP_N210_R4:

            _mbc[mb].clock->set_mimo_clock_delay(mimo_clock_delay_usrp_n2xx);

            break;

        case usrp2_iface::USRP2_REV4:

            _mbc[mb].clock->set_mimo_clock_delay(mimo_clock_delay_usrp2_rev4);

            break;

        default: break; //not handled

        }

    }

}