git-svn-id: http://svn.eurecom.fr/openair4G/trunk@5493 818b1a75-f10b-46b9-bf7c-635c3b92a50f

2014-07-14 13:47:29 +00:00
parent 752cb8a7b7
commit a491fbb1aa
7 changed files with 1184 additions and 1281 deletions
@@ -0,0 +1,81 @@
+/** common_lib.h
+ *
+ * Author: HongliangXU : hong-liang-xu@agilent.com
+ */
+#ifndef COMMON_LIB_H
+#define COMMON_LIB_H
+#include <stdint.h>
+
+typedef int64_t openair0_timestamp;
+typedef struct openair0_device_t openair0_device;
+/* structrue holds the parameters to configure USRP devices
+ */
+
+typedef enum {
+  max_gain=0,med_gain,byp_gain
+} rx_gain_t;
+
+
+typedef struct {
+  /* the sample rate for both transmit and receive. */
+  double sample_rate;
+  /* number of RX channels (=RX antennas) */
+  int rx_num_channels;
+  /* number of TX channels (=TX antennas) */
+  int tx_num_channels;
+  /* center frequency in Hz for RX */
+  double rx_freq[4];
+  /* center frequency in Hz for TX */
+  double tx_freq[4];
+  /* mode for rxgain (ExpressMIMO2)*/
+  rx_gain_t rxg_mode[4];
+  /* gain for RX in dB */
+  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;
+} openair0_config_t;
+
+struct openair0_device_t {
+  /* USRP 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, const void *buff, int nsamps, int flags);
+
+  /* Read '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.
+   * Return the number of sample read */
+  int (*trx_read_func)(openair0_device *device, openair0_timestamp *ptimestamp, void *buff, int nsamps);
+
+  /* Terminate operation of the transceiver -- free all associated resources */
+  void (*trx_end_func)(openair0_device *device);
+};
+
+
+#ifdef __cplusplus
+extern "C"
+{
+/* return 0 if OK, < 0 if error */
+int openair0_device_init(openair0_device* device, openair0_config_t *openair0_cfg);
+}
+#else
+int openair0_device_init(openair0_device* device, openair0_config_t *openair0_cfg);
+#endif
+
+#endif // COMMON_LIB_H