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
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
|
//
// Copyright 2018 Ettus Research, a National Instruments Company
//
// SPDX-License-Identifier: GPL-3.0-or-later
//
#ifndef INCLUDED_LIBUHD_RFNOC_E3XX_RADIO_CTRL_IMPL_HPP
# define INCLUDED_LIBUHD_RFNOC_E3XX_RADIO_CTRL_IMPL_HPP
# include "e3xx_ad9361_iface.hpp"
# include <uhd/types/serial.hpp>
# include <uhd/usrp/dboard_manager.hpp>
# include <uhd/usrp/gpio_defs.hpp>
# include <uhdlib/rfnoc/radio_ctrl_impl.hpp>
# include <uhdlib/rfnoc/rpc_block_ctrl.hpp>
# include <uhdlib/usrp/cores/gpio_atr_3000.hpp>
# include <mutex>
namespace uhd { namespace rfnoc {
/*! \brief Provide access to an E3xx radio.
*/
class e3xx_radio_ctrl_impl : public radio_ctrl_impl, public rpc_block_ctrl
{
public:
typedef boost::shared_ptr<e3xx_radio_ctrl_impl> sptr;
//! Frequency bands for RX. Bands are a function of the analog filter banks
enum class rx_band { INVALID_BAND, LB_B2, LB_B3, LB_B4, LB_B5, LB_B6, LB_B7, HB };
//! Frequency bands for TX. Bands are a function of the analog filter banks
enum class tx_band {
INVALID_BAND,
LB_80,
LB_160,
LB_225,
LB_400,
LB_575,
LB_1000,
LB_1700,
LB_2750,
HB
};
/**************************************************************************
* ATR/ Switches Types
*************************************************************************/
//! ATR state
enum atr_state_t { IDLE, RX_ONLY, TX_ONLY, FULL_DUPLEX };
//! Channel select:
enum chan_sel_t { CHAN1, CHAN2, BOTH };
/************************************************************************
* Structors
***********************************************************************/
e3xx_radio_ctrl_impl();
virtual ~e3xx_radio_ctrl_impl();
/************************************************************************
* API calls
***********************************************************************/
// Note: We use the cached values in radio_ctrl_impl, so most getters are
// not reimplemented here
//! Set streaming mode - active chains, channel_mode, timing_mode
void set_streaming_mode(
const bool tx1, const bool tx2, const bool rx1, const bool rx2);
//! Set which channel mode is used
void set_channel_mode(const std::string& channel_mode);
double set_rate(const 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 set_tx_bandwidth(const double bandwidth, const size_t chan);
double set_rx_bandwidth(const double bandwidth, 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);
protected:
//! Map a frequency in Hz to an rx_band value. Will return
// rx_band::INVALID_BAND if the frequency is out of range.
rx_band map_freq_to_rx_band(const double freq);
//! Map a frequency in Hz to an tx_band value. Will return
// tx_band::INVALID_BAND if the frequency is out of range.
tx_band map_freq_to_tx_band(const double freq);
virtual const std::string get_default_timing_mode() = 0;
/*! Run a loopback self test.
*
* This will write data to the AD936x and read it back again.
* If this test fails, it generally means the interface is broken,
* so we assume it passes and throw otherwise. Running this requires
* a core that we can peek and poke the loopback values into.
*
* \param iface An interface to the associated radio control core
* \param iface The radio control core's address to write the loopback value
* \param iface The radio control core's readback address to read back the returned
* value
*
* \throws a uhd::runtime_error if the loopback value didn't match.
*/
virtual void loopback_self_test(std::function<void(uint32_t)> poker_functor,
std::function<uint64_t()> peeker_functor) = 0;
virtual uint32_t get_rx_switches(
const size_t chan, const double freq, const std::string& ant) = 0;
virtual uint32_t get_tx_switches(const size_t chan, const double freq) = 0;
virtual uint32_t get_idle_switches() = 0;
virtual uint32_t get_tx_led() = 0;
virtual uint32_t get_rx_led() = 0;
virtual uint32_t get_txrx_led() = 0;
virtual uint32_t get_idle_led() = 0;
//! Reference to the AD9361 controls
// e3xx_ad9361_iface::uptr _ad9361;
ad9361_ctrl::sptr _ad9361;
//! Swap RFA and RFB for catalina
bool _fe_swap;
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 Catalina defaults
void _init_codec();
//! 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);
/**************************************************************************
* Misc Controls
*************************************************************************/
//! Blink the front-panel LEDs for \p identify_duration,
// and resume normal operation.
void _identify_with_leds(const int identify_duration);
void _set_atr_bits(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;
//! 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;
//! ATR controls. These control the AD9361 gain
// up/down bits.
// Every radio channel gets its own ATR state register.
std::vector<usrp::gpio_atr::gpio_atr_3000::sptr> _db_gpio;
// ATR controls for LEDs
std::vector<usrp::gpio_atr::gpio_atr_3000::sptr> _leds_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
double _master_clock_rate = 1.0;
}; /* class radio_ctrl_impl */
}} /* namespace uhd::rfnoc */
#endif /* INCLUDED_LIBUHD_RFNOC_E3XX_RADIO_CTRL_IMPL_HPP */
// vim: sw=4 et:
|
