mirror of
https://github.com/RangeNetworks/openbts.git
synced 2025-11-03 05:13:16 +00:00
8c5ccbf25f
With the introduction of the B100, there is USB support using UHD devices. The characteristics of the trasmit side burst submissions are more reflective of the bus type than the device or driver. Use a fixed latency interval for network devices and the adaptive underrun approach for USB devices - regardless of driver or device type. The GPMC based transport on the E100 appears unaffected by either latency scheme, which defaults to network. Signed-off-by: Thomas Tsou <ttsou@vt.edu> git-svn-id: http://wush.net/svn/range/software/public/openbts/trunk@2677 19bc5d8c-e614-43d4-8b26-e1612bc8e597
129 lines
3.9 KiB
C++
129 lines
3.9 KiB
C++
/*
|
|
* Copyright 2008 Free Software Foundation, Inc.
|
|
*
|
|
* This software is distributed under multiple licenses; see the COPYING file in the main directory for licensing information for this specific distribuion.
|
|
*
|
|
* This use of this software may be subject to additional restrictions.
|
|
* See the LEGAL file in the main directory for details.
|
|
|
|
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.
|
|
|
|
*/
|
|
|
|
#ifndef __RADIO_DEVICE_H__
|
|
#define __RADIO_DEVICE_H__
|
|
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
#include "config.h"
|
|
#endif
|
|
|
|
/** a 64-bit virtual timestamp for radio data */
|
|
typedef unsigned long long TIMESTAMP;
|
|
|
|
/** A class to handle a USRP rev 4, with a two RFX900 daughterboards */
|
|
class RadioDevice {
|
|
|
|
public:
|
|
/* Available transport bus types */
|
|
enum busType { USB, NET };
|
|
|
|
static RadioDevice *make(double desiredSampleRate, bool skipRx = false);
|
|
|
|
/** Initialize the USRP */
|
|
virtual bool open()=0;
|
|
|
|
/** Start the USRP */
|
|
virtual bool start()=0;
|
|
|
|
/** Stop the USRP */
|
|
virtual bool stop()=0;
|
|
|
|
/** Get the bus type */
|
|
virtual enum busType getBus()=0;
|
|
|
|
/** Enable thread priority */
|
|
virtual void setPriority()=0;
|
|
|
|
/**
|
|
Read samples from the radio.
|
|
@param buf preallocated buf to contain read result
|
|
@param len number of samples desired
|
|
@param overrun Set if read buffer has been overrun, e.g. data not being read fast enough
|
|
@param timestamp The timestamp of the first samples to be read
|
|
@param underrun Set if radio does not have data to transmit, e.g. data not being sent fast enough
|
|
@param RSSI The received signal strength of the read result
|
|
@return The number of samples actually read
|
|
*/
|
|
virtual int readSamples(short *buf, int len, bool *overrun,
|
|
TIMESTAMP timestamp = 0xffffffff,
|
|
bool *underrun = 0,
|
|
unsigned *RSSI = 0)=0;
|
|
/**
|
|
Write samples to the radio.
|
|
@param buf Contains the data to be written.
|
|
@param len number of samples to write.
|
|
@param underrun Set if radio does not have data to transmit, e.g. data not being sent fast enough
|
|
@param timestamp The timestamp of the first sample of the data buffer.
|
|
@param isControl Set if data is a control packet, e.g. a ping command
|
|
@return The number of samples actually written
|
|
*/
|
|
virtual int writeSamples(short *buf, int len, bool *underrun,
|
|
TIMESTAMP timestamp,
|
|
bool isControl=false)=0;
|
|
|
|
/** Update the alignment between the read and write timestamps */
|
|
virtual bool updateAlignment(TIMESTAMP timestamp)=0;
|
|
|
|
/** Set the transmitter frequency */
|
|
virtual bool setTxFreq(double wFreq)=0;
|
|
|
|
/** Set the receiver frequency */
|
|
virtual bool setRxFreq(double wFreq)=0;
|
|
|
|
/** Returns the starting write Timestamp*/
|
|
virtual TIMESTAMP initialWriteTimestamp(void)=0;
|
|
|
|
/** Returns the starting read Timestamp*/
|
|
virtual TIMESTAMP initialReadTimestamp(void)=0;
|
|
|
|
/** returns the full-scale transmit amplitude **/
|
|
virtual double fullScaleInputValue()=0;
|
|
|
|
/** returns the full-scale receive amplitude **/
|
|
virtual double fullScaleOutputValue()=0;
|
|
|
|
/** sets the receive chan gain, returns the gain setting **/
|
|
virtual double setRxGain(double dB)=0;
|
|
|
|
/** gets the current receive gain **/
|
|
virtual double getRxGain(void)=0;
|
|
|
|
/** return maximum Rx Gain **/
|
|
virtual double maxRxGain(void) = 0;
|
|
|
|
/** return minimum Rx Gain **/
|
|
virtual double minRxGain(void) = 0;
|
|
|
|
/** sets the transmit chan gain, returns the gain setting **/
|
|
virtual double setTxGain(double dB)=0;
|
|
|
|
/** return maximum Tx Gain **/
|
|
virtual double maxTxGain(void) = 0;
|
|
|
|
/** return minimum Tx Gain **/
|
|
virtual double minTxGain(void) = 0;
|
|
|
|
/** Return internal status values */
|
|
virtual double getTxFreq()=0;
|
|
virtual double getRxFreq()=0;
|
|
virtual double getSampleRate()=0;
|
|
virtual double numberRead()=0;
|
|
virtual double numberWritten()=0;
|
|
|
|
};
|
|
|
|
#endif
|