2 // Copyright 2008,2009 Free Software Foundation, Inc.
4 // This file is part of GNU Radio
6 // GNU Radio is free software; you can redistribute it and/or modify
7 // it under the terms of the GNU General Public License as published by
8 // the Free Software Foundation; either asversion 3, or (at your option)
11 // GNU Radio is distributed in the hope that it will be useful,
12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 // GNU General Public License for more details.
16 // You should have received a copy of the GNU General Public License
17 // along with GNU Radio; see the file COPYING. If not, write to
18 // the Free Software Foundation, Inc., 51 Franklin Street,
19 // Boston, MA 02110-1301, USA.
25 #include <usrp/db_wbxng.h>
26 #include "db_wbxng_adf4350.h"
27 #include <db_base_impl.h>
30 // d'board i/o pin defs
31 // Tx and Rx have shared defs, but different i/o regs
32 #define ENABLE_5 (1 << 7) // enables 5.0V power supply
33 #define ENABLE_33 (1 << 6) // enables 3.3V supply
34 //#define RX_TXN (1 << 15) // Tx only: T/R antenna switch for TX/RX port
35 //#define RX2_RX1N (1 << 15) // Rx only: antenna switch between RX2 and TX/RX port
36 #define RX_TXN ((1 << 5)|(1 << 15)) // Tx only: T/R antenna switch for TX/RX port
37 #define RX2_RX1N ((1 << 5)|(1 << 15)) // Rx only: antenna switch between RX2 and TX/RX port
38 #define RXBB_EN (1 << 4)
39 #define TXMOD_EN (1 << 4)
40 #define PLL_CE (1 << 3)
41 #define PLL_PDBRF (1 << 2)
42 #define PLL_MUXOUT (1 << 1)
43 #define PLL_LOCK_DETECT (1 << 0)
45 // RX Attenuator constants
47 #define ATTN_MASK (63 << ATTN_SHIFT)
49 wbxng_base::wbxng_base(usrp_basic_sptr _usrp, int which)
50 : db_base(_usrp, which)
53 @param usrp: instance of usrp.source_c
54 @param which: which side: 0 or 1 corresponding to side A or B respectively
58 usrp()->_write_oe(d_which, 0, 0xffff); // turn off all outputs
61 d_spi_format = SPI_FMT_MSB | SPI_FMT_HDR_0;
63 _enable_refclk(false); // disable refclk
68 wbxng_base::~wbxng_base()
73 wbxng_base::_refclk_divisor()
79 wbxng_base::set_freq(double freq)
82 @returns (ok, actual_baseband_freq) where:
83 ok is True or False and indicates success or failure,
84 actual_baseband_freq is the RF frequency that corresponds to DC in the IF.
88 freq_t int_freq = freq_t(std::max(freq_min(), std::min(freq, freq_max())));
90 bool ok = d_common->_set_freq(int_freq*2, _refclk_freq());
92 _write_spi(d_common->compute_register(5));
93 _write_spi(d_common->compute_register(4));
94 _write_spi(d_common->compute_register(3));
95 /* load involved registers */
96 _write_spi(d_common->compute_register(2));
97 _write_spi(d_common->compute_register(1));
98 _write_spi(d_common->compute_register(0));
100 double freq_result = (double) d_common->_get_freq(_refclk_freq())/2.0;
102 //ok &= _get_locked();
103 struct freq_result_t args = {ok, freq_result};
105 /* Wait before reading Lock Detect*/
108 t.tv_nsec = 10000000;
111 //fprintf(stderr,"Setting WBXNG frequency, requested %d, obtained %f, lock_detect %d\n",
112 // int_freq, freq_result, d_common->_get_locked());
115 // Offsetting the LO helps get the Tx carrier leakage out of the way.
116 // This also ensures that on Rx, we're not getting hosed by the
117 // FPGA's DC removal loop's time constant. We were seeing a
118 // problem when running with discontinuous transmission.
119 // Offsetting the LO made the problem go away.
120 //freq += d_lo_offset;
126 wbxng_base::_set_pga(float pga_gain)
129 usrp()->set_pga(0, pga_gain);
130 usrp()->set_pga(1, pga_gain);
133 usrp()->set_pga(2, pga_gain);
134 usrp()->set_pga(3, pga_gain);
140 wbxng_base::is_quadrature()
143 Return True if this board requires both I & Q analog channels.
145 This bit of info is useful when setting up the USRP Rx mux register.
151 wbxng_base::freq_min()
153 return (double) d_common->_get_min_freq()/2.0;
157 wbxng_base::freq_max()
159 return (double) d_common->_get_max_freq()/2.0;
163 wbxng_base::_get_locked(void)
165 return usrp()->read_io(d_which) & PLL_LOCK_DETECT;
169 wbxng_base::_write_spi(std::string data)
171 usrp()->_write_spi(0, d_spi_enable, d_spi_format, data);
174 // ----------------------------------------------------------------
176 db_wbxng_tx::db_wbxng_tx(usrp_basic_sptr _usrp, int which)
177 : wbxng_base(_usrp, which)
180 @param usrp: instance of usrp.sink_c
181 @param which: 0 or 1 corresponding to side TX_A or TX_B respectively.
185 d_spi_enable = SPI_ENABLE_TX_A;
188 d_spi_enable = SPI_ENABLE_TX_B;
191 d_common = boost::shared_ptr<adf4350> (new adf4350());
193 /* Initialize the registers. */
194 _write_spi(d_common->compute_register(5));
195 _write_spi(d_common->compute_register(4));
196 _write_spi(d_common->compute_register(3));
197 _write_spi(d_common->compute_register(2));
198 _write_spi(d_common->compute_register(1));
199 _write_spi(d_common->compute_register(0));
201 // power up the transmit side, but don't enable the mixer
202 usrp()->_write_oe(d_which,(PLL_CE|PLL_PDBRF|RX_TXN|TXMOD_EN|ENABLE_33|ENABLE_5), (PLL_CE|PLL_PDBRF|RX_TXN|TXMOD_EN|ENABLE_33|ENABLE_5));
203 usrp()->write_io(d_which, (PLL_CE|RX_TXN|ENABLE_33|ENABLE_5), (PLL_CE|PLL_PDBRF|RX_TXN|ENABLE_33|ENABLE_5));
204 //set_lo_offset(4e6);
207 //d_common->_enable(true);
208 usrp()->write_io(d_which, (PLL_PDBRF), (PLL_PDBRF));
210 set_gain(gain_min()); // initialize gain
213 db_wbxng_tx::~db_wbxng_tx()
219 db_wbxng_tx::shutdown()
221 // fprintf(stderr, "db_wbxng_tx::shutdown d_is_shutdown = %d\n", d_is_shutdown);
224 d_is_shutdown = true;
225 // do whatever there is to do to shutdown
228 //d_common->_enable(false);
229 usrp()->write_io(d_which, 0, (PLL_PDBRF));
231 // Power down and leave the T/R switch in the R position
232 usrp()->write_io(d_which, (RX_TXN), (PLL_CE|PLL_PDBRF|RX_TXN|ENABLE_33|ENABLE_5));
235 _write_control(_compute_control_reg());
237 _enable_refclk(false); // turn off refclk
243 db_wbxng_tx::set_auto_tr(bool on)
247 ok &= set_atr_mask (RX_TXN | TXMOD_EN);
248 ok &= set_atr_txval(0 | TXMOD_EN);
249 ok &= set_atr_rxval(RX_TXN);
252 ok &= set_atr_mask (0);
253 ok &= set_atr_txval(0);
254 ok &= set_atr_rxval(0);
260 db_wbxng_tx::set_enable(bool on)
263 Enable transmitter if on is true
267 int mask = RX_TXN | TXMOD_EN;
271 //d_common->_enable(true);
276 //d_common->_enable(false);
278 return usrp()->write_io(d_which, v, mask);
282 db_wbxng_tx::gain_min()
288 db_wbxng_tx::gain_max()
294 db_wbxng_tx::gain_db_per_step()
296 return gain_max()/(1+(1.4-0.5)*4096/3.3);
300 db_wbxng_tx::set_gain(float gain)
305 @param gain: gain in decibels
310 gain = std::max(gain_min(), std::min(gain, gain_max()));
312 float pga_gain, agc_gain;
313 float V_maxgain, V_mingain, V_fullscale, dac_value;
315 float maxgain = gain_max();
316 float mingain = gain_min();
323 dac_value = (agc_gain*(V_maxgain-V_mingain)/(maxgain-mingain) + V_mingain)*4096/V_fullscale;
325 //fprintf(stderr, "TXGAIN: %f dB, Dac Code: %d, Voltage: %f\n", gain, int(dac_value), float((dac_value/4096.0)*V_fullscale));
326 assert(dac_value>=0 && dac_value<4096);
328 return (usrp()->write_aux_dac(d_which, 0, int(dac_value))
329 && _set_pga(usrp()->pga_max()));
334 /**************************************************************************/
337 db_wbxng_rx::db_wbxng_rx(usrp_basic_sptr _usrp, int which)
338 : wbxng_base(_usrp, which)
341 @param usrp: instance of usrp.source_c
342 @param which: 0 or 1 corresponding to side RX_A or RX_B respectively.
346 d_spi_enable = SPI_ENABLE_RX_A;
349 d_spi_enable = SPI_ENABLE_RX_B;
352 d_common = boost::shared_ptr<adf4350> (new adf4350());
354 /* Initialize the registers. */
355 _write_spi(d_common->compute_register(5));
356 _write_spi(d_common->compute_register(4));
357 _write_spi(d_common->compute_register(3));
358 _write_spi(d_common->compute_register(2));
359 _write_spi(d_common->compute_register(1));
360 _write_spi(d_common->compute_register(0));
362 usrp()->_write_oe(d_which, (PLL_CE|PLL_PDBRF|RX2_RX1N|RXBB_EN|ATTN_MASK|ENABLE_33|ENABLE_5), (PLL_CE|PLL_PDBRF|RX2_RX1N|RXBB_EN|ATTN_MASK|ENABLE_33|ENABLE_5));
363 usrp()->write_io(d_which, (PLL_CE|RX2_RX1N|RXBB_EN|ENABLE_33|ENABLE_5), (PLL_CE|PLL_PDBRF|RX2_RX1N|RXBB_EN|ATTN_MASK|ENABLE_33|ENABLE_5));
364 //fprintf(stderr,"Setting WBXNG RXBB on");
367 //d_common->_enable(true);
368 usrp()->write_io(d_which, (PLL_PDBRF), (PLL_PDBRF));
370 // set up for RX on TX/RX port
371 select_rx_antenna("TX/RX");
373 bypass_adc_buffers(true);
379 set_gain(gain_min()); // initialize gain
382 db_wbxng_rx::~db_wbxng_rx()
388 db_wbxng_rx::shutdown()
390 // fprintf(stderr, "db_wbxng_rx::shutdown d_is_shutdown = %d\n", d_is_shutdown);
393 d_is_shutdown = true;
394 // do whatever there is to do to shutdown
396 // Power down VCO/PLL
397 //d_common->_enable(false);
398 usrp()->write_io(d_which, 0, (PLL_PDBRF));
400 // fprintf(stderr, "db_wbxng_rx::shutdown before _write_control\n");
401 //_write_control(_compute_control_reg());
403 // fprintf(stderr, "db_wbxng_rx::shutdown before _enable_refclk\n");
404 _enable_refclk(false); // turn off refclk
406 // fprintf(stderr, "db_wbxng_rx::shutdown before set_auto_tr\n");
410 usrp()->write_io(d_which, 0, (PLL_CE|PLL_PDBRF|RX2_RX1N|RXBB_EN|ATTN_MASK|ENABLE_33|ENABLE_5));
412 // fprintf(stderr, "db_wbxng_rx::shutdown after set_auto_tr\n");
417 db_wbxng_rx::set_auto_tr(bool on)
421 ok &= set_atr_mask (RXBB_EN|RX2_RX1N);
422 ok &= set_atr_txval( 0|RX2_RX1N);
423 ok &= set_atr_rxval(RXBB_EN| 0);
426 ok &= set_atr_mask (0);
427 ok &= set_atr_txval(0);
428 ok &= set_atr_rxval(0);
434 db_wbxng_rx::select_rx_antenna(int which_antenna)
437 Specify which antenna port to use for reception.
438 @param which_antenna: either 'TX/RX' or 'RX2'
441 if(which_antenna == 0) {
442 usrp()->write_io(d_which, 0,RX2_RX1N);
444 else if(which_antenna == 1) {
445 usrp()->write_io(d_which, RX2_RX1N, RX2_RX1N);
454 db_wbxng_rx::select_rx_antenna(const std::string &which_antenna)
457 Specify which antenna port to use for reception.
458 @param which_antenna: either 'TX/RX' or 'RX2'
462 if(which_antenna == "TX/RX") {
463 usrp()->write_io(d_which, 0, RX2_RX1N);
465 else if(which_antenna == "RX2") {
466 usrp()->write_io(d_which, RX2_RX1N, RX2_RX1N);
476 db_wbxng_rx::set_gain(float gain)
481 @param gain: gain in decibels
486 gain = std::max(gain_min(), std::min(gain, gain_max()));
488 float pga_gain, agc_gain;
490 float maxgain = gain_max() - usrp()->pga_max();
492 pga_gain = gain-maxgain;
493 assert(pga_gain <= usrp()->pga_max());
501 return _set_attn(maxgain-agc_gain) && _set_pga(int(pga_gain));
505 db_wbxng_rx::_set_attn(float attn)
507 int attn_code = int(floor(attn/0.5));
508 unsigned int iobits = (~attn_code) << ATTN_SHIFT;
509 //fprintf(stderr, "Attenuation: %f dB, Code: %d, IO Bits %x, Mask: %x \n", attn, attn_code, iobits & ATTN_MASK, ATTN_MASK);
510 return usrp()->write_io(d_which, iobits, ATTN_MASK);
514 db_wbxng_rx::gain_min()
516 return usrp()->pga_min();
520 db_wbxng_rx::gain_max()
522 return usrp()->pga_max()+30.5;
526 db_wbxng_rx::gain_db_per_step()
532 db_wbxng_rx::i_and_q_swapped()