Update to odulow per maintenance bronze
[o-du/phy.git] / fapi_5g / source / include / nr5g_fapi_internal.h
1 /******************************************************************************
2 *   Copyright (c) 2019 Intel.
3 *
4 *   Licensed under the Apache License, Version 2.0 (the "License");
5 *   you may not use this file except in compliance with the License.
6 *   You may obtain a copy of the License at
7 *
8 *       http://www.apache.org/licenses/LICENSE-2.0
9 *
10 *   Unless required by applicable law or agreed to in writing, software
11 *   distributed under the License is distributed on an "AS IS" BASIS,
12 *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 *   See the License for the specific language governing permissions and
14 *   limitations under the License.
15 *
16 *******************************************************************************/
17 /**
18  * @file
19  * This file consist of FAPI configuration APIs macros, structure typedefs and
20  * prototypes.
21  *
22  **/
23
24 #ifndef _NR5G_FAPI_INTELNAL_H_
25 #define _NR5G_FAPI_INTELNAL_H_
26
27 #include "fapi_interface.h"
28 #include "nr5g_fapi_common_types.h"
29
30 #define  MAX_UL_SLOT_INFO_COUNT                      10 //Maximum no of Slots for which UL_TTI.request info has to
31 #define  FAPI_MAX_NUM_PUSCH_PDU                     255 //as per Table 3-44
32 #define  FAPI_MAX_NUM_PUCCH_PDU                     255 //as per Table 3-44
33 #define  FAPI_MAX_NUM_SRS_PDU                       255 //as per Table 3-73
34 #define  FAPI_MAX_NUM_RACH_PDU                      255 //as per Table 3-74
35 #define  FAPI_MAX_PHY_INSTANCES                      12
36
37 // CONFIGURATION INFORMATION CARRIER CONFIGURATION BANDWIDTH
38 #define FAPI_BANDWIDTH_5_MHZ                          5
39 #define FAPI_BANDWIDTH_10_MHZ                        10
40 #define FAPI_BANDWIDTH_15_MHZ                        15
41 #define FAPI_BANDWIDTH_20_MHZ                        20
42 #define FAPI_BANDWIDTH_25_MHZ                        25
43 #define FAPI_BANDWIDTH_30_MHZ                        30
44 #define FAPI_BANDWIDTH_40_MHZ                        40
45 #define FAPI_BANDWIDTH_50_MHZ                        50
46 #define FAPI_BANDWIDTH_60_MHZ                        60
47 #define FAPI_BANDWIDTH_70_MHZ                        70
48 #define FAPI_BANDWIDTH_80_MHZ                        80
49 #define FAPI_BANDWIDTH_90_MHZ                        90
50 #define FAPI_BANDWIDTH_100_MHZ                      100
51 #define FAPI_BANDWIDTH_200_MHZ                      200
52 #define FAPI_BANDWIDTH_400_MHZ                      400
53
54 #define FAPI_SUBCARRIER_SPACING_15                  0
55 #define FAPI_SUBCARRIER_SPACING_30                  1
56 #define FAPI_SUBCARRIER_SPACING_60                  2
57 #define FAPI_SUBCARRIER_SPACING_120                 3
58
59 #define FAPI_FFT_SIZE_512                          512
60 #define FAPI_FFT_SIZE_1024                         1024
61 #define FAPI_FFT_SIZE_2048                         2048
62 #define FAPI_FFT_SIZE_4096                         4096
63
64 #define FAPI_MAX_DL_LAYERS                              MAX_NUM_DL_LAYERS
65 #define FAPI_MAX_UL_LAYERS                              4
66 // FAPI Supports MAX 12; Mapping to Intel Phys capabilities
67 #define FAPI_MAX_DMRS_PORTS                             MAX_DL_PER_UE_DMRS_PORT_NUM
68 // FAPI Supports MAX 12; Mapping to Intel Phys capabilities
69 #define FAPI_MAX_PTRS_PORTS                             MAX_DL_PER_UE_PTRS_PORT_NUM
70
71 // FAPI States
72 /**
73  * FAPI state is maintained per fapi instance. If FAPI messages are received in
74  * wrong state an ERROR.indication message will be sent by FAPI.
75  */
76 typedef enum _fapi_states {
77     FAPI_STATE_IDLE = 0,
78     FAPI_STATE_CONFIGURED,
79     FAPI_STATE_RUNNING
80 } fapi_states_t;
81
82 typedef enum {
83     FAPI_PUCCH_FORMAT_TYPE_0 = 0,
84     FAPI_PUCCH_FORMAT_TYPE_1,
85     FAPI_PUCCH_FORMAT_TYPE_2,
86     FAPI_PUCCH_FORMAT_TYPE_3,
87     FAPI_PUCCH_FORMAT_TYPE_4,
88 } nr5g_fapi_uci_format_t;
89
90 typedef struct {
91     uint8_t group_id;
92     uint16_t initial_cyclic_shift;
93     uint8_t nr_of_symbols;
94     uint8_t start_symbol_index;
95     uint8_t time_domain_occ_idx;
96 } nr5g_fapi_pucch_resources_t;
97
98
99 typedef enum {
100     MEM_STAT_CONFIG_REQ = 0,
101     MEM_STAT_START_REQ,
102     MEM_STAT_STOP_REQ,
103     MEM_STAT_SHUTDOWN_REQ,
104     MEM_STAT_DL_CONFIG_REQ,
105     MEM_STAT_UL_CONFIG_REQ,
106     MEM_STAT_UL_DCI_REQ,
107     MEM_STAT_TX_REQ,
108     MEM_STAT_DL_IQ_SAMPLES,
109     MEM_STAT_UL_IQ_SAMPLES,
110     MEM_STAT_DEFAULT,
111 } _mem_stats_for_dl;
112
113 //Unused definitions
114 #define RELEASE_15 0x0001
115
116 #define FAPI_NORMAL_CYCLIC_PREFIX_MASK              0x01
117 #define FAPI_EXTENDED_CYCLIC_PREFIX_MASK            0x02
118
119 // PDCCH Information
120 #define FAPI_CCE_MAPPING_INTERLEAVED_MASK           0x01
121 #define FAPI_CCE_MAPPING_NONINTERLVD_MASK           0x02
122 // Upper Bound for PDCCH Channels per Slot
123 #define FAPI_MAX_PDCCHS_PER_SLOT_MASK               0xff
124
125 // PUCCH Information
126 #define FAPI_FORMAT_0_MASK                          0x01
127 #define FAPI_FORMAT_1_MASK                          0x02
128 #define FAPI_FORMAT_2_MASK                          0x04
129 #define FAPI_FORMAT_3_MASK                          0x08
130 #define FAPI_FORMAT_4_MASK                          0x10
131 // Upper Bound for PUCCH Channels per Slot
132 #define FAPI_MAX_PUCCHS_PER_SLOT_MASK               0xff
133
134 // PDSCH Information
135 #define FAPI_PDSCH_MAPPING_TYPE_A_MASK              0x01
136 #define FAPI_PDSCH_MAPPING_TYPE_B_MASK              0x02
137 #define FAPI_PDSCH_ALLOC_TYPE_0_MASK                0x01
138 #define FAPI_PDSCH_ALLOC_TYPE_1_MASK                0x02
139 #define FAPI_PDSCH_VRB_TO_PRB_MAP_NON_INTLV_MASK    0x01
140 #define FAPI_PDSCH_VRB_TO_PRB_MAP_INTLVD_MASK       0x02
141 #define FAPI_PDSCH_DMRS_CONFIG_TYPE_1_MASK          0x01
142 #define FAPI_PDSCH_DMRS_CONFIG_TYPE_2_MASK          0x02
143 #define FAPI_PDSCH_DMRS_MAX_LENGTH_1                0
144 #define FAPI_PDSCH_DMRS_MAX_LENGTH_2                1
145 #define FAPI_DMRS_ADDITIONAL_POS_0_MASK             0x01
146 #define FAPI_DMRS_ADDITIONAL_POS_1_MASK             0x02
147 #define FAPI_DMRS_ADDITIONAL_POS_2_MASK             0x04
148 #define FAPI_DMRS_ADDITIONAL_POS_3_MASK             0x08
149 // Upper Limit for PDSCHS TBs per Slot
150 #define FAPI_MAX_PDSCHS_TBS_PER_SLOT_MASK           0xff
151 #define FAPI_MAX_NUMBERMIMO_LAYERS_PDSCH            2
152
153 // Subcarrier spacing information
154 #define FAPI_15KHZ_MASK                             0x01
155 #define FAPI_30KHZ_MASK                             0x02
156 #define FAPI_60KHZ_MASK                             0x04
157 #define FAPI_120KHZ_MASK                            0x08
158
159 // Bandwitdth information
160 #define FAPI_5MHZ_BW_MASK                           0x0001
161 #define FAPI_10MHZ_BW_MASK                          0x0002
162 #define FAPI_15MHZ_BW_MASK                          0x0004
163 #define FAPI_20MHZ_BW_MASK                          0x0010
164 #define FAPI_40MHZ_BW_MASK                          0x0020
165 #define FAPI_50MHZ_BW_MASK                          0x0040
166 #define FAPI_60MHZ_BW_MASK                          0x0080
167 #define FAPI_70MHZ_BW_MASK                          0x0100
168 #define FAPI_80MHZ_BW_MASK                          0x0200
169 #define FAPI_90MHZ_BW_MASK                          0x0400
170 #define FAPI_100MHZ_BW_MASK                         0x0800
171 #define FAPI_200MHZ_BW_MASK                         0x1000
172 #define FAPI_400MHZ_BW_MASK                         0x2000
173
174 #define FAPI_MAX_MUMIMO_USERS_MASK                  0xff
175
176 // PUSCH Parameters
177 #define FAPI_PUSCH_MAPPING_TYPE_A_MASK              0x01
178 #define FAPI_PUSCH_MAPPING_TYPE_B_MASK              0x02
179 #define FAPI_PUSCH_ALLOC_TYPE_0_MASK                0x01
180 #define FAPI_PUSCH_ALLOC_TYPE_1_MASK                0x02
181 #define FAPI_PUSCH_VRB_TO_PRB_MAP_NON_INTLV_MASK    0x01
182 #define FAPI_PUSCH_VRB_TO_PRB_MAP_INTLVD_MASK       0x02
183 #define FAPI_PUSCH_DMRS_CONFIG_TYPE_1_MASK          0x01
184 #define FAPI_PUSCH_DMRS_CONFIG_TYPE_2_MASK          0x02
185 #define FAPI_PUSCH_DMRS_MAX_LENGTH_1                0
186 #define FAPI_PUSCH_DMRS_MAX_LENGTH_2                1
187 // Upper limit for PUSCHMAXPTRSPORTS
188 #define FAPI_PUSCH_MAX_PTRS_PORTS_UB                2
189 //Upper Limit for PDSCHS TBs per Slot
190 #define FAPI_MAX_PUSCHS_TBS_PER_SLOT_MASK           0xff
191
192 // PRACH Parameters
193 #define FAPI_PRACH_LF_FORMAT_0_MASK                 0x01
194 #define FAPI_PRACH_LF_FORMAT_1_MASK                 0x02
195 #define FAPI_PRACH_LF_FORMAT_2_MASK                 0x04
196 #define FAPI_PRACH_LF_FORMAT_3_MASK                 0x08
197
198 #define FAPI_PRACH_SF_FORMAT_A1_MASK                0x01
199 #define FAPI_PRACH_SF_FORMAT_A2_MASK                0x02
200 #define FAPI_PRACH_SF_FORMAT_A3_MASK                0x04
201 #define FAPI_PRACH_SF_FORMAT_B1_MASK                0x08
202 #define FAPI_PRACH_SF_FORMAT_B2_MASK                0x10
203 #define FAPI_PRACH_SF_FORMAT_B3_MASK                0x20
204 #define FAPI_PRACH_SF_FORMAT_B4_MASK                0x40
205 #define FAPI_PRACH_SF_FORMAT_C0_MASK                0x80
206 #define FAPI_PRACH_SF_FORMAT_C2_MASK                0x100
207
208 // Measurement Parameters
209 #define FAPI_RSSI_REPORT_IN_DBM_MASK                0x01
210 #define FAPI_RSSI_REPORT_IN_DBFS_MASK               0x02
211
212 // Frequency needs to track 38.104 Section 5.2 and 38.211 Section 5.3.1
213 // Lower Bound KHz
214 #define FAPI_MIN_FREQUENCY_PT_A                     450000
215 // Upper Bound KHz
216 #define FAPI_MAX_FREQUENCY_PT_A                     52600000
217 // dlk0, ulk0 per 38.211 Section 5.3.1
218 // Upper Bound
219 #define FAPI_K0_MAX                                 23699
220 // dlGridSize, ulGridSize per 38.211 Section 4.4.2
221 // Upper Bound
222 #define FAPI_GRIDSIZE_MAX                           275
223 // Number of Transmit Antennas
224 // Define upper mask based on variable type
225 #define FAPI_NUM_ANT_MASK                           0xffff
226 // CELL CONFIGURATION
227 // Physical Cell ID from 38.211 Section 7.4.2.1
228 // Upper Bound
229 #define FAPI_MAX_CELL_ID                            1007
230 // SSB CONFIGURATION
231 // SSB POWER RANGE in dBm
232 #define FAPI_SS_PBCH_LOWEST_POWER                   -60
233 #define FAPI_SS_PBCH_MAX_POWER                      50
234 // BCH PAYLOAD  for 5G the MAC always generates the BCH Payload
235 #define FAPI_BCH_PAYLOAD_GEN_BY_MAC                 0
236 #define FAPI_BCH_PAYLOAD_WITH_PHY_GEN_TIMING        1
237 #define FAPI_BCH_PAYLOAD_ENTIRELY_GEN_BY_PHY        2
238 // ScsCommon
239 #define FAPI_SCSCOMMON_MASK                         0x03
240 // PRACH CONFIGURATION
241 #define FAPI_PRACH_LONG_SEQUENCE                    0
242 #define FAPI_PRACH_SHORT_SEQUENCE                   1
243 #define FAPI_PRACH_SUBC_SPACING_MAX                 4
244 // Restricted Set Configuration
245 #define FAPI_PRACH_RESTRICTED_SET_UNRESTRICTED      0
246 #define FAPI_PRACH_RESTRICTED_SET_TYPE_A            1
247 #define FAPI_PRACH_RESTRICTED_SET_TYPE_B            2
248 // Root Sequence Index
249 // Upper Bound
250 #define FAPI_PRACH_ROOT_SEQ_INDEX_MAX               837
251 // k1
252 // Upper Bound
253 #define FAPI_K1_UPPER_BOUND                         272
254 // PRACH Zero Corr Configuration
255 // Upper Bound
256 #define FAPI_PRACHZEROCORRCONF_MASK                 0x0f
257 // Number of Unused Root Sequences Mask
258 #define FAPI_UNUSEDROOTSEQUENCES_MASK               0x0f
259 // SSB
260 #define FAPI_SSB_SUB6_THRESHOLD                  6000000
261 // Ssb Offset Point A max
262 #define FAPI_SSB_OFFSET_POINTA_MAX                  2199
263 // betaPSS  i.e. PSS EPRE to SSS EPRE in a SS/PBCH Block per 38.213 Section 4.1
264 #define FAPI_BETAPSS_0_DB                           0
265 #define FAPI_BETAPSS_3_DB                           1
266 // SSB Period in ms
267 #define FAPI_SSB_PERIOD_5_MS                        0
268 #define FAPI_SSB_PERIOD_10_MS                       1
269 #define FAPI_SSB_PERIOD_20_MS                       2
270 #define FAPI_SSB_PERIOD_40_MS                       3
271 #define FAPI_SSB_PERIOD_80_MS                       4
272 #define FAPI_SSB_PERIOD_160_MS                      5
273 // Ssb Subcarrier Offset    per 38.211 Section 7.4.3.1
274 // SsbSubcarrierOffset mask
275 #define FAPI_SSB_SUBCARRIER_OFFSET_MASK             0x1f
276 // MIB PAYLOAD MASK
277 #define MIB_PAYLOAD_MASK                            0xfff0
278 // BEAM ID MASK
279 #define FAPI_BEAM_ID_MASK                           0x3f
280 // TDD Table
281 // TDD Period
282 #define FAPI_TDD_PERIOD_0_P_5_MS                        0
283 #define FAPI_TDD_PERIOD_0_P_625_MS                      1
284 #define FAPI_TDD_PERIOD_1_MS                            2
285 #define FAPI_TDD_PERIOD_1_P_25_MS                       3
286 #define FAPI_TDD_PERIOD_2_MS                            4
287 #define FAPI_TDD_PERIOD_2_P_5_MS                        5
288 #define FAPI_TDD_PERIOD_5_MS                            6
289 #define FAPI_TDD_PERIOD_10_MS                           7
290 // Slot Configuration
291 #define FAPI_DL_SLOT                                    0
292 #define FAPI_UL_SLOT                                    1
293 #define FAPI_GUARD_SLOT                                 2
294 // Measurement configuration
295 #define FAPI_NO_RSSI_REPORTING                          0
296 #define FAPI_RSSI_REPORTED_IN_DBM                       1
297 #define FAPI_RSSI_REPORTED_IN_DBFS                      2
298 // Error Indication
299 #define FAPI_SFN_MASK                                   0x03ff
300  // Slot Indication
301 #define FAPI_SLOT_MAX_VALUE                            159
302
303 #define FAPI_U16_MASK                                  0xffff
304 #define FAPI_U8_MASK                                   0xff
305 // Define Maximum number of Ues per Group
306 #define FAPI_MAX_NUMBER_OF_UES_PER_GROUP                12
307
308 // PDCCH PDU
309 #define FAPI_BWPSIZE_MAX                                275
310 #define FAPI_BWPSIZE_START_MAX                          274
311 #define FAPI_SUBCARRIER_SPACING_MAX                     4
312 #define FAPI_CYCLIC_PREFIX_NORMAL                       0
313 #define FAPI_CYCLIC_PREFIX_EXTENDED                     1
314 #define FAPI_MAX_SYMBOL_START_INDEX                     13
315
316 #define FAPI_CORESET_DURATION_1_SYMBOL                  1
317 #define FAPI_CORESET_DURATION_2_SYMBOLS                 2
318 #define FAPI_CORESET_DURATION_3_SYMBOLS                 3
319
320 #define FAPI_CCE_REG_MAPPING_TYPE_NON_INTERLEAVED       0
321 #define FAPI_CCE_REG_MAPPING_TYPE_INTERLEAVED           1
322 #define FAPI_REG_BUNDLE_SIZE_2                          2
323 #define FAPI_REG_BUNDLE_SIZE_3                          3
324 #define FAPI_REG_BUNDLE_SIZE_6                          6
325
326 #define FAPI_INTERLEAVER_SIZE_2                         2
327 #define FAPI_INTERLEAVER_SIZE_3                         3
328 #define FAPI_INTERLEAVER_SIZE_6                         6
329
330 #define FAPI_CORESET_TYPE_0_CONF_BY_PBCH_OR_SIB1        0
331 #define FAPI_CORESET_TYPE_1                             1
332
333 #define FAPI_PREC_GRANULARITY_SAME_AS_REG_BUNDLE        0
334 #define FAPI_PREC_GRANULARITY_ALL_CONTIG_RBS            1
335
336 #define FAPI_CCE_INDEX_MAX                              135
337 #define FAPI_PDCCH_AGG_LEVEL_1                          1
338 #define FAPI_PDCCH_AGG_LEVEL_2                          2
339 #define FAPI_PDCCH_AGG_LEVEL_4                          4
340 #define FAPI_PDCCH_AGG_LEVEL_8                          8
341 #define FAPI_PDCCH_AGG_LEVEL_16                         16
342
343 #define FAPI_BETA_PDCCH_1_0_MAX                         17
344
345 #define FAPI_POWER_CTRL_OFF_SS_MINUS_3_DB               0
346 #define FAPI_POWER_CTRL_OFF_SS_0_DB                     1
347 #define FAPI_POWER_CTRL_OFF_SS_3_DB                     2
348 #define FAPI_POWER_CTRL_OFF_SS_6_DB                     3
349
350 #define FAPI_MAX_NUMBER_OF_CODEWORDS                    2
351
352 #define FAPI_MAX_MCS_INDEX                              31
353 #define FAPI_MCS_INDEX_MASK                             0x1f
354
355 #define FAPI_MCS_TABLE_NOT_QAM_256                      0
356 #define FAPI_MCS_TABLE_QAM_256                          1
357 #define FAPI_MCS_TABLE_QAM_64_LOW_SE                    2
358
359 #define FAPI_REDUNDANCY_INDEX_MASK                      0x03
360
361 #define FAPI_REF_POINT_FOR_PDSCH_DMRS_AT_PT_A           0
362 #define FAPI_REF_POINT_FOR_PDSCH_DMRS_AT_LOWEST_ALLOC   1
363
364 #define FAPI_DL_DMRS_SYMB_POS_MASK                      0x3fff
365
366 #define FAPI_MAX_DMRS_CDM_GRPS_WO_DATA                  3
367
368 #define FAPI_DMRS_PORTS_MASK                            0x0fff
369
370 #define FAPI_RES_ALLOC_TYPE_0                           0
371 #define FAPI_RES_ALLOC_TYPE_1                           1
372
373 #define FAPI_VRB_TO_PRB_MAP_NON_INTERLVD                0
374 #define FAPI_VRB_TO_PRB_MAP_INTERLVD_RB_SIZE_2          1
375 #define FAPI_VRB_TO_PRB_MAP_INTERLVD_RB_SIZE_4          2
376
377 #define FAPI_MAX_START_SYMBOL_INDEX                     13
378 #define FAPI_MAX_NR_OF_SYMBOLS                          14
379 #define FAPI_PTRS_PORT_INDEX_MASK                       0x3f
380 #define FAPI_PTRS_TIME_DENSITY_1                        0
381 #define FAPI_PTRS_TIME_DENSITY_2                        1
382 #define FAPI_PTRS_TIME_DENSITY_4                        2
383 #define FAPI_PTRS_FREQ_DENSITY_2                        0
384 #define FAPI_PTRS_FREQ_DENSITY_4                        1
385 #define FAPI_PTRS_RE_OFFSET_MASK                        0x03
386 #define FAPI_EPRE_RATIO_PDSCH_PTRS_MASK                 0x03
387
388 // PDSCH Power Control Offset
389 #define FAPI_PWR_CTRL_OFFSET_MINUS_8_DB                 0
390 #define FAPI_PWR_CTRL_OFFSET_MINUS_7_DB                 1
391 #define FAPI_PWR_CTRL_OFFSET_MINUS_6_DB                 2
392 #define FAPI_PWR_CTRL_OFFSET_MINUS_5_DB                 3
393 #define FAPI_PWR_CTRL_OFFSET_MINUS_4_DB                 4
394 #define FAPI_PWR_CTRL_OFFSET_MINUS_3_DB                 5
395 #define FAPI_PWR_CTRL_OFFSET_MINUS_2_DB                 6
396 #define FAPI_PWR_CTRL_OFFSET_MINUS_1_DB                 7
397 #define FAPI_PWR_CTRL_OFFSET_0_DB                       8
398 #define FAPI_PWR_CTRL_OFFSET_1_DB                       9
399 #define FAPI_PWR_CTRL_OFFSET_2_DB                       10
400 #define FAPI_PWR_CTRL_OFFSET_3_DB                       11
401 #define FAPI_PWR_CTRL_OFFSET_4_DB                       12
402 #define FAPI_PWR_CTRL_OFFSET_5_DB                       13
403 #define FAPI_PWR_CTRL_OFFSET_6_DB                       14
404 #define FAPI_PWR_CTRL_OFFSET_7_DB                       15
405 #define FAPI_PWR_CTRL_OFFSET_8_DB                       16
406 #define FAPI_PWR_CTRL_OFFSET_9_DB                       17
407 #define FAPI_PWR_CTRL_OFFSET_10_DB                      18
408 #define FAPI_PWR_CTRL_OFFSET_11_DB                      19
409 #define FAPI_PWR_CTRL_OFFSET_12_DB                      20
410 #define FAPI_PWR_CTRL_OFFSET_13_DB                      21
411 #define FAPI_PWR_CTRL_OFFSET_14_DB                      22
412 #define FAPI_PWR_CTRL_OFFSET_15_DB                      23
413 // Power Control Offset SS
414 #define FAPI_PWR_CTRL_OFFSET_SS_MINUS_3_DB              0
415 #define FAPI_PWR_CTRL_OFFSET_SS_0_DB                    1
416 #define FAPI_PWR_CTRL_OFFSET_SS_3_DB                    2
417 #define FAPI_PWR_CTRL_OFFSET_SS_6_DB                    3
418 // CSI Type
419 #define FAPI_CSI_TRS                                    0
420 #define FAPI_CSI_NON_ZERO_POWER                         1
421 #define FAPI_CSI_ZERO_POWER                             2
422 // Row entry into CSI Resource Location Table
423 #define FAPI_CSIRLT_ROW_MAX_VALUE                       18
424 #define FAPI_CSI_FREQ_DOMAIN_MASK                       0x0fff
425 #define FAPI_CSI_SYMB_L1_MIN                            2
426 #define FAPI_CSI_SYMB_L1_MAX                            12
427 // CDM Type
428 #define FAPI_CDM_TYPE_NO_CDM                            0
429 #define FAPI_CDM_TYPE_FD_CDM                            1
430 #define FAPI_CDM_TYPE_CDM4_FD2_TD2                      2
431 #define FAPI_CDM_TYPE_CDM8_FD2_TD4                      3
432 // Frequency Density
433 #define FAPI_FD_DOT5_EVEN_RB                            0
434 #define FAPI_FD_DOT5_ODD_RB                             1
435 #define FAPI_FD_ONE                                     2
436 #define FAPI_FD_THREE                                   3
437
438 // SSB
439 #define FAPI_SSB_BLOCK_INDEX_MASK                       0x3f
440 #define FAPI_SSB_SC_OFFSET_MASK                         0x1f
441
442 // UL TTI REQUEST
443 #define FAPI_MAX_NUM_UE_GROUPS_INCLUDED                 8
444 #define FAPI__MAX_NUM_UE_IN_GROUP                       6
445 // PRACH PDU
446 #define FAPI_MAX_NUM_PRACH_OCAS                         7
447 // PRACH FORMAT
448 #define FAPI_PRACH_FORMAT_A1                            0
449 #define FAPI_PRACH_FORMAT_A2                            1
450 #define FAPI_PRACH_FORMAT_A3                            2
451 #define FAPI_PRACH_FORMAT_B1                            3
452 #define FAPI_PRACH_FORMAT_B2                            4
453 #define FAPI_PRACH_FORMAT_B3                            5
454 #define FAPI_PRACH_FORMAT_B4                            6
455 #define FAPI_PRACH_FORMAT_C0                            7
456 #define FAPI_PRACH_FORMAT_C2                            8
457
458 #define FAPI_MAX_PRACH_FD_OCCASION_INDEX                7
459 #define FAPI_MAX_ZC_ZONE_CONFIG_NUMBER                  419
460
461 // PUSCH PDU
462 #define FAPI_PUSCH_BIT_DATA_PRESENT_MASK                0x0001
463 #define FAPI_PUSCH_UCI_DATA_PRESENT_MASK                0x0002
464 #define FAPI_PUSCH_PTRS_INCLUDED_FR2_MASK               0x0004
465 #define FAPI_PUSCH_DFTS_OFDM_TX_MASK                    0x0008
466
467 #define FAPI_MAX_QAM_MOD_ORDER                          8
468 #define FAPI_MCS_INDEX_MASK                             0x1f
469
470 #define FAPI_MCS_TABLE_NOT_QAM256                       0
471 #define FAPI_MCS_TABLE_QAM256                           1
472 #define FAPI_MCS_TABLE_QAM64_LOWSE                      2
473 #define FAPI_MCS_TABLE_NOT_QAM256_W_XFRM_PRECOD         3
474 #define FAPI_MCS_TABLE_QAM64_LOWSE_W_XFRM_PRECOD        4
475 #define FAPI_PUSCH_MAX_NUM_LAYERS                       4
476 // DMRS
477 #define FAPI_UL_DMRS_SYMB_POS_MASK                      0x3fff
478 #define FAPI_UL_DMRS_CONFIG_TYPE_1                      0
479 #define FAPI_UL_DMRS_CONFIG_TYPE_2                      1
480 #define FAPI_MAX_DMRS_CDM_GRPS_NO_DATA                  3
481 #define FAPI_UL_DMRS_PORTS_MASK                         0x07ff
482 #define FAPI_UL_TX_DIRECT_CURR_LOCATION_MAX             3299
483 #define FAPI_UL_TX_DIRECT_CURR_LOC_OUTSIDE_CARRIER      3300
484 #define FAPI_UL_TX_DIRECT_CURR_LOC_UNDETERMINED         3301
485 // PUSCH DATA
486 #define FAPI_RV_INDEX_MASK                              0x03
487 #define FAPI_HARQ_PROCESS_ID_MASK                       0x0f
488 // PUSCH UCI INFO
489 #define FAPI_HARQ_ACK_CSI_PX_BIT_LEN_SMALL_BLOCK_MAX    11
490 #define FAPI_HARQ_ACK_CSI_PX_BIT_LEN_POLAR_MAX          1706
491 // ALPHA SCALING
492 #define FAPI_ALPHA_SCALE_0_5                            0
493 #define FAPI_ALPHA_SCALE_0_65                           1
494 #define FAPI_ALPHA_SCALE_0_8                            2
495 #define FAPI_ALPHA_SCALE_1_0                            3
496 // BETA OFFSET HARQ ACK
497 #define FAPI_BETA_OFFSET_HARQ_ACK_MAX                   15
498 #define FAPI_BETA_OFFSET_CSIX_MAX                       18
499
500 // PUSCH PTRS INFORMATION 38.212 Section 7.3.1.1.2
501 #define FAPI_MAX_NUMBER_PTRS_PORT_INDEX                 11  // 0..11
502 // UL PTRS POWER 5G FAPI Table 3-49
503 #define FAPI_UL_PTRS_PWR_0_DB                           0
504 #define FAPI_UL_PTRS_PWR_3_DB                           1
505 #define FAPI_UL_PTRS_PWR_4_77_DB                        2
506 #define FAPI_UL_PTRS_PWR_6_DB                           3
507 // DFTSOFDM INFO 5g FAPI Table 3-50
508 #define FAPI_MAX_LOW_PAPR_GROUP_NUMBER                  29  // 0..29
509 #define FAPI_MAX_LOW_PAPR_SEQ_NUMBER                    87  // 3*LOW_PAPR_GRP_NUM
510 #define FAPI_MAX_UL PTRS_SAMP_DENSITY                   8
511 #define FAPI_MAX_UL_PTRS_TD_XFRM_PRECOD                 4
512
513 // PUCCH PDU Table 3-51
514 #define FAPI_MAX_PUCCH_FORMAT_TYPE                      4
515 #define FAPI_MULTI_SLOT_TX_IND_NO_MULTI_SLOT            0
516 #define FAPI_MULTI_SLOT_TX_IND_TX_START                 1
517 #define FAPI_MULTI_SLOT_TX_IND_TX_CONT                  2
518 #define FAPI_MULTI_SLOT_TX_IND_TX_END                   3
519 #define FAPI_MAX_NUM_PRB_FOR_A_PUCCH                    16
520 #define FAPI_MAX_PUCCH_DUR_F0_AND_F2                    2
521 #define FAPI_MIN_PUCCH_DUR_F1_F3_F4                     4
522 #define FAPI_MAX_PUCCH_DUR_F1_F3_F4                     14
523 #define FAPI_MAX_INIT_CYCLIC_SHIFT_F0_F1_F3_F4          11
524 #define FAPI_MAX_OCC_INDEX_F1                           6
525 #define FAPI_MAX_PRE_DFT_OCC_IDX_F4                     3
526 #define FAPI_MAX_PRE_DFT_OCC_LEN_F4                     4
527 #define FAPI_MAX_DMRS_CYC_SHIFT_F4                      9
528 #define FAPI_BIT_LEN_HARQ_PL_ZERO                       0
529 #define FAPI_BIT_LEN_HARQ_PL_F0_F1_2_BITS               1
530 #define FAPI_BIT_LEN_HARQ_PL_F2_F3_F4_1706_BITS         2
531 #define FAPI_BIT_LEN_CSI_PX_PL_NO_CSI                   0
532 #define FAPI_BIT_LEN_CSI_PX_PL_1706_BITS                1
533
534 // SRS PDU
535 #define FAPI_1_SRS_ANT_PORT                             0
536 #define FAPI_2_SRS_ANT_PORTS                            1
537 #define FAPI_4_SRS_ANT_PORTS                            2
538 #define FAPI_SRS_NO_REPETITIONS                         0
539 #define FAPI_SRS_2_REPETITIONS                          2
540 #define FAPI_SRS_4_REPETITIONS                          4
541 #define FAPI_SRS_CONFIG_INDEX_MASK                      0x3f
542 #define FAPI_SRS_BW_INDEX_MASK                          0x03
543 #define FAPI_TX_COMB_SIZE_2                             0
544 #define FAPI_TX_COMB_SIZE_4                             1
545 #define FAPI_MAX_SRS_FREQ_POSITION                      67
546 #define FAPI_MAX_SRS_FD_SHIFT                           268
547 #define FAPI_SRS_FREQ_HOPPING_MASK                      0x03
548 #define FAPI_SRS_NO_HOPPING                             0
549 #define FAPI_SRS_GRP_OR_SEQ_HOPPING                     1
550 #define FAPI_SRS_SEQ_HOPPING                            2
551 #define FAPI_SRS_RES_ALLOC_APERIODIC                    0
552 #define FAPI_SRS_RES_ALLOC_SEMI_PERSISTENT              1
553 #define FAPI_SRS_RES_ALLOC_PERIODIC                     2
554 #define FAPI_MAX_LSOT_OFFSET_VALUE                      2559
555
556 // RX_DATA Indication
557 #define FAPI_UL_CQI_INVALID                             255
558 #define FAPI_TIMING_ADVANCE_INVALID                     0xffff
559 #define FAPI_MAX_TIMING_ADVANCE                         63
560 #define FAPI_MAX_RSSI                                   1280
561
562 // RACH Indication
563 #define FAPI_RACH_FREQ_INDEX_MAX                        7
564 #define FAPI_RACH_DETECTED_PREAMBLES_MASK               0x3f
565 #define FAPI_RACH_TIMING_ADVANCE_MAX                    3846
566 #define FAPI_RACH_PREAMBLE_POWER_INVALID                0xffffffff
567 #define FAPI_RACH_PREAMBLE_TIMING_ADVANCE_INVALID       0xffff
568 #define FAPI_RACH_PREAMBLE_POWER_MAX                    170000
569
570 // SR, HARQ, and CSI Part 1/2 PDUs Table 3-66
571 #define FAPI_SR_MASK                                    0x01
572 #define FAPI_HARQ_MASK                                  0x02
573 #define FAPI_CSI_PART1                                  0x04
574 #define FAPI_CSI_PART2                                  0x08
575 #define FAPI_PUCCH_FORMAT2                              0
576 #define FAPI_PUCCH_FORMAT3                              1
577 #define FAPI_PUCCH_FORMAT4                              2
578 #define FAPI_PUCCH_FORMAT_MASK                          0x03
579
580 // SR PDU For Format 0 or 1 Table 3-67
581 #define FAPI_SR_CONFIDENCE_LEVEL_GOOD                   0
582 #define FAPI_SR_CONFIDENCE_LEVEL_BAD                    1
583 #define FAPI_SR_CONFIDENCE_LEVEL_INVALID                0xff
584
585 // HARQ PDU for Format 0 or 1 Table 3-68
586 #define FAPI_HARQ_VALUE_PASS                            0
587 #define FAPI_HARQ_VALUE_FAIL                            1
588 #define FAPI_HARQ_VALUE_NOT_PRESENT                     2
589
590 // SR PDU for Format 2,3 or 4 Table 3-69
591 #define FAPI_SR_PAYLOAD_MAX                             1
592
593 // HARQ PDU for Format 2,3 or 4 Table 3-70
594 #define FAPI_HARQ_CRC_PASS                              0
595 #define FAPI_HARQ_CRC_FAIL                              1
596 #define FAPI_HARQ_CRC_NOT_PRESENT                       2
597 #define FAPI_HARQ_PAYLOAD_MAX                           214
598
599 // CSI Part 1 PDU Table 3-71 and 3-72
600 #define FAPI_CSI_PARTX_CRC_PASS                         0
601 #define FAPI_CSI_PARTX_CRC_FAIL                         1
602 #define FAPI_CSI_PARTX_CRC_NOT_PRESENT                  2
603 #define FAPI_CSI_PARTX_PAYLOAD_MAX                      214
604
605 // CRC
606 enum {
607     FAPI_CRC_CORRECT = 0,
608     FAPI_CRC_ERROR = 1
609 };
610
611 // Release/Features support
612 typedef enum {
613     FAPI_NOT_SUPPORTED = 0,
614     FAPI_SUPPORTED,
615 } fapiSupport_t;
616
617 // Information of optional and mandatory status for a TLV
618 typedef enum {
619     FAPI_IDLE_STATE_ONLY_OPTIONAL = 0,
620     FAPI_IDLE_STATE_ONLY_MANDATORY,
621     FAPI_IDLE_AND_CONFIGURED_STATES_OPTIONAL,
622     FAPI_IDLE_STATE_MANDATORY_CONFIGURED_STATE_OPTIONAL,
623     FAPI_IDLE_CONFIGURED_AND_RUNNING_STATES_OPTIONAL,
624     FAPI_IDLE_STATE_MANDATORY_CONFIGURED_AND_RUNNING_STATES_OPTIONAL
625 } fapiTlvStatus_t;
626
627 typedef enum modulationOrder {
628     FAPI_QPSK = 0,
629     FAPI_16QAM,
630     FAPI_64QAM,
631     FAPI_256QAM
632 } fapiModOrder_t;
633
634 // SSBPERRACH
635 typedef enum {
636     FAPI_SSB_PER_RACH_1_OVER_8 = 0,
637     FAPI_SSB_PER_RACH_1_OVER_4,
638     FAPI_SSB_PER_RACH_1_OVER_2,
639     FAPI_SSB_PER_RACH_1,
640     FAPI_SSB_PER_RACH_2,
641     FAPI_SSB_PER_RACH_4,
642     FAPI_SSB_PER_RACH_8,
643     FAPI_SSB_PER_RACH_16
644 } fapiSsbPerRach_t;
645
646 #endif                          //_NR5G_FAPI_INTELNAL_H_