summaryrefslogtreecommitdiff
path: root/usrp2/firmware/lib/db_base.h
blob: 1945efe0b9286299ad150b18e129a1fd156df97d (plain)
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
/* -*- c++ -*- */
/*
 * Copyright 2008,2009 Free Software Foundation, Inc.
 *
 * 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/>.
 */

#ifndef INCLUDED_DB_BASE_H
#define INCLUDED_DB_BASE_H

#include <usrp2_types.h>
#include <bool.h>

/*!
 * \brief "base class" for firmware version of daughterboard code
 */
struct db_base {
  uint16_t		dbid;		//< daughterboard ID

  uint16_t              is_tx 		  : 1;  //< is this a transmit db?
  uint16_t		is_quadrature 	  : 1;
  uint16_t		i_and_q_swapped   : 1;
  uint16_t		spectrum_inverted : 1;

  uint16_t		output_enables;	//< bitmask of which pins should be outputs from FPGA
  uint16_t		used_pins;	//< bitmask of pins used by the daughterboard

  u2_fxpt_freq_t	freq_min;	//< min freq that can be set (Hz)
  u2_fxpt_freq_t	freq_max;	//< max freq that can be set (Hz)

  u2_fxpt_gain_t	gain_min;	//< min gain that can be set (dB)
  u2_fxpt_gain_t	gain_max;	//< max gain that can be set (dB)
  u2_fxpt_gain_t	gain_step_size;	//< (dB)

  u2_fxpt_freq_t	default_lo_offset;  //< offset to add to tune frequency, reset value
  u2_fxpt_freq_t        current_lo_offset;  //< current value of lo_offset

  /*
   * Auto T/R control values
   */
  uint32_t		atr_mask;       //< which bits to control
  uint32_t		atr_txval;	//< value to use when transmitting
  uint32_t		atr_rxval;	//< value to use when receiving

  //! delay in clk ticks from when Tx fifo gets data to when T/R switches
  // uint32_t		atr_tx_delay;

  //! delay in clk ticks from when Tx fifo goes empty to when T/R switches
  // uint32_t		atr_rx_delay;

  bool	(*init)(struct db_base *);
  bool	(*set_freq)(struct db_base *, u2_fxpt_freq_t freq, u2_fxpt_freq_t *dc);
  bool	(*set_gain)(struct db_base *, u2_fxpt_gain_t gain);
  bool	(*set_tx_enable)(struct db_base *, bool on);
  bool	(*set_antenna)(struct db_base *, int ant);
};


#endif /* INCLUDED_DB_BASE_H */