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
|
//
// Copyright 2010 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/>.
//
#ifndef INCLUDED_USRP2_IFACE_HPP
#define INCLUDED_USRP2_IFACE_HPP
#include <uhd/transport/udp_simple.hpp>
#include <uhd/types/serial.hpp>
#include <uhd/usrp/mboard_eeprom.hpp>
#include <boost/shared_ptr.hpp>
#include <boost/utility.hpp>
#include <boost/cstdint.hpp>
#include <boost/function.hpp>
#include <utility>
#include <string>
#include "fw_common.h"
#include "usrp2_regs.hpp"
//TODO: kill this crap when you have the top level GPS include file
typedef boost::function<void(std::string)> gps_send_fn_t;
typedef boost::function<std::string(void)> gps_recv_fn_t;
/*!
* The usrp2 interface class:
* Provides a set of functions to implementation layer.
* Including spi, peek, poke, control...
*/
class usrp2_iface : public uhd::i2c_iface, boost::noncopyable{
public:
typedef boost::shared_ptr<usrp2_iface> sptr;
/*!
* Make a new usrp2 interface with the control transport.
* \param ctrl_transport the udp transport object
* \return a new usrp2 interface object
*/
static sptr make(uhd::transport::udp_simple::sptr ctrl_transport);
/*!
* Perform a control transaction.
* \param data a control data struct
* \return the result control data
*/
virtual usrp2_ctrl_data_t ctrl_send_and_recv(const usrp2_ctrl_data_t &data) = 0;
/*!
* Write a register (32 bits)
* \param addr the address
* \param data the 32bit data
*/
virtual void poke32(boost::uint32_t addr, boost::uint32_t data) = 0;
/*!
* Read a register (32 bits)
* \param addr the address
* \return the 32bit data
*/
virtual boost::uint32_t peek32(boost::uint32_t addr) = 0;
/*!
* Write a register (16 bits)
* \param addr the address
* \param data the 16bit data
*/
virtual void poke16(boost::uint32_t addr, boost::uint16_t data) = 0;
/*!
* Read a register (16 bits)
* \param addr the address
* \return the 16bit data
*/
virtual boost::uint16_t peek16(boost::uint32_t addr) = 0;
/*!
* Perform an spi transaction.
* \param which_slave the slave device number
* \param config spi config args
* \param data the bits to write
* \param num_bits how many bits in data
* \param readback true to readback a value
* \return spi data if readback set
*/
virtual boost::uint32_t transact_spi(
int which_slave,
const uhd::spi_config_t &config,
boost::uint32_t data,
size_t num_bits,
bool readback
) = 0;
virtual void write_uart(boost::uint8_t dev, const std::string &buf) = 0;
virtual std::string read_uart(boost::uint8_t dev) = 0;
virtual gps_recv_fn_t get_gps_read_fn(void) = 0;
virtual gps_send_fn_t get_gps_write_fn(void) = 0;
//! The list of possible revision types
enum rev_type {
USRP2_REV3 = 3,
USRP2_REV4 = 4,
USRP_N200 = 200,
USRP_N210 = 210,
USRP_NXXX = 0
};
//! Get the revision type for this device
virtual rev_type get_rev(void) = 0;
//! Get the canonical name for this device
virtual const std::string get_cname(void) = 0;
/*!
* Register map selected from USRP2/USRP2+.
*/
usrp2_regs_t regs;
//motherboard eeprom map structure
uhd::usrp::mboard_eeprom_t mb_eeprom;
};
#endif /* INCLUDED_USRP2_IFACE_HPP */
|
