if4_tools.h 4.27 KB
Newer Older
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
/*******************************************************************************
    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 <http://www.gnu.org/licenses/>.

  Contact Information
  OpenAirInterface Admin: openair_admin@eurecom.fr
  OpenAirInterface Tech : openair_tech@eurecom.fr
  OpenAirInterface Dev  : openair4g-devel@lists.eurecom.fr

  Address      : Eurecom, Campus SophiaTech, 450 Route des Chappes, CS 50193 - 06904 Biot Sophia Antipolis cedex, FRANCE

 *******************************************************************************/

/*! \file PHY/LTE_TRANSPORT/if4_tools.h
* \brief 
* \author S. Sandeep Kumar, Raymond Knopp
* \date 2016
* \version 0.1
* \company Eurecom
* \email: ee13b1025@iith.ac.in, knopp@eurecom.fr 
* \note
* \warning
*/

41 42
#include <stdint.h>

43 44
/// Macro for IF4 packet type
#define IF4_PACKET_TYPE 0x080A 
45 46 47 48
#define IF4_PULFFT 0x0019 
#define IF4_PDLFFT 0x0020
#define IF4_PRACH 0x0021

49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64
/// IF4 Frame Status (32 bits)
struct IF4_frame_status {
  /// Antenna Numbers
  uint32_t ant_num:3;
  /// Antenna Start
  uint32_t ant_start:3;
  /// Radio Frame Number
  uint32_t rf_num:16;
  /// Sub-frame Number
  uint32_t sf_num:4;
  /// Symbol Number
  uint32_t sym_num:4;
  /// Reserved
  uint32_t rsvd:2;    
};

65 66 67
typedef struct IF4_frame_status IF4_frame_status_t;
#define sizeof_IF4_frame_status_t 4 

68
/// IF4 Antenna Gain (16 bits)
69 70
struct IF4_gain {
  /// Reserved 
Sandeep Kumar's avatar
Sandeep Kumar committed
71
  uint16_t rsvd:10;
72
  /// FFT Exponent Output
Sandeep Kumar's avatar
Sandeep Kumar committed
73
  uint16_t exponent:6;  
74 75
};  

76 77 78
typedef struct IF4_gain IF4_gain_t;
#define sizeof_IF_gain_t 2

79
/// IF4 LTE PRACH Configuration (32 bits)
80 81 82 83 84 85 86 87 88 89 90 91
struct IF4_lte_prach_conf {
  /// Reserved
  uint32_t rsvd:3;
  /// Antenna Indication
  uint32_t ant:3;
  /// Radio Frame Number
  uint32_t rf_num:16;
  /// Sub-frame Number
  uint32_t sf_num:4;
  /// FFT Exponent Output
  uint32_t exponent:6;  
};
Sandeep Kumar's avatar
Sandeep Kumar committed
92

93 94 95
typedef struct IF4_lte_prach_conf IF4_lte_prach_conf_t;
#define sizeof_IF4_lte_prach_conf_t 4

96
struct IF4_dl_header {
97 98 99 100 101
  /// Destination Address
  
  /// Source Address
  
  /// Type
102
  uint16_t type; 
103
  /// Sub-Type
104
  uint16_t sub_type;
105
  /// Reserved
106
  uint32_t rsvd;
107
  /// Frame Status
108
  IF4_frame_status_t frame_status;
109
  /// Data Blocks
110

111
  /// Frame Check Sequence
112

113 114
};

115 116
typedef struct IF4_dl_header IF4_dl_header_t;
#define sizeof_IF4_dl_header_t 12 
Sandeep Kumar's avatar
Sandeep Kumar committed
117

118
struct IF4_ul_header {
119 120 121 122 123
  /// Destination Address
  
  /// Source Address
  
  /// Type
124
  uint16_t type;
125
  /// Sub-Type
126
  uint16_t sub_type;
127
  /// Reserved
128
  uint32_t rsvd;
129
  /// Frame Status
130
  IF4_frame_status_t frame_status;
131
  /// Gain 0
132
  IF4_gain_t gain0;
133
  /// Gain 1
134
  IF4_gain_t gain1;
135
  /// Gain 2
136
  IF4_gain_t gain2;
137
  /// Gain 3
138
  IF4_gain_t gain3;
139
  /// Gain 4
140
  IF4_gain_t gain4;
141
  /// Gain 5
142
  IF4_gain_t gain5;
143
  /// Gain 6
144
  IF4_gain_t gain6;
145
  /// Gain 7
146
  IF4_gain_t gain7;
147
  /// Data Blocks
148

149
  /// Frame Check Sequence
150

151 152
};

153 154
typedef struct IF4_ul_header IF4_ul_header_t;
#define sizeof_IF4_ul_header_t 28 
155

156
struct IF4_prach_header {
157
  /// Destination Address 
158
  
159
  /// Source Address
160
  
161 162 163 164 165 166 167
  /// Type
  uint16_t type;
  /// Sub-Type
  uint16_t sub_type;
  /// Reserved
  uint32_t rsvd;
  /// LTE Prach Configuration
168
  IF4_lte_prach_conf_t prach_conf;
169
  /// Prach Data Block (one antenna)
170

171
  /// Frame Check Sequence
172

173 174
};

175 176
typedef struct IF4_prach_header IF4_prach_header_t;
#define sizeof_IF4_prach_header_t 12
177

178
void gen_IF4_dl_header(IF4_dl_header_t*, eNB_rxtx_proc_t*);
179

180
void gen_IF4_ul_header(IF4_ul_header_t*, eNB_rxtx_proc_t*);
181

182
void gen_IF4_prach_header(IF4_prach_header_t*, eNB_rxtx_proc_t*);
183

184
void send_IF4(PHY_VARS_eNB*, eNB_rxtx_proc_t*, uint16_t);
185

186
void recv_IF4(PHY_VARS_eNB*, eNB_rxtx_proc_t*, uint16_t*, uint32_t*);