1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
//
// Copyright 2017-2018 Ettus Research, a National Instruments Company
//
// SPDX-License-Identifier: GPL-3.0-or-later
//
#pragma once
#include "ad937x_device_types.hpp"
#include "adi/mykonos_debug/t_mykonos_dbgjesd.h"
#include "adi/t_mykonos.h"
#include "adi/t_mykonos_gpio.h"
#include "config/ad937x_config_t.hpp"
#include "config/ad937x_fir.hpp"
#include "config/ad937x_gain_ctrl_config.hpp"
#include "mpm/ad937x/ad937x_ctrl_types.hpp"
#include "mpm/ad937x/adi_ctrl.hpp"
#include <mpm/exception.hpp>
#include <mpm/spi/spi_iface.hpp>
#include <boost/filesystem.hpp>
#include <boost/noncopyable.hpp>
#include <functional>
#include <map>
#include <memory>
class ad937x_device : public boost::noncopyable
{
public:
enum class gain_mode_t { MANUAL, AUTOMATIC, HYBRID };
enum pll_t : uint8_t {
CLK_SYNTH = 0x01,
RX_SYNTH = 0x02,
TX_SYNTH = 0x04,
SNIFF_SYNTH = 0x08,
CALPLL_SDM = 0x10,
};
enum mcr_t { MCR_122_88MHZ, MCR_125_00MHZ, MCR_153_60MHZ };
ad937x_device(mpm::types::regs_iface* iface,
const size_t deserializer_lane_xbar,
mpm::ad937x::gpio::gain_pins_t gain_pins);
void begin_initialization();
void finish_initialization();
void setup_cal(const uint32_t init_cals_mask,
const uint32_t tracking_cals_mask,
const uint32_t timeout);
uint8_t set_lo_source(const uhd::direction_t direction, const uint8_t pll_source);
uint8_t get_lo_source(const uhd::direction_t direction) const;
void start_jesd_rx();
void start_jesd_tx();
void start_radio();
void stop_radio();
uint8_t get_multichip_sync_status();
uint8_t get_framer_status();
uint8_t get_deframer_status();
uint16_t get_ilas_config_match();
void enable_jesd_loopback(const uint8_t enable);
uint8_t get_product_id();
uint8_t get_device_rev();
mpm::ad937x::device::api_version_t get_api_version();
mpm::ad937x::device::arm_version_t get_arm_version();
double set_bw_filter(const uhd::direction_t direction, const double value);
void set_agc_mode(const uhd::direction_t direction, const gain_mode_t mode);
double set_clock_rate(const double value);
void enable_channel(const uhd::direction_t direction,
const mpm::ad937x::device::chain_t chain,
const bool enable);
double set_gain(const uhd::direction_t direction,
const mpm::ad937x::device::chain_t chain,
const double value);
double get_gain(
const uhd::direction_t direction, const mpm::ad937x::device::chain_t chain);
double tune(
const uhd::direction_t direction, const double value, const bool wait_for_lock);
double get_freq(const uhd::direction_t direction);
bool get_pll_lock_status(const uint8_t pll, const bool wait_for_lock = false);
void set_fir(const std::string& name, int8_t gain, const std::vector<int16_t>& fir);
void set_fir(
const uhd::direction_t direction, int8_t gain, const std::vector<int16_t>& fir);
std::pair<int8_t, std::vector<int16_t>> get_fir(const std::string& name);
int16_t get_temperature();
void set_enable_gain_pins(const uhd::direction_t direction,
const mpm::ad937x::device::chain_t chain,
const bool enable);
void set_gain_pin_step_sizes(const uhd::direction_t direction,
const mpm::ad937x::device::chain_t chain,
const double inc_step,
const double dec_step);
void update_rx_lo_source(uint8_t rxPllUseExternalLo);
void update_tx_lo_source(uint8_t rxPllUseExternalLo);
uint8_t get_rx_lo_source();
uint8_t get_tx_lo_source();
void set_master_clock_rate(const mcr_t rate);
const static double MIN_FREQ;
const static double MAX_FREQ;
const static double MIN_RX_GAIN;
const static double MAX_RX_GAIN;
const static double RX_GAIN_STEP;
const static double MIN_TX_GAIN;
const static double MAX_TX_GAIN;
const static double TX_GAIN_STEP;
private:
enum class multichip_sync_t { PARTIAL, FULL };
enum class radio_state_t { OFF, ON };
ad9371_spiSettings_t full_spi_settings;
ad937x_config_t mykonos_config;
ad937x_gain_ctrl_config_t gain_ctrl;
void _apply_gain_pins(
const uhd::direction_t direction, mpm::ad937x::device::chain_t chain);
void _setup_rf();
void _call_api_function(const std::function<mykonosErr_t()>& func);
void _call_gpio_api_function(const std::function<mykonosGpioErr_t()>& func);
std::string _get_arm_binary_path() const;
std::vector<uint8_t> _get_arm_binary();
void _verify_product_id();
void _verify_multichip_sync_status(const multichip_sync_t mcs);
radio_state_t _move_to_config_state();
void _restore_from_config_state(radio_state_t state);
static uint8_t _convert_rx_gain_to_mykonos(const double gain);
static double _convert_rx_gain_from_mykonos(const uint8_t gain);
static uint16_t _convert_tx_gain_to_mykonos(const double gain);
static double _convert_tx_gain_from_mykonos(const uint16_t gain);
const static std::map<std::string, mykonosfirName_t> _tx_filter_map;
const static std::map<std::string, mykonosfirName_t> _rx_filter_map;
};
|
