/******************************************************************************* OpenAirInterface Copyright(c) 1999 - 2014 Eurecom OpenAirInterface 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. OpenAirInterface 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 OpenAirInterface.The full GNU General Public License is included in this distribution in the file called "COPYING". If not, see . Contact Information OpenAirInterface Admin: openair_admin@eurecom.fr OpenAirInterface Tech : openair_tech@eurecom.fr OpenAirInterface Dev : openair4g-devel@eurecom.fr Address : Eurecom, Campus SophiaTech, 450 Route des Chappes, CS 50193 - 06904 Biot Sophia Antipolis cedex, FRANCE *******************************************************************************/ /** common_lib.h * * Author: HongliangXU : hong-liang-xu@agilent.com */ #ifndef COMMON_LIB_H #define COMMON_LIB_H #include typedef int64_t openair0_timestamp; typedef struct openair0_device_t openair0_device; /* structrue holds the parameters to configure USRP devices */ #ifndef EXMIMO #define MAX_CARDS 1 #endif #define USRP_GAIN_OFFSET (86.0) // 86 calibrated for USRP B210 @ 2.6 GHz to get equivalent RS EPRE in OAI to SMBV100 output typedef enum { max_gain=0,med_gain,byp_gain } rx_gain_t; typedef struct { //! Module ID for this configuration int Mod_id; //! the sample rate for both transmit and receive. double sample_rate; //! number of samples per RX/TX packet (USRP + Ethernet) int samples_per_packet; //! number of RX channels (=RX antennas) int rx_num_channels; //! number of TX channels (=TX antennas) int tx_num_channels; //! \brief Center frequency in Hz for RX. //! index: [0..rx_num_channels[ double rx_freq[4]; //! \brief Center frequency in Hz for TX. //! index: [0..rx_num_channels[ !!! see lte-ue.c:427 FIXME iterates over rx_num_channels double tx_freq[4]; //! mode for rxgain (ExpressMIMO2) rx_gain_t rxg_mode[4]; //! \brief Gain for RX in dB. //! index: [0..rx_num_channels[ double rx_gain[4]; //! gain for TX in dB double tx_gain[4]; //! RX bandwidth in Hz double rx_bw; //! TX bandwidth in Hz double tx_bw; //! RRH IP addr for Ethernet interface char *rrh_ip; //! RRH port number for Ethernet interface int rrh_port; } openair0_config_t; typedef struct { /* card id */ int card; /* rf chain id */ int chain; } openair0_rf_map; struct openair0_device_t { /* Module ID of this device */ int Mod_id; /* RF frontend parameters set by application */ openair0_config_t openair0_cfg; /* Can be used by driver to hold internal structure*/ void *priv; /* Functions API, which are called by the application*/ /* Called to start the transceiver. Return 0 if OK, < 0 if error */ int (*trx_start_func)(openair0_device *device); /* Write 'nsamps' samples on each channel from buffers. buff[0] is the array for * the first channel. timestamp if the time (in samples) at which the first sample * MUST be sent * use flags = 1 to send as timestamp specfied*/ void (*trx_write_func)(openair0_device *device, openair0_timestamp timestamp, void **buff, int nsamps, int cc, int flags); /*! \brief Receive samples from hardware. * Read \ref nsamps samples from each channel to buffers. buff[0] is the array for * the first channel. *ptimestamp is the time at which the first sample * was received. * \param device the hardware to use * \param[out] ptimestamp the time at which the first sample was received. * \param[out] An array of pointers to buffers for received samples. The buffers must be large enough to hold the number of samples \ref nsamps. * \param nsamps Number of samples. One sample is 2 byte I + 2 byte Q => 4 byte. * \param cc Number of channels. If cc == 1, only buff[0] is filled with samples. * \returns the number of sample read */ int (*trx_read_func)(openair0_device *device, openair0_timestamp *ptimestamp, void **buff, int nsamps,int cc); /* Terminate operation of the transceiver -- free all associated resources */ void (*trx_end_func)(openair0_device *device); }; #ifdef __cplusplus extern "C" { #endif /* return 0 if OK, < 0 if error */ int openair0_device_init(openair0_device* device, openair0_config_t *openair0_cfg); openair0_timestamp get_usrp_time(openair0_device *device); int openair0_set_frequencies(openair0_device* device, openair0_config_t *openair0_cfg); int openair0_set_rx_frequencies(openair0_device* device, openair0_config_t *openair0_cfg); int openair0_set_gains(openair0_device* device, openair0_config_t *openair0_cfg); #ifdef __cplusplus } #endif #endif // COMMON_LIB_H